|
Nav2 Navigation Stack - humble
humble
ROS 2 Navigation Stack
|
The Map Server provides maps to the rest of the Nav2 system using both topic and service interfaces. Map server will expose maps on the node bringup, but can also change maps using a load_map service during run-time, as well as save maps using a save_map server.
See its Configuration Guide Page for additional parameter descriptions.
In contrast to the ROS1 navigation map server, the nav2 map server will support a variety of map types, and thus some aspects of the original code have been refactored to support this new extensible framework.
Currently map server divides into tree parts:
map_servermap_savermap_io librarymap_server is responsible for loading the map from a file through command-line interface or by using service requests.
map_saver saves the map into a file. Like map_server, it has an ability to save the map from command-line or by calling a service.
map_io - is a map input-output library. The library is designed to be an object-independent in order to allow easily save/load map from external code just by calling necessary function. This library is also used by map_loader and map_saver to work. Currently it contains OccupancyGrid saving/loading functions moved from the rest part of map server code. It is designed to be replaceable for a new IO library (e.g. for library with new map encoding method or any other library supporting costmaps, multifloor maps, etc...).
The Map Server is a composable ROS2 node. By default, there is a map_server executable that instances one of these nodes, but it is possible to compose multiple map server nodes into a single process, if desired.
The command line for the map server executable is slightly different that it was with ROS1. With ROS1, one invoked the map server and passing the map YAML filename, like this:
Where the YAML file specified contained the various map metadata, such as:
The Nav2 software retains the map YAML file format from Nav1, but uses the ROS2 parameter mechanism to get the name of the YAML file to use. This effectively introduces a level of indirection to get the map yaml filename. For example, for a node named 'map_server', the parameter file would look like this:
One can invoke the map service executable directly, passing the params file on the command line, like this:
There is also possibility of having multiple map server nodes in a single process, where the parameters file would separate the parameters by node name, like this:
Then, one would invoke this process with the params file that contains the parameters for both nodes:
The parameter for the initial map (yaml_filename) has to be set, but an empty string can be used if no initial map should be loaded. In this case, no map is loaded during on_configure or published during on_activate. The load_map-service should the be used to load and publish a map.
Like in ROS1 map_saver could be used as CLI-executable. It was renamed to map_saver_cli and could be invoked by following command:
MapIO library contains following API functions declared in map_io.hpp to work with OccupancyGrid maps:
As in ROS navigation, the map_server node provides a "map" service to get the map. See the nav_msgs/srv/GetMap.srv file for details.
NEW in ROS2 Eloquent, map_server also now provides a "load_map" service and map_saver - a "save_map" service. See nav2_msgs/srv/LoadMap.srv and nav2_msgs/srv/SaveMap.srv for details.
For using these services map_server/map_saver should be launched as a continuously running nav2::LifecycleNode node. In addition to the CLI, Map Saver has a functionality of server handling incoming services. To run Map Saver in a server mode nav2_map_server/launch/map_saver_server.launch.py launch-file could be used.
Service usage examples:
1.9.1