forcesBase Class Referenceabstract

Calculates the forces and moments by integrating the pressure and skin-friction forces over a given list of patches. More...

Inheritance diagram for forcesBase:
Collaboration diagram for forcesBase:

Public Member Functions

 TypeName ("forcesBase")
 Runtime type information. More...
 
 forcesBase (const word &name, const Time &runTime, const dictionary &dict)
 Construct from Time and dictionary. More...
 
 forcesBase (const word &name, const objectRegistry &obr, const dictionary &)
 Construct from objectRegistry and dictionary. More...
 
 forcesBase (const forcesBase &)=delete
 Disallow default bitwise copy construction. More...
 
virtual ~forcesBase ()
 Destructor. More...
 
virtual bool read (const dictionary &)
 Read the forces data. More...
 
virtual wordList fields () const
 Return the list of fields required. More...
 
virtual void calcForcesMoments ()
 Calculate the forces and moments. More...
 
virtual vector forceEff () const
 Return the total force. More...
 
virtual vector momentEff () const
 Return the total moment. More...
 
virtual bool execute ()
 Execute, currently does nothing. More...
 
virtual bool write ()
 Write the forces. More...
 
void operator= (const forcesBase &)=delete
 Disallow default bitwise assignment. More...
 
- Public Member Functions inherited from fvMeshFunctionObject
 TypeName ("fvMeshFunctionObject")
 Runtime type information. More...
 
 fvMeshFunctionObject (const word &name, const Time &runTime, const dictionary &dict)
 Construct from Time and dictionary. More...
 
 fvMeshFunctionObject (const word &name, const objectRegistry &obr, const dictionary &dict)
 Construct from the region objectRegistry and dictionary. More...
 
 fvMeshFunctionObject (const fvMeshFunctionObject &)=delete
 Disallow default bitwise copy construction. More...
 
virtual ~fvMeshFunctionObject ()
 Destructor. More...
 
void operator= (const fvMeshFunctionObject &)=delete
 Disallow default bitwise assignment. More...
 
- Public Member Functions inherited from regionFunctionObject
 TypeName ("regionFunctionObject")
 Runtime type information. More...
 
 regionFunctionObject (const word &name, const Time &runTime, const dictionary &dict)
 Construct from Time and dictionary. More...
 
 regionFunctionObject (const word &name, const objectRegistry &obr, const dictionary &dict)
 Construct from the region objectRegistry and dictionary. More...
 
 regionFunctionObject (const regionFunctionObject &)=delete
 Disallow default bitwise copy construction. More...
 
virtual ~regionFunctionObject ()
 Destructor. More...
 
void operator= (const regionFunctionObject &)=delete
 Disallow default bitwise assignment. More...
 
- Public Member Functions inherited from functionObject
 ClassName ("functionObject")
 
virtual const wordtype () const =0
 Runtime type information. More...
 
 declareRunTimeSelectionTable (autoPtr, functionObject, dictionary,(const word &name, const Time &runTime, const dictionary &dict),(name, runTime, dict))
 
 functionObject (const word &name, const Time &runTime)
 Construct from components. More...
 
autoPtr< functionObjectclone () const
 Return clone. More...
 
 functionObject (const functionObject &)=delete
 Disallow default bitwise copy construction. More...
 
virtual ~functionObject ()
 Destructor. More...
 
const wordname () const
 Return the name of this functionObject. More...
 
virtual bool executeAtStart () const
 Return true if the functionObject should be executed at the start. More...
 
virtual bool end ()
 Called when Time::run() determines that the time-loop exits. More...
 
virtual scalar timeToNextAction ()
 Called by Time::adjustTimeStep(). Allows the functionObject to. More...
 
virtual scalar maxDeltaT () const
 Return the maximum time-step for stable operation. More...
 
virtual void movePoints (const polyMesh &mesh)
 Update topology using the given map. More...
 
virtual void topoChange (const polyTopoChangeMap &map)
 Update topology using the given map. More...
 
virtual void mapMesh (const polyMeshMap &)
 Update from another mesh using the given map. More...
 
virtual void distribute (const polyDistributionMap &)
 Redistribute or update using the given distribution map. More...
 
void operator= (const functionObject &)=delete
 Disallow default bitwise assignment. More...
 
- Public Member Functions inherited from logFiles
 logFiles (const objectRegistry &obr, const word &prefix)
 Construct from objectRegistry and prefix. More...
 
 logFiles (const logFiles &)=delete
 Disallow default bitwise copy construction. More...
 
virtual ~logFiles ()
 Destructor. More...
 
const wordListtoc () const
 Return the list of log file names. More...
 
const wordListnames () const
 Return the list of log file names. More...
 
PtrList< OFstream > & files ()
 Return access to the files. More...
 
OFstreamfile ()
 Return access to the file (if only 1) More...
 
OFstreamfile (const label i)
 Return file 'i'. More...
 
void operator= (const logFiles &)=delete
 Disallow default bitwise assignment. More...
 
- Public Member Functions inherited from writeFile
 writeFile (const objectRegistry &obr, const word &prefix)
 Construct from objectRegistry and prefix. More...
 
 writeFile (const writeFile &)=delete
 Disallow default bitwise copy construction. More...
 
 ~writeFile ()
 Destructor. More...
 
void initStream (Ostream &os) const
 Initialise the output stream for writing. More...
 
fileName baseFileDir () const
 Return the base directory for output. More...
 
fileName baseTimeDir () const
 Return the base directory for the current time value. More...
 
Omanip< int > valueWidth (const label offset=0) const
 Return the value width when writing to stream with optional offset. More...
 
void writeCommented (Ostream &os, const string &str) const
 Write a commented string to stream. More...
 
void writeTabbed (Ostream &os, const string &str) const
 Write a tabbed string to stream. More...
 
void writeHeader (Ostream &os, const string &str) const
 Write a commented header to stream. More...
 
void writeTime (Ostream &os) const
 Write the current time to stream. More...
 
template<class Type >
void writeHeaderValue (Ostream &os, const string &property, const Type &value) const
 Write a (commented) header property and value pair. More...
 
label charWidth () const
 Return width of character stream output. More...
 
void operator= (const writeFile &)=delete
 Disallow default bitwise assignment. More...
 

Protected Types

enum class  fileID { mainFile = 0 , binsFile = 1 }
 Enumeration for ensuring the right file is accessed. More...
 

Protected Member Functions

Ostreamfile (const fileID fid)
 
wordList createFileNames (const dictionary &dict) const
 Create file names for forces and bins. More...
 
virtual void writeFileHeader (const label i)
 Output file header information. More...
 
void initialise ()
 Initialise the fields. More...
 
tmp< volSymmTensorFielddevTau () const
 Return the effective viscous stress (laminar + turbulent). More...
 
tmp< volScalarFieldmu () const
 Dynamic viscosity field. More...
 
tmp< volScalarFieldrho () const
 Return rho if specified otherwise rhoRef. More...
 
scalar rho (const volScalarField &p) const
 Return rhoRef if the pressure field is dynamic, i.e. p/rho. More...
 
tmp< volScalarFieldalpha () const
 Get the volume fraction field. More...
 
tmp< scalarFieldalpha (const label patchi) const
 Get the volume fraction field on a patch. More...
 
void applyBins (const vectorField &Md, const vectorField &fN, const vectorField &fT, const vectorField &fP, const vectorField &d)
 Accumulate bin data. More...
 
void calcForcesMoments (const vector &CofR)
 Calculate the forces and moments. More...
 
virtual vector CofR () const =0
 Return the current centre of the rigid body. More...
 
virtual void writeCoRValueHeader (Ostream &file)
 Write the constant centre of rotation value in the header. More...
 
virtual void writeCoRHeader (Ostream &file)
 Write the time varying centre of rotation column header. More...
 
virtual void writeCofR (Ostream &file)
 Write the time varying centre of rotation. More...
 
void writeForces ()
 Helper function to write force data. More...
 
void writeBins ()
 Helper function to write bin data. More...
 
OFstreamfile ()
 Return access to the file (if only 1) More...
 
OFstreamfile (const label i)
 Return file 'i'. More...
 
- Protected Member Functions inherited from fvMeshFunctionObject
labelHashSet patchSet (const dictionary &, const bool optional=false) const
 Return the patch set corresponding to the patch selection entries. More...
 
- Protected Member Functions inherited from regionFunctionObject
template<class ObjectType >
bool foundObject (const word &fieldName) const
 Find field in the objectRegistry. More...
 
template<class ObjectType >
void cannotFindObject (const word &fieldName)
 Prints a warning message that fieldName cannot be found. More...
 
void cannotFindObject (const word &fieldName)
 Prints a warning message that fieldName cannot be found. More...
 
void cannotFindObjects (const wordList &fieldNames)
 Prints a warning message that fieldNames cannot be found. More...
 
template<class ObjectType >
const ObjectType & lookupObject (const word &fieldName) const
 Lookup object from the objectRegistry. More...
 
template<class ObjectType >
ObjectType & lookupObjectRef (const word &fieldName)
 Lookup non-const object reference from the objectRegistry. More...
 
template<class ObjectType >
bool store (const tmp< ObjectType > &tfield)
 Store the given field in the objectRegistry. More...
 
template<class ObjectType >
bool store (const word &fieldName, const tmp< ObjectType > &tfield, bool cacheable=false)
 Store the given field in the objectRegistry under the given name. More...
 
bool writeObject (const word &fieldName)
 Write field if present in objectRegistry. More...
 
bool clearObject (const word &fieldName)
 Clear field from the objectRegistry if present. More...
 
- Protected Member Functions inherited from logFiles
virtual void createFiles ()
 Create the output file. More...
 
virtual void resetNames (const wordList &names)
 Reset the list of names from a wordList. More...
 
virtual void resetName (const word &name)
 Reset the list of names to a single name entry. More...
 

Protected Attributes

List< Field< vector > > force_
 Pressure, viscous and porous force per bin. More...
 
List< Field< vector > > moment_
 Pressure, viscous and porous moment per bin. More...
 
labelHashSet patchSet_
 Patches to integrate forces over. More...
 
word pName_
 Name of pressure field. More...
 
word UName_
 Name of velocity field. More...
 
word rhoName_
 Name of density field (optional) More...
 
word phaseName_
 The name of the phase (optional) More...
 
Switch directForceDensity_
 Is the force density being supplied directly? More...
 
word fDName_
 The name of the force density (fD) field. More...
 
scalar rhoRef_
 Reference density needed for incompressible calculations. More...
 
scalar pRef_
 Reference pressure. More...
 
bool porosity_
 Flag to include porosity effects. More...
 
label nBin_
 Number of bins. More...
 
vector binDir_
 Direction used to determine bin orientation. More...
 
scalar binDx_
 Distance between bin divisions. More...
 
scalar binMin_
 Minimum bin bounds. More...
 
List< pointbinPoints_
 Bin positions along binDir. More...
 
bool binCumulative_
 Should bin data be cumulative? More...
 
bool initialised_
 Initialised flag. More...
 
- Protected Attributes inherited from fvMeshFunctionObject
const fvMeshmesh_
 Reference to the fvMesh. More...
 
- Protected Attributes inherited from regionFunctionObject
const objectRegistryobr_
 Reference to the region objectRegistry. More...
 
- Protected Attributes inherited from functionObject
const Timetime_
 Reference to time. More...
 
- Protected Attributes inherited from logFiles
wordList names_
 File names. More...
 
PtrList< OFstreamfilePtrs_
 File pointer. More...
 
- Protected Attributes inherited from writeFile
const objectRegistryfileObr_
 Reference to the region objectRegistry. More...
 
const word prefix_
 Prefix. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from functionObject
static autoPtr< functionObjectNew (const word &name, const Time &, const dictionary &)
 Select from dictionary, based on its "type" entry. More...
 
- Public Attributes inherited from functionObject
Switch log
 Switch write log to Info. More...
 
Switch executeAtStart_
 Switch write log to Info. More...
 
- Static Public Attributes inherited from functionObject
static bool postProcess
 Global post-processing mode switch. More...
 
- Static Public Attributes inherited from writeFile
static const word outputPrefix
 Directory prefix. More...
 
static label addChars = 8
 Additional characters for writing. More...
 

Detailed Description

Calculates the forces and moments by integrating the pressure and skin-friction forces over a given list of patches.

See also
Foam::functionObject Foam::functionObjects::fvMeshFunctionObject Foam::functionObjects::logFiles Foam::functionObjects::timeControl
Source files

Definition at line 60 of file forcesBase.H.

Member Enumeration Documentation

◆ fileID

enum fileID
strongprotected

Enumeration for ensuring the right file is accessed.

Enumerator
mainFile 
binsFile 

Definition at line 71 of file forcesBase.H.

Constructor & Destructor Documentation

◆ forcesBase() [1/3]

forcesBase ( const word name,
const Time runTime,
const dictionary dict 
)

Construct from Time and dictionary.

Definition at line 579 of file forcesBase.C.

References dict, and forcesBase::read().

Here is the call graph for this function:

◆ forcesBase() [2/3]

forcesBase ( const word name,
const objectRegistry obr,
const dictionary dict 
)

Construct from objectRegistry and dictionary.

Definition at line 612 of file forcesBase.C.

References dict, and forcesBase::read().

Here is the call graph for this function:

◆ forcesBase() [3/3]

forcesBase ( const forcesBase )
delete

Disallow default bitwise copy construction.

◆ ~forcesBase()

~forcesBase ( )
virtual

Destructor.

Definition at line 647 of file forcesBase.C.

Member Function Documentation

◆ file() [1/3]

Ostream& file ( const fileID  fid)
inlineprotected

Definition at line 146 of file forcesBase.H.

References logFiles::file().

Here is the call graph for this function:

◆ createFileNames()

Foam::wordList createFileNames ( const dictionary dict) const
protected

Create file names for forces and bins.

Definition at line 49 of file forcesBase.C.

References List< T >::append(), dict, dictionary::lookup(), and logFiles::names().

Here is the call graph for this function:

◆ writeFileHeader()

void writeFileHeader ( const label  i)
protectedvirtual

Output file header information.

Implements logFiles.

Reimplemented in forceCoeffs.

Definition at line 76 of file forcesBase.C.

References Foam::abort(), Foam::endl(), f(), Foam::FatalError, FatalErrorInFunction, Foam::file, forAll, Foam::jn(), Foam::name(), Foam::nl, Foam::tab, and Foam::vtkWriteOps::writeHeader().

Here is the call graph for this function:

◆ initialise()

void initialise ( )
protected

Initialise the fields.

Definition at line 161 of file forcesBase.C.

References Foam::exit(), Foam::FatalError, and FatalErrorInFunction.

Here is the call graph for this function:

◆ devTau()

◆ mu()

◆ rho() [1/2]

Foam::tmp< Foam::volScalarField > rho ( ) const
protected

Return rho if specified otherwise rhoRef.

Definition at line 346 of file forcesBase.C.

References Foam::dimDensity, and GeometricField< Type, PatchField, GeoMesh >::New().

Here is the call graph for this function:

◆ rho() [2/2]

Foam::scalar rho ( const volScalarField p) const
protected

Return rhoRef if the pressure field is dynamic, i.e. p/rho.

otherwise return 1

Definition at line 364 of file forcesBase.C.

References Foam::dimPressure, Foam::exit(), Foam::FatalError, FatalErrorInFunction, and p.

Here is the call graph for this function:

◆ alpha() [1/2]

Foam::tmp< Foam::volScalarField > alpha ( ) const
protected

Get the volume fraction field.

Definition at line 387 of file forcesBase.C.

References Foam::dimless, IOobject::groupName(), GeometricField< Type, PatchField, GeoMesh >::New(), and word::null.

Here is the call graph for this function:

◆ alpha() [2/2]

Foam::tmp< Foam::scalarField > alpha ( const label  patchi) const
protected

Get the volume fraction field on a patch.

Definition at line 408 of file forcesBase.C.

References IOobject::groupName(), word::null, and patchi.

Here is the call graph for this function:

◆ applyBins()

void applyBins ( const vectorField Md,
const vectorField fN,
const vectorField fT,
const vectorField fP,
const vectorField d 
)
protected

Accumulate bin data.

Definition at line 430 of file forcesBase.C.

References forAll, Foam::max(), Foam::min(), and Foam::sum().

Here is the call graph for this function:

◆ calcForcesMoments() [1/2]

◆ CofR()

virtual vector CofR ( ) const
protectedpure virtual

Return the current centre of the rigid body.

Implemented in rigidBodyForces, movingForces, and forces.

◆ writeCoRValueHeader()

void writeCoRValueHeader ( Ostream file)
protectedvirtual

Write the constant centre of rotation value in the header.

Not written by default

Reimplemented in forces.

Definition at line 467 of file forcesBase.C.

◆ writeCoRHeader()

void writeCoRHeader ( Ostream file)
protectedvirtual

Write the time varying centre of rotation column header.

Reimplemented in forces.

Definition at line 471 of file forcesBase.C.

References Foam::file, and Foam::tab.

◆ writeCofR()

void writeCofR ( Ostream file)
protectedvirtual

Write the time varying centre of rotation.

Reimplemented in forces.

Definition at line 477 of file forcesBase.C.

References Foam::file.

◆ writeForces()

void writeForces ( )
protected

Helper function to write force data.

Definition at line 483 of file forcesBase.C.

References Foam::endl(), Foam::file, Log, Foam::name(), Foam::nl, Foam::setw(), Foam::sum(), Foam::tab, and Foam::type().

Here is the call graph for this function:

◆ writeBins()

void writeBins ( )
protected

Helper function to write bin data.

Definition at line 522 of file forcesBase.C.

References Foam::endl(), f(), Foam::file, forAll, Foam::setw(), and Foam::tab.

Here is the call graph for this function:

◆ TypeName()

TypeName ( "forcesBase"  )

Runtime type information.

◆ read()

bool read ( const dictionary dict)
virtual

◆ fields()

virtual wordList fields ( ) const
inlinevirtual

Return the list of fields required.

Implements functionObject.

Definition at line 250 of file forcesBase.H.

References List< word >::null().

Here is the call graph for this function:

◆ calcForcesMoments() [2/2]

void calcForcesMoments ( )
virtual

Calculate the forces and moments.

Definition at line 925 of file forcesBase.C.

Referenced by forceCoeffs::write().

Here is the caller graph for this function:

◆ forceEff()

Foam::vector forceEff ( ) const
virtual

Return the total force.

Definition at line 931 of file forcesBase.C.

References Foam::sum().

Here is the call graph for this function:

◆ momentEff()

Foam::vector momentEff ( ) const
virtual

Return the total moment.

Definition at line 937 of file forcesBase.C.

References Foam::sum().

Here is the call graph for this function:

◆ execute()

bool execute ( )
virtual

Execute, currently does nothing.

Implements functionObject.

Reimplemented in forceCoeffs.

Definition at line 943 of file forcesBase.C.

◆ write()

bool write ( )
virtual

Write the forces.

Reimplemented from logFiles.

Reimplemented in forceCoeffs.

Definition at line 949 of file forcesBase.C.

References Foam::endl(), Log, UPstream::master(), and logFiles::write().

Here is the call graph for this function:

◆ operator=()

void operator= ( const forcesBase )
delete

Disallow default bitwise assignment.

◆ file() [2/3]

Foam::OFstream & file
protected

Return access to the file (if only 1)

Definition at line 119 of file logFiles.C.

Referenced by forceCoeffs::writeFileHeader().

Here is the caller graph for this function:

◆ file() [3/3]

Foam::OFstream & file
protected

Return file 'i'.

Definition at line 122 of file logFiles.C.

References Foam::endl(), and WarningInFunction.

Here is the call graph for this function:

Member Data Documentation

◆ force_

List<Field<vector> > force_
protected

Pressure, viscous and porous force per bin.

Definition at line 78 of file forcesBase.H.

◆ moment_

List<Field<vector> > moment_
protected

Pressure, viscous and porous moment per bin.

Definition at line 81 of file forcesBase.H.

◆ patchSet_

labelHashSet patchSet_
protected

Patches to integrate forces over.

Definition at line 87 of file forcesBase.H.

◆ pName_

word pName_
protected

Name of pressure field.

Definition at line 90 of file forcesBase.H.

◆ UName_

word UName_
protected

Name of velocity field.

Definition at line 93 of file forcesBase.H.

◆ rhoName_

word rhoName_
protected

Name of density field (optional)

Definition at line 96 of file forcesBase.H.

◆ phaseName_

word phaseName_
protected

The name of the phase (optional)

Definition at line 99 of file forcesBase.H.

◆ directForceDensity_

Switch directForceDensity_
protected

Is the force density being supplied directly?

Definition at line 102 of file forcesBase.H.

◆ fDName_

word fDName_
protected

The name of the force density (fD) field.

Definition at line 105 of file forcesBase.H.

◆ rhoRef_

scalar rhoRef_
protected

Reference density needed for incompressible calculations.

Definition at line 108 of file forcesBase.H.

◆ pRef_

scalar pRef_
protected

Reference pressure.

Definition at line 111 of file forcesBase.H.

◆ porosity_

bool porosity_
protected

Flag to include porosity effects.

Definition at line 114 of file forcesBase.H.

◆ nBin_

label nBin_
protected

Number of bins.

Definition at line 120 of file forcesBase.H.

Referenced by forceCoeffs::writeFileHeader().

◆ binDir_

vector binDir_
protected

Direction used to determine bin orientation.

Definition at line 123 of file forcesBase.H.

Referenced by forceCoeffs::writeFileHeader().

◆ binDx_

scalar binDx_
protected

Distance between bin divisions.

Definition at line 126 of file forcesBase.H.

Referenced by forceCoeffs::writeFileHeader().

◆ binMin_

scalar binMin_
protected

Minimum bin bounds.

Definition at line 129 of file forcesBase.H.

Referenced by forceCoeffs::writeFileHeader().

◆ binPoints_

List<point> binPoints_
protected

Bin positions along binDir.

Definition at line 132 of file forcesBase.H.

◆ binCumulative_

bool binCumulative_
protected

Should bin data be cumulative?

Definition at line 135 of file forcesBase.H.

◆ initialised_

bool initialised_
protected

Initialised flag.

Definition at line 139 of file forcesBase.H.


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