Get Transform

Transformation availability indicator, returned as a logical. If the output is 1, then a transformation exists on the ROS 2 network between the specified source and target frames in last sample hit. This output can be used to trigger subsystems for processing new transforms received in the ROS 2 network.

Data Types: Boolean

Homogeneous transformation value between source and target frame, returned as a non-virtual bus or a 4-by-4 double matrix.

Source for specifying frames, specified as one of the following:

Target coordinate frame, specified as a string. When Frame source is set to Select from ROS 2 network, use Select to select a frame from the ROS 2 network. You must be connected to a ROS 2 network to get a list of frames available in the network transformation tree. Otherwise, set Frame source to Specify your own and specify the frame you want.

Source coordinate frame, specified as a string. When Frame source is set to Select from ROS 2 network, use Select to select a frame from the ROS 2 network. You must be connected to a ROS 2 network to get a list of frames available in the network transformation tree. Otherwise, set Frame source to Specify your own and specify the frame you want.

Format of the output transformation value, specified as one of these options:

Interval between outputs, specified as a scalar. In simulation, the sample time follows simulation time and not actual wall-clock time.

This default value indicates that the block sample time is inherited. For more information about the inherited sample time type, see Specify Sample Time (Simulink).

Determines the mode of storing transforms in the queue. The queued transforms will be sent to late-joining listeners. If the queue fills with transforms waiting to be processed, then old transforms will be dropped to make room for new. When set to Keep last, the queue stores the number of transforms set by the Depth property. Otherwise, when set to Keep all, the queue stores all transforms up to the MATLAB^® resource limits.

Number of transforms stored in the transform queue when History is set to Keep last.

Affects the guarantee of transform delivery. If Reliable, then delivery is guaranteed, but may retry multiple times. If Best effort, then attempt delivery and do not retry.

Affects persistence of transforms in tf or tf_static topic publishers, which allows late-joining listeners to receive the number of old transforms specified by Depth. If Volatile, then transforms do not persist. If Transient local, then publisher will retain the most recent transforms.

Maximum amount of time allowed between successive transforms, specified as a positive scalar. For dynamic listener QoS setting, this deadline parameter specifies the maximum allowed interval between successive transforms on the tf topic, whereas for static listener QoS setting, it specifies the same for the tf_static topic.

Length of time a transform is considered valid, specified as a positive scalar. The block does not process service requests persisting longer than the specified lifespan in the queue.

For dynamic listener QoS setting, this lifespan parameter specifies the length of time a transform is considered valid on the tf topic, whereas for static listener QoS setting, it specifies the same for the tf_static topic.

Level of liveliness reporting provided by the block acting as a dynamic or a static listener, specified as automatic.

If automatic, the ROS 2 network considers the block to be alive for another Lease Duration after it has received a new transformation message.

Maximum amount of time before which the block has to assert liveliness as a static or dynamic listener, specified as a positive scalar.