openfoam/src/OpenFOAM/matrices/schemes/schemesLookup.H

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | www.openfoam.com
     \\/     M anipulation  |
-------------------------------------------------------------------------------
    Copyright (C) 2011-2015 OpenFOAM Foundation
    Copyright (C) 2020-2022 OpenCFD Ltd.
-------------------------------------------------------------------------------
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::schemesLookup

Description
    Selector class for finite area/finite volume differencing schemes.

    The schemes data are treated as MUST_READ_IF_MODIFIED even if
    the requested readOption is nominally MUST_READ or READ_IF_PRESENT.
    This allows run-time modifications to behave as expected.

    The optional fallback dictionary content for constructors is used
    when a file is missing or for a NO_READ, with a null pointer being
    treated like an empty dictionary.

SourceFiles
    schemesLookup.C
    schemesLookupDetail.C

\*---------------------------------------------------------------------------*/

#ifndef Foam_schemesLookup_H
#define Foam_schemesLookup_H

#include "IOdictionary.H"

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

namespace Foam
{

/*---------------------------------------------------------------------------*\
                        Class schemesLookup Declaration
\*---------------------------------------------------------------------------*/

class schemesLookup
:
    public IOdictionary
{
    // Private Class

        //- Lightweight grouping of scheme dictionary and default
        struct lookupDetail
        {
            word name_;
            dictionary dict_;
            ITstream default_;


        // Constructors

            //- Construct empty with given sub-dictionary name
            lookupDetail
            (
                const word& dictName,
                const fileName& parentDictPath
            );


        // Member Functions

            //- Clear dictionary and default scheme
            void clear();

            //- Return the default scheme (if any)
            ITstream& fallback() const;

            //- Lookup named scheme from dictionary, or return default
            ITstream& lookup(const word& name) const;

            //- Populate dictionary and/or default
            void populate
            (
                const dictionary& dict,
                const word& defaultName,
                const bool mandatory = false
            );

            //- Write dictionary entry
            void writeEntry(Ostream& os) const;

            //- Write dictionary entry if non-empty
            void writeEntryOptional(Ostream& os) const;
        };


    // Private Data

        //- ddt
        lookupDetail ddtSchemes_;

        //- d2dt2
        lookupDetail d2dt2Schemes_;

        //- interpolation
        lookupDetail interpSchemes_;

        //- div
        lookupDetail divSchemes_;

        //- grad
        lookupDetail gradSchemes_;

        //- lnGrad (finiteArea)
        lookupDetail lnGradSchemes_;

        //- snGrad (finiteVolume)
        lookupDetail snGradSchemes_;

        //- laplacian
        lookupDetail laplacianSchemes_;

        //- flux
        mutable dictionary fluxRequired_;
        bool fluxRequiredDefault_;

        //- True if default ddtScheme is steady-state
        bool steady_;


    // Private Member Functions

        //- Clear dictionaries and streams before reading
        void clear();

        //- Check if default ddtScheme is steady-state
        void checkSteady();

        //- Read settings from the dictionary
        void read(const dictionary& dict);

        //- No copy construct
        schemesLookup(const schemesLookup&) = delete;

        //- No copy assignment
        void operator=(const schemesLookup&) = delete;


public:

    //- Debug switch
    static int debug;


    // Constructors

        //- Construct for objectRegistry, readOption, (system) dictionary name.
        schemesLookup
        (
            const objectRegistry& obr,
            IOobjectOption::readOption rOpt,
            const word& dictName,
            const dictionary* fallback = nullptr
        );

        //- Construct for objectRegistry, (system) dictionary name
        //- using the readOption from the registry.
        schemesLookup
        (
            const objectRegistry& obr,
            const word& dictName,
            const dictionary* fallback = nullptr
        );


    // Member Functions

        //- The current schemes dictionary, respects the "select" keyword
        const dictionary& schemesDict() const;

        //- True if default ddtScheme is steady-state
        bool steady() const noexcept
        {
            return steady_;
        }

        //- True if default ddtScheme is not steady-state
        bool transient() const noexcept
        {
            return !steady_;
        }


    // Lookup Access

        //- Get ddt scheme for given name, or default
        ITstream& ddtScheme(const word& name) const;

        //- Get d2dt2 scheme for given name, or default
        ITstream& d2dt2Scheme(const word& name) const;

        //- Get interpolation scheme for given name, or default
        ITstream& interpolationScheme(const word& name) const;

        //- Get div scheme for given name, or default
        ITstream& divScheme(const word& name) const;

        //- Get grad scheme for given name, or default
        ITstream& gradScheme(const word& name) const;

        //- Get (finiteArea) lnGrad scheme for given name, or default
        ITstream& lnGradScheme(const word& name) const;

        //- Get (finiteVolume) snGrad scheme for given name, or default
        ITstream& snGradScheme(const word& name) const;

        //- Get laplacian scheme for given name, or default
        ITstream& laplacianScheme(const word& name) const;

        //- Get flux-required for given name, or default
        void setFluxRequired(const word& name) const;

        //- Set flux-required for given name (mutable)
        bool fluxRequired(const word& name) const;


    // Read Access

        //- Access ddt schemes dictionary
        const dictionary& ddtSchemes() const noexcept
        {
            return ddtSchemes_.dict_;
        }

        //- Access d2dt2 schemes dictionary
        const dictionary& d2dt2Schemes() const noexcept
        {
            return d2dt2Schemes_.dict_;
        }

        //- Access interpolation schemes dictionary
        const dictionary& interpolationSchemes() const noexcept
        {
            return interpSchemes_.dict_;
        }

        //- Access div schemes dictionary
        const dictionary& divSchemes() const noexcept
        {
            return divSchemes_.dict_;
        }

        //- Access grad schemes dictionary
        const dictionary& gradSchemes() const noexcept
        {
            return gradSchemes_.dict_;
        }

        //- Access lnGrad schemes dictionary (finiteArea)
        const dictionary& lnGradSchemes() const noexcept
        {
            return lnGradSchemes_.dict_;
        }

        //- Access snGrad schemes dictionary (finiteVolume)
        const dictionary& snGradSchemes() const noexcept
        {
            return snGradSchemes_.dict_;
        }

        //- Access laplacian schemes dictionary
        const dictionary& laplacianSchemes() const noexcept
        {
            return laplacianSchemes_.dict_;
        }

        //- Access to flux required dictionary
        const dictionary& fluxRequired() const noexcept
        {
            return fluxRequired_;
        }


    // Edit Access

        //- Access ddt schemes dictionary
        dictionary& ddtSchemes() noexcept
        {
            return ddtSchemes_.dict_;
        }

        //- Access d2dt2 schemes dictionary
        dictionary& d2dt2Schemes() noexcept
        {
            return d2dt2Schemes_.dict_;
        }

        //- Access interpolation schemes dictionary
        dictionary& interpolationSchemes() noexcept
        {
            return interpSchemes_.dict_;
        }

        //- Access div schemes dictionary
        dictionary& divSchemes() noexcept
        {
            return divSchemes_.dict_;
        }

        //- Access grad schemes dictionary
        dictionary& gradSchemes() noexcept
        {
            return gradSchemes_.dict_;
        }

        //- Access lnGrad schemes dictionary (finiteArea)
        dictionary& lnGradSchemes() noexcept
        {
            return lnGradSchemes_.dict_;
        }

        //- Access snGrad schemes dictionary (finiteVolume)
        dictionary& snGradSchemes() noexcept
        {
            return snGradSchemes_.dict_;
        }

        //- Access laplacian schemes dictionary
        dictionary& laplacianSchemes() noexcept
        {
            return laplacianSchemes_.dict_;
        }

        //- Access to flux required dictionary
        dictionary& fluxRequired() noexcept
        {
            return fluxRequired_;
        }


    // Read

        //- Read schemes from IOdictionary, respects the "select" keyword
        bool read();


    // Write

        //- Write dictionary (possibly modified) settings
        void writeDicts(Ostream& os) const;
};


// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

} // End namespace Foam

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //

#endif

// ************************************************************************* //