Computes the volumetric- or mass-flux information across selections of face zones. More...
Public Types | |
enum | modeType { mdFaceZone, mdFaceZoneAndDirection, mdCellZoneAndDirection, mdSurface, mdSurfaceAndDirection } |
Face mode type. More... | |
Public Member Functions | |
TypeName ("fluxSummary") | |
Runtime type information. More... | |
fluxSummary (const word &name, const Time &runTime, const dictionary &dict) | |
Construct from Time and dictionary. More... | |
fluxSummary (const fluxSummary &)=delete | |
No copy construct. More... | |
void | operator= (const fluxSummary &)=delete |
No copy assignment. More... | |
virtual | ~fluxSummary ()=default |
Destructor. More... | |
virtual bool | read (const dictionary &dict) |
Read the field fluxSummary data. More... | |
virtual bool | execute () |
Execute, currently does nothing. More... | |
virtual bool | write () |
Write the fluxSummary. More... | |
![]() | |
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... | |
virtual | ~fvMeshFunctionObject ()=default |
Destructor. More... | |
![]() | |
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... | |
virtual | ~regionFunctionObject ()=default |
Destructor. More... | |
template<class ObjectType > | |
const ObjectType * | lookupObjectPtr (const word &fieldName) const |
Deprecated(2018-10) More... | |
template<class ObjectType > | |
ObjectType * | lookupObjectRefPtr (const word &fieldName) const |
Deprecated(2018-10) More... | |
![]() | |
stateFunctionObject (const word &name, const Time &runTime) | |
Construct from components. More... | |
virtual | ~stateFunctionObject ()=default |
Destructor. More... | |
dictionary & | propertyDict () |
Return access to the property dictionary. More... | |
bool | foundProperty (const word &entryName) const |
Return true if the property exists. More... | |
void | clearTrigger () |
Remove the trigger index from the properties. More... | |
label | getTrigger () const |
Get the current trigger index. More... | |
bool | setTrigger (const label triggeri, bool increaseOnly=true) |
Set the trigger index. Normally only if greater than current. More... | |
bool | getDict (const word &entryName, dictionary &dict) const |
Set dictionary, return true if set. More... | |
bool | getObjectDict (const word &objectName, const word &entryName, dictionary &dict) const |
Set dictionary from named object, return true if set. More... | |
template<class Type > | |
Type | getProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const |
Retrieve generic property. More... | |
template<class Type > | |
bool | getProperty (const word &entryName, Type &value) const |
Set generic property, return true if set. More... | |
template<class Type > | |
void | setProperty (const word &entryName, const Type &value) |
Add generic property. More... | |
template<class Type > | |
Type | getObjectProperty (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const |
Retrieve generic property from named object. More... | |
template<class Type > | |
bool | getObjectProperty (const word &objectName, const word &entryName, Type &value) const |
Set generic property from named object, return true if set. More... | |
template<class Type > | |
void | setObjectProperty (const word &objectName, const word &entryName, const Type &value) |
Add generic property from named object. More... | |
template<class Type > | |
void | setResult (const word &entryName, const Type &value) |
Add result. More... | |
template<class Type > | |
void | setObjectResult (const word &objectName, const word &entryName, const Type &value) |
Add result from named object. More... | |
template<class Type > | |
Type | getResult (const word &entryName, const Type &defaultValue=Type(Zero)) const |
Retrieve result. More... | |
template<class Type > | |
Type | getObjectResult (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const |
Retrieve result from named object. More... | |
template<class Type > | |
bool | getObjectResult (const word &objectName, const word &entryName, Type &value) const |
Set result from named object, return true if set. More... | |
word | resultType (const word &entryName) const |
Retrieve the result type. More... | |
word | objectResultType (const word &objectName, const word &entryName) const |
Return the type of result. More... | |
wordList | objectResultEntries () const |
Retrieve the result entries. More... | |
wordList | objectResultEntries (const word &objectName) const |
Return result entries for named object. More... | |
void | writeResultEntries (Ostream &os) const |
Write the results entries for all objects to stream. More... | |
void | writeResultEntries (const word &objectName, Ostream &os) const |
Write the results entries for named object to stream. More... | |
void | writeAllResultEntries (Ostream &os) const |
Write the results entries for all objects to stream. More... | |
![]() | |
timeFunctionObject (const word &name, const Time &runTime) | |
Construct from Time. More... | |
virtual | ~timeFunctionObject ()=default |
Destructor. More... | |
const Time & | time () const |
Return time database. More... | |
objectRegistry & | storedObjects () |
const objectRegistry & | storedObjects () const |
![]() | |
declareRunTimeSelectionTable (autoPtr, functionObject, dictionary,(const word &name, const Time &runTime, const dictionary &dict),(name, runTime, dict)) | |
functionObject (const word &name, const bool withNamePrefix=defaultUseNamePrefix) | |
Construct from components. More... | |
autoPtr< functionObject > | clone () const |
Return clone. More... | |
virtual | ~functionObject ()=default |
Destructor. More... | |
virtual const word & | type () const =0 |
Runtime type information. More... | |
const word & | name () const noexcept |
Return the name of this functionObject. More... | |
bool | useNamePrefix () const noexcept |
Return the flag for adding a scoping name prefix. More... | |
bool | useNamePrefix (bool on) noexcept |
Modify the flag for adding a scoping name prefix. More... | |
virtual bool | execute (const label subIndex) |
Execute using the specified subIndex. More... | |
virtual bool | end () |
Called when Time::run() determines that the time-loop exits. More... | |
virtual bool | adjustTimeStep () |
Called at the end of Time::adjustDeltaT() if adjustTime is true. More... | |
virtual bool | filesModified () const |
Did any file get changed during execution? More... | |
virtual void | updateMesh (const mapPolyMesh &mpm) |
Update for changes of mesh. More... | |
virtual void | movePoints (const polyMesh &mesh) |
Update for changes of mesh. More... | |
![]() | |
writeFile (const objectRegistry &obr, const fileName &prefix, const word &name="undefined", const bool writeToFile=true) | |
Construct from objectRegistry, prefix, fileName. More... | |
writeFile (const objectRegistry &obr, const fileName &prefix, const word &name, const dictionary &dict, const bool writeToFile=true) | |
writeFile (const writeFile &wf) | |
Construct copy. More... | |
virtual | ~writeFile ()=default |
Destructor. More... | |
virtual OFstream & | file () |
Return access to the file (if only 1) More... | |
virtual bool | writeToFile () const |
Flag to allow writing to file. More... | |
virtual bool | canWriteHeader () const |
Flag to allow writing the header. More... | |
virtual label | charWidth () const |
Return width of character stream output. More... | |
virtual void | writeCommented (Ostream &os, const string &str) const |
Write a commented string to stream. More... | |
virtual void | writeTabbed (Ostream &os, const string &str) const |
Write a tabbed string to stream. More... | |
virtual void | writeHeader (Ostream &os, const string &str) const |
Write a commented header to stream. More... | |
virtual void | writeCurrentTime (Ostream &os) const |
Write the current time to stream. More... | |
virtual void | writeBreak (Ostream &os) const |
Write a break marker to the 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... | |
Static Public Attributes | |
static const Enum< modeType > | modeTypeNames_ |
Face mode names. More... | |
![]() | |
static int | debug |
Flag to execute debug content. More... | |
static bool | postProcess |
Global post-processing mode switch. More... | |
static bool | defaultUseNamePrefix |
Global default for useNamePrefix. More... | |
static word | outputPrefix |
Directory prefix. More... | |
![]() | |
static label | addChars = 8 |
Additional characters for writing. More... | |
Protected Member Functions | |
bool | isSurfaceMode () const |
Check if surface mode instead of zone mode. More... | |
word | checkFlowType (const dimensionSet &fieldDims, const word &fieldName) const |
Check flowType (mass or volume) More... | |
void | initialiseSurface (const word &surfName, DynamicList< word > &names, DynamicList< vector > &dir, DynamicList< boolList > &faceFlip) const |
Initialise for given surface name. More... | |
void | initialiseSurfaceAndDirection (const word &surfName, const vector &refDir, DynamicList< word > &names, DynamicList< vector > &dir, DynamicList< boolList > &faceFlip) const |
Initialise for given surface name and direction. More... | |
void | initialiseFaceZone (const word &faceZoneName, DynamicList< word > &names, DynamicList< vector > &dir, DynamicList< labelList > &faceID, DynamicList< labelList > &facePatchID, DynamicList< boolList > &faceFlip) const |
Initialise face set from face zone. More... | |
void | initialiseFaceZoneAndDirection (const word &faceZoneName, const vector &refDir, DynamicList< word > &names, DynamicList< vector > &dir, DynamicList< labelList > &faceID, DynamicList< labelList > &facePatchID, DynamicList< boolList > &faceFlip) const |
Initialise face set from face zone and direction. More... | |
void | initialiseCellZoneAndDirection (const word &cellZoneName, const vector &refDir, DynamicList< word > &names, DynamicList< vector > &dir, DynamicList< labelList > &faceID, DynamicList< labelList > &facePatchID, DynamicList< boolList > &faceFlip) const |
Initialise face set from cell zone and direction. More... | |
scalar | totalArea (const label idx) const |
Calculate the total area for the surface or derived faceZone. More... | |
bool | update () |
Initialise - after read(), before write() More... | |
virtual void | writeFileHeader (const word &zoneName, const scalar area, const vector &refDir, Ostream &os) const |
Output file header information. More... | |
bool | surfaceModeWrite () |
Specialized write for surfaces. More... | |
![]() | |
fvMeshFunctionObject (const fvMeshFunctionObject &)=delete | |
No copy construct. More... | |
void | operator= (const fvMeshFunctionObject &)=delete |
No copy assignment. More... | |
![]() | |
virtual const objectRegistry & | obr () const |
The region or sub-region registry being used. More... | |
template<class ObjectType > | |
bool | foundObject (const word &fieldName) const |
Find object (eg, a field) in the (sub) objectRegistry. More... | |
template<class ObjectType > | |
const ObjectType * | cfindObject (const word &fieldName) const |
template<class ObjectType > | |
const ObjectType * | findObject (const word &fieldName) const |
template<class ObjectType > | |
ObjectType * | findObject (const word &fieldName) |
template<class ObjectType > | |
ObjectType * | getObjectPtr (const word &fieldName) const |
template<class ObjectType > | |
const ObjectType & | lookupObject (const word &fieldName) const |
Lookup and return object (eg, a field) from the (sub) objectRegistry. More... | |
template<class ObjectType > | |
ObjectType & | lookupObjectRef (const word &fieldName) const |
Lookup and return object (eg, a field) from the (sub) objectRegistry. More... | |
template<class ObjectType > | |
bool | store (word &fieldName, const tmp< ObjectType > &tfield, bool cacheable=false) |
Store the field in the (sub) objectRegistry under the given name. More... | |
template<class ObjectType > | |
bool | storeInDb (const word &fieldName, const tmp< ObjectType > &tfield, const objectRegistry &obr) |
Store the field in an optional objectRegistry under the given name. More... | |
bool | writeObject (const word &fieldName) |
Write field if present in the (sub) objectRegistry. More... | |
bool | clearObject (const word &fieldName) |
Clear field from the (sub) objectRegistry if present. More... | |
void | clearObjects (const wordList &objNames) |
Clear fields from the (sub) objectRegistry if present. More... | |
regionFunctionObject (const regionFunctionObject &)=delete | |
No copy construct. More... | |
void | operator= (const regionFunctionObject &)=delete |
No copy assignment. More... | |
![]() | |
const functionObjects::properties & | stateDict () const |
Return a const reference to the state dictionary. More... | |
functionObjects::properties & | stateDict () |
Return non-const access to the state dictionary. More... | |
stateFunctionObject (const stateFunctionObject &)=delete | |
No copy construct. More... | |
void | operator= (const stateFunctionObject &)=delete |
No copy assignment. More... | |
![]() | |
void | clearOutputObjects (const wordList &objNames) |
Remove specified items from "functionObjectObjects". More... | |
timeFunctionObject (const timeFunctionObject &)=delete | |
No copy construct. More... | |
void | operator= (const timeFunctionObject &)=delete |
No copy assignment. More... | |
![]() | |
word | scopedName (const word &name) const |
Return a scoped (prefixed) name. 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... | |
virtual autoPtr< OFstream > | createFile (const word &name, scalar timeValue) const |
Return autoPtr to a new file for a given time. More... | |
virtual autoPtr< OFstream > | createFile (const word &name) const |
Return autoPtr to a new file using the simulation start time. More... | |
virtual void | resetFile (const word &name) |
Reset internal file pointer to new file with new name. More... | |
Omanip< int > | valueWidth (const label offset=0) const |
Return the value width when writing to stream with optional offset. More... | |
void | operator= (const writeFile &)=delete |
No copy assignment. More... | |
Protected Attributes | |
bool | needsUpdate_ |
Track if the surface needs an update. More... | |
modeType | mode_ |
Mode for face determination/to generate faces to test. More... | |
scalar | scaleFactor_ |
Factor to scale results. More... | |
word | phiName_ |
Name of flux field. More... | |
List< word > | zoneNames_ |
Region (zone/surface) names. More... | |
List< vector > | zoneDirections_ |
Region (zone/surface) directions. More... | |
List< labelList > | faceID_ |
Face IDs. More... | |
List< labelList > | facePatchID_ |
Face patch IDs. More... | |
List< boolList > | faceFlip_ |
Face flip map signs. More... | |
PtrList< OFstream > | filePtrs_ |
Output file per face zone. More... | |
scalar | tolerance_ |
Tolerance applied when matching face normals. More... | |
![]() | |
const fvMesh & | mesh_ |
Reference to the fvMesh. More... | |
![]() | |
word | subRegistryName_ |
Name for alternative object registry. More... | |
const objectRegistry & | obr_ |
Reference to the region objectRegistry. More... | |
const objectRegistry * | obrPtr_ |
Pointer to alternative (eg, sub-region) objectRegistry. More... | |
![]() | |
const Time & | time_ |
Reference to the time database. More... | |
![]() | |
const objectRegistry & | fileObr_ |
Reference to the region objectRegistry. More... | |
const fileName | prefix_ |
Prefix. More... | |
word | fileName_ |
Name of file. More... | |
autoPtr< OFstream > | filePtr_ |
File pointer. More... | |
label | writePrecision_ |
Write precision. More... | |
bool | writeToFile_ |
Flag to enable/disable writing to file. More... | |
bool | updateHeader_ |
bool | writtenHeader_ |
Flag to identify whether the header has been written. More... | |
bool | useUserTime_ |
scalar | startTime_ |
Start time value. More... | |
Additional Inherited Members | |
![]() | |
static autoPtr< functionObject > | New (const word &name, const Time &runTime, const dictionary &dict) |
Select from dictionary, based on its "type" entry. More... | |
![]() | |
bool | log |
Flag to write log into Info. More... | |
Computes the volumetric- or mass-flux information across selections of face zones.
Operand | Type | Location |
---|---|---|
input | - | - |
output file | dat | $FOAM_CASE/postProcessing/<FO>/<time>/<faceN> |
output field | - | - |
system/controlDict.functions
: fluxSummary1 { // Mandatory entries (unmodifiable) type fluxSummary; libs (fieldFunctionObjects); // Mandatory entries (runtime modifiable) mode cellZoneAndDirection; cellZoneAndDirection ( (porosity (1 0 0)) ); // Optional entries (runtime modifiable) phi phi; scaleFactor 1.0; tolerance 0.8; // Optional (inherited) entries ... }
where the entries mean:
Property | Description | Type | Req'd | Dflt |
---|---|---|---|---|
type | Type name: fluxSummary | word | yes | - |
libs | Library name: fieldFunctionObjects | word | yes | - |
mode | Mode to generate faces to test | word | yes | - |
phi | Name of surface flux field | word | no | phi |
scaleFactor | Factor to scale results | scalar | no | 1.0 |
tolerance | Tolerance for reference direction | scalar | no | 0.8 |
Options for the mode
entry:
faceZone faceZoneAndDirection cellZoneAndDirection surface surfaceAndDirection
The inherited entries are elaborated in:
Usage by the postProcess
utility is not available.
Definition at line 192 of file fluxSummary.H.
enum modeType |
Face mode type.
Enumerator | |
---|---|
mdFaceZone | Face zone. |
mdFaceZoneAndDirection | Face zone with prescribed direction. |
mdCellZoneAndDirection | Cell zone with prescribed direction. |
mdSurface | A functionObject surface. |
mdSurfaceAndDirection | A surface with prescribed direction. |
Definition at line 202 of file fluxSummary.H.
fluxSummary | ( | const word & | name, |
const Time & | runTime, | ||
const dictionary & | dict | ||
) |
Construct from Time and dictionary.
Definition at line 935 of file fluxSummary.C.
References dict, and Foam::read().
|
delete |
No copy construct.
|
virtualdefault |
Destructor.
|
protected |
Check if surface mode instead of zone mode.
Definition at line 70 of file fluxSummary.C.
References fluxSummary::mdSurface, fluxSummary::mdSurfaceAndDirection, and fluxSummary::mode_.
|
protected |
Check flowType (mass or volume)
Return name on success, fatal error on failure.
Definition at line 77 of file fluxSummary.C.
References Foam::abort(), Foam::dimArea, Foam::dimMass, Foam::dimTime, Foam::dimVolume, Foam::FatalError, FatalErrorInFunction, and word::null.
|
protected |
Initialise for given surface name.
Definition at line 107 of file fluxSummary.C.
References List< T >::append(), DynamicList< T, SizeMin >::append(), objectRegistry::cfindObject(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, Foam::PtrListOps::names(), Foam::nl, and Foam::Zero.
|
protected |
Initialise for given surface name and direction.
Definition at line 133 of file fluxSummary.C.
References List< T >::append(), DynamicList< T, SizeMin >::append(), objectRegistry::cfindObject(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, forAll, Foam::mag(), n, Foam::PtrListOps::names(), Foam::nl, s, and List< T >::setSize().
|
protected |
Initialise face set from face zone.
Definition at line 181 of file fluxSummary.C.
References List< T >::append(), DynamicList< T, SizeMin >::append(), polyPatch::boundaryMesh(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, faceZone::flipMap(), forAll, Foam::PtrListOps::names(), Foam::nl, polyPatch::whichFace(), and Foam::Zero.
|
protected |
Initialise face set from face zone and direction.
Definition at line 258 of file fluxSummary.C.
References List< T >::append(), DynamicList< T, SizeMin >::append(), GeometricField< Type, PatchField, GeoMesh >::boundaryField(), polyPatch::boundaryMesh(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, forAll, Foam::mag(), n, Foam::PtrListOps::names(), Foam::nl, polyPatch::whichFace(), and Foam::Zero.
|
protected |
Initialise face set from cell zone and direction.
Definition at line 360 of file fluxSummary.C.
References List< T >::append(), DynamicList< T, SizeMin >::append(), polyPatch::coupled(), Foam::expressions::patchExpr::debug, DebugInfo, Foam::endl(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, forAll, Foam::identity(), Foam::Info, Foam::labelMax, Foam::mag(), n, Foam::name(), Foam::PtrListOps::names(), Foam::nl, os(), Foam::foamVersion::patch, Foam::reduce(), Foam::returnReduce(), Foam::search(), polyPatch::start(), syncTools::swapBoundaryFaceList(), Foam::type(), and WarningInFunction.
|
protected |
Calculate the total area for the surface or derived faceZone.
Definition at line 657 of file fluxSummary.C.
References GeometricField< Type, PatchField, GeoMesh >::boundaryField(), forAll, Foam::returnReduce(), s, and Foam::sum().
|
protected |
Initialise - after read(), before write()
Definition at line 780 of file fluxSummary.C.
References Foam::endl(), forAll, Foam::Info, Foam::name(), Foam::nl, and Foam::type().
|
protectedvirtual |
Output file header information.
Definition at line 1041 of file fluxSummary.C.
References Foam::fieldTypes::area, Foam::endl(), os(), Foam::tab, and Foam::writeHeader().
|
protected |
Specialized write for surfaces.
Definition at line 697 of file fluxSummary.C.
References Foam::endl(), forAll, Log, Foam::name(), Foam::nl, phi, phis(), Foam::reduce(), s, token::TAB, and Foam::type().
TypeName | ( | "fluxSummary" | ) |
Runtime type information.
|
delete |
No copy assignment.
|
virtual |
Read the field fluxSummary data.
Reimplemented from writeFile.
Definition at line 961 of file fluxSummary.C.
References Foam::abort(), dict, Foam::endl(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::flatOutput(), Foam::Info, Foam::name(), regionFunctionObject::read(), writeFile::read(), and Foam::type().
|
virtual |
Execute, currently does nothing.
Implements functionObject.
Definition at line 1083 of file fluxSummary.C.
|
virtual |
Write the fluxSummary.
Implements functionObject.
Definition at line 1089 of file fluxSummary.C.
References Foam::endl(), forAll, Log, Foam::name(), Foam::nl, phi, Foam::reduce(), token::TAB, Foam::type(), and update().
|
static |
Face mode names.
Definition at line 212 of file fluxSummary.H.
|
protected |
Track if the surface needs an update.
Definition at line 220 of file fluxSummary.H.
|
protected |
Mode for face determination/to generate faces to test.
Definition at line 223 of file fluxSummary.H.
Referenced by fluxSummary::isSurfaceMode().
|
protected |
Factor to scale results.
Definition at line 226 of file fluxSummary.H.
|
protected |
Name of flux field.
Definition at line 229 of file fluxSummary.H.
Region (zone/surface) names.
Definition at line 235 of file fluxSummary.H.
Region (zone/surface) directions.
Definition at line 238 of file fluxSummary.H.
Face IDs.
Definition at line 241 of file fluxSummary.H.
Face patch IDs.
Definition at line 244 of file fluxSummary.H.
Face flip map signs.
Definition at line 247 of file fluxSummary.H.
Output file per face zone.
Definition at line 250 of file fluxSummary.H.
|
protected |
Tolerance applied when matching face normals.
Definition at line 254 of file fluxSummary.H.