get
Description
returns simulation log data specified by loggeddata
= get(log
,Parameter
)Parameter
from the
ScenarioLog
object log
.
returns simulation log data specified by loggeddata
= get(log
,Parameter
,"ActorID",ID
)Parameter
for actor with
identifier ID
from the ScenarioLog
object
log
.
Examples
Get Scenario Simulation Log
Set logging on for ss
, a
ScenarioSimulation
object.
set(ss,"Logging","on")
Get the simulation log after it stops playing.
log = get(ss,"SimulationLog")
Get the list of participating actors from the simulation.
actors = get(log,"ActorIDs")
actors = 0 1 2
Get the velocity of actor with actor ID 1.
vel = get(log,"Velocity","ActorID",1)
Input Arguments
log
— Scenario simulation log
ScenarioLog
object
Scenario simulation log from which to return data, specified as a
ScenarioLog
object.
Example: actors = get(log,"ActorIDs")
Parameter
— Information required from simulation log
ActorIDs
| Time
| MaxSimulationTime
| StepSize
| Diagnostics
| Actions
| Events
| Pose
| Velocity
| AngularVelocity
| WheelPose
| ScenarioFile
| InitialState
| TrafficSignal
| TrafficSignalController
Information required from simulation log, specified as one of these parameters.
ActorIDs
Time
MaxSimulationTime
StepSize
Diagnostics
Actions
Events
Pose
Velocity
AngularVelocity
WheelPose
ScenarioFile
InitialState
TrafficSignal
TrafficSignalController
Note
You can retrieve the Actions
, Events
,
Pose
, Velocity
,
AngularVelocity
,
InitialState
,WheelPose
,TrafficSignal
,
and TrafficSignalController
parameters for a specific
ActorID
, only.
ID
— Actor identifier
positive integer
Actor identifier, specified as a positive integer.
Example: pose = get(log,"Pose","ActorID",5)
Output Arguments
loggeddata
— Specific simulation log data
array | structure array | double
Specific simulation log data, returned as an array or structure array.
This table describes the output returned for each Parameter
input argument.
Input Argument | Output |
---|---|
ActorIDs | List of unique IDs of actors that participated in the simulation, returned as an array. Actor ID 0, representing the world, is always included in the list. |
Time | Each time step of the simulation, returned as an array. |
MaxSimulationTime | Maximum simulation time, returned as a double. |
StepSize | Step size of a simulation, returned as a double. |
Diagnostics | Diagnostics reported during the simulation, if any, returned as a Diagnostics structure array. |
Actions | Actions of specified actor, if any, for each time step of the simulation, returned as an Actions structure array. |
Events | Events being sent by the specified actor, if any, for each time step of the simulation, returned as an Events structure array. |
Pose | Pose of specified actor for each time step of the simulation, returned as a Pose structure array. |
Velocity | Velocity of specified actor for each time step of the simulation, returned as a Velocity structure array. |
AngularVelocity | Angular velocity of specified actor for each time step of the simulation, returned as a AngularVelocity structure array. |
WheelPose | Wheel pose of specified actor for each time step of the simulation, returned as a WheelPose structure array. |
ScenarioFile | Scenario file used to generate log. |
InitialState | Actor state before the start of a simulation, returned as a InitialState Structure structure. The returned structure fields vary based on the actor type. |
TrafficSignal | Traffic signal run-time information, returned as a TrafficSignal structure array. |
TrafficSignalController | Traffic signal controller run-time information, returned as a TrafficSignalController structure array. |
More About
Diagnostics
Structure Array
This table describes the fields of each structure within the
Diagnostics
structure array:
Field Name | Description |
---|---|
Time | Simulation time step at which diagnostic message is reported. |
MessageType | Type of reported message, returned as an enumeration variable of the
The value
of
|
Message | Diagnostic message text, returned as a string or character vector. |
Actions
Structure Array
This table describes the fields of each structure within the Actions
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
Action | Actions of the specified actor, if any, at each simulation time step. |
Events
Structure Array
This table describes the fields of each structure within the Events
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
Events | Events being sent by the specified actor, if any, at each simulation time step. |
Pose
Structure Array
This table describes the fields of each structure within the Pose
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
Pose | Pose of the specified actor at each simulation time step. |
Velocity
Structure Array
This table describes the fields of each structure within the Velocity
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
Velocity | Velocity of the specified actor at each simulation time step. |
AngularVelocity
Structure Array
This table describes the fields of each structure within the
AngularVelocity
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
AngularVelocity | Angular velocity of the specified actor at each simulation time step. |
WheelPose
Structure Array
This table describes the fields of a structure within the WheelPose
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
WheelPose | The wheel pose of the specified actor at each simulation time step.
|
InitialState
Structure
This table describes the InitialState
structure:
Field Name | Description |
---|---|
Time | Time step at which actor was created, returned as a
double . |
ActorID | Actor identifier, returned as a string. |
Pose | Initial actor pose, returned as a 4-by-4 matrix. |
Velocity | Initial actor velocity, returned as a 1-by-3 matrix. |
AngularVelocity | Initial angular velocity of actor, returned as a 1-by-3 matrix. |
WheelPose | Initial wheel pose of vehicle actor, returned as a 4-by-4-by-4 array. |
TrafficSignalState | Initial state of the specified traffic signal actor, returned as a structure of type TrafficSignalRuntime. |
TrafficSignalControllerState | Initial state of the specified traffic signal controller actor, returned as a structure of type TrafficSignalControllerRuntime. |
TrafficSignal
Structure Array
This table describes the TrafficSignal
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
TrafficSignal | Traffic signal run-time information for the specified actor ID, returned as a TrafficSignalRuntime structure. |
TrafficSignalController
Structure Array
This table describes the TrafficSignalController
structure array:
Field Name | Description |
---|---|
Time | Each simulation time step, from start to end. |
TrafficSignalController | Traffic signal controller run-time information for the specified actor ID, returned as a TrafficSignalControllerRuntime structure. |
Version History
Introduced in R2022aR2024b: Log run-time information for traffic signal and traffic signal controller
Use the get
function to log run-time information for traffic signal
and traffic signal controller actors, at each time step of a scenario simulation.
R2023a: Log initial state of an actor
Use the get
function to log information about the state of an actor
before the simulation starts.
See Also
MATLAB-Befehl
Sie haben auf einen Link geklickt, der diesem MATLAB-Befehl entspricht:
Führen Sie den Befehl durch Eingabe in das MATLAB-Befehlsfenster aus. Webbrowser unterstützen keine MATLAB-Befehle.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)