--- - module_name: carla # - CLASSES ------------------------------ classes: - class_name: Actor # - DESCRIPTION ------------------------ doc: > CARLA defines actors as anything that plays a role in the simulation or can be moved around. That includes: pedestrians, vehicles, sensors and traffic signs (considering traffic lights as part of these). Actors are spawned in the simulation by carla.World and they need for a carla.ActorBlueprint to be created. These blueprints belong into a library provided by CARLA, find more about them [here](bp_library.md). # - PROPERTIES ------------------------- instance_variables: - var_name: attributes type: dict doc: > A dictionary containing the attributes of the blueprint this actor was based on. - var_name: id type: int doc: > Identifier for this actor. Unique during a given episode. - var_name: type_id type: str doc: > The identifier of the blueprint this actor was based on, e.g. `vehicle.ford.mustang`. - var_name: is_alive type: bool doc: > Returns whether this object was destroyed using this actor handle. - var_name: is_active type: bool doc: > Returns whether this actor is active (True) or not (False). - var_name: is_dormant type: bool doc: > Returns whether this actor is dormant (True) or not (False) - the opposite of is_active. - var_name: parent type: carla.Actor doc: > Actors may be attached to a parent actor that they will follow around. This is said actor. - var_name: semantic_tags type: list(int) doc: > A list of semantic tags provided by the blueprint listing components for this actor. E.g. a traffic light could be tagged with `Pole` and `TrafficLight`. These tags are used by the semantic segmentation sensor. Find more about this and other sensors [here](ref_sensors.md#semantic-segmentation-camera). - var_name: actor_state type: carla.ActorState doc: > Returns the carla.ActorState, which can identify if the actor is Active, Dormant or Invalid. - var_name: bounding_box type: carla.BoundingBox doc: > Bounding box containing the geometry of the actor. Its location and rotation are relative to the actor it is attached to. # - METHODS ---------------------------- methods: - def_name: add_angular_impulse params: - param_name: angular_impulse type: carla.Vector3D param_units: degrees*s doc: > Angular impulse vector in global coordinates. doc: > Applies an angular impulse at the center of mass of the actor. This method should be used for instantaneous torques, usually applied once. Use __add_torque()__ to apply rotation forces over a period of time. # -------------------------------------- - def_name: add_force params: - param_name: force type: carla.Vector3D param_units: N doc: > Force vector in global coordinates. doc: > Applies a force at the center of mass of the actor. This method should be used for forces that are applied over a certain period of time. Use __add_impulse()__ to apply an impulse that only lasts an instant. # -------------------------------------- - def_name: add_impulse params: - param_name: impulse type: carla.Vector3D param_units: N*s doc: > Impulse vector in global coordinates. doc: > Applies an impulse at the center of mass of the actor. This method should be used for instantaneous forces, usually applied once. Use __add_force()__ to apply forces over a period of time. # -------------------------------------- - def_name: add_torque params: - param_name: torque type: carla.Vector3D param_units: degrees doc: > Torque vector in global coordinates. doc: > Applies a torque at the center of mass of the actor. This method should be used for torques that are applied over a certain period of time. Use __add_angular_impulse()__ to apply a torque that only lasts an instant. # -------------------------------------- - def_name: destroy return: bool doc: > Tells the simulator to destroy this actor and returns True if it was successful. It has no effect if it was already destroyed. warning: > This method blocks the script until the destruction is completed by the simulator. # -------------------------------------- - def_name: disable_constant_velocity doc: > Disables any constant velocity previously set for a carla.Vehicle actor. # -------------------------------------- - def_name: enable_constant_velocity params: - param_name: velocity type: carla.Vector3D doc: > Velocity vector in local space. param_units: m/s doc: > Sets a vehicle's velocity vector to a constant value over time. The resulting velocity will be approximately the `velocity` being set, as with __set_target_velocity()__. note: > Only carla.Vehicle actors can use this method. warning: > Enabling a constant velocity for a vehicle managed by the [Traffic Manager](https://carla.readthedocs.io/en/latest/adv_traffic_manager/) may cause conflicts. This method overrides any changes in velocity by the TM. # -------------------------------------- - def_name: get_acceleration return: carla.Vector3D return_units: m/s2 doc: > Returns the actor's 3D acceleration vector the client recieved during last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_angular_velocity return: carla.Vector3D return_units: deg/s doc: > Returns the actor's angular velocity vector the client recieved during last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_location return: carla.Location return_units: meters doc: > Returns the actor's location the client recieved during last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_transform return: carla.Transform doc: > Returns the actor's transform (location and rotation) the client recieved during last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_velocity return: carla.Vector3D return_units: m/s doc: > Returns the actor's velocity vector the client recieved during last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_world return: carla.World doc: > Returns the world this actor belongs to. # -------------------------------------- - def_name: set_target_angular_velocity params: - param_name: angular_velocity type: carla.Vector3D param_units: deg/s doc: > Sets the actor's angular velocity vector. This is applied before the physics step so the resulting angular velocity will be affected by external forces such as friction. # -------------------------------------- - def_name: set_location params: - param_name: location type: carla.Location param_units: meters doc: > Teleports the actor to a given location. # -------------------------------------- - def_name: set_simulate_physics params: - param_name: enabled type: bool default: True doc: > Enables or disables the simulation of physics on this actor. # -------------------------------------- - def_name: set_transform params: - param_name: transform type: carla.Transform doc: > Teleports the actor to a given transform (location and rotation). # -------------------------------------- - def_name: set_target_velocity params: - param_name: velocity type: carla.Vector3D doc: > Sets the actor's velocity vector. This is applied before the physics step so the resulting angular velocity will be affected by external forces such as friction. # -------------------------------------- - def_name: __str__ # -------------------------------------- - def_name: set_enable_gravity params: - param_name: enabled type: bool doc: > Enables or disables gravity for the actor. __Default__ is True. - class_name: ActorState # - DESCRIPTION ------------------------ doc: > Class that defines the state of an actor. # - PROPERTIES ------------------------- instance_variables: - var_name: Invalid doc: > An actor is Invalid if a problem has occurred. - var_name: Active doc: > An actor is Active when it visualized and can affect other actors. - var_name: Dormant doc: > An actor is Dormant when it is not visualized and will not affect other actors through physics. For example, actors are dormant if they are on an unloaded tile in a large map. - class_name: VehicleLightState # - DESCRIPTION ------------------------ doc: > Class that recaps the state of the lights of a vehicle, these can be used as a flags. E.g: `VehicleLightState.HighBeam & VehicleLightState.Brake` will return `True` when both are active. Lights are off by default in any situation and should be managed by the user via script. The blinkers blink automatically. _Warning: Right now, not all vehicles have been prepared to work with this functionality, this will be added to all of them in later updates_ # - PROPERTIES ------------------------- instance_variables: - var_name: NONE doc: > All lights off - var_name: Position - var_name: LowBeam - var_name: HighBeam - var_name: Brake - var_name: RightBlinker - var_name: LeftBlinker - var_name: Reverse - var_name: Fog - var_name: Interior - var_name: Special1 doc: > This is reserved for certain vehicles that can have special lights, like a siren. - var_name: Special2 doc: > This is reserved for certain vehicles that can have special lights, like a siren. - var_name: All doc: > All lights on - class_name: Vehicle parent: carla.Actor # - DESCRIPTION ------------------------ doc: > One of the most important groups of actors in CARLA. These include any type of vehicle from cars to trucks, motorbikes, vans, bycicles and also official vehicles such as police cars. A wide set of these actors is provided in carla.BlueprintLibrary to facilitate differente requirements. Vehicles can be either manually controlled or set to an autopilot mode that will be conducted client-side by the traffic manager. # - PROPERTIES ------------------------- instance_variables: - var_name: bounding_box type: carla.BoundingBox doc: > Bounding box containing the geometry of the vehicle. Its location and rotation are relative to the vehicle it is attached to. # - METHODS ---------------------------- methods: - def_name: apply_control params: - param_name: control type: carla.VehicleControl doc: > Applies a control object on the next tick, containing driving parameters such as throttle, steering or gear shifting. # -------------------------------------- - def_name: apply_ackermann_control params: - param_name: control type: carla.VehicleAckermannControl doc: > Applies an Ackermann control object on the next tick. # -------------------------------------- - def_name: apply_ackermann_controller_settings params: - param_name: settings type: carla.AckermannControllerSettings doc: > Applies a new Ackermann control settings to this vehicle in the next tick. warning: This method does call the simulator. # -------------------------------------- - def_name: get_ackermann_controller_settings return: carla.AckermannControllerSettings doc: > Returns the last Ackermann control settings applied to this vehicle. warning: This method does call the simulator to retrieve the value. # -------------------------------------- - def_name: apply_physics_control params: - param_name: physics_control type: carla.VehiclePhysicsControl doc: > Applies a physics control object in the next tick containing the parameters that define the vehicle as a corporeal body. E.g.: moment of inertia, mass, drag coefficient and many more. # -------------------------------------- - def_name: is_at_traffic_light return: bool doc: > Vehicles will be affected by a traffic light when the light is red and the vehicle is inside its bounding box. The client returns whether a traffic light is affecting this vehicle according to last tick (it does not call the simulator). # -------------------------------------- - def_name: get_control return: carla.VehicleControl doc: > The client returns the control applied in the last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_light_state return: carla.VehicleLightState doc: > Returns a flag representing the vehicle light state, this represents which lights are active or not. # -------------------------------------- - def_name: get_physics_control return: carla.VehiclePhysicsControl doc: > The simulator returns the last physics control applied to this vehicle. warning: This method does call the simulator to retrieve the value. # -------------------------------------- - def_name: get_speed_limit return: float return_units: km/h doc: > The client returns the speed limit affecting this vehicle according to last tick (it does not call the simulator). The speed limit is updated when passing by a speed limit signal, so a vehicle might have none right after spawning. # -------------------------------------- - def_name: get_traffic_light return: carla.TrafficLight doc: > Retrieves the traffic light actor affecting this vehicle (if any) according to last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_traffic_light_state return: carla.TrafficLightState doc: > The client returns the state of the traffic light affecting this vehicle according to last tick. The method does not call the simulator. If no traffic light is currently affecting the vehicle, returns green. # -------------------------------------- - def_name: enable_carsim params: - param_name: simfile_path type: str doc: > Path to the `.simfile` file with the parameters of the simulation. doc: > Enables the CarSim physics solver for this particular vehicle. In order for this function to work, there needs to be a valid license manager running on the server side. The control inputs are redirected to CarSim which will provide the position and orientation of the vehicle for every frame. # -------------------------------------- - def_name: use_carsim_road params: - param_name: enabled type: bool doc: > Enables or disables the usage of CarSim vs terrain file specified in the `.simfile`. By default this option is disabled and CarSim uses unreal engine methods to process the geometry of the scene. # -------------------------------------- - def_name: enable_chrono_physics params: - param_name: max_substeps type: int doc: > Max number of Chrono substeps - param_name: max_substep_delta_time type: int doc: > Max size of substep - param_name: vehicle_json type: str doc: > Path to vehicle json file relative to `base_json_path` - param_name: powertrain_json type: str doc: > Path to powertrain json file relative to `base_json_path` - param_name: tire_json type: str doc: > Path to tire json file relative to `base_json_path` - param_name: base_json_path type: str doc: > Path to `chrono/data/vehicle` folder. E.g., `/home/user/carla/Build/chrono-install/share/chrono/data/vehicle/` (the final `/` character is required). doc: > Enables Chrono physics on a spawned vehicle. note: > Ensure that you have started the CARLA server with the `ARGS="--chrono"` flag. You will not be able to use Chrono physics without this flag set. warning: > Collisions are not supported. When a collision is detected, physics will revert to the default CARLA physics. # -------------------------------------- - def_name: set_autopilot params: - param_name: enabled type: bool default: True - param_name: port type: uint16 default: 8000 doc: > The port of the TM-Server where the vehicle is to be registered or unlisted. If __None__ is passed, it will consider a TM at default port `8000`. doc: > Registers or deletes the vehicle from a Traffic Manager's list. When __True__, the Traffic Manager passed as parameter will move the vehicle around. The autopilot takes place client-side. # -------------------------------------- - def_name: set_light_state params: - param_name: light_state type: carla.VehicleLightState doc: > Sets the light state of a vehicle using a flag that represents the lights that are on and off. # -------------------------------------- - def_name: __str__ # -------------------------------------- - def_name: set_wheel_steer_direction params: - param_name: wheel_location type: carla.VehicleWheelLocation - param_name: angle_in_deg type: float doc: > Sets the angle of a vehicle's wheel visually. warning: > Does not affect the physics of the vehicle. # -------------------------------------- - def_name: get_wheel_steer_angle return: float params: - param_name: wheel_location type: carla.VehicleWheelLocation doc: > Returns the physics angle in degrees of a vehicle's wheel. note: > Returns the angle based on the physics of the wheel, not the visual angle. # -------------------------------------- - def_name: get_failure_state return: carla.VehicleFailureState doc: > Vehicle have failure states, to indicate that it is incapable of continuing its route. This function returns the vehicle's specific failure state, or in other words, the cause that resulted in it. # -------------------------------------- - def_name: show_debug_telemetry params: - param_name: enabled type: bool default: True doc: > Enables or disables the telemetry on this vehicle. This shows information about the vehicles current state and forces applied to it in the spectator window. Only information for one vehicle can be shown so that, if you enable a second one, the previous will be automatically disabled. # -------------------------------------- - def_name: open_door params: - param_name: door_idx type: carla.VehicleDoor doc: > door index doc: > Open the door `door_idx` if the vehicle has it. Use carla.VehicleDoor.All to open all available doors. # -------------------------------------- - def_name: close_door params: - param_name: door_idx type: carla.VehicleDoor doc: > door index doc: > Close the door `door_idx` if the vehicle has it. Use carla.VehicleDoor.All to close all available doors. - class_name: Walker parent: carla.Actor # - DESCRIPTION ------------------------ doc: > This class inherits from the carla.Actor and defines pedestrians in the simulation. Walkers are a special type of actor that can be controlled either by an AI (carla.WalkerAIController) or manually via script, using a series of carla.WalkerControl to move these and their skeletons. # - PROPERTIES ------------------------- # - METHODS ---------------------------- methods: - def_name: apply_control params: - param_name: control type: carla.WalkerControl doc: > On the next tick, the control will move the walker in a certain direction with a certain speed. Jumps can be commanded too. # -------------------------------------- - def_name: get_control return: carla.WalkerControl doc: > The client returns the control applied to this walker during last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_bones return: carla.WalkerBoneControlOut doc: > Return the structure with all the bone transformations from the actor. For each bone, we get the name and its transform in three different spaces: - name: bone name - world: transform in world coordinates - component: transform based on the pivot of the actor - relative: transform based on the bone parent # -------------------------------------- - def_name: set_bones params: - param_name: bones type: carla.WalkerBoneControlIn param_units: list of pairs (bone_name, transform) for the bones that we want to set doc: > Set the bones of the actor. For each bone we want to set we use a relative transform. Only the bones in this list will be set. For each bone you need to setup this info: - name: bone name - relative: transform based on the bone parent # -------------------------------------- - def_name: blend_pose params: - param_name: blend_value type: float param_units: value from 0 to 1 with the blend percentage doc: > Set the blending value of the custom pose with the animation. The values can be: - 0: will show only the animation - 1: will show only the custom pose (set by the user with set_bones()) - any other: will interpolate all the bone positions between animation and the custom pose # -------------------------------------- - def_name: show_pose doc: > Show the custom pose and hide the animation (same as calling blend_pose(1)) # -------------------------------------- - def_name: hide_pose doc: > Hide the custom pose and show the animation (same as calling blend_pose(0)) # -------------------------------------- - def_name: get_pose_from_animation doc: > Make a copy of the current animation frame as the custom pose. Initially the custom pose is the neutral pedestrian pose. # -------------------------------------- - def_name: __str__ # -------------------------------------- - class_name: WalkerAIController parent: carla.Actor # - DESCRIPTION ------------------------ doc: > Class that conducts AI control for a walker. The controllers are defined as actors, but they are quite different from the rest. They need to be attached to a parent actor during their creation, which is the walker they will be controlling (take a look at carla.World if you are yet to learn on how to spawn actors). They also need for a special blueprint (already defined in carla.BlueprintLibrary as "controller.ai.walker"). This is an empty blueprint, as the AI controller will be invisible in the simulation but will follow its parent around to dictate every step of the way. # - METHODS ---------------------------- methods: - def_name: go_to_location params: - param_name: destination type: carla.Location param_units: meters doc: > Sets the destination that the pedestrian will reach. # -------------------------------------- - def_name: start doc: > Enables AI control for its parent walker. # -------------------------------------- - def_name: stop doc: > Disables AI control for its parent walker. # -------------------------------------- - def_name: set_max_speed params: - param_name: speed type: float default: 1.4 param_units: m/s doc: > An easy walking speed is set by default. doc: > Sets a speed for the walker in meters per second. # -------------------------------------- - def_name: __str__ # -------------------------------------- - class_name: TrafficSign parent: carla.Actor # - DESCRIPTION ------------------------ doc: > Traffic signs appearing in the simulation except for traffic lights. These have their own class inherited from this in carla.TrafficLight. Right now, speed signs, stops and yields are mainly the ones implemented, but many others are borne in mind. # - PROPERTIES ------------------------- instance_variables: - var_name: trigger_volume doc: > A carla.BoundingBox situated near a traffic sign where the carla.Actor who is inside can know about it. # -------------------------------------- - class_name: TrafficLightState # - DESCRIPTION ------------------------ doc: > All possible states for traffic lights. These can either change at a specific time step or be changed manually. The snipet in carla.TrafficLight.set_state changes the state of a traffic light on the fly. # - PROPERTIES ------------------------- instance_variables: - var_name: Red - var_name: Yellow - var_name: Green - var_name: 'Off' - var_name: Unknown # -------------------------------------- - class_name: TrafficLight parent: carla.TrafficSign # - DESCRIPTION ------------------------ doc: > A traffic light actor, considered a specific type of traffic sign. As traffic lights will mostly appear at junctions, they belong to a group which contains the different traffic lights in it. Inside the group, traffic lights are differenciated by their pole index. Within a group the state of traffic lights is changed in a cyclic pattern: one index is chosen and it spends a few seconds in green, yellow and eventually red. The rest of the traffic lights remain frozen in red this whole time, meaning that there is a gap in the last seconds of the cycle where all the traffic lights are red. However, the state of a traffic light can be changed manually. # - PROPERTIES ------------------------- instance_variables: - var_name: state type: carla.TrafficLightState doc: > Current state of the traffic light. # - METHODS ---------------------------- methods: - def_name: freeze params: - param_name: freeze type: bool doc: > Stops all the traffic lights in the scene at their current state. # -------------------------------------- - def_name: is_frozen return: bool doc: > The client returns True if a traffic light is frozen according to last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_elapsed_time return: float return_units: seconds doc: > The client returns the time in seconds since current light state started according to last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_group_traffic_lights return: list(carla.TrafficLight) doc: > Returns all traffic lights in the group this one belongs to. note: > This method calls the simulator. # -------------------------------------- - def_name: reset_group doc: > Resets the state of the traffic lights of the group to the initial state at the start of the simulation. note: > This method calls the simulator. # -------------------------------------- - def_name: get_pole_index return: int doc: > Returns the index of the pole that identifies it as part of the traffic light group of a junction. # -------------------------------------- - def_name: get_state return: carla.TrafficLightState doc: > The client returns the state of the traffic light according to last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_green_time return: float return_units: seconds doc: > The client returns the time set for the traffic light to be green, according to last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_red_time return: float return_units: seconds doc: > The client returns the time set for the traffic light to be red, according to last tick. The method does not call the simulator. # -------------------------------------- - def_name: get_yellow_time return: float return_units: seconds doc: > The client returns the time set for the traffic light to be yellow, according to last tick. The method does not call the simulator. # -------------------------------------- - def_name: set_state params: - param_name: state type: carla.TrafficLightState doc: > Sets a given state to a traffic light actor. # -------------------------------------- - def_name: set_green_time params: - param_name: green_time type: float param_units: seconds doc: > Sets a given time for the green light to be active. # -------------------------------------- - def_name: set_red_time params: - param_name: red_time type: float param_units: seconds doc: > Sets a given time for the red state to be active. # -------------------------------------- - def_name: set_yellow_time params: - param_name: yellow_time type: float param_units: seconds doc: > Sets a given time for the yellow light to be active. # -------------------------------------- - def_name: get_affected_lane_waypoints return: list(carla.Waypoint) doc: > Returns a list of waypoints indicating the positions and lanes where the traffic light is having an effect. # -------------------------------------- - def_name: get_light_boxes return: list(carla.BoundingBox) doc: > Returns a list of the bounding boxes encapsulating each light box of the traffic light. # -------------------------------------- - def_name: get_opendrive_id return: str doc: > Returns the OpenDRIVE id of this traffic light. # -------------------------------------- - def_name: get_stop_waypoints return: list(carla.Waypoint) doc: > Returns a list of waypoints indicating the stop position for the traffic light. These waypoints are computed from the trigger boxes of the traffic light that indicate where a vehicle should stop. # -------------------------------------- - def_name: __str__ # -------------------------------------- - class_name: VehicleWheelLocation doc: > `enum` representing the position of each wheel on a vehicle. Used to identify the target wheel when setting an angle in carla.Vehicle.set_wheel_steer_direction or carla.Vehicle.get_wheel_steer_angle. # - PROPERTIES ------------------------- instance_variables: - var_name: FL_Wheel doc: > Front left wheel of a 4 wheeled vehicle. - var_name: FR_Wheel doc: > Front right wheel of a 4 wheeled vehicle. - var_name: BL_Wheel doc: > Back left wheel of a 4 wheeled vehicle. - var_name: BR_Wheel doc: > Back right wheel of a 4 wheeled vehicle. - var_name: Front_Wheel doc: > Front wheel of a 2 wheeled vehicle. - var_name: Back_Wheel doc: > Back wheel of a 2 wheeled vehicle. # -------------------------------------- - class_name: VehicleDoor doc: > Possible index representing the possible doors that can be open. Notice that not all possible doors are able to open in some vehicles. # - PROPERTIES ------------------------- instance_variables: - var_name: FL doc: > Front left door. - var_name: FR doc: > Front right door. - var_name: RL doc: > Back left door. - var_name: RR doc: > Back right door. - var_name: All doc: > Represents all doors. # -------------------------------------- - class_name: VehicleFailureState # - DESCRIPTION ------------------------ doc: > Enum containing the different failure states of a vehicle, from which the it cannot recover. These are returned by __get_failure_state()__ and only Rollover is currently implemented. # - PROPERTIES ------------------------- instance_variables: - var_name: NONE - var_name: Rollover - var_name: Engine - var_name: TirePuncture ...