-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
35 additions
and
17 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,21 +1,39 @@ | ||
# Particle Simulator | ||
|
||
## Overview | ||
Welcome to the Particle Simulator project! This simulator is designed to create and visualize complex particle systems governed by real physics. It supports various states of matter including powder, liquid, solid, and gas, and allows for the simulation of phenomena such as explosions, nuclear reactions, fusion, fission, and particle collisions. | ||
A particle simulation game with various elements such as powder, water, fire, steam, and wood. Users can create particles and interact with them in a physics-based environment. | ||
|
||
## Features | ||
- **Particle Dynamics**: Simulate individual particle motion with accurate physics. | ||
- **State Transitions**: Model transitions between different states of matter. | ||
- **Interactions**: Implement interactions between particles, including collisions and forces. | ||
- **Explosions and Reactions**: Simulate explosive reactions and nuclear processes. | ||
- **Visualization**: Visualize the particle systems in 2D with clear and informative graphics. | ||
|
||
## Getting Started | ||
### Prerequisites | ||
- Python 3.6+ | ||
- `numpy` and `matplotlib` packages | ||
|
||
### Installation | ||
1. **Clone the Repository:** | ||
```bash | ||
git clone https://github.com/KhamessiTaha/ParticleSimulator.git | ||
|
||
- Powder, Water, Fire, Steam, and Wood elements | ||
- Physics-based interactions | ||
- Element creation through a user interface | ||
|
||
## Requirements | ||
|
||
- Python 3.7+ | ||
- Pygame | ||
- NumPy | ||
|
||
## Installation | ||
|
||
1. Clone the repository: | ||
```bash | ||
git clone https://github.com/yourusername/ParticleSimulator.git | ||
cd ParticleSimulator | ||
``` | ||
|
||
2. Install dependencies: | ||
```bash | ||
pip install -r requirements.txt | ||
``` | ||
|
||
3. Run the application: | ||
```bash | ||
python src/ui.py | ||
``` | ||
|
||
## Building the Executable | ||
|
||
To build the application as a standalone executable, run: | ||
```bash | ||
pyinstaller --name ParticleSimulator --onefile src/ui.py |