Arxiv:1801.01947V1 [Astro-Ph.IM] 6 Jan 2018
Total Page:16
File Type:pdf, Size:1020Kb
Draft version January 9, 2018 Preprint typeset using LATEX style AASTeX6 v. 1.0 RADVEL: THE RADIAL VELOCITY MODELING TOOLKIT Benjamin J. Fulton1,2,3, Erik A. Petigura1,4, Sarah Blunt1, Evan Sinukoff1,2,5 1California Institute of Technology, Pasadena, California, U.S.A. 2Institute for Astronomy, University of Hawai‘i at Ma¯anoa, Honolulu, HI 96822, USA 3Texaco Fellow 4Hubble Fellow 5Natural Sciences and Engineering Research Council of Canada Graduate Student Fellow ABSTRACT RadVel is an open source Python package for modeling Keplerian orbits in radial velocity (RV) time series. RadVel provides a convenient framework to fit RVs using maximum a posteriori optimization and to compute robust confidence intervals by sampling the posterior probability density via Markov Chain Monte Carlo (MCMC). RadVel allows users to float or fix parameters, impose priors, and perform Bayesian model comparison. We have implemented realtime MCMC convergence tests to ensure adequate sampling of the posterior. RadVel can output a number of publication-quality plots and tables. Users may interface with RadVel through a convenient command-line interface or directly from Python. The code is object-oriented and thus naturally extensible. We encourage contributions from the community. Documentation is available at http://radvel.readthedocs.io. 1. INTRODUCTION (MCMC) sampling techniques and robust convergence The radial velocity (RV) technique was among the first criteria to ensure accurately estimated orbital parame- techniques to permit the discovery and characterization ters and their associated uncertainties. of extrasolar planets (e.g., Campbell et al. 1988; Latham The goal of this paper is to document the core features et al. 1989; Mayor & Queloz 1995; Marcy & Butler 1996). of RadVel version 1.0 (Fulton & Petigura 2017). Due to Prior to NASA’s Kepler Space Telescope (Borucki et al. the evolving nature of RadVel, the most up to date docu- 2010), the RV technique accounted for the vast majority mentation can be found at http://radvel.readthedocs.io of exoplanet detections (Akeson et al. 2013). (RTD page hereafter). This paper complements that In the post-Kepler era, the RV field has shifted some- documentation and is structured as follows: we describe what from discovery to follow up and characterization the parameters involved to describe an RV orbit in Sec- of planets discovered by transit surveys. In the case tion2, in Section3 we discuss Bayesian inference as of planets discovered via either technique the need to implemented in RadVel. The design of the code is de- model RV orbits to extract planet masses (or minimum scribed in Section4 and the model fitting procedure is masses, M sin i) is a critical tool necessary to understand described in Section5. We explain how to install RadVel the compositions and typical masses of exoplanets. and walk through two example fits to demonstrate how Several software packages have been written to ad- the code is run in Section6. We describe the mechanism for support and contributions in Section7 and close with arXiv:1801.01947v1 [astro-ph.IM] 6 Jan 2018 dress the need of the exoplanet community to fit RV time series.1 In designing RadVel, we have emphasized some concluding remarks in Section8. ease of use, flexibility, and extensibility. RadVel can be installed and a simple planetary system can mod- 2. THE RADIAL VELOCITY ORBIT eled from the command-line in seconds. RadVel also RV orbits are fundamentally described with five or- provides an extensive and well-documented application bital elements: orbital period (P ), a parameter that de- programming interface (API) to perform complex fitting scribes the orbital phase at a given time (we use the tasks. We employ modern Markov Chain Monte Carlo time of inferior conjunction, Tc), orbital eccentricity (e), the argument of periastron of the star’s orbit (!), and the velocity semi-amplitude (K). We also include terms 1 a non-exhaustive list includes RVLIN (Wright & Howard 2009), for the mean center-of-mass velocity (γ), plus linear (γ_ ) Systemic (Meschiari et al. 2009; Meschiari & Laughlin 2010), EXOFAST (Eastman et al. 2013), rvfit (Iglesias-Marzoa et al. 2015), and quadratic (γ¨) acceleration terms in the RV model. and ExoSOFT (Mede & Brandt 2017) Since RV measurement uncertainties generally do not 2 take into account contributions from astrophysical and single orbiting planet. Equation 1 is known as Kepler’s instrumental sources of noise we also fit for a “jitter” equation and we solve it using the iterative method pro- term (σ), which is added in quadrature with the mea- posed by Danby(1988), and reproduced in Murray & surement uncertainties. These parameters are listed and Dermott(1999). described in Table2 for reference. Figure1 depicts an Note that we equate _z to vr in our description of the example eccentric Keplerian orbit with several of these RV orbit. In our coordinate system, the ^z unit vector parameters annotated. We define a cartesian coordi- points away from the observer. Historically, this has nate system described by the ^x, ^y, and ^z unit vectors been the observational convention so that positive RV such that ^z points away from the observer and ^y is nor- can be interpreted as a redshift of the star. However, mal to the plane of the planet’s orbit. In this coordinate some derivations of this equation in the literature (e.g., system, the x-y plane defines the sky plane. Murray & Correia 2010; Deck et al. 2014) define their co- ordinate system such that ^z points toward the observer Table 1. Keplerian Orbital Elements and derive an equation for RV which is very similar to our Equation 3. The key difference when defining a co- Parameter Description Symbol ordinate system with ^z pointing toward the observer is that the sign in Equation 3 must be flipped (vr = −_z) Keplerian Orbital Parameters or, equivalently, ! must refer to the argument of peri- orbital period P apsis of the planet’s orbit which is shifted by π relative to the argument of periapsis of the star’s orbit. time of inferior conjunction (or transit)1 T c In the case of multiple planets the Keplerian orbits time of periastron1,2 T p are summed together. We also add acceleration terms eccentricity e to account for additional perturbers in the system with 2 argument of periapsis of the star’s orbit ! orbital periods much longer than the observational base- velocity semi-amplitude K line. The total RV motion of the star due to all com- panions (Vr) is, Mean and Acceleration Terms 3 Npl mean center-of-mass velocity γi X 2 Vr = vr;k + γ +γ _ (t − t0) +γ ¨(t − t0) ; (4) linear acceleration term γ_ k second order acceleration term γ¨ where Npl is the total number of planets in the system Noise Parameters and t0 is an arbitrary abscissa epoch defined by the user. radial velocity “jitter” (white noise)3 σ i 2.2. Parameterization 1 In order to speed fitting convergence and avoid biasing Either Tc or Tp can be used to describe the phase of the orbit. Both are not needed simultaneously. parameters that must physically be finite and positive 2undefined for circular orbits (e.g. Lucy & Sweeney 1971) analytical transformations of the orbital elements are often used to describe the 3usually specific to each instrument (i) orbit. In RadVel we have implemented several of these transformations into six different “basis” sets. One of the highlight features of RadVel is the ability to easily switch between these different bases. This allows the 2.1. Keplerian Solver user to explore any biases that might arise based on Synthesizing radial velocities involves solving the fol- the choice of parameterization, and/or impose priors on lowing system of equations, parameters or combinations of parameters that are not typically used to describe an RV orbit (e.g. a prior on M = E − e sin E (1) e cos ! from a secondary eclipse detection). ! r1 + e E We have implemented the basis sets listed in Ta- ν = 2 tan−1 tan (2) 1 − e 2 ble 2.2. Users can easily add additional basis sets by modifying the radvel.basis.Basis object. A _z= v = K[cos(ν + !) + e cos(!)] (3) r string representation of the new basis should be where M is the mean anomaly, E is the eccentric added to the radvel.basis.Basis.BASIS_NAMES at- anomaly, and e is the orbital eccentricity, ν is commonly tribute. The radvel.basis.Basis.to_synth and referred to as the true anomaly, K is the velocity semi- radvel.basis.Basis.from_synth methods should also amplitude, and vr is the star’s reflex RV caused by a be updated to properly transform the new basis to and 3 315° 150 0° 270° orbital period ( ) apoapsis of the planet's orbit ) ( 100 e d u t i l p m a - i m ] e redshift periapsis of the s toward Earth s 50 45° star's orbit 225° m [ V inferior R direction conjunction ) of orbit ( 0 e periapsis of d u t i orbit of the planet's orbit l star p m a orbit of - planet i m e blueshift s 90° 180° 50 sky plane 135° 0.8 0.6 0.4 0.2 0.0 0.2 0.4 0.6 0.8 true anomaly ( ) Orbital Phase Figure 1. Diagram of a Keplerian orbit. Left: Top-down view of an eccentric Keplerian orbit with relevant parameters labeled. The planet’s orbit is plotted as a light grey dotted line and the star’s orbit is plotted in blue (scale exaggerated for clarity). Right: Model radial velocity curve for the same orbit with the relevant parameters labeled. We define a cartesian coordinate system described by the ^x, ^y, and ^z unit vectors such that ^z points away from the observer and ^y is normal to the plane of the planet’s orbit.