writeBinaryOccupancyGrid

(To be removed) Write values from grid to ROS message

writeBinaryOccupancyGrid will be removed in a future release. Use rosWriteBinaryOccupancyGrid (ROS Toolbox) instead. For more information, see ROS Message Structure Functions.

Syntax

writeBinaryOccupancyGrid(msg,map)

Description

writeBinaryOccupancyGrid(msg,map) writes occupancy values and other information to the ROS message, msg, from the binary occupancy grid, map.

Input Arguments

map — Binary occupancy grid

binaryOccupancyMap object handle

Binary occupancy grid, specified as a binaryOccupancyMap object handle. map is converted to a 'nav_msgs/OccupancyGrid' message on the ROS network. map is an object with a grid of binary values, where 1 indicates an occupied location and 0 indications an unoccupied location.

msg — 'nav_msgs/OccupancyGrid' ROS message

OccupancyGrid object handle

'nav_msgs/OccupancyGrid' ROS message, specified as a OccupancyGrid object handle.

Version History

Introduced in R2015a

R2021a: ROS Message Structure Functions

You can now create messages as structures with fields matching the message object properties. Using structures typically improves performance of creating, updating, and using ROS messages, but message fields are no longer validated when set. Message types and corresponding field values from the structures are validated when sent across the network.

To support message structures as inputs, new functions that operate on specialized ROS messages have been provided. These new functions are based on the existing object functions of message objects, but support ROS and ROS 2 message structures as inputs instead of message objects.

The object functions will be removed in a future release.

Message Types	Object Function Name	New Function Name
Image CompressedImage	readImage writeImage	rosReadImage (ROS Toolbox) rosWriteImage (ROS Toolbox)
LaserScan	readCartesian readScanAngles lidarScan plot	rosReadCartesian (ROS Toolbox) rosReadScanAngles (ROS Toolbox) rosReadLidarScan (ROS Toolbox) rosPlot (ROS Toolbox)
PointCloud2	apply readXYZ readRGB readAllFieldNames readField scatter3	rosApplyTransform (ROS Toolbox) rosReadXYZ (ROS Toolbox) rosReadRGB (ROS Toolbox) rosReadAllFieldNames (ROS Toolbox) rosReadField (ROS Toolbox) rosPlot (ROS Toolbox)
Quaternion	readQuaternion	rosReadQuaternion (ROS Toolbox)
OccupancyGrid	readBinaryOccupanyGrid readOccupancyGrid writeBinaryOccupanyGrid writeOccupanyGrid	rosReadOccupancyGrid (ROS Toolbox) rosReadBinaryOccupancyGrid (ROS Toolbox) rosReadOccupancyGrid (ROS Toolbox) rosWriteBinaryOccupancyGrid (ROS Toolbox) rosWriteOccupancyGrid (ROS Toolbox)
Octomap	readOccupancyMap3D	rosReadOccupancyMap3D (ROS Toolbox)
PointStamped PoseStamped QuaternionStamped Vector3Stamped TransformStamped	apply	rosApplyTransform (ROS Toolbox)
All messages	showdetails	rosShowDetails (ROS Toolbox)