render Batch Summary
Primary on-demand report. One document covering every completed item (or a caller-supplied subset). Sections:
Run Overview — table with item name, requested reps, completed reps, run-error flag.
Per-item across-replication statistics — one sub-section per item containing the response × stat table (Count, Mean, Std Dev, Half-width, CI bounds, Min, Max).
Designed to answer "how did my items stack up?" in one file, without forcing the analyst to flip between per-item reports.
Parameters
optional whitelist of experiment.exp_name values to include. null (the default) includes every snapshot in result; a non-null set filters both the Run Overview rows and the per-item stat sub-sections. Empty set means "no items" and surfaces as an error in the returned WriteOutcome. Unknown names in the set are silently ignored.
filename stem (no extension) for the consolidated document. Defaults to "scenario-summaries" to preserve Scenario-app filenames; Experiment-app hosts should pass a domain-natural value such as "batch-summary".
title that goes on the rendered document.
the human-readable plural form used in body text (e.g. "scenarios", "design points").
the Run Overview's leftmost column header (e.g. "Scenario", "Design Point").