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

scripts/scenario_schema.py

View on GitHub
"""Typed scenario configuration. All vehicle inputs use SI units.

Generic CarSim scenario layer: timing (SimulationConfig), typed vehicle
parameter overrides (VehicleOverrides) and validation of generic scenario
YAML/JSON (validate_scenario / load_scenario against schemas/
scenario.schema.json).
"""
import json
import math
from dataclasses import dataclass, fields
from pathlib import Path
from typing import Optional

from result_contract import channel
from parameters import coerce_structured_overrides


@dataclass(frozen=True)
class SimulationConfig:
    dt: float = 0.001
    duration: float = 30.0

    def __post_init__(self):
        if not all(math.isfinite(x) and x > 0 for x in (self.dt, self.duration)):
            raise ValueError("dt and duration must be finite and positive")
        steps = self.duration / self.dt
        if self.dt < 1e-7 or not math.isclose(steps, round(steps), abs_tol=1e-7, rel_tol=0):
            raise ValueError("duration must be an integral number of steps; dt >= 1e-7 s")


@dataclass(frozen=True)
class VehicleOverrides:
    sprung_mass_kg: Optional[float] = None
    cg_x_m: Optional[float] = None
    cg_y_m: Optional[float] = None
    cg_z_m: Optional[float] = None
    izz_kgm2: Optional[float] = None

    def __post_init__(self):
        for f in fields(self):
            value = getattr(self, f.name)
            if value is not None and not math.isfinite(value):
                raise ValueError("%s must be finite" % f.name)
        for name in ("sprung_mass_kg", "izz_kgm2"):
            value = getattr(self, name)
            if value is not None and value <= 0:
                raise ValueError("%s must be positive" % name)
        if self.cg_z_m is not None and self.cg_z_m < 0:
            raise ValueError("cg_z_m must be nonnegative")

    def keywords(self):
        mapping = {"sprung_mass_kg": ("M_SU", 1), "cg_x_m": ("LX_CG_SU", 1000),
                   "cg_y_m": ("Y_CG_SU", 1000), "cg_z_m": ("H_CG_SU", 1000),
                   "izz_kgm2": ("IZZ_SU", 1)}
        return {key: getattr(self, name) * factor for name, (key, factor) in mapping.items()
                if getattr(self, name) is not None}

    def lines(self):
        return ["%s %.12g" % item for item in self.keywords().items()]


def _validate_maneuver(config, sim):
    for key in ("speed_kmh", "steering_deg"):
        rows = config["maneuver"][key]
        times = [r[0] for r in rows]
        if times[0] != 0 or times[-1] > sim.duration or any(b <= a for a, b in zip(times, times[1:])):
            raise ValueError("%s times must start at zero, increase, and stay within duration" % key)
        if not all(math.isfinite(v) for row in rows for v in row):
            raise ValueError("Nonfinite maneuver value")


def validate_scenario(config):
    """Validate a generic scenario dict: schema plus runtime semantics.

    Every registered output channel, including tire forces, is legal.
    """
    import jsonschema
    schema = Path(__file__).resolve().parents[1] / "schemas" / "scenario.schema.json"
    jsonschema.Draft202012Validator(json.loads(schema.read_text(encoding="utf-8"))).validate(config)
    sim = SimulationConfig(**config["simulation"])
    VehicleOverrides(**config.get("vehicle", {}))
    coerce_structured_overrides(config.get("parameters", []))
    for name in config["outputs"]["channels"]:
        channel(name)  # unregistered units fail closed
        if name == "Time":
            raise ValueError("Time is written automatically; remove it from outputs.channels")
    _validate_maneuver(config, sim)
    if not math.isfinite(config["road"]["friction"]):
        raise ValueError("friction must be finite")
    threshold = config.get("validation", {}).get("minimum_speed_mps", 0)
    if not math.isfinite(threshold):
        raise ValueError("Movement threshold must be finite")
    return config


def load_scenario(path):
    path = Path(path)
    text = path.read_text(encoding="utf-8")
    if path.suffix.lower() == ".json":
        value = json.loads(text)
    else:
        import yaml
        value = yaml.safe_load(text)
    return validate_scenario(value)
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall