A Christmas Star (Minus the Star, Plus a Moon Nobody Asked For)
Abstract
A browser-based simulator for exoplanet transit photometry, binary eclipses, and exomoon scenarios — with Keplerian and N-body paths, limb-darkening models, and timing diagnostics. It is an educational simulator, not a validated research pipeline. I spent Christmas on this. You’re welcome, science.
Contents
Astronomy literature and calculations checked through 2026-10-24. The
software description was last checked on 2026-07-11: a same-day retry found no
remote dev branch, and the default main branch was cloned at commit
fc6f27c5aead33fd01a8c2f24be507b7e2b2b176. Claims below describe that
documented interface, not an archived Christmas 2025 binary or an executed
deployment.
Summary
‘Tis the season to stare at light curves. While most people were unwrapping presents on December 25th, I was staring at synthetic flux drop-offs and debugging a limb-darkening model. The result is a browser-based simulator for exoplanet transit photometry, including binary eclipses and exomoon scenarios. It does not detect any real exomoons. It does, however, correctly model why detecting them is comically hard.
Source: sebastianspicker/exoplanet-exomoon-simulation
Why Exomoons Hide in Light Curves
The gift of transits
When a planet crosses in front of its host star, it hides part of the stellar disc. If the disc is uniformly bright and the planet lies wholly inside it, the observed flux drops by exactly the ratio of their projected areas:
\[ \delta = \left(\frac{R_p}{R_\star}\right)^2 = k^2 \]where $R_p$ and $R_\star$ are the radii of planet and star and $k$ is their ratio. With the IAU nominal equatorial radii [[1]], Jupiter transiting the Sun gives $\delta = 1.06\%$ and Earth 84 ppm. For an exomoon orbiting a Jupiter-sized planet — well, unwrap that calculation yourself:
\[ \delta_m = \left(\frac{R_m}{R_\star}\right)^2 \]A Moon-radius exomoon (mean radius 1,737.4 km [[2]]) around a Sun-radius star gives about 6.2 ppm in this uniform-disc calculation. Kepler was designed for 20 ppm combined differential photometric precision (CDPP) over 6.5 hours for a 12th-magnitude solar-type star [[3]]; for 12th-magnitude dwarfs it achieved about 30 ppm, with the stars’ own variability the largest contributor to the excess [[4]]. Actual precision depends on target brightness, variability, cadence, and data treatment. Ho ho hold on — the single-event scale is below that benchmark.
How far below? CDPP is defined so that a 6.5-hour transit of depth $\delta$ is detected at $\delta/\mathrm{CDPP}$ standard deviations [[5]]. If the noise is white, a longer transit and repeated transits gain signal faster than noise:
$$ \mathrm{S/N} \approx \frac{\delta}{\sigma_{6.5}} \sqrt{\frac{N\,T}{6.5\ \mathrm{h}}} \tag{1} $$where $\sigma_{6.5}$ is the 6.5-hour CDPP, $T$ the transit duration and $N$ the number of transits stacked. A central transit across the Sun, seen from 1 au, lasts 13.1 hours. At the design precision a single transit of Earth then gives S/N ≈ 6. The Moon, crossing alongside it, gives 0.44 and needs about 260 transits to reach the $7.1\sigma$ threshold of Kepler’s planet search [[5]] (Fig. 1). At one transit a year that is about 260 years, against a 3.5-year baseline mission [[3]]. Eq. (1) is the optimistic case. It assumes white noise and a moon whose dips line up from one transit to the next, which its orbit around the planet largely prevents.
Why stars are not uniformly bright (and why that ruins everything)
A star is not a flat disc of uniform intensity. It is darker at the limb than at the centre — an effect called limb darkening — because a line of sight near the limb crosses the atmosphere obliquely and reaches optical depth one higher up, in cooler, less emissive layers. The quadratic limb-darkening law is:
\[ I(\mu) = I_0 \left[1 - u_1(1 - \mu) - u_2(1 - \mu)^2\right] \]where $I_0$ is the intensity at disc centre; $\mu = \cos\theta = \sqrt{1 - r^2}$, with $\theta$ the angle between the line of sight and the local surface normal and $r$ the projected distance from disc centre in stellar radii; and $u_1, u_2$ are coefficients that depend on the star and the passband. For a Sun-like star in the V band, Claret’s tables give $u_1 = 0.437$ and $u_2 = 0.295$ (least-squares fit to an ATLAS model atmosphere with 5,750 K, $\log g = 4.5$, solar metallicity and 2 km/s microturbulence) [[6]]. This matters for transit modelling because the depth of the light curve dip changes as the planet traverses from limb to centre to limb — the transit is not a flat-bottomed box, it is a rounded trough. With these coefficients Jupiter crossing the Sun’s centre would dim it by 1.31%, not 1.06%. Mandel and Agol give such light curves in closed form [[7]].
Fitting the trough incorrectly biases $R_p/R_\star$ and, more critically for exomoon searches, leaves residuals that look suspiciously like extra dips. The best flat-bottomed model of that Jupiter transit makes $k$ 9% too large and still misses by up to 1,300 ppm, about 200 times the depth of a Moon-sized moon (Fig. 2). The right law with $u_1$ raised by 0.1, fitted with radius ratio, impact parameter and speed free as before, still leaves residuals of up to 350 ppm.
Exomoon detection: the indirect approach
No exomoon had been unambiguously confirmed by September 2026 [[8]]. Two indirect signatures are:
Transit Timing Variations (TTV). Planet and moon orbit their common barycentre. The planet’s transit therefore arrives slightly early or late relative to a pure Keplerian ephemeris, by the planet’s offset from the barycentre along its path divided by the barycentre’s speed across the star.
Transit Duration Variations (TDV). The same barycentre wobble modulates the planet’s sky-projected velocity at transit, changing transit duration. The two signals are in quadrature: the timing offset peaks when the planet is farthest from the barycentre along its path, the duration change a quarter of a moon orbit later, when the planet moves fastest relative to it [[9]].
From Kipping’s root-mean-square expressions, the peak amplitudes for circular, coplanar orbits seen edge-on are [[9]], [[10]]:
$$ \Delta t_\mathrm{TTV} = \frac{a_W}{v_B}, \qquad \Delta t_\mathrm{TDV} = \frac{2\pi\bar\tau}{P_m}\,\Delta t_\mathrm{TTV}, \qquad a_W = \frac{m_m}{m_p + m_m}\,a_m $$where $a_W$ is the planet’s distance from the barycentre, $a_m$ the planet–moon separation, $m_p$ and $m_m$ the masses of planet and moon, $v_B$ the barycentre’s speed across the star, $\bar\tau$ the mean transit duration and $P_m$ the moon’s orbital period. Seen edge-on from far away, Earth sits 4,671 km from the Earth–Moon barycentre, which moves at 29.8 km/s [[2]]: Earth’s transits would come up to 157 s early or late, and their 13.1-hour duration would vary by up to 20 s.
TTV alone fixes only the product $m_m a_m$, and a stable moon circles its planet faster than transits can sample it (the Moon 13.4 times a year), so its period cannot be read from the timing series. TDV scales as $m_m a_m^{-1/2}$; the ratio of the two gives $P_m$ and, with the planet’s mass, $a_m$ and $m_m$ separately [[9]]. An inclined moon orbit adds a second TDV component [[10]].
Neither signal is clean in practice. Stellar activity, instrument systematics, and other planets in the system all contribute correlated noise at similar timescales. Kepler-1625 b-i, one of the two most discussed candidates, rests largely on timing deviations and a moon-like dip in one Hubble transit [[11]]. A reanalysis traces the evidence almost entirely to the shallowness of that transit and calls it “a fitting artifact in which a moon transit is used to compensate for the unconstrained stellar limb darkening” [[12]], the problem Fig. 2 illustrates. The original authors reply that those fits “appear to have somehow missed this deeper likelihood maximum” and that the candidate remains viable but needs further observations [[13]]. Season’s readings: disputed.
The Simulation
What it actually does
The simulator is a TypeScript application (Vite build, runs in-browser) built around a deterministic, SI-unit physics core. The main pipeline:
UI parameters
→ V4 normalisation
→ runtime creation (realtime | reference)
→ orbital integrator (Kepler + N-body)
→ geometry & photometry
→ flux decomposition
→ canvas render + plots
Two runtime modes:
- Realtime — fast integrator, interactive rendering, good for exploration
- Reference — deterministic in-thread supersampling, intended for more reproducible comparisons at greater computational cost
The photometry layer computes quadratic limb-darkened transit flux, handles binary eclipse geometry (for eclipsing binary configurations), and exposes hooks for phase curves and instrument noise.
The diagnostics layer is the part I find most useful: energy conservation checks across the integration, radial velocity time series, astrometry, and transit timing outputs. An energy plot can reveal some numerical drift; a flat plot is not a complete accuracy validation.
The current repository documents a versioned real-systems.snapshot.json from
the NASA Exoplanet Archive, including freshness metadata. A snapshot is dated
input data, not a live archive query or a guarantee that every parameter is
current.
What it deliberately does not do
The relativistic corrections are approximations. This is not a GR integrator, and the importance of relativistic precession depends on mass, semi-major axis, and eccentricity; short-period systems cannot be dismissed by comparison with Mercury alone. Do not use this path for compact objects or precision dynamical inference.
The atmospheric module exposes hooks but is not a radiative-transfer solver. If you want realistic transmission spectra, point yourself at something like petitRADTRANS [[14]] and use this for the orbital geometry only.
A Residuals-Hunting Problem
The simulation is educational in intent — hence the built-in didactic mode (black-box exploration → hypothesis → reveal → A/B comparison → rubric scoring). The documented implementation includes quadratic limb darkening, multi-body gravitational integration, and timing diagnostics. Those features make the model more instructive; their presence does not by itself establish numerical accuracy across the parameter space.
The thing I kept running into while building this is how much of exomoon detection reduces to a residuals-hunting problem. You fit the best planet-only model you can, examine the timing and duration residuals, and look for a coherent signal. The simulator documents synthetic planet–moon scenarios and configurable noise, letting you inspect residuals — the kind of intuition-building exercise that is tedious to set up from scratch with, say, a raw batman light-curve model [[15]] and a custom integrator.
Limitations worth being honest about. The performance budget is real: some effects are profile-gated to keep the interactive mode responsive, which means the reference mode exists for more expensive deterministic comparisons, not “the full physics.” For a publication-quality simulation you would want a dedicated N-body code (REBOUND [[16]] is the obvious choice), not a browser runtime. This is a tool for understanding the problem, not for writing papers about it — which, fitting for a Christmas project, is exactly what I have time for right now.
Merry Christmas. If you came here expecting warmth and cheer, I offer instead a synthetic light curve with a 6.2 ppm exomoon signal below a 20 ppm design benchmark over 6.5 hours. Practically the same thing.
For the physical version of this — a lamp, a ball, and a smartphone measuring real transit light curves in a classroom — see Hunting Exoplanets with Your Phone; its exomoon counterpart, a moon sphere on a disco-ball motor, is Can a Planet Have a Moon?. For context on where those experiments came from, see The Lab Goes Home.
References
[1] Prša, A., Harmanec, P., Torres, G., et al. (2016). Nominal values for selected solar and planetary quantities: IAU 2015 Resolution B3. The Astronomical Journal, 152(2), 41. DOI: 10.3847/0004-6256/152/2/41
[2] Williams, D. R. Moon Fact Sheet; Earth Fact Sheet. NASA Space Science Data Coordinated Archive. Opened 24 October 2026. https://nssdc.gsfc.nasa.gov/planetary/factsheet/moonfact.html; https://nssdc.gsfc.nasa.gov/planetary/factsheet/earthfact.html
[3] Koch, D. G., Borucki, W. J., Basri, G., et al. (2010). Kepler mission design, realized photometric performance, and early science. The Astrophysical Journal, 713(2), L79–L86. DOI: 10.1088/2041-8205/713/2/L79
[4] Gilliland, R. L., Chaplin, W. J., Dunham, E. W., et al. (2011). Kepler mission stellar and instrument noise properties. The Astrophysical Journal Supplement Series, 197(1), 6. DOI: 10.1088/0067-0049/197/1/6
[5] Jenkins, J. M. (Ed.). (2017). Kepler Data Processing Handbook (KSCI-19081-002), in particular chapter 9, “Transiting Planet Search”. NASA Ames Research Center. https://archive.stsci.edu/files/live/sites/mast/files/home/missions-and-data/kepler/_documents/KSCI-19081-002-KDPH.pdf
[6] Claret, A. (2000). A new non-linear limb-darkening law for LTE stellar
atmosphere models. Astronomy & Astrophysics, 363, 1081–1190. Coefficient
tables: VizieR catalogue J/A+A/363/1081; the values used here are the
least-squares quadratic fits for ATLAS models (file atlasco.dat, Johnson V,
microturbulence 2 km/s).
https://cdsarc.cds.unistra.fr/viz-bin/cat/J/A+A/363/1081
[7] Mandel, K., & Agol, E. (2002). Analytic light curves for planetary transit searches. The Astrophysical Journal, 580(2), L171–L175. DOI: 10.1086/345520
[8] Pérez-Rodrigo, A., & Rebollido, I. (2026). That’s no moon: Exomoon survival and detection limitations. Astronomy & Astrophysics, 714, A299. DOI: 10.1051/0004-6361/202661276. Preprint: arXiv:2609.07320.
[9] Kipping, D. M. (2009a). Transit timing effects due to an exomoon. Monthly Notices of the Royal Astronomical Society, 392(1), 181–189. DOI: 10.1111/j.1365-2966.2008.13999.x
[10] Kipping, D. M. (2009b). Transit timing effects due to an exomoon – II. Monthly Notices of the Royal Astronomical Society, 396(3), 1797–1804. DOI: 10.1111/j.1365-2966.2009.14869.x
[11] Teachey, A., & Kipping, D. M. (2018). Evidence for a large exomoon orbiting Kepler-1625b. Science Advances, 4(10), eaav1784. DOI: 10.1126/sciadv.aav1784
[12] Heller, R., & Hippke, M. (2024). Large exomoons unlikely around Kepler-1625 b and Kepler-1708 b. Nature Astronomy, 8(2), 193–206. DOI: 10.1038/s41550-023-02148-w
[13] Kipping, D., Teachey, A., Yahalomi, D. A., Cassese, B., et al. (2025). Concerning the possible exomoons around Kepler-1625 b and Kepler-1708 b. Nature Astronomy, 9(6), 795–798. DOI: 10.1038/s41550-025-02547-1. The wording used here is from the preprint’s abstract, “A Reply to: Large exomoons unlikely around Kepler-1625 b and Kepler-1708 b”, arXiv:2401.10333.
[14] Mollière, P., Wardenier, J. P., van Boekel, R., Henning, Th., Molaverdikhani, K., & Snellen, I. A. G. (2019). petitRADTRANS: A Python radiative transfer package for exoplanet characterization and retrieval. Astronomy & Astrophysics, 627, A67. DOI: 10.1051/0004-6361/201935470
[15] Kreidberg, L. (2015). batman: BAsic Transit Model cAlculatioN in Python. Publications of the Astronomical Society of the Pacific, 127(957), 1161–1165. DOI: 10.1086/683602
[16] Rein, H., & Liu, S.-F. (2012). REBOUND: An open-source multi-purpose N-body code for collisional dynamics. Astronomy & Astrophysics, 537, A128. DOI: 10.1051/0004-6361/201118085
Changelog
- 2026-03-05: Corrected the description of the limb-darkening variable from “$\mu = \cos\theta$ is the angle from disk centre” to “$\mu = \cos\theta$ is the cosine of the angle from disk centre.” $\theta$ is the angle; $\mu$ is its cosine.
- 2026-03-05: Corrected Claret (2000) page range from 1081–1090 to 1081–1190. The paper contains extensive tables of limb-darkening coefficients spanning 109 pages.
- 2026-07-11: Recalculated the Earth- and Moon-scale transit depths, bounded the Kepler precision and TTV/TDV approximations, reconciled the software description with current
maincommitfc6f27c5, and removed research-grade implications. The repository cloned successfully, but dependency installation remained execution-policy blocked. - 2026-10-03: Corrected the TDV mechanism: transit duration responds to the planet’s sky-projected (transverse) velocity, not its velocity along the line of sight.
- 2026-10-24: Corrected the depth from “proportional to” the area ratio to equal to it, for a uniform disc with the planet wholly inside, and Jupiter’s from about 1% to 1.06% (IAU equatorial radii). Defined $\theta$ as the angle between line of sight and surface normal. Replaced “the best exomoon candidate to date” with “one of the two most discussed candidates”, and the NASA ExoMoons page, which no longer states the candidates’ status, with Pérez-Rodrigo & Rebollido (2026). The 2026-03-05 entry’s 109 pages are 110, 1081–1190 inclusive. Added Kepler’s achieved precision, the signal-to-noise scaling, Eq. (1), and the transits a Moon-sized moon needs (Fig. 1); limb-darkening coefficients and the misfit of a flat-bottomed model (Fig. 2); Kipping’s TTV and TDV amplitudes with an Earth–Moon example; the reanalysis of Kepler-1625 b-i and the reply; and numbered references, including batman, REBOUND and petitRADTRANS.