AMAZ3DSim is a lightweight python-based 3D network multi-agent simulator. It uses a cell-based congestion model. It calculates risk, battery capacities, travel time and travelled distance of the agents and the loudness the network links experience. AMAZ3DSim is suitable for 3D network optimization tasks.

Use the package manager pip to install the following dependencies.

sudo apt install python3.8

pip install click
pip install tkinter
pip install matplotlib
pip install networkx

To start AMAZ3DSim with default settings

python3.8 CommandLineInterface.py

To open a small help doc listing the parameters of the CommandLineInterface.py

python3.8 CommandLineInterface.py --help

A full command specifies all of the following paramters

python3.8 CommandLineInterface.py --in-file /path/to/scenario.xml --out-file /path/to/output.xml --config-file /path/to/config.xml --random-mode False

If an argument is left out, a standard value is used.

A fully commented example configuration is available under

config/config.xml

which is also the standard configuration.

To simulate your own network, create your own scenario.xml file. A scenario.xml contains the network, the agents and the delivery orders to be fulfilled.

Example scenario.xml files are available in the input folder.

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

MIT