// Command reference
simforge batch
Generated from the CLI's own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the reference index.
simforge batch
Sites x draws matrix of a template: instantiate -> simulate -> evaluate per cell, resumable
simforge batch [OPTIONS] --out <DIR> <TEMPLATE>
Runs on: local runtime
| Argument / flag | Notes | What |
|---|---|---|
| <template> | required | The v2 template |
| --map MAP | One installed map | |
| --maps MAPS | repeatable | Several installed maps, comma-separated, in this order |
| --all-maps | Every installed map | |
| --draws N | Parameter draws per site | |
| --out DIR | required | The batch directory (cells and batch-summary.json) |
| --min-score SCORE | Drop sites scoring below this | |
| --max-sites N | Keep at most this many sites per map | |
| --concurrency N | Worker threads (default min(4, cpus - 1)) | |
| --no-trace | Do not write the per-cell traces | |
| --filter MODE | Reject filters: critical | negative-control | all | |
| --trivial-ttc S | The trivially-safe TTC threshold, seconds | |
| --force | Re-run every cell, even one whose results still hold | |
| --ambient PRESET | Generated background traffic: off | light | moderate | city | heavy | |
| --ambient-density N | Ambient density override, vehicles per km of eligible lane | |
| --ambient-max-actors N | Ambient actor cap | |
| --ambient-radius-m M | Ambient candidate radius around the choreography, metres | |
| --ambient-seed SEED | Ambient population seed | |
| --ambient-settle S | Seconds of ambient-only warm-up before t = 0 (default 20 with --ambient) |