NuPIC demo app for geospatial anomaly detection.
JavaScript Python HTML CSS

README.md

NuPIC Geospatial Tracking Application

Build Status Coverage Status

Geospatial anomaly detection app using NuPIC.

Dependencies

You must have NuPIC installed. Please follow the installation instructions there.

Now, install the other python requirements for nupic.geospatial:

pip install -r requirements.txt

Tutorial Videos

Using the NuPIC Geospatial Tracking Application

NuPIC Geospatial Tracking Application Tutorial

Geospatial Coordinate Encoder Explained

Geospatial Coordinate Encoder

Usage

To run, simply start the web server from the command line:

python server.py

This will start a web server and load some initial sample data for viewing. Open http://localhost:5000 in your browser to view and walk through the tracks.

Route Viewer

Loading Your Own GPS Tracks

You can create GPS tracks with many mobile applications and GPS trackers. Any GPS data in the GPX file format can be loaded into nupic.geospatial (which runs it through NuPIC) and analyzed through the web browser. Here are a couple of popular apps you might use on your phone that produce GPX files:

Converting GPX Files

You can convert one file or a directory full of GPX files into a format that is readable by nupic.geospatial. To do this, run the script as shown below:

./tools/convert_gpx.py <path/to/gpx/file/or/folder>

This will write out a file you can use as input for ./run.py (described below). For all options, run ./tools/convert_gpx.py --help

Running Converted Tracks Through nupic.geospatial

Now that you have converted your GPX files into the proper format for nupic.geospatial, there is another script to run them through NuPIC.

./run.py <path/to/input/csv>

The input file could be converted GPX data (see above) or the results from the route simulator in the web app (see below). This script will automatically create sequences base on the timing of the input rows. If you don't want this behavior, you can negate it with the --manual-sequence option, which will create sequences based upon the name field of the input CSV file. There are several other options available for this command. Run ./run.py --help to see them all.

After running this script, the output data will be written static/js/data.js, where the web server can load it into the browser. Now you can simply run python server.py to start the server and view your analyzed data.

Using the route simulator

You can experiment with different routes without a GPS device by using the route simulator. It will generate geospatial data and run it through NuPIC while the server is running. Simply open http://localhost:5000/simulate in your browser. Once you've created a route (or routes), you can either run them immediately through NuPIC with the "Build" button (at the top right of the screen), or you can save the tracks to a local file for running later with the run.py script (see above).

Route Simulator