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 ccfWidthDispersion 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).