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-2018 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 ccmSolutionTable_H
#define ccmSolutionTable_H
 
#include "SLList.H"
#include "Ostream.H"
#include "wordRes.H"
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
namespace Foam
{
namespace ccm
{
 
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 T>
class namesList
:
    public SLList<T>
{
public:
    using const_iterator = typename SLList<T>::const_iterator;
    using iterator = typename SLList<T>::iterator;
 
    // Constructors
 
        //- Null construct
        namesList()
        {}
 
 
    // Access
 
        //- Return true if a list element has a name that matches key
        bool found(const word& key) const
        {
            forAllConstIters(*this, iter)
            {
                if (iter().name() == key)
                {
                    return true;
                }
            }
 
            return false;
        }
 
 
        //- Find a list element has a name matching key
        iterator find(const word& key)
        {
            forAllIters(*this, iter)
            {
                if (iter().name() == key)
                {
                    return iter;
                }
            }
 
            return SLList<T>::end();
        }
 
 
        //- Return a list of names matching white-list and not in black-list
        List<word> findNames
        (
            const wordRes& white,
            const wordRes& black = wordRes()
        ) const
        {
            List<word> matched(SLList<T>::size());
 
            label matchi = 0;
            forAllConstIters(*this, iter)
            {
                const word& name = iter().name();
 
                if (white.match(name) && !black.match(name))
                {
                    matched[matchi++] = name;
                }
            }
            matched.setSize(matchi);
 
            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
        {
            return name_;
        }
 
        //- The full field name
        const string& fullName() const
        {
            return fullName_;
        }
 
        //- The field units
        const string& units() const
        {
            return units_;
        }
 
        //- The max cell id for the field
        label maxCellId() const
        {
            return maxCellId_;
        }
 
        //- The max face id for the field
        label maxFaceId() const
        {
            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 newMax)
        {
            if (maxCellId_ < newMax)
            {
                maxCellId_ = newMax;
            }
        }
 
 
        //- Set the max face Id for the field
        void maxFaceId(const int newMax)
        {
            if (maxFaceId_ < newMax)
            {
                maxFaceId_ = newMax;
            }
        }
 
 
    // 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
        {
            return name_;
        }
 
        //- The solution iteration/timestep
        label iteration() const
        {
            return iter_;
        }
 
        //- The solution time (sec)
        scalar timeValue() const
        {
            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
 
        //- Null construct
        fieldTable()
        :
            namesList<fieldEntry>()
        {}
 
 
    // Access
 
        //- The maximum cell Id referenced in the list
        label maxCellId() const
        {
            label maxId = 0;
            forAllConstIters(*this, iter)
            {
                const label currMax = iter().maxCellId();
 
                if (maxId < currMax)
                {
                    maxId = currMax;
                }
            }
 
            return maxId;
        }
 
 
        //- The maximum face Id referenced in the list
        label maxFaceId() const
        {
            label maxId = 0;
            forAllConstIters(*this, iter)
            {
                const label currMax = iter().maxFaceId();
 
                if (maxId < currMax)
                {
                    maxId = currMax;
                }
            }
 
            return maxId;
        }
 
 
    // 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
 
// ************************************************************************* //