Welcome to PyTransit documentation! PyTransit is a package for exoplanet transit light curve modelling that offers optimised CPU and GPU implementations of exoplanet transit models with a unified interface (API). Transit model evaluation is trivial for simple use-cases, such as homogeneous light curves observed in a single passband, but also straightforward for more complex use-cases, such as when dealing with heterogeneous light curves containing transits observed in different passbands and different instruments, or with transmission spectroscopy.

The development of PyTransit began in 2009 to fill the need for a fast and reliable exoplanet transit modelling toolkit for Python. Since then, PyTransit has gone through several iterations, always thriving to be the fastest and most versatile exoplanet transit modelling tool for Python.


The transit model initialization is straightforward. At its simplest, the model takes an array the mid-exposure times,

from pytransit import RoadRunnerModel

tm = RoadRunnerModel('quadratic')

after which it is ready to be evaluated

tm.evaluate(k=0.1, ldc=[0.2, 0.1], t0=0.0, p=1.0, a=3.0, i=0.5*pi)

To complicate the situation a bit, we can consider a case where we want to model several transits observed in different passbands. The stellar limb darkening varies from passband to passband, so we need to give a set of limb darkening coefficients for each passband, and we may also want to allow the radius ratio to vary from passband to passband. Now, we will only need to initialise the model with per-exposure light curve indices (lcids) and per-light-curve passband indices (pbids) (don’t worry, these are simple integer arrays), after which we are ready to evaluate the model with passband-dependent radius ratio and limb darkening

tm.set_data(times, lcids=lcids, pbids=pbids)
tm.evaluate(k=[0.10, 0.12], ldc=[[0.2, 0.1, 0.5, 0.1]], t0=0.0, p=1.0, a=3.0, i=0.5*pi)

We made both the radius ratio and limb darkening passband-dependent in the example above, but we could just as well evaluate the model with a single scalar radius ratio (as in the first example), in which case only the limb darkening would be passband-dependent.

We may often want to evaluate the model for a large set of parameters at the same time (such as when doing MCMC sampling with emcee, or using some other population-based sampling or minimization method). Give evaluate an array of parameters

tm.evaluate(k=[[0.10, 0.12], [0.11, 0.13]],
            ldc=[[0.2, 0.1, 0.5, 0.1],[0.4, 0.2, 0.75, 0.1]],
            t0=[0.0, 0.01], p=[1, 1], a=[3.0, 2.9], i=[.5*pi, .5*pi])

and PyTransit will calculate the models for the whole parameter set in parallel.


Indices and tables#