carla/PythonAPI/docs/snapshot.yml

105 lines
3.8 KiB
YAML

---
- module_name: carla
# - CLASSES ------------------------------
classes:
- class_name: WorldSnapshot
# - DESCRIPTION ------------------------
doc: >
This snapshot comprises all the information for every actor on scene at a certain moment of time. It creates and gives acces to a data structure containing a series of carla.ActorSnapshot. The client recieves a new snapshot on every tick that cannot be stored.
# - PROPERTIES -------------------------
instance_variables:
- var_name: id
type: int
doc: >
A value unique for every snapshot to differenciate them.
- var_name: frame
type: int
doc: >
Simulation frame in which the snapshot was taken.
- var_name: timestamp
type: carla.Timestamp
var_units: seconds
doc: >
Precise moment in time when snapshot was taken. This class works in seconds as given by the operative system.
# - METHODS ----------------------------
methods:
- def_name: find
return: carla.ActorSnapshot
params:
- param_name: actor_id
type: int
doc: >
Given a certain actor ID, returns its corresponding snapshot or <b>None</b> if it is not found.
# --------------------------------------
- def_name: has_actor
return: bool
params:
- param_name: actor_id
type: int
doc: >
Given a certain actor ID, checks if there is a snapshot corresponding it and so, if the actor was present at that moment.
# --------------------------------------
- def_name: __iter__
doc: >
Method that enables iteration for this class using **<font color="#f8805a">timestamp</font>** as reference value.
# --------------------------------------
- def_name: __len__
return: int
doc: >
Returns the amount of carla.ActorSnapshot present in this snapshot.
# --------------------------------------
- def_name: __eq__
return: bool
params:
- param_name: other
type: carla.WorldSnapshot
doc: >
Returns __True__ if both **<font color="#f8805a">timestamp</font>** are the same.
# --------------------------------------
- def_name: __ne__
return: bool
params:
- param_name: other
type: carla.WorldSnapshot
doc: >
Returns <b>True</b> if both **<font color="#f8805a">timestamp</font>** are different.
# --------------------------------------
- class_name: ActorSnapshot
# - DESCRIPTION ------------------------
doc: >
A class that comprises all the information for an actor at a certain moment in time. These objects are contained in a carla.WorldSnapshot and sent to the client once every tick.
# - PROPERTIES -------------------------
instance_variables:
- var_name: id
type: int
doc: >
An identifier for the snapshot itself.
# - METHODS ----------------------------
methods:
- def_name: get_acceleration
return: carla.Vector3D
return_units: m/s<sup>2</sup>
doc: >
Returns the acceleration vector registered for an actor in that tick.
# --------------------------------------
- def_name: get_angular_velocity
return: carla.Vector3D
return_units: rad/s
doc: >
Returns the angular velocity vector registered for an actor in that tick.
# --------------------------------------
- def_name: get_transform
return: carla.Transform
doc: >
Returns the actor's transform (location and rotation) for an actor in that tick.
# --------------------------------------
- def_name: get_velocity
return: carla.Vector3D
return_units: m/s
doc: >
Returns the velocity vector registered for an actor in that tick.
# --------------------------------------
...