refine is a 3D mesh adaptation tool implemented in the C language.
refine can function without depencies, but the typical use cases of
parallel execution and geometry evaluation require an MPI implementation
and Engineering Sketch Pad (ESP).
A native implementaion of a recursive coordinate bisection partition
algorithm is included, but better results are expected with
ParMETIS.
Initial mesh generation assumes
TetGen or
AFLR is in
the shell path.
Configuration and compliation is supported with Autoconf and CMake.
./bootstrap
mkdir -p build
cd build
../configure --prefix=`pwd` \
--with-mpi=/mpi/path \
--with-parmetis=/parmetis/path \
--with-EGADS=/egads/path \
--with-OpenCASCADE=/opencascade/path
make
make install
See the INSTALL file in the top directory or ./configure --help
for additional build instructions.
mkdir -p build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=`pwd` \
-DCMAKE_PREFIX_PATH="/mpi/path;/parmetis/path;/egads/path;/opencascade/path"
make
make install
The installed bin directory will include the ref executable.
Invoking ref with no arguments will list available subcommands.
Help on a particular subcommand is available via a -h, i.e.,
ref adapt -h. If MPI is provided, refmpi will allow for parallel
execution. If ESP is provided, ref and refmpifull includes
EGADS built with OpenCASCADE and refmpi includes EGADSlite.
The following examples assume that ref is in your shell path.
mpiexec ... refmpi or mpiexec ... refmpifull can be substituted for
ref in each of these examples if MPI and/or ESP is configured. The
.meshb and .solb file extensions
are used generically. Other formats are supported, e.g.,
AFLR *.ugrid.
An .egads file can be dumped from OpenCSM in the ESP package.
ref bootstrap project.egads
or
mpiexec ... refmpifull bootstrap project.egads
which assume that tetgen is in your shell path or
aflr3 is in your shell path with --mesher aflr option.
A project-vol.meshb is output that includes the surface mesh,
volume mesh, mesh-to-geometry associtivity, and EGADSlite data.
The mesh is adapted with
ref adapt input.meshb -x output.meshb [-m metric.solb] [-g geometry.egads]
or
mpiexec ... refmpi adapt input.meshb -x output.meshb [-m metric.solb]
where a surface curvature metric is used if the -m argument is not present.
In conjunction with the Unstructured Grid Adaptation Working Group, an implementation of the multiscale metric is provided.
ref multiscale input.meshb scalar.solb complexity output-metric.solb
or
mpiexec ... refmpi multiscale input.meshb scalar.solb complexity output-metric.solb
The fields in a .solb file paired with a donor mesh can be interpolated to a receptor mesh. This utility can be executed in serial or parallel.
ref interp donor-mesh.ext donor-field.solb receptor-mesh.ext receptor-field.solb
or
mpiexec ... refmpi interp donor-mesh.ext donor-field.solb receptor-mesh.ext receptor-field.solb
where the output is receptor-field.solb.
refine is a 2D and 3D mesh adaptation tool implemented in the C
language. Mesh adaptation mechanics are provided where the primary
target is linear and curved simplex (triangle and tetrahedra)
meshes. A limited capability to store, modify, and insert
mixed-element types is also provided. Typical use is via an executable
that interacts with files, and linking to a library form is also
available. Mesh adaptation metrics can be computed by reconstructing
gradients and Hessians from a field. Visualization files and multiple
mesh formats can be exported. Solutions can be interpolated between
meshes. The distance to lower-dimensional elements can be computed.
Interfaces are available to multiple geometry sources and an internal
surrogate geometry source. Parallel execution is supported with
partitioning and load balancing. Solution fields are provided to
verify the mesh adaptation process.