Map Server / Saver

Source code on Github.

The Map Server implements the server for handling the map load requests for the stack and host a map topic. It also implements a map saver server which will run in the background and save maps based on service requests. There exists a map saver CLI similar to ROS 1 as well for a single map save.

Map Saver Parameters

save_map_timeout

Type

Default

int

2.0

Description

Timeout to attempt saving the map (seconds).

free_thresh_default

Type

Default

double

0.25

Description

Free space maximum probability threshold value for occupancy grid.

occupied_thresh_default

Type

Default

double

0.65

Description

Occupied space minimum probability threshold value for occupancy grid.

Map Server Parameters

yaml_filename

Type

Default

string

N/A

Description

Path to map yaml file. Note from Rolling + Iron-Turtle forward: This parameter can set either from the yaml file or using the launch configuration parameter map. If we set it on launch commandline / launch configuration default, we override the yaml default. If you would like the specify your map file in yaml, remove the launch default so it is not overridden in Nav2’s default launch files. Before Iron: yaml_filename must be set in the yaml (even if a bogus value) so that our launch scripts can overwrite it with launch values.

topic_name

Type

Default

string

“map”

Description

Topic to publish loaded map to.

frame_id

Type

Default

string

“map”

Description

Frame to publish loaded map in.

Costmap Filter Info Server Parameters

type

Type

Default

int

0

Description

Type of costmap filter used. This is an enum for the type of filter this should be interpreted as. We provide the following pre-defined types:

  • 0: keepout zones / preferred lanes filter

  • 1: speed filter, speed limit is specified in % of maximum speed

  • 2: speed filter, speed limit is specified in absolute value (m/s)

  • 3: binary filter

filter_info_topic

Type

Default

string

“costmap_filter_info”

Description

Topic to publish costmap filter information to.

mask_topic

Type

Default

string

“filter_mask”

Description

Topic to publish filter mask to. The value of this parameter should be in accordance with topic_name parameter of Map Server tuned to filter mask publishing.

base

Type

Default

double

0.0

Description

Base of OccupancyGrid mask value -> filter space value linear conversion which is being proceeded as: filter_space_value = base + multiplier * mask_value

multiplier

Type

Default

double

1.0

Description

Multiplier of OccupancyGrid mask value -> filter space value linear conversion which is being proceeded as: filter_space_value = base + multiplier * mask_value

bond_heartbeat_period

Type

Default

double

0.1

Description

The lifecycle node bond mechanism publishing period (on the /bond topic). Disabled if inferior or equal to 0.0.

Example

map_server:
  ros__parameters:
    yaml_filename: "turtlebot3_world.yaml"
    topic_name: "map"
    frame_id: "map"

map_saver:
  ros__parameters:
    save_map_timeout: 5.0
    free_thresh_default: 0.25
    occupied_thresh_default: 0.65

costmap_filter_info_server:
  ros__parameters:
    type: 1
    filter_info_topic: "costmap_filter_info"
    mask_topic: "filter_mask"
    base: 0.0
    multiplier: 0.25