ccmSolutionTable.H

Go to the documentation of this file.

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | www.openfoam.com
     \\/     M anipulation  |
-------------------------------------------------------------------------------
    Copyright (C) 2016-2025 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/>.

Description
    Containers for holding ccm solution and field listings.

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

#ifndef Foam_ccmSolutionTable_H
#define Foam_ccmSolutionTable_H

#include "SLList.H"
#include "Ostream.H"
#include "wordRes.H"

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

namespace Foam
{
namespace ccm
{

// Forward Declarations
class fieldEntry;
class fieldTable;
class solutionEntry;

Ostream& operator<<(Ostream& os, const fieldEntry& entry);
Ostream& operator<<(Ostream& os, const fieldTable& entry);
Ostream& operator<<(Ostream& os, const solutionEntry& entry);

/*---------------------------------------------------------------------------*\
                    Class Foam::ccm::namesList Declaration
\*---------------------------------------------------------------------------*/

//- A linked-list that is searchable by the 'name()' of the items
template<class Type>
class namesList
:
    public SLList<Type>
{
public:

    using const_iterator = typename SLList<Type>::const_iterator;
    using iterator = typename SLList<Type>::iterator;


    // Constructors

        //- Default construct
        namesList() = default;


    // Access

        //- True if a list element has a name that matches key
        bool found(const word& key) const
        {
            for (const Type& item : *this)
            {
                if (item.name() == key)
                {
                    return true;
                }
            }

            return false;
        }


        //- Find list element by name
        iterator find(const word& key)
        {
            const auto last = SLList<Type>::end();

            iterator iter = SLList<Type>::begin();

            for (; (iter != last); ++iter)
            {
                if ((*iter).name() == key)
                {
                    break;
                }
            }

            return iter;
        }


        //- Return a list of names in allow-list and not in deny-list
        List<word> findNames
        (
            const wordRes& allow,
            const wordRes& deny = wordRes()
        ) const
        {
            List<word> matched(SLList<Type>::size());

            label count = 0;

            for (const Type& item : *this)
            {
                const word& name = item.name();

                if (allow.match(name) && !deny.match(name))
                {
                    matched[count] = name;
                    ++count;
                }
            }

            matched.resize(count);
            return matched;
        }
};


/*---------------------------------------------------------------------------*\
                    Class Foam::ccm::fieldEntry Declaration
\*---------------------------------------------------------------------------*/

//- A ccm field entry with short name, name, maxId and type
//  shortName => ( fullName, maxId, type );
class fieldEntry
{
    // Private Data

        //- The field name (PROSTAR short name)
        word name_;

        //- The full field name
        string fullName_;

        //- The field units
        string units_;

        //- The max cell id for the field
        label maxCellId_;

        //- The max face id for the field
        label maxFaceId_;

public:

    // Constructors

        //- Construct from components with optional units
        fieldEntry
        (
            const word& shortName,
            const string& fullName,
            const char* units = nullptr
        )
        :
            name_(shortName),
            fullName_(fullName),
            units_(),
            maxCellId_(0),
            maxFaceId_(0)
        {
            if (units && *units)
            {
                units_ = units;
            }
        }


    // Access

        //- The field name (PROSTAR short name)
        const word& name() const noexcept { return name_; }

        //- The full field name
        const string& fullName() const noexcept { return fullName_; }

        //- The field units
        const string& units() const noexcept { return units_; }

        //- The max cell id for the field
        label maxCellId() const noexcept { return maxCellId_; }

        //- The max face id for the field
        label maxFaceId() const noexcept { return maxFaceId_; }


    // Edit

        //- Set the field units
        void units(const std::string& units)
        {
            if (!units.empty())
            {
                units_ = units;
            }
        }

        //- Set the max cell Id for the field
        void maxCellId(const int val)
        {
            if (maxCellId_ < val)
            {
                maxCellId_ = val;
            }
        }


        //- Set the max face Id for the field
        void maxFaceId(const int val)
        {
            if (maxFaceId_ < val)
            {
                maxFaceId_ = val;
            }
        }


    // IOstream Operators

        friend Ostream& operator<<
        (
            Ostream& os,
            const fieldEntry& entry
        )
        {
            os  << entry.name_ << " => " << entry.fullName_
                << " [" << entry.units_.c_str()
                << "] maxCell: " << entry.maxCellId_
                << " maxFace: " << entry.maxFaceId_;

            return os;
        }
};


/*---------------------------------------------------------------------------*\
                  Class Foam::ccm::solutionEntry Declaration
\*---------------------------------------------------------------------------*/

//- A ccm solution entry with name, iteration and time
//  stateName => ( iteration, time );
class solutionEntry
{
    // Private Data

        //- The solution name
        word name_;

        //- The solution iteration/timestep
        label iter_;

        //- The solution time (sec)
        scalar time_;

public:

    // Constructors

        //- Construct from components
        solutionEntry
        (
            const word& name,
            const label iteration,
            const scalar timeValue = 0
        )
        :
            name_(name),
            iter_(iteration),
            time_(timeValue)
        {}


    // Access

        //- The solution name
        const word& name() const noexcept { return name_; }

        //- The solution iteration/timestep
        label iteration() const noexcept { return iter_; }

        //- The solution time (sec)
        scalar timeValue() const noexcept { return time_; }


    // IOstream Operators

        friend Ostream& operator<<
        (
            Ostream& os,
            const solutionEntry& entry
        )
        {
            os  << entry.name_ << " =>"
                << " iter: " << entry.iter_
                << " time: " << entry.time_;

            return os;
        }
};


/*---------------------------------------------------------------------------*\
                  Class Foam::ccm::solutionTable Declaration
\*---------------------------------------------------------------------------*/

// Typedef: ccm::solutionTable
// A list of all the available solutions
typedef namesList<solutionEntry> solutionTable;


/*---------------------------------------------------------------------------*\
                    Class Foam::ccm::fieldTable Declaration
\*---------------------------------------------------------------------------*/

//- A list of the available fields
class fieldTable
:
    public namesList<fieldEntry>
{
public:

    // Constructor

        //- Default construct
        fieldTable() = default;


    // Access

        //- The maximum cell Id referenced in the list
        label maxCellId() const
        {
            label result = 0;
            for (const auto& item : *this)
            {
                const label val = item.maxCellId();

                if (result < val)
                {
                    result = val;
                }
            }

            return result;
        }


        //- The maximum face Id referenced in the list
        label maxFaceId() const
        {
            label result = 0;
            for (const auto& item : *this)
            {
                const label val = item.maxFaceId();

                if (result < val)
                {
                    result = val;
                }
            }

            return result;
        }


    // IOstream Operators

        friend Ostream& operator<<
        (
            Ostream& os,
            const fieldTable& tbl
        )
        {
            os  << static_cast<const namesList<fieldEntry>&>(tbl)
                << nl
                << "maxCell: "  << tbl.maxCellId()
                << " maxFace: " << tbl.maxFaceId();

            return os;
        }
};


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

} // End namespace ccm
} // End namespace Foam

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

#endif

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