diag_style command

Syntax:

diag_style style keyword value keyword value ... 

• style = cluster or diffusion or energy or propensity
• zero or more keyword/value pairs may be appended
• keyword = stats or delay or delt or logfreq or loglinfreq

    stats values = yes or no
      yes/no = provide output to stats line
    delay values = tdelay
      tdelay = delay evaluating diagnostic until at least this time
    delt values = delta
      delta = time increment between evaluations of the diagnostic (seconds)
    logfreq or loglinfreq values = N factor
      N = number of repetitions per interval
      factor = scale factor between intervals
  
  

• see doc pages for individual diagnostic commands for additional keywords - diagnostic-specific keywords must come after any other standard keywords

Examples:

diag_style cluster stats no delt 1.0 
diag_style energy 

Description:

This command invokes a diagnostic calculation. Currently, diagnostics can only be defined for on-lattice applications. See the app_style command for an overview of such applications.

The diagnostics currently available are:

• array = statistics of lattice values
• cluster = grain size statistics for general lattices
• diffusion = statistics on diffusion events
• energy = energy of entire system for general lattices
• propensity = propensity of entire system for general lattices

Diagnostics may provide one or more values that are appended to other statistical output and printed to the screen and log file via the stats command. This is stats output. In addition, the diagnostic may write more extensive output to its own files if requested by diagnostic-specific keywords.

The stats keyword controls whether or not the diagnostic appends values to the statistical output. If stats is set to yes, then the frequency of the stats output will determine when the diagnostic is called, and none of the other keywords related to how often the diagnostic is called can be used.

If stats is set to no, then the other keywords related to how often the diagnostic is called may be used. The delt keyword specificies Delta = the interval of time between each diagnostic calculation.

Similarly, the logfreq and loglinfreq keywords will cause the diagnostic to run at progressively larger intervals during the course of a simulation. There will be N outputs per interval where the size of each interval scales up by factor each time. Delta is the time between outputs in the first (smallest) interval. See the stats command for more information on how the output times are specified. See the stats command for more information on how the intervals are specified.

If N is specified as 0, then this will turn off logarithmic intervals, and revert to regular intervals of delta.

The delay keyword specifies the shortest time at which the diagnostic can be evaluated. This is useful if it is inconvenient to evaluate the diagnostic at time t=0.

Restrictions: none

Related commands:

stats

Default:

The stats setting is yes.