Skip to content

Commit

Permalink
Merge pull request #29 from mesh-adaptation/readme_update
Browse files Browse the repository at this point in the history
gpu version installation guide
  • Loading branch information
erizmr authored Oct 11, 2024
2 parents 42c0ba6 + e41c450 commit 88c9026
Showing 1 changed file with 5 additions and 23 deletions.
28 changes: 5 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,20 +10,9 @@ Additional information: [[Project page]](https://erizmr.github.io/UM2N/)
</p>



<!-- <img width="100%" src="https://raw.githubusercontent.com/chunyang-w/chunyang-w.github.io/pic/202306231902481.webp"/> -->
<!-- (Image source: [Star Trek: Official Site](https://intl.startrek.com/article/warp-drive-a-reality-could-be-soon)) -->



## 🔎 Abstract

Solving complex Partial Differential Equations (PDEs) accurately and efficiently is an essential and challenging problem in all scientific and engineering disciplines. Mesh movement methods provide the capability to improve the accuracy of the numerical solution without increasing the overall mesh degree of freedom count. Conventional sophisticated mesh movement methods are extremely expensive and struggle to handle scenarios with complex boundary geometries. However, existing learning-based methods require re-training from scratch given a different PDE type or boundary geometry, which limits their applicability, and also often suffer from robustness issues in the form of inverted elements. In this paper, we introduce the Universal Mesh Movement Network (UM2N), which -- once trained -- can be applied in a non-intrusive, zero-shot manner to move meshes with different size distributions and structures, for solvers applicable to different PDE types and boundary geometries. UM2N consists of a Graph Transformer (GT) encoder for extracting features and a Graph Attention Network (GAT) based decoder for moving the mesh. We evaluate our method on advection and Navier-Stokes based examples, as well as a real-world tsunami simulation case. Our method outperforms existing learning-based mesh movement methods in terms of the benchmarks described above. In comparison to the conventional sophisticated Monge-Ampère PDE-solver based method, our approach not only significantly accelerates mesh movement, but also proves effective in scenarios where the conventional method fails.
<!-- In the famous TV series Star Trek, the starship Enterprise is able to travel
faster than light by warping space-time. In this project, we 'warp' the
underlying mesh of a discretised PDE problem to win some computational time.
The node of the mesh is moved to the ideal position guided by a Graph Neural
Network (GNN), which is supposed to be faster than numerical solvers. -->


The latest test status:
Expand All @@ -42,7 +31,11 @@ Just navigate to **project root** folder, open terminal and execute the
```
This will install [Firedrake](https://www.firedrakeproject.org/download.html)
and [Movement](https://github.com/mesh-adaptation/movement) under the `install`
folder, as well as the `WarpMesh` package.
folder, as well as the `WarpMesh` package. Note that the pytorch installed is a cpu version.

- GPU (cuda) support
For gpu support, please execute the: `install_gpu.sh {CUDA_VERSION}`.
E.g. `install_gpu.sh 118` for a CUDA version 11.8.


### Step-by-step approach
Expand Down Expand Up @@ -172,14 +165,3 @@ The documentation is generated by Sphinx. To build the documentation, under the
└── README.md (Project summary and useful information)
```

<!-- ## Useful thing: delete plot directory
```
find ./ -type d -name "plot" -exec rm -rf {} +
tensorboard --logdir=path/to/your/logs
```
## 🖖🏼 At last ...
Live long and prosper! -->

0 comments on commit 88c9026

Please sign in to comment.