Skip to content
drphilmarshall edited this page Apr 6, 2012 · 8 revisions

Accessing the Pangloss Code

We are developing open source software to infer the gravitational lensing effects of mass along the line of sight to interesting objects in the Universe. The code is currently in an 'alpha' state. It is nevertheless freely available, but we do ask that you follow the guidelines on this page before you download it.

Download

There are two ways to download the code, one for close collaborators and one for the rest of the world.

  • Close collaborators: Send email to Phil asking to become a collaborator, with read+write access.

  • Everyone else: Fork the git repository into an independent branch that you own.

In either case you will need to git clone the repository onto your local machine (it's worth setting up github with your ssh keys at this point). You will then be able to edit the code on your local machine. You will also be able to request to submit your changes back to the central archive. Close collaborators will be able to push directly (making collaboration fast). The github help is very well written, and does not take long to work through.

Everyone else will be able to submit pull requests for consideration. For these to be considered, we'd like you to introduce yourselves! While the code is freely available to download at any time, we'd like to know if you are using it - especially if you plan on making useful modifications to it. In fact, if you do want to do anything with the code, it'd be nice if you would send email to the Pangloss community email list introducing yourself. (Don't forget to include your github username!)

License

We distribute the Pangloss code under the GNU general public license (see the LICENSE file in the code repository), with the following additional recommendation that if you are working with the code, that you keep in touch. Note that providing a license is not the same as providing a warranty: while trying our best, we can't guarantee successful code.

Dependencies

It's true, you will have to have some other packages installed to run Pangloss. Here they are, they're all free, and mostly available by pip (python package manager) and homebrew:

python numpy, scipy, pyfits atpy