fvMesh.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) 2011-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::fvMesh
 
Description
    Mesh data needed to do the Finite Volume discretisation.
 
    NOTE ON USAGE:
    fvMesh contains all the topological and geometric information
    related to the mesh.  It is also responsible for keeping the data
    up-to-date.  This is done by deleting the cell volume, face area,
    cell/face centre, addressing and other derived information as
    required and recalculating it as necessary.  The fvMesh therefore
    reserves the right to delete the derived information upon every
    topological (mesh refinement/morphing) or geometric change (mesh
    motion).  It is therefore unsafe to keep local references to the
    derived data outside of the time loop.
 
SourceFiles
    fvMesh.C
    fvMeshGeometry.C
 
\*---------------------------------------------------------------------------*/
 
#ifndef fvMesh_H
#define fvMesh_H
 
#include "polyMesh.H"
#include "surfaceMesh.H"
#include "lduMesh.H"
#include "primitiveMesh.H"
#include "fvBoundaryMesh.H"
#include "surfaceInterpolation.H"
#include "fvSchemes.H"
#include "fvSolution.H"
#include "DimensionedField.H"
#include "SlicedDimensionedField.H"
#include "volFieldsFwd.H"
#include "surfaceFieldsFwd.H"
#include "pointFieldsFwd.H"
#include "slicedVolFieldsFwd.H"
#include "slicedSurfaceFieldsFwd.H"
#include "className.H"
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
namespace Foam
{
 
class fvMeshLduAddressing;
class fvMeshStitcher;
class fvMeshTopoChanger;
class fvMeshDistributor;
class fvMeshMover;
class fvMesh;
class polyDistributionMap;
 
template<class Type>
class UCompactListList;
 
namespace fvMeshTopoChangers
{
    class list;
}
 
 
/*---------------------------------------------------------------------------*\
                           Class fvMesh Declaration
\*---------------------------------------------------------------------------*/
 
class fvMesh
:
    public polyMesh,
    public lduMesh,
    public surfaceMesh,
    public surfaceInterpolation
{
public:
 
    // Public data types
 
        //- Enumeration defining the state of the mesh after a read update.
        //  Used for post-processing applications, where the mesh
        //  needs to update based on the files written in time directories.
        enum readUpdateState
        {
            UNCHANGED,
            POINTS_MOVED,
            STITCHED,
            TOPO_CHANGE,
            TOPO_PATCH_CHANGE
        };
 
        //- Extent to which to stitch on read and readUpdate. By default, a
        //  full geometric stitch is performed. A non-geometric stitch can be
        //  done as an optimisation in situations when finite volume geometry
        //  is not needed (e.g., decomposition). Stitching can also be
        //  prevented altogether if that is appropriate (e.g., if the mesh is
        //  loaded for mapping in an un-stitched state).
        enum class stitchType
        {
            none,
            nonGeometric,
            geometric
        };
 
 
private:
 
    // Private Data
 
        //- Boundary mesh
        fvBoundaryMesh boundary_;
 
        //- The stitcher function class
        autoPtr<fvMeshStitcher> stitcher_;
 
        //- The topo-changer function class
        autoPtr<fvMeshTopoChanger> topoChanger_;
 
        //- The distributor function class
        autoPtr<fvMeshDistributor> distributor_;
 
        //- The mover function class
        autoPtr<fvMeshMover> mover_;
 
 
    // Demand-driven data
 
        //- Matrix addressing
        mutable fvMeshLduAddressing* lduPtr_;
 
        //- Face-poly-face IO
        mutable IOobject* polyFacesBfIOPtr_;
 
        //- Face-poly-face addressing
        mutable GeometricBoundaryField<label, surfaceMesh>* polyFacesBfPtr_;
 
        //- Offsets for poly-bFace-patch and patch-face addressing
        mutable labelList* polyBFaceOffsetsPtr_;
 
        //- Poly-bFace-patch addressing
        mutable labelList* polyBFaceOffsetPatchesPtr_;
 
        //- Poly-bFace-patch-face addressing
        mutable labelList* polyBFaceOffsetPatchFacesPtr_;
 
        //- Poly-bFace-patch addressing
        mutable UCompactListList<label>* polyBFacePatchesPtr_;
 
        //- Poly-bFace-patch-face addressing
        mutable UCompactListList<label>* polyBFacePatchFacesPtr_;
 
        //- Face-owner addressing
        mutable GeometricBoundaryField<label, surfaceMesh>* ownerBfPtr_;
 
        //- Current time index for cell volumes
        //  Note.  The whole mechanism will be replaced once the
        //  dimensionedField is created and the dimensionedField
        //  will take care of the old-time levels.
        mutable label curTimeIndex_;
 
        //- Cell volumes
        mutable SlicedDimensionedField<scalar, fvMesh>* VPtr_;
 
        //- Cell volumes old time level
        mutable DimensionedField<scalar, fvMesh>* V0Ptr_;
 
        //- Cell volumes old-old time level
        mutable DimensionedField<scalar, fvMesh>* V00Ptr_;
 
        //- Face area vectors
        mutable slicedSurfaceVectorField* SfSlicePtr_;
 
        //- Face area vectors
        mutable surfaceVectorField* SfPtr_;
 
        //- Mag face area vectors
        mutable slicedSurfaceScalarField* magSfSlicePtr_;
 
        //- Mag face area vectors
        mutable surfaceScalarField* magSfPtr_;
 
        //- Cell centres
        mutable slicedVolVectorField* CSlicePtr_;
 
        //- Cell centres
        mutable volVectorField* CPtr_;
 
        //- Face centres
        mutable slicedSurfaceVectorField* CfSlicePtr_;
 
        //- Face centres
        mutable surfaceVectorField* CfPtr_;
 
        //- Face motion fluxes
        mutable surfaceScalarField* phiPtr_;
 
        //- fvSchemes created on demand
        mutable autoPtr<fvSchemes> fvSchemes_;
 
        //- fvSolution created on demand
        mutable autoPtr<fvSolution> fvSolution_;
 
 
    // Private Member Functions
 
        // Storage management
 
            //- Clear FV geometry but not the old-time cell volumes
            void clearFvGeomNotOldVol();
 
            //- Clear FV geometry
            void clearFvGeom();
 
            //- Clear geometry like clearGeomNotOldVol but recreate any
            //  geometric demand-driven data that was set
            void updateGeomNotOldVol();
 
            //- Store old times fields for all fields of a given type and class
            template<class Type, template<class> class GeoField>
            void storeOldTimeFields();
 
            //- Store old times fields for all fields of a given class
            template<template<class> class GeoField>
            void storeOldTimeFields();
 
            //- Store old times fields for all fields
            //  Used prior to field mapping following mesh-motion
            //  and NCC stitching
            void storeOldTimeFields();
 
            //- Null oldest time field for all fields of a given type and class
            template<class Type, template<class> class GeoField>
            void nullOldestTimeFields();
 
            //- Null oldest time field for all fields of a given class
            template<template<class> class GeoField>
            void nullOldestTimeFields();
 
            //- Null oldest time field for all fields
            //  Used prior to field mapping following mesh topology change
            void nullOldestTimeFields();
 
 
       // Make topological data
 
            //- Get the patch types for the poly faces field
            wordList polyFacesPatchTypes() const;
 
            //- Modify face-poly-face addressing
            GeometricBoundaryField<label, surfaceMesh>& polyFacesBfRef();
 
 
       // Make geometric data
 
            //- Make the face area vectors
            void makeSf() const;
 
            //- Make the mag face area vectors
            void makeMagSf() const;
 
            //- Make the cell centres
            void makeC() const;
 
            //- Make the face centres
            void makeCf() const;
 
            //- Modify cell face area vectors
            surfaceVectorField& SfRef();
 
            //- Modify cell face area magnitudes
            surfaceScalarField& magSfRef();
 
            //- Modify cell centres
            volVectorField& CRef();
 
            //- Modify face centres
            surfaceVectorField& CfRef();
 
            //- Modify cell face motion fluxes
            surfaceScalarField& phiRef();
 
 
public:
 
    // Public Typedefs
 
        typedef fvMesh Mesh;
        typedef fvBoundaryMesh BoundaryMesh;
 
        //- Zone type
        typedef cellZone Zone;
 
        //- Patch field type
        template<class Type>
        using PatchField = fvPatchField<Type>;
 
        //- Field source type
        template<class Type>
        using FieldSource = fvFieldSource<Type>;
 
        friend fvMeshTopoChangers::list;
 
 
    // Declare name of the class and its debug switch
    ClassName("fvMesh");
 
 
    // Static data
 
        //- Set of names of registered geometric fields
        //  Vc, Vc0, Vc00, Sf, magSf, C, Cf, meshPhi, meshPhi_0
        const static HashSet<word> geometryFields;
 
        //- Set of names of registered current-time geometric fields
        //  Vc, Sf, magSf, C, Cf
        const static HashSet<word> curGeometryFields;
 
 
    // Constructors
 
        //- Construct from IOobject.
        //  Optionally prevent post-construction, so that postConstruct may be
        //  called manually for finer control of construction of mesh changes
        //  and the level of stitching.
        //  Optionally prevent zone generation
        explicit fvMesh
        (
            const IOobject& io,
            const bool doPost = true
        );
 
        //- Construct from cellShapes with boundary.
        fvMesh
        (
            const IOobject& io,
            pointField&& points,
            const cellShapeList& shapes,
            const faceListList& boundaryFaces,
            const wordList& boundaryPatchNames,
            const PtrList<dictionary>& boundaryDicts,
            const word& defaultBoundaryPatchName,
            const word& defaultBoundaryPatchType,
            const bool syncPar = true
        );
 
        //- Construct from components without boundary.
        //  Boundary is added using addFvPatches() member function
        fvMesh
        (
            const IOobject& io,
            pointField&& points,
            faceList&& faces,
            labelList&& allOwner,
            labelList&& allNeighbour,
            const bool syncPar = true
        );
 
        //- Construct without boundary from cells rather than owner/neighbour.
        //  Boundary is added using addFvPatches() member function
        fvMesh
        (
            const IOobject& io,
            pointField&& points,
            faceList&& faces,
            cellList&& cells,
            const bool syncPar = true
        );
 
        //- Move constructor
        fvMesh(fvMesh&&);
 
        //- Disallow default bitwise copy construction
        fvMesh(const fvMesh&) = delete;
 
 
    //- Destructor
    virtual ~fvMesh();
 
 
    // Member Functions
 
        // Helpers
 
            //- Complete construction of the mesh
            void postConstruct
            (
                const bool changers,
                const bool zones,
                const stitchType stitch
            );
 
            //- Add boundary patches. Constructor helper
            void addFvPatches
            (
                const List<polyPatch*>&,
                const bool validBoundary = true
            );
 
            //- Update the mesh based on the mesh files saved in time
            //  directories
            readUpdateState readUpdate
            (
                const stitchType stitch = stitchType::geometric
            );
 
 
        // Access
 
            //- Return the top-level database
            const Time& time() const
            {
                return polyMesh::time();
            }
 
            //- Return the object registry - resolve conflict polyMesh/lduMesh
            virtual const objectRegistry& db() const
            {
                return polyMesh::db();
            }
 
            //- Return reference to name
            //  Note: name() is currently ambiguous due to derivation from
            //  surfaceInterpolation
            const word& name() const
            {
                return polyMesh::name();
            }
 
            //- Return reference to boundary mesh
            const fvBoundaryMesh& boundary() const;
 
            //- Return reference to polyMesh
            const polyMesh& poly() const
            {
                return *this;
            }
 
            //- Return reference to fvMesh for volFields GeoMesh argument
            const fvMesh& operator()() const
            {
                return *this;
            }
 
            //- Return fvMesh size
            label size() const
            {
                return nCells();
            }
 
            //- Return ldu addressing
            virtual const lduAddressing& lduAddr() const;
 
            //- Return a list of pointers for each patch
            //  with only those pointing to interfaces being set
            virtual lduInterfacePtrsList interfaces() const
            {
                return boundary().interfaces();
            }
 
            //- Return communicator used for parallel communication
            virtual label comm() const
            {
                return polyMesh::comm();
            }
 
            //- Internal face owner
            const labelUList& owner() const
            {
                return lduAddr().lowerAddr();
            }
 
            //- Internal face neighbour
            const labelUList& neighbour() const
            {
                return lduAddr().upperAddr();
            }
 
            //- Return whether the fvMesh is conformal with the polyMesh
            bool conformal() const;
 
            //- Return face-poly-face addressing
            const GeometricBoundaryField<label, surfaceMesh>&
                polyFacesBf() const;
 
            //- Return poly-bFace-patch addressing
            const UCompactListList<label>& polyBFacePatches() const;
 
            //- Return poly-bFace-patch-face addressing
            const UCompactListList<label>& polyBFacePatchFaces() const;
 
            //- Return face-owner addressing
            const GeometricBoundaryField<label, surfaceMesh>& ownerBf() const;
 
            //- Return the stitcher function class
            const fvMeshStitcher& stitcher() const;
 
            //- Return the stitcher function class
            fvMeshStitcher& stitcher();
 
            //- Return the topo-changer function class
            const fvMeshTopoChanger& topoChanger() const;
 
            //- Return the distributor function class
            const fvMeshDistributor& distributor() const;
 
            //- Return the mover function class
            const fvMeshMover& mover() const;
 
            //- Return cell volumes
            const DimensionedField<scalar, fvMesh>& V() const;
 
            //- Return old-time cell volumes
            const DimensionedField<scalar, fvMesh>& V0() const;
 
            //- Return old-old-time cell volumes
            const DimensionedField<scalar, fvMesh>& V00() const;
 
            //- Return sub-cycle cell volumes
            tmp<DimensionedField<scalar, fvMesh>> Vsc() const;
 
            //- Return sub-cycle old-time cell volumes
            tmp<DimensionedField<scalar, fvMesh>> Vsc0() const;
 
            //- Return cell face area vectors
            const surfaceVectorField& Sf() const;
 
            //- Return cell face area magnitudes
            const surfaceScalarField& magSf() const;
 
            //- Return cell face normal vectors
            tmp<surfaceVectorField> nf() const;
 
            //- Return cell centres
            const volVectorField& C() const;
 
            //- Return face centres
            const surfaceVectorField& Cf() const;
 
            //- Return face deltas as surfaceVectorField
            tmp<surfaceVectorField> delta() const;
 
            //- Return cell face motion fluxes
            const surfaceScalarField& phi() const;
 
            //- Return the list of fields of type GeoField
            //  i.e. fields that are not geometry
            template<class GeoField>
            UPtrList<GeoField> fields
            (
                bool strict = false,
                const HashSet<word>& geometryFields = fvMesh::geometryFields
            ) const;
 
            //- Return the list of current fields of type GeoField
            //  i.e. fields that are not old-times or geometry
            template<class GeoField>
            UPtrList<GeoField> curFields
            (
                const bool strict = false,
                const HashSet<word>& geometryFields = fvMesh::geometryFields
            ) const;
 
            //- Lookup a dimensioned field for this geometry
            template<class Type>
            tmp<DimensionedField<Type, fvMesh>> lookupField(const word&) const;
 
            //- Return a labelType of valid component indicators
            //  1 : valid (solved)
            // -1 : invalid (not solved)
            template<class Type>
            typename pTraits<Type>::labelType validComponents() const;
 
            //- Return the fvSchemes
            const fvSchemes& schemes() const;
 
            //- Return the fvSolution
            const fvSolution& solution() const;
 
 
        // Edit
 
            //- Does the mesh topology change?
            bool topoChanging() const;
 
            //- Does the mesh get redistributed?
            bool distributing() const;
 
            //- Is this mesh dynamic?
            bool dynamic() const;
 
            //- Has the mesh topology changed this time-step?
            //  Note the additional condition vs the polyMesh. The
            //  finite-volume topology changes if the stitcher changes the
            //  non-conformal faces.
            bool topoChanged() const
            {
                return poly().topoChanged() || (moving() && !conformal());
            }
 
            //- Update the mesh for topology change, mesh to mesh mapping
            //  or redistribution
            bool update();
 
            //- Move the mesh
            bool move();
 
            //- Print a list of all the currently allocated mesh data
            void printAllocated() const;
 
            //- Clear geometry
            void clearGeom();
 
            //- Clear addressing
            void clearAddressing(const bool isMeshUpdate = false);
 
            //- Clear all geometry and addressing
            void clearOut();
 
            //- Prepare for a mesh change
            void preChange();
 
            //- Update mesh corresponding to the given map
            virtual void topoChange(const polyTopoChangeMap& map);
 
            //- Update from another mesh using the given map
            virtual void mapMesh(const polyMeshMap&);
 
            //- Redistribute or update using the given distribution map
            virtual void distribute(const polyDistributionMap& map);
 
            //- Reset the points
            //  without storing old points or returning swept volumes
            virtual void setPoints(const pointField&);
 
            //- Move points, returns volumes swept by faces in motion
            virtual tmp<scalarField> movePoints(const pointField&);
 
            //- Get the current instance for the poly faces boundary field
            const fileName& polyFacesBfInstance() const;
 
            //- Set the instance for the poly faces boundary field
            void setPolyFacesBfInstance(const fileName&);
 
            //- Conform the fvMesh to the polyMesh
            void conform
            (
                const surfaceScalarField& phi =
                    NullObjectRef<surfaceScalarField>()
            );
 
            //- Unconform the fvMesh from the polyMesh
            void unconform
            (
                const GeometricBoundaryField<label, surfaceMesh>& polyFacesBf,
                const surfaceVectorField& Sf,
                const surfaceVectorField& Cf,
                const surfaceScalarField& phi =
                    NullObjectRef<surfaceScalarField>(),
                const bool sync = true
            );
 
            //- Map all fields in time using given map.
            void mapFields(const polyTopoChangeMap& map);
 
            //- Add/insert single patch
            virtual void addPatch
            (
                const label insertPatchi,
                const polyPatch& patch
            );
 
            //- Reorder and trim existing patches. If validBoundary the new
            //  situation is consistent across processors
            virtual void reorderPatches
            (
                const labelUList& newToOld,
                const bool validBoundary
            );
 
            //- Remove boundary patches. Warning: fvPatchFields hold ref to
            //  these fvPatches.
            void removeFvBoundary();
 
            //- Swap mesh
            //  For run-time mesh replacement and mesh to mesh mapping
            void swap(fvMesh&);
 
 
        // Write
 
            //- Write the mesh data and all objects in the registry
            virtual bool writeObject
            (
                IOstream::streamFormat fmt,
                IOstream::versionNumber ver,
                IOstream::compressionType cmp,
                const bool write = true
            ) const;
 
            //- Write the mesh data only
            virtual bool writeMesh() const;
 
 
    // Member Operators
 
        //- Disallow default bitwise assignment
        void operator=(const fvMesh&) = delete;
 
        bool operator!=(const fvMesh&) const;
 
        bool operator==(const fvMesh&) const;
};
 
 
template<>
typename pTraits<sphericalTensor>::labelType
fvMesh::validComponents<sphericalTensor>() const;
 
//- Cast the give dictionary to the corresponding region fvMesh
//  Useful for \#codeStream in the context of field initialisation
const fvMesh& region(const dictionary& dict);
 
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
} // End namespace Foam
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
#include "surfaceMeshI.H"
 
#ifdef NoRepository
    #include "fvMeshTemplates.C"
#endif
 
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
#endif
 
// ************************************************************************* //