Skip to content

zyfgi/carsim-guide-skill

carsim-guide

Verified

Operate and automate CarSim simulations from an agent, including safe output and parameter discovery, named Run Control execution contexts, structured overrides, isolated batch sweeps, dataset dependency inspection, control-mode selection, result validation, diagnostics, and version-aware CLI/Simulink/VS API routing. Use for executing, configuring, exploring, or debugging CarSim. Do not use for vehicle-dynamics theory alone, generic dataframe work, or unrelated simulators.

FileKindSize
SKILL.mdskill md6.3 KB
examples/batches/friction_sweep.yamlconfig159 B
examples/batches/mass_friction_grid.yamlconfig198 B
examples/discovery/dataset_tree.pyscript693 B
examples/discovery/find_output.pyscript715 B
examples/discovery/find_parameter.pyscript761 B
examples/scenarios/basic_cruise.yamlconfig380 B
examples/scenarios/friction_change.yamlconfig379 B
examples/scenarios/steering_maneuver.yamlconfig377 B
examples/scenarios/tire_force_output.yamlconfig437 B
examples/scenarios/vehicle_override.yamlconfig376 B
examples/simulink_cosim.pyscript5.5 KB
examples/torque_vectoring.pyscript5.6 KB
references/advanced-controls.mdmarkdown4.0 KB
references/batch-workflows.mdmarkdown1.6 KB
references/compatibility.mdmarkdown1.4 KB
references/control-modes.mdmarkdown1.0 KB
references/database-exploration.mdmarkdown7.4 KB
references/dataset-syntax.mdmarkdown6.6 KB
references/outputs-and-units.mdmarkdown2.1 KB
references/parameter-discovery.mdmarkdown1.4 KB
references/parameters.mdmarkdown3.3 KB
references/python-interface.mdmarkdown7.9 KB
references/run-validation.mdmarkdown2.2 KB
references/scenarios.mdmarkdown3.3 KB
references/simulink-cosim.mdmarkdown4.0 KB
references/troubleshooting.mdmarkdown1.4 KB
references/version-compatibility.mdmarkdown811 B
references/vs-c-api.mdmarkdown3.3 KB
scripts/base_registry.pyscript4.7 KB
scripts/batch_runner.pyscript7.1 KB
scripts/carsim_batch.pyscript23.4 KB
scripts/carsim_errors.pyscript2.2 KB
scripts/control_modes.pyscript1.8 KB
scripts/cosim_model.mother4.7 KB
scripts/database_tools.pyscript16.5 KB
scripts/diagnose_run.pyscript444 B
scripts/diagnostics.pyscript6.9 KB
scripts/discovery_query.pyscript1.0 KB
scripts/dump_dll_exports.pyscript1.9 KB
scripts/output_registry.pyscript8.9 KB
scripts/override_registry.pyscript2.9 KB
scripts/parameter_discovery.pyscript8.6 KB
scripts/parameters.pyscript10.0 KB
scripts/result_contract.pyscript548 B
scripts/scenario_runner.pyscript11.3 KB
scripts/scenario_schema.pyscript4.0 KB
scripts/setup_paths.pyscript11.2 KB
scripts/tv_cosim.mother8.5 KB
scripts/validate_run.pyscript6.1 KB
scripts/version_compatibility.pyscript2.0 KB

references/simulink-cosim.md

View on GitHub
# Simulink co-simulation

Use CLI batch execution when all external inputs are predefined before the
run. Use Simulink co-simulation when an external controller must affect the
vehicle during the same simulation. The bundled example has been exercised
end-to-end with CarSim 2024.0 and MATLAB R2025b with Simulink 25.2.

## Mechanism

```
Simulink model (your controller)
  import array -> [vs_sf S-Function] -> export array
                    | reads simfile.sim (PORTS_IMP/PORTS_EXP > 0)
                    v
              VS solver steps at EXT_MODEL_STEP
```

- The solver ships as `vs_sf.mexw64` inside `<PROG>\Programs\solvers\Matlab\`, wrapped by the library `Solver_SF.slx` (same folder; `slblocks.m` registers it as the "VehicleSim" library).
- Import/export declarations live in the parsfile; the counts live in BOTH the parsfile and the simfile (see pitfall 1).
- Exports carry **native CarSim units** (km/h, deg/s, g) — convert where you consume them.

## Programmatic route

1. **Generate the co-sim inputs with the normal override workflow**, adding import/export declarations via `unsafe_extra_lines` (see `examples/simulink_cosim.py`):

   ```
   IMPORT IMP_STEER_SW REPLACE      ! steering wheel angle [deg] from Simulink
   EXPORT Vx                         ! export order = declaration order
   EXPORT AVz                        ! [deg/s]
   EXPORT Ay                         ! [g]
   EXPORT Yo                         ! [m]
   EXPORT Steer_SW                   ! [deg]
   PORTS_IMP 1,1                     ! <array #>,<count>  -- NOT a single count!
   PORTS_EXP 1,5
   ```

   and patch the simfile the same way: `PORTS_IMP 1,1`, `PORTS_EXP 1,5`. Keep `EXT_MODEL_STEP` = solver `TSTEP`.

2. **Build and run the model headless** (`scripts/cosim_model.m`):

   ```
   matlab -batch "addpath('<PROG>\Programs\solvers\Matlab'); cosim_model('<workdir>')"
   ```

   The script builds a model with the `Solver_SF/CarSim S-Function` library block (`SIMFILE` mask parameter = `simfile.sim`, resolved from the model's working directory), a PI controller on the exported yaw rate, saturation, and To Workspace sinks; runs it fixed-step at the exchange rate; and writes `cosim_results.csv`.

3. **Verify in Python**: read `cosim_results.csv` with pandas, convert native units to SI.

## Runtime requirements

1. **PORTS syntax is two numbers**: `PORTS_IMP <array#>,<count>` (e.g. `PORTS_EXP 1,5`). A single number is parsed as the *array number* and can produce an invalid-width error.
2. **Use the library block, not a raw S-Function block**: `Solver_SF/CarSim S-Function` with mask parameter `SIMFILE`. A raw S-Function block whose `Parameters` is `simfile.sim` fails compilation — Simulink evaluates the string as a MATLAB expression (`unable to resolve name`).
3. **Import activation**: use `IMPORT IMP_STEER_SW REPLACE` for the live steering port. `VS_ADD 0` can parse without activating the signal.
4. **To Workspace time is already numeric** — do not wrap it in `seconds()`, which converts doubles into durations and corrupts the exported matrix.
5. **Discrete-Time Integrator has no `Gain` parameter** (name differs across releases) — use gain 1 in the block and a plain Gain block after it.
6. **License still applies** (GUI or `cslm.exe`), same as the headless CLI.
7. Fixed-step solver (`ode1`) with `FixedStep` = `EXT_MODEL_STEP` = solver `TSTEP`.

## Timing and path consistency

The Python examples create one `SimulationConfig` and pass its duration and
`dt` to both the CarSim files and MATLAB model builder. MATLAB builders accept
optional `tstop, dt` arguments; their integrators and fixed-step solver use the
same `dt`. Keep `EXT_MODEL_STEP`, CarSim `TSTEP`, and the MATLAB fixed step
equal.

`PROGDIR` and `DATADIR` must include their trailing path separator because some
native resources concatenate the directory string with a filename. The
generator preserves the separator and disables error dialogs before reading
the base. Python captures MATLAB stdout and stderr in `matlab_output.txt` so
startup and solver errors are reviewable.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall