REBOUNDx: A Library for Adding Conservative and Dissipative Forces to Otherwise Symplectic N-body Integrations
arXiv:1908.05634 · doi:10.1093/mnras/stz2870
Abstract
Symplectic methods, in particular the Wisdom-Holman map, have revolutionized our ability to model the long-term, conservative dynamics of planetary systems. However, many astrophysically important effects are dissipative. The consequences of incorporating such forces into otherwise symplectic schemes is not always clear. We show that moving to a general framework of non-commutative operators (dissipative or not) clarifies many of these questions, and that several important properties of symplectic schemes carry over to the general case. In particular, we show that explicit splitting schemes generically exploit symmetries in the applied external forces which often strongly suppress integration errors. Furthermore, we demonstrate that so-called `symplectic correctors' (which reduce energy errors by orders of magnitude at fixed computational cost) apply equally well to weakly dissipative systems and can thus be more generally thought of as `weak splitting correctors.' Finally, we show that previously advocated approaches of incorporating additional forces into symplectic methods work well for dissipative forces, but give qualitatively wrong answers for conservative but velocity-dependent forces like post-Newtonian corrections. We release REBOUNDx, an open-source C library for incorporating additional effects into REBOUND N-body integrations, together with a convenient Python wrapper. All effects are machine-independent and we provide a binary format that interfaces with the SimulationArchive class in REBOUND to enable the sharing and reproducibility of results. Users can add effects from a list of pre-implemented astrophysical forces, or contribute new ones.
arXiv commentSubmitted. Paper repository: https://github.com/dtamayo/reboundxpaper, Library Documentation: https://reboundx.readthedocs.io/en/latest/
References in corpus (31)
- REBOUND: An open-source multi-purpose N-body code for collisional dynamics
- IAS15: A fast, adaptive, high-order integrator for gravitational dynamics, accurate to machine precision over a billion orbits
- WHFast: A fast and unbiased implementation of a symplectic Wisdom-Holman integrator for long term gravitational simulations
- On the orbital evolution and growth of protoplanets embedded in a gaseous disc
- High order symplectic integrators for perturbed Hamiltonian systems
- The classical mechanics of non-conservative systems
- Resonant Post-Newtonian Eccentricity Excitation in Hierarchical Three-body Systems
- Dissipative Divergence of Resonant Orbits
- Overstable Librations can account for the Paucity of Mean Motion Resonances among Exoplanet Pairs
- Resonant Repulsion of Kepler Planet Pairs
- A class of symplectic integrators with adaptive timestep for separable Hamiltonian systems
- Hybrid Symplectic Integrators for Planetary Dynamics
- BRIDGE: A Direct-tree Hybrid N-body Algorithm for Fully Self-consistent Simulations of Star Clusters and their Parent Galaxies
- Long-term planetary integration with individual time steps
- New families of symplectic splitting methods for numerical integration in dynamical astronomy
- Dynamical Chaos in the Wisdom-Holman Integrator: Origins and Solutions
- The evolution of embedded star clusters
- A Mapping for the Gravitational Few-Body Problem with Dissipation
- K2-137 b: an Earth-sized planet in a 4.3-hour orbit around an M-dwarf
- High order symplectic integrators for planetary dynamics and their implementation in REBOUND
- A Fast and Accurate Universal Kepler Solver without Stumpff Series
- A study of symplectic integrators for planetary system problems: error analysis and comparisons
- The principle of stationary nonconservative action for classical mechanics and field theories
- Slimplectic Integrators: Variational Integrators for General Nonconservative Systems
- The Relativistic Factor in the Orbital Dynamics of Point Masses
- Time-symmetric integration in astrophysics
- Should -body integrators be symplectic everywhere in phase space?
- Computational astrophysics for the future: An open, modular approach with agreed standards would facilitate astrophysical discovery
- On the accuracy of symplectic integrators for secularly evolving planetary systems
- High order regularised symplectic integrator for collisional planetary systems
- Improving the accuracy of simulated chaotic -body orbits using smoothness
Cited by in corpus (131)
- exoplanet: Gradient-based probabilistic inference for exoplanet data & other astronomical time series
- Evidence for a high mutual inclination between the cold Jupiter and transiting super Earth orbiting Men
- TOI-1136 is a Young, Coplanar, Aligned Planetary System in a Pristine Resonant Chain
- Efficient planet formation by pebble accretion in ALMA rings
- The TESS-Keck Survey IV: A Retrograde, Polar Orbit for the Ultra-Low-Density, Hot Super-Neptune WASP-107b
- The Hills Mechanism and the Galactic Center S-stars
- Binary formation through gas-assisted capture and the implications for stellar, planetary and compact-object evolution
- The dynamics of the TRAPPIST-1 system in the context of its formation
- EXPRES I. HD~3651 an Ideal RV Benchmark
- Precise transit and radial-velocity characterization of a resonant pair: a warm Jupiter TOI-216c and eccentric warm Neptune TOI-216b
- TOI-1130: A photodynamical analysis of a hot Jupiter in resonance with an inner low-mass planet
- Where intermediate-mass black holes could hide in the Galactic Centre: A full parameter study with the S2 orbit
- Self-Consistent Spin, Tidal and Dynamical Equations of Motion in the REBOUNDx Framework
- A Criterion for the Stability of Planets in Chains of Resonances
- Capture of stars into gaseous discs around massive black holes: Alignment, circularization and growth
- Mean motion resonance capture in the context of type-I migration
- C/2014 UN271 (Bernardinelli-Bernstein): the nearly spherical cow of comets
- Direct -body simulations of satellite formation around small asteroids: insights from DART's encounter with the Didymos system
- A low-eccentricity migration pathway for a 13-h-period Earth analogue in a four-planet system
- On the long-term stability of the Solar System in the presence of weak perturbations from stellar flybys
- Rare Event Sampling Improves Mercury Instability Statistics
- When, where, and how many planets end up in first-order resonances?
- Formation of polar terrestrial circumbinary planets
- TRACE: a code for Time-Reversible Astrophysical Close Encounters
- Proximity of exoplanets to first-order mean-motion resonances
- TOI-1408: Discovery and Photodynamical Modeling of a Small Inner Companion to a Hot Jupiter Revealed by TTVs
- Mercury and OrbFit packages for the numerical integration of planetary systems: implementation of the Yarkovsky and YORP effects
- A Five-Planet Resonant Chain: Reevaluation of the Kepler-80 System
- The six-planet resonant chain of HD 110067
- Oort cloud perturbations as a source of hyperbolic Earth impactors
- TRAPPIST-1: Dynamical analysis of the transit-timing variations and origin of the resonant chain
- A Tidal Origin for a 3-body Resonance in Kepler-221
- TOI-4010: A System of Three Large Short-Period Planets With a Massive Long-Period Companion
- celmech: A Python package for celestial mechanics
- Identifying meteorite droppers among the population of bright 'sporadic' bolides imaged by the Spanish Meteor Network during the spring of 2022
- Exciting the TTV Phases of Resonant Sub-Neptunes
- Are long-term -body simulations reliable?
- A differentiable N-body code for transit timing and dynamical modeling. I. Algorithm and derivatives
- An integrable model for first-order three-planet mean motion resonances
- A gap-sharing planet pair shaping the crescent in HD 163296: a disk sculpted by a resonant chain
- Stellar Evolution and Tidal Dissipation in REBOUNDx
- Modeling Radial Velocity Data of Resonant Planets to Infer Migration Histories
- Running The Gauntlet -- Survival of Small Circumbinary Planets Migrating Through Destabilising Resonances
- Stepsize errors in the -body problem: discerning Mercury's true possible long-term orbits
- A radial limit on polar circumbinary orbits from general relativity
- A Deep and Wide Twilight Survey for Asteroids Interior to Earth and Venus
- Relativistic Dynamical Stability Criterion of Multi-Planet Systems with a Distant Companion
- The HARPS search for southern extra-solar planets. XLVI: 12 super-Earths around the solar type stars HD39194, HD93385, HD96700, HD154088, and HD189567
- GRIT: a package for structure-preserving simulations of gravitationally interacting rigid-bodies
- Debris Disks in Multi-Planet Systems: Are Our Inferences Compromised by Unseen Planets?
- Sculpting the circumbinary planet size distribution through resonant interactions with companion planets
- TIC 290061484: A Triply Eclipsing Triple System with the Shortest Known Outer Period of 24.5 Days
- Formation, Structure, and Detectability of the Geminids Meteoroid Stream
- A CHEOPS-enhanced view of the HD3167 system
- A General Origin for Multi-Planetary Systems With Significantly Misaligned USP Planets
- Mass ratio, the hills mechanism, and the galactic centre S-stars
- The Exomoon Corridor for Multiple Moon Systems
- A third star in the HAT-P-7 system, and a new dynamical pathway to misaligned hot Jupiters
- Transit-Timing Variation Signature of Planet Migration: The Case of K2-24
- Exomoons in Systems with a Strong Perturber: Applications to Cen AB
- The rarity of very red TNOs in the scattered disk
- Birth cluster simulations of planetary systems with multiple super-Earths: initial conditions for white dwarf pollution drivers
- Constraints on the origins of hypervelocity stars: velocity distribution, mergers and star-formation history
- Radial-velocity variation of a tertiary star orbiting a binary black hole in coplanar and non-coplanar triples: short- and long-term anomalous behavior
- Simple physics and integrators accurately reproduce Mercury instability statistics
- Tidal interactions shape period ratios in planetary systems with three-body resonant chains
- Forming Young and Hypervelocity Stars in the Galactic Centre via Tidal Disruption of a Molecular Cloud
- A close outer companion to the ultra-hot Jupiter TOI-2109 b?
- Giant Planet Influence on the Collective Gravity of a Primordial Scattered Disk
- TESS and HARPS reveal two sub-Neptunes around TOI 1062
- Detached Eclipsing Binaries in Compact Hierarchical Triples: Triple-lined systems BD+44 2258 and KIC 06525196
- General relativistic precession and the long-term stability of the solar system
- Resonance Capture and Stability Analysis for Planet Pairs under Type I Disk Migration
- orbitN: A symplectic integrator for planetary systems dominated by a central mass -- Insight into long-term solar system chaos
- Can the gravitational effect of Planet X be detected in current-era tracking of the known major and minor planets?
- Kepler-80 Revisited: Assessing the Participation of a Newly Discovered Planet in the Resonant Chain
- Coplanar circumbinary planets can be unstable to large tilt oscillations in the presence of an inner polar planet
- The Yarkovsky effect in REBOUNDx
- Tilting Uranus via Secular Spin-Orbit Resonance with Planet 9
- exoMMR: a New Python Package to Confirm and Characterize Mean Motion Resonances
- EnckeHH: an integrator for gravitational dynamics with a dominant mass that achieves optimal error behaviour
- Extreme exomoons in WASP-49 Ab: dynamics and detectability
- Apsidal Clustering following the Inclination Instability
- TOI-5108 b and TOI 5786 b: Two transiting sub-Saturns detected and characterized with TESS, MaHPS and SOPHIE
- A repository of vanilla long term integrations of the Solar System
- A hot mini-Neptune and a temperate, highly eccentric sub-Saturn around the bright K-dwarf TOI-2134
- Confirming Resonance in Three Transiting Systems
- Global dynamics and architecture of the Kepler-444 system
- A direct N-body integrator for modelling the chaotic, tidal dynamics of multi-body extrasolar systems: TIDYMESS
- Composition constraints of the TRAPPIST-1 planets from their formation
- Dynamical feasibility of (3) Juno as a parent body of the H chondrites
- Delivery of DART Impact Ejecta to Mars and Earth: Opportunity for Meteor Observations
- Meteoroid Stream Formation Due to the Extraction of Space Resources from Asteroids
- A stream of hypervelocity stars from the Galactic Center
- Observable tests for the light-sail scenario of interstellar objects
- A Lopsided Outer Solar System
- Tidally Heated Sub-Neptunes, Refined Planetary Compositions, and Confirmation of a Third Planet in the TOI-1266 System
- Self-consistent Dynamical and Chaotic Tides in the REBOUNDx framework
- Dynamical Instability of Multi-planet Systems and Free-floating Planets
- Planetesimal Growth in Evolving Protoplanetary Disks: Constraints from the Pebble Supply
- An automated occultation network for gravitational mapping of the trans-neptunian solar system
- Planet Mass Function around M stars at 1-10 au: A Plethora of sub-Earth mass objects
- A constraint on the density of Jupiter's moon Thebe from primordial dynamics
- Effects of Outer Giant Planets on In Situ Formation of Inner Super-Earths
- TESS and HARPS-N unveil two planets transiting TOI-1453. A super-Earth and one of the lowest mass sub-Neptunes
- The influence of a static planetary atmosphere on spin transfer during pebble accretion
- Architecture of planetary systems predicted from protoplanetary disks observed with ALMA II: evolution outcomes and dynamical stability
- Constraining protoplanetary disks with exoplanetary dynamics: Kepler-419 as an example
- Steeper Scattered Disks Buckle Faster
- The Formation of Double Hot Jupiter Systems through von Zeipel-Lidov-Kozai Migration
- The Challenge of Measuring Asteroid Masses with Gaia DR2 astrometry
- Higher-Order Mean-Motion Resonances Can Form in Type-I Disk Migration
- Impact of a granular mass distribution on the orbit of S2 in the Galactic center
- Dynamical simulation of the Interstellar Comet 3I/ATLAS
- Callisto's Nonresonant Orbit as an Outcome of Circum-Jovian Disk Substructure
- The Moon-forming Impact as a Constraint for the Inner Solar System's Formation
- A High-Precision, Differentiable Code for Solar System Ephemerides
- The Dynamical Viability of an Extended Jupiter Ring System
- Entering the Wind Roche Lobe Overflow realm in Symbiotic Systems
- Gas-depleted planet formation occurred in the four-planet system around the red dwarf LHS 1903
- Uncovering the Rapidly Evolving Orbits of the Dynamic TOI-201 System
- An Implementation of Stochastic Forces for the N-body code REBOUND
- Discovery of a dwarf planet candidate in an extremely wide orbit: 2017 OF201
- ARDENT: A Python package for fast dynamical detection limits with radial velocities
- General Relativity Can Prevent a Runaway Greenhouse on Potentially Habitable Planets Orbiting White Dwarfs
- Influence of Modeling Assumptions on the Inferred Dynamical State of Resonant Systems: A Case Study of the HD 45364 System
- An ancient L- type family associated to (460) Scania in the Middle Main Belt as revealed by Gaia DR3 spectra
- Precautionary Planetary Defence
- The recent crossing of the 7:3 resonance between Ganymede and Callisto
- The Effects of Disk Induced Apsidal Precession on Planets Captured into Mean Motion Resonance
- Distinguishing Dark Matter Cusps from Cores using Globular Clusters