Course contents · Method explanations
The grouped table of contents, chapter-oriented Markdown reading flow, and links between explanation and code are inspired by CSC207-UofT/207-course-notes, inspected for this documentation edition. AstroSimBench's physics prose, examples, and captions are written for this project. No CSC207 Java lesson text or repository assets are included, and no affiliation or endorsement is implied.
| Local method | Mathematical source | Relationship to this project |
|---|---|---|
| Euler / RK4 / Leapfrog | Standard numerical integration formulas retained from the existing project | Educational implementation, not a new algorithm claim |
| RK45 | Dormand & Prince (1980) | Published 5(4) tableau; local stage evaluation and controller integration |
| Hermite4 | Makino & Aarseth (1992) | Basic shared-step PEC equations; no Ahmad–Cohen neighbor or block-step scheme |
| BS | Bulirsch & Stoer (1966) | Modified midpoint and polynomial extrapolation in an educational implementation |
| GL4 | Hairer: symplectic integrators | Standard two-stage Gauss tableau, local finite-difference Newton solve |
| WH2 | Wisdom & Holman (1991) | Jacobi Hamiltonian splitting with the project's spatial Kepler subflow |
| WH4 | Yoshida (1990) | Published symmetric composition coefficients applied to WH2 |
| Universal Kepler propagation | Universal-variable / Stumpff f,g equations; background in Shepperd (1985) | Bracketed Newton and Stumpff evaluation; not a reproduction of Shepperd's continued-fraction or state-transition implementation |
| IAS15 | Rein & Spiegel, IAS15 paper | External production reference through REBOUND |
Algorithm formulas and theory remain attributable to their published sources. Implementing a published algorithm is not a claim to invent it. The preserved code's provenance states that third-party solver source was not copied into this package.
- REBOUND integrator documentation: external IAS15/BS usage and the distinction between production solvers and these teaching implementations.
- REBOUND gravity documentation: gravity-model context.
- REBOUND chaos indicators: background distinct from this course's empirical reference-window diagnostic.
- heyoka.py restricted three-body example: conceptual background for the circular restricted model.
- SciPy bootstrap documentation: background for resampling terminology. The experiment's paired-seed bootstrap is implemented with NumPy and does not call SciPy.
REBOUND remains an optional package dependency needed for the reference experiments; its source is not vendored here. The existing core test suite calls SciPy DOP853 as an additional validation where available. Saved settings record the actual reference version used (5.1.1 in the original runs, 5.2.2 in Part 4); the supported dependency range is declared in pyproject.toml.
Version 1.0.0 licenses the original code under MIT and the original teaching prose, project-generated figures and result collections under CC BY 4.0, where those rights apply. Dependencies retain their own terms, including REBOUND's GPL-3.0-only license. See Licensing and attribution for scope and combined-distribution considerations. Citation of an algorithm is separate from licensing its implementation.
- Wisdom (2006), Symplectic correctors for canonical heliocentric n-body maps, Appendix equations (24)–(30): published third-order ABA corrector coefficients. Part 4 expands those formulas into an original local implementation with a tested conjugacy to the existing BAB kernel. No REBOUND source code is vendored.
- Rein, Tamayo & Brown (2019), High order symplectic integrators for planetary dynamics: formal residual error terms and their regime dependence.
- REBOUND WHFast documentation: external Jacobi corrector-0/3 controls with synchronized output copies. Tested here with REBOUND 5.2.2. External counters unavailable through this adapter are not entered as zero work.
- Wisdom (2015), Resolving the Pericenter: motivation for testing the local resolution of perturbed eccentric motion. Its empirical step counts are not universal acceptance conditions.
- Rein et al. (2019), MERCURIUS, and the official adapter settings: external hybrid candidate, with no local changeover implementation.
- Lu, Hernandez & Rein (2024), TRACE, and the official settings: external almost time-reversible encounter candidate. No paper or REBOUND source code is vendored.
- Naoz (2016), The Eccentric Kozai-Lidov Effect and Its Applications: background for the near-circular test-particle quadrupole e_max formula and its assumptions. The formula is a limiting theory comparison, not an exact direct-system reference.
- Luo, Katz & Dong (2016), Double-Averaging Can Fail to Characterize the Long-Term Evolution of Lidov-Kozai Cycles & Derivation of an Analytical Correction: short-period corrections and limits of double averaging for strong companions. The local centered sampled-signal average does not implement that paper's corrected equations.
- Lu, Hernandez & Rein (2024), TRACE: context for comparing encounter-oriented hybrids with Jacobi methods in ZLK systems. Our 4E comparison uses its own physical setup, targets and finite settings; it does not reproduce a paper figure.
The bundled Part 4 references and external candidates were run with REBOUND 5.2.2. Verification explains the independent BS and output-sampling checks, including the limits of full-trajectory agreement in the 120-degree case. New compatible environments record their own versions and empirical reference floors.
The official MERCURIUS settings describe multiple critical-distance criteria and a pair changeover based on the larger critical distance. The official TRACE settings describe a modified Hill scale using heliocentric distance, together with a separate pericenter condition. Our new Hill-normalized columns are explicitly geometric context, not solver telemetry or a count of internal switches.
Wisdom (2015), Figures 1–4 and the conclusion, supplies a reported empirical scale, not data points for our state-error plot. The lesson converts the period convention explicitly. Kaib, Quinn & Brasser (2011), AJ 141, 3, preprint Section 1, discusses corrector error scaling and timestep/partition changes. No figures from either paper are reproduced.