Skip to content

iadyo/nboms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NBodyOrbitalSimulator

Author: Adrian Just
Email: dsw60258@student.dsw.edu.pl
Institution: DSW - Dolnośląska Szkoła Wyższa
Course: Python Programming - Final Project
Date: February 2026


Project Title

N-Body Orbital Mechanics Simulator

A numerical solver for gravitational N-body problems with interactive 3D visualization using Python, implementing Euler integration for celestial body dynamics.


Installation and Running

Prerequisites

  • Python 3.9+
  • pip or uv package manager

Method 1: Using pip (Standard)

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Linux/macOS:
source venv/bin/activate
# On Windows:
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python main.py

Method 2: Using uv package manager

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the application with uv
uv run nboms

Conclusions

This project demonstrates proficiency in:

  • Computional Physics: Translation of mathematical models into executable code.
  • Numerical Methods: Understanding of integration schemes, truncation errors, and stability considerations.
  • Software Enginnering: Professional Python project structure with testing, documentation, and version control.
  • Data Visualization: Interactive 3D plotting with Matplotlib, GUI development with Tkinter.

Examples

Screenshot of the N-Body Orbital Simulator Example of the N-Body Orbital Simulator in action

About

A numerical solver for the N-body gravitational problem using Euler integration

Resources

License

Stars

Watchers

Forks

Contributors

Languages