backtracks
backtracks is a python package to fit relative astrometry with background helical motion tracks, to discern directly imaged planets from contaminant sources
The code is written and developed by Gilles Otten (@gotten), William Balmer (@wbalmer), and Tomas Stolker (@tomasstolker).
Documentation
Documentation can be found at http://backtracks.readthedocs.io.
Tutorial
A Jupyter notebook will show you how to use backtracks by reproducing the result in Nielsen et al. (2017) and Wagner et al. (2022) for the case of the former exoplanet candidate around HD 131339 A.
Attribution
If you use backtracks in your published work, please cite our Zenodo entry (here), and provide a footnote/acknowledgement linking to our package. An example bibtex citation is included below, but you may wish to cite a specific version of the package via zenodo instead. Thank you!
@software{backtracks_code,
author = {William O. Balmer and
Gilles P. P. L. Otten and
Tomas Stolker},
title = {backtracks: a python package to compare relative astrometry with background helical motion: v0.6},
month = feb,
year = 2025,
publisher = {Zenodo},
version = {v0.6},
doi = {10.5281/zenodo.14838369},
url = {https://doi.org/10.5281/zenodo.14838369},
}
Details
High precision relative astrometry calculations with USNO’s NOVAS via the python implementation<https://pypi.org/project/novas/>. Thanks to Brandon Rhodes for maintaining this python package.
eDR3 Distance prior summary file from Bailer-Jones et al. (2021).
Example of HD 131399Ab uses data from Wagner et al. (2022) and Nielsen et al. (2017). Thank you to Kevin Wagner for providing the latest astrometry!
Log-likelihood and some utility functions borrowed heavily from orbitize! (BSD 3-clause).
PPF of multivariate normal borrowed from pints (BSD 3-clause).
Installation
Currently requires and python 3.9-3.11 ish and astropy, corner, dynesty, matplotlib, numpy, novas, novas_de405, and their dependencies. Note that novas is not supported on Windows. You can create a working environment using conda+pip via a few lines of code:
$ conda create python=3.11 -n backtrack
$ conda activate backtrack
$ conda install pip
$ pip install backtracksOr, to clone the repo and install in development mode (we recommend this, as the code is a work in progress and you can easily fix bugs you will likely encounter this way):
$ conda create python=3.11 -n backtrack
$ conda activate backtrack
$ conda install pip
$ git clone https://github.com/wbalmer/backtrack.git
$ cd backtrack
$ pip install -e .Then, test your installation:
>>> from backtracks import System1 maintainer
Metadata
1 maintainer
Release files for backtracks 0.6.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| backtracks-0.6.4.tar.gz | 12.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| backtracks-0.6.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.0 MB
Release files / backtracks-0.6.4.tar.gz
| Download URL | backtracks-0.6.4.tar.gz |
|---|---|
| Size | 12.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1bae34b2303f70db96079269726de88d2678daeea26be77fa1cb046b327fa8c5
|
|
BLAKE2b-256 checksum How to use checksums |
4c7cc63df369c44b1a2620a3652ae97351860f231266ade275f91eb522995af5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / backtracks-0.6.4-py3-none-any.whl
| Download URL | backtracks-0.6.4-py3-none-any.whl |
|---|---|
| Size | 360.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
31f4fb6ce7b7932f1d56e2e1a483ca10410208ff56af79592ef70f730aad9c03
|
|
BLAKE2b-256 checksum How to use checksums |
d28c1b26c3743a6328804b857f61967678ab2397aa4f2da483d6e554d0a05be6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
