Monitors

The monitors are specified individually as blocks in the control file. The only general keyword that can be specified is explained in the table below:

Keyword Description Default value
monitors flush interval INTEGER: Iteration interval to flush the monitor information to the monitor files. 100

Residual Monitors

Statistics Monitor

#define statistics
   initial time      = 1.d0
   initial iteration = 10
   sampling interval = 10
   dump interval     = 20
   @start
#end

By default, the statistic monitor will average following variables:

  • u
  • v
  • w
  • uu
  • vv
  • ww
  • uv
  • uw
  • vw

A keyword preceded by @ is used in real-time to signalize the solver what it must do with the statistics computation:

  • @start
  • @pause
  • @stop
  • @reset
  • @dump

After reading the keyword, the solver performs the desired action and marks it with a star, e.g. @start*.

Note

Real-time keywords may not work in parallel MPI computations. I depends on how the system is configured.

Probes

#define probe 1
   name     = SomeName
   variable = SomeVariable
   position = [0.d0, 0.d0, 0.d0]
#end
Keyword Description Default value
name CHARACTER: Name of the monitor. Mandatory Keyword
variable CHARACTER: Variable to be monitored. Implemented options are: pressure, velocity, u, v, w, mach, k. Mandatory Keyword
position REAL(3): Coordinates of the point to be monitored. Mandatory Keyword

Surface Monitors

#define surface monitor 1
   name              = SomeName
   marker            = NameOfBoundary
   variable          = SomeVariable
   reference surface = 1.d0
   direction         = [1.d0, 0.d0, 0.d0]
#end
Keyword Description Default value
name CHARACTER: Name of the monitor. Mandatory Keyword
marker CHARACTER: Name of the boundary where a variable will be monitored. Mandatory Keyword
variable CHARACTER: Variable to be monitored. Implemented options are: mass-flow, flow, pressure-force, viscous-force, force, lift, drag, pressure-average. Mandatory Keyword
reference surface REAL: Reference surface [area] for the monitor. Needed for "lift" and "drag" computations. --
direction REAL(3): Direction in which the force is going to be measured. Needed for "pressure-force", "viscous-force" and "force". Can be specified for "lift" (default [0.d0,1.d0,0.d0]) and "drag" (default [1.d0,0.d0,0.d0]). --

Volume monitors

Volume monitors compute the average of a quantity in the whole domain. They can be scalars(s) or vectors(v).

#define volume monitor 1
   name     = SomeName
   variable = SomeVariable
#end
Keyword Description Default value
name CHARACTER: Name of the monitor. Mandatory Keyword
variable CHARACTER: Variable to be monitored. The variable can be scalar (s) or vectorial (v). Implemented options are: kinetic energy (s), kinetic energy rate (s), enstrophy (s), entropy (s), entropy rate (s), mean velocity (s), velocity (v), momentum (v), source (v). Mandatory Keyword

Load Balancing Monitors

Load balancing monitors compute the DOF in each partition of the mesh to check the unbalance. 

#define load balancing monitor 1
   name     = SomeName
   variable = SomeVariable
#end
Keyword Description Default value
name CHARACTER: Name of the monitor. Mandatory Keyword
variable CHARACTER: Variable to be monitored. Implemented options are: max dof per partition, min dof per partition, avg dof per partition, absolute dof unbalancing, relative dof unbalancing. Mandatory Keyword

The variable absolute dof unbalancing is computed as follows:

The variable relative dof unbalancing is computed as follows: