CLI Reference#

Entry point:

drexp <subcommand> [options]

The CLI mirrors the study lifecycle from validation through execution and artifact export.

Subcommands#

Validate study structure and cross-reference integrity.

drexp validate-study path/to/study.yaml

Materialize admissible conditions and optionally write a conditions CSV.

drexp materialize-design path/to/study.yaml --output artifacts/conditions.csv

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

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 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 canonical analysis tables from checkpointed runs.

drexp export-analysis path/to/study.yaml --output-dir artifacts/study-output

Create a bundled archive of study outputs.

drexp bundle-results artifacts/study-output --bundle-path artifacts/study-output.tar.gz