Worked examples
Open any of these from Analyze → Start, or with api.loadExample(id) (Browser API) or load_example (MCP tools). Each opens with a stored posterior (press Run to sample it again) and a card saying what to look at. Examples marked simulated use generated data; the others are real observations, with their source and licence below.
Single transit (simulated)
single · transit · HAT-P-32 b · a simulated ground-based night with an airmass trend
One night of a hot Jupiter crossing its star, as a small telescope records it: the dip is the planet blocking a disc that is darker at its edge, the slow slope is the atmosphere thickening as the star sets.
Data. Simulated by this code (EXOTIC example single_transit: a ground-based night with an airmass trend).
Licence. Generated here; no third-party data.
Checked. EXOTIC’s posterior on the same simulated data is reproduced within the limits shown (node test/exotic.test.mjs).
TESS transit of HD 80606 b
hd80606-tess · transit · the 12-hour transit of a planet on an e = 0.93 orbit
TESS watching HD 80606 b, a planet on one of the most eccentric orbits known (e ≈ 0.93): it races past the star in days and spends months far away.
Data. TESS 2-minute light curve of the February 2020 transit, the file of EXOTIC’s examples/joint_rv_transit (public/examples/hd80606/2458888_08_lightcurve.csv).
Licence. No licence stated in this repository for the file. TESS data are public (MAST); the reduced light curve is from the EXOTIC repository.
Checked. partly: the mid-time agrees; the inclination is 0.03° from the published value, 3.6 times this fit’s formal uncertainty (a/R★ is held fixed); the radius ratio is NOT reproduced (dilution) (.venv/bin/python tools/build_example_results.py # or open the example in the analyzer and press Run).
Several transits, one fit (simulated)
multi · transit · HAT-P-32 b · five simulated nights, each with its own airmass trend; the period is free
Five nights of the same planet. Each night has its own baseline and airmass trend; the planet is shared, so the period is measured from the spacing of the transits.
Data. Simulated by this code (EXOTIC example multiple_transit: five nights, each with its own airmass trend; the period is free).
Licence. Generated here; no third-party data.
Checked. EXOTIC’s posterior on the same simulated data is reproduced within the limits shown (node test/exotic.test.mjs).
Radial velocities of HD 80606 b
hd80606-rv · rv · 264 velocities from seven instruments over 20 years
Radial velocities from seven instruments: the star's motion towards and away from us as the planet tugs it. The sharp swing is periastron.
Data. 264 radial velocities (ELODIE, HIRES, HRS, SOPHIE, APF) as compiled in EXOTIC’s examples/radial_velocity (public/examples/hd80606/HD80606_RV.csv).
Licence. No licence stated in this repository; the measurements are from the publications compiled by Pearson et al. 2022.
Checked. reproduced within the test’s limits (K within 5 m/s, e within 0.002, ω within 0.5°, P within 0.002 d); formal errors are too small because χ² = 1555 for 264 points without jitter (node test/exotic.test.mjs).
HD 80606 b: transit + velocities + timing
hd80606-joint · transit, rv, ephemeris · the joint analysis of Pearson et al. (2022)
Transit, velocities and mid-times together: one orbit has to explain all three. a/R★ comes from Kepler's law with the star's mass and radius.
Data. The TESS light curve and velocities above, four mid-transit times and one mid-eclipse time (sources named in each row of the session file).
Licence. As the two rows above.
Checked. orbit and mass agree within the test’s limits (P within 5e-4 d, i within 0.03°, e within 0.001, K within 3 m/s), though several differ from the published values by 1.5 to 2 times this fit’s formal uncertainties, which are too small (χ² = 1675 for 1168 measurements; the star is held fixed). The transit duration of this fit and the eclipse duration are NOT reproduced (node test/exotic.test.mjs && node test/validation.test.mjs).
HD 80606 b: the Rossiter–McLaughlin effect
hd80606-rm · rv · two partial transits in the velocities (SOPHIE 2009 February, HIRES 2009 June) give the projected obliquity λ
During a transit the planet blocks part of a rotating star: first the side turning towards us, then the side turning away, so the star's measured velocity shifts — the Rossiter–McLaughlin effect. The 3D star is coloured by its fitted rotation: blue where it comes towards us, red where it goes away, tilted by the fitted λ.
Data. The 264 velocities above and the five mid-times; the two partial transits in the file, SOPHIE 2009 February 14 (Moutou et al. 2009) and HIRES 2009 June 5 (Winn et al. 2009), are datasets of their own with free jitters (public/examples/hd80606/README.md). Rp/R★ held at 0.1001 (Winn et al. 2009) because the TESS radius is diluted by HD 80607; the anomaly uses quadratic limb darkening of the 390–690 nm band (the session’s rm block); no light curve in the fit.
Licence. As the rows above.
Checked. λ and v sin i★ agree (about 1σ and 0.6σ) from two partial transits; the same data with the orbit fixed give 1.47 km/s and 58° (test/hd80606rm.test.mjs). The model is the first moment of the uncovered light (a CCF form exists, not used here), without exposure averaging (node test/examples_real.test.mjs && node test/hd80606rm.test.mjs).
TOI-1873: two planets and a candidate, TESS + NEID
toi1873 · transit, rv · real data: 50 TESS transits in 13 sectors and 37 NEID velocities; masses from the velocities
TOI-1873: three planets of one star in real TESS light curves and NEID velocities. Each planet has its own transit; the velocities carry the sum of their pulls. The outer planet was seen in only three transits, so its period is one of a few aliases.
Data. TESS SPOC light curves of 13 sectors as extracted and detrended in EXOTIC’s examples/toi-3planet, windows around every transit of b, c and d binned to 10 min (2876 points, 53 epochs); 37 NEID velocities of the published pyaneti analysis (public/examples/toi1873/README.md).
Licence. TESS data are public (MAST). The NEID velocities and the pyaneti results were shared with the owner by collaborators; no licence is stated and they may be unpublished: decide before the repository goes public.
Checked. ephemerides, inclinations and both masses agree with the published two-planet fit within 0.6σ (c’s mass 0.03σ, b’s −0.4σ); the radius ratios differ by −1.5σ (b) and +1.6σ (c). Planet d: N = 7 (128.6 d) holds 85% of the posterior, 900 d 0%; its mass is 13 +8 −7 M⊕. The run stopped at its budget of 1.5 million calls with 2.6% of the evidence possibly left (NOT converged): read ln Z as a lower limit (node test/examples_real.test.mjs # ESL_FULL=1 reruns the sampler (about 2 hours)).
Three planets, synthetic (toy-1873)
toy1873 · transit, rv · simulated by EXOTIC, modelled on TOI-1873; the outer planet’s velocity signal is below the jitter
TOI-1873: three planets of one star in real TESS light curves and NEID velocities. Each planet has its own transit; the velocities carry the sum of their pulls. The outer planet was seen in only three transits, so its period is one of a few aliases.
Data. Synthetic system of EXOTIC’s examples/multi_planet (modelled on TOI-1873; the real data are the row above): three light-curve files and 40 velocities with injected truth.
Licence. Synthetic; from the EXOTIC repository.
Checked. reproduced (identical χ² at the injected values) (node test/exotic.test.mjs && node test/session.test.mjs).
WASP-43 b: full-orbit phase curve
phasecurve · transit · Spitzer 4.5 µm, one orbit: transit, two eclipses and the day-night cycle
A whole orbit of WASP-43 b at 4.5 µm: the planet's own light rises towards the eclipse as its hot dayside turns to us, and drops when the planet passes behind the star.
Data. One Spitzer IRAC channel 2 visit (BJD 2458738.3 to 2458739.4), already detrended, from github.com/pearsonkyle/Exoplanet-Mapping (commit 3af871c); binned to 120 s here.
Licence. That repository has no licence file; it is the site owner’s repository and its README asks for its white paper to be cited (public/examples/phasecurve/README.md). Spitzer data are public (IRSA).
Checked. reproduces the source repository’s own fit; the light curve was detrended jointly with that fit, so this is not an independent check, and no value from a journal article is compared (node test/make_phasecurve_examples.mjs <Exoplanet-Mapping checkout> && node test/phasemodel.test.mjs).
WASP-43 b: eclipse map
eclipsemap · transit · Spitzer 4.5 µm: a phase curve, four more eclipses and two transits; map of degree 1
Eclipses of WASP-43 b: as the star covers the planet, the light lost at each moment comes from a different strip of its disc, which maps the brightness across the dayside.
Data. The visit above plus windows around four more eclipses and two transits from two other Spitzer visits (same repository).
Licence. As the row above.
Checked. no published value to compare; internal check only (χ² through the likelihood equals the model used directly) (node test/phasemodel.test.mjs).
Eclipse map at JWST precision (simulated)
eclipsemap-sim · transit · simulated: three eclipses and a transit of a WASP-18 b-like planet; map of degree 2
A simulated degree-2 map recovered from three eclipses and a transit.
Data. Simulated by this code: three eclipses and a transit, 60 ppm per 60 s, seed 20261115; orbit of WASP-18 b.
Licence. Generated here; no third-party data.
Checked. injected values recovered within the posterior (a self-consistency test: the data were made with this model) (node test/make_phasecurve_examples.mjs <Exoplanet-Mapping checkout>).
A planet with a moon (simulated)
exomoon · transit · simulated: a Jupiter at 45 d with a 2.2 Earth-radius moon, twelve transits
Twelve transits of a planet with a moon: the planet wobbles around the shared centre of mass, so its transits come early or late, and the moon adds its own small dip.
Data. Simulated by this code (public/examples/exomoon/make_example.mjs, seed 20261115): a Jupiter-size planet at 45 d with a moon, 250 ppm.
Licence. Generated here; no third-party data.
Checked. injected values recovered (self-consistency; no real exomoon exists to reproduce) (node public/examples/exomoon/make_example.mjs && node test/exomoon.test.mjs).
Orbital decay of WASP-12 b
decay · ephemeris · 457 mid-transit times over 15 years: is the period changing?
Fifteen years of mid-transit times of WASP-12 b. A constant period would make them fall on a straight line; they curve.
TOI-1873: ephemerides, O − C and periodogram
toi1873-oc · ephemeris · real data: 50 TESS mid-transit times of three planets; is anything periodic in the residuals?
Only the transit times of TOI-1873's planets: each time minus a straight-line prediction (O − C) shows whether the planet keeps perfect time.
Data. The mid-transit times of EXOTIC’s per-transit fits of the TESS light curves (examples/toi-3planet, toi1873_transit_fits.json): 39 of b, 8 of c, 3 of d (public/examples/toi1873/transit_times.csv).
Licence. TESS data are public (MAST); the times are EXOTIC’s measurements, no licence stated.
Checked. the periods equal EXOTIC’s on the same times (0.00σ and 0.01σ; b is 1.6σ from pyaneti’s, c 0.4σ). No periodicity in the O − C: strongest peaks at false-alarm probabilities of 25% (b) and 80% (c), as EXOTIC also finds (node test/examples_real.test.mjs).
Kepler-88: weighing a hidden planet by transit timing (real data)
kepler88 · ephemeris · real data: 119 Kepler mid-transit times of b swing by ±10 hours; an N-body fit gives the mass of the non-transiting planet c
Kepler-88 b's transits arrive up to half a day early or late, in a slow 630-day cycle. Nothing else transits: the tug comes from a hidden planet, c, near the 2:1 resonance, and an N-body fit of b's times alone weighs it.
Data. 119 mid-transit times of Kepler-88 b (two flagged outliers left out) from the Kepler TTV catalogue of Holczer et al. 2016 (ApJS 225, 9; VizieR J/ApJS/225/9, table3, rows of KOI-142.01; public/examples/kepler88/README.md). N-body model, b’s T0 and P profiled, c at i = 87°, both eccentricity vectors free; 8.66 min of timing noise added in quadrature (the catalogue errors, given to one figure, are too small for this model).
Licence. VizieR catalogue data (CDS terms, https://cds.unistra.fr/vizier-org/licences_vizier.html); Kepler data are public (MAST).
Checked. c’s mass, 0.671 ± 0.006 M Jup from b’s timing alone, agrees with Weiss et al. 2020 (−0.2σ) and Nesvorný et al. 2013 (+1.4σ); its osculating period is 22.3349 ± 0.0007 d against Nesvorný’s osculating 22.3395 (−2.4σ; Weiss’s 22.265 is defined differently and not comparable); both eccentricities (0.0558, 0.0572) match the published 0.0559 and 0.0563 to 0.0572. The uncertainties rest on the 8.66 min of timing noise added to the catalogue errors (node public/examples/kepler88/make_example.mjs && node tools/build_example_results_node.mjs kepler88 && node test/examples_real.test.mjs).
Masses from timing alone (simulated)
ttvpair · ephemeris · simulated: two transiting planets near the 2:1 resonance; the N-body fit of their times gives both masses without velocities
Two transiting planets near a resonance pull on each other, so both drift early and late in opposite senses. The size of each drift weighs the other planet — no velocities needed.
Data. Simulated with this project’s IAS15 integrator (public/examples/ttvpair/make_example.mjs, seed 20261116): every transit of two warm Saturns over 1460 d, 113 times.
Licence. Generated here; no third-party data.
Checked. both injected masses recovered (−0.3σ and +0.1σ) with circular orbits held; no velocities in the fit (node public/examples/ttvpair/make_example.mjs && node test/examples_real.test.mjs).
Timing variations from an unseen companion (simulated)
nbody · ephemeris · simulated: 72 mid-transit times of a hot Jupiter pulled by a 0.1 M Jup planet near the 2:1 resonance
A hot Jupiter with an unseen companion near the 2:1 resonance: their mutual pulls make the transits drift early and late in a slow cycle.
Data. Simulated with this project’s IAS15 integrator (public/examples/nbody/make_example.mjs).
Licence. Generated here; no third-party data.
Checked. injected mass recovered; the transiting planet’s T0 and P are profiled, not sampled (node public/examples/nbody/make_example.mjs && node test/nbody.test.mjs && node test/nbodymodel.test.mjs).
Ephemeris from 40 mid-transit times (simulated)
ephemeris · ephemeris · an exercise list from EXOTIC’s sample data; O − C diagram
Forty mid-transit times. Fitting a straight line through them (time against epoch) gives the period and a reference time to predict the next transits.