ADAGIO Release 1.1
What is ADAGIO
ADAGIO was designed for the computation of ranks in gregarious species. To this end, it takes a directed graph (the interaction matrix) as input and returns a directed acyclic graph as well as corresponding ranks. In addition, the framework implements David's score, I&SI and ELO rating for the sake of reference.
Why ADAGIO
We have been able to show that ADAGIO outperforms the methods aforementioned on real and synthetic data. Hence, we suggest using ADAGIO for assessing dominance in species of any kind. For more information, please read the upoming paper (link will be added as soon as the paper is published).
How to use
- Please make sure you have Java 1.8 installed.
- Download Adagiov1.1.
- Decompress Adagio
- Go to your command line (Windows) or terminal (Linux and Mac).
- Go to the folder containing Adagio.
- Run
java -jar adagio.jar -folder FOLDER
, where FOLDER is the folder which contains your interaction matrix or matrices formatted according to these examples. ADAGIO will try to process all the .csv files in FOLDER, so please only put files which abide by the format in the examples in FOLDER and set their ending to .csv. All non-csv files will not be processed.
ADAGIO also supports the following command line parameters:
- folder: Path to the folder to process. Necessary parameter
- preprocessing: Switch preprocessing on and off. Can be true or false. Default is true.
- ranking: Selects the type of ranking use. Currently supported are top and bottom. Default is bottom.
- ending: Sets the ending of the files that are to be processed. Default is .csv
The call
java -jar adagio.jar -folder C:/test -preprocessing true -ranking top -ending txt
leads to all files that end in "txt" in the folder "C:/test" being processed by Adagio. The ranking method used is top-down and the preprocessing is carried out.
- You should receive a report file dubbed adagio.output with a content akin to
File name | Population | Landau's Index | ... |
---|---|---|---|
Alados 1992-1.csv | 7 | 1.0 | ... |
Alados 1992-2.csv | 9 | 0.79 | ... |
You can find the ranks assigned by ADAGIO in the folder in which your original data was. The file ends with ".adagio.ranks". The files dubbed with ".david.ranks" respectively ".elo.ranks" show the results returned by David's score and the Elo ration for the sake of reference.