carsim-guide
VerifiedOperate 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.
references/outputs-and-units.md
View on GitHub# Output discovery and units
Use `scripts/output_registry.py` as the authority for verified channel names,
native units, SI conversions, categories, descriptions, and aliases.
## Unknown output workflow
1. Call `resolve_output_alias(text)`. It performs exact verified alias lookup;
an empty result means “unknown,” not permission to infer a channel.
2. Call `find_output_candidates(text, search_terms=[...], artifacts=[...])`
over relevant prior
`run.csv`, `run_echo.par`, or CarSim output-definition files.
3. Show each candidate with its source line. A candidate without an
`OutputSpec` is weak and must not be requested yet.
4. Confirm the channel spelling and native unit in an authoritative local
definition or successful run, then add a reviewed registry entry and test.
5. Request the verified channel and confirm it is present in the fresh CSV.
`normalize_output_query` returns a `DiscoveryQuery(original, search_terms,
aliases)`. The built-in Chinese mappings translate physical descriptions such
as “前悬架垂向行程” into English *physical search phrases*, never into a
CarSim channel. A candidate channel must still occur literally in an artifact.
Passing `search_terms=[]`, or having no usable terms, returns no candidates.
Candidates expose `channel`, `source`, `matched_text`, `reason`, and
`verification_state` (`registered` or `artifact_match`). Artifact matches do
not mutate `OUTPUT_REGISTRY` and remain unverified until channel meaning and
native unit are confirmed. `find_output_candidates` never fabricates a name.
Do not bulk-add plausible CarSim names for coverage.
## CSV reading contract
```python
read_run_csv("run.csv", columns=["Time", "Vx"])
```
With `columns=[...]`, only requested columns must have registered units; an
unrequested custom column is ignored. With `columns=None`, every retained
column must be registered. Missing Time/requested columns, unknown units, and
non-numeric selected values fail closed. `units="native"` disables SI scaling.
Verified conversions include Vx/Vy km/h→m/s, Ax/Ay g→m/s², angles deg→rad,
angular speeds rpm→rad/s, and force/torque identity conversions.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |