danieldeer/amaz3dsim

A lightweight Python-based 3D network multi-agent simulator. Uses a cell-based congestion model. Calculates risk, loudness and battery capacities of the agents. Suitable for 3D network optimization tasks.

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.

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

amaz3dsim's Issues

Error in scenarioParser

Starting the CommandLineInterface on default settings causes an error (see screenshot). The problem stays also with the simple scenario, but without lines 157-162 in ScenarioParser, it works.

Overloaded link lets agents freely travel despite capacity

An input scenario that places too many agents on a link should be handled realistically by the simulator.

e.g. 50 agents can be placed on a capacity 1 link, but then only 1 agent should be able to move

As of now, all agents move freely on the first link they are generated on.