No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
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.
docs Added cert features Jan 17, 2018
examples initial commit Dec 15, 2017
safekit removed cert lm configs Jan 22, 2018
test initial commit Dec 15, 2017
.gitattributes Added cert features Jan 17, 2018
.gitignore initial commit Dec 15, 2017
DISCLAIMER initial commit Dec 15, 2017
LICENSE fixed license conflict Dec 18, 2017
README.rst fixed path in readme Aug 17, 2018
data_examples.tar.bz2 initial commit Dec 15, 2017
setup.py initial commit Dec 15, 2017

README.rst

Authors

About Safekit

Safekit is a python software package for anomaly detection from multivariate streams, developed for the AIMSAFE (Analysis in Motion Stream Adaptive Foraging for Evidence) project at Pacific Northwest National Laboratory. An exposition of the models in this package can be found in the papers:

The code of the toolkit is written in python using the tensorflow deep learning toolkit and numpy.

Dependencies

Dependencies required for installation:

  • Tensorflow 1.0 or above
  • Numpy
  • Scipy
  • Sklearn
  • Matplotlib

Python Distribution

Safekit is written in python 2. Most functionality should be forwards compatible.

Installation

A virtual environment is recommended for installation. Make sure that tensorflow 1.0+ is installed in your virtual environment.

Install tensorflow

From the terminal in your activated virtual environment:

(venv)$ git clone https:/github.com/pnnl/safekit.git
(venv)$ cd safekit/
(venv)$ python setup.py develop

To test your installation, from the top level directory run:

$ tar -xjvf data_examples.tar.bz2
$ python test/agg_tests.py data_examples/lanl/agg_feats data_examples/cert/agg_feats test.log
$ python test/lanl_lm_tests.py data_examples/lanl/lm_feats/ test.log

These two tests should take about 10 to 15 minutes each depending on the processing capability of your system. The tests range over many different model configurations and can be used as a somewhat comprehensive tutorial on the functionality of the code base.

Documentation

Github hosted documentation

Docs can be read locally from the cloned repo by opening safekit/docs/_build/html/index.html with a browser.