https://github.com/tday1/particles

A CUDA-accelerated particle Sim in C++
https://github.com/tday1/particles

Last synced: 4 days ago
JSON representation

A CUDA-accelerated particle Sim in C++

• Host: GitHub
• URL: https://github.com/tday1/particles
• Owner: TDay1
• Created: 2022-08-30T03:14:36.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-08-06T22:41:04.000Z (5 months ago)
• Last Synced: 2024-08-07T02:08:26.745Z (5 months ago)
• Language: C++
• Homepage:
• Size: 60.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Particles - High performance computing assignment

A Parallel implementation of a 2D fluid (particle) simulation.

---

## Summary

This repository contains a 2D fluid simulation in C++ developed for the Major project Milestone 1.

If you have any issues building or running please don't hesitate to reach out: .

All code in this project is POSIX-compliant C++11.

## Building

Building and incremental builds is all set up with a Makefile. To build run:

```

module load cuda

module load gnu

make

```

Note: simulation parameters are hardcoded at build-time, these may all be found and modified in `src/main.cu`

## Running

There are two components to run. The first is the particle simulation itself which can be run with `./particle-sim`.

Once particle-sim has run, some out files will be generated in your current working directory, these will be used by the second component - the visualisation scripts.

Note: if you run this on the Getafix console node (which you shouldn't) file logging doesn't work (likely due to some kind of disk io rate limit)

Note: The directory which this log file is written to is configurable on `src/output.cpp:6`. If you do change this make sure you update the scripts in `debug/` to reflect this new path

To run the visualisation scripts:

    * Generate a video (mp4) of the simulation: `python3 debug/visualise.py`

    * Generate a plot of the centre of gravity throughout the sim: `python3 debug/cg.py`

Note: the visualisation tools have the following dependencies: `python, numpy, matplotlib, and ffmpeg`

## Project structure

```

.

├── debug       # Simulation visualisation scripts

├── headers     # C++ header files

├── src         # Program source code

├── obj         # Compiled objects (only used during build)

├── Makefile

└── README.md

```