Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sandialabs/omega_h
Simplex mesh adaptivity for HPC
https://github.com/sandialabs/omega_h
cmake cpp cpp14 cuda geometry gpu hpc mesh mesh-generation meshing mpi openmp parallel parallel-computing parallelism sandia-national-laboratories scr-2203 snl-science-libs triangulation
Last synced: 9 days ago
JSON representation
Simplex mesh adaptivity for HPC
- Host: GitHub
- URL: https://github.com/sandialabs/omega_h
- Owner: sandialabs
- License: other
- Created: 2016-05-13T22:15:37.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-06-13T16:11:22.000Z (5 months ago)
- Last Synced: 2024-10-15T01:21:29.807Z (25 days ago)
- Topics: cmake, cpp, cpp14, cuda, geometry, gpu, hpc, mesh, mesh-generation, meshing, mpi, openmp, parallel, parallel-computing, parallelism, sandia-national-laboratories, scr-2203, snl-science-libs, triangulation
- Language: C++
- Homepage:
- Size: 6.92 MB
- Stars: 114
- Watchers: 18
- Forks: 53
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
![Omega\_h Logo][1]
# Omega\_h
> Reliable mesh adaptation
Omega\_h is a C++14 library that implements tetrahedron and triangle mesh adaptativity,
with a focus on scalable HPC performance using (optionally) MPI and OpenMP or CUDA.
It is intended to provided adaptive functionality to existing simulation codes.
Mesh adaptivity allows one to minimize both discretization error and number
of degrees of freedom live during the simulation, as well as enabling moving
object and evolving geometry simulations.
Omega\_h will do this for you in a way that is fast, memory-efficient, and
portable across many different architectures.
## Installing / Getting started
For a bare minimum setup with no parallelism, you just need [CMake][0],
a C++14 compiler, and preferably [ZLib][6] installed.
```shell
git clone [email protected]:SNLComputation/omega_h.git
cd omega_h
cmake . -DCMAKE_INSTALL_PREFIX=/your/choice
make install
```
This should install Omega\_h under the given prefix in a way you can
access from your own CMake files using these CMake commands:
```cmake
find_package(Omega_h)
target_link_libraries(myprogram Omega_h::omega_h)
```
## Features
Omega\_h provides at least the following:
* Adaptation of tetrahedral and triangle meshes in parallel
* Anisotropic metric field support
* Given good input element quality, the output element
quality is also guaranteed.
* Scalable MPI parallelism
* On-node OpenMP or CUDA parallelism
* Fully deterministic execution
* Given the same mesh, global numbering, and size field,
results will be independent of parallel partitioning
and ordering.
## Configuration
Below we document some key CMake configuration options:
#### Omega\_h\_USE\_MPI
Default: `OFF`
Whether to enable MPI parallelism.
We recommend using [MPICH][3] or another MPI 3.0 implementation,
but we also support MPI version 2.1.
If this is `ON`, set `CMAKE_CXX_COMPILER` to your MPI compiler wrapper.
#### Omega\_h\_USE\_OpenMP
Default: `OFF`
Whether to enable OpenMP thread parallelism.
The `-fopenmp` flag will automatically be added.
#### Omega\_h\_USE\_CUDA
Default: `OFF`
Whether to enable CUDA GPU parallelism.
Currently, this requires that [`nvcc_wrapper`][7] be used as the `CMAKE_CXX_COMPILER`.
#### Omega\_h\_USE\_SEACASExodus
Default: `OFF`
Whether to use the Exodus subpackage of the SEACAS toolkit.
This allows reading and writing Exodus files from Omega\_h.
By default, it will look for this dependency in `SEACASExodus_PREFIX`.
## Contributing
Please open a Github issue to ask a question, report a bug,
request features, etc.
If you'd like to contribute, please fork the repository and use a feature
branch. Pull requests are welcome.
## Licensing
This library is released under the FreeBSD license.
[0]: https://cmake.org
[1]: https://raw.githubusercontent.com/SNLComputation/omega_h/master/misc/omega_h.png
[3]: http://www.mpich.org
[6]: http://zlib.net
[7]: http://github.com/kokkos/nvcc_wrapper