{"id":42434270,"url":"https://github.com/fraware/solarsim","last_synced_at":"2026-01-28T05:03:48.447Z","repository":{"id":280014814,"uuid":"940755554","full_name":"fraware/solarsim","owner":"fraware","description":"Advanced 3D simulation of the solar system, featuring enhanced physics and interactive visualization. ","archived":false,"fork":false,"pushed_at":"2025-07-28T21:30:07.000Z","size":342,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-28T23:25:03.043Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://solar-sim-showcase.lovable.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fraware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-28T18:23:59.000Z","updated_at":"2025-07-28T21:30:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"6c6eac3f-f393-4e6e-9461-56e12d1f4baa","html_url":"https://github.com/fraware/solarsim","commit_stats":null,"previous_names":["fraware/solarsim"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fraware/solarsim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fsolarsim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fsolarsim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fsolarsim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fsolarsim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fraware","download_url":"https://codeload.github.com/fraware/solarsim/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraware%2Fsolarsim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28840056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T02:10:51.810Z","status":"ssl_error","status_checked_at":"2026-01-28T02:10:50.806Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-28T05:03:39.858Z","updated_at":"2026-01-28T05:03:48.439Z","avatar_url":"https://github.com/fraware.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [SolarSim](https://solar-sim-showcase.lovable.app/)\n\n## Overview\n\nThis project is an advanced 3D simulation of the solar system, featuring enhanced physics and interactive visualization. It simulates the motion of celestial bodies—including the Sun, eight planets, Earth's Moon, and Pluto—using a velocity Verlet integrator with adaptive time-stepping, relativistic corrections (for Mercury), and basic collision detection. The simulation is visualized in 3D using Matplotlib and controlled via a Tkinter GUI, which offers real-time parameter adjustments, timeline scrubbing, and multiple camera views.\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n\u003cimg src=\"assets/SOLARSIM.png\"\u003e\n\u003c/p\u003e\n\n## Features\n\n- **Advanced Physics \u0026 Numerical Methods**\n  - **Velocity Verlet Integration:** A symplectic integrator for improved long-term energy conservation.\n  - **Adaptive Time-Stepping:** Automatically adjusts the time step based on inter-body distances.\n  - **Relativistic Corrections:** A simple correction for Mercury’s perihelion precession.\n  - **Collision Detection:** Merges bodies when they come within a specified proximity.\n- **Expanded Celestial Model**\n\n  - Includes the Sun, Mercury, Venus, Earth, Moon, Mars, Jupiter, Saturn, Uranus, Neptune, and Pluto.\n  - Uses approximate orbital data; can be enhanced with precise astronomical data (e.g., via AstroPy).\n\n- **User Interactivity \u0026 Control**\n\n  - Real-time adjustments for time step, simulation speed (steps per frame), and body-specific parameters.\n  - Multiple camera modes: Free, Follow, and Top-Down views.\n  - Timeline slider for scrubbing and replaying simulation trajectories.\n  - Real-time data overlays for simulation time (in days) and total energy.\n  - Placeholder toggle for GPU acceleration.\n\n- **Visualization Enhancements**\n  - 3D visualization with a star-filled background.\n  - Labels and trajectory paths for each celestial body.\n  - Interactive navigation toolbar (zoom, pan, rotate).\n\n## Requirements\n\n- **Python 3.x**\n- **Required Python Packages:**\n  - [NumPy](https://numpy.org/)\n  - [Matplotlib](https://matplotlib.org/)\n  - [Tkinter](https://docs.python.org/3/library/tkinter.html) (usually included with Python)\n  - [Numba](http://numba.pydata.org/)\n- **Optional for Packaging:**\n  - [PyInstaller](https://www.pyinstaller.org/) for creating standalone executables\n\n## Installation\n\n1. **Clone the Repository:**\n\n   ```bash\n   git clone https://github.com/yourusername/enhanced_solar_system.git\n   cd enhanced_solar_system\n   ```\n\n2. **Install Dependencies:**\n\nUse pip to install the necessary packages:\n\n```bash\npip install numpy matplotlib numba\n```\n\n## Running the Simulation\n\nTo run the simulation, execute the main script:\n\n```bash\npython enhanced_solar_system.py\n```\n\n### Controls\n\n- **Base Time Step (s):** Adjusts the simulation's base time step (default is 86,400 seconds = 1 day).\n- **Steps/Frame:** Sets the number of simulation steps executed per animation frame.\n- **Pause/Resume/Step:** Control the simulation flow.\n- **Camera Modes:** Choose between Free, Follow (centers on a selected body), or Top-Down views.\n- **Timeline Slider:** Scrub through the simulation timeline to replay trajectories.\n- **GPU Acceleration:** (Placeholder) Toggle for potential future GPU support.\n- **Data Overlays:** View real-time simulation time and total energy.\n\n## Packaging as a Standalone Application\n\nTo create a standalone executable using PyInstaller, follow these steps:\n\n1. **Install PyInstaller:**\n\n   ```bash\n   pip install pyinstaller\n\n   ```\n\n2. **Package the Application:**\n\nRun the following command in your project directory:\n\n```bash\npyinstaller --onefile --windowed enhanced_solar_system.py\n```\n\n3. **Locate the Executable:**\n\nThe packaged executable will be located in the dist folder.\n\n### Project Structure\n\n```bash\nenhanced_solar_system/\n├── enhanced_solar_system.py # Main simulation script\n├── README.md # Project documentation\n├── .gitignore # Git ignore rules (e.g., /dist, /build folders)\n└── build_app.sh / build_app.bat # Build scripts for packaging\n```\n\n## Contributing\n\nContributions are welcome! If you’d like to enhance the simulation further, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bugfix.\n3. Make your changes with clear commit messages.\n4. Open a pull request explaining your changes.\n\nFeel free to suggest improvements in areas such as numerical methods, physics enhancements, visualization, or performance optimization.\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraware%2Fsolarsim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffraware%2Fsolarsim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraware%2Fsolarsim/lists"}