Peregrine is a fast and flexible open-source software GNSS receiver. It can be used as a standalone application to post-process GNSS data all the way to PVT solutions or as from within IPython <http://ipython.org/> as a toolkit for GNSS data exploration.
Peregrine is written in Python <http://www.python.org/> for flexibility and ease of development and uses the libswiftnav C library for speed.
Full documentation available online at http://docs.swift-nav.com/peregrine.
You can automatically install dependencies using:
$ ./deps.sh
Peregrine makes use of the following packages:
Peregrine can also be used interactively with IPython and requires an additional two packages:
- [Optional] progressbar to display a progress indication in the terminal whilst running.
- [Optional] matplotlib to support generation of plots.
On Ubuntu these can be installed from the repositories:
$ sudo apt-get install python-numpy python-fftw python-matplotlib libfftw3-dev $ pip install git+https://github.com/fnoble/python-progressbar.git
Note
Peregrine makes use of some extensions to the progressbar library that are not yet merged upstream. For now you can install our development version as shown in the command above.
Additionally, Peregrine depends on the libswiftnav libraries and Python bindings, see each of the packages for installation instructions:
The peregrine source are available from GitHub, https://github.com/swift-nav/peregrine.
The latest development version of peregrine can be cloned from GitHub using this command:
$ git clone git://github.com/swift-nav/peregrine.git
Note
pyFFTW requires FFTW3 which should be available through your operating system package manager. For Mac OS X we recommend using Homebrew.
To install Peregrine (from the root of the source tree):
$ python setup.py install
This will download and install any required python modules from PyPI.
Peregrine also supports a developer mode that creates a symbolic link from the source location to the install location. This enables you to modify Peregrine without having to install it every time. It can be installed by:
$ python setup.py develop
Note
The latest version of Peregrine's documentation should be available online at http://docs.swift-nav.com/peregrine.
Building the documentation requires the Peregrine source code and some additional packages:
These packages can be installed on Ubuntu 12.04 or later:
$ sudo apt-get install python-sphinx python-matplotlib ipython texlive-full dvipng $ sudo pip install numpydoc
To build the Peregrine documentation, execute the following commands:
$ cd docs $ make html
The documentation will be built in the docs/_build/html directory, and can
be read by pointing a web browser to docs/_build/html/index.html.