https://github.com/oadultradeepfield/three-body-simulation

A C++ program that simulates the motion of three objects under mutual gravitational attraction using Newton's law of gravitation approximated with the fourth-order Runge-Kutta method.
https://github.com/oadultradeepfield/three-body-simulation

Last synced: 4 days ago
JSON representation

A C++ program that simulates the motion of three objects under mutual gravitational attraction using Newton's law of gravitation approximated with the fourth-order Runge-Kutta method.

• Host: GitHub
• URL: https://github.com/oadultradeepfield/three-body-simulation
• Owner: oadultradeepfield
• License: mit
• Created: 2024-12-09T14:33:48.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-10T06:31:39.000Z (about 2 months ago)
• Last Synced: 2024-12-10T07:36:44.241Z (about 2 months ago)
• Language: C++
• Homepage:
• Size: 5.63 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Three-Body Simulation

💡 _**Future Plan**: Generalize the program for N bodies with a support for spherical coordinates (The new version is now available at [this repo](https://github.com/oadultradeepfield/generalized-n-body-simulation))._

A C++ program simulating the motion of three objects under mutual gravitational attraction using Newton's law of gravitation, $F = GMm/r^2$. The simulation approximates the ODE solution with the fourth-order Runge-Kutta method (RK4) to update positions and velocities. Visualization is done using Python's Matplotlib for 3D trajectories and XY projections.

[![C++](https://img.shields.io/badge/C%2B%2B-00599C?style=flat&logo=C%2B%2B&logoColor=white)](https://isocpp.org/)

[![Python](https://img.shields.io/badge/Python-3776AB?style=flat&logo=Python&logoColor=white)](https://www.python.org/)

## Installation

1. Clone the repository and navigate to the project directory:

   ```bash

   git clone https://github.com/oadultradeepfield/three-body-simulation.git

   cd three-body-simulation

   ```

2. Create a build directory, generate the Makefile with CMake, and build the project:

   ```bash

   mkdir build

   cd build

   cmake ..

   make

   ```

3. Install Python dependencies for visualization:

   ```bash

   pip install -r python/requirements.txt

   ```

## Usage

1. Configure the simulation by editing `config.txt` and `bodies.txt`:

   - `config.txt`

     ```bash

     G=1

     dt=0.0005

     total_time=50

     filename=results/example_02_eight_shaped_orbit.txt

     ```

   - `bodies.txt`

     ```bash

     # Body 1

     1

     0.97000436 -0.2430875 0.0

     0.466203685 0.4321573 0.0

     # Body 2

     1

     -0.97000436 0.2430875 0.0

     0.466203685 0.4321573 0.0

     # Body 3

     1

     0.0 0.0 0.0

     -0.93240737 -0.8643146 0.0

     ```

2. Run the simulation:

   ```bash

   build/ThreeBodySimulation config.txt bodies.txt

   ```

3. Generate trajectory plots (optional):

   ```bash

   python3 python/plot.py --filename ./results/example_02_eight_shaped_orbit.txt

   ```

The output plot will be saved in the same directory as the `.txt` file.

|                            **Example 3D Trajectory**                            |                             **Example XY Projection**                              |

| :-----------------------------------------------------------------------------: | :--------------------------------------------------------------------------------: |

| ![Example 3D Trajectory](/results/example_02_eight_shaped_orbit_trajectory.png) | ![Example 2D Projection](/results/example_02_eight_shaped_orbit_2d_projection.png) |