RaviPetersen.H

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) 2013-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/>.
 
Class
    Foam::laminarFlameSpeedModels::RaviPetersen
 
Description
    Laminar flame speed obtained from Ravi and Petersen's correlation.
 
    The correlation for the laminar flame speed \f$Su\f$ is of the following
    form:
    \f[
        Su = \left( \sum \alpha_i \Phi^i \right)
        \left( \frac{T}{T_{ref}} \right)^{\left( \sum \beta_j \Phi^j \right)}
    \f]
 
    Where \f$\Phi\f$ is the equivalence ratio, and \f$\alpha\f$ and \f$\beta\f$
    are polynomial coefficients given for a number of pressure and equivalence
    ratio points.
 
SourceFiles
    RaviPetersen.C
 
\*---------------------------------------------------------------------------*/
 
#ifndef RaviPetersen_H
#define RaviPetersen_H
 
#include "laminarFlameSpeed.H"
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
namespace Foam
{
namespace laminarFlameSpeedModels
{
 
/*---------------------------------------------------------------------------*\
                        Class RaviPetersen Declaration
\*---------------------------------------------------------------------------*/
 
class RaviPetersen
:
    public laminarFlameSpeed
{
    // Private Data
 
        //- Correlation pressure values
        List<scalar> pPoints_;
 
        //- Correlation equivalence ratios
        List<scalar> PhiPoints_;
 
        //- Correlation alpha coefficients
        List<List<List<scalar>>> alpha_;
 
        //- Correlation beta coefficients
        List<List<List<scalar>>> beta_;
 
        //- Reference temperature
        scalar TRef_;
 
 
    // Private Member Functions
 
        //- Check that input points are ordered
        void checkPointsMonotonicity
        (
            const dictionary& coeffDict,
            const word& name,
            const List<scalar>& x
        ) const;
 
        //- Check that the coefficient arrays are of the correct shape
        void checkCoefficientArrayShape
        (
            const dictionary& coeffDict,
            const word& name,
            const List<List<List<scalar>>>& x
        ) const;
 
        //- Find and interpolate a value in the data point arrays
        inline bool interval
        (
            const List<scalar>& xPoints,
            const scalar x,
            label& xIndex,
            scalar& xXi,
            scalar& xLim
        ) const;
 
        //- Evaluate a polynomial
        inline scalar polynomial
        (
            const List<scalar>& coeffs,
            const scalar x
        ) const;
 
        //- Evaluate a polynomial differential
        inline scalar dPolynomial
        (
            const List<scalar>& coeffs,
            const scalar x
        ) const;
 
        //- Calculate normalised temperature to the power of the B polynomial
        inline scalar THatPowB
        (
            const label PhiIndex,
            const label pIndex,
            const scalar Phi,
            const scalar Tu
        ) const;
 
        //- Return the flame speed within the correlation range
        inline scalar correlationInRange
        (
            const label PhiIndex,
            const label pIndex,
            const scalar Phi,
            const scalar Tu
        ) const;
 
        //- Extrapolate the flame speed correlation outside its range
        inline scalar correlationOutOfRange
        (
            const label PhiIndex,
            const label pIndex,
            const scalar Phi,
            const scalar PhiLim,
            const scalar Tu
        ) const;
 
        //- Return the laminar flame speed [m/s]
        inline scalar Su0pTPhi
        (
            const scalar p,
            const scalar Tu,
            const scalar Phi
        ) const;
 
 
public:
 
    //- Runtime type information
    TypeName("RaviPetersen");
 
 
    // Constructors
 
        //- Construct from dictionary and uRhoMulticomponentThermo
        RaviPetersen
        (
            const dictionary& dict,
            const dictionary& coeffDict,
            const uRhoMulticomponentThermo&
        );
 
        //- Disallow default bitwise copy construction
        RaviPetersen(const RaviPetersen&) = delete;
 
 
    //- Destructor
    virtual ~RaviPetersen();
 
 
    // Member Functions
 
        //- Return the laminar flame speed [m/s]
        virtual tmp<volScalarField> Su
        (
            const volScalarField& p,
            const volScalarField& Tu,
            const volScalarField& Phi
        ) const;
 
        //- Return the laminar flame speed [m/s]
        //  including EGR effects
        virtual tmp<volScalarField> Su
        (
            const volScalarField& p,
            const volScalarField& Tu,
            const volScalarField& Phi,
            const volScalarField& egr
        ) const;
 
 
    // Member Operators
 
        //- Disallow default bitwise assignment
        void operator=(const RaviPetersen&) = delete;
};
 
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
} // End laminarFlameSpeedModels
} // End namespace Foam
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
#endif
 
// ************************************************************************* //