General Reacting Incompressible Navier-Stokes (GRINS) was initiated
to house common modeling work centered around using the incompressible
and variable-density (low-Mach) Navier-Stokes equations
utilizing the libMesh finite
element library, including both MPI and MPI+threads parallelism,
as provided by libMesh.
GRINS has now become a tool for rapidly developing
formulations and algorithms for the solution of complex multiphysics
applications.
GRINS originally lived within
the PECOS center at the Institute for Computational
Engineering and Sciences (ICES)
at The University of Texas at Austin.
We encourage pull requests for new features, bug fixes, etc. For questions regarding development, we have a grins-devel Google group setup. For user related questions, please use the grins-users group.
In addition to a modern C++ compiler, GRINS requires an up-to-date installation of the libMesh finite element library (currently version 0.9.2.2 or later) as well as the Boost C++ library.
To enable the reacting low Mach Navier-Stokes physics class, GRINS must be compiled with an external chemistry library. While Cantera is partially supported, Antioch is fully supported.
GRINS uses an Autotools build system, so typical GNU build commands are used.
- ./bootstrap (generate configure script)
- ./configure --prefix=/path/to/install --with-libmesh=/path/to/libMesh --with-boost=/path/to/boost (for more options, do ./configure --help)
- make (note parallel builds are supported)
- make check (note parallel-tests are supported)
- make install
By default, GRINS leverages the METHOD environment variable (described here) in order to retrieve the CXXFLAGS variable from the libMesh installation (if METHOD is not present, the default is "opt"). The user can define their own CXXFLAGS variable by passing
--disable-libmesh-flags CXXFLAGS="your flags here"
to configure.