Skip to content

src/core/rm.js ​

text
Rossiter–McLaughlin effect: the radial-velocity anomaly while a planet covers part of a rotating star.

The star rotates as a solid body. In the sky frame of kepler.js (X, Y in stellar radii, +Z toward the observer)
the planet crosses the disc moving toward +X and the orbit normal projects onto +Y (the transit chord is at
Y = -b). The sky-projected stellar spin axis is turned from the projected orbit normal by the projected
obliquity lambda, toward the planet's direction of motion: s = (sin lambda, cos lambda). A point (x, y) of the
disc then recedes from the observer at
    v(x, y) = v sin i*  (x cos lambda - y sin lambda)
(velocities positive away from the observer, as in rv.js), so for lambda = 0 the planet first covers the
approaching half and the anomaly starts positive. This is ellc's convention (Maxted 2016, lambda_1): test/rm.test.mjs
compares whole curves with ellc's flux-weighted velocities for lambda = 0, 30, -45 and 120 degrees, where the
opposite sign of lambda would differ by 5 to 52 m/s.

The anomaly is the shift of the flux-weighted mean velocity of the light that is left:
    dV = - int_occ I v dA / (F_star - int_occ I dA),     int over the disc of I v dA = 0,
the quantity Ohta et al. (2005) expand for a small planet. It is not what a fit of a Gaussian to the
cross-correlation function measures for a well-resolved line (Hirano et al. 2010, Boué et al. 2013), which is
smaller by up to tens of per cent when v sin i is comparable to the line width.

Both integrals over the occulted area are line integrals around its boundary (Green's theorem). With
F(r) = int_0^r I(r') r' dr' (closed form for the Claret law; transit.js hOf) the field (F(r), 0) has divergence
I(r) x, so the first moment of the intensity along the line from the star's centre to the planet's is
    M = int_occ I x' dA = oint F(r) dy'
around the occulted region: an arc of the planet's limb, plus during ingress and egress an arc of the stellar
limb where F = F(1). The occulted region is symmetric about that line, so the perpendicular moment vanishes.
The blocked flux is the transit kernel's (transit.js blockedFraction).

Import: import { … } from './src/core/rm.js' — no DOM, runs in Node and the browser.

occultedMoment ​

js
function occultedMoment(z, p, ld)
text
First moment of the intensity over the occulted part of the disc, along the direction from the star's centre to
the planet's: int I(r) x' dA, with I(0) = 1 and the stellar radius 1. z: centre-to-centre distance, p: Rp/R*,
ld: prepareLD(...) of the Claret coefficients.

rmAnomaly ​

js
function rmAnomaly(X, Y, p, ld, vsini, lambda)

Velocity anomaly (same unit as vsini) with the planet's centre at sky position (X, Y) in stellar radii, in front of the star. p: Rp/R*, ld: prepareLD(...) of Claret coefficients, lambda in degrees.

rmSmallPlanet ​

js
function rmSmallPlanet(X, Y, p, a, vsini, lambda)
text
Ohta et al. (2005) small-planet limit: the planet as a point that removes pi p^2 I(mu) of light at its centre,
    dV = - v sin i* x_s pi p^2 I(mu) / (F_star - pi p^2 I(mu)),   x_s = X cos lambda - Y sin lambda.
For checks; the model is rmAnomaly.

ccfFit ​

js
function ccfFit(vsini, betaP, ld, kern)
text
The Gaussian that best fits (least squares over the line, free amplitude) the disc-integrated profile: the rotation
kernel of v sin i (limb darkening ld = prepareLD(...)) convolved with a Gaussian of dispersion beta_p, on 301
velocities over +- (v sin i + 6 beta_p). Returns { beta0 (same unit as the inputs), gain }: gain = kappa / (1 - c) corrects
the linearised shift for a profile that is not Gaussian: kappa is the profile's area over the fitted Gaussian's, and c
= <r0, d2m/dmu2> / <dm/dmu, dm/dmu> the curvature term of the Gauss-Newton Hessian left by the residual r0 of the
out-of-transit fit (both 1 and 0 for a Gaussian profile).

ccfWidth ​

js
const ccfWidth

Dispersion beta_0 of the best-fitting Gaussian (ccfFit).

ccfWidthTable ​

js
function ccfWidthTable(ld, rMax = 30, n = 121)
text
ccfFit tabulated against v sin i / beta_p for one limb darkening (interpolated linearly): (vsini, betaP) -> { beta0, gain }.

rmAnomalyCCF ​

js
function rmAnomalyCCF(X, Y, p, ld, vsini, lambda, o)
text
Anomaly a Gaussian fit to the CCF measures, planet at (X, Y): as rmAnomaly with o = { betaP, beta0, gain (default 1) }
(velocities in the unit of vsini).

makeRM ​

js
function makeRM(p)
text
Compile one planet's anomaly as a function of time: p = { rprs, per, tmid, ars, inc, ecc, omega, vsini [km/s],
lambda [deg], ldLaw, ld } (or claret: [a1..a4] in place of ldLaw, ld). Returns rv(t) in m/s.
p.method = 'ccf' gives what a Gaussian fit to the CCF measures, with p.beta (km/s: the local line's dispersion,
instrumental and thermal), p.zeta (km/s, macroturbulence, optional) and p.beta0 (km/s, the out-of-transit CCF
dispersion; computed from the model when absent, through p.widthTable = ccfWidthTable(ld) if given).
p.exptime [d] with p.supersample (default 5): the anomaly averaged over each exposure.

vsiniPrior ​

js
function vsiniPrior(star)

Prior on v sin i from a catalogue value: normal truncated at 0 (and at +10 sigma), in the form of fit.free priors. star: { vsini, vsiniErr } in km/s.

trueObliquity ​

js
function trueObliquity(lambda, inc, istar)
text
True (3-D) obliquity psi [deg] from the sky-projected lambda, the orbit's inclination and the star's i* (all degrees):
cos psi = cos i* cos i + sin i* sin i cos lambda (Fabrycky & Winn 2009).

MIT licensed · Kyle A. Pearson