ChangeOverTimestepPostprocessor

Computes the change or relative change in a post-processor value over a timestep or the entire transient

The ChangeOverTimestepPostprocessor can be used to track convergence of additional quantities computed by postprocessors. For example, in conjugate heat transfer simulations, the total energy stored in the fluid should be tracked as an additional convergence metric, and not just the residual from the equations.

The 'INITIAL' execute_on flag should be included in the tracked postprocessor execute_on parameter if the ChangeOverTimestepPostprocessor is set to compute the difference with regards to the initial value.

Example input syntax

In this example, the ChangeOverTimestepPostprocessor is set to track the change of a FunctionValuePostprocessor, as a test of correctness. The FunctionValuePostprocessor's evolution is known as it is defined by a ParsedFunction.

[Postprocessors<<<{"href": "../../syntax/Postprocessors/index.html"}>>>]
  [./my_postprocessor]
    type = FunctionValuePostprocessor<<<{"description": "Computes the value of a supplied function at a single point (scalable)", "href": "FunctionValuePostprocessor.html"}>>>
    function<<<{"description": "The function which supplies the postprocessor value."}>>> = my_function
    execute_on<<<{"description": "The list of flag(s) indicating when this object should be executed. For a description of each flag, see https://mooseframework.inl.gov/source/interfaces/SetupInterface.html."}>>> = 'initial timestep_end'
  [../]
  [./change_over_time]
    type = ChangeOverTimePostprocessor<<<{"description": "Computes the change or relative change in a post-processor value over a timestep or the entire transient", "href": "ChangeOverTimePostprocessor.html"}>>>
    postprocessor<<<{"description": "The name of the postprocessor"}>>> = my_postprocessor
    change_with_respect_to_initial<<<{"description": "Compute change with respect to initial value instead of previous value"}>>> = false
    execute_on<<<{"description": "The list of flag(s) indicating when this object should be executed. For a description of each flag, see https://mooseframework.inl.gov/source/interfaces/SetupInterface.html."}>>> = 'initial timestep_end'
  [../]
[]

[Functions<<<{"href": "../../syntax/Functions/index.html"}>>>]
  [./my_function]
    type = ParsedFunction<<<{"description": "Function created by parsing a string", "href": "../functions/MooseParsedFunction.html"}>>>
    expression<<<{"description": "The user defined function."}>>> = '1 + t * t'
  [../]
[]

(moose/test/tests/postprocessors/change_over_time/change_over_time.i)

# This test tests the ChangeOverTimePostprocessor, which computes the change
# in a postprocessor value with respect to the previous value or with respect to
# the initial value. This test creates a time-dependent function postprocessor
# and then computes its change over a timestep. The FE problem used here is a
# dummy problem and has no effect on the test.

[Mesh]
  type = GeneratedMesh
  dim = 1
  nx = 5
[]

[Variables]
  [./u]
  [../]
[]

[Kernels]
  [./time_derivative]
    type = TimeDerivative
    variable = u
  [../]
  [./diff]
    type = Diffusion
    variable = u
  [../]
[]

[BCs]
  [./left]
    type = DirichletBC
    variable = u
    boundary = left
    value = 0
  [../]
  [./right]
    type = DirichletBC
    variable = u
    boundary = right
    value = 1
  [../]
[]

[Executioner]
  type = Transient

  start_time = 0.0
  dt = 1.0
  num_steps = 2
[]

[Functions]
  [./my_function]
    type = ParsedFunction
    expression = '1 + t * t'
  [../]
[]

[Postprocessors]
  [./my_postprocessor]
    type = FunctionValuePostprocessor
    function = my_function
    execute_on = 'initial timestep_end'
  [../]
  [./change_over_time]
    type = ChangeOverTimePostprocessor
    postprocessor = my_postprocessor
    change_with_respect_to_initial = false
    execute_on = 'initial timestep_end'
  [../]
[]

[Outputs]
  file_base = 'change_over_time_previous'
  csv = true
[]