Finite-rate combustion solvers (ED, ED/FR, EDC, PaSR, QLFR, PaSR_LFR, LFR) for OpenFOAM based on the OpenSMOKE++ framework. FiReSMOKE requires one of the following OpenFOAM versions:
- OpenFOAM-7.x
If you use FiReSMOKE for your publications, we kindly ask you to cite the following two papers:
Parente, A., Malik, R.M., Contino, F., Cuoci, A., Dally, B., Extension of the Eddy Dissipation Concept for turbulence/chemistry interactions to MILD combustion (2016) Fuel, 163, pp. 98-111, DOI: 10.1016/j.fuel.2015.09.020
Cuoci, A., Frassoldati, A., Faravelli, T., Ranzi, E., OpenSMOKE++: An object-oriented framework for the numerical modeling of reactive systems with detailed kinetic mechanisms (2015) Computer Physics Communications, 192, pp. 237-264, DOI: 10.1016/j.cpc.2015.02.014
If you use the SPARC plugin for your publications, we kindly ask you to cite the following two papers:
D'Alessio, G., Parente, A., Stagni, A., Cuoci, A., Adaptive chemistry via pre-partitioning of composition space and mechanism reduction. (2020) Combustion and Flame, Volume 211, pp. 68-82. DOI: 10.1016/j.combustflame.2019.09.010.
Amaduzzi, R., D'Alessio, G., Pagani, P., Cuoci, A., Malpica Galassi, R., Parente, A., Automated adaptive chemistry for Large Eddy Simulations of turbulent reacting flows. (2024) Combustion and Flame, Volume 259, pp. 113-136. DOI: 10.1016/j.combustflame.2023.113136.
Docker installation provides a self-contained environment for OpenFOAM 7 with a pre-compiled version of FiReSMOKE.
- OpenSMOKE++ (already included in fireSMOKE)
- Eigen (http://eigen.tuxfamily.org/index.php?title=Main_Page)
- RapidXML (http://rapidxml.sourceforge.net/)
- Boost C++ (http://www.boost.org/)
- Intel MKL (https://software.intel.com/en-us/intel-mkl)
- ODEPACK (http://computation.llnl.gov/casc/odepack/odepack_home.html)
- DVODE (http://computation.llnl.gov/casc/odepack/odepack_home.html)
- DASPK (http://www.engineering.ucsb.edu/~cse/software.html)
- Sundials (http://computation.llnl.gov/casc/sundials/main.html)
- MEBDF (http://wwwf.imperial.ac.uk/~jcash/IVP_software/readme.html)
- RADAU (http://www.unige.ch/~hairer/software.html)
- Armadillo (for SPARC compilation, https://arma.sourceforge.net/) - version 9.800.6
Three different options are available to compile the code, according to the level of support for the solution of ODE systems
- Minimalist: no external, optional libraries are required. Only the native OpenSMOKE++ ODE solver can be used.
- Minimalist + Intel MKL: only the native OpenSMOKE++ ODE solver can be used, but linear algebra operations are managed by the Intel MKL libraries
- Complete: all the optional libraries are linked to the code, in order to have the possibility to work with different ODE solvers
- Instructions to compile the Minimalist version
- Open the
mybashrc.minimalist
and adjust the paths to the compulsory external libraries (in particular choose the OpenFOAM version you are working with) - Type:
source mybashrc.minimalist
- Compile the steady-state solver: from the
solver/fireSimpleSMOKE
folder typewmake
- Compile the unsteady solver: from the
solver/firePimpleSMOKE
folder typewmake
- Instructions to compile the Minimalist+MKL version
- Open the
mybashrc.minimalist.mkl
and adjust the paths to the compulsory external libraries and the paths to the Intel MKL library (in particular choose the OpenFOAM version you are working with) - Type:
source mybashrc.minimalist.mkl
- Compile the steady-state solver: from the
solver/fireSimpleSMOKE
folder typewmake
- Compile the unsteady solver: from the
solver/firePimpleSMOKE
folder typewmake
- Instructions to compile the Complete version
- Open the
mybashrc.complete
and adjust the paths to the compulsory external libraries and the Intel MKL library (in particular choose the OpenFOAM version you are working with). You can choose the additional external libraries you want to add to edcSMOKE, by modifying theEXTERNAL_ODE_SOLVERS
variable: in particular1
means that the support is requested, while0
means that no support is requested. Obviously, for each requested library, you need to provide the correct path. - Type:
source mybashrc.complete
- Compile the steady-state solver: from the
solver/fireSimpleSMOKE
folder typewmake
- Compile the unsteady solver: from the
solver/firePimpleSMOKE
folder typewmake
- Instructions to compile with SPARC plugin
- Adjust the paths in the desired
mybashrc
file to the armadillo libraries. - Type:
source mybashrc.minimalist.mkl
- Compile the steady-state solver: from the
solver/fireSimpleSMOKE
folder typewmake
- Compile the unsteady solver: from the
solver/firePimpleSMOKE
folder typewmake
Only tested for MacOS.
-
Install Docker for your OS Docker Installation
-
OpenFOAM7 + FiReSMOKE is launched from the script
firesmoke2-macos
in this repository. The script needs to be located somewhere on the user’sPATH
for convenient execution. The following commands will then install in the system-wide /usr/local/bin directory and make the script executable:sudo curl --create-dirs -o /usr/local/bin/firesmoke2-macos firesmoke2-macos
sudo chmod 755 /usr/local/bin/firesmoke2-macos
- if you do not have permissions to open the application:
xattr -d com.apple.quarantine /usr/local/bin/firesmoke2-macos
- if you do not have permissions to open the application:
-
The Docker container mounts the user’s file system so that case files are stored permanently. The container mounts the directory from where
firesmoke2-macos
is launched by default, but the user can also specify the directory using the “-d” option. Mounting the user’s $HOME directory is disallowed. Where a case-sensitive volume has been created, the container mount directory would typically coincide with the mount directory (or sub-directory) of the volume. For example, for a case-sensitive volume mounted in the default location,$HOME/openfoam
:cd $HOME/openfoam
firesmoke2-macos