All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Ewoms::Simulator< TypeTag > Class Template Reference

Manages the initializing and running of time dependent problems. More...

#include <simulator.hh>

Public Member Functions

 Simulator (const Simulator &)=delete
 
 Simulator (bool verbose=true)
 
GridManager & gridManager ()
 Return a reference to the grid manager of simulation.
 
const GridManager & gridManager () const
 Return a reference to the grid manager of simulation.
 
const GridView & gridView () const
 Return the grid view for which the simulation is done.
 
Model & model ()
 Return the physical model used in the simulation.
 
const Model & model () const
 Return the physical model used in the simulation.
 
Problem & problem ()
 Return the object which specifies the pysical setup of the simulation.
 
const Problem & problem () const
 Return the object which specifies the pysical setup of the simulation.
 
void setStartTime (Scalar t)
 Set the time of the start of the simulation. More...
 
Scalar startTime () const
 Return the time of the start of the simulation.
 
void setTime (Scalar t)
 Set the current simulated time, don't change the current time step index. More...
 
void setTime (Scalar t, unsigned stepIdx)
 Set the current simulated time and the time step index. More...
 
Scalar time () const
 Return the number of seconds of simulated time which have elapsed since the start time. More...
 
void setEndTime (Scalar t)
 Set the time of simulated seconds at which the simulation runs. More...
 
Scalar endTime () const
 Returns the number of (simulated) seconds which the simulation runs.
 
const Ewoms::TimersetupTimer () const
 Returns a reference to the timer object which measures the time needed to set up and initialize the simulation.
 
const Ewoms::TimerexecutionTimer () const
 Returns a reference to the timer object which measures the time needed to run the simulation.
 
const Ewoms::TimerprePostProcessTimer () const
 Returns a reference to the timer object which measures the time needed for pre- and postprocessing of the solutions.
 
const Ewoms::TimerlinearizeTimer () const
 Returns a reference to the timer object which measures the time needed for linarizing the solutions.
 
const Ewoms::TimersolveTimer () const
 Returns a reference to the timer object which measures the time needed by the solver.
 
const Ewoms::TimerupdateTimer () const
 Returns a reference to the timer object which measures the time needed to the solutions of the non-linear system of equations.
 
const Ewoms::TimerwriteTimer () const
 Returns a reference to the timer object which measures the time needed to write the visualization output.
 
void setTimeStepSize (Scalar value)
 Set the current time step size to a given value. More...
 
void setTimeStepIndex (unsigned value)
 Set the current time step index to a given value. More...
 
Scalar timeStepSize () const
 Returns the time step length $\mathrm{[s]}$ so that we don't miss the beginning of the next episode or cross the end of the simlation.
 
int timeStepIndex () const
 Returns number of time steps which have been executed since the beginning of the simulation.
 
void setFinished (bool yesno=true)
 Specify whether the simulation is finished. More...
 
bool finished () const
 Returns true if the simulation is finished. More...
 
bool willBeFinished () const
 Returns true if the simulation is finished after the time level is incremented by the current time step size.
 
Scalar maxTimeStepSize () const
 Aligns the time step size to the episode boundary and to the end time of the simulation.
 
void startNextEpisode (Scalar episodeStartTime, Scalar episodeLength)
 Change the current episode of the simulation. More...
 
void startNextEpisode (Scalar len=std::numeric_limits< Scalar >::max())
 Start the next episode, but don't change the episode identifier. More...
 
void setEpisodeIndex (int episodeIdx)
 Sets the index of the current episode. More...
 
int episodeIndex () const
 Returns the index of the current episode. More...
 
Scalar episodeStartTime () const
 Returns the absolute time when the current episode started $\mathrm{[s]}$.
 
void setEpisodeLength (Scalar dt)
 Sets the length in seconds of the current episode. More...
 
Scalar episodeLength () const
 Returns the length of the current episode in simulated time $\mathrm{[s]}$.
 
bool episodeIsOver () const
 Returns true if the current episode is finished at the current time.
 
bool episodeWillBeOver () const
 Returns true if the current episode will be finished after the current time step.
 
Scalar episodeMaxTimeStepSize () const
 Aligns the time step size to the episode boundary if the current time step crosses the boundary of the current episode.
 
void run ()
 Runs the simulation using a given problem class. More...
 

Static Public Member Functions

static void registerParameters ()
 Registers all runtime parameters used by the simulation.
 
static std::string humanReadableTime (Scalar timeInSeconds, bool isAmendment=true)
 Given a time step size in seconds, return it in a format which is more easily parsable by humans. More...
 

Saving/restoring the simulation state

void serialize ()
 This method writes the complete state of the simulation to the harddisk. More...
 
template<class Restarter >
void serialize (Restarter &restarter)
 Write the time manager's state to a restart file. More...
 
template<class Restarter >
void deserialize (Restarter &restarter)
 Read the time manager's state from a restart file. More...
 

Detailed Description

template<class TypeTag>
class Ewoms::Simulator< TypeTag >

Manages the initializing and running of time dependent problems.

This class instantiates the grid, the model and the problem to be simlated and runs the simulation loop. The time axis is treated as a sequence of "episodes" which are defined as time intervals for which the problem exhibits boundary conditions and source terms that do not depend on time.

Member Function Documentation

template<class TypeTag >
template<class Restarter >
void Ewoms::Simulator< TypeTag >::deserialize ( Restarter &  restarter)
inline

Read the time manager's state from a restart file.

Template Parameters
RestarterThe type of the object which takes care to deserialize data
Parameters
restarterThe deserializer object
template<class TypeTag >
int Ewoms::Simulator< TypeTag >::episodeIndex ( ) const
inline

Returns the index of the current episode.

The first episode has the index 0.

template<class TypeTag >
bool Ewoms::Simulator< TypeTag >::finished ( ) const
inline

Returns true if the simulation is finished.

This is the case if either setFinished(true) has been called or if the end time is reached.

template<class TypeTag >
static std::string Ewoms::Simulator< TypeTag >::humanReadableTime ( Scalar  timeInSeconds,
bool  isAmendment = true 
)
inlinestatic

Given a time step size in seconds, return it in a format which is more easily parsable by humans.

e.g. 874000.0 will become "10.12 days"

template<class TypeTag >
void Ewoms::Simulator< TypeTag >::run ( )
inline

Runs the simulation using a given problem class.

This method makes sure that time steps sizes are aligned to episode boundaries, amongst other stuff.

template<class TypeTag >
void Ewoms::Simulator< TypeTag >::serialize ( )
inline

This method writes the complete state of the simulation to the harddisk.

The file will start with the prefix returned by the name() method, has the current time of the simulation clock in it's name and uses the extension .ers. (Ewoms ReStart file.) See Ewoms::Restart for details.

template<class TypeTag >
template<class Restarter >
void Ewoms::Simulator< TypeTag >::serialize ( Restarter &  restarter)
inline

Write the time manager's state to a restart file.

Template Parameters
RestarterThe type of the object which takes care to serialize data
Parameters
restarterThe serializer object
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setEndTime ( Scalar  t)
inline

Set the time of simulated seconds at which the simulation runs.

Parameters
tThe time $\mathrm{[s]}$ at which the simulation is finished
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setEpisodeIndex ( int  episodeIdx)
inline

Sets the index of the current episode.

Use this method with care!

template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setEpisodeLength ( Scalar  dt)
inline

Sets the length in seconds of the current episode.

Use this method with care!

template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setFinished ( bool  yesno = true)
inline

Specify whether the simulation is finished.

Parameters
yesnoIf true the simulation is considered finished before the end time is reached, else it is only considered finished if the end time is reached.
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setStartTime ( Scalar  t)
inline

Set the time of the start of the simulation.

Parameters
tThe time $\mathrm{[s]}$ which should be jumped to
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setTime ( Scalar  t)
inline

Set the current simulated time, don't change the current time step index.

Parameters
tThe time $\mathrm{[s]}$ which should be jumped to
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setTime ( Scalar  t,
unsigned  stepIdx 
)
inline

Set the current simulated time and the time step index.

Parameters
tThe time $\mathrm{[s]}$ which should be jumped to
stepIdxThe new time step index
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setTimeStepIndex ( unsigned  value)
inline

Set the current time step index to a given value.

Parameters
timeStepIndexThe new value for the time step index
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::setTimeStepSize ( Scalar  value)
inline

Set the current time step size to a given value.

If the step size would exceed the length of the current episode, the timeStep() method will take care that the step size won't exceed the episode or the end of the simulation, though.

Parameters
timeStepSizeThe new value for the time step size $\mathrm{[s]}$
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::startNextEpisode ( Scalar  episodeStartTime,
Scalar  episodeLength 
)
inline

Change the current episode of the simulation.

Parameters
episodeStartTimeTime when the episode began $\mathrm{[s]}$
episodeLengthLength of the episode $\mathrm{[s]}$
template<class TypeTag >
void Ewoms::Simulator< TypeTag >::startNextEpisode ( Scalar  len = std::numeric_limits<Scalar>::max())
inline

Start the next episode, but don't change the episode identifier.

Parameters
lenLength of the episode $\mathrm{[s]}$, infinite if not specified.
template<class TypeTag >
Scalar Ewoms::Simulator< TypeTag >::time ( ) const
inline

Return the number of seconds of simulated time which have elapsed since the start time.

To get the time after the time integration, you have to add timeStepSize() to time().


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