A Python 3 utility library for querying, analyzing, and visualizing MONROE data.
Branch: master
Clone or download
Pull request Compare This branch is 96 commits ahead, 3 commits behind biolab:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
anomaly examples
notebooks
ricercando
scripts
workflows
.travis.yml
README.md
setup.py

README.md

RICERCANDO - Network Measurement Analysis Toolbox

Build Status

The toolbox consists of:

  • A Python 3 utility library (Ricercando) for querying, analyzing, and visualizing MONROE data.
  • An Orange add-on for accessing MONROE data, either from an Influx DB database or a locally stored Dataframe file, and for Significant Group analysis.
  • Jupyter notebooks for rapid time-series and geographical analysis of MONROE data, and for automatic detection of anomalies.
  • Utility scripts for managing a local copy of MONROE data using Influx DB.

Prerequisites

To use Ricercando toolbox within Orange data mining suite, install Orange 3.9+ first.

To use time-series and visualisation notebooks, install the following Python packages:

  • pandas
  • ipywidgets
  • bokeh
  • paramnb
  • colorcet
  • geoviews (available from conda)

Installation of prerequisites using conda:

conda install -c conda-forge -c ioam -c pyviz orange3 pandas ipywidgets geoviews bokeh=0.13.0 colorcet param=1.7.0 paramnb qgrid=1.0.5 scikit-garden

Installation

Run the following command line in the Python 3 environment of choice:

pip install git+https://github.com/ivek1312/ricercando

As the project API is as of yet considered unstable, we recommend installing in development mode:

git clone https://github.com/ivek1312/ricercando
cd ricercando
pip install -e .

# Run tests to confirm the package is installed correctly
python setup.py test

Then issue git pull within ricercando directory every now and then. The alternative is to re-run pip install git+https://github.com/ivek1312/ricercando command whenever updating is desired.

Usage

For help on how to query data, see the relevant Jupyter notebook.

Instructions set up your own MONROE data copy in an Influx DB.

Visualisation Jupyter notebooks are in the notebooks directory.

For using Ricercando add-on in Orange, see examples in workflows directory.

Credits

This project has received funding from the European Union’s Horizon 2020 research and innovation programme.

Copyright (c) 2018, Faculty of Computer and Information Science University of Ljubljana, Slovenia

Contact: Veljko Pejovic, veljko.pejovic@fri.uni-lj.si

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.