Skip to content

IBAMR/IBAMR

Repository files navigation

IBAMR

An adaptive and distributed-memory parallel implementation of the immersed boundary (IB) method

What Is IBAMR?

IBAMR is a distributed-memory parallel implementation of the immersed boundary (IB) method with support for Cartesian grid adaptive mesh refinement (AMR). Support for distributed-memory parallelism is via MPI, the Message Passing Interface.

Core IBAMR functionality relies upon several high-quality open-source libraries, including:

  • SAMRAI, the Structured Adaptive Mesh Refinement Application Infrastructure
  • PETSc, the Portable, Extensible Toolkit for Scientific Computation
  • libMesh, a C++ finite element library
  • hypre, a library of high performance preconditioners that features parallel multigrid methods for both structured and unstructured grid problems.

IBAMR also uses functionality provided by a number of additional third-party libraries, including: Boost; Eigen; HDF5; muParser; and Silo.

IBAMR outputs visualization files that can be read by the VisIt Visualization Tool.

What Is the IB Method?

The immersed boundary (IB) method is a general-purpose numerical method for simulating fluid-structure interaction. The IB formulation of such problems uses an Eulerian description of the fluid and a Lagrangian description of the structure. Interaction equations that couple the Eulerian and Lagrangian variables take the form of integral equations with delta function kernels.

For general information about the IB method, see math.nyu.edu/faculty/peskin. For additional information about the IBAMR software, see ibamr.github.io. We are happy to host visualizations of simulations that use IBAMR.

Getting Started

IBAMR requires a number of third-party libraries. Sample build instructions are provided for both Linux distributions and macOS.

For help with git see the summary document included with the documentation.

Documentation

Source code documentation for the IBAMR library and supporting IBTK library is available on-line. File format documentation is also available on-line. There is also list of frequently asked questions.

Support

Support for IBAMR is available via the IBAMR Users Google Group (ibamr-users@googlegroups.com). Discussion related to the continued development of IBAMR is via the IBAMR Developers Google Group (ibamr-dev@googlegroups.com).

Bugs and Other Issues

Please use the GitHub issue tracking system to report bugs, feature requests, or other issues with IBAMR.

Acknowledgments

IBAMR development is supported in part by NSF Software Infrastructure for Sustained Innovation awards OAC 1450327 (to UNC-Chapel Hill), OAC 1450374 (to Northwestern University), and OAC 1607042 (to Rice University). Additional support is provided by NSF CAREER award OAC 1652541 (to UNC-Chapel Hill). Prior support was provided by NSF awards DMS 1016554 (to New York University), DMS 1460368 (to UNC-Chapel Hill), OAC 1047734 (to New York University), and OAC 1460334 (to UNC-Chapel Hill). We gratefully acknowledge this support.