refactor: upgrade N-body simulation with Leapfrog integrator and energy monitoring #14203
+204
−347
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Describe your change:
Checklist:
Additional Context: Physical Integrity Upgrade
This PR upgrades the
n_body_simulation.pyfrom a simple visual demo to a physically robust simulator by replacing the naive Euler method with Leapfrog Integration.Why Leapfrog? (The Quantitative Evidence)
In gravitational systems, preserving the Hamiltonian (Total Energy) is crucial. The standard Euler method suffers from "numerical drift," causing energy to increase or decrease artificially.
Comparison (Figure-8 Orbit, 1000 steps):
Key Enhancements:
Vector2Ddataclass to handle position, velocity, and force as high-level physical entities, reducing the error-prone handling of individual x/y components.total_energy()method toBodySystem, allowing users to verify the physical integrity of their simulations.By aligning the implementation with the fundamental laws of orbital mechanics, this module now serves as a much more accurate educational tool for students of physics and computer science.