/vanLon17-JAAMAS-code

Code for 'When do agents outperform centralized algorithms? - A systematic empirical evaluation in logistics'. Rinde R.S. van Lon and Tom Holvoet. Journal of Autonomous Agents and Multi-Agent Systems (2017).

Primary LanguageJavaApache License 2.0Apache-2.0

When do agents outperform centralized algorithms? - A systematic empirical evaluation in logistics

This repository contains the code that was used to perform the experiments described in:

When do agents outperform centralized algorithms? - A systematic empirical evaluation in logistics. Rinde R.S. van Lon and Tom Holvoet. Journal of Autonomous Agents and Multi-Agent Systems (2017).

This is version v1.1.0.

The code in this repository is archived at Zenodo: DOI

The datasets and results belonging to this paper can be found in one big zip file, at this location: DOI

Overview

Since the paper is part of a long term research effort, the code used for the experiments is distributed over several open source repositories. The code in the current repository is the glue that instantiates and binds the code from the other repositories to create a cohesive experiment setup.

In this repository

This repository contains several scripts that can be used to execute each experiment conducted for this paper. Maven and Java 7 (or higher) are required.

Purpose of script Prerequisites Command
Generate main dataset ./generate-main-dataset.sh
Perform main experiment Requires the main dataset, either generate it or use the already generated files from the zip: scenarios/vanLonHolvoet15-adapted-to-4-hours/ ./main-experiment.sh
Real-time reliability (sensitivity) experiment Requires the main dataset, either generate it or use the already generated files from the zip: scenarios/vanLonHolvoet15-adapted-to-4-hours/ ./sensitivity-experiment.sh
Generate MAS tuning dataset ./generate-mas-tuning-dataset.sh
MAS tuning part 1 Requires the MAS tuning dataset, either generate it or use the already generated files from the zip: scenarios/mas-tuning-dataset/ ./mas-tuning1.sh
MAS tuning part 2 Requires the MAS tuning dataset, either generate it or use the already generated files from the zip: scenarios/mas-tuning-dataset/ ./mas-tuning1.sh
MAS tuning part 3 Requires the MAS tuning dataset, either generate it or use the already generated files from the zip: scenarios/mas-tuning-dataset/ ./mas-tuning1.sh
OptaPlanner tuning on Gendreau dataset Requires the Gendreau dataset, the files can be found in the zip: scenarios/gendreau2006/ ./optaplanner-tuning.sh

Dependencies

All dependencies are imported via Maven but can also be downloaded manually. The following dependencies are especially relevant:

Library Description Version DOI
RinSim Real-time logistics simulator. 4.3.0 DOI
RinLog Collection of algorithms, including DynCNET multi-agent system and OptaPlanner for dynamic PDPTW problems. 3.2.2 DOI
PDPTW Dataset Generator Generator of PDPTW datasets. 1.1.0 DOI

License

All files in this repository are licensed under the Apache 2.0 license.