Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/im-rises/nbody-simulator-docker
N-body simulator using bruteforce method using docker for calculations
https://github.com/im-rises/nbody-simulator-docker
containers cpp docker javascript n-body n-body-simulator nbody-simulation nodejs simulation simulator
Last synced: 25 days ago
JSON representation
N-body simulator using bruteforce method using docker for calculations
- Host: GitHub
- URL: https://github.com/im-rises/nbody-simulator-docker
- Owner: Im-Rises
- License: mit
- Created: 2023-05-31T18:10:43.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-29T03:38:56.000Z (7 months ago)
- Last Synced: 2024-04-15T01:19:01.054Z (7 months ago)
- Topics: containers, cpp, docker, javascript, n-body, n-body-simulator, nbody-simulation, nodejs, simulation, simulator
- Language: C++
- Homepage: https://im-rises.github.io/nbody-simulator-webgl/
- Size: 107 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nbody-simulator-docker
[//]: # ( 
)
## Description
This is a simple n-body simulator made with OpenGL for the graphics part and C++ for the logic part.
The project is running on a complete docker environment.
> **Note**
> The project is a test of paralleling the calculation of the particles on different docker containers and store them in
> a redis database.
> A docker is also used to generate the video from the redis database.
## Videos
[//]: # (https://github.com/Im-Rises/nbody-simulator-docker/assets/59691442/59ef1c71-e2bb-4bd5-99f8-66eace4280b5)
https://github.com/Im-Rises/nbody-simulator-docker/assets/59691442/622717a8-b508-4221-a79e-f00c07475979
Longer video 🚀🚀 [here](https://www.youtube.com/watch?v=OisxyKE_ioU) 🚀🚀
## How to use
To use the project, you need to have docker installed on your computer.
You can download it here:
You also need to install the following linux lib:
```bash
sudo apt-get install xvfb
```
You also need python3 installed on your computer.
You can download it here:
Once you have installed the requirements, you can install the python libs with the following command:
```bash
pip install -r requirements.txt
```
This will install the required libs to generate the `docker-compose.yml` using the `docker-compose-generator.py` python
script.
```bash
python3 docker-compose-generator.py
```
exemple:
```bash
python3 docker-compose-generator.py 1000 4 10
```
This will generate a `docker-compose.yml` file with 4 calculators and 1000 particles and a simulation recording time of
10 seconds.
Once created you can run the `docker-compose.yml` with the following command:
```bash
./test.sh
```
An output video will be genereated in the `./src/NBodyGraphics/output_dir` folder.
## Dependencies
- OpenGL version: 3.3
- GLSL version: 330
- GLFW version: 3.2.1
- Glad version: 0.1.36
- GLM version: 0.9.9
- OpenCV version: 4.7.0-dev
- nlhomann/json version: 3.9.1
- libcurl version: 7.74.0
## Architecture
```mermaid
flowchart LR
subgraph Host
subgraph Docker-Calculators
docker1 & docker2 & docker...
end
docker1 & docker2 & docker... <--> |GET/POST| api-redis
subgraph Redis
api-redis
end
api-redis --> |Send particles| NBodyGraphics
NBodyGraphics --> |Request update| api-redis
subgraph Video-Generator
end
subgraph Video-Generator
NBodyGraphics
end
NBodyGraphics --> |Save video | Volume
end
```
## Logic Diagram
```mermaid
graph TB
A((Start))
B[NBodyGraphics]
C[API-Redis]
D[NBodycalculator1]
E[NBodycalculator2]
F[NBodycalculator3]
G[NBodycalculator...]
H[API-Redis]
I[NBodyGraphics]
J[Volume]
A --> B
B --> | Physic update | C
C --> | Particle request update | D & E & F & G
D & E & F & G --> | Send updated particles | H
H --> | Send updated particles | I
I --> | Do another cycle | B
I --> | Save video | J
```
## Libraries
docker:
cmake:
glfw:
glm:
glad:
OpenGL:
Json:
libcurl:
## Contributors
Axel COURMONT:
- @Alshkor
-
Quentin MOREL:
- @Im-Rises
-
Alexis ROVILLE:
- @Fromiel
-
[](https://github.com/Im-Rises/nbody-simulator-docker/graphs/contributors)