Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions | Protected Attributes | Static Protected Attributes | List of all members
Time Class Reference

Class to control time during OpenFOAM simulations that is also the top-level objectRegistry. More...

Inheritance diagram for Time:
Inheritance graph
[legend]
Collaboration diagram for Time:
Collaboration graph
[legend]

Public Types

enum  writeControls {
  wcNone, wcTimeStep, wcRunTime, wcAdjustableRunTime,
  wcClockTime, wcCpuTime, wcUnknown
}
 Write control options. More...
 
enum  stopAtControls {
  saEndTime, saNoWriteNow, saWriteNow, saNextWrite,
  saUnknown
}
 Stop-run control options, which are primarily used when altering the stopAt condition. More...
 
enum  fmtflags { general = 0, fixed = ios_base::fixed, scientific = ios_base::scientific }
 Supported time directory name formats. More...
 
- Public Types inherited from IOobject
enum  objectState : char { GOOD, BAD }
 Enumeration defining the valid states of an IOobject. More...
 
enum  fileCheckTypes : char { timeStamp, timeStampMaster, inotify, inotifyMaster }
 Enumeration defining the file checking options. More...
 
- Public Types inherited from IOobjectOption
enum  readOption : unsigned char { NO_READ = 0, MUST_READ = 0x1, MUST_READ_IF_MODIFIED = 0x3, READ_IF_PRESENT = 0x4 }
 Enumeration defining read preferences. More...
 
enum  writeOption : unsigned char { NO_WRITE = 0, AUTO_WRITE = 0x10 }
 Enumeration defining write preferences. More...
 
enum  registerOption : unsigned char { NO_REGISTER = 0, REGISTER = 1 }
 Enumeration for use with registerObject(). Values map to bool (false/true) More...
 
- Public Types inherited from HashTable< regIOobject *>
typedef HashTable< regIOobject *, word, Foam::Hash< word > > this_type
 The template instance used for this HashTable. More...
 
typedef std::conditional< std::is_same< zero::null, typename std::remove_cv< regIOobject * >::type >::value, Detail::HashTableSingle< word >, Detail::HashTablePair< word, regIOobject * > >::type node_type
 A table entry (node) that encapsulates the key/val tuple with an additional linked-list entry for hash collisions. More...
 
typedef word key_type
 The second template parameter, type of keys used. More...
 
typedef regIOobjectmapped_type
 The first template parameter, type of objects contained. More...
 
typedef regIOobjectvalue_type
 Same as mapped_type for OpenFOAM HashTables. More...
 
typedef Foam::Hash< wordhasher
 The third template parameter, the hash index method. More...
 
typedef regIOobject * * pointer
 Pointer type for storing into value_type objects. More...
 
typedef regIOobject * & reference
 Reference to the stored value_type. More...
 
typedef const regIOobject * * const_pointer
 Const pointer type for the stored value_type. More...
 
typedef const regIOobject * & const_reference
 Const reference to the stored value_type. More...
 
typedef label difference_type
 The type to represent the difference between two iterators. More...
 
typedef label size_type
 The type that can represent the size of a HashTable. More...
 
using key_iterator = key_iterator_base< iterator >
 Forward iterator returning the key. More...
 
using const_key_iterator = key_iterator_base< const_iterator >
 Forward const iterator returning the key. More...
 
- Public Types inherited from dimensioned< Type >
typedef Type value_type
 The underlying data type. More...
 
typedef pTraits< Type >::cmptType cmptType
 Component type. More...
 

Public Member Functions

 TypeName ("time")
 Runtime type information. More...
 
 Time (const word &ctrlDictName, const argList &args, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct from dictionary name to read and argument list. More...
 
 Time (const word &ctrlDictName, const fileName &rootPath, const fileName &caseName, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct given name of dictionary to read and root/case paths. More...
 
 Time (const dictionary &dict, const fileName &rootPath, const fileName &caseName, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct given dictionary and root/case paths. More...
 
 Time (const fileName &rootPath, const fileName &caseName, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct at endTime and root/case paths. More...
 
 Time (const word &ctrlDictName, const argList &args, const word &systemName, const word &constantName, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct from dictionary name to read and argument list. More...
 
 Time (const word &ctrlDictName, const fileName &rootPath, const fileName &caseName, const word &systemName, const word &constantName, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct given name of dictionary to read and root/case paths. More...
 
 Time (const dictionary &dict, const fileName &rootPath, const fileName &caseName, const word &systemName, const word &constantName, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct given dictionary and root/case paths. More...
 
 Time (const fileName &rootPath, const fileName &caseName, const word &systemName, const word &constantName, const bool enableFunctionObjects=true, const bool enableLibs=true)
 Construct given endTime and root/case paths. More...
 
virtual ~Time ()
 Destructor. More...
 
fileName path () const
 Return path. More...
 
const dictionarycontrolDict () const
 Return read access to the controlDict dictionary. More...
 
virtual const fileNamedbDir () const
 Local directory path of this objectRegistry relative to the time. More...
 
fileName timePath () const
 Return current time path. More...
 
IOstreamOption writeStreamOption () const noexcept
 The write stream option (format, compression, version) More...
 
IOstreamOption::streamFormat writeFormat () const noexcept
 The write stream format. More...
 
IOstreamOption::compressionType writeCompression () const noexcept
 The write stream compression. More...
 
IOstreamOption::versionNumber writeVersion () const noexcept
 The write stream version. More...
 
const wordgraphFormat () const noexcept
 Default graph format. More...
 
Switch runTimeModifiable () const noexcept
 Supports re-reading. More...
 
Switch runTimeModifiable (const Switch sw) noexcept
 Set re-reading support on/off (use with caution). More...
 
virtual bool read ()
 Read control dictionary, update controls and time. More...
 
void readModifiedObjects ()
 Read the objects that have been modified. More...
 
word findInstance (const fileName &dir, const word &name=word::null, IOobjectOption::readOption rOpt=IOobjectOption::MUST_READ, const word &stopInstance=word::null) const
 Return time instance (location) of dir that contains the file name (eg, used in reading mesh data). More...
 
word findInstancePath (const fileName &directory, const instant &t) const
 Search the case for the time directory path corresponding to the given instance. More...
 
word findInstancePath (const instant &t) const
 Search the case for the time directory path corresponding to the given instance. More...
 
virtual bool writeTimeDict () const
 Write time dictionary to the <time>/uniform directory. More...
 
virtual bool writeObject (IOstreamOption streamOpt, const bool valid) const
 Write using stream options. More...
 
bool writeNow ()
 Write the objects immediately (not at end of iteration) and continue the run. More...
 
bool writeAndEnd ()
 Write the objects now (not at end of iteration) and end the run. More...
 
void writeOnce ()
 Write the objects once (one shot) and continue the run. More...
 
OstreamprintExecutionTime (OSstream &os) const
 Print the elapsed ExecutionTime (cpu-time), ClockTime. More...
 
virtual word timeName () const
 Return current time name. More...
 
virtual label startTimeIndex () const
 Return start time index. More...
 
virtual dimensionedScalar startTime () const
 Return start time. More...
 
virtual dimensionedScalar endTime () const
 Return end time. More...
 
virtual stopAtControls stopAt () const
 Return the stop control information. More...
 
virtual bool isAdjustTimeStep () const
 Return true if adjustTimeStep is true. More...
 
const functionObjectListfunctionObjects () const
 Return the list of function objects. More...
 
dlLibraryTablelibs () const noexcept
 Mutable access to the loaded dynamic libraries. More...
 
label subCycling () const noexcept
 Zero (tests as false) if time is not being sub-cycled, otherwise the current sub-cycle index or the total number of sub-cycles. More...
 
const TimeStateprevTimeState () const
 Return previous TimeState if time is being sub-cycled. More...
 
virtual bool run () const
 Return true if run should continue,. More...
 
virtual bool loop ()
 Return true if run should continue and if so increment time. More...
 
virtual bool end () const
 Return true if end of run,. More...
 
virtual bool stopAt (const stopAtControls stopCtrl) const
 Adjust the current stopAtControl. More...
 
virtual void setTime (const Time &t)
 Reset the time and time-index to those of the given time. More...
 
virtual void setTime (const instant &inst, const label newIndex)
 Reset the time and time-index. More...
 
virtual void setTime (const dimensionedScalar &newTime, const label newIndex)
 Reset the time and time-index. More...
 
virtual void setTime (const scalar newTime, const label newIndex)
 Reset the time and time-index. More...
 
virtual void setEndTime (const dimensionedScalar &endTime)
 Reset end time. More...
 
virtual void setEndTime (const scalar endTime)
 Reset end time. More...
 
virtual void setDeltaT (const dimensionedScalar &deltaT, const bool adjust=true)
 Reset time step, normally also calling adjustDeltaT() More...
 
virtual void setDeltaT (const scalar deltaT, const bool adjust=true)
 Reset time step, normally also calling adjustDeltaT() More...
 
virtual TimeState subCycle (const label nSubCycles)
 Set time to sub-cycle for the given number of steps. More...
 
virtual void subCycleIndex (const label index)
 Adjust the reported sub-cycle index. More...
 
virtual void endSubCycle ()
 Reset time after sub-cycling back to previous TimeState. More...
 
functionObjectListfunctionObjects ()
 Return non-const access to the list of function objects. More...
 
virtual Timeoperator+= (const dimensionedScalar &deltaT)
 Set deltaT to that specified and increment time via operator++() More...
 
virtual Timeoperator+= (const scalar deltaT)
 Set deltaT to that specified and increment time via operator++() More...
 
virtual Timeoperator++ ()
 Prefix increment,. More...
 
virtual Timeoperator++ (int)
 Postfix increment, this is identical to the prefix increment. More...
 
const fileNamerootPath () const noexcept
 Return root path. More...
 
const fileNamecaseName () const noexcept
 Return case name. More...
 
fileNamecaseName () noexcept
 Return case name. More...
 
- Public Member Functions inherited from clock
 clock ()
 Construct with the current clock time for the start point. More...
 
double elapsedClockTime () const
 Returns wall-clock time since clock instantiation. More...
 
double clockTimeIncrement () const
 Returns wall-clock time since last clockTimeIncrement() call. More...
 
- Public Member Functions inherited from cpuTimePosix
 cpuTimePosix ()
 Construct with the current clock time. More...
 
void resetCpuTime ()
 Reset to use the current time for the start time. More...
 
double elapsedCpuTime () const
 Return CPU time (in seconds) from the start. More...
 
double cpuTimeIncrement () const
 Return CPU time (in seconds) since last call to cpuTimeIncrement() More...
 
- Public Member Functions inherited from TimePaths
 TimePaths (const argList &args, const word &systemName="system", const word &constantName="constant")
 Construct using characteristics given by the argList. More...
 
 TimePaths (const fileName &rootPath, const fileName &caseName, const word &systemName="system", const word &constantName="constant")
 Construct given database name, rootPath and casePath. More...
 
 TimePaths (const bool processorCase, const fileName &rootPath, const bool distributed, const fileName &globalCaseName, const fileName &caseName, const word &systemName="system", const word &constantName="constant")
 Construct given database name, rootPath and casePath. More...
 
bool distributed () const noexcept
 True if case running with parallel distributed directories (ie. not NFS mounted) More...
 
bool processorCase () const noexcept
 Return true if this is a processor case. More...
 
bool processorCase (const bool isProcessorCase) noexcept
 Set processor case status. Return old one. More...
 
const fileNamerootPath () const noexcept
 Return root path. More...
 
const fileNameglobalCaseName () const noexcept
 Return global case name. More...
 
const fileNamecaseName () const noexcept
 Return case name. More...
 
fileNamecaseName () noexcept
 The case name for modification (use with caution) More...
 
fileName path () const
 Return path for the case. More...
 
fileName globalPath () const
 Return global path for the case. More...
 
fileName relativePath (const fileName &input, const bool caseTag=false) const
 Return the input relative to the globalPath by stripping off a leading value of the globalPath. More...
 
const wordconstant () const noexcept
 Return constant name. More...
 
const wordsystem () const noexcept
 Return system name. More...
 
fileName caseConstant () const
 Return the constant name for the case, which is ../constant() for parallel runs. More...
 
fileName caseSystem () const
 Return the system name for the case, which is ../system() for parallel runs. More...
 
fileName constantPath () const
 Return constant path. More...
 
fileName systemPath () const
 Return system path. More...
 
instantList times () const
 Search the case for valid time directories. More...
 
instant findClosestTime (const scalar t) const
 Search the case for the time closest to the given time. More...
 
- Public Member Functions inherited from objectRegistry
 TypeName ("objectRegistry")
 Declare type name for this IOobject. More...
 
 objectRegistry (const Time &db, const label nObjects=128)
 Construct the time objectRegistry, with estimated table capacity (default: 128) More...
 
 objectRegistry (const IOobject &io, const label nObjects=128)
 Construct sub-registry given an IObject to describe the registry, with estimated table capacity (default: 128) More...
 
virtual ~objectRegistry ()
 Destructor, with checkOut() for all objects that are ownedByRegistry. More...
 
const objectRegistrythisDb () const noexcept
 Return the object registry. More...
 
const objectRegistryparent () const noexcept
 Return the parent objectRegistry. More...
 
const Timetime () const noexcept
 Return time registry. More...
 
bool isTimeDb () const noexcept
 True if the registry is Time. More...
 
HashTable< wordHashSetclasses () const
 A summary hash of classes used and their associated object names. More...
 
template<class MatchPredicate >
HashTable< wordHashSetclasses (const MatchPredicate &matchName) const
 A summary hash of classes used and their associated object names, restricted to objects that have a matching object name. More...
 
UPtrList< const regIOobjectcsorted () const
 Return sorted list of objects. More...
 
UPtrList< const regIOobjectsorted () const
 Return sorted list of objects. More...
 
UPtrList< regIOobjectsorted ()
 Return sorted list of objects. More...
 
template<class Type >
UPtrList< const Type > csorted () const
 Return sorted list of objects with a class satisfying isA<Type> More...
 
template<class Type >
UPtrList< const Type > sorted () const
 Return sorted list of objects with a class satisfying isA<Type> More...
 
template<class Type >
UPtrList< Type > sorted ()
 Return sorted list of objects with a class satisfying isA<Type> More...
 
template<class Type , class MatchPredicate >
UPtrList< const Type > csorted (const MatchPredicate &matchName) const
 Return sorted list of objects with a class satisfying isA<Type> that also have a matching object name. More...
 
template<class Type , class MatchPredicate >
UPtrList< const Type > sorted (const MatchPredicate &matchName) const
 Return sorted list of objects with a class satisfying isA<Type> that also have a matching object name. More...
 
template<class Type , class MatchPredicate >
UPtrList< Type > sorted (const MatchPredicate &matchName)
 Return sorted list of objects with a class satisfying isA<Type> that also have a matching object name. More...
 
label count (const char *clsName) const
 The number of objects of the given class name. More...
 
template<class MatchPredicate >
label count (const MatchPredicate &matchClass) const
 The number of objects of the given class name. More...
 
template<class MatchPredicate1 , class MatchPredicate2 >
label count (const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName) const
 The number of objects of the given class name. More...
 
template<class Type >
label count (const bool strict=false) const
 The names of objects with a class satisfying isA<Type> More...
 
template<class Type , class MatchPredicate >
label count (const MatchPredicate &matchName) const
 The names of objects with a class satisfying isA<Type> that also have a matching object name. More...
 
wordList names () const
 The unsorted names of all objects. More...
 
wordList names (const char *clsName) const
 The unsorted names of objects with the given class name. More...
 
template<class MatchPredicate >
wordList names (const MatchPredicate &matchClass) const
 The unsorted names of objects with a matching class name. More...
 
template<class MatchPredicate1 , class MatchPredicate2 >
wordList names (const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName) const
 The unsorted names of objects with a matching class name that also have a matching object name. More...
 
template<class Type >
wordList names () const
 The unsorted names of objects with a class satisfying isA<Type>. More...
 
template<class Type , class MatchPredicate >
wordList names (const MatchPredicate &matchName) const
 The unsorted names of objects with a class satisfying isA<Type> that also have a matching object name. More...
 
wordList sortedNames () const
 The sorted names of all objects. More...
 
wordList sortedNames (const char *clsName) const
 The sorted names of objects with the given class name. More...
 
template<class MatchPredicate >
wordList sortedNames (const MatchPredicate &matchClass) const
 The sorted names objects with a matching class name. More...
 
template<class MatchPredicate1 , class MatchPredicate2 >
wordList sortedNames (const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName) const
 The sorted names of objects with a matching class name that also have a matching object name. More...
 
template<class Type >
wordList sortedNames () const
 The sorted names of objects with a class satisfying isA<Type> More...
 
template<class Type , class MatchPredicate >
wordList sortedNames (const MatchPredicate &matchName) const
 The sorted names of objects with a class satisfying isA<Type> that also have a matching object name. More...
 
const objectRegistrysubRegistry (const word &name, const bool forceCreate=false, const bool recursive=false) const
 Lookup and return a const sub-objectRegistry. More...
 
template<class Type >
HashTable< const Type * > lookupClass (const bool strict=false) const
 Return all objects with a class satisfying isA<Type> More...
 
template<class Type >
HashTable< Type * > lookupClass (const bool strict=false)
 Return all objects with a class satisfying isA<Type> More...
 
const regIOobjectcfindIOobject (const word &name, const bool recursive=false) const
 Return const pointer to the regIOobject. More...
 
bool found (const word &name, const bool recursive=false) const
 Can the regIOobject object be found (by name). More...
 
template<class Type >
bool foundObject (const word &name, const bool recursive=false) const
 Is the named Type found? More...
 
template<class Type >
const Type * cfindObject (const word &name, const bool recursive=false) const
 Return const pointer to the object of the given Type. More...
 
template<class Type >
const Type * findObject (const word &name, const bool recursive=false) const
 Return const pointer to the object of the given Type. More...
 
template<class Type >
Type * findObject (const word &name, const bool recursive=false)
 Return non-const pointer to the object of the given Type. More...
 
template<class Type >
Type * getObjectPtr (const word &name, const bool recursive=false) const
 Return non-const pointer to the object of the given Type, using a const-cast to have it behave like a mutable. More...
 
template<class Type >
const Type & lookupObject (const word &name, const bool recursive=false) const
 Lookup and return const reference to the object of the given Type. Fatal if not found or the wrong type. More...
 
template<class Type >
Type & lookupObjectRef (const word &name, const bool recursive=false) const
 Lookup and return non-const reference to the object of the given Type. Fatal if not found or the wrong type. More...
 
label getEvent () const
 Return new event number. More...
 
bool checkIn (regIOobject *io) const
 Add a regIOobject to registry. A nullptr is ignored. More...
 
bool checkIn (regIOobject &io) const
 Add a regIOobject to registry. More...
 
bool checkOut (regIOobject *io) const
 Remove a regIOobject from registry and free memory if the object is ownedByRegistry. A nullptr is ignored. More...
 
bool checkOut (regIOobject &io) const
 Remove a regIOobject from registry and free memory if the object is ownedByRegistry. More...
 
bool checkOut (const word &key) const
 Remove a regIOobject by name from registry and free memory if the object is ownedByRegistry. More...
 
void clear ()
 Clear all entries from the registry. More...
 
void clearStorage ()
 Clear all entries from the registry and the table itself. More...
 
bool erase (const iterator &iter)
 Erase an entry specified by the given iterator. More...
 
bool erase (const word &key)
 Erase an entry specified by the given key. More...
 
label erase (std::initializer_list< word > keys)
 Remove entries given by the listed keys. More...
 
label erase (const UList< word > &keys)
 Remove entries given by the listed keys. More...
 
virtual void rename (const word &newName)
 Rename. More...
 
virtual bool modified () const
 Return true if any of the object's files have been modified. More...
 
void readModifiedObjects ()
 Read the objects that have been modified. More...
 
virtual bool readIfModified ()
 Read object if modified. More...
 
virtual bool writeData (Ostream &) const
 writeData function required by regIOobject but not used. More...
 
template<class Type >
const Type * lookupObjectPtr (const word &name, bool recursive=false) const
 Deprecated(2018-10) find object. More...
 
template<class Type >
Type * lookupObjectRefPtr (const word &name, bool recursive=false) const
 Deprecated(2018-10) get object pointer, ignoring constness. More...
 
template<class MatchPredicate >
Foam::HashTable< Foam::wordHashSetclassesImpl (const objectRegistry &list, const MatchPredicate &matchName)
 
template<class MatchPredicate1 , class MatchPredicate2 >
Foam::label countImpl (const objectRegistry &list, const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName)
 
template<class Type , class MatchPredicate >
Foam::label countTypeImpl (const objectRegistry &list, const MatchPredicate &matchName)
 
template<class MatchPredicate1 , class MatchPredicate2 >
Foam::wordList namesImpl (const objectRegistry &list, const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName, const bool doSort)
 
template<class Type , class MatchPredicate >
Foam::wordList namesTypeImpl (const objectRegistry &list, const MatchPredicate &matchName, const bool doSort)
 
template<class Type , class MatchPredicate >
Foam::UPtrList< Type > objectsTypeImpl (const objectRegistry &list, const MatchPredicate &matchName)
 
template<class MatchPredicate >
Foam::HashTable< Foam::wordHashSetclasses (const MatchPredicate &matchName) const
 
template<class MatchPredicate >
Foam::label count (const MatchPredicate &matchClass) const
 
template<class MatchPredicate1 , class MatchPredicate2 >
Foam::label count (const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName) const
 
template<class Type , class MatchPredicate >
Foam::label count (const MatchPredicate &matchName) const
 
template<class Type >
Foam::label count (const bool strict) const
 
template<class Type >
Foam::UPtrList< const Type > csorted () const
 
template<class Type >
Foam::UPtrList< const Type > sorted () const
 
template<class Type >
Foam::UPtrList< Type > sorted ()
 
template<class Type , class MatchPredicate >
Foam::UPtrList< const Type > csorted (const MatchPredicate &matchName) const
 
template<class Type , class MatchPredicate >
Foam::UPtrList< const Type > sorted (const MatchPredicate &matchName) const
 
template<class Type , class MatchPredicate >
Foam::UPtrList< Type > sorted (const MatchPredicate &matchName)
 
template<class MatchPredicate >
Foam::wordList names (const MatchPredicate &matchClass) const
 
template<class MatchPredicate1 , class MatchPredicate2 >
Foam::wordList names (const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName) const
 
template<class Type >
Foam::wordList names () const
 
template<class Type , class MatchPredicate >
Foam::wordList names (const MatchPredicate &matchName) const
 
template<class MatchPredicate >
Foam::wordList sortedNames (const MatchPredicate &matchClass) const
 
template<class MatchPredicate1 , class MatchPredicate2 >
Foam::wordList sortedNames (const MatchPredicate1 &matchClass, const MatchPredicate2 &matchName) const
 
template<class Type >
Foam::wordList sortedNames () const
 
template<class Type , class MatchPredicate >
Foam::wordList sortedNames (const MatchPredicate &matchName) const
 
template<class Type >
Foam::HashTable< const Type * > lookupClass (const bool strict) const
 
template<class Type >
Foam::HashTable< Type * > lookupClass (const bool strict)
 
- Public Member Functions inherited from regIOobject
 TypeName ("regIOobject")
 Runtime type information. More...
 
 regIOobject (const IOobject &io, const bool isTimeObject=false)
 Construct from IOobject. The optional flag adds special handling if the object is the top-level regIOobject (eg, Time). More...
 
 regIOobject (const regIOobject &rio)
 Copy construct. More...
 
 regIOobject (const regIOobject &rio, bool registerCopy)
 Copy construct, transferring registry registration to the copy if registerCopy is true. More...
 
 regIOobject (const word &newName, const regIOobject &, bool registerCopy)
 Copy construct with new name, transferring registry registration to the copy f registerCopy is true. More...
 
 regIOobject (const IOobject &io, const regIOobject &rio)
 Copy construct with new IO parameters. More...
 
virtual ~regIOobject ()
 Destructor. More...
 
bool checkIn ()
 Add object to registry, if not already registered. More...
 
bool checkOut ()
 Remove all file watches and remove object from registry. More...
 
virtual void addWatch ()
 Add file watch on object (if registered and READ_IF_MODIFIED) More...
 
bool registered () const noexcept
 Query the registered state (ie, has been checked in). This is not necessarily the same as registerObject(), which is just a stated preference. More...
 
bool ownedByRegistry () const noexcept
 Is this object owned by the registry? More...
 
bool store ()
 Register object with its registry and transfer ownership to the registry. More...
 
void release (const bool unregister=false) noexcept
 Set object as not ownedByRegistry. More...
 
label eventNo () const noexcept
 Event number at last update. More...
 
label & eventNo () noexcept
 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 as up-to-date. More...
 
const dictionaryfindMetaData () const noexcept
 Return pointer to meta-data or nullptr. More...
 
dictionarygetMetaData () noexcept
 Get or create meta-data. More...
 
void removeMetaData ()
 Remove meta-data. More...
 
virtual void updateMetaData ()
 Update internal meta-data (eg, prior to writing) More...
 
virtual fileName filePath () const
 Return complete path + object name if the file exists. More...
 
bool headerOk ()
 Read and check header info. Does not check the headerClassName. More...
 
IstreamreadStream (const word &, const bool valid=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 label addWatch (const fileName &)
 Add file watch for fileName on object if not yet watched. More...
 
const labelListwatchIndices () const noexcept
 Read access to file-monitoring handles. More...
 
labelListwatchIndices () noexcept
 Write access to file-monitoring handles. More...
 
virtual bool write (const bool valid=true) const
 Write using setting from DB. More...
 
virtual bool global () const
 Is object global. More...
 
void operator= (const IOobject &io)
 Copy assignment. More...
 
virtual bool writeObject (IOstreamOption::streamFormat fmt, IOstreamOption::versionNumber ver, IOstreamOption::compressionType cmp, const bool valid) const
 Write using given format, version and compression. More...
 
- Public Member Functions inherited from IOobject
 TypeName ("IOobject")
 Declare type-name, virtual type (with debug switch) More...
 
 IOobject (const IOobject &)=default
 Copy construct. More...
 
virtual ~IOobject ()=default
 Destructor. More...
 
 IOobject (const word &name, const fileName &instance, const objectRegistry &registry, IOobjectOption ioOpt=IOobjectOption())
 Construct from name, instance, registry, io options. More...
 
 IOobject (const word &name, const fileName &instance, const fileName &local, const objectRegistry &registry, IOobjectOption ioOpt=IOobjectOption())
 Construct from name, instance, local, registry, io options. More...
 
 IOobject (const fileName &path, const objectRegistry &registry, IOobjectOption ioOpt=IOobjectOption())
 Construct from path, registry, io options. More...
 
 IOobject (const word &name, const fileName &instance, const objectRegistry &registry, IOobjectOption::readOption rOpt, IOobjectOption::writeOption wOpt=IOobjectOption::NO_WRITE, bool registerObject=true, bool globalObject=false)
 Construct from name, instance, registry, io options. More...
 
 IOobject (const word &name, const fileName &instance, const fileName &local, const objectRegistry &registry, IOobjectOption::readOption rOpt, IOobjectOption::writeOption wOpt=IOobjectOption::NO_WRITE, bool registerObject=true, bool globalObject=false)
 Construct from name, instance, local, registry, io options. More...
 
 IOobject (const fileName &path, const objectRegistry &registry, IOobjectOption::readOption rOpt, IOobjectOption::writeOption wOpt=IOobjectOption::NO_WRITE, bool registerObject=true, bool globalObject=false)
 Construct from path, registry, io options. More...
 
 IOobject (const IOobject &io, const objectRegistry &registry)
 Copy construct, resetting registry. More...
 
 IOobject (const IOobject &io, const word &name)
 Copy construct, resetting name. More...
 
 IOobject (const IOobject &io, const word &name, const fileName &local)
 Copy construct, resetting name and local component. More...
 
 IOobject (const IOobject &io, IOobjectOption::readOption rOpt, IOobjectOption::writeOption wOpt)
 Copy construct, resetting read/write options. More...
 
autoPtr< IOobjectclone () const
 Clone. More...
 
autoPtr< IOobjectclone (const objectRegistry &registry) const
 Clone resetting registry. More...
 
const objectRegistrydb () const noexcept
 Return the local objectRegistry. More...
 
const Timetime () const
 Return Time associated with the objectRegistry. More...
 
const wordname () const noexcept
 Return the object name. More...
 
const wordheaderClassName () const noexcept
 Return name of the class name read from header. More...
 
wordheaderClassName () noexcept
 Return non-constant access to the class name read from header. More...
 
const stringnote () const noexcept
 Return the optional note. More...
 
stringnote () noexcept
 Modifiable access to the optional note. More...
 
unsigned labelByteSize () const noexcept
 The sizeof (label) in bytes, possibly read from the header. More...
 
unsigned scalarByteSize () const noexcept
 The sizeof (scalar) in bytes, possibly read from the header. More...
 
bool hasHeaderClass () const noexcept
 True if headerClassName() is non-empty (after reading) More...
 
template<class Type >
bool isHeaderClass () const
 Check if headerClassName() equals Type::typeName. More...
 
template<class Type >
bool isHeaderClassName () const
 Same as isHeaderClass() More...
 
word group () const
 Return group (extension part of name) More...
 
word member () const
 Return member (name without the extension) More...
 
const fileNamerootPath () const
 Return the Time::rootPath() More...
 
const fileNamecaseName () const
 Return the Time::caseName() More...
 
const fileNameinstance () const noexcept
 Read access to instance path component. More...
 
fileNameinstance () noexcept
 Write access to instance path component. More...
 
const fileNamelocal () const noexcept
 Read access to local path component. More...
 
fileName path () const
 The complete path. More...
 
fileName path (const word &instance, const fileName &local=fileName::null) const
 The complete path with alternative instance and local. More...
 
fileName objectPath () const
 The complete path + object name. More...
 
fileName objectRelPath () const
 The object path relative to the root. More...
 
fileName localFilePath (const word &typeName, const bool search=true) const
 Redirect to fileHandler filePath, searching locally. More...
 
fileName globalFilePath (const word &typeName, const bool search=true) const
 Redirect to fileHandler filePath, searching up if in parallel. More...
 
IOstreamOption parseHeader (const dictionary &headerDict)
 Parse 'FoamFile' header contents and set the IOobject characteristics and return the stream characteristics. More...
 
bool readHeader (Istream &is)
 Read header ('FoamFile' dictionary) and set the IOobject and stream characteristics. More...
 
bool readHeader (dictionary &headerDict, Istream &is)
 Read header (the 'FoamFile' dictionary) and set the IOobject and stream characteristics. More...
 
template<class Type >
bool typeHeaderOk (const bool checkType=true, const bool search=true, const bool verbose=true)
 Read header (uses typeFilePath to find file) and check its info. More...
 
template<class Type >
void warnNoRereading () const
 Helper: warn that type does not support re-reading. More...
 
bool writeHeader (Ostream &os) const
 Write header with current type() More...
 
bool writeHeader (Ostream &os, const word &objectType) const
 Write header with override of type. More...
 
void writeHeader (dictionary &dict, IOstreamOption streamOpt) const
 Write header into a dictionary with current type() and given output format. More...
 
void writeHeader (dictionary &dict, const word &objectType, IOstreamOption streamOpt) const
 Write header into a dictionary with override of type and given output format. More...
 
bool good () const noexcept
 Did last readHeader() succeed? More...
 
bool bad () const noexcept
 Did last readHeader() fail? More...
 
InfoProxy< IOobjectinfo () const
 Return info proxy, for printing information to a stream. More...
 
void operator= (const IOobject &io)
 Copy assignment, copies all values (except the registry) More...
 
template<>
bool isHeaderClass () const
 Specialization for void always returns true (no headerClassName check). More...
 
template<class StringType >
Foam::word groupName (StringType base, const word &group)
 
- Public Member Functions inherited from IOobjectOption
constexpr IOobjectOption (readOption rOpt=readOption::NO_READ, writeOption wOpt=writeOption::NO_WRITE, registerOption registerObject=registerOption::REGISTER, bool globalObject=false) noexcept
 Default construct (NO_READ, NO_WRITE, register, non-global) or construct with specified options. More...
 
constexpr IOobjectOption (readOption rOpt, registerOption registerObject=registerOption::REGISTER, bool globalObject=false) noexcept
 Construct NO_WRITE with specified read/register options. More...
 
constexpr IOobjectOption (writeOption wOpt, registerOption registerObject=registerOption::REGISTER, bool globalObject=false) noexcept
 Construct NO_READ with specified write/register options. More...
 
constexpr IOobjectOption (registerOption registerObject, bool globalObject=false) noexcept
 Construct (NO_READ, NO_WRITE) with specified register option. More...
 
constexpr IOobjectOption (readOption rOpt, writeOption wOpt, bool registerObject, bool globalObject=false) noexcept
 Construct from components with specified register option as bool. More...
 
constexpr IOobjectOption (bool registerObject, bool globalObject=false) noexcept
 Construct (NO_READ, NO_WRITE) with specified register option as bool. More...
 
readOption readOpt () const noexcept
 Get the read option. More...
 
readOption readOpt (readOption opt) noexcept
 Set the read option. More...
 
writeOption writeOpt () const noexcept
 Get the write option. More...
 
writeOption writeOpt (writeOption opt) noexcept
 Set the write option. More...
 
bool registerObject () const noexcept
 Should objects created with this IOobject be registered? More...
 
bool registerObject (bool on) noexcept
 Change registration preference. More...
 
bool globalObject () const noexcept
 True if object is treated the same for all processors. More...
 
bool globalObject (bool on) noexcept
 Change global-object status. More...
 
bool isReadRequired () const noexcept
 True if (MUST_READ | MUST_READ_IF_MODIFIED) bits are set. More...
 
bool isReadOptional () const noexcept
 True if (READ_IF_PRESENT) bits are set. More...
 
readOptionreadOpt () noexcept
 Access to the read option. More...
 
writeOptionwriteOpt () noexcept
 Access to the write option. More...
 
bool & registerObject () noexcept
 Access to the register object option. More...
 
bool & globalObject () noexcept
 Access to the global object option. More...
 
- Public Member Functions inherited from HashTable< regIOobject *>
 HashTable ()
 Default construct with default (128) table capacity. More...
 
 HashTable (const label size)
 Construct given initial table capacity. More...
 
 HashTable (Istream &is, const label size=128)
 Construct from Istream with default table capacity. More...
 
 HashTable (const this_type &ht)
 Copy construct. More...
 
 HashTable (this_type &&rhs)
 Move construct. More...
 
 HashTable (std::initializer_list< std::pair< word, regIOobject * >> list)
 Construct from an initializer list. More...
 
 ~HashTable ()
 Destructor. More...
 
label capacity () const noexcept
 The size of the underlying table. More...
 
label size () const noexcept
 The number of elements in table. More...
 
bool empty () const noexcept
 True if the hash table is empty. More...
 
regIOobject * & at (const word &key)
 Find and return a hashed entry. FatalError if it does not exist. More...
 
const regIOobject * & at (const word &key) const
 Find and return a hashed entry. FatalError if it does not exist. More...
 
bool found (const word &key) const
 True if hashed key is found in table. More...
 
iterator find (const word &key)
 Find and return an iterator set at the hashed entry. More...
 
const_iterator find (const word &key) const
 Find and return an const_iterator set at the hashed entry. More...
 
const_iterator cfind (const word &key) const
 Find and return an const_iterator set at the hashed entry. More...
 
const regIOobject * & lookup (const word &key, const regIOobject * &deflt) const
 Return hashed entry if it exists, or return the given default. More...
 
List< wordtoc () const
 The table of contents (the keys) in unsorted order. More...
 
List< wordsortedToc () const
 The table of contents (the keys) in sorted order. More...
 
List< wordsortedToc (const Compare &comp) const
 The table of contents (the keys) sorted according to the specified comparator. More...
 
Foam::List< wordsortedToc (const Compare &comp) const
 
List< wordtocKeys (const UnaryPredicate &pred, const bool invert=false) const
 The table of contents (the keys) selected according to the unary predicate applied to the keys. More...
 
Foam::List< wordtocKeys (const UnaryPredicate &pred, const bool invert) const
 
List< wordtocValues (const UnaryPredicate &pred, const bool invert=false) const
 The table of contents (the keys) selected according to the unary predicate applied to the values. More...
 
Foam::List< wordtocValues (const UnaryPredicate &pred, const bool invert) const
 
List< wordtocEntries (const BinaryPredicate &pred, const bool invert=false) const
 The table of contents (the keys) selected according to the binary predicate applied to the keys and values. More...
 
Foam::List< wordtocEntries (const BinaryPredicate &pred, const bool invert) const
 
UPtrList< const node_typecsorted () const
 Const access to the hash-table contents in sorted order (sorted by keys). More...
 
UPtrList< const node_typesorted () const
 Const access to the hash-table contents in sorted order (sorted by keys). More...
 
UPtrList< node_typesorted ()
 Non-const access to the hash-table contents in sorted order (sorted by keys). More...
 
label countKeys (const UnaryPredicate &pred, const bool invert=false) const
 Count the number of keys that satisfy the unary predicate. More...
 
Foam::label countKeys (const UnaryPredicate &pred, const bool invert) const
 
label countValues (const UnaryPredicate &pred, const bool invert=false) const
 Count the number of values that satisfy the unary predicate. More...
 
Foam::label countValues (const UnaryPredicate &pred, const bool invert) const
 
label countEntries (const BinaryPredicate &pred, const bool invert=false) const
 Count the number of entries that satisfy the binary predicate. More...
 
Foam::label countEntries (const BinaryPredicate &pred, const bool invert) const
 
bool emplace (const word &key, Args &&... args)
 Emplace insert a new entry, not overwriting existing entries. More...
 
bool emplace_set (const word &key, Args &&... args)
 Emplace set an entry, overwriting any existing entries. More...
 
bool insert (const word &key, const regIOobject * &obj)
 Copy insert a new entry, not overwriting existing entries. More...
 
bool insert (const word &key, regIOobject * &&obj)
 Move insert a new entry, not overwriting existing entries. More...
 
bool set (const word &key, const regIOobject * &obj)
 Copy assign a new entry, overwriting existing entries. More...
 
bool set (const word &key, regIOobject * &&obj)
 Move assign a new entry, overwriting existing entries. More...
 
bool erase (const iterator &iter)
 Erase an entry specified by given iterator. More...
 
bool erase (const word &key)
 Erase an entry specified by the given key. More...
 
label erase (const HashTable< AnyType, word, AnyHash > &other)
 Remove table entries given by keys of the other hash-table. More...
 
label erase (std::initializer_list< word > keys)
 Remove table entries given by the listed keys. More...
 
label erase (InputIter first, InputIter last)
 Remove multiple entries using an iterator range of keys. More...
 
label erase (const FixedList< word, N > &keys)
 Remove table entries given by the listed keys. More...
 
label erase (const UList< word > &keys)
 Remove table entries given by the listed keys. More...
 
Foam::label erase (InputIter first, InputIter last)
 
Foam::label erase (const FixedList< word, N > &keys)
 
Foam::label erase (const HashTable< AnyType, word, AnyHash > &other)
 
label retain (const HashTable< AnyType, word, AnyHash > &other)
 Retain table entries given by keys of the other hash-table. More...
 
Foam::label retain (const HashTable< AnyType, word, AnyHash > &other)
 
label filterKeys (const UnaryPredicate &pred, const bool pruning=false)
 Generalized means to filter table entries based on their keys. More...
 
Foam::label filterKeys (const UnaryPredicate &pred, const bool pruning)
 
label filterValues (const UnaryPredicate &pred, const bool pruning=false)
 Generalized means to filter table entries based on their values. More...
 
Foam::label filterValues (const UnaryPredicate &pred, const bool pruning)
 
label filterEntries (const BinaryPredicate &pred, const bool pruning=false)
 Generalized means to filter table entries based on their key/value. More...
 
Foam::label filterEntries (const BinaryPredicate &pred, const bool pruning)
 
void resize (const label sz)
 Resize the hash table for efficiency. More...
 
void clear ()
 Clear all entries from table. More...
 
void clearStorage ()
 Clear the table entries and the table itself. More...
 
void swap (HashTable< regIOobject *, word, Foam::Hash< word > > &rhs)
 Swap contents into this table. More...
 
void transfer (HashTable< regIOobject *, word, Foam::Hash< word > > &rhs)
 Transfer contents into this table. More...
 
regIOobject * & operator[] (const word &key)
 Find and return a hashed entry. FatalError if it does not exist. More...
 
const regIOobject * & operator[] (const word &key) const
 Find and return a hashed entry. FatalError if it does not exist. More...
 
regIOobject * & operator() (const word &key)
 Return existing entry or create a new entry. More...
 
regIOobject * & operator() (const word &key, const regIOobject * &deflt)
 Return existing entry or insert a new entry. More...
 
void operator= (const this_type &rhs)
 Copy assign. More...
 
void operator= (std::initializer_list< std::pair< word, regIOobject * >> rhs)
 Copy assign from an initializer list. More...
 
void operator= (this_type &&rhs)
 Move assign. More...
 
bool operator== (const this_type &rhs) const
 Equality. Tables are equal if all keys and values are equal, independent of order or underlying storage size. More...
 
bool operator!= (const this_type &rhs) const
 The opposite of the equality operation. More...
 
this_typeoperator+= (const this_type &rhs)
 Add entries into this HashTable. More...
 
const_iterator_pair< const_key_iterator, this_typekeys () const
 A const iterator begin/end pair for iterating over keys. More...
 
iterator begin ()
 iterator set to the beginning of the HashTable More...
 
const_iterator begin () const
 const_iterator set to the beginning of the HashTable More...
 
const_iterator cbegin () const
 const_iterator set to the beginning of the HashTable More...
 
iterator end () noexcept
 iterator to signal the end (for any HashTable) More...
 
const_iterator end () const noexcept
 const_iterator to signal the end (for any HashTable) More...
 
constexpr const_iterator cend () const noexcept
 const_iterator to signal the end (for any HashTable) More...
 
OstreamprintInfo (Ostream &os) const
 Print information. More...
 
OstreamwriteKeys (Ostream &os, const label shortLen=0) const
 Write unordered keys (list), with line-breaks when length exceeds shortLen. More...
 
- Public Member Functions inherited from HashTableCore
 ClassName ("HashTable")
 Declare type-name (with debug switch) More...
 
 HashTableCore () noexcept=default
 Default construct. More...
 
- Public Member Functions inherited from TimeState
 TimeState ()
 Construct a zero time state, using the current time formatting. More...
 
virtual ~TimeState ()=default
 Destructor. More...
 
virtual scalar userTimeToTime (const scalar theta) const
 Convert the user-time (e.g. CA deg) to real-time (s). More...
 
virtual scalar timeToUserTime (const scalar t) const
 Convert the real-time (s) into user-time (e.g. CA deg) More...
 
scalar timeOutputValue () const
 Return current time value. More...
 
label timeIndex () const noexcept
 Return current time index. More...
 
scalar deltaTValue () const noexcept
 Return time step value. More...
 
scalar deltaT0Value () const noexcept
 Return old time step value. More...
 
dimensionedScalar deltaT () const
 Return time step. More...
 
dimensionedScalar deltaT0 () const
 Return old time step. More...
 
bool writeTime () const noexcept
 True if this is a write time. More...
 
bool outputTime () const noexcept
 Deprecated(2016-05) return true if this is a write time. More...
 
- Public Member Functions inherited from dimensioned< Type >
 dimensioned ()
 A dimensionless Zero, named "0". More...
 
 dimensioned (const dimensionSet &dims)
 A dimensioned Zero, named "0". More...
 
 dimensioned (const dimensionSet &dims, const Foam::zero)
 A dimensioned Zero, named "0". More...
 
 dimensioned (const dimensionSet &dims, const Foam::one)
 A dimensioned pTraits::one, named "1". More...
 
 dimensioned (const Type &val)
 Implicit construct dimensionless from given value. More...
 
 dimensioned (const dimensionSet &dims, const Type &val)
 Construct dimensioned from given value. More...
 
 dimensioned (const word &name, const dimensionSet &dims, const Type &val)
 Construct from components (name, dimensions, value). More...
 
 dimensioned (const word &name, const dimensioned< Type > &dt)
 Copy construct dimensioned Type with a new name. More...
 
 dimensioned (const primitiveEntry &e)
 Construct from primitive entry with given name. More...
 
 dimensioned (const primitiveEntry &e, const dimensionSet &dims)
 Construct from primitive entry with given name and dimensions. More...
 
 dimensioned (const word &name, const dictionary &dict)
 Construct from dictionary lookup with a given name. More...
 
 dimensioned (const word &name, const dimensionSet &dims, const dictionary &dict)
 Construct from dictionary lookup with a given name and dimensions. More...
 
 dimensioned (const word &name, const dimensionSet &dims, const dictionary &dict, const word &entryName)
 Construct from dictionary lookup with a given name and dimensions. More...
 
 dimensioned (const word &name, const dimensionSet &dims, const Type &val, const dictionary &dict)
 Construct from components (name, dimensions, value) with optional dictionary override. More...
 
const wordname () const noexcept
 Return const reference to name. More...
 
wordname () noexcept
 Return non-const reference to name. More...
 
const dimensionSetdimensions () const noexcept
 Return const reference to dimensions. More...
 
dimensionSetdimensions () noexcept
 Return non-const reference to dimensions. More...
 
const Type & value () const noexcept
 Return const reference to value. More...
 
Type & value () noexcept
 Return non-const reference to value. More...
 
dimensioned< cmptTypecomponent (const direction d) const
 Return a component as a dimensioned<cmptType> More...
 
void replace (const direction d, const dimensioned< cmptType > &dc)
 Return a component with a dimensioned<cmptType> More...
 
dimensioned< Type > T () const
 Return transpose. More...
 
bool read (const dictionary &dict)
 Update the value of dimensioned<Type>, lookup in dictionary with the name(). More...
 
bool readIfPresent (const dictionary &dict)
 Update the value of dimensioned<Type> if found in the dictionary, lookup in dictionary with the name(). More...
 
bool read (const word &entryName, const dictionary &dict)
 Update the value of dimensioned<Type>, using an alternative entry name. More...
 
bool readIfPresent (const word &entryName, const dictionary &dict)
 Update the value of dimensioned<Type> if found in the dictionary, using an alternative entry name. More...
 
Istreamread (Istream &is, const bool readName=true)
 Read (name, dimensions, value) from stream, using units from system table. More...
 
Istreamread (Istream &is, const dictionary &readSet)
 Read (name, dimensions, value) from stream, using units from dictionary. More...
 
Istreamread (Istream &is, const HashTable< dimensionedScalar > &readSet)
 Read (name, dimensions, value) from stream, using units from table. More...
 
void writeEntry (const word &keyword, Ostream &os) const
 Write as a dictionary entry with keyword. More...
 
dimensioned< cmptTypeoperator[] (const direction d) const
 Return a component as a dimensioned<cmptType> More...
 
void operator+= (const dimensioned< Type > &dt)
 
void operator-= (const dimensioned< Type > &dt)
 
void operator*= (const scalar s)
 
void operator/= (const scalar s)
 
 dimensioned (Istream &is)
 Deprecated(2018-11) Construct from Istream (expects name, dimensions, value) More...
 
 dimensioned (const word &name, Istream &is)
 Deprecated(2018-11) Construct from Istream with given name (expects dimensions, value) More...
 
 dimensioned (const word &name, const dimensionSet &dims, Istream &is)
 Deprecated(2018-11) Construct from Istream with given name and expected dimensions. More...
 

Static Public Member Functions

static autoPtr< TimeNew ()
 Construct (dummy) Time - no functionObjects or libraries. More...
 
static autoPtr< TimeNew (const fileName &caseDir)
 Construct (dummy) Time - no functionObjects or libraries. More...
 
static autoPtr< TimeNew (const argList &args)
 Construct (dummy) Time - no functionObjects or libraries. More...
 
static word timeName (const scalar t, const int precision=precision_)
 Return time name of given scalar time formatted with the given precision. More...
 
- Static Public Member Functions inherited from clock
static time_t getTime ()
 Get the current clock time in seconds. More...
 
static const struct tm rawDate ()
 The current wall-clock date as a raw struct. More...
 
static std::string dateTime ()
 The current wall-clock date/time (in local time) as a string in ISO-8601 format (yyyy-mm-ddThh:mm:ss). More...
 
static std::string date ()
 The current wall-clock date as a string formatted as (MON dd yyyy), where MON is Jan, Feb, etc. More...
 
static std::string clockTime ()
 The current wall-clock (in local time) as a string formatted as as (hh:mm:ss). More...
 
- Static Public Member Functions inherited from TimePaths
static instantList findTimes (const fileName &directory, const word &constantName="constant")
 Search a given directory for valid time directories. More...
 
static label findClosestTimeIndex (const instantList &timeDirs, const scalar t, const word &constantName="constant")
 Search instantList for the time index closest to the specified time. More...
 
- Static Public Member Functions inherited from regIOobject
template<class Type >
static Type & store (Type *p)
 Transfer pointer ownership to its registry. More...
 
template<class Type >
static Type & store (autoPtr< Type > &ptr)
 Transfer pointer ownership to its registry. More...
 
template<class Type >
static Type & store (autoPtr< Type > &&ptr)
 Transfer pointer ownership to its registry. More...
 
template<class Type >
static Type & store (refPtr< Type > &ptr)
 Transfer pointer ownership to its registry. More...
 
template<class Type >
static Type & store (refPtr< Type > &&ptr)
 Transfer pointer ownership to its registry. More...
 
template<class Type >
static Type & store (tmp< Type > &ptr)
 Transfer pointer ownership to its registry. More...
 
template<class Type >
static Type & store (tmp< Type > &&ptr)
 Transfer pointer ownership to its registry. More...
 
- Static Public Member Functions inherited from IOobject
static bool bannerEnabled () noexcept
 Status of output file banner. More...
 
static bool bannerEnabled (bool on) noexcept
 Enable/disable output file banner. More...
 
static bool fileNameComponents (const fileName &path, fileName &instance, fileName &local, word &name)
 Split path into instance, local, name components. More...
 
template<class StringType >
static word groupName (StringType base, const word &group)
 Create dot-delimited name.group string. More...
 
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...
 
static word scopedName (const std::string &scope, const word &name)
 Create scope:name or scope_name string. More...
 
static IOobject selectIO (const IOobject &io, const fileName &altFile, const word &ioName="")
 Return the IOobject, but also consider an alternative file name. More...
 
static OstreamwriteBanner (Ostream &os, const bool noSyntaxHint=false)
 Write the standard OpenFOAM file/dictionary banner. More...
 
static OstreamwriteDivider (Ostream &os)
 Write the standard file section divider. More...
 
static OstreamwriteEndDivider (Ostream &os)
 Write the standard end file divider. More...
 
- Static Public Member Functions inherited from IOobjectOption
static bool isReadRequired (readOption opt) noexcept
 True if (MUST_READ | MUST_READ_IF_MODIFIED) bits are set. More...
 
static bool isReadOptional (readOption opt) noexcept
 True if (READ_IF_PRESENT) bits are set. More...
 
- Static Public Member Functions inherited from HashTableCore
static label canonicalSize (const label requested_size)
 Return a canonical (power-of-two) of the requested size. More...
 
- Static Public Member Functions inherited from dimensioned< Type >
static dimensioned< Type > getOrDefault (const word &name, const dictionary &dict, const dimensionSet &dims=dimless, const Type &deflt=Type(Zero))
 Construct dimensioned from dictionary, with default value. More...
 
static dimensioned< Type > getOrDefault (const word &name, const dictionary &dict, const Type &deflt=Type(Zero))
 Construct dimensionless from dictionary, with default value. More...
 
static dimensioned< Type > getOrAddToDict (const word &name, dictionary &dict, const dimensionSet &dims=dimless, const Type &deflt=Type(Zero))
 Construct dimensioned from dictionary, with default value. More...
 
static dimensioned< Type > getOrAddToDict (const word &name, dictionary &dict, const Type &deflt=Type(Zero))
 Construct dimensionless from dictionary, with default value. More...
 
static dimensioned< Type > lookupOrDefault (const word &name, const dictionary &dict, const dimensionSet &dims=dimless, const Type &deflt=Type(Zero))
 Construct dimensioned from dictionary, with default value. FatalIOError if there are excess tokens. More...
 
static dimensioned< Type > lookupOrDefault (const word &name, const dictionary &dict, const Type &deflt=Type(Zero))
 Construct dimensionless from dictionary, with default value. More...
 
static dimensioned< Type > lookupOrAddToDict (const word &name, dictionary &dict, const dimensionSet &dims=dimless, const Type &deflt=Type(Zero))
 Construct dimensioned from dictionary, with default value. More...
 
static dimensioned< Type > lookupOrAddToDict (const word &name, dictionary &dict, const Type &deflt=Type(Zero))
 Construct dimensionless from dictionary, with default value. More...
 

Static Public Attributes

static const Enum< writeControlswriteControlNames
 Names for writeControls. More...
 
static const Enum< stopAtControlsstopAtControlNames
 Names for stopAtControls. More...
 
static int printExecutionFormat_
 Style for "ExecutionTime = " output. More...
 
static word controlDictName
 The default control dictionary name (normally "controlDict") More...
 
- Static Public Attributes inherited from IOobject
static const Enum< fileCheckTypesfileCheckTypesNames
 Names for the fileCheckTypes. More...
 
static char scopeSeparator
 Character for scoping object names (':' or '_') More...
 
static fileCheckTypes fileModificationChecking
 Type of file modification checking. More...
 
static float fileModificationSkew
 Time skew (seconds) for file modification checks. More...
 
static int maxFileModificationPolls
 Max number of times to poll for file modification changes. More...
 
- Static Public Attributes inherited from HashTableCore
static const label maxTableSize
 Maximum allowable internal table size. Approximately labelMax/4. More...
 

Protected Member Functions

void adjustDeltaT ()
 Adjust the time step so that writing occurs at the specified time. More...
 
void setControls ()
 Set the controls from the current controlDict. More...
 
void setMonitoring (const bool forceProfiling=false)
 Set file monitoring, profiling, etc. More...
 
virtual void readDict ()
 Read the control dictionary and set the write controls etc. More...
 
- Protected Member Functions inherited from regIOobject
bool readHeaderOk (const IOstreamOption::streamFormat fmt, const word &typeName)
 Helper: check readOpt flags and read if necessary. More...
 
- Protected Member Functions inherited from IOobject
void setBad (const string &s)
 Set the object state to bad. More...
 
- Protected Member Functions inherited from HashTable< regIOobject *>
bool iterator_erase (node_type *&entry, label &index)
 Low-level entry erasure using iterator internals. More...
 

Protected Attributes

label startTimeIndex_
 
scalar startTime_
 
scalar endTime_
 
stopAtControls stopAt_
 
writeControls writeControl_
 
scalar writeInterval_
 
label purgeWrite_
 
FIFOStack< wordpreviousWriteTimes_
 
label subCycling_
 The total number of sub-cycles, the current sub-cycle index, or 0 if time is not being sub-cycled. More...
 
bool writeOnce_
 
autoPtr< TimeStateprevTimeState_
 If time is being sub-cycled this is the previous TimeState. More...
 
sigWriteNow sigWriteNow_
 Signal handler for one-shot writing upon signal. More...
 
sigStopAtWriteNow sigStopAtWriteNow_
 Signal handler for write and clean exit upon signal. More...
 
- Protected Attributes inherited from TimeState
label timeIndex_
 
label writeTimeIndex_
 
scalar deltaT_
 
scalar deltaT0_
 
scalar deltaTSave_
 
bool deltaTchanged_
 
bool writeTime_
 

Static Protected Attributes

static fmtflags format_
 Time directory name format. More...
 
static int precision_
 Time directory name precision. More...
 
static const int maxPrecision_
 Maximum time directory name precision. More...
 
- Static Protected Attributes inherited from regIOobject
static bool masterOnlyReading = false
 To flag master-only reading of objects. More...
 

Additional Inherited Members

- Static Protected Member Functions inherited from IOobject
static void writeHeaderContent (Ostream &os, const IOobject &io, const word &objectType, const dictionary *metaDataDict=nullptr)
 Helper: write content for FoamFile IOobject header with optional meta information. More...
 
static void writeHeaderContent (dictionary &dict, const IOobject &io, const word &objectType, IOstreamOption streamOpt, const dictionary *metaDataDict=nullptr)
 Helper: write dictionary content for FoamFile header with optional meta information. More...
 

Detailed Description

Class to control time during OpenFOAM simulations that is also the top-level objectRegistry.

Source files

Definition at line 69 of file Time.H.

Member Enumeration Documentation

◆ writeControls

Write control options.

Enumerator
wcNone 

"none"

wcTimeStep 

"timeStep"

wcRunTime 

"runTime"

wcAdjustableRunTime 

"adjustable" / "adjustableRunTime"

wcClockTime 

"clockTime"

wcCpuTime 

"cpuTime"

wcUnknown 

Dummy no-op.

Definition at line 82 of file Time.H.

◆ stopAtControls

Stop-run control options, which are primarily used when altering the stopAt condition.

Enumerator
saEndTime 

Stop when Time reaches prescribed endTime.

saNoWriteNow 

Adjust endTime to stop immediately w/o writing.

saWriteNow 

adjust endTime to stop immediately w/ writing

saNextWrite 

stop at the next data write interval

saUnknown 

Dummy no-op. Do not change current value.

Definition at line 97 of file Time.H.

◆ fmtflags

enum fmtflags

Supported time directory name formats.

Enumerator
general 

default float notation

fixed 

fixed-point notation

scientific 

scientific notation

Definition at line 109 of file Time.H.

Constructor & Destructor Documentation

◆ Time() [1/8]

Time ( const word ctrlDictName,
const argList args,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)
inline

Construct from dictionary name to read and argument list.

Uses "system" and "constant" for its directories.

Definition at line 24 of file TimeI.H.

◆ Time() [2/8]

Time ( const word ctrlDictName,
const fileName rootPath,
const fileName caseName,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)
inline

Construct given name of dictionary to read and root/case paths.

Uses "system" and "constant" for its directories.

Definition at line 44 of file TimeI.H.

◆ Time() [3/8]

Time ( const dictionary dict,
const fileName rootPath,
const fileName caseName,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)
inline

Construct given dictionary and root/case paths.

Uses "system" and "constant" for its directories.

Definition at line 66 of file TimeI.H.

◆ Time() [4/8]

Time ( const fileName rootPath,
const fileName caseName,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)
inline

Construct at endTime and root/case paths.

Uses "system" and "constant" for its directories.

Definition at line 88 of file TimeI.H.

◆ Time() [5/8]

Time ( const word ctrlDictName,
const argList args,
const word systemName,
const word constantName,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)

Construct from dictionary name to read and argument list.

Use specified system/constant directory names.

Parameters
systemName"system" directory name
constantName"constant" directory name

Definition at line 477 of file Time.C.

References argList::allowFunctionObjects(), argList::allowLibs(), args, argList::found(), and IOobjectOption::MUST_READ_IF_MODIFIED.

Here is the call graph for this function:

◆ Time() [6/8]

Time ( const word ctrlDictName,
const fileName rootPath,
const fileName caseName,
const word systemName,
const word constantName,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)

Construct given name of dictionary to read and root/case paths.

Use specified system/constant directory names.

Parameters
systemName"system" directory name
constantName"constant" directory name

Definition at line 404 of file Time.C.

References IOobjectOption::MUST_READ_IF_MODIFIED.

◆ Time() [7/8]

Time ( const dictionary dict,
const fileName rootPath,
const fileName caseName,
const word systemName,
const word constantName,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)

Construct given dictionary and root/case paths.

Use specified system/constant directory names.

Parameters
systemName"system" directory name
constantName"constant" directory name

Definition at line 553 of file Time.C.

References IOobjectOption::MUST_READ_IF_MODIFIED.

◆ Time() [8/8]

Time ( const fileName rootPath,
const fileName caseName,
const word systemName,
const word constantName,
const bool  enableFunctionObjects = true,
const bool  enableLibs = true 
)

Construct given endTime and root/case paths.

Use specified system/constant directory names.

Parameters
systemName"system" directory name
constantName"constant" directory name

Definition at line 631 of file Time.C.

◆ ~Time()

~Time ( )
virtual

Destructor.

Definition at line 738 of file Time.C.

References objectRegistry::clear(), Foam::fileHandler, forAllReverse, and profiling::stop().

Here is the call graph for this function:

Member Function Documentation

◆ adjustDeltaT()

void adjustDeltaT ( )
protected

Adjust the time step so that writing occurs at the specified time.

Definition at line 92 of file Time.C.

References functionObjectList::adjustTimeStep(), TimeState::deltaT_, Foam::labelMax, Foam::max(), Foam::min(), Time::startTime_, dimensioned< Type >::value(), Time::wcAdjustableRunTime, Time::writeControl_, Time::writeInterval_, and TimeState::writeTimeIndex_.

Here is the call graph for this function:

◆ setControls()

void setControls ( )
protected

◆ setMonitoring()

void setMonitoring ( const bool  forceProfiling = false)
protected

Set file monitoring, profiling, etc.

Optionally force profiling without inspecting the controlDict

Definition at line 339 of file Time.C.

References IOobjectOption::AUTO_WRITE, Foam::debug::controlDict(), Foam::fileHandler, dictionary::findDict(), dictionary::getOrDefault(), profiling::initialize(), IOobjectOption::NO_READ, and timeName.

Here is the call graph for this function:

◆ readDict()

void readDict ( )
protectedvirtual

Read the control dictionary and set the write controls etc.

Reimplemented in crankConRod, and engineTime.

Definition at line 83 of file TimeIO.C.

References IOstreamOption::BINARY, List< T >::clear(), IOstreamOption::COMPRESSED, IOstreamOption::compression(), Foam::debug::debugObjects(), IOstream::defaultPrecision(), TimeState::deltaT_, TimeState::deltaTchanged_, DetailInfo, dict, Foam::debug::dimensionedConstantObjects(), Foam::dimensionedConstants(), Foam::debug::dimensionSetObjects(), Foam::dimensionSystems(), TimePaths::distributed(), Foam::endl(), Time::endTime_, Foam::exit(), Foam::FatalError, Foam::FatalIOError, FatalIOErrorInFunction, Foam::fileHandler, DictionaryBase< IDLListType, T >::find(), dictionary::findDict(), Time::fixed, forAllConstIters(), forAllReverse, IOstreamOption::format(), Time::format_, dictionary::found(), Time::general, dictionary::get(), Foam::Info, Foam::infoDetailLevel, Foam::debug::infoObjects(), IOWarningInFunction, dictionary::merge(), baseIOdictionary::name(), dimensioned< scalar >::name(), fileOperation::New(), Foam::nl, Foam::debug::optimisationObjects(), os(), Foam::Perr, Foam::Pout, OSstream::precision(), Time::precision_, Time::purgeWrite_, dictionary::readEntry(), Enum< EnumType >::readIfPresent(), dictionary::readIfPresent(), Time::saEndTime, Time::scientific, Foam::Serr, Foam::setEnv(), simpleObjectRegistry::setValues(), UList< T >::size(), Foam::Sout, Time::stopAt_, Time::stopAtControlNames, error::stream(), ofstreamPointer::supports_gz(), Time::timeName(), IOstreamOption::UNCOMPRESSED, dimensioned< Type >::value(), IOstreamOption::version(), WarningInFunction, regIOobject::watchIndices(), Time::wcAdjustableRunTime, Time::wcRunTime, Time::wcTimeStep, Time::writeControl_, Time::writeControlNames, Time::writeInterval_, and TimeState::writeTimeIndex_.

Referenced by engineTime::readDict(), and crankConRod::readDict().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ TypeName()

TypeName ( "time"  )

Runtime type information.

◆ New() [1/3]

Foam::autoPtr< Foam::Time > New ( )
static

Construct (dummy) Time - no functionObjects or libraries.

Definition at line 697 of file Time.C.

References autoPtr< T >::New().

Referenced by debugWriter::write(), boundaryDataWriter::write(), boundaryDataWriter::writeTemplate(), and debugWriter::writeTemplate().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ New() [2/3]

Foam::autoPtr< Foam::Time > New ( const fileName caseDir)
static

Construct (dummy) Time - no functionObjects or libraries.

Definition at line 710 of file Time.C.

References fileName::name(), autoPtr< T >::New(), and fileName::path().

Here is the call graph for this function:

◆ New() [3/3]

Foam::autoPtr< Foam::Time > New ( const argList args)
static

Construct (dummy) Time - no functionObjects or libraries.

Definition at line 723 of file Time.C.

References args, Time::controlDictName, and autoPtr< T >::New().

Here is the call graph for this function:

◆ path()

fileName path ( ) const
inline

◆ controlDict()

const dictionary& controlDict ( ) const
inline

Return read access to the controlDict dictionary.

Definition at line 457 of file Time.H.

Referenced by thermo::readControls().

Here is the caller graph for this function:

◆ dbDir()

virtual const fileName& dbDir ( ) const
inlinevirtual

Local directory path of this objectRegistry relative to the time.

Reimplemented from objectRegistry.

Definition at line 462 of file Time.H.

References fileName::null.

◆ timePath()

fileName timePath ( ) const
inline

Return current time path.

Definition at line 470 of file Time.H.

References Time::path(), and Time::timeName().

Referenced by faMesh::faMesh(), averageNeighbourFvGeometryScheme::movePoints(), MeshedSurfaceProxy< Face >::write(), molecule::writeFields(), and Foam::writePatchGraph().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ writeStreamOption()

IOstreamOption writeStreamOption ( ) const
inlinenoexcept

The write stream option (format, compression, version)

Definition at line 478 of file Time.H.

◆ writeFormat()

IOstreamOption::streamFormat writeFormat ( ) const
inlinenoexcept

The write stream format.

Definition at line 486 of file Time.H.

References IOstreamOption::format().

Here is the call graph for this function:

◆ writeCompression()

IOstreamOption::compressionType writeCompression ( ) const
inlinenoexcept

The write stream compression.

Definition at line 494 of file Time.H.

References IOstreamOption::compression().

Here is the call graph for this function:

◆ writeVersion()

IOstreamOption::versionNumber writeVersion ( ) const
inlinenoexcept

The write stream version.

Definition at line 502 of file Time.H.

References IOstreamOption::version().

Here is the call graph for this function:

◆ graphFormat()

const word& graphFormat ( ) const
inlinenoexcept

Default graph format.

Definition at line 510 of file Time.H.

◆ runTimeModifiable() [1/2]

Switch runTimeModifiable ( ) const
inlinenoexcept

Supports re-reading.

Definition at line 518 of file Time.H.

◆ runTimeModifiable() [2/2]

Switch runTimeModifiable ( const Switch  sw)
inlinenoexcept

Set re-reading support on/off (use with caution).

Returns
the previous value

Definition at line 528 of file Time.H.

◆ read()

bool read ( )
virtual

Read control dictionary, update controls and time.

Reimplemented from regIOobject.

Reimplemented in crankConRod, and engineTime.

Definition at line 435 of file TimeIO.C.

References Foam::fileHandler.

Referenced by engineTime::read(), and crankConRod::read().

Here is the caller graph for this function:

◆ readModifiedObjects()

void readModifiedObjects ( )

Read the objects that have been modified.

Definition at line 460 of file TimeIO.C.

References Foam::fileHandler, IOobject::fileModificationChecking, IOobject::inotifyMaster, objectRegistry::modified(), UPstream::parRun(), objectRegistry::readModifiedObjects(), and IOobject::timeStampMaster.

Referenced by SIMPLEControlOpt::loop(), and Time::run().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ findInstance()

Foam::word findInstance ( const fileName dir,
const word name = word::null,
IOobjectOption::readOption  rOpt = IOobjectOption::MUST_READ,
const word stopInstance = word::null 
) const

Return time instance (location) of dir that contains the file name (eg, used in reading mesh data).

When is empty, searches for directory dir only. Does not search beyond stopInstance (if set) or constant.

Note
If the instance cannot be found, returns the stopInstance (if set and reached) or constant. FatalError if it cannot be found and readOpt is (MUST_READ or MUST_READ_IF_MODIFIED).

Definition at line 777 of file Time.C.

References Foam::fileHandler, IOobject::instance(), io(), Foam::name(), and timeName.

Referenced by topoSet::findIOobject(), faMeshTools::newMesh(), fvMeshTools::newMesh(), points0MotionSolver::points0IO(), sensitivitySurface::smoothSensitivities(), and cellCellStencil::zoneID().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ findInstancePath() [1/2]

Foam::word findInstancePath ( const fileName directory,
const instant t 
) const

Search the case for the time directory path corresponding to the given instance.

Definition at line 801 of file Time.C.

References Instant< T >::equal(), forAllReverse, word::null, and path().

Referenced by uncollatedFileOperation::readObjects().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ findInstancePath() [2/2]

Foam::word findInstancePath ( const instant t) const

Search the case for the time directory path corresponding to the given instance.

Definition at line 829 of file Time.C.

References path().

Here is the call graph for this function:

◆ writeTimeDict()

bool writeTimeDict ( ) const
virtual

Write time dictionary to the <time>/uniform directory.

Definition at line 506 of file TimeIO.C.

References dictionary::add(), addProfiling, IOstreamOption::ASCII, IOobjectOption::NO_READ, IOobjectOption::NO_WRITE, and timeName.

Here is the call graph for this function:

◆ writeObject()

bool writeObject ( IOstreamOption  streamOpt,
const bool  valid 
) const
virtual

Write using stream options.

Reimplemented from objectRegistry.

Definition at line 541 of file TimeIO.C.

References Foam::fileHandler, IOobject::path(), timeName, and objectRegistry::writeObject().

Here is the call graph for this function:

◆ writeNow()

bool writeNow ( )

Write the objects immediately (not at end of iteration) and continue the run.

Definition at line 590 of file TimeIO.C.

References Foam::vtk::write().

Referenced by runTimeControl::execute(), and SIMPLEControlSingleRun::writeNow().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ writeAndEnd()

bool writeAndEnd ( )

Write the objects now (not at end of iteration) and end the run.

Definition at line 597 of file TimeIO.C.

Referenced by runTimeControl::execute(), and simpleControl::loop().

Here is the caller graph for this function:

◆ writeOnce()

void writeOnce ( )

Write the objects once (one shot) and continue the run.

Definition at line 606 of file TimeIO.C.

◆ printExecutionTime()

Foam::Ostream & printExecutionTime ( OSstream os) const

Print the elapsed ExecutionTime (cpu-time), ClockTime.

Definition at line 612 of file TimeIO.C.

References Foam::endl(), Foam::nl, os(), Foam::printTimeHMS(), and OFstream::stdStream().

Referenced by sensitivitySurface::smoothSensitivities(), adjointMeshMovementSolver::solve(), adjointEikonalSolver::solve(), and RASTurbulenceModel::solveIter().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ timeName() [1/2]

Foam::word timeName ( const scalar  t,
const int  precision = precision_ 
)
static

Return time name of given scalar time formatted with the given precision.

Definition at line 760 of file Time.C.

Referenced by constantAbsorptionEmission::aCont(), adjointLaminar::adjointMeanFlowSource(), adjointkOmegaSST::adjointMeanFlowSource(), adjointSensitivity::adjointMeshMovementSource(), adjointSpalartAllmaras::allocateMask(), kOmegaSST::allocateMeanFields(), RASModelVariables::allocateMeanFields(), fieldToCell::applyToSet(), sensitivityVolBSplinesFI::assembleSensitivities(), variablesSet::autoCreateMeshMovementField(), coordSetWriter::beginTime(), surfaceWriter::beginTime(), Bezier::Bezier(), blended< Type >::blendingFactor(), cellCoBlended< Type >::blendingFactor(), Foam::calc_pTotal(), Foam::calc_rhoU(), nearWallFields::calcAddressing(), ObukhovLength::calcOL(), DarcyForchheimer::calcTransformModelData(), RASModelVariables::cloneRefPtr(), adjointEikonalSolver::computeYPhi(), contactAngleForce::correct(), cubic< Type >::correction(), waxSolventEvaporation::correctModel(), omegaWallFunctionFvPatchScalarField::createAveragingWeights(), epsilonWallFunctionFvPatchScalarField::createAveragingWeights(), cellCellStencil::createField(), logFiles::createFiles(), distanceSurface::createGeometry(), cloud::createIOField(), ATCModel::createLimiter(), Foam::createZeroFieldPtr(), filmTurbulenceModel::Cw(), constant::d(), faMeshDecomposition::decomposeMesh(), adjointLaminar::distanceSensitivities(), adjointkOmegaSST::distanceSensitivities(), multiphaseMangrovesSource::dragCoeff(), masterUncollatedFileOperation::findInstance(), adjointLaminar::FISensitivityTerm(), adjointkOmegaSST::FISensitivityTerm(), forces::force(), fvMeshDistribute::generateTestField(), adjointRASModel::getAdjointTMVariable1Inst(), adjointRASModel::getAdjointTMVariable2Inst(), ATCUaGradU::getFISensitivityTerm(), cancelATC::getFISensitivityTerm(), adjointEikonalSolver::getFISensitivityTerm(), sampledSets::getOrLoadField(), probes::getOrLoadField(), constantHeatTransfer::h(), localMax< Type >::interpolate(), localMin< Type >::interpolate(), isoSurfacePoint::isoSurfacePoint(), simpleControl::loop(), SIMPLEControlSingleRun::loop(), meshRefinement::makeDisplacementField(), Foam::MapConsistentMesh(), Foam::MapConsistentVolFields(), Foam::MapLagrangianFields(), Foam::MapMesh(), meshToMesh::mapSrcToTgt(), Foam::MapSubMesh(), meshToMesh::mapTgtToSrc(), Foam::MapVolFields(), momentumError::momentumError(), triSurfaceMesh::movePoints(), laminar::mut(), dynamicFvMesh::New(), adjointRASModel::nutJacobianTMVar1(), adjointRASModel::nutJacobianTMVar2(), objectiveManager::objectiveManager(), kinematicSingleLayer::pp(), kinematicSingleLayer::pu(), dummy::R(), Foam::reconstructLagrangian(), variablesSet::renameTurbulenceField(), filmTurbulenceModel::rho(), timeSelector::selectIfPresent(), variablesSet::setFluxField(), incompressibleAdjointMeanFlowVars::setMeanFields(), incompressibleVars::setMeanFields(), adjointRASModel::setMeanFields(), refinementIterator::setRefinement(), masterUncollatedFileOperation::setTime(), noFilm::Sh(), noScatter::sigmaEff(), constantScatter::sigmaEff(), skewCorrected< Type >::skewCorrection(), sensitivitySurface::smoothSensitivities(), twoPhaseSystem::solve(), multiphaseSystem::solve(), RASTurbulenceModel::solveIter(), noFilm::Srho(), temperatureDependentContactAngleForce::theta(), distributionContactAngleForce::theta(), perturbedTemperatureDependentContactAngleForce::theta(), MPPICParcel< ParcelType >::trackingData::updateAverages(), KinematicParcel< ParcelType >::trackingData::updateAverages(), uniformInterpolatedDisplacementPointPatchVectorField::updateCoeffs(), adjointkOmegaSST::updatePrimalRelatedFields(), laminar::Us(), coalCloudList::UTrans(), resolutionIndexModel::V(), velocityDisplacementMotionSolver::velocityDisplacementMotionSolver(), reverseLinear< Type >::weights(), clippedLinear< Type >::weights(), FIREMeshWriter::write(), RemoveParcels< CloudType >::write(), sensitivityBezier::write(), FacePostProcessing< CloudType >::write(), sensitivityVolBSplines::write(), sensitivityVolBSplinesFI::write(), sensitivityBezierFI::write(), MeshedSurfaceProxy< Face >::write(), ParticleCollector< CloudType >::write(), areaWrite::write(), Foam::writeCellGraph(), faMeshDecomposition::writeDecomposition(), Foam::writeMeshObject(), triSurfaceMesh::writeObject(), and adjointkOmegaSST::zeroFirstCell().

◆ timeName() [2/2]

Foam::word timeName ( ) const
virtual

Return current time name.

Definition at line 770 of file Time.C.

References dimensioned< scalar >::name().

Referenced by writeFile::newFileAtTime(), Time::readDict(), faceSetOption::setArea(), cellSetOption::setVol(), Time::timePath(), and writeFile::writeCurrentTime().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ startTimeIndex()

Foam::label startTimeIndex ( ) const
virtual

Return start time index.

Definition at line 835 of file Time.C.

◆ startTime()

Foam::dimensionedScalar startTime ( ) const
virtual

Return start time.

Definition at line 841 of file Time.C.

References Foam::dimTime.

Referenced by logFiles::createFiles(), and pointHistory::pointHistory().

Here is the caller graph for this function:

◆ endTime()

Foam::dimensionedScalar endTime ( ) const
virtual

Return end time.

Definition at line 847 of file Time.C.

References Foam::dimTime.

Referenced by SIMPLEControlSingleRun::checkEndTime(), and SIMPLEControlSingleRun::readIters().

Here is the caller graph for this function:

◆ stopAt() [1/2]

Foam::Time::stopAtControls stopAt ( ) const
virtual

Return the stop control information.

Definition at line 853 of file Time.C.

Referenced by dynamicFvMesh::New().

Here is the caller graph for this function:

◆ isAdjustTimeStep()

bool isAdjustTimeStep ( ) const
virtual

Return true if adjustTimeStep is true.

Definition at line 971 of file Time.C.

◆ functionObjects() [1/2]

const functionObjectList& functionObjects ( ) const
inline

Return the list of function objects.

Definition at line 662 of file Time.H.

Referenced by stateFunctionObject::stateDict().

Here is the caller graph for this function:

◆ libs()

dlLibraryTable& libs ( ) const
inlinenoexcept

Mutable access to the loaded dynamic libraries.

Definition at line 670 of file Time.H.

Referenced by codedPoints0MotionSolver::libs(), codedFunctionObject::libs(), GAMGAgglomeration::New(), and functionObject::New().

Here is the caller graph for this function:

◆ subCycling()

label subCycling ( ) const
inlinenoexcept

Zero (tests as false) if time is not being sub-cycled, otherwise the current sub-cycle index or the total number of sub-cycles.

The interpretation of non-zero values is dependent on the routine.

Definition at line 683 of file Time.H.

References Time::subCycling_.

Referenced by masterUncollatedFileOperation::setTime().

Here is the caller graph for this function:

◆ prevTimeState()

const TimeState& prevTimeState ( ) const
inline

Return previous TimeState if time is being sub-cycled.

Definition at line 691 of file Time.H.

References Time::prevTimeState_.

◆ run()

bool run ( ) const
virtual

Return true if run should continue,.

also invokes the functionObjectList::end() method when the time goes out of range

Note
For correct behaviour, the following style of time-loop is recommended:
while (runTime.run())
{
runTime.write();
}

Definition at line 859 of file Time.C.

References profiling::active(), addProfiling, IOobject::name(), and Time::readModifiedObjects().

Referenced by runTimeControl::execute().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ loop()

bool loop ( )
virtual

Return true if run should continue and if so increment time.

also invokes the functionObjectList::end() method when the time goes out of range

Note
For correct behaviour, the following style of time-loop is recommended:
while (runTime.loop())
{
runTime.write();
}

Definition at line 931 of file Time.C.

Referenced by simpleControl::loop(), and SIMPLEControlSingleRun::loop().

Here is the caller graph for this function:

◆ end()

bool end ( ) const
virtual

Return true if end of run,.

does not invoke any functionObject methods

Note
The rounding heuristics near endTime mean that
run()
and
!end()
may not yield the same result

Definition at line 944 of file Time.C.

◆ stopAt() [2/2]

bool stopAt ( const stopAtControls  stopCtrl) const
virtual

Adjust the current stopAtControl.

Parameters
stopCtrlthe new stop control, whereby stopAtControls::saUnknown is treated as a no-op.
Note
this value only persists until the next time the dictionary is read.
Returns
true if the stopAt() value was changed.

Definition at line 950 of file Time.C.

◆ setTime() [1/4]

void setTime ( const Time t)
virtual

Reset the time and time-index to those of the given time.

Definition at line 977 of file Time.C.

References Foam::fileHandler, dimensioned< scalar >::name(), TimeState::timeIndex_, and dimensioned< Type >::value().

Referenced by timeSelector::select0().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setTime() [2/4]

void setTime ( const instant inst,
const label  newIndex 
)
virtual

Reset the time and time-index.

Definition at line 986 of file Time.C.

References Foam::fileHandler, Instant< T >::name(), dimensioned< scalar >::name(), IOobjectOption::NO_WRITE, IOobjectOption::READ_IF_PRESENT, dictionary::readIfPresent(), timeName, and Instant< T >::value().

Here is the call graph for this function:

◆ setTime() [3/4]

void setTime ( const dimensionedScalar newTime,
const label  newIndex 
)
virtual

Reset the time and time-index.

Definition at line 1013 of file Time.C.

References setTime(), and dimensioned< Type >::value().

Here is the call graph for this function:

◆ setTime() [4/4]

void setTime ( const scalar  newTime,
const label  newIndex 
)
virtual

Reset the time and time-index.

Definition at line 1019 of file Time.C.

References Foam::fileHandler, dimensioned< scalar >::name(), and timeName.

Here is the call graph for this function:

◆ setEndTime() [1/2]

void setEndTime ( const dimensionedScalar endTime)
virtual

Reset end time.

Definition at line 1028 of file Time.C.

References dimensioned< Type >::value().

Referenced by SIMPLEControlSingleRun::checkEndTime(), and SIMPLEControlSingleRun::readIters().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setEndTime() [2/2]

void setEndTime ( const scalar  endTime)
virtual

Reset end time.

Definition at line 1034 of file Time.C.

◆ setDeltaT() [1/2]

void setDeltaT ( const dimensionedScalar deltaT,
const bool  adjust = true 
)
virtual

Reset time step, normally also calling adjustDeltaT()

Definition at line 1041 of file Time.C.

References dimensioned< Type >::value().

Referenced by SIMPLEControlOpt::resetDeltaT().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setDeltaT() [2/2]

void setDeltaT ( const scalar  deltaT,
const bool  adjust = true 
)
virtual

Reset time step, normally also calling adjustDeltaT()

Definition at line 1050 of file Time.C.

◆ subCycle()

Foam::TimeState subCycle ( const label  nSubCycles)
virtual

Set time to sub-cycle for the given number of steps.

Definition at line 1062 of file Time.C.

References Foam::exit(), Foam::FatalError, FatalErrorInFunction, Foam::nl, setTime(), and timeIndex.

Referenced by subCycleTime::subCycleTime().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ subCycleIndex()

void subCycleIndex ( const label  index)
virtual

Adjust the reported sub-cycle index.

Parameters
indexis the sub-cycle index. This index is ignored sub-cycling was not already registered, or if the index is zero or negative.

Definition at line 1086 of file Time.C.

◆ endSubCycle()

void endSubCycle ( )
virtual

Reset time after sub-cycling back to previous TimeState.

Definition at line 1099 of file Time.C.

◆ functionObjects() [2/2]

functionObjectList& functionObjects ( )
inline

Return non-const access to the list of function objects.

Definition at line 836 of file Time.H.

◆ operator+=() [1/2]

Foam::Time & operator+= ( const dimensionedScalar deltaT)
virtual

Set deltaT to that specified and increment time via operator++()

Definition at line 1113 of file Time.C.

References dimensioned< Type >::value().

Here is the call graph for this function:

◆ operator+=() [2/2]

Foam::Time & operator+= ( const scalar  deltaT)
virtual

Set deltaT to that specified and increment time via operator++()

Definition at line 1119 of file Time.C.

◆ operator++() [1/2]

Foam::Time & operator++ ( )
virtual

Prefix increment,.

also invokes the functionObjectList::start() or functionObjectList::execute() method, depending on the time-index

Definition at line 1126 of file Time.C.

References stdFoam::end(), Foam::endl(), Foam::mag(), Foam::max(), Foam::min(), dimensioned< scalar >::name(), Foam::nl, Foam::pow(), Foam::reduce(), Foam::returnReduce(), setTime(), Foam::sign(), timeIndex, and WarningInFunction.

Here is the call graph for this function:

◆ operator++() [2/2]

Foam::Time & operator++ ( int  )
virtual

Postfix increment, this is identical to the prefix increment.

Definition at line 1342 of file Time.C.

◆ rootPath()

const Foam::fileName & rootPath
inlinenoexcept

Return root path.

Definition at line 43 of file TimePathsI.H.

◆ caseName() [1/2]

const Foam::fileName & caseName
inlinenoexcept

Return case name.

Definition at line 55 of file TimePathsI.H.

Referenced by triSurface::triSurface(), triSurface::triSurfInstance(), and triSurface::write().

Here is the caller graph for this function:

◆ caseName() [2/2]

Foam::fileName & caseName
inlinenoexcept

Return case name.

Definition at line 61 of file TimePathsI.H.

Member Data Documentation

◆ writeControlNames

const Foam::Enum< Foam::Time::writeControls > writeControlNames
static

Names for writeControls.

Definition at line 120 of file Time.H.

Referenced by Time::readDict().

◆ stopAtControlNames

const Foam::Enum< Foam::Time::stopAtControls > stopAtControlNames
static

Names for stopAtControls.

Definition at line 125 of file Time.H.

Referenced by Foam::getStopAction(), abort::read(), and Time::readDict().

◆ printExecutionFormat_

int printExecutionFormat_
static

Style for "ExecutionTime = " output.

0 = seconds (with trailing 's') 1 = day-hh:mm:ss

Note
this is public so registered info switches can modify it.

Definition at line 136 of file Time.H.

◆ startTimeIndex_

label startTimeIndex_
protected

Definition at line 165 of file Time.H.

◆ startTime_

scalar startTime_
protected

Definition at line 167 of file Time.H.

Referenced by Time::adjustDeltaT().

◆ endTime_

scalar endTime_
mutableprotected

Definition at line 169 of file Time.H.

Referenced by Time::readDict().

◆ stopAt_

stopAtControls stopAt_
mutableprotected

Definition at line 171 of file Time.H.

Referenced by Time::readDict().

◆ writeControl_

writeControls writeControl_
protected

Definition at line 173 of file Time.H.

Referenced by Time::adjustDeltaT(), and Time::readDict().

◆ writeInterval_

scalar writeInterval_
protected

Definition at line 175 of file Time.H.

Referenced by Time::adjustDeltaT(), and Time::readDict().

◆ purgeWrite_

label purgeWrite_
protected

Definition at line 177 of file Time.H.

Referenced by Time::readDict().

◆ previousWriteTimes_

FIFOStack<word> previousWriteTimes_
mutableprotected

Definition at line 179 of file Time.H.

◆ subCycling_

label subCycling_
protected

The total number of sub-cycles, the current sub-cycle index, or 0 if time is not being sub-cycled.

Definition at line 185 of file Time.H.

Referenced by Time::subCycling().

◆ writeOnce_

bool writeOnce_
protected

Definition at line 188 of file Time.H.

◆ prevTimeState_

autoPtr<TimeState> prevTimeState_
protected

If time is being sub-cycled this is the previous TimeState.

Definition at line 193 of file Time.H.

Referenced by Time::prevTimeState().

◆ sigWriteNow_

sigWriteNow sigWriteNow_
protected

Signal handler for one-shot writing upon signal.

Definition at line 198 of file Time.H.

◆ sigStopAtWriteNow_

sigStopAtWriteNow sigStopAtWriteNow_
protected

Signal handler for write and clean exit upon signal.

Definition at line 203 of file Time.H.

◆ format_

Foam::Time::fmtflags format_
staticprotected

Time directory name format.

Definition at line 209 of file Time.H.

Referenced by Time::readDict().

◆ precision_

int precision_
staticprotected

Time directory name precision.

Definition at line 214 of file Time.H.

Referenced by Time::readDict().

◆ maxPrecision_

const int maxPrecision_
staticprotected

Maximum time directory name precision.

Definition at line 219 of file Time.H.

◆ controlDictName

Foam::word controlDictName
static

The default control dictionary name (normally "controlDict")

Definition at line 275 of file Time.H.

Referenced by faMeshDecomposition::decomposeMesh(), Time::New(), and faMeshDecomposition::writeDecomposition().


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