1053 lines
43 KiB
YAML
1053 lines
43 KiB
YAML
---
|
|
- module_name: carla
|
|
# - CLASSES ------------------------------
|
|
classes:
|
|
- class_name: SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Base class for all the objects containing data generated by a carla.Sensor. This objects should be the argument of the function said sensor is listening to, in order to work with them. Each of these sensors needs for a specific type of sensor data. Hereunder is a list of the sensors and their corresponding data.<br>
|
|
- Cameras (RGB, depth and semantic segmentation): carla.Image.<br>
|
|
- Collision detector: carla.CollisionEvent.<br>
|
|
- GNSS sensor: carla.GnssMeasurement.<br>
|
|
- IMU sensor: carla.IMUMeasurement.<br>
|
|
- Lane invasion detector: carla.LaneInvasionEvent.<br>
|
|
- LIDAR sensor: carla.LidarMeasurement.<br>
|
|
- Obstacle detector: carla.ObstacleDetectionEvent.<br>
|
|
- Radar sensor: carla.RadarMeasurement.<br>
|
|
- RSS sensor: carla.RssResponse.<br>
|
|
- Semantic LIDAR sensor: carla.SemanticLidarMeasurement.<br>
|
|
- Cooperative awareness messages V2X sensor: carla.CAMEvent.<br>
|
|
- Custom V2X messages V2X sensor: carla.CustomV2XEvent.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: frame
|
|
type: int
|
|
doc: >
|
|
Frame count when the data was generated.
|
|
- var_name: timestamp
|
|
type: float
|
|
var_units: seconds
|
|
doc: >
|
|
Simulation-time when the data was generated.
|
|
- var_name: transform
|
|
type: carla.Transform
|
|
doc: >
|
|
Sensor's transform when the data was generated.
|
|
# --------------------------------------
|
|
|
|
- class_name: ColorConverter
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines conversion patterns that can be applied to a carla.Image in order to show information provided by carla.Sensor. Depth conversions cause a loss of accuracy, as sensors detect depth as <b>float</b> that is then converted to a grayscale value between 0 and 255. Take a look at the snipet in carla.Sensor.listen to see an example of how to create and save image data for <b>sensor.camera.semantic_segmentation</b>.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: CityScapesPalette
|
|
doc: >
|
|
Converts the image to a segmented map using tags provided by the blueprint library. Used by the [semantic segmentation camera](ref_sensors.md#semantic-segmentation-camera).
|
|
- var_name: Depth
|
|
doc: >
|
|
Converts the image to a linear depth map. Used by the [depth camera](ref_sensors.md#depth-camera).
|
|
- var_name: LogarithmicDepth
|
|
doc: >
|
|
Converts the image to a depth map using a logarithmic scale, leading to better precision for small distances at the expense of losing it when further away.
|
|
- var_name: Raw
|
|
doc: >
|
|
No changes applied to the image. Used by the [RGB camera](ref_sensors.md#rgb-camera).
|
|
|
|
- class_name: CityObjectLabel
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Enum declaration that contains the different tags available to filter the bounding boxes returned by carla.World.get_level_bbs(). These values correspond to the [semantic tag](ref_sensors.md#semantic-segmentation-camera) that the elements in the scene have.
|
|
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: None
|
|
- var_name: Buildings
|
|
- var_name: Fences
|
|
- var_name: Other
|
|
- var_name: Pedestrians
|
|
- var_name: Poles
|
|
- var_name: RoadLines
|
|
- var_name: Roads
|
|
- var_name: Sidewalks
|
|
- var_name: TrafficSigns
|
|
- var_name: Vegetation
|
|
- var_name: Car
|
|
- var_name: Bus
|
|
- var_name: Truck
|
|
- var_name: Motorcycle
|
|
- var_name: Bicycle
|
|
- var_name: Rider
|
|
- var_name: Train
|
|
- var_name: Walls
|
|
- var_name: Sky
|
|
- var_name: Ground
|
|
- var_name: Bridge
|
|
- var_name: RailTrack
|
|
- var_name: GuardRail
|
|
- var_name: TrafficLight
|
|
- var_name: Static
|
|
- var_name: Dynamic
|
|
- var_name: Water
|
|
- var_name: Terrain
|
|
- var_name: Any
|
|
|
|
- class_name: Image
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines an image of 32-bit BGRA colors that will be used as initial data retrieved by camera sensors. There are different camera sensors (currently three, RGB, depth and semantic segmentation) and each of these makes different use for the images. Learn more about them [here](ref_sensors.md).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: fov
|
|
type: float
|
|
var_units: degrees
|
|
doc: >
|
|
Horizontal field of view of the image.
|
|
- var_name: height
|
|
type: int
|
|
doc: >
|
|
Image height in pixels.
|
|
- var_name: width
|
|
type: int
|
|
doc: >
|
|
Image width in pixels.
|
|
- var_name: raw_data
|
|
type: bytes
|
|
doc: >
|
|
Flattened array of pixel data, use reshape to create an image array.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: convert
|
|
params:
|
|
- param_name: color_converter
|
|
type: carla.ColorConverter
|
|
doc: >
|
|
Converts the image following the `color_converter` pattern.
|
|
# --------------------------------------
|
|
- def_name: save_to_disk
|
|
params:
|
|
- param_name: path
|
|
type: str
|
|
doc: >
|
|
Path that will contain the image.
|
|
- param_name: color_converter
|
|
type: carla.ColorConverter
|
|
default: Raw
|
|
doc: >
|
|
Default <b>Raw</b> will make no changes.
|
|
doc: >
|
|
Saves the image to disk using a converter pattern stated as `color_converter`. The default conversion pattern is <b>Raw</b> that will make no changes to the image.
|
|
# --------------------------------------
|
|
- def_name: __getitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the carla.Color that form the image.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
- def_name: __setitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
- param_name: color
|
|
type: carla.Color
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: OpticalFlowImage
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines an optical flow image of 2-Dimension float (32-bit) vectors representing the optical flow detected in the field of view. The components of the vector represents the displacement of an object in the image plane. Each component outputs values in the normalized range [-2,2] which scales to [-2 size, 2 size] with size being the total resolution in the corresponding component.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: fov
|
|
type: float
|
|
var_units: degrees
|
|
doc: >
|
|
Horizontal field of view of the image.
|
|
- var_name: height
|
|
type: int
|
|
doc: >
|
|
Image height in pixels.
|
|
- var_name: width
|
|
type: int
|
|
doc: >
|
|
Image width in pixels.
|
|
- var_name: raw_data
|
|
type: bytes
|
|
doc: >
|
|
Flattened array of pixel data, use reshape to create an image array.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: get_color_coded_flow
|
|
return: carla.Image
|
|
doc: >
|
|
Visualization helper. Converts the optical flow image to an RGB image.
|
|
# --------------------------------------
|
|
- def_name: __getitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the carla.OpticalFlowPixel that form the image.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
- def_name: __setitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
- param_name: color
|
|
type: carla.Color
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: LidarMeasurement
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines the LIDAR data retrieved by a <b>sensor.lidar.ray_cast</b>. This essentially simulates a rotating LIDAR using ray-casting. Learn more about this [here](ref_sensors.md#lidar-raycast-sensor).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: channels
|
|
type: int
|
|
doc: >
|
|
Number of lasers shot.
|
|
# --------------------------------------
|
|
- var_name: horizontal_angle
|
|
type: float
|
|
var_units: radians
|
|
doc: >
|
|
Horizontal angle the LIDAR is rotated at the time of the measurement.
|
|
# --------------------------------------
|
|
- var_name: raw_data
|
|
type: bytes
|
|
doc: >
|
|
Received list of 4D points. Each point consists of [x,y,z] coordinates plus the intensity computed for that point.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: save_to_disk
|
|
params:
|
|
- param_name: path
|
|
type: str
|
|
doc: >
|
|
Saves the point cloud to disk as a <b>.ply</b> file describing data from 3D scanners. The files generated are ready to be used within [MeshLab](http://www.meshlab.net/), an open source system for processing said files. Just take into account that axis may differ from Unreal Engine and so, need to be reallocated.
|
|
# --------------------------------------
|
|
- def_name: get_point_count
|
|
params:
|
|
- param_name: channel
|
|
type: int
|
|
doc: >
|
|
Retrieves the number of points sorted by channel that are generated by this measure. Sorting by channel allows to identify the original channel for every point.
|
|
# --------------------------------------
|
|
- def_name: __getitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the carla.LidarDetection retrieved as data.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
- def_name: __setitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
- param_name: detection
|
|
type: carla.LidarDetection
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
|
|
- class_name: LidarDetection
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Data contained inside a carla.LidarMeasurement. Each of these represents one of the points in the cloud with its location and its associated intensity.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: point
|
|
type: carla.Location
|
|
var_units: meters
|
|
doc: >
|
|
Point in xyz coordinates.
|
|
# --------------------------------------
|
|
- var_name: intensity
|
|
type: float
|
|
doc: >
|
|
Computed intensity for this point as a scalar value between [0.0 , 1.0].
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: SemanticLidarMeasurement
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines the semantic LIDAR data retrieved by a <b>sensor.lidar.ray_cast_semantic</b>. This essentially simulates a rotating LIDAR using ray-casting. Learn more about this [here](ref_sensors.md#semanticlidar-raycast-sensor).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: channels
|
|
type: int
|
|
doc: >
|
|
Number of lasers shot.
|
|
# --------------------------------------
|
|
- var_name: horizontal_angle
|
|
type: float
|
|
var_units: radians
|
|
doc: >
|
|
Horizontal angle the LIDAR is rotated at the time of the measurement.
|
|
# --------------------------------------
|
|
- var_name: raw_data
|
|
type: bytes
|
|
doc: >
|
|
Received list of raw detection points. Each point consists of [x,y,z] coordinates plus the cosine of the incident angle, the index of the hit actor, and its semantic tag.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: save_to_disk
|
|
params:
|
|
- param_name: path
|
|
type: str
|
|
doc: >
|
|
Saves the point cloud to disk as a <b>.ply</b> file describing data from 3D scanners. The files generated are ready to be used within [MeshLab](http://www.meshlab.net/), an open-source system for processing said files. Just take into account that axis may differ from Unreal Engine and so, need to be reallocated.
|
|
# --------------------------------------
|
|
- def_name: get_point_count
|
|
params:
|
|
- param_name: channel
|
|
type: int
|
|
doc: >
|
|
Retrieves the number of points sorted by channel that are generated by this measure. Sorting by channel allows to identify the original channel for every point.
|
|
# --------------------------------------
|
|
- def_name: __getitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the carla.SemanticLidarDetection retrieved as data.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
- def_name: __setitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
- param_name: detection
|
|
type: carla.SemanticLidarDetection
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: SemanticLidarDetection
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Data contained inside a carla.SemanticLidarMeasurement. Each of these represents one of the points in the cloud with its location, the cosine of the incident angle, index of the object hit, and its semantic tag.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: point
|
|
type: carla.Location
|
|
var_units: meters
|
|
doc: >
|
|
[x,y,z] coordinates of the point.
|
|
# --------------------------------------
|
|
- var_name: cos_inc_angle
|
|
type: float
|
|
doc: >
|
|
Cosine of the incident angle between the ray, and the normal of the hit object.
|
|
# --------------------------------------
|
|
- var_name: object_idx
|
|
type: uint
|
|
doc: >
|
|
ID of the actor hit by the ray.
|
|
# --------------------------------------
|
|
- var_name: object_tag
|
|
type: uint
|
|
doc: >
|
|
[Semantic tag](https://carla.readthedocs.io/en/latest/ref_sensors/#semantic-segmentation-camera) of the component hit by the ray.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: CollisionEvent
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines a collision data for <b>sensor.other.collision</b>. The sensor creates one of these for every collision detected. Each collision sensor produces one collision event per collision per frame. Multiple collision events may be produced in a single frame by collisions with multiple other actors. Learn more about this [here](ref_sensors.md#collision-detector).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: actor
|
|
type: carla.Actor
|
|
doc: >
|
|
The actor the sensor is attached to, the one that measured the collision.
|
|
- var_name: other_actor
|
|
type: carla.Actor
|
|
doc: >
|
|
The second actor involved in the collision.
|
|
- var_name: normal_impulse
|
|
type: carla.Vector3D
|
|
var_units: N*s
|
|
doc: >
|
|
Normal impulse resulting of the collision.
|
|
|
|
- class_name: ObstacleDetectionEvent
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines the obstacle data for <b>sensor.other.obstacle</b>. Learn more about this [here](ref_sensors.md#obstacle-detector).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: actor
|
|
type: carla.Actor
|
|
doc: >
|
|
The actor the sensor is attached to.
|
|
- var_name: other_actor
|
|
type: carla.Actor
|
|
doc: >
|
|
The actor or object considered to be an obstacle.
|
|
- var_name: distance
|
|
type: float
|
|
var_units: meters
|
|
doc: >
|
|
Distance between `actor` and `other`.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: LaneInvasionEvent
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines lanes invasion for <b>sensor.other.lane_invasion</b>. It works only client-side and is dependant on OpenDRIVE to provide reliable information. The sensor creates one of this every time there is a lane invasion, which may be more than once per simulation step. Learn more about this [here](ref_sensors.md#lane-invasion-detector).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: actor
|
|
type: carla.Actor
|
|
doc: >
|
|
Gets the actor the sensor is attached to, the one that invaded another lane.
|
|
- var_name: crossed_lane_markings
|
|
type: list(carla.LaneMarking)
|
|
doc: >
|
|
List of lane markings that have been crossed and detected by the sensor.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: GnssMeasurement
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines the Gnss data registered by a <b>sensor.other.gnss</b>. It essentially reports its position with the position of the sensor and an OpenDRIVE geo-reference.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: altitude
|
|
type: float
|
|
var_units: meters
|
|
doc: >
|
|
Height regarding ground level.
|
|
- var_name: latitude
|
|
type: float
|
|
var_units: degrees
|
|
doc: >
|
|
North/South value of a point on the map.
|
|
- var_name: longitude
|
|
type: float
|
|
var_units: degrees
|
|
doc: >
|
|
West/East value of a point on the map.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: IMUMeasurement
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines the data registered by a <b>sensor.other.imu</b>, regarding the sensor's transformation according to the current carla.World. It essentially acts as accelerometer, gyroscope and compass.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: accelerometer
|
|
type: carla.Vector3D
|
|
var_units: m/s<sup>2</sup>
|
|
doc: >
|
|
Linear acceleration.
|
|
- var_name: compass
|
|
type: float
|
|
var_units: radians
|
|
doc: >
|
|
Orientation with regard to the North ([0.0, -1.0, 0.0] in Unreal Engine).
|
|
- var_name: gyroscope
|
|
type: carla.Vector3D
|
|
var_units: rad/s
|
|
doc: >
|
|
Angular velocity.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: RadarMeasurement
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines and gathers the measures registered by a <b>sensor.other.radar</b>, representing a wall of points in front of the sensor with a distance, angle and velocity in relation to it. The data consists of a carla.RadarDetection array. Learn more about this [here](ref_sensors.md#radar-sensor).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: raw_data
|
|
type: bytes
|
|
doc: >
|
|
The complete information of the carla.RadarDetection the radar has registered.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: get_detection_count
|
|
doc: >
|
|
Retrieves the number of entries generated, same as **<font color="#7fb800">\__str__()</font>**.
|
|
# --------------------------------------
|
|
- def_name: __getitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the carla.RadarDetection retrieved as data.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
- def_name: __setitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
- param_name: detection
|
|
type: carla.RadarDetection
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: RadarDetection
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Data contained inside a carla.RadarMeasurement. Each of these represents one of the points in the cloud that a <b>sensor.other.radar</b> registers and contains the distance, angle and velocity in relation to the radar.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: altitude
|
|
type: float
|
|
var_units: radians
|
|
doc: >
|
|
Altitude angle of the detection.
|
|
# --------------------------------------
|
|
- var_name: azimuth
|
|
type: float
|
|
var_units: radians
|
|
doc: >
|
|
Azimuth angle of the detection.
|
|
# --------------------------------------
|
|
- var_name: depth
|
|
type: float
|
|
var_units: meters
|
|
doc: >
|
|
Distance from the sensor to the detection position.
|
|
# --------------------------------------
|
|
- var_name: velocity
|
|
type: float
|
|
var_units: m/s
|
|
doc: >
|
|
The velocity of the detected object towards the sensor.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: RssResponse
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that contains the output of a carla.RssSensor. This is the result of the RSS calculations performed for the parent vehicle of the sensor.
|
|
|
|
|
|
A carla.RssRestrictor will use the data to modify the carla.VehicleControl of the vehicle.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: response_valid
|
|
type: bool
|
|
doc: >
|
|
States if the response is valid. It is __False__ if calculations failed or an exception occured.
|
|
# --------------------------------------
|
|
- var_name: proper_response
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/structad_1_1rss_1_1state_1_1ProperResponse.html">ad.rss.state.ProperResponse</a>
|
|
doc: >
|
|
The proper response that the RSS calculated for the vehicle.
|
|
# --------------------------------------
|
|
- var_name: rss_state_snapshot
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/structad_1_1rss_1_1state_1_1RssStateSnapshot.html">ad.rss.state.RssStateSnapshot</a>
|
|
doc: >
|
|
Detailed RSS states at the current moment in time.
|
|
# --------------------------------------
|
|
- var_name: ego_dynamics_on_route
|
|
type: carla.RssEgoDynamicsOnRoute
|
|
doc: >
|
|
Current ego vehicle dynamics regarding the route.
|
|
# --------------------------------------
|
|
- var_name: world_model
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/structad_1_1rss_1_1world_1_1WorldModel.html">ad.rss.world.WorldModel</a>
|
|
doc: >
|
|
World model used for calculations.
|
|
# --------------------------------------
|
|
- var_name: situation_snapshot
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/structad_1_1rss_1_1situation_1_1SituationSnapshot.html">ad.rss.situation.SituationSnapshot</a>
|
|
doc: >
|
|
Detailed RSS situations extracted from the world model.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: RssEgoDynamicsOnRoute
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Part of the data contained inside a carla.RssResponse describing the state of the vehicle. The parameters include its current dynamics, and how it is heading regarding the target route.
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
## ** Missing timestamp and time_since_epoch_check_start_ms
|
|
- var_name: ego_speed
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Speed.html">ad.physics.Speed</a>
|
|
doc: >
|
|
The ego vehicle's speed.
|
|
# --------------------------------------
|
|
- var_name: min_stopping_distance
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Distance.html">ad.physics.Distance</a>
|
|
doc: >
|
|
The current minimum stopping distance.
|
|
# --------------------------------------
|
|
- var_name: ego_center
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/structad_1_1map_1_1point_1_1ENUPoint.html">ad.map.point.ENUPoint</a>
|
|
doc: >
|
|
The considered enu position of the ego vehicle.
|
|
# --------------------------------------
|
|
- var_name: ego_heading
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/classad_1_1map_1_1point_1_1ENUHeading.html">ad.map.point.ENUHeading</a>
|
|
doc: >
|
|
The considered heading of the ego vehicle.
|
|
# --------------------------------------
|
|
- var_name: ego_center_within_route
|
|
type: bool
|
|
doc: >
|
|
States if the ego vehicle's center is within the route.
|
|
# --------------------------------------
|
|
- var_name: crossing_border
|
|
type: bool
|
|
doc: >
|
|
States if the vehicle is already crossing one of the lane borders.
|
|
# --------------------------------------
|
|
- var_name: route_heading
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/classad_1_1map_1_1point_1_1ENUHeading.html">ad.map.point.ENUHeading</a>
|
|
doc: >
|
|
The considered heading of the route.
|
|
# --------------------------------------
|
|
- var_name: route_nominal_center
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/structad_1_1map_1_1point_1_1ENUPoint.html">ad.map.point.ENUPoint</a>
|
|
doc: >
|
|
The considered nominal center of the current route.
|
|
# --------------------------------------
|
|
- var_name: heading_diff
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/classad_1_1map_1_1point_1_1ENUHeading.html">ad.map.point.ENUHeading</a>
|
|
doc: >
|
|
The considered heading diff towards the route.
|
|
# --------------------------------------
|
|
- var_name: route_speed_lat
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Speed.html">ad.physics.Speed</a>
|
|
doc: >
|
|
The ego vehicle's speed component _lat_ regarding the route.
|
|
# --------------------------------------
|
|
- var_name: route_speed_lon
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Speed.html">ad.physics.Speed</a>
|
|
doc: >
|
|
The ego vehicle's speed component _lon_ regarding the route.
|
|
# --------------------------------------
|
|
- var_name: route_accel_lat
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Acceleration.html">ad.physics.Acceleration</a>
|
|
doc: >
|
|
The ego vehicle's acceleration component _lat_ regarding the route.
|
|
# --------------------------------------
|
|
- var_name: route_accel_lon
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Acceleration.html">ad.physics.Acceleration</a>
|
|
doc: >
|
|
The ego vehicle's acceleration component _lon_ regarding the route.
|
|
# --------------------------------------
|
|
- var_name: avg_route_accel_lat
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Acceleration.html">ad.physics.Acceleration</a>
|
|
doc: >
|
|
The ego vehicle's acceleration component _lat_ regarding the route smoothened by an average filter.
|
|
# --------------------------------------
|
|
- var_name: avg_route_accel_lon
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_physics/apidoc/html/classad_1_1physics_1_1Acceleration.html">ad.physics.Acceleration</a>
|
|
doc: >
|
|
The ego acceleration component _lon_ regarding the route smoothened by an average filter.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: RssActorConstellationData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Data structure that is provided within the callback registered by RssSensor.register_actor_constellation_callback().
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: ego_match_object
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/structad_1_1map_1_1match_1_1Object.html">ad.map.match.Object</a>
|
|
doc: >
|
|
The ego map matched information.
|
|
# --------------------------------------
|
|
- var_name: ego_route
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/structad_1_1map_1_1route_1_1FullRoute.html">ad.map.route.FullRoute</a>
|
|
doc: >
|
|
The ego route.
|
|
# --------------------------------------
|
|
- var_name: ego_dynamics_on_route
|
|
type: carla.RssEgoDynamicsOnRoute
|
|
doc: >
|
|
Current ego vehicle dynamics regarding the route.
|
|
# --------------------------------------
|
|
- var_name: other_match_object
|
|
type: <a href="https://ad-map-access.readthedocs.io/en/latest/ad_map_access/apidoc/html/structad_1_1map_1_1match_1_1Object.html">ad.map.match.Object</a>
|
|
doc: >
|
|
The other object's map matched information. This is only valid if 'other_actor' is not 'None'.
|
|
# --------------------------------------
|
|
- var_name: other_actor
|
|
type: carla.Actor
|
|
doc: >
|
|
The other actor. This is 'None' in case of query of default parameters or articial objects of kind <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/namespacead_1_1rss_1_1world.html#a6432f1ef8d0657b4f21ed5966aca1625">ad.rss.world.ObjectType.ArtificialObject</a>
|
|
with no dedicated 'carla.Actor' (as e.g. for the [road boundaries](ref_sensors.md#rss-sensor) at the moment)
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: RssActorConstellationResult
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Data structure that should be returned by the callback registered by RssSensor.register_actor_constellation_callback().
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: rss_calculation_mode
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss_map_integration/namespacead_1_1rss_1_1map.html#adcb01232986ed83a0c540cd5d03ef495">ad.rss.map.RssMode</a>
|
|
doc: >
|
|
The calculation mode to be applied with the actor.
|
|
# --------------------------------------
|
|
- var_name: restrict_speed_limit_mode
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss_map_integration/classad_1_1rss_1_1map_1_1RssSceneCreation.html#a403aae6dce3c77a8aec01dd9808dd964">ad.rss.map.RestrictSpeedLimitMode</a>
|
|
doc: >
|
|
The mode for restricting speed limit.
|
|
# --------------------------------------
|
|
- var_name: ego_vehicle_dynamics
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/structad_1_1rss_1_1world_1_1RssDynamics.html">ad.rss.world.RssDynamics</a>
|
|
doc: >
|
|
The RSS dynamics to be applied for the ego vehicle.
|
|
# --------------------------------------
|
|
- var_name: actor_object_type
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/namespacead_1_1rss_1_1world.html#a6432f1ef8d0657b4f21ed5966aca1625">ad.rss.world.ObjectType</a>
|
|
doc: >
|
|
The RSS object type to be used for the actor.
|
|
# --------------------------------------
|
|
- var_name: actor_dynamics
|
|
type: <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/structad_1_1rss_1_1world_1_1RssDynamics.html">ad.rss.world.RssDynamics</a>
|
|
doc: >
|
|
The RSS dynamics to be applied for the actor.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: DVSEvent
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines a DVS event. An event is a quadruple, so a tuple of 4 elements, with `x`, `y` pixel coordinate location, timestamp `t` and polarity `pol` of the event. Learn more about them [here](ref_sensors.md).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: x
|
|
type: int
|
|
doc: >
|
|
X pixel coordinate.
|
|
# --------------------------------------
|
|
- var_name: 'y'
|
|
type: int
|
|
doc: >
|
|
Y pixel coordinate.
|
|
# --------------------------------------
|
|
- var_name: t
|
|
type: int
|
|
doc: >
|
|
Timestamp of the moment the event happened.
|
|
# --------------------------------------
|
|
- var_name: pol
|
|
type: bool
|
|
doc: >
|
|
Polarity of the event. __True__ for positive and __False__ for negative.
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: DVSEventArray
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines a stream of events in carla.DVSEvent. Such stream is an array of arbitrary size depending on the number of events. This class also stores the field of view, the height and width of the image and the timestamp from convenience. Learn more about them [here](ref_sensors.md).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: fov
|
|
type: float
|
|
var_units: degrees
|
|
doc: >
|
|
Horizontal field of view of the image.
|
|
# --------------------------------------
|
|
- var_name: height
|
|
type: int
|
|
doc: >
|
|
Image height in pixels.
|
|
# --------------------------------------
|
|
- var_name: width
|
|
type: int
|
|
doc: >
|
|
Image width in pixels.
|
|
# --------------------------------------
|
|
- var_name: raw_data
|
|
type: bytes
|
|
# - METHODS ----------------------------
|
|
methods:
|
|
- def_name: to_image
|
|
doc: >
|
|
Converts the image following this pattern: blue indicates positive events, red indicates negative events.
|
|
# --------------------------------------
|
|
- def_name: to_array
|
|
doc: >
|
|
Converts the stream of events to an array of int values in the following order <code>[x, y, t, pol]</code>.
|
|
# --------------------------------------
|
|
- def_name: to_array_x
|
|
doc: >
|
|
Returns an array with X pixel coordinate of all the events in the stream.
|
|
# --------------------------------------
|
|
- def_name: to_array_y
|
|
doc: >
|
|
Returns an array with Y pixel coordinate of all the events in the stream.
|
|
# --------------------------------------
|
|
- def_name: to_array_t
|
|
doc: >
|
|
Returns an array with the timestamp of all the events in the stream.
|
|
# --------------------------------------
|
|
- def_name: to_array_pol
|
|
doc: >
|
|
Returns an array with the polarity of all the events in the stream.
|
|
# --------------------------------------
|
|
- def_name: __getitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the carla.DVSEvent retrieved as data.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
- def_name: __setitem__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
- param_name: color
|
|
type: carla.Color
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: GBufferTextureID
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Defines the of each GBuffer texture (See the method `carla.Sensor.listen_to_gbuffer`).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: SceneColor
|
|
doc: >
|
|
The texture "SceneColor" contains the final color of the image.
|
|
- var_name: SceneDepth
|
|
doc: >
|
|
The texture "SceneDepth" contains the depth buffer - linear in world units.
|
|
- var_name: SceneStencil
|
|
doc: >
|
|
The texture "SceneStencil" contains the stencil buffer.
|
|
- var_name: GBufferA
|
|
doc: >
|
|
The texture "GBufferA" contains the world-space normal vectors in the RGB channels. The alpha channel contains "per-object data".
|
|
- var_name: GBufferB
|
|
doc: >
|
|
The texture "GBufferB" contains the metallic, specular and roughness in the RGB channels, respectively. The alpha channel contains a mask where the lower 4 bits indicate the shading model and the upper 4 bits contain the selective output mask.
|
|
- var_name: GBufferC
|
|
doc: >
|
|
The texture "GBufferC" contains the diffuse color in the RGB channels, with the indirect irradiance in the alpha channel.<br>
|
|
If static lightning is not allowed, the alpha channel will contain the ambient occlusion instead.
|
|
- var_name: GBufferD
|
|
doc: >
|
|
The contents of the "GBufferD" varies depending on the rendered object's material shading model (GBufferB):<br>
|
|
- MSM_Subsurface (2), MSM_PreintegratedSkin (3), MSM_TwoSidedFoliage (6):<br>
|
|
RGB: Subsurface color.<br>
|
|
A: Opacity.<br>
|
|
- MSM_ClearCoat (4):<br>
|
|
R: Clear coat.<br>
|
|
G: Roughness.<br>
|
|
- MSM_SubsurfaceProfile (5):<br>
|
|
RGB: Subsurface profile.<br>
|
|
- MSM_Hair (7):<br>
|
|
RG: World normal.<br>
|
|
B: Backlit value.<br>
|
|
- MSM_Cloth (8):<br>
|
|
RGB: Subsurface color.<br>
|
|
A: Cloth value.<br>
|
|
- MSM_Eye (9):<br>
|
|
RG: Eye tangent.<br>
|
|
B: Iris mask.<br>
|
|
A: Iris distance.
|
|
- var_name: GBufferE
|
|
doc: >
|
|
The texture "GBufferE" contains the precomputed shadow factors in the RGBA channels. This texture is unavailable if the selective output mask (GBufferB) does not have its 4th bit set.
|
|
- var_name: GBufferF
|
|
doc: >
|
|
The texture "GBufferF" contains the world-space tangent in the RGB channels and the anisotropy in the alpha channel. This texture is unavailable if the selective output mask (GBufferB) does not have its 5th bit set.
|
|
- var_name: Velocity
|
|
doc: >
|
|
The texture "Velocity" contains the screen-space velocity of the scene objects.
|
|
- var_name: SSAO
|
|
doc: >
|
|
The texture "SSAO" contains the screen-space ambient occlusion texture.
|
|
- var_name: CustomDepth
|
|
doc: >
|
|
The texture "CustomDepth" contains the Unreal Engine custom depth data.
|
|
- var_name: CustomStencil
|
|
doc: >
|
|
The texture "CustomStencil" contains the Unreal Engine custom stencil data.
|
|
# --------------------------------------
|
|
|
|
|
|
- class_name: CAMData
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
This is the data type for cooperative awareness message reception, contained in a [CAMEvent](#carlacamevent)
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: power
|
|
type: float - dBm
|
|
doc: >
|
|
Received power.
|
|
|
|
# - METHODS ----------------------------
|
|
# --------------------------------------
|
|
methods:
|
|
- def_name: get
|
|
return: dict
|
|
doc: >
|
|
Get the CAM data. Returns a nested dictionary containing the message following the ETSI standard: - `Header`: dict - `Message`: dict
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
- class_name: CAMEvent
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines the data provided by a **sensor.other.v2x**. This is a collection type to combine returning several [CAMData](#carlacamdata).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
|
|
# - METHODS ----------------------------
|
|
# --------------------------------------
|
|
methods:
|
|
- def_name: get_message_count
|
|
return: int
|
|
doc: >
|
|
Get the number of received CAM's.
|
|
# --------------------------------------
|
|
- def_name: __get_item__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the [CAMData](#carlacamdata) retrieved as data.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
|
|
|
|
- class_name: CustomV2XEvent
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
Class that defines the data provided by a **sensor.other.v2x_custom**. This is a collection type to combine returning several [CustomV2XData](#carlacustomv2xdata).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
|
|
# - METHODS ----------------------------
|
|
# --------------------------------------
|
|
methods:
|
|
- def_name: get_message_count
|
|
return: int
|
|
doc: >
|
|
Get the number of received CAM's.
|
|
# --------------------------------------
|
|
- def_name: __get_item__
|
|
params:
|
|
- param_name: pos
|
|
type: int
|
|
# --------------------------------------
|
|
- def_name: __iter__
|
|
doc: >
|
|
Iterate over the [CustomV2XData](#carlacustomv2xdata) retrieved as data.
|
|
# --------------------------------------
|
|
- def_name: __len__
|
|
# --------------------------------------
|
|
|
|
|
|
- class_name: CustomV2XData
|
|
parent: carla.SensorData
|
|
# - DESCRIPTION ------------------------
|
|
doc: >
|
|
This is the data type defining a custom V2X message. Received as part of a [CustomV2XEvent](#carlacustomv2xevent).
|
|
# - PROPERTIES -------------------------
|
|
instance_variables:
|
|
- var_name: power
|
|
type: float - dBm
|
|
doc: >
|
|
Received power.
|
|
|
|
# - METHODS ----------------------------
|
|
# --------------------------------------
|
|
methods:
|
|
- def_name: get
|
|
return: dict
|
|
doc: >
|
|
Get the custom message. Returns a nested dictionary containing the message. It has two primary keys: - `Header` : dict - `Message`: str
|
|
# --------------------------------------
|
|
- def_name: __str__
|
|
# --------------------------------------
|
|
|
|
|
|
...
|