Skip to content

Latest commit

 

History

History
52 lines (40 loc) · 2 KB

README.md

File metadata and controls

52 lines (40 loc) · 2 KB

Codacy Badge

AMAZ3DSim

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. AMAZ3DSim simulation of OSM Darmstadt scenario

Installation

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

Usage

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.

Configuration

A fully commented example configuration is available under

config/config.xml

which is also the standard configuration.

Input interface of the simulator

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.

Contributing

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

License

MIT