[soln-plugin-tavg]
Time average quantities. Parameterised with
nsteps
— accumulate the average everynsteps
time steps:int
dt-out
— write to disk everydt-out
time units:float
tstart
— time at which to start accumulating average data:float
mode
— output file accumulation mode:continuous
|windowed
In continuous mode each output file contains average data from
tstart
up until the time at which the file is written. In windowed mode each output file only contains average data for the precedingdt-out
time units. The default iswindowed
. Average data files obtained using the windowed mode can be accumulated after-the-fact using the CLI.std-mode
— standard deviation reporting mode:summary
|all
If to output full standard deviation fields or just summary statistics. In lieu of a complete field, summary instead reports the maximum and average standard deviation for each field. The default is
summary
withall
doubling the size of the resulting files.basedir
— relative path to directory where outputs will be written:string
basename
— pattern of output names:string
precision
— output file number precision:single
|double
The default is
single
. Note that this only impacts the output, with statistic accumulation always being performed in double precision.region
— region to be written, specified as either the entire domain using*
, a combination of the geometric shapes specified in Regions, or a sub-region of elements that have faces on a specific domain boundary via the name of the domain boundary:*
|shape(args, ...)
| stringavg
-name — expression to time average, written as a function of the primitive variables and gradients thereof; multiple expressions, each with their own name, may be specified:string
fun-avg
-name — expression to compute at file output time, written as a function of any ordinary average terms; multiple expressions, each with their own name, may be specified:string
Example:
[soln-plugin-tavg]
nsteps = 10
dt-out = 2.0
mode = windowed
basedir = .
basename = files-{t:06.2f}
avg-u = u
avg-v = v
avg-uu = u*u
avg-vv = v*v
avg-uv = u*v
fun-avg-upup = uu - u*u
fun-avg-vpvp = vv - v*v
fun-avg-upvp = uv - u*v
This plugin also exposes functionality via a CLI. The following functions are available
pyfr tavg merge
— average together multiple time average files into a single time average file. The averaging times are read from the file and do not need to be evenly spaced in time.Example:
pyfr tavg merge avg-1.00.pyfrs avg-2.00.pyfrs avg-10.00.pyfrs merged_avg.pyfrs