fasthep-render provides plotting, table rendering, reporting, and visualization utilities for FAST-HEP workflows.
The Python import namespace is:
import fasthep_renderfasthep-render is responsible for:
- histogram rendering
- cutflow tables
- report generation
- plotting backends
- rendering registries
- artifact formatting
- summary visualizations
- workflow diagnostics output
It is the presentation and reporting layer of the FAST-HEP ecosystem.
fasthep-flow provides:
- workflow compilation
- orchestration
- execution planning
- backend interfaces
fasthep-render provides:
- visualization
- report generation
- artifact formatting
- plotting implementations
- rendering specifications
In practice, most HEP users will use both packages together.
-
fasthep-flow- workflow language and execution engine
-
fasthep-carpenter- HEP analysis transforms
- histogramming
- event processing
-
fasthep-curator- dataset inspection
- validation
- metadata generation
-
fasthep-cli- the unified
fasthepcommand-line interface
- the unified
Alternatively, install the meta package:
pip install fasthepInstall directly:
pip install fasthep-renderDevelopment environment:
pixi install
pixi run ciExample render specification:
render:
NumberOfJets:
renderer: histogram
style:
title: Jet multiplicity
x_label: Number of jets
y_label: EventsExample Python usage:
from fasthep_render.api import render_artifact
render_artifact(
artifact="results/NumberOfJets.pkl",
spec="render_specs/render_NumberOfJets.yaml",
output="results/NumberOfJets.png",
)fasthep-render focuses on:
- declarative rendering
- reusable render specifications
- backend-independent visualization
- registry-driven extensibility
- reproducible reports
- publication-oriented outputs
The package intentionally separates rendering and presentation concerns from workflow execution and analysis logic.
Main FAST-HEP documentation:
API documentation for this package:
Main FAST-HEP repository and project links:
Contribution guidelines, development setup, and project-wide documentation are maintained centrally in the main FAST-HEP repository.
Earlier rendering implementations existed inside the monolithic prototype repositories.
The current repository contains the standalone split-package rendering layer.
FAST-HEP is currently in active pre-alpha development.
Interfaces may evolve rapidly while the package split and stabilization work continues.