This repository contains code and instruction to reproduce the experiments presented in the paper Time-fluid field-based coordination by Danilo Pianini, Stefano Mariani, Mirko Viroli, and Franco Zambonelli; submitted to Coordination 2020.
In order to run the experiments, the Java Development Kit 11 is required. We test using OpenJ9 11 and 13, and OpenJDK 11 and 13. Original testing was performed with OpenJDK 11. JDK 14 and above are known not to work with the version of Protelis used in this work.
In order to produce the charts, Python 3 is required. We recommend Python 3.8.1, but it is very likely that any Python 3 version, and in particular any later version will serve the purpose just as well. The recommended way to obtain it is via pyenv.
The experiments have been designed and tested under Linux. However, we have some muliplatform build automation in place. Everything should run on any recent Linux, MacOS X, and Windows setup.
We provide a reference Travis CI configuration to maintain reproducibility over time.
While this image: 
.travis.yml file,
you should be able to re-run the experiment entirely.
Charts are remotely generated and made available on the project release page. The latest release allows for quick retrieval of the latest version of the charts.
A graphical execution of the simulation can be started by issuing the following command
./gradlew runAllGraphic.
Simulation on the graphical interface can be started with P,
for further details please refer to the Alchemist Simulator guide.
Windows users may try using the gradlew.bat script as a replacement for gradlew.
The whole simulation batch can be executed by issuing ./gradlew runAllBatch.
Be aware that it may take a very long time, from several hours to weeks, depending on your hardware.
If you are under Linux, the system tries to detect the available memory and CPUs automatically, and parallelize the work.
In order to speed up the process for those interested in observing and manipulating the existing data,
we provide simulation-generated data directly in the repository.
Generating the charts is matter of executing the process.py script.
The enviroment is designed to be used in conjunction with pyenv.
The following guide will start from the assumption that pyenv is installed on your system. First, install Python by issuing
pyenv install --skip-existing 3.8.1
Now, configure the project to be interpreted with exactly that version:
pyenv local 3.8.1
Update the pip package manager and install the required dependencies.
pip install --upgrade pip
pip install -r requirements.txtThis section assumes you correctly completed the required configuration described in the previous section.
In order for the script to execute, you only need to launch the actual process by issuing python process.py