2019-05-03 18:18:02 +08:00
---
- module_name : carla
2019-05-03 20:56:18 +08:00
# - CLASSES ------------------------------
2019-05-03 18:18:02 +08:00
classes :
2019-05-03 20:56:18 +08:00
- class_name : SensorData
2019-05-03 18:18:02 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-07-03 23:16:31 +08:00
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.
- Cameras (RGB, depth and semantic segmentation) : carla.Image.
- Collision detector : carla.CollisionEvent.
- Gnss detector : carla.GnssMeasurement.
- IMU detector : carla.IMUMeasurement.
- Lane invasion detector : carla.LaneInvasionEvent.
- Lidar raycast : carla.LidarMeasurement.
2020-07-31 07:14:52 +08:00
- SemanticLidar raycast : carla.SemanticLidarMeasurement.
2020-07-03 23:16:31 +08:00
- Obstacle detector : carla.ObstacleDetectionEvent.
- Radar detector : carla.RadarMeasurement.
- RSS sensor : carla.RssResponse.
2019-05-03 18:18:02 +08:00
# - PROPERTIES -------------------------
instance_variables :
2019-07-02 19:10:28 +08:00
- var_name : frame
2019-07-04 17:12:14 +08:00
type : int
2019-05-03 20:56:18 +08:00
doc : >
2019-07-02 19:10:28 +08:00
Frame count when the data was generated.
2019-05-03 20:56:18 +08:00
- var_name : timestamp
2019-07-04 17:12:14 +08:00
type : float
2019-05-03 20:56:18 +08:00
doc : >
2019-07-02 19:10:28 +08:00
Simulation-time when the data was generated.
2019-05-03 20:56:18 +08:00
- var_name : transform
2019-07-04 17:12:14 +08:00
type : carla.Transform
2019-05-03 20:56:18 +08:00
doc : >
2019-07-02 19:10:28 +08:00
Sensor's transform when the data was generated.
2019-07-03 00:32:23 +08:00
# --------------------------------------
2019-05-03 20:56:18 +08:00
- class_name : ColorConverter
# - DESCRIPTION ------------------------
doc : >
2020-04-03 19:57:11 +08:00
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 a this [recipe](ref_code_recipes.md#converted-image-recipe) to see an example of how to create and save image data for <b>sensor.camera.semantic_segmentation</b>.
2019-05-03 20:56:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
2020-02-24 20:58:54 +08:00
- var_name : CityScapesPalette
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
Converts the image to a segmentated map using tags provided by the blueprint library. Used by <b>sensor.camera.semantic_segmentation</b>.
2019-05-03 20:56:18 +08:00
- var_name : Depth
doc : >
2020-04-03 19:57:11 +08:00
Converts the image to a linear depth map. Used by <b>sensor.camera.depth</b>.
2019-05-03 20:56:18 +08:00
- var_name : LogarithmicDepth
doc : >
2020-04-03 19:57:11 +08:00
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.
2020-02-24 20:58:54 +08:00
- var_name : Raw
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
No changes applied to the image.
2019-05-03 20:56:18 +08:00
- class_name : Image
2019-06-05 21:05:57 +08:00
parent : carla.SensorData
2019-05-03 20:56:18 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-03-30 17:18:13 +08:00
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).
2019-05-03 20:56:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
2020-02-24 20:58:54 +08:00
- var_name : fov
type : float
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
Horizontal field of view of the image in degrees.
2019-05-03 20:56:18 +08:00
- var_name : height
2019-07-03 22:18:21 +08:00
type : int
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
Image height in pixels.
2020-02-24 20:58:54 +08:00
- var_name : width
type : int
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
Image width in pixels.
2019-05-03 20:56:18 +08:00
- var_name : raw_data
2019-07-03 22:18:21 +08:00
type : bytes
2019-05-03 20:56:18 +08:00
# - METHODS ----------------------------
methods :
- def_name : convert
2019-07-02 19:10:28 +08:00
params :
- param_name : color_converter
type : carla.ColorConverter
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
Converts the image following the `color_converter` pattern.
2019-05-03 20:56:18 +08:00
# --------------------------------------
- def_name : save_to_disk
2019-07-02 19:10:28 +08:00
params :
- param_name : path
type : str
2019-08-03 02:15:14 +08:00
doc : >
2020-04-03 19:57:11 +08:00
Path that will contain the image.
2019-07-02 19:10:28 +08:00
- param_name : color_converter
type : carla.ColorConverter
default : Raw
2020-02-24 20:58:54 +08:00
doc : >
2020-04-03 19:57:11 +08:00
Default <b>Raw</b> will make no changes.
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
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.
2019-05-03 20:56:18 +08:00
# --------------------------------------
- def_name : __getitem__
2019-07-02 19:10:28 +08:00
params :
- param_name : pos
2019-07-03 22:18:21 +08:00
type : int
2019-05-03 20:56:18 +08:00
# --------------------------------------
2020-03-30 17:18:13 +08:00
- def_name : __iter__
# --------------------------------------
- def_name : __len__
# --------------------------------------
2019-05-03 20:56:18 +08:00
- def_name : __setitem__
2019-07-02 19:10:28 +08:00
params :
- param_name : pos
2019-07-03 22:18:21 +08:00
type : int
2019-07-02 19:10:28 +08:00
- param_name : color
type : carla.Color
# --------------------------------------
- def_name : __str__
2019-05-03 20:56:18 +08:00
# --------------------------------------
- class_name : LidarMeasurement
2019-06-05 21:05:57 +08:00
parent : carla.SensorData
2019-05-03 20:56:18 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-03-30 17:18:13 +08:00
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).
2019-05-03 20:56:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : channels
2019-07-03 22:18:21 +08:00
type : int
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
Number of lasers shot.
2020-02-24 20:58:54 +08:00
- var_name : horizontal_angle
type : float
doc : >
Horizontal angle the Lidar is rotated at the time of the measurement (in radians).
2019-05-03 20:56:18 +08:00
- var_name : raw_data
2019-07-03 22:18:21 +08:00
type : bytes
2019-05-03 18:18:02 +08:00
doc : >
2020-07-03 00:25:49 +08:00
Received list of 4D points. Each point consists in a 3D-xyz data plus the intensity computed for that point.
2019-05-03 18:18:02 +08:00
# - METHODS ----------------------------
methods :
2019-05-03 20:56:18 +08:00
- def_name : save_to_disk
2019-07-02 19:10:28 +08:00
params :
2019-11-14 01:50:21 +08:00
- param_name : path
2019-07-02 19:10:28 +08:00
type : str
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
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.
2019-05-03 20:56:18 +08:00
# --------------------------------------
2020-03-30 17:18:13 +08:00
- 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.
2019-05-03 20:56:18 +08:00
# --------------------------------------
- def_name : __getitem__
2019-07-02 19:10:28 +08:00
params :
- param_name : pos
2019-07-03 22:18:21 +08:00
type : int
2019-05-03 20:56:18 +08:00
# --------------------------------------
2020-03-30 17:18:13 +08:00
- def_name : __iter__
# --------------------------------------
- def_name : __len__
# --------------------------------------
2019-05-03 20:56:18 +08:00
- def_name : __setitem__
2019-07-02 19:10:28 +08:00
params :
- param_name : pos
2019-07-03 22:18:21 +08:00
type : int
2020-07-07 23:25:05 +08:00
- param_name : detection
type : carla.LidarDetection
2019-07-02 19:10:28 +08:00
# --------------------------------------
- def_name : __str__
2019-05-03 20:56:18 +08:00
# --------------------------------------
2020-07-07 23:25:05 +08:00
- 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 asociated intensity.
# - PROPERTIES -------------------------
instance_variables :
- var_name : point
type : carla.Location
doc : >
Point in xyz coordinates.
# --------------------------------------
- var_name : intensity
type : float
doc : >
Computed intensity for this point.
# - METHODS ----------------------------
methods :
- def_name : __str__
# --------------------------------------
2020-07-31 07:14:52 +08:00
- class_name : SemanticLidarMeasurement
2020-07-30 21:38:18 +08:00
parent : carla.SensorData
# - DESCRIPTION ------------------------
doc : >
2020-07-31 07:14:52 +08:00
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).
2020-07-30 21:38:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : channels
type : int
doc : >
Number of lasers shot.
- var_name : horizontal_angle
type : float
doc : >
Horizontal angle the Lidar is rotated at the time of the measurement (in radians).
- var_name : raw_data
type : bytes
doc : >
Received list of raw detection points. Each point consists in a 3D-xyz data plus cosine of the incident angle, the idx 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__
# --------------------------------------
- def_name : __len__
# --------------------------------------
- def_name : __setitem__
params :
- param_name : pos
type : int
- param_name : detection
2020-07-31 07:14:52 +08:00
type : carla.SemanticLidarDetection
2020-07-30 21:38:18 +08:00
# --------------------------------------
- def_name : __str__
# --------------------------------------
2020-07-31 07:14:52 +08:00
- class_name : SemanticLidarDetection
2020-07-30 21:38:18 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-07-31 07:14:52 +08:00
Data contained inside a carla.SemanticLidarMeasurement. Each of these represents one of the points in the cloud with its location and its asociated intensity.
2020-07-30 21:38:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : point
type : carla.Location
doc : >
Point in xyz coordinates.
# --------------------------------------
- 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 : >
Carla index of the hitted actor.
# --------------------------------------
- var_name : object_tag
type : uint
doc : >
Semantic tag of the hitted component.
# - METHODS ----------------------------
methods :
- def_name : __str__
# --------------------------------------
2019-05-03 20:56:18 +08:00
- class_name : CollisionEvent
2019-06-05 21:05:57 +08:00
parent : carla.SensorData
2019-05-03 20:56:18 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-04-03 19:57:11 +08:00
Class that defines a collision data for <b>sensor.other.collision</b>. The sensor creates one of this for every collision detected which may be many for one simulation step. Learn more about this [here](ref_sensors.md#collision-detector).
2019-05-03 20:56:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : actor
2019-07-02 19:10:28 +08:00
type : carla.Actor
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
The actor the sensor is attached to, the one that measured the collision.
2019-05-03 20:56:18 +08:00
- var_name : other_actor
2019-07-02 19:10:28 +08:00
type : carla.Actor
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
The second actor involved in the collision.
2019-05-03 20:56:18 +08:00
- var_name : normal_impulse
2019-07-02 19:10:28 +08:00
type : carla.Vector3D
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
Normal impulse resulting of the collision.
2019-05-03 20:56:18 +08:00
- class_name : ObstacleDetectionEvent
2019-06-05 21:05:57 +08:00
parent : carla.SensorData
2019-05-03 20:56:18 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-04-03 19:57:11 +08:00
Class that defines the obstacle data for <b>sensor.other.obstacle</b>. Learn more about this [here](ref_sensors.md#obstacle-detector).
2019-05-03 20:56:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : actor
2019-07-02 19:10:28 +08:00
type : carla.Actor
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
The actor the sensor is attached to.
2019-05-03 20:56:18 +08:00
- var_name : other_actor
2019-07-02 19:10:28 +08:00
type : carla.Actor
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
The actor or object considered to be an obstacle.
2019-05-03 20:56:18 +08:00
- var_name : distance
2019-07-02 19:10:28 +08:00
type : float
2019-05-03 20:56:18 +08:00
doc : >
2020-04-03 19:57:11 +08:00
Distance between `actor` and `other`.
2019-07-03 00:32:23 +08:00
# - METHODS ----------------------------
methods :
- def_name : __str__
2019-07-02 19:10:28 +08:00
# --------------------------------------
2019-05-03 20:56:18 +08:00
- class_name : LaneInvasionEvent
2019-06-05 21:05:57 +08:00
parent : carla.SensorData
2019-05-03 20:56:18 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-04-03 19:57:11 +08:00
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).
2019-05-03 20:56:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : actor
2019-07-02 19:10:28 +08:00
type : carla.Actor
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
Gets the actor the sensor is attached to, the one that invaded another lane.
2019-05-03 20:56:18 +08:00
- var_name : crossed_lane_markings
2019-07-02 19:10:28 +08:00
type : list(carla.LaneMarking)
2019-05-03 20:56:18 +08:00
doc : >
2020-02-24 20:58:54 +08:00
List of lane markings that have been crossed and detected by the sensor.
2019-07-03 00:32:23 +08:00
# - METHODS ----------------------------
methods :
- def_name : __str__
2019-07-02 19:10:28 +08:00
# --------------------------------------
2019-05-03 20:56:18 +08:00
2019-11-14 01:50:21 +08:00
- class_name : GnssMeasurement
2019-06-05 21:05:57 +08:00
parent : carla.SensorData
2019-05-03 20:56:18 +08:00
# - DESCRIPTION ------------------------
doc : >
2020-02-24 20:58:54 +08:00
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.
2019-05-03 20:56:18 +08:00
# - PROPERTIES -------------------------
instance_variables :
2020-02-24 20:58:54 +08:00
- var_name : altitude
type : float
doc : >
Height regarding ground level.
2019-05-03 20:56:18 +08:00
- var_name : latitude
2019-07-02 19:10:28 +08:00
type : float
2019-05-03 20:56:18 +08:00
doc : >
2019-11-14 01:50:21 +08:00
North/South value of a point on the map.
2019-05-03 20:56:18 +08:00
- var_name : longitude
2019-07-02 19:10:28 +08:00
type : float
2019-05-03 20:56:18 +08:00
doc : >
2019-11-14 01:50:21 +08:00
West/East value of a point on the map.
2019-07-03 00:32:23 +08:00
# - METHODS ----------------------------
methods :
- def_name : __str__
2019-11-14 01:50:21 +08:00
# --------------------------------------
- class_name : IMUMeasurement
parent : carla.SensorData
# - DESCRIPTION ------------------------
doc : >
2020-04-03 19:57:11 +08:00
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.
2019-11-14 01:50:21 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : accelerometer
type : carla.Vector3D
doc : >
2020-02-24 20:58:54 +08:00
Linear acceleration in m/s^2.
2019-11-14 01:50:21 +08:00
- var_name : compass
type : float
doc : >
2020-02-24 20:58:54 +08:00
Orientation with regard to the North ((0.0, -1.0, 0.0) in Unreal Engine) in radians.
- var_name : gyroscope
type : carla.Vector3D
doc : >
Angular velocity in rad/sec.
2019-11-14 01:50:21 +08:00
# - METHODS ----------------------------
methods :
- def_name : __str__
2019-07-03 00:32:23 +08:00
# --------------------------------------
2019-12-09 22:54:53 +08:00
- class_name : RadarMeasurement
parent : carla.SensorData
# - DESCRIPTION ------------------------
doc : >
2020-03-30 17:18:13 +08:00
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).
2019-12-09 22:54:53 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : raw_data
type : bytes
doc : >
2020-04-03 19:57:11 +08:00
The complete information of the carla.RadarDetection the radar has registered.
2019-12-09 22:54:53 +08:00
# - METHODS ----------------------------
methods :
- def_name : get_detection_count
doc : >
2020-04-03 19:57:11 +08:00
Retrieves the number of entries generated, same as **<font color="#7fb800">\__str__()</font>**.
2019-12-09 22:54:53 +08:00
# --------------------------------------
- def_name : __getitem__
params :
- param_name : pos
type : int
# --------------------------------------
2020-03-30 17:18:13 +08:00
- def_name : __iter__
# --------------------------------------
- def_name : __len__
# --------------------------------------
2019-12-09 22:54:53 +08:00
- def_name : __setitem__
params :
- param_name : pos
type : int
- param_name : detection
type : carla.RadarDetection
# --------------------------------------
- def_name : __str__
# --------------------------------------
- class_name : RadarDetection
# - DESCRIPTION ------------------------
doc : >
2020-04-03 19:57:11 +08:00
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.
2019-12-09 22:54:53 +08:00
# - PROPERTIES -------------------------
instance_variables :
2020-02-24 20:58:54 +08:00
- var_name : altitude
2019-12-09 22:54:53 +08:00
type : float
doc : >
2020-02-24 20:58:54 +08:00
Altitude angle of the detection in radians.
2019-12-09 22:54:53 +08:00
# --------------------------------------
- var_name : azimuth
type : float
doc : >
2020-02-24 20:58:54 +08:00
Azimuth angle of the detection in radians.
2019-12-09 22:54:53 +08:00
# --------------------------------------
2020-02-24 20:58:54 +08:00
- var_name : depth
2019-12-09 22:54:53 +08:00
type : float
doc : >
2020-02-24 20:58:54 +08:00
Distance in meters from the sensor to the detection position.
2019-12-09 22:54:53 +08:00
# --------------------------------------
2020-02-24 20:58:54 +08:00
- var_name : velocity
2019-12-09 22:54:53 +08:00
type : float
doc : >
2020-02-24 20:58:54 +08:00
The velocity of the detected object towards the sensor in m/s.
2019-12-09 22:54:53 +08:00
# - METHODS ----------------------------
methods :
- def_name : __str__
# --------------------------------------
2020-04-03 19:57:11 +08:00
- class_name : RssResponse
parent : carla.SensorData
# - DESCRIPTION ------------------------
doc : >
2020-07-03 23:16:31 +08:00
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.
2020-04-03 19:57:11 +08:00
2020-07-03 23:16:31 +08:00
A carla.RssRestrictor will use the data to modify the carla.VehicleControl of the vehicle.
2020-04-03 19:57:11 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : response_valid
type : bool
doc : >
2020-07-03 23:16:31 +08:00
States if the response is valid. It is __False__ if calculations failed or an exception occured.
2020-04-03 19:57:11 +08:00
# --------------------------------------
- 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">libad_rss_python.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">libad_rss_python.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.
2020-07-03 21:54:04 +08:00
# --------------------------------------
- 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">libad_rss_python.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">libad_rss_python.SituationSnapshot</a>
doc : >
Detailed RSS situations extracted from the world model.
2020-04-03 19:57:11 +08:00
# - METHODS ----------------------------
methods :
- def_name : __str__
# --------------------------------------
- class_name : RssEgoDynamicsOnRoute
# - DESCRIPTION ------------------------
doc : >
2020-07-03 23:16:31 +08:00
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.
2020-04-03 19:57:11 +08:00
# - PROPERTIES -------------------------
instance_variables :
- 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">libad_physics_python.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">libad_physics_python.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">libad_map_access_python.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">libad_map_access_python.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">libad_map_access_python.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">libad_map_access_python.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">libad_map_access_python.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">libad_physics_python.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">libad_physics_python.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">libad_physics_python.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">libad_physics_python.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">libad_physics_python.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">libad_physics_python.Acceleration</a>
doc : >
The ego acceleration component _lon_ regarding the route smoothened by an average filter.
# - METHODS ----------------------------
methods :
- def_name : __str__
# --------------------------------------
2020-07-03 21:54:04 +08:00
- 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">libad_map_access_python.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">libad_map_access_python.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">libad_map_access_python.Object</a>
doc : >
2020-07-03 23:16:31 +08:00
The other object's map matched information. This is only valid if 'other_actor' is not 'None'.
2020-07-03 21:54:04 +08:00
# --------------------------------------
- var_name : other_actor
type : carla.Actor
doc : >
2020-07-03 23:16:31 +08:00
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">libad_rss_python.ObjectType.ArtificialObject</a>
with no dedicated 'carla.Actor' (as e.g. for the [road boundaries](ref_sensors.md#rss-sensor) at the moment)
2020-07-03 21:54:04 +08:00
# - 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
2020-07-03 23:16:31 +08:00
type : <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss_map_integration/namespacead_1_1rss_1_1map.html#adcb01232986ed83a0c540cd5d03ef495">libad_rss_map_integration_python.RssMode</a>
2020-07-03 21:54:04 +08:00
doc : >
2020-07-03 23:16:31 +08:00
The calculation mode to be applied with the actor.
2020-07-03 21:54:04 +08:00
# --------------------------------------
- var_name : restrict_speed_limit_mode
2020-07-03 23:16:31 +08:00
type : <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss_map_integration/classad_1_1rss_1_1map_1_1RssSceneCreation.html#a403aae6dce3c77a8aec01dd9808dd964">libad_rss_map_integration_python.RestrictSpeedLimitMode</a>
2020-07-03 21:54:04 +08:00
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">libad_rss_python.RssDynamics</a>
doc : >
The RSS dynamics to be applied for the ego vehicle.
# --------------------------------------
- var_name : actor_object_type
2020-07-03 23:16:31 +08:00
type : <a href="https://intel.github.io/ad-rss-lib/doxygen/ad_rss/namespacead_1_1rss_1_1world.html#a6432f1ef8d0657b4f21ed5966aca1625">libad_rss_python.ObjectType</a>
2020-07-03 21:54:04 +08:00
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">libad_rss_python.RssDynamics</a>
doc : >
The RSS dynamics to be applied for the actor.
# - METHODS ----------------------------
methods :
- def_name : __str__
# --------------------------------------
2020-05-08 22:57:44 +08:00
- class_name : DVSEvent
# - DESCRIPTION ------------------------
doc : >
2020-07-03 23:16:31 +08:00
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).
2020-05-08 22:57:44 +08:00
# - 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 : >
2020-07-03 23:16:31 +08:00
Timestamp of the moment the event happened.
2020-05-08 22:57:44 +08:00
# --------------------------------------
- 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 : >
2020-07-03 23:16:31 +08:00
Class that defines a stream of events in [carla.DVSEvent](#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).
2020-05-08 22:57:44 +08:00
# - PROPERTIES -------------------------
instance_variables :
- var_name : fov
type : float
doc : >
2020-07-03 23:16:31 +08:00
Horizontal field of view of the image in degrees.
2020-05-08 22:57:44 +08:00
# --------------------------------------
- var_name : height
type : int
doc : >
2020-07-03 23:16:31 +08:00
Image height in pixels.
2020-05-08 22:57:44 +08:00
# --------------------------------------
- var_name : width
type : int
doc : >
2020-07-03 23:16:31 +08:00
Image width in pixels.
2020-05-08 22:57:44 +08:00
# --------------------------------------
- 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__
# --------------------------------------
- def_name : __len__
# --------------------------------------
- def_name : __setitem__
params :
- param_name : pos
type : int
- param_name : color
type : carla.Color
# --------------------------------------
- def_name : __str__
# --------------------------------------
2019-05-03 18:18:02 +08:00
...