The caravida tool - npapanik/Adyton GitHub Wiki

####What is the "caravida" tool?

The "caravida" tool is a script for importing the most popular real-world contact traces into Adyton. Initially, "caravida" fetches the original trace file(s) from the web (mainly from CRAWDAD). Then, it processes the downloaded file(s) in order to make them compatible with Adyton: A Network Simulator for Opportunistic Networks.

In Adyton v1.0.0 the "caravida" tool was available under the name "import_dataset".

####Requirements

To successfully use the "caravida" tool the following tools must be installed.

• gcc compiler
• awk
• bc
• wget
• md5sum
• MySQL (only for the MIT Reality trace)
• dialog (only for -gui option)

Commonly used linux distributions, e.g., Ubuntu, come with all the required tools already installed. To get access in most of the original datasets you should join the CRAWDAD community. The CRAWDAD registration is free and can be completed through the CRAWDAD registration page.

####Processing one or more traces

To process a particular trace file use the following commands in the linux terminal.

$ cd "path_to_Adyton"/utils/trace-processing/
$ chmod +x caravida.sh
$ ./caravida.sh <trace_name>

To process more than one trace use the same command, but using more options.

$ ./caravida.sh <trace_name_1> <trace_name_2> .. <trace_name_N>

To process all the supported traces, execute:

$ ./caravida.sh -all

To clean all temp files created during the processing, execute:

$ ./caravida.sh -clean

####Running with a gui

Also, a gui version of the tool is available through the command:

$ ./caravida.sh -gui

####Traces supported

Currently, the "caravida" tool supports the following list of traces.