2.27.2.14. pycsamt.pipeline._dashboard#
The “dashboard” report tier — a branded, chart-carrying HTML report.
make_dashboard_html() is the richer sibling of
pycsamt.pipeline._report.make_html_report(): real pyCSAMT brand
colors and logo, KPI stat tiles, and three native inline-SVG charts (no JS,
no CDN — the file stays a single self-contained document, the same
convention the rest of the pipeline’s reports already follow).
Palette provenance#
Every color here traces to a real source, not an eyeballed choice:
Brand tokens (ink/surface/border/secondary/primary) are copied from
docs/source/_static/css/custom.css’s--pycsamt-*custom properties — pyCSAMT’s actual site palette.The categorical pair used for the two-series site-count-flow chart is the brand’s own secondary blue and primary orange, run through the dataviz skill’s
validate_palette.jsagainst both this dashboard’s light (#ffffff) and dark (#141922) surfaces — every check passed (CVD ΔE 22.4, normal-vision ΔE 33.2, contrast >= 3:1) with the raw brand hex values, no substitution needed.The status palette (good/warning/critical) is the dataviz skill’s own validated, brand-independent set (documented there as “fixed, never themed”) — deliberately distinct from the categorical slots so a status color can never be mistaken for a data series.
Both the categorical pair and the status palette validated identically on light and dark surfaces, so — unlike the ink/surface/border tokens — none of them are redefined in the dark-mode media query below.
The small stat-tile icons are trimmed, currentColor-recolored copies
of real icon assets; the header logo and the favicon are the real,
unmodified pyCSAMT marks (pycsamt-v2-symbol.svg / .ico). All of
these live under docs/source/_static/ — that directory is not shipped
in the installed package, so every asset is embedded here as a plain
string (the favicon as a base64 data URI) rather than read from disk at
runtime.
Functions
|
Return a self-contained, branded HTML dashboard report. |
- pycsamt.pipeline._dashboard.make_dashboard_html(pipeline_name, step_results, elapsed_sec, outdir, n_sites_in, n_sites_out, pipeline_yaml='')[source]
Return a self-contained, branded HTML dashboard report.
The richer sibling of
pycsamt.pipeline._report.make_html_report(): KPI stat tiles and three native inline-SVG charts (step status, per-step duration, site-count flow) on top of the same step data. See the module docstring for where every color in this report traces back to.