rosrate

Execute loop at fixed frequency

Description

The rosrate object uses the rateControl superclass to inherit most of its properties and methods. The main difference is that rateControl uses the ROS node as a source for time information. Therefore, it can use the ROS simulation or wall clock time (see the IsSimulationTime property).

If rosinit creates a ROS master in MATLAB®, the global node uses wall clock time.

The performance of the rosrate object and the ability to maintain the DesiredRate value depends on the publishing of the clock information in ROS.

Tip

The scheduling resolution of your operating system and the level of other system activity can affect rate execution accuracy. As a result, accurate rate timing is limited to 100 Hz for execution of MATLAB code. To improve performance and execution speeds, use code generation.

Creation

Description

example

rate = rosrate(desiredRate) creates a Rate object, which enables you to execute a loop at a fixed frequency, DesiredRate. The time source is linked to the time source of the global ROS node, which requires you to connect MATLAB to a ROS network using rosinit.

example

rate = ros.Rate(node,desiredRate) creates a Rate object that operates loops at a fixed rate based on the time source linked to the specified ROS node, node.

Properties

expand all

Desired execution rate of loop, specified as a scalar in hertz. When using waitfor, the loop operates every DesiredRate seconds, unless the loop takes longer. It then begins the next loop based on the specified OverRunAction.

Desired time period between executions, specified as a scalar in seconds. This property is equal to the inverse of DesiredRate.

Elapsed time since construction or reset, specified as a scalar in seconds.

Elapsed time between last two calls to waitfor, specified as a scalar. By default, LastPeriod is set to NaN until waitfor is called for the first time. After the first call, LastPeriod equals TotalElapsedTime.

Method for handling overruns, specified as one of these character vectors:

  • 'drop' — waits until the next time interval equal to a multiple of DesiredPeriod

  • 'slip' — immediately executes the loop again

Each code section calls waitfor at the end of execution.

Indicator if simulation or wall clock time is used, returned as true or false. If true, the Rate object is using the ROS simulation time to regulate the rate of loop execution.

Object Functions

waitforPause code execution to achieve desired execution rate
statisticsStatistics of past execution periods
resetReset Rate object

Examples

collapse all

Initialize the ROS master and node.

rosinit
Initializing ROS master on http://bat1002804glnxa64:36639/.
Initializing global node /matlab_global_node_18445 with NodeURI http://bat1002804glnxa64:32995/

Create a rate object that runs at 1 Hz.

r = rosrate(1);

Start loop that prints iteration and time elapsed. Use waitfor to pause the loop until the next time interval. Reset r prior to the loop execution. Notice that each iteration executes at a 1-second interval.

reset(r)
for i = 1:10
	time = r.TotalElapsedTime;
	fprintf('Iteration: %d - Time Elapsed: %f\n',i,time)
	waitfor(r);
end
Iteration: 1 - Time Elapsed: 0.009493
Iteration: 2 - Time Elapsed: 1.008082
Iteration: 3 - Time Elapsed: 2.005714
Iteration: 4 - Time Elapsed: 3.007885
Iteration: 5 - Time Elapsed: 4.006299
Iteration: 6 - Time Elapsed: 5.008677
Iteration: 7 - Time Elapsed: 6.012372
Iteration: 8 - Time Elapsed: 7.003266
Iteration: 9 - Time Elapsed: 8.003387
Iteration: 10 - Time Elapsed: 9.009318

Shut down the ROS network.

rosshutdown
Shutting down global node /matlab_global_node_18445 with NodeURI http://bat1002804glnxa64:32995/
Shutting down ROS master on http://bat1002804glnxa64:36639/.

Initialize the ROS master and node.

rosinit
Initializing ROS master on http://bat1074105glnxa64:44449/.
Initializing global node /matlab_global_node_79833 with NodeURI http://bat1074105glnxa64:38869/
node = robotics.ros.Node('/testTime');
Using Master URI http://localhost:44449 from the global node to connect to the ROS master.

Create a ros.Rate object running at 20 Hz.

r = robotics.ros.Rate(node,20);

Reset the object to restart the timer and run the loop for 30 iterations. Insert code you want to run in the loop before calling waitfor.

reset(r)
for i = 1:30
	% User code goes here.
	waitfor(r);
end

Shut down ROS node.

rosshutdown
Shutting down global node /matlab_global_node_79833 with NodeURI http://bat1074105glnxa64:38869/
Shutting down ROS master on http://bat1074105glnxa64:44449/.

Introduced in R2019b