singleStepReaction.C

Go to the documentation of this file.

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     | Website:  https://openfoam.org
    \\  /    A nd           | Copyright (C) 2011-2026 OpenFOAM Foundation
     \\/     M anipulation  |
-------------------------------------------------------------------------------
License
    This file is part of OpenFOAM.
 
    OpenFOAM is free software: you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
 
    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    for more details.
 
    You should have received a copy of the GNU General Public License
    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
\*---------------------------------------------------------------------------*/
 
#include "singleStepReaction.H"
#include "fvmSup.H"
 
// * * * * * * * * * * * * Protected Member Functions  * * * * * * * * * * * //
 
void Foam::reactionModels::singleStepReaction::calculateqFuel()
{
    const scalar Wu = thermo_.WiValue(fuelIndex_);
 
    forAll(reaction_.lhs(), i)
    {
        const label speciei = reaction_.lhs()[i].index;
        const scalar stoichCoeff = reaction_.lhs()[i].stoichCoeff;
        specieStoichCoeffs_[speciei] = -stoichCoeff;
        qFuel_.value() +=
            thermo_.hfiValue(speciei)*thermo_.WiValue(speciei)*stoichCoeff/Wu;
    }
 
    forAll(reaction_.rhs(), i)
    {
        const label speciei = reaction_.rhs()[i].index;
        const scalar stoichCoeff = reaction_.rhs()[i].stoichCoeff;
        specieStoichCoeffs_[speciei] = stoichCoeff;
        qFuel_.value() -=
            thermo_.hfiValue(speciei)*thermo_.WiValue(speciei)*stoichCoeff/Wu;
        specieProd_[speciei] = -1;
    }
 
    Info << "Fuel heat of reaction: " << qFuel_.value() << endl;
}
 
 
void Foam::reactionModels::singleStepReaction::massAndAirStoichRatios()
{
    const label O2Index = thermo_.species()["O2"];
    const scalar Wu = thermo_.WiValue(fuelIndex_);
 
    stoicRatio_ =
        (
            thermo_.WiValue(thermo_.defaultSpecie())
           *specieStoichCoeffs_[thermo_.defaultSpecie()]
          + thermo_.WiValue(O2Index)*mag(specieStoichCoeffs_[O2Index])
        )/(Wu*mag(specieStoichCoeffs_[fuelIndex_]));
 
    s_ = thermo_.WiValue(O2Index)*mag(specieStoichCoeffs_[O2Index])
        /(Wu*mag(specieStoichCoeffs_[fuelIndex_]));
 
    Info << "stoichiometric air-fuel ratio: " << stoicRatio_.value() << endl;
    Info << "stoichiometric oxygen-fuel ratio: " << s_.value() << endl;
}
 
 
void Foam::reactionModels::singleStepReaction::calculateMaxProducts()
{
    scalar Wm = 0.0;
    scalar totalMol = 0.0;
    forAll(reaction_.rhs(), i)
    {
        label speciei = reaction_.rhs()[i].index;
        totalMol += mag(specieStoichCoeffs_[speciei]);
    }
 
    scalarList Xi(reaction_.rhs().size());
 
    forAll(reaction_.rhs(), i)
    {
        const label speciei = reaction_.rhs()[i].index;
        Xi[i] = mag(specieStoichCoeffs_[speciei])/totalMol;
        Wm += Xi[i]*thermo_.WiValue(speciei);
    }
 
    forAll(reaction_.rhs(), i)
    {
        const label speciei = reaction_.rhs()[i].index;
        Yprod0_[speciei] =  thermo_.WiValue(speciei)/Wm*Xi[i];
    }
 
    Info << "Maximum products mass concentrations: " << nl;
    forAll(Yprod0_, i)
    {
        if (Yprod0_[i] > 0)
        {
            Info<< "    " << thermo_.species()[i] << ": " << Yprod0_[i] << nl;
        }
    }
 
    // Normalise the stoichiometric coeff to mass
    forAll(specieStoichCoeffs_, i)
    {
        specieStoichCoeffs_[i] =
            specieStoichCoeffs_[i]*thermo_.WiValue(i)
           /(thermo_.WiValue(fuelIndex_)*mag(specieStoichCoeffs_[fuelIndex_]));
    }
}
 
 
// * * * * * * * * * * * * * * * * Constructors  * * * * * * * * * * * * * * //
 
Foam::reactionModels::singleStepReaction::singleStepReaction
(
    const word& modelType,
    const fluidMulticomponentThermo& thermo,
    const compressibleMomentumTransportModel& turb,
    const word& reactionProperties
)
:
    reactionModel(modelType, thermo, turb, reactionProperties),
    reaction_(thermo_.species(), this->subDict("reaction")),
    stoicRatio_(dimensionedScalar("stoicRatio", dimless, 0)),
    s_(dimensionedScalar("s", dimless, 0)),
    qFuel_(dimensionedScalar("qFuel", sqr(dimVelocity), 0)),
    specieStoichCoeffs_(thermo_.species().size(), 0.0),
    Yprod0_(thermo_.species().size(), 0.0),
    fres_(Yprod0_.size()),
    fuelIndex_(thermo_.species()[thermo.properties().lookup("fuel")]),
    specieProd_(Yprod0_.size(), 1),
    wFuel_
    (
        IOobject
        (
            this->thermo().phasePropertyName("wFuel"),
            this->mesh().time().name(),
            this->mesh(),
            IOobject::NO_READ,
            IOobject::NO_WRITE
        ),
        this->mesh(),
        dimensionedScalar(dimMass/dimVolume/dimTime, 0)
    ),
    semiImplicit_(readBool(this->coeffs_.lookup("semiImplicit")))
{
    forAll(fres_, fresI)
    {
        IOobject header
        (
            "fres_" + thermo_.species()[fresI],
            this->mesh().time().name(),
            this->mesh()
        );
 
        fres_.set
        (
            fresI,
            new volScalarField
            (
                header,
                this->mesh(),
                dimensionedScalar("fres" + Foam::name(fresI), dimless, 0)
            )
        );
    }
 
    calculateqFuel();
 
    massAndAirStoichRatios();
 
    calculateMaxProducts();
 
    if (semiImplicit_)
    {
        Info<< "Reaction mode: semi-implicit" << endl;
    }
    else
    {
        Info<< "Reaction mode: explicit" << endl;
    }
}
 
 
// * * * * * * * * * * * * * * * * Destructor  * * * * * * * * * * * * * * * //
 
Foam::reactionModels::singleStepReaction::~singleStepReaction()
{}
 
 
// * * * * * * * * * * * * * * Member Functions  * * * * * * * * * * * * * * //
 
Foam::tmp<Foam::volScalarField::Internal>
Foam::reactionModels::singleStepReaction::R(const label speciei) const
{
    return wFuel_()*specieStoichCoeffs()[speciei];
}
 
 
Foam::tmp<Foam::fvScalarMatrix>
Foam::reactionModels::singleStepReaction::R(volScalarField& Y) const
{
    const label specieI = thermo_.species()[Y.member()];
 
    volScalarField wSpecie
    (
        wFuel_*specieStoichCoeffs()[specieI]
    );
 
    if (semiImplicit_)
    {
        const label fNorm = specieProd()[specieI];
        const volScalarField fres(this->fres(specieI));
        wSpecie /= max(fNorm*(Y - fres), scalar(1e-2));
 
        return -fNorm*wSpecie*fres + fNorm*fvm::Sp(wSpecie, Y);
    }
    else
    {
        return wSpecie + fvm::Sp(0.0*wSpecie, Y);
    }
}
 
 
Foam::tmp<Foam::volScalarField>
Foam::reactionModels::singleStepReaction::Qdot() const
{
    const label fuelI = fuelIndex();
    volScalarField& YFuel =
        const_cast<volScalarField&>(this->thermo().Y(fuelI));
 
    return -qFuel()*(R(YFuel) & YFuel);
}
 
 
bool Foam::reactionModels::singleStepReaction::read()
{
    if (reactionModel::read())
    {
        return true;
    }
    else
    {
        return false;
    }
}
 
 
void Foam::reactionModels::singleStepReaction::fresCorrect()
{
    const label O2Index = thermo_.species()["O2"];
    const volScalarField& YFuel = thermo_.Y()[fuelIndex_];
    const volScalarField& YO2 = thermo_.Y()[O2Index];
 
    // reactants
    forAll(reaction_.lhs(), i)
    {
        const label speciei = reaction_.lhs()[i].index;
        if (speciei == fuelIndex_)
        {
            fres_[speciei] = max(YFuel - YO2/s_, scalar(0));
        }
        else if (speciei == O2Index)
        {
            fres_[speciei] = max(YO2 - YFuel*s_, scalar(0));
        }
    }
 
    // products
    forAll(reaction_.rhs(), i)
    {
        const label speciei = reaction_.rhs()[i].index;
        if (speciei != thermo_.defaultSpecie())
        {
            forAll(fres_[speciei], celli)
            {
                if (fres_[fuelIndex_][celli] > 0.0)
                {
                    // rich mixture
                    fres_[speciei][celli] =
                        Yprod0_[speciei]
                      * (1.0 + YO2[celli]/s_.value() - YFuel[celli]);
                }
                else
                {
                    // lean mixture
                    fres_[speciei][celli] =
                        Yprod0_[speciei]
                      * (
                            1.0
                          - YO2[celli]/s_.value()*stoicRatio_.value()
                          + YFuel[celli]*stoicRatio_.value()
                        );
                }
            }
        }
    }
}
 
 
// ************************************************************************* //