search

MAPF-Competition / PlanViz

An offline visualization tool for analysing solutions to multi-robot coordination problems.
https://www.leagueofrobotrunners.org/
MIT License
28 stars 13 forks source link

readme

PlanViz

Welcome to PlanViz! This is an offline (i.e., post-hoc) visualiser for analysing solutions to multi-robot and multi-agent coordination problems. It is developed as a support tool for participants in the League of Robot Runners competition. However, PlanViz can also be used for a variety of similar problems which are outside the scope of the competition.

PlanViz is implemented in python using the tkinter, a Tcl/Tk GUI toolkit. An example of the application in action is shown in the following video.

plan_viz_gif

Run

Please refer to the PlanViz instruction manual for details about how to use this tool and supported features. The following simple example shows how to visualise a plan file, from the JSON formatted descriptions produced by the Robot Runners start-kit.

Open a terminal and type the following command:

# For League of Robot Runners 2024
python3 script/run2.py --map example/warehouse_small.map --plan example/warehouse_small_2024.json --grid --aid --tid

# For League of Robot Runners 2023
python3 script/run.py --map example/warehouse_small.map --plan example/warehouse_small_2023.json --grid --aid --tid

Tracker Transfer

Tracker Transfer is a tool that helps to convert best-known solutions to a wide range of MAPF problems, as published by the community website MAPF Tracker. Once converted, these plans can be visualised with PlanViz. Please refer to the Tracker Transfer instruction manual for details about how to use this tool and supported features.