An adaptive and distributed-memory parallel implementation of the immersed boundary (IB) method
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.
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.
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.
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 for IBAMR is available via the IBAMR Users Google Group ([email protected]). Discussion related to the continued development of IBAMR is via the IBAMR Developers Google Group ([email protected]).
Please use the GitHub issue tracking system to report bugs, feature requests, or other issues with IBAMR.
IBAMR has a core group of developers but also regularly takes contributions from our students as well as outside users.
All patches undergo a peer review process and are usually accepted after some minor revisions.
To ensure style uniformity, we require that users run make indent (or make the fixes indicated by the continous integration run).
For more information on how this process works see scripts/formatting/README.md.
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.