ExternalEnergyAnalyzer

Synopsis

This analyzer computes the average of the total external energy, and optionally outputs sampled values or block averages during the simulation.

See also

DdMd::ExternalEnergyAnalyzer

Parameters

The parameter file format is:

ExternalEnergyAnalyzer{
  interval           int
  outputFileName     string
  [nSamplePerBlock]  int
}

in which

interval	number of steps between data samples
outputFileName	name of output file
nSamplePerBlock	number of samples per block average (optional, default = 0)

If nSamplePerBlock > 0, this analyzer outputs block average values every interval*nSamplePerBlock time steps. For nSamplePerBlock > 1, each such block average is an average of the most recent nSamplePerBlock sampled values, which are sampled every interval time steps. Setting nSamplePerBlock = 1 causes every sampled value to be output, with no averaging. Setting nSamplePerBlock = 0 disables computation and output of block averages.

The nSamplePerBlock parameter is optional, as indicated by the square brackets in the file format. It is set to nSamplePerBlock = 0 by default, thus disabling output of block averages by default.

Output

If nSamplePerBlock > 0, block averages are output to the file {outputFileName}.dat, with extension ".dat", during the simulation. Each line of this file contains the value of the time step associated with the first value in the block average and the value of the block average of nSamplePerBlock values. If nSamplePerBlock = 0, no such file is created.

At the end of the simulation, when the OUTPUT_ANALYZERS command is invoked:

• A copy of the parameter file block associated with this analyzer is echoed to file {outputFileName}.prm.
• The final average value and estimated error on the average is output to file {outputFileName}.ave.
• Details of the hierarchical block-averaging analysis of the error on the average, along with the value of the variance, are output to a file {outputFileName}.aer.