Peregrine has the following requirements:
Peregrine also depends on other projects for optional features.
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 follows:
$ pip install git+https://github.com/fnoble/python-progressbar.git
The peregrine source and release tarballs 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
Installation requires Distribute, if your python installation doesn’t provide this it will automatically be installed.
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.
If you are a developer and intend to make modifications to Peregrine then you can instead run:
$ python setup.py develop
Which is similar to install but instead of copying Peregrine to the install location, a link is made from the source location to the install location so you can continue to work on the source without having to run install every time you wish to test your changes.
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:
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.