Fork notice: This is a fork of dstndstn/tractor ("the Tractor"), created for the NASA SPHEREx mission's use by the SPHEREx Science Data Center team at Caltech/IPAC. It differs from the upstream -- see
FORK.mdfor what changed and why. Licensed under GPLv2, the same as the upstream.Changes are copyright (C) 2023-2026, California Institute of Technology.
The automated build and coverage badges shown below report on the upstream's CI on external services (CircleCI, Coveralls, Codecov) and do not reflect the status of this fork.
Probabilistic astronomical source detection & measurement
Copyright 2011-2023 Dustin Lang (Perimeter Institute) & David W. Hogg (NYU/Flatiron)
Licensed under GPLv2; see LICENSE.
First, install the Astrometry.net code. (https://astrometry.net/downloads or https://github.com/dstndstn/astrometry.net/tags). You can do this by grabbing the code and using "make", or you can install the python code directly using pip:
pip install git+https://github.com/dstndstn/astrometry.net.git
Then grab the Tractor code:
git clone git@github.com:dstndstn/tractor.git
cd tractor
make
# OR
python3 setup.py build_ext --inplace --with-ceres --with-cython
It is possible to run directly out of the checked-out tractor directory. But if you want to install it, you can use pip, optionally with flags to enable Ceres Solver (requires the Ceres library), and Cython:
pip install -v --install-option="--with-ceres" --install-option="--with-cython" .
There is a test script that renders SDSS images:
python examples/tractor-sdss-synth.py
Prereqs:
- scipy
- numpy
- astrometry.net
Other packages used in various places include:
Horribly incomplete, but online at http://thetractor.org/doc and http://thetractor.readthedocs.org/en/latest/
We are trying to move from a "Research code that only we use" phase to "Research code that other people can use". We are happy to hear your feedback; please feel free to file Issues. And naturally we will be pleased to see pull requests!