run_scenario
Convert natural language into a validated CARLA scenario and execute it. Supports cut-in, pedestrian, and weather parameters.
Instructions
Generate and execute a CARLA scenario from natural language.
Builds a validated :class:ScenarioManifest from flat parameters and runs
it. At least one of the cut_in_*, pedestrian_*, or weather_*
groups must be provided. Optionally persists the validated spec for replay.
Args:
nl_prompt (str): The natural-language description of the scenario.
cut_in_speed_kmh (Optional[float]): See :func:_build_manifest.
cut_in_ttc_s (Optional[float]): See :func:_build_manifest.
cut_in_side (Optional[str]): See :func:_build_manifest.
cut_in_ego_speed_kmh (float): See :func:_build_manifest.
cut_in_map (str): See :func:_build_manifest.
pedestrian_gap_s (Optional[float]): See :func:_build_manifest.
pedestrian_distance_m (Optional[float]): See :func:_build_manifest.
pedestrian_occluded (bool): See :func:_build_manifest.
weather_condition (Optional[str]): See :func:_build_manifest.
weather_intensity (Optional[float]): See :func:_build_manifest.
save_as (Optional[str]): If given, save the validated spec under this
name for later replay.
Returns:
dict: The execution result, or an error/hint payload if
validation failed.
Examples: Aggressive cut-in from the right at 120 km/h::
run_scenario("...", cut_in_speed_kmh=120, cut_in_ttc_s=1.2,
cut_in_side="right")
Occluded pedestrian crossing 30 m ahead::
run_scenario("...", pedestrian_gap_s=1.5, pedestrian_distance_m=30,
pedestrian_occluded=True)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nl_prompt | Yes | ||
| cut_in_speed_kmh | No | ||
| cut_in_ttc_s | No | ||
| cut_in_side | No | ||
| cut_in_ego_speed_kmh | No | ||
| cut_in_map | No | Town04 | |
| pedestrian_gap_s | No | ||
| pedestrian_distance_m | No | ||
| pedestrian_occluded | No | ||
| weather_condition | No | ||
| weather_intensity | No | ||
| save_as | No |