Revision 06d2adb7822f4392b21185d38c52cad34aaebef6 authored by sakamotoyan on 20 March 2024, 13:09:09 UTC, committed by GitHub on 20 March 2024, 13:09:09 UTC
1 parent 69b6eb3
Raw File

# TiSPH_multiphase
TiSPH_multiphase is an open-source implementation of our implicit multiphase solver.

## Platform
This software is developed using [Taichi](, making it compatible with both Linux and Windows operating systems, with or without a graphics card. It has been thoroughly tested on Ubuntu 20.04 and Windows 10/11.

For an optimal experience, especially when running demos, we recommend using an operating system with a graphical user interface (GUI).

## Requirements
- **Taichi**: The core of most algorithms in this program. Install it via pip with the command:
  pip install taichi
- **Numpy**: Essential for data generation.
- **Matplotlib**: Used for visualizing and plotting results.
- **OpenGL or Vulkan**: Necessary for the GUI-based 3D demos.

## Demos
### Running the demos
Execute the following in your terminal to run a demo:
**2D Demos**: The output consists of a series of images that are automatically saved to the `output` directory.

**3D Demos**: A window will open displaying the simulation. Use your mouse to adjust the camera angle. Press `r` to start the simulation.

### GPU Simulation
By default, all 2D demos are set to run on the CPU. To run simulations on the GPU:
1. Comment out `ti.init(arch=ti.cpu)` 
2. Uncomment `ti.init(arch=ti.cuda)` in the `` file.

> **Note**: Ensure you have a CUDA-compatible graphics card for GPU simulation. We've verified performance on the NVIDIA RTX 3090. The demo `` is a time-intensive 3D simulation and is set to run on the GPU by default.

### Solver Configuration
All demos utilize our implicit multiphase solver by default. To switch to another multiphase solver:
1. Change `solver = SOLVER_ISM` 
2. To `solver = SOLVER_JL21` in the `` file.

### Experimenting with Demos
For those keen to tweak and experiment, we've included ample comments within the `` file. Adjust parameters as you like and observe varying results!
back to top