sizeGroup.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) 2017-2023 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::diameterModels::sizeGroup
 
Description
    Single size class fraction field representing a fixed particle volume as
    defined by the user through the corresponding sphere equivalent diameter.
 
    If present, the field is read from the start time directory, e.g. during
    restart. Otherwise, it is constructed as a uniform field using the size
    class fraction value provided by the user. In the latter case, the boundary
    condition types are taken from the 'f.<phaseName>' field, which represents
    the sum of all size group fractions of a phase. The user specified value is
    also applied at fixed value boundary conditions and used as inlet value for
    mixed boundary conditions.
 
    An alternative diameter field is provided by the selected shape model, e.g.
    a collisional diameter, which is then utilised in selected population
    balance submodels, e.g. for modelling fractal aggregation.
 
Usage
    \table
        Property     | Description                | Required    | Default value
        dSph         | Sphere equivalent diameter | yes         | none
        value        | Initial and boundary condition value of\\
                       size class fraction        | yes         | none
        shapeModel   | Shape model providing an alternative diameter field\\
                                                  | yes         | none
    \endtable
 
See also
    Foam::diameterModels::populationBalanceModel
    Foam::diameterModels::velocityGroup
    Foam::diameterModels::shapeModel
 
SourceFiles
    sizeGroup.C
 
\*---------------------------------------------------------------------------*/
 
#ifndef sizeGroup_H
#define sizeGroup_H
 
#include "dictionaryEntry.H"
#include "velocityGroup.H"
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
namespace Foam
{
namespace diameterModels
{
 
class shapeModel;
 
/*---------------------------------------------------------------------------*\
                          Class sizeGroup Declaration
\*---------------------------------------------------------------------------*/
 
class sizeGroup
:
    public volScalarField
{
private:
 
    // Private Data
 
        dictionary dict_;
 
        //- Phase this  sizeGroup belongs to
        const phaseModel& phase_;
 
        //- VelocityGroup this sizeGroup belongs to
        const velocityGroup& velocityGroup_;
 
        //- Sphere equivalent diameter of the sizeGroup
        const dimensionedScalar dSph_;
 
        //- Representative volume of the sizeGroup
        const dimensionedScalar x_;
 
        //- Initial value and value at boundaries
        const scalar value_;
 
        //- Label of this sizeGroup within the corresponding populationBalance
        mutable autoPtr<label> i_;
 
        //- Model for describing the representative shape of the elements in the
        //  sizeGroup
        autoPtr<shapeModel> shapeModel_;
 
 
public:
 
    // Constructors
 
        sizeGroup
        (
            const word& name,
            const dictionary& dict,
            const phaseModel& phase,
            const velocityGroup& velocityGroup,
            const fvMesh& mesh
        );
 
        //- Return clone
        autoPtr<sizeGroup> clone() const;
 
        //- Return a pointer to a new sizeGroup created on freestore
        //  from Istream
        class iNew
        {
            const phaseModel& phase_;
            const velocityGroup& velocityGroup_;
 
        public:
 
            iNew
            (
                const phaseModel& phase,
                const velocityGroup& velocityGroup
            )
            :
                phase_(phase),
                velocityGroup_(velocityGroup)
            {}
 
            autoPtr<sizeGroup> operator()(Istream& is) const
            {
                dictionaryEntry ent(dictionary::null, is);
                return autoPtr<sizeGroup>
                (
                    new sizeGroup
                    (
                        ent.keyword(),
                        ent,
                        phase_,
                        velocityGroup_,
                        phase_.mesh()
                    )
                );
            }
        };
 
 
    //- Destructor
    virtual ~sizeGroup();
 
 
    // Member Functions
 
        //- Return const-reference to the dictionary
        inline const dictionary& dict() const;
 
        //- Return const-reference to the phase
        inline const phaseModel& phase() const;
 
        //- Return const-reference to the velocityGroup
        inline const velocityGroup& VelocityGroup() const;
 
        //- Return representative spherical diameter of the sizeGroup
        inline const dimensionedScalar& dSph() const;
 
        //- Return representative volume of the sizeGroup
        inline const dimensionedScalar& x() const;
 
        //- Return reference to diameterModel of the phase
        inline autoPtr<shapeModel>& shapeModelPtr();
 
        //- Return const-reference to diameterModel of the phase
        inline const autoPtr<shapeModel>& shapeModelPtr() const;
 
        //- Return index of the size group within the population balance
        const label& i() const;
 
        //- Return representative surface area of the sizeGroup
        const tmp<volScalarField> a() const;
 
        //- Return representative diameter of the sizeGroup
        const tmp<volScalarField> d() const;
 
        //- Correct secondary properties
        void correct();
};
 
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
} // End namespace diameterModels
} // End namespace Foam
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
#include "sizeGroupI.H"
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
#endif
 
// ************************************************************************* //