ActorSimulation

Access and modify runtime specifications of RoadRunner Scenario actor in MATLAB

Since R2022a

Description

An ActorSimulation object represents an actor in a scenario simulation. Use an ActorSimulation object to:

• Access and modify the runtime attributes of an actor.

• Access the actions of an actor in the current simulation time step.

Creation

Retrieve the list of ActorSimulation objects from a simulation by using the get function of a ScenarioSimulation object. If required, you can then retrieve specific actors.

Object Functions

convertToStruct	Convert actor to MATLAB structure
get	Get scenario or static attribute of actor
getAction	Get actions associated with actor
getAttribute	Get run-time attribute of actor
receiveEvent	Receive event from scenario
sendEvent	Send event to scenario
setAttribute	Set run-time attribute of actor
Simulink.ActorSimulation.createMATLABStruct	Create MATLAB structure for bus object for RoadRunner
Simulink.ActorSimulation.load	Load built-in RoadRunner bus definitions into MATLAB workspace

Examples

Get Actors of Scenario Simulation

Create Sim, a ScenarioSimulation object.

rrApp = roadrunner("C:\RoadRunnerProject");
openScenario(rrApp,"TrajectoryCutIn");
Sim = createSimulation(rrApp);

Start the simulation.

set(Sim,"SimulationCommand","Start");

Get all actors while the simulation runs.

actorSim = get(Sim,"ActorSimulation");

Get the first actor only.

actorOne = actorSim{1};

Version History

Introduced in R2022a