> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# simforge simulate

> Reference for simforge simulate: usage, arguments and flags, generated from the CLI.

Generated from the CLI's own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the [command reference](/cli).

## simulate

Simulate the same scenario file locally or with --cloud

```sh theme={null}
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 | `2d` (top-down map video on the CPU), `schematic` (the flat OpenDRIVE view, GPU) or `3d` (photoreal camera sensors, GPU) |
| `--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 |
| `--stage` | | With --cloud: save a scenario file to the workspace as an immutable revision (free) and price the run on it; starts nothing. --dry-run saves nothing |
| `--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) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.