MUON tools
Find here all information concerning the different MUON tools.


Tools providing analysis on simulation tracks

Tools providing analysis based on journeys and horizons

Calculate cliques

Description : Calculate the cliques from an input DGS file.
Input: dgs
Output: clique

Calculate the progression of the horizons of all nodes

Description : Calculate the progression of the horizons of all nodes from an input DGS file.
Input: dgs
Output: hzons

Calculate ideal journeys

Description : Calculate the journeys for a list of nodes from an input DGS file.
Input: dgsjrney
Output: jrney

Calculate temporal views

Description : Calculate the views for a list of nodes from an input DGS file.
Input: dgs
Output: view

Display graph temporal distances

Description : Display the evolution of temporal distances (foremost and latest) between all couples of nodes in a graph along time
Input: dgs
Output: datasvgplotdatasvgplot

Display horizons sets

Description : Display and/or compare the nodes in the horizons of source nodes from given journeys. If a journey id is provided, compare the nodes in the horizons having this id, else compare the horizons cardinalities. If a file containing 'ideal' journeys is provided, the horizons are relative to the ideal horizons (ratios), else, the values are absolute
Input: jrneyjrney
Output: datasvgtxt

Convert journeys to DGS

Description : Reads a file containing descriptions of message journeys, and produces a DGS file where nodes are tagged with the journey id at the time of a journey hop related to the node.
Input: jrney
Output: dgs

Calculate nodes centrality

Description : Calculate the centrality of relay nodes for a journey.
Input: dgs
Output: datasvgtxt

Display a journey timeline

Description : Display a timeline representing several journeys or a single journey (hops between nodes along time)
Input: jrney
Output: datasvgtxt

Filter journeys

Description : Filter hops in journeys based on from/to nodes
Input: jrney
Output: jrney

Calculate messages journeys

Description : Parse log files containing lines for messages emissions/receptions and produce the journeys of the messages.
Input: aevt
Output: jrney

Display temporal distances from/to a node

Description : Display the evolution of temporal distances (foremost and latest) between a given node and all other nodes along time
Input: dgs
Output: datasvgplotdatasvgplot

Display temporal distances for a couple of nodes

Description : Display the evolution of temporal distances (foremost and latest) between a couple of nodes along time
Input: dgs
Output: datasvgplotdatasvgplot

Calculate probabilistic network robustness

Description : Calculate the robustness of the network by randomly removing nodes and observe the reaction of the network to the increased number of node failures. The result is calculated over a certain number of iterations.
Input: dgs
Output: datasvgplot

Calculate targeted network robustness

Description : Calculate the robustness of the network by removing one or more targeted nodes. Compare results between removed targets as well as remove multiple nodes in one go to evaluate how the network reacts to specific losses.
Input: dgs
Output: md

Display journeys temporal distances

Description : Display and/or compare the temporal distances of journeys. If a journey id is provided, display the temporal distances to each node of the journey. Else, display the eccentricity for each journey. If a file containing 'ideal' journeys is provided, the distances are relative to the ideal distances, else, the values are absolute
Input: jrneyjrney
Output: datasvgtxt

Tools providing statistics on simulation tracks

Calculate statistics about events

Description : Parses an events file, and calculates statistics about the number of messages published and received by each node.
Input: aevt
Output: data

Calculate statistics

Description : Parses a data file, and calculates statistics based on the numerical values contained in one column of that file.
Input: data
Output: md

Tools providing analysis about edges and messages

Calculate contact distance

Description : Calculates the distance at each point in time between two nodes during a specific contact. The resulting distances are used to create a graph depicting the evolution of the distance during the contact. If messages were exchanged during the contact, the distance at that point in time is extrapolated. The direction of the message is also extrapolated, and have their own column in the data file, therefor using different colours for the graph.
Input: dgsaevt
Output: datasvgtxt

Calculate contacts durations

Description : Calculate contacts and intercontacts durations from edges in a DGS input file as well as statistics about the number and duration of contacts and intercontacts.
Input: dgs
Output: mddatasvgtxtdatasvgtxtdatasvgtxt

Estimate Node Contacts

Description : Estimate the number of potential neighbours in a radious around a node, and compare to the connections extracted from a DGS file.
Input: dgs
Output: datasvgtxt

Calculate edge density timeline

Description : Calculates the number of nodes and the adge density of the graph over time. Density: 2|E| / |V|(|V|-1)
Input: dgs
Output: datamdsvgtxt

Message Statistics

Description : Calculate the message statistics of nodes from the message event file. The statistics concerning the number of published messages, number of sent published messages, number of transferred messages, total number of sent messages and the number of received messages are retrieved.
Input: aevt
Output: md

Calculate messages distance

Description : Reads simultaneously a DGS file and a MSG file, and for each receive event contained in the MSG file calculates the distance between sender and receiver during that event (based on locations contained in the DGS file).
Input: dgsaevt
Output: aevt

Display node neighborhood timeline

Description : Display the number of neighbors of a node along time
Input: dgs
Output: datasvgtxt

Convert transmissions to DGS

Description : Reads simultaneously a DGS file and a MSG file, and for each receive event contained in the MSG file, extracts the coordinates of the sender and receiver at that time from the DGS file.
Input: dgsaevt
Output: dgs

Count transmissions during contacts

Description : Reads simultaneously a DGS file and a MSG file, and for each receive event contained in the MSG file, and for each contact (i.e., each edge) defined in the DGS file, calculates the number of message transfers during that contact (based on the receive events described in the MSG file).
Input: dgsaevt
Output: data

Tools providing analysis about nodes activity

Calculate contacts from mobility

Description : Converts a DGS file containing node locations to a DGS file with nodes locations and contact edges from a given fixed range.
Input: dgs
Output: dgs

Interpolate DGS mobility

Description : Reads a DGS file containing only node locations on stdin and produces on stdout a DGS file with interpolated locations, according to the set period.
Input: dgs
Output: dgs

Smoothen DGS mobility

Description : Reads a DGS file on stdin, focusing on lines pertaining to a given node (if specified), and produces mobility statistics and a DGS file expurged from all lines that exceed the specified limits (if specified)
Input: dgs
Output: datadgs

Calculate nodes activity

Description : Parses the nodes appearance/disappearance and prints a CDF representation of the amount of time each node is online.
Input: dgs
Output: mdsvg

Calculate nodes presence timeline

Description : Calculate the number of nodes in the graph along time, as well as the number of nodes potentialy in horizon and view
Input: dgs
Output: datasvgplot

Transformation and filtering of files

Transformation of files from a format to another format or to the same format with different informations

Convert DGS to history

Description : Parses a DGS file and produces a history of nodes creations and deletions
Input: dgs
Output: data

Convert DGS to One

Description : Transforms a DGS file into a One file
Input: dgs
Output: one

Extracts the bounding box of a DGS file

Description : Extracts the bounding box of a DGS file
Input: dgs
Output:

Nullifies contacts in DGS file

Description : Reads a DGS file and produces an equivalent file with all contacts nullified (i.e., contact duration reduced to 1 ms).
Input: dgs
Output: dgs

Changes the coordinates of all nodes in the DGS file by applying a rotation around a reference point

Description : Changes the coordinates of all nodes in the DGS file by applying a rotation around a reference point
Input: dgs
Output: dgs

Scales up or down the coordinates of all nodes in the DGS file

Description : Scales up or down the coordinates of all nodes in the DGS file
Input: dgs
Output: dgs

Changes the coordinates of all nodes in the DGS file by applying a constant offset

Description : Changes the coordinates of all nodes in the DGS file by applying a constant offset
Input: dgs
Output: dgs

Normalize DGS Edges

Description : Reads a DGS file and produces an equivalent with all events pertaining to edge creation or deletion normalized.
Input: dgs
Output: dgs

Convert geo to cartesian

Description : Convert a DGS file with nodes locations expressed in geographical coordinates to cartesian coordinates
Input: dgs
Output: dgs

Merge DGS

Description : Merges several DGS files and produces a single DGS file
Input: dgs
Output: dgs

Repair DGS

Description : Repair a DGS file with errors to produce a DGS file without errors
Input: dgs
Output: dgs

DGSReverser

Description : Reverse a DFS file chronologically, while inverting all graph events (i.e., 'an <=> dn' and 'ae <=> de')
Input: dgs
Output: dgs

Computes distance and speed between successive node locations

Description : Reads a DGS file and produces an equivalent file with distance and speed for every node location.
Input: dgs
Output: dgs

Normalize DGS Steps

Description : Transform a DGS file by shifting all steps so that the first step has a given value (default: 0) and initialize the ref_time accordingly.
Input: dgs
Output: dgs

Convert One to DGS

Description : Transforms a ONE file into a DGS file
Input: one
Output: dgs

Transformation of files from a format to the same format with more/less informations

Filter Area

Description : Filter nodes based on their position, keeping only those that are in the defined area.
Input: dgs
Output: dgs

Filter DGS edges

Description : Filters out events pertaining to edges having specific attributes only.
Input: dgs
Output: dgs

Filter DGS nodes

Description : Filters out events pertaining to nodes having specific attributes only.
Input: dgs
Output: dgs

Filter DGS Period

Description : Filters out events, keeping only that which is contained between two given steps.
Input: dgs
Output: dgs

Filter Messages Period

Description : Filters out events, keeping only that which is contained between two given steps.
Input: aevt
Output: aevt

Plotting tools

Generate CDF

Description : Generate a cumulative distribution function from a column of comparable values.
Input: data
Output: data

Merge CDF

Description : Merge several CDF data files to a unique one.
Input: data
Output: data

Plot CDF

Description : launch gnuplot with given input CDF data file(s)
Input: data
Output: svgtxt

Plot Data

Description : Launch gnuplot with given input data file(s) and properties
Input: data
Output: svgtxt

Tools used to display or produce videos from simulation tracks

Tools used to display simulation tracks

Tools used to produce videos from simulation tracks

Make movie

Description : Makes a movie from a set of PNG images. The images must be in the current directory, and the image filenames must be of the form img_NNNNN.png
Input:
Output: video (mp4, mkv)