CLI Reference#
Entry point:
drexp <subcommand> [options]
The CLI mirrors the study lifecycle from validation through execution and artifact export.
Subcommands#
validate-study#
Validate study structure and cross-reference integrity.
drexp validate-study path/to/study.yaml
materialize-design#
Materialize admissible conditions and optionally write a conditions CSV.
drexp materialize-design path/to/study.yaml --output artifacts/conditions.csv
generate-doe#
Generate DOE tables directly (full, lhs, frac2).
drexp generate-doe --kind lhs --factors-json '{"x": [0, 1], "y": [10, 20]}' --n-samples 12 --out artifacts/doe.csv
Use design-research-experiments[doe] plus --backend scipy/qmc for
SciPy-backed LHS or --backend pydoe3 for pyDOE3-backed fractional designs.
run-study#
Execute one study definition. When stderr is attached to a TTY, runs show an
interactive tqdm progress bar by default.
drexp run-study path/to/study.yaml --parallelism 4
drexp run-study path/to/study.yaml --parallelism 4 --no-progress
resume-study#
Resume from checkpointed outputs. Use --progress to force a bar in
non-interactive contexts or --no-progress to suppress it.
drexp resume-study path/to/study.yaml --parallelism 4
drexp resume-study path/to/study.yaml --parallelism 4 --progress
export-analysis#
Export canonical analysis tables from checkpointed runs.
drexp export-analysis path/to/study.yaml --output-dir artifacts/study-output
bundle-results#
Create a bundled archive of study outputs.
drexp bundle-results artifacts/study-output --bundle-path artifacts/study-output.tar.gz
draft-paper#
Explicitly assemble a review-required Markdown and LaTeX paper draft from a
study artifact directory or its manifest.json. Ordinary study execution
never invokes this command automatically.
drexp draft-paper artifacts/study-output
drexp draft-paper artifacts/study-output/manifest.json --require-complete
drexp draft-paper artifacts/study-output --component-packet problem-paper.json --component-packet analysis-paper.json
The default destination is artifacts/study-output/paper-draft. Use
--output-dir for an explicit destination and --overwrite to replace an
existing non-empty draft. --require-complete still writes a partial draft,
then exits nonzero if evidence-critical TODOs remain.