Main Content


Advance robot scenario simulation by one time step

Since R2022a



    isrunning = advance(scenario) advances the robot scenario simulation by one time step. The UpdateRate property of the robotScenario object determines the time step during simulation. The function returns the running status of the simulation. The function only updates a platform location if the platform has an assigned trajectory.


    collapse all

    Create a robot scenario.

    scenario = robotScenario(UpdateRate=100,StopTime=1);

    Add the ground plane and a cylinder as meshes.

    addMesh(scenario,"Plane",Size=[30 30],Color=[0.7 0.7 0.7])
    addMesh(scenario,"Cylinder",Position=[-2 4 0.5],Color=[0 1 1])

    Create a robot platform with a specified waypoint trajectory in the scenario. Define the mesh for the robot platform.

    traj = waypointTrajectory("Waypoints",[0 -10 0; 10 0 0; -10 10 0; 0 -10 0], ...
                              "TimeOfArrival",[0 0.33 0.66 1], ...
    platform = robotPlatform("Robot",scenario, ...

    Simulate and visualize the scenario.

    idx = 1;
    while advance(scenario)
        motion(idx,:) = read(platform);
        drawnow update
        idx = idx+1;


    Input Arguments

    collapse all

    Robot scenario, specified as a robotScenario object.

    Output Arguments

    collapse all

    Running state of the simulation, returned as true or false. If isrunning is returned as true, then the simulation is running. If isrunning is returned as false, the simulation has stopped. A simulation stops when the stop time is reached.

    Version History

    Introduced in R2022a