Hello world! Welcome to the documentation for
orbitize, a Python
package for fitting orbits of directly imaged planets.
orbitize packages two back-end algorithms into a consistent API.
It’s written to be fast, extensible, and easy-to-use. The tutorials below will walk
you through the code and introduce some technical stuff, but we suggest learning about
the Orbits for the Impatient (OFTI) algorithm
and MCMC algorithms (we use this one) before diving in.
Our contributor guidelines
document will point you to more useful resources.
orbitize is designed to meet the needs of the exoplanet imaging community, and we
encourage community involvement. If you find a bug, want to request a feature, etc. please
create an issue on GitHub.
orbitize is patterned after and inspired by radvel.
If you use
orbitizein your work, please cite Blunt et al (2019).
If you use the OFTI algorithm, please also cite Blunt et al (2017).
If you use the Affine-invariant MCMC algorithm from
emcee, please also cite Foreman-Mackey et al (2013).
If you use the parallel-tempered Affine-invariant MCMC algorithm from
ptemcee, please also cite Vousden et al (2016).
- Detailed API Documentation
orbitize is under active development, and we’ve still got a lot to do! To get involved,
check out our contributor guidelines,
look over our issues list, and/or reach out to
Sarah. We’d love to have
you on our team!
Some major planned updates:
fit orbits of multiple objects in one system
fit Gaia astrometry & RVs
marginalize over instrumental uncertainties
Default corner plots now display angles in degrees instead of radians
Add a keyword for plotting orbits that cross PA=360
Mikkola solver now implemented in C-Kepler solver
Fixed a bug with parallel processing for OFTI
Added orbit vizualisation jupyter nb show-me-the-orbit to docs/tutorials
New methods for viewing/chopping MCMC chains
Parallel processing for OFTI.
Fixed a bug converting errors in RA/Dec to sep/PA in OFTI.
OFTI and MCMC now both return likelihood, whereas before one returned posterior.
Updated logic for restricting Omega and omega bounds.
API change to lay the groundwork for dynamical mass calculation.
JeffreysPrior -> LogUniformPrior
Added some informative error messages for input tables.
Bugfix for RA/Dec inputs to the OFTI sampler (Issue #108).
Add ability to customize date of tau definition.
Sampler now saves choice of tau reference with results.
Default tau value is now Jan 1, 2020.
Add custom likelihood function.
Add progress bar for
Add customizable color axis for orbit plots.
Add sep/PA panels to orbit plot.
GaussianPriornow operates on only positive numbers by default.
Expand input reading functionality.
Bugfixes for MCMC.
Bugfix for building on CentOS machines.