Customizing Maps#

This section describes how to create and use a custom Duckiematrix Map.

What you will need

What you will get

Knowledge on how to create and use a custom Duckiematrix Map.

Create a custom Map#

To create a custom Map:

  1. Download the loop Map zip file from Duckietown public storage.

  2. Unzip the loop Map zip file.

  3. Move the loop Map to a convenient location, noting its path.

  4. Edit the name and layers of the loop Map.

Note

Remember that a Map is defined as a directory containing the layers (YAML files) that form that Map.

Use a custom Map#

To run a local Engine and Renderer using a custom Map, run the following command, where MAP is the path to the custom Map:

dts matrix run --standalone --map MAP

Note

If you are using a Duckietown Workspace, dts matrix run --standalone starts the Duckiematrix Engine in the environment where the command is run. If dts is installed on the host machine, this command can be run from inside the Duckietown Workspace and is automatically delegated to the host machine, where it launches the native Renderer. For the split Duckietown Workspace workflow, start the Engine separately and run dts matrix run inside or outside the Duckietown Workspace.

Note

For any changes in the layers to appear in the Renderer, this command will need to be re-run.