Anisotropic mesh adaptation library
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Description

PRAgMaTIc (Parallel anisotRopic Adaptive Mesh ToolkIt) provides 2D/3D anisotropic mesh adaptivity for meshes of simplexes. The target applications are finite element and finite volume methods although it can also be used as a lossy compression algorithm for 2 and 3D data (e.g. image compression). It takes as its input the mesh and a metric tensor field which encodes desired mesh element size anisotropically.

The toolkit is written in C++ but also provides interfaces for C. It has been integrated with FEniCS/Dolfin, with PETSc/DMPlex and integration with Firedrake is ongoing. One of the design goals of PRAgMaTIc is to develop highly scalable algorithms for clusters of multi-core and many-core nodes. PRAgMaTIc uses OpenMP for thread parallelism and MPI for domain decomposition parallelisation.

Publications

A thread-parallel algorithm for anisotropic mesh adaptation Under review: arXiv:1308.2480

Hybrid OpenMP/MPI anisotropic mesh smoothing DOI: 10.1016/j.procs.2012.04.166

Accelerating Anisotropic Mesh Adaptivity on nVIDIA's CUDA Using Texture Interpolation DOI: 10.1007/978-3-642-23397-5_38

Requirements

The following libraries are required to build PRAgMaTIc:

  • Eigen3
  • MPI
  • METIS (on debian this can be installed with sudo apt-get install libmetis-dev)
  • VTK (optional)
  • LibMeshb (optional).

Configure

PRAgMaTIc can be configured with a number of custom options for IOs, which are shown in the following.

ENABLE_VTK=TRUE|FALSE

ENABLE_LIBMESHB=TRUE|FALSE

These can be set as env variables, or given as command line arguments to cmake, e.g. cmake -DENABLE_VTK=FALSE would disable MPI support. If both of the same option are given, the command line argument is given a higher priority over the env variable.

If neither is given the default value is used for the configuration, which is TRUE for all configure options.

Let be the path to the source directory of PRAgMaTIc, the build directory in which you want to build PRAgMaTIc, and the directory in which you wish to install PRAgMaTIc. E.g. execute

$ mkdir

$ cd

Then do

$ cmake

If you want to install PRAgMaTIc to a specific location then specify the target location.

$ cmake -DCMAKE_INSTALL_PREFIX=

The default location for is /usr/local.

By default, PRAgMaTIc is built in debug mode. To build in release mode, set CMAKE_BUILD_TYPE=Release.

Build

PRAgMaTIc is now ready to be built. In your execute

$ make

Testing

To build and run tests, execute

$ make test

Install

In your , execute

$ make install

Depending on you might have to run with sudo rights.

$ sudo make install

Examples

Some examples can be found in /python. Dolfin is required to run them.

Note: PRAgMaTIc needs to be built prior to running the examples.

DEBIAN

A Debian package is provided. To build a deb simply cd to the source directory and execute:

$ dpkg-buildpackage -us -uc