This is the software controller for GUPPI, "the best damn pulsar instrument in the world" (via http://www.cv.nrao.edu/~sransom/). GUPPI started with the name "Green Bank Ultimate Pulsar Processing Instrument", but really we just call it "guppi" (though it is ultimate).
The guppi controller was developed against Python 2.5 starting in 2008, and has also been tested against Python 2.4.
Install guppi_daq first. This has its own dependencies, including (but not limited to) mysql-python, pyfits, and some slalib & shared memory stuff.
This project was developed against Optio's soaplib package, version 0.7.2. One of the enhancement requests on this project is to move away from SOAP entirely. Until that happens, you'll have to track down a pre-0.8 version of soaplib or update the project to use soaplib's successive (non-Optio) development. As a shortcut, this version is already available on beef.gb.nrao.edu. Go there first:
beef.gb.nrao.edu:/home/pulsar64/lib/python2.5/site-packages
cp -a soaplib-0.7.2dev_r27-py2.5.egg/soaplib somedestinationThe matplotlib dependency (which depends on numpy and some GUI toolkit) might not install as easily as the others when installing from the Python package index, so manual intervention may be required here.
With setuptools (from easy_install) installed:
python setup.py install --prefix=/path/to/guppiBe sure to set a good prefix or remove it altogether. This command installs the guppi controller to the given prefix and the required dependencies as listed in setup.py to the site packages. python setup.py install may require administrative access when installing these dependencies. If dependencies are already installed, any user with write permissions to the prefix location should be able to install an updated version of the guppi controller.
Deployments use supervisord to manage all running processes for the guppi controller. Example configurations are available in the etc/ area of the project.
For various reasons, the guppi controller was never versioned. Instead use a datestring of yyyy.mm.dd. Currently this datestring is set manually in setup.py.
You can find your installed version by noting the version in the file path:
python -c 'import guppi; print guppi.__file__'It is possible to use ipython with the guppi interpreter. Change:
exec /usr/bin/env python -i -c 'from guppi.interpreter import *' $@in the guppi launch script (see scripts/guppi) to:
exec /usr/bin/env ipython -i -c 'from guppi.interpreter import *' $@Note however that this breaks the tab completer as written. A better approach would be to use Python's builtin code module and call code.interact(...). guppi saw first light with the python -i trick and we've kept it since. See Flask-Script (http://packages.python.org/Flask-Script/) for a simple example of how to use code.interact(...) with ipython option.