Loading...
Searching...
No Matches
timeControl Class Reference

General time dependent execution controller. The execution parameters are given by the "Control" and (optionally) the "Interval", with the default being to execute every time-step. More...

#include <timeControl.H>

Public Types

enum  timeControls {
  ocNone = 0 , ocAlways , ocTimeStep , ocWriteTime ,
  ocRunTime , ocAdjustableRunTime , ocClockTime , ocCpuTime ,
  ocOnStart , ocOnEnd
}
 The time control options. More...

Public Member Functions

 timeControl (const Time &runTime, const word &prefix="")
 Construct a control object that executes each time-step.
 timeControl (const Time &runTime, const dictionary &dict, const word &prefix)
 Construct from Time object, dictionary and the prefix for the control name.
 ~timeControl ()=default
 Destructor.
void read (const dictionary &dict)
 Read from dictionary.
const Time & time () const
 Return the Time.
const word & name () const
 Return the name (prefix).
const word & type () const
 Return the named control enumeration as its 'type'.
void clear ()
 Reset control to 'always' - ie, no intervention.
timeControls control () const
 Return the control enumeration.
bool always () const
 Return true if the control will always execute - ie, no intervention.
bool execute ()
 Flag to indicate whether to execute.
scalar interval () const
 Return interval.
label executionIndex () const
 Return the index of the previous execution.

Static Public Member Functions

static bool entriesPresent (const dictionary &dict, const word &prefix)
 Identify if a timeControl object is present in the dictionary.

Detailed Description

General time dependent execution controller. The execution parameters are given by the "Control" and (optionally) the "Interval", with the default being to execute every time-step.

For example, an "execute" control every tenth write time: 

    executeControl  writeTime;
    executeInterval 10;

See Foam::functionObject for a list of known selection types.

Source files

Definition at line 57 of file timeControl.H.

Member Enumeration Documentation

◆ timeControls

enum timeControls

The time control options.

Enumerator
ocNone 

No execution.

ocAlways 

Always execute.

ocTimeStep 

Execution coupled to time-step (default).

ocWriteTime 

Execution coupled to write-time.

ocRunTime 

Use run-time for execution.

ocAdjustableRunTime 

Currently identical to "runTime".

ocClockTime 

Use clock time for execution.

ocCpuTime 

Use CPU time for execution.

ocOnStart 

Execute on first step of run.

ocOnEnd 

Execute on end of run.

Definition at line 64 of file timeControl.H.

Constructor & Destructor Documentation

◆ timeControl() [1/2]

timeControl ( const Time & runTime,
const word & prefix = "" )
explicit

Construct a control object that executes each time-step.

For places where a time control object is required, but should not actually intervene.

Definition at line 50 of file timeControl.C.

References ocAlways, and runTime.

◆ timeControl() [2/2]

timeControl ( const Time & runTime,
const dictionary & dict,
const word & prefix )

Construct from Time object, dictionary and the prefix for the control name.

Definition at line 65 of file timeControl.C.

References dict, read(), and runTime.

Here is the call graph for this function:

◆ ~timeControl()

~timeControl ( )
default

Destructor.

References dict.

Member Function Documentation

◆ entriesPresent()

bool entriesPresent ( const dictionary & dict,
const word & prefix )
static

Identify if a timeControl object is present in the dictionary.

Matches prefix + "Control"

Definition at line 80 of file timeControl.C.

References dict.

Referenced by entriesPresent().

Here is the caller graph for this function:

◆ read()

void read ( const dictionary & dict)

Read from dictionary.

Definition at line 103 of file timeControl.C.

References dict, Foam::endl(), IOWarningInFunction, Foam::nl, ocAdjustableRunTime, ocClockTime, ocCpuTime, ocRunTime, ocTimeStep, ocWriteTime, and error::warnAboutAge().

Referenced by timeControl().

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

◆ time()

const Foam::Time & time ( ) const
inline

Return the Time.

Definition at line 24 of file timeControlI.H.

◆ name()

const Foam::word & name ( ) const
inline

Return the name (prefix).

Definition at line 30 of file timeControlI.H.

◆ type()

const Foam::word & type ( ) const
inline

Return the named control enumeration as its 'type'.

Definition at line 36 of file timeControlI.H.

◆ clear()

void clear ( )

Reset control to 'always' - ie, no intervention.

Definition at line 94 of file timeControl.C.

References ocAlways.

◆ control()

Foam::timeControl::timeControls control ( ) const
inline

Return the control enumeration.

Definition at line 42 of file timeControlI.H.

◆ always()

bool always ( ) const
inline

Return true if the control will always execute - ie, no intervention.

Definition at line 48 of file timeControlI.H.

References ocAlways, and ocTimeStep.

◆ execute()

bool execute ( )

Flag to indicate whether to execute.

Definition at line 164 of file timeControl.C.

References Foam::abort(), executionIndex(), Foam::FatalError, FatalErrorInFunction, Foam::nl, ocAdjustableRunTime, ocAlways, ocClockTime, ocCpuTime, ocNone, ocOnEnd, ocOnStart, ocRunTime, ocTimeStep, ocWriteTime, and Foam::returnReduce().

Here is the call graph for this function:

◆ interval()

Foam::scalar interval ( ) const
inline

Return interval.

Definition at line 58 of file timeControlI.H.

◆ executionIndex()

Foam::label executionIndex ( ) const
inline

Return the index of the previous execution.

Definition at line 64 of file timeControlI.H.

Referenced by execute().

Here is the caller graph for this function:
The documentation for this class was generated from the following files: