get

Get value of scenario simulation parameter

Since R2022a

Syntax

Output = get(ScenarioSim,Param)

Description

Output = get(ScenarioSim,Param) returns the value of the specified parameter Param from a scenario simulation ScenarioSim at run-time.

Examples

Get Specified Parameter Value

Create a roadrunner object to launch the RoadRunner application, and open the project at the specified project location.

rrApp = roadrunner("C:\Project\TestHighwayRoute");

Open the scenario file TrajectoryCutIn.rrscenario that is included with the RoadRunner Scenario application.

openScenario(rrApp,"TrajectoryCutIn");

Create a ScenarioSimulation object rrSim.

rrSim = createSimulation(rrApp);

Get the current simulation status.

simstatus = get(rrSim,"SimulationStatus");

Get the log data history associated with the simulation.

simLog = get(rrSim,"SimulationLog");

Get the ActorSimulation objects corresponding to all actors in the scenario.

actors = get(rrSim,"ActorSimulation");

Get an ActorSimulation object from the scenario by using the handle to the Simulink^® model that specifies the behavior of this actor.

actorsim = get(rrSim,"ActorSimulation","SimulinkModel",mdHdl);

Get an ActorSimulation object by using the System object™ that represents its run-time behavior. This operation is possible only if an actor is already associated with a MATLAB^® System object.

actorsysobj = get(rrSim,"ActorSimulation","SystemObject",obj);

Get a specific actor using its corresponding ActorModel object name.

actormod = get(rrSim,"ActorSimulation","ActorModel",actorModel);

Retrieve all the sensors from the simulation.

sensors = get(rrSim,"SensorSimulation");

Input Arguments

ScenarioSim — RoadRunner Scenario simulation

ScenarioSimulation object

RoadRunner Scenario simulation, specified as a ScenarioSimulation object.

Example: ScenarioSim

Param — Scenario simulation parameter

StepSize | MaxSimulationTime | PacerStatus | SimulationPace | SimulationStatus | SimulationLog | Logging | ActorSimulation | Observers | SimulationTime | SensorSimulation| | Map | ScenarioServices

Scenario simulation parameter, specified as one of these values:

Parameter	Description
"StepSize"	Step size of simulation
"MaxSimulationTime"	Maximum simulation time of scenario
"PacerStatus"	Pacer status of simulation
"SimulationPace"	Pace of simulation
"SimulationStatus"	Status of simulation
"SimulationLog"	Logged simulation data
"Logging"	Logging status of simulation
"ActorSimulation"	Actors in simulation
"ActorSimulation", "SimulinkModel", mdHdl	Actor in simulation corresponding to specified Simulink model handle
"ActorSimulation", "SystemObject", obj	Actor in simulation corresponding to specified System object
"ActorSimulation", "ActorModel", actorModel	Actor in simulation corresponding to specified Simulink.ActorModel object
"Observers"	Observers attached to a simulation
"SimulationTime"	Simulation time
"SensorSimulation"	Sensors in simulation
"Map"	RoadRunner HD map for the scene used in scenario simulation
"ScenarioServices"	Service that allows you to perform calculations on RoadRunner scene or scenario

Output Arguments

Output — Value of parameter

double | char | string | structure array | ScenarioLog object | ActorSimulation object | SensorSimulation object | roadrunnerHDMap object | ScenarioServices object

Value of parameter, returned as one of these data types:

Parameter	Data Type of Output
"StepSize"	Step size of simulation, returned as a double.
"MaxSimulationTime"	Maximum simulation time of scenario, returned as a double.
"PacerStatus"	Pacer status of simulation, returned as a char or string. Possible values are "on" and "off".
"SimulationPace"	Simulation pace, returned as adouble.
"SimulationStatus"	Simulation status, returned as a char or string. These are the possible values. "Running" — The simulation is currently running. "Stopped" — The simulation is stopped. "Paused" — The simulation is paused. "Unspecified" — Undefined simulation status.
"SimulationLog"	ScenarioLog object.
"Logging"	Logging status of simulation, returned as a char or string. Possible values are "on" and "off".
"ActorSimulation"	Cell array of ActorSimulation objects.
"ActorSimulation", "SimulinkModel", mdHdl	ActorSimulation object.
"ActorSimulation", "SystemObject", obj	ActorSimulation object.
"ActorSimulation", "ActorModel", actorModel	ActorSimulation object.
"Observers"	Structure array containing the following fields: ObserverName — Name of the observer, returned as a character vector. FilePath — Path of the System object file or Simulink file modeling an observer, returned as a character vector.
"SimulationTime"	Simulation time, returned as a double. You can get the value of the simulation time only while a simulation is playing. The function returns -1 before the start of the simulation, or after the end of the simulation.
"SensorSimulation"	SensorSimulation object.
"Map"	roadrunnerHDMap object.
"ScenarioServices"	ScenarioServices object.

Version History

Introduced in R2022a

R2024a: Retrieve the current simulation time

Get the current simulation time of a scenario.