https://github.com/SCOREC/omega_h
Simplex mesh adaptivity for HPC
https://github.com/SCOREC/omega_h
kokkos
Last synced: 7 months ago
JSON representation
Simplex mesh adaptivity for HPC
- Host: GitHub
- URL: https://github.com/SCOREC/omega_h
- Owner: SCOREC
- License: other
- Fork: true (sandialabs/omega_h)
- Created: 2018-09-13T19:54:04.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-05T03:47:22.000Z (7 months ago)
- Last Synced: 2025-03-05T04:27:47.786Z (7 months ago)
- Topics: kokkos
- Language: C++
- Homepage:
- Size: 7.98 MB
- Stars: 1
- Watchers: 5
- Forks: 10
- Open Issues: 21
-
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.
## Extensions
This fork of Omega\_h from https://github.com/sandialabs/omega_h v9.34.12 adds support for:
- loading serial Simmetrix meshes
- reverse classification, and defining tags on sets of mesh entities defined by a reverse classification relation
- representing single-process mixed meshes
- domains with matched/periodic entities
## 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 git@github.com:SCOREC/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.
#### 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.
[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