DemandDrivenMeshObject< Mesh, MeshObjectType, Type > Class Template Reference

Templated abstract base-class for demand-driven mesh objects used to automate their allocation to the mesh database and the mesh-modifier event-loop. More...

Inheritance diagram for DemandDrivenMeshObject< Mesh, MeshObjectType, Type >:
Collaboration diagram for DemandDrivenMeshObject< Mesh, MeshObjectType, Type >:

Public Member Functions

virtual const wordtype () const
 Runtime type information. More...
 
virtual ~DemandDrivenMeshObject ()
 
const Mesh & mesh () const
 
virtual bool writeData (Foam::Ostream &) const
 Pure virtual writaData function. More...
 
- Public Member Functions inherited from regIOobject
 TypeName ("regIOobject")
 Runtime type information. More...
 
 regIOobject (const IOobject &, const bool isTime=false)
 Construct from IOobject. Optional flag for if IOobject is the. More...
 
 regIOobject (const regIOobject &)
 Copy constructor. More...
 
 regIOobject (const regIOobject &&)
 Move constructor. More...
 
 regIOobject (const regIOobject &, bool registerCopy)
 Copy constructor, transferring registry registration to copy. More...
 
 regIOobject (const word &newName, const regIOobject &, bool registerCopy)
 Copy constructor with new name, transferring registry registration. More...
 
 regIOobject (const IOobject &, const regIOobject &)
 Copy constructor with new IO parameters. More...
 
virtual ~regIOobject ()
 Destructor. More...
 
virtual bool global () const
 Return true if object is global, i.e. same for all processors. More...
 
virtual bool globalFile () const
 Return true if object is global, i.e. same for all processors. More...
 
const fileNamecaseName () const
 
fileName path () const
 Return complete path. More...
 
fileName objectPath () const
 Return complete path + object name. More...
 
fileName filePath () const
 Return complete path + object name if the file exists. More...
 
bool checkIn ()
 Add object to registry. More...
 
bool checkOut ()
 Remove object from registry. More...
 
void addWatch ()
 Add file watch on object (if registered and READ_IF_MODIFIED) More...
 
bool registered () const
 Is this object registered with the registry? More...
 
bool ownedByRegistry () const
 Is this object owned by the registry? More...
 
void store ()
 Transfer ownership of this object to its registry. More...
 
void release ()
 Release ownership of this object from its registry. More...
 
label eventNo () const
 Event number at last update. More...
 
labeleventNo ()
 Event number at last update. More...
 
bool upToDate (const regIOobject &) const
 Return true if up-to-date with respect to given object. More...
 
bool upToDate (const regIOobject &, const regIOobject &) const
 Return true if up-to-date with respect to given objects. More...
 
bool upToDate (const regIOobject &, const regIOobject &, const regIOobject &) const
 Return true if up-to-date with respect to given objects. More...
 
bool upToDate (const regIOobject &, const regIOobject &, const regIOobject &, const regIOobject &) const
 Return true if up-to-date with respect to given objects. More...
 
void setUpToDate ()
 Set up to date (obviously) More...
 
virtual void rename (const word &newName)
 Rename. More...
 
bool headerOk ()
 Read and check header info. More...
 
IstreamreadStream (const word &, const bool read=true)
 Return Istream and check object type against that given. More...
 
void close ()
 Close Istream. More...
 
virtual bool readData (Istream &)
 Virtual readData function. More...
 
virtual bool read ()
 Read object. More...
 
const labelListwatchIndices () const
 Return file-monitoring handles. More...
 
labelListwatchIndices ()
 Return file-monitoring handles. More...
 
virtual bool modified () const
 Return true if the object's file (or files for objectRegistry) More...
 
virtual bool dependenciesModified () const
 Return true if the object's dependencies have been modified. More...
 
virtual bool readIfModified ()
 Read object if modified (as set by call to modified) More...
 
virtual bool writeObject (IOstream::streamFormat, IOstream::versionNumber, IOstream::compressionType, const bool write) const
 Write using given format, version and compression. More...
 
virtual bool write (const bool write=true) const
 Write using setting from DB. More...
 
void operator= (const IOobject &)
 Assign to IOobject. More...
 
void operator= (const regIOobject &)=delete
 Disallow default assignment. More...
 
const fileNamecaseName (const bool global) const
 
fileName path (const bool global) const
 Return complete path including the processor sub-directory. More...
 
fileName objectPath (const bool global) const
 Return complete path + object name including the processor. More...
 
fileName filePath (const word &typeName, const bool global) const
 Return complete path + object name if the file exists. More...
 
- Public Member Functions inherited from IOobject
 TypeName ("IOobject")
 Runtime type information. More...
 
 IOobject (const word &name, const fileName &instance, const objectRegistry &registry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true)
 Construct from name, instance, registry, io options. More...
 
 IOobject (const word &name, const fileName &instance, const fileName &local, const objectRegistry &registry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true)
 Construct from name, instance, local, registry, io options. More...
 
 IOobject (const fileName &path, const objectRegistry &registry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true)
 Construct from path, registry, io options. More...
 
 IOobject (const IOobject &io, const objectRegistry &registry)
 Construct from copy resetting registry. More...
 
 IOobject (const IOobject &io, const word &name)
 Construct from copy resetting name. More...
 
 IOobject (const IOobject &io)=default
 Copy constructor. More...
 
autoPtr< IOobjectclone () const
 Clone. More...
 
autoPtr< IOobjectclone (const objectRegistry &registry) const
 Clone resetting registry. More...
 
virtual ~IOobject ()
 Destructor. More...
 
const Timetime () const
 Return time. More...
 
const objectRegistrydb () const
 Return the local objectRegistry. More...
 
const wordname () const
 Return name. More...
 
const wordheaderClassName () const
 Return name of the class name read from header. More...
 
wordheaderClassName ()
 Return name of the class name read from header. More...
 
stringnote ()
 Return non-constant access to the optional note. More...
 
const stringnote () const
 Return the optional note. More...
 
bool & registerObject ()
 Register object created from this IOobject with registry if true. More...
 
bool registerObject () const
 Register object created from this IOobject with registry if true. More...
 
readOption readOpt () const
 
readOptionreadOpt ()
 
writeOption writeOpt () const
 
writeOptionwriteOpt ()
 
word group () const
 Return group (extension part of name) More...
 
word member () const
 Return member (name without the extension) More...
 
const fileNamerootPath () const
 
const fileNamecaseName (const bool global) const
 
fileNameinstance () const
 Return the instance directory, constant, system, <time> etc. More...
 
void updateInstance () const
 If the instance is a time directory update to the current time. More...
 
const fileNamelocal () const
 
fileName path (const bool global) const
 Return complete path including the processor sub-directory. More...
 
fileName objectPath (const bool global) const
 Return complete path + object name including the processor. More...
 
fileName relativePath () const
 Return the path relative to the case directory. More...
 
fileName relativeObjectPath () const
 Return complete relativePath + object name. More...
 
fileName filePath (const word &typeName, const bool global) const
 Return complete path + object name if the file exists. More...
 
bool readHeader (Istream &)
 Read header. More...
 
bool headerOk ()
 Read header of local object without type-checking. More...
 
template<class Type >
void warnNoRereading () const
 Helper: warn that type does not support re-reading. More...
 
bool writeHeader (Ostream &) const
 Write header. More...
 
bool writeHeader (Ostream &, const word &objectType) const
 Write header. Allow override of type. More...
 
bool good () const
 
bool bad () const
 
InfoProxy< IOobjectinfo () const
 Return info proxy. More...
 
void operator= (const IOobject &)
 
template<class Name >
Foam::word groupName (Name name, const word &group)
 

Static Public Member Functions

static Type & New (const word &name, const Mesh &mesh)
 Construct and return the named DemandDrivenMeshObject. More...
 
static Type & New (const Mesh &mesh)
 Construct and return the DemandDrivenMeshObject named Type::typeName. More...
 
template<class... Args>
static Type & New (const word &name, const Mesh &mesh, const Args &... args)
 Construct and return the named DemandDrivenMeshObject. More...
 
template<class... Args>
static Type & New (const Mesh &mesh, const Args &... args)
 Construct and return the DemandDrivenMeshObject named Type::typeName. More...
 
static bool found (const word &name, const Mesh &mesh)
 Return true if the DemandDrivenMeshObject with the given name. More...
 
static bool found (const Mesh &mesh)
 Return true if the DemandDrivenMeshObject named Type::typeName. More...
 
- Static Public Member Functions inherited from regIOobject
template<class Type >
static Type & store (Type *)
 Transfer ownership of the given object pointer to its registry. More...
 
template<class Type >
static Type & store (autoPtr< Type > &)
 Transfer ownership of the given object pointer to its registry. More...
 
- Static Public Member Functions inherited from IOobject
static bool fileNameComponents (const fileName &path, fileName &instance, fileName &local, word &name)
 Split path into instance, local, name components. More...
 
template<class Name >
static word groupName (Name name, const word &group)
 
static word group (const word &name)
 Return group (extension part of name) More...
 
static word member (const word &name)
 Return member (name without the extension) More...
 
template<class Stream >
static Stream & writeBanner (Stream &os, bool noHint=false)
 Write the standard OpenFOAM file/dictionary banner. More...
 
template<class Stream >
static Stream & writeDivider (Stream &os)
 Write the standard file section divider. More...
 
template<class Stream >
static Stream & writeEndDivider (Stream &os)
 Write the standard end file divider. More...
 

Protected Member Functions

 DemandDrivenMeshObject (const IOobject &io, const Mesh &mesh)
 Construct from mesh and IOobject. More...
 
 DemandDrivenMeshObject (const word &name, const Mesh &mesh)
 Construct from mesh and name. More...
 
 DemandDrivenMeshObject (const Mesh &mesh)
 Construct from mesh, the name is set to Type::typeName. More...
 
- Protected Member Functions inherited from regIOobject
bool readHeaderOk (const IOstream::streamFormat defaultFormat, const word &typeName)
 Read header, check readOpt flags and read data if necessary. More...
 
- Protected Member Functions inherited from IOobject
void setBad (const string &)
 Set the object state to bad. More...
 
template<class Type >
bool typeHeaderOk (const bool checkType)
 Read header using typeGlobalFile to find file. More...
 

Additional Inherited Members

- Public Types inherited from IOobject
enum  objectState { GOOD , BAD }
 Enumeration defining the valid states of an IOobject. More...
 
enum  readOption { MUST_READ , MUST_READ_IF_MODIFIED , READ_IF_PRESENT , NO_READ }
 Enumeration defining the read options. More...
 
enum  writeOption { AUTO_WRITE = 0 , NO_WRITE = 1 }
 Enumeration defining the write options. More...
 
enum  fileCheckTypes { timeStamp , timeStampMaster , inotify , inotifyMaster }
 Enumeration defining the file checking options. More...
 
- Static Public Attributes inherited from regIOobject
static float fileModificationSkew
 
- Static Public Attributes inherited from IOobject
static constexpr const char * foamFile = "FoamFile"
 Keyword for the FoamFile header sub-dictionary. More...
 
static const NamedEnum< fileCheckTypes, 4 > fileCheckTypesNames
 
static fileCheckTypes fileModificationChecking
 Type of file modification checking. More...
 

Detailed Description

template<class Mesh, template< class > class MeshObjectType, class Type>
class Foam::DemandDrivenMeshObject< Mesh, MeshObjectType, Type >

Templated abstract base-class for demand-driven mesh objects used to automate their allocation to the mesh database and the mesh-modifier event-loop.

DemandDrivenMeshObject is templated on the type of mesh it is allocated to, the type of the mesh object (DeletableMeshObject, MoveableMeshObject, DistributeableMeshObject, TopoChangeableMeshObject) and the type of the actual object it is created for example:

class leastSquaresVectors
:
    public DemandDrivenMeshObject
    <
        fvMesh,
        MoveableMeshObject,
        leastSquaresVectors
    >
{
.
.
.
    //! Delete the least square vectors when the mesh moves
    virtual bool movePoints();
};

MeshObject types:

  • DeletableMeshObject: mesh object to be deleted after any mesh change
  • MoveableMeshObject: mesh object to be updated after mesh motion otherwise deleted
  • DistributeableMeshObject mesh object to be updated after mesh redistribution or motion otherwise deleted
  • TopoChangeableMeshObject: mesh object to be updated after mesh topology change, mesh-to-mesh mapping, redistribution or motion otherwise deleted
  • RepatchableMeshObject: mesh object to be updated on patch or topology change, mesh-to-mesh mapping, redistribution or motion otherwise deleted

DemandDrivenMeshObject should always be constructed and accessed via the New methods provided so that they are held and maintained by the objectRegistry. To ensure this use constructors of the concrete derived types should be private or protected and friendship with the DemandDrivenMeshObject base-class declared so that the New functions can call the the constructors.

Source files

Definition at line 96 of file DemandDrivenMeshObject.H.

Constructor & Destructor Documentation

◆ DemandDrivenMeshObject() [1/3]

DemandDrivenMeshObject ( const IOobject io,
const Mesh &  mesh 
)
protected

Construct from mesh and IOobject.

Only derived classes can construct DemandDrivenMeshObject

Definition at line 32 of file DemandDrivenMeshObject.C.

◆ DemandDrivenMeshObject() [2/3]

DemandDrivenMeshObject ( const word name,
const Mesh &  mesh 
)
protected

Construct from mesh and name.

Only derived classes can construct DemandDrivenMeshObject

Definition at line 45 of file DemandDrivenMeshObject.C.

◆ DemandDrivenMeshObject() [3/3]

DemandDrivenMeshObject ( const Mesh &  mesh)
protected

Construct from mesh, the name is set to Type::typeName.

Only derived classes can construct DemandDrivenMeshObject

Definition at line 66 of file DemandDrivenMeshObject.C.

◆ ~DemandDrivenMeshObject()

Definition at line 204 of file DemandDrivenMeshObject.C.

References regIOobject::release().

Here is the call graph for this function:

Member Function Documentation

◆ type()

const Foam::word & type
virtual

Runtime type information.

Definition at line 215 of file DemandDrivenMeshObject.C.

Referenced by GAMGProcAgglomeration::New().

Here is the caller graph for this function:

◆ New() [1/4]

Type & New ( const word name,
const Mesh &  mesh 
)
static

◆ New() [2/4]

Type & New ( const Mesh &  mesh)
static

Construct and return the DemandDrivenMeshObject named Type::typeName.

Definition at line 109 of file DemandDrivenMeshObject.C.

◆ New() [3/4]

Type & New ( const word name,
const Mesh &  mesh,
const Args &...  args 
)
static

Construct and return the named DemandDrivenMeshObject.

with the additional arguments

Definition at line 139 of file DemandDrivenMeshObject.C.

◆ New() [4/4]

Type & New ( const Mesh &  mesh,
const Args &...  args 
)
static

Construct and return the DemandDrivenMeshObject named Type::typeName.

with the additional arguments

Definition at line 172 of file DemandDrivenMeshObject.C.

References args, Foam::endl(), found, OSstream::name(), Foam::Pout, and regIOobject::store().

Here is the call graph for this function:

◆ found() [1/2]

bool found ( const word name,
const Mesh &  mesh 
)
static

Return true if the DemandDrivenMeshObject with the given name.

is found in the mesh registry

Definition at line 222 of file DemandDrivenMeshObject.C.

References Foam::name().

Here is the call graph for this function:

◆ found() [2/2]

bool found ( const Mesh &  mesh)
static

Return true if the DemandDrivenMeshObject named Type::typeName.

is found in the mesh registry

Definition at line 233 of file DemandDrivenMeshObject.C.

References found.

◆ mesh()

const Mesh& mesh ( ) const
inline

Definition at line 173 of file DemandDrivenMeshObject.H.

◆ writeData()

virtual bool writeData ( Foam::Ostream ) const
inlinevirtual

Pure virtual writaData function.

Must be defined in derived types

Implements regIOobject.

Reimplemented in fvModels, fvConstraints, and coordinateSystems.

Definition at line 178 of file DemandDrivenMeshObject.H.


The documentation for this class was generated from the following files: