// Command reference
simforge simulate
Generated from the CLI's own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the reference index.
simforge simulate
Simulate the same scenario file locally or with --cloud
simforge simulate [OPTIONS] <TARGET> [EXTRA]...
| Argument / flag | Notes | What |
|---|---|---|
| <target> | required | Scenario JSON file or materialized workspace; identical input for local and cloud |
| <extra> | repeatable | Runtime-specific options; forwarded without shell interpolation |
| --out OUT | Output folder; local requires it, cloud waits and downloads when it is given | |
| --mode MODE | one of 2d, schematic, 3d; default 2d | |
| --rig RIG | Sensor rig JSON (simforge rig init). Default: the basic-dash-camera rig on the ego | |
| --preset PRESET | one of training, showcase, schematic | Render preset |
| --camera-detector FILE | Local native render only: authored instantaneous HDR detector response JSON | |
| --camera-temporal FILE | Local native render only: bounded exact-time HDR exposure request JSON | |
| --camera-delivery FILE | Local bounded offline measurement delivery or controlled delivery-only resume | |
| --fps FPS | Frame rate every camera records (2d: the video's), over the render preset's own rate; 3d takes 5 to 60 | |
| --wait | Wait for a submitted cloud job to finish | |
| --download | Download a succeeded cloud job into --out; implies --wait | |
| --max-cost CENTS | Explicit maximum cloud cost in cents; required for billable cloud jobs | |
| --revision REVISION | Immutable revision for an existing hosted scenario target | |
| --replay-of RUN_ID | Cloud 3d render: the drive a succeeded closed_loop run scored (its episode timeline), rendered on the target's revision that run drove | |
| --seed SEED | Override the resolution's seed (the trace is then expected to differ) | |
| --map-dir DIR | Use this map directory instead of the installed map found by content (map.xodr[.gz] sha256 = the manifest's map.xodrSha256) | |
| --cache-root DIR | Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps | |
| --trace FILE | Instance mode (the positional is an instance file): also write the trace here (gzip JSON) | |
| --allow-no-colliders | Simulate without map colliders when the map publishes none (recorded in the result; the default refuses) |