Skip to content

src/core/derive.js ​

Derived system parameters, following the rows of Table 7 in Pearson et al. (2022, arXiv:2208.14520) plus a few extras. Pure functions of the model parameters and the stellar inputs, so they can be evaluated per posterior draw.

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

C ​

js
const C
text
Constants: the nominal values of IAU 2015 Resolution B3 (Prsa et al. 2016, AJ 152, 41) for the Sun, Earth and
Jupiter (R_sun, T_eff,sun, equatorial R_earth and R_jup, GM ratios), the IAU 2012 astronomical unit, CODATA 2018 G.
GMsun is the DE value 1.32712440018e20 (the nominal one is rounded to 1.3271244e20: 1.4e-10 apart). Radii in "R_jup"
and "R_earth" are equatorial ones throughout (the volumetric mean radius of Jupiter is 2.2% smaller, of Earth 0.1%).
Msun = GMsun / G is only used for densities, where G cancels against the G in Kepler's law to 1e-5.

deriveSystem ​

js
function deriveSystem(v, star)
text
v: model parameters {rprs, ars, inc, per, tmid, ecc, omega}
star: {rstar [Rsun], mstar [Msun], teff [K], mplanet [Mjup] or null, jmag, kmag (2MASS, optional)}

Besides the rows of the paper's table:
  insolAvg     orbit-averaged insolation, insol / sqrt(1 - e^2) (the mean of 1/r^2 over time)
  teqPeri, teqApo   the same zero-albedo, full-redistribution temperature at periastron and apastron distance
  lttEclipse   seconds by which light-travel time delays mid-eclipse against the conjunction time `emid`
               (r_transit + r_eclipse) sin i / c: 2a/c for a circular orbit
  gp, loggp    surface gravity of the planet [m/s^2, log10 cgs] from its mass and radius. gpRV is the same from
               observables alone, 2 pi sqrt(1 - e^2) K / (P (Rp/a)^2 sin i) (Southworth et al. 2007), no stellar mass or radius
  hillAU, hillRp    Hill radius at periastron, a (1 - e) (Mp / 3 M*)^(1/3), in au and in planet radii
  rocheAU, rocheRatio   fluid Roche limit of the planet about its star, 2.44 R* (rho_star / rho_planet)^(1/3), and
               periastron distance over it (below 1 the planet would be losing mass); rho_star from M* and R*
  tsm, esm     transmission and emission spectroscopy metrics of Kempton et al. (2018, PASP 130, 114401), eqs. 1 and 4,
               with their T_eq (zero albedo, full redistribution) and T_day = 1.1 T_eq; tsm needs the mass, a radius
               under 10 R_earth and star.jmag; esm needs star.kmag. Outside 10 R_earth tsm uses the last scale factor
               and `tsmExtrapolated` is true.

planetClass ​

js
function planetClass(rpEarth, teq)

Size class used to pick the planet's appearance.

summarizeEpoch ​

js
function summarizeEpoch(a, key, tmid, per, weights = null)

Posterior summary of an epoch that repeats every period (mid-eclipse emid, periastron tperi), taken about the circular mean with that period, so a posterior across the branch point is one peak. Reported with the same convention as kepler.js eventTimes: the eclipse nearest the transit (after it when more than 0.4 P away) and the periastron before it; tmid and P are the posterior medians.

  • returns { med, plus, minus } like summarizeDraws, or null

summarizeDraws ​

js
function summarizeDraws(a, opts = {})

No description in the source.

MIT licensed · Kyle A. Pearson