carla/Docs/python_api.md

569 lines
10 KiB
Markdown

<h1>Python API Reference</h1>
!!! important
Versions prior to 0.9.0 have a very different API. For the documentation of
the stable version please switch to the
[stable branch](https://carla.readthedocs.io/en/stable/).
## `carla.Client`
- `Client(host, port, worker_threads=0)`
- `set_timeout(float_seconds)`
- `get_client_version()`
- `get_server_version()`
- `get_world()`
- `get_available_maps()`
- `reload_world()`
- `load_world(map_name)`
- `start_recorder(string filename)`
- `replay_file(string filename, float start, float duration, int camera_follow_id)`
- `show_recorder_file_info(string filename)`
- `show_recorder_collisions(string filename, char category1, char category2)`
- `show_recorder_actors_blocked(string filename, float min_time, float min_distance)`
- `set_replayer_speed(float time_factor)`
- `apply_batch(commands, do_tick=False)`
- `apply_batch_sync(commands, do_tick=False)` -> list(carla.command.Response)
## `carla.World`
- `id`
- `debug`
- `get_blueprint_library()`
- `get_map()`
- `get_spectator()`
- `get_settings()`
- `apply_settings(world_settings)`
- `get_weather()`
- `set_weather(weather_parameters)`
- `get_actor(actor_id) -> carla.Actor`
- `get_actors(actor_ids=None) -> carla.ActorList`
- `spawn_actor(blueprint, transform, attach_to=None)`
- `try_spawn_actor(blueprint, transform, attach_to=None, attachment_type=carla.AttachmentType.Rigid)`
- `wait_for_tick(seconds=1.0)`
- `on_tick(callback)`
- `tick()`
## `carla.WorldSettings`
- `synchronous_mode`
- `no_rendering_mode`
- `__eq__(other)`
- `__ne__(other)`
## `carla.DebugHelper`
- `draw_point(location, size=0.1, color=carla.Color(), life_time=-1.0, persistent_lines=True)`
- `draw_line(begin, end, thickness=0.1, color=carla.Color(), life_time=-1.0, persistent_lines=True)`
- `draw_arrow(begin, end, thickness=0.1, arrow_size=0.1, color=carla.Color(), life_time=-1.0, persistent_lines=True)`
- `draw_box(box, rotation, thickness=0.1, color=carla.Color(), life_time=-1.0, persistent_lines=True)`
- `draw_string(location, text, draw_shadow=False, color=carla.Color(), life_time=-1.0, persistent_lines=True)`
## `carla.BlueprintLibrary`
- `find(id)`
- `filter(wildcard_pattern)`
- `__getitem__(pos)`
- `__len__()`
- `__iter__()`
## `carla.ActorBlueprint`
- `id`
- `tags`
- `has_tag(tag)`
- `match_tags(wildcard_pattern)`
- `has_attribute(key)`
- `get_attribute(key)`
- `set_attribute(key, value)`
- `__len__()`
- `__iter__()`
## `carla.ActorAttribute`
- `id`
- `type`
- `recommended_values`
- `is_modifiable`
- `as_bool()`
- `as_int()`
- `as_float()`
- `as_str()`
- `as_color()`
- `__eq__(other)`
- `__ne__(other)`
- `__nonzero__()`
- `__bool__()`
- `__int__()`
- `__float__()`
- `__str__()`
## `carla.ActorList`
- `find(id)`
- `filter(wildcard_pattern)`
- `__getitem__(pos)`
- `__len__()`
- `__iter__()`
## `carla.Actor`
- `id`
- `type_id`
- `parent`
- `semantic_tags`
- `is_alive`
- `attributes`
- `get_world()`
- `get_location()`
- `get_transform()`
- `get_velocity()`
- `get_angular_velocity()`
- `get_acceleration()`
- `set_location(location)`
- `set_transform(transform)`
- `set_velocity(vector)`
- `set_angular_velocity(vector)`
- `add_impulse(vector)`
- `set_simulate_physics(enabled=True)`
- `destroy()`
- `__str__()`
## `carla.Vehicle(carla.Actor)`
- `bounding_box`
- `apply_control(vehicle_control)`
- `get_control()`
- `get_physics_control()`
- `apply_physics_control(vehicle_physics_control)`
- `set_autopilot(enabled=True)`
- `get_speed_limit()`
- `get_traffic_light_state()`
- `is_at_traffic_light()`
- `get_traffic_light()`
## `carla.TrafficLight(carla.Actor)`
- `state`
- `set_state(traffic_light_state)`
- `get_state()`
- `set_green_time(green_time)`
- `get_green_time()`
- `set_yellow_time(yellow_time)`
- `get_yellow_time()`
- `set_red_time(red_time)`
- `get_red_time()`
- `get_elapsed_time()`
- `freeze(True)`
- `is_frozen()`
- `get_pole_index()`
- `get_group_traffic_lights()`
## `carla.Sensor(carla.Actor)`
- `is_listening`
- `listen(callback_function)`
- `stop()`
## `carla.SensorData`
- `frame_number`
- `timestamp`
- `transform`
## `carla.Image(carla.SensorData)`
- `width`
- `height`
- `fov`
- `raw_data`
- `convert(color_converter)`
- `save_to_disk(path, color_converter=None)`
- `__len__()`
- `__iter__()`
- `__getitem__(pos)`
- `__setitem__(pos, color)`
## `carla.LidarMeasurement(carla.SensorData)`
- `horizontal_angle`
- `channels`
- `raw_data`
- `get_point_count(channel)`
- `save_to_disk(path)`
- `__len__()`
- `__iter__()`
- `__getitem__(pos)`
- `__setitem__(pos, location)`
## `carla.CollisionEvent(carla.SensorData)`
- `actor`
- `other_actor`
- `normal_impulse`
## `carla.LaneInvasionEvent(carla.SensorData)`
- `actor`
- `crossed_lane_markings`
## `carla.GnssEvent(carla.SensorData)`
- `latitude`
- `longitude`
- `altitude`
## `carla.ObstacleDetectionSensorEvent(carla.SensorData)`
- `actor`
- `other_actor`
- `distance`
## `carla.VehicleControl`
- `throttle`
- `steer`
- `brake`
- `hand_brake`
- `reverse`
- `gear`
- `manual_gear_shift`
- `__eq__(other)`
- `__ne__(other)`
## `carla.WheelsPhysicsControl`
- `tire_friction`
- `damping_rate`
- `max_steer_angle`
- `radius`
- `position`
- `__eq__(other)`
- `__ne__(other)`
## `carla.VehiclePhysicsControl`
- `torque_curve`
- `max_rpm`
- `moi`
- `damping_rate_full_throttle`
- `damping_rate_zero_throttle_clutch_engaged`
- `damping_rate_zero_throttle_clutch_disengaged`
- `use_gear_autobox`
- `gear_switch_time`
- `clutch_strength`
- `mass`
- `drag_coefficient`
- `center_of_mass`
- `steering_curve`
- `wheels`
- `__eq__(other)`
- `__ne__(other)`
## `carla.Map`
- `__init__(name, xodr_content)`
- `name`
- `get_spawn_points()`
- `get_waypoint(location, project_to_road=True, lane_type=carla.LaneType.Driving)`
- `get_topology()`
- `generate_waypoints(distance)`
- `transform_to_geolocation(location)`
- `to_opendrive()`
- `save_to_disk(path=self.name)`
## `carla.LaneType`
- `NONE`
- `Driving`
- `Stop`
- `Shoulder`
- `Biking`
- `Sidewalk`
- `Border`
- `Restricted`
- `Parking`
- `Bidirectional`
- `Median`
- `Special1`
- `Special2`
- `Special3`
- `RoadWorks`
- `Tram`
- `Rail`
- `Entry`
- `Exit`
- `OffRamp`
- `OnRamp`
- `Any`
## `carla.LaneChange`
- `NONE`
- `Right`
- `Left`
- `Both`
## `carla.LaneMarkingColor`
- `Standard = White`
- `Blue`
- `Green`
- `Red`
- `White`
- `Yellow`
- `Other`
## `carla.LaneMarkingType`
- `NONE`
- `Other`
- `Broken`
- `Solid`
- `SolidSolid`
- `SolidBroken`
- `BrokenSolid`
- `BrokenBroken`
- `BottsDots`
- `Grass`
- `Curb`
## `carla.LaneMarking`
- `type` -> carla.LaneMarking
- `color` -> carla.RoadMarkColor
- `lane_change` -> carla.LaneChange
- `width`
## `carla.Waypoint`
- `id`
- `transform`
- `is_intersection` _deprecated, use `is_junction` instead_
- `is_junction`
- `lane_width`
- `road_id`
- `section_id`
- `lane_id`
- `junction_id`
- `s`
- `lane_change` -> carla.LaneChange
- `lane_type` -> carla.LaneType
- `right_lane_marking` -> carla.LaneMarking
- `left_lane_marking` -> carla.LaneMarking
- `next(distance)` -> list(carla.Waypoint)
- `get_right_lane()` -> carla.Waypoint
- `get_left_lane()` -> carla.Waypoint
## `carla.WeatherParameters`
- `cloudyness`
- `precipitation`
- `precipitation_deposits`
- `wind_intensity`
- `sun_azimuth_angle`
- `sun_altitude_angle`
- `__eq__(other)`
- `__ne__(other)`
Static presets
- `carla.WeatherParameters.Default`
- `carla.WeatherParameters.ClearNoon`
- `carla.WeatherParameters.CloudyNoon`
- `carla.WeatherParameters.WetNoon`
- `carla.WeatherParameters.WetCloudyNoon`
- `carla.WeatherParameters.MidRainyNoon`
- `carla.WeatherParameters.HardRainNoon`
- `carla.WeatherParameters.SoftRainNoon`
- `carla.WeatherParameters.ClearSunset`
- `carla.WeatherParameters.CloudySunset`
- `carla.WeatherParameters.WetSunset`
- `carla.WeatherParameters.WetCloudySunset`
- `carla.WeatherParameters.MidRainSunset`
- `carla.WeatherParameters.HardRainSunset`
- `carla.WeatherParameters.SoftRainSunset`
## `carla.Vector2D`
- `x`
- `y`
- `__add__(other)`
- `__sub__(other)`
- `__eq__(other)`
- `__ne__(other)`
## `carla.Vector3D`
- `x`
- `y`
- `z`
- `__add__(other)`
- `__sub__(other)`
- `__eq__(other)`
- `__ne__(other)`
## `carla.Location`
- `x`
- `y`
- `z`
- `distance(other)`
- `__add__(other)`
- `__sub__(other)`
- `__eq__(other)`
- `__ne__(other)`
## `carla.GeoLocation`
- `latitude`
- `longitude`
- `altitude`
- `__eq__(other)`
- `__ne__(other)`
## `carla.Rotation`
- `pitch`
- `yaw`
- `roll`
- `get_forward_vector()`
- `__eq__(other)`
- `__ne__(other)`
## `carla.Transform`
- `location`
- `rotation`
- `transform(geom_object)`
- `get_forward_vector()`
- `__eq__(other)`
- `__ne__(other)`
## `carla.BoundingBox`
- `location`
- `extent`
- `__eq__(other)`
- `__ne__(other)`
## `carla.Timestamp`
- `frame_count`
- `elapsed_seconds`
- `delta_seconds`
- `platform_timestamp`
- `__eq__(other)`
- `__ne__(other)`
## `carla.Color`
- `r`
- `g`
- `b`
- `a`
- `__eq__(other)`
- `__ne__(other)`
## `carla.ColorConverter`
- `Raw`
- `Depth`
- `LogarithmicDepth`
- `CityScapesPalette`
## `carla.AttachmentType`
- `Rigid`
- `SpringArm`
## `carla.ActorAttributeType`
- `Bool`
- `Int`
- `Float`
- `RGBColor`
## `carla.TrafficLightState`
- `Red`
- `Yellow`
- `Green`
- `Off`
- `Unknown`
## `carla.LaneMarking`
- `Other`
- `Broken`
- `Solid`
# module `carla.command`
`carla.command.FutureActor` (not yet spawned actor handler)
## `carla.command.Response`
- `actor_id`
- `error` -> str|empty
- `has_error()`
## `carla.command.SpawnActor`
- `__init__(blueprint, transform, parent=None)`
- `then(command)`
## `carla.command.DestroyActor`
- `__init__(actor)`
- `actor_id`
## `carla.command.ApplyVehicleControl`
- `__init__(actor, control)`
- `actor_id`
- `control`
## `carla.command.ApplyWalkerControl`
- `__init__(actor, control)`
- `actor_id`
- `control`
## `carla.command.ApplyTransform`
- `__init__(actor, transform)`
- `actor_id`
- `transform`
## `carla.command.ApplyVelocity`
- `__init__(actor, velocity)`
- `actor_id`
- `velocity`
## `carla.command.ApplyAngularVelocity`
- `__init__(actor, angular_velocity)`
- `actor_id`
- `angular_velocity`
## `carla.command.ApplyImpulse`
- `__init__(actor, impulse)`
- `actor_id`
- `impulse`
## `carla.command.SetSimulatePhysics`
- `__init__(actor, bool)`
- `actor_id`
- `enabled`
## `carla.command.SetAutopilot`
- `__init__(actor, bool)`
- `actor_id`
- `enabled`