ValueThresholdMarker

The refinement state based on a threshold value compared to the specified variable.

Description

The ValueThresholdMarker requires an estimate of error be provided from an Indicator. Using this indicator an element is marked for refinement or coarsening if the element error value above or below the coarsening and refinement thresholds.

By default elements with error greater than the threshold defined in the "refine" parameter will be marked for refinement. Element with error less than the threshold defined in the "coarsen" parameters will be marked for coarsening. This behavior can be inverted using the "invert" parameter.

Additionally, a third buffer region can be defined. Elements in this region may be marked to a different state. Typically, this buffer region is used to define a region of elements that are marked with "DO_NOTHING" to avoid having elements marked for refinement directly adjacent to elements marked for refinement.

Example Input Syntax

[Adaptivity]
  [./Markers]
    [./marker]
      type = ValueThresholdMarker
      coarsen = 0.3
      variable = u
      refine = 0.7
    [../]
    [./inverted_marker]
      type = ValueThresholdMarker
      invert = true
      coarsen = 0.7
      refine = 0.3
      variable = u
      third_state = DO_NOTHING
    [../]
  [../]
[]

Input Parameters

variableThe values of this variable will be compared to 'refine' and 'coarsen' to see what should be done with the element
C++ Type:VariableName
Unit:(no unit assumed)
Controllable:No
Description:The values of this variable will be compared to 'refine' and 'coarsen' to see what should be done with the element

Required Parameters

blockThe list of blocks (ids or names) that this object will be applied
C++ Type:std::vector<SubdomainName>
Unit:(no unit assumed)
Controllable:No
Description:The list of blocks (ids or names) that this object will be applied
coarsenThe threshold value for coarsening. Elements with variable values beyond this will be marked for coarsening.
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The threshold value for coarsening. Elements with variable values beyond this will be marked for coarsening.
invertFalseIf this is true then values _below_ 'refine' will be refined and _above_ 'coarsen' will be coarsened.
Default:False
C++ Type:bool
Unit:(no unit assumed)
Controllable:No
Description:If this is true then values _below_ 'refine' will be refined and _above_ 'coarsen' will be coarsened.
prop_getter_suffixAn optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.
C++ Type:MaterialPropertyName
Unit:(no unit assumed)
Controllable:No
Description:An optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.
refineThe threshold value for refinement. Elements with variable values beyond this will be marked for refinement.
C++ Type:double
Unit:(no unit assumed)
Controllable:No
Description:The threshold value for refinement. Elements with variable values beyond this will be marked for refinement.
third_stateDONT_MARKThe Marker state to apply to values falling in-between the coarsen and refine thresholds.
Default:DONT_MARK
C++ Type:MooseEnum
Unit:(no unit assumed)
Options:DONT_MARK, COARSEN, DO_NOTHING, REFINE
Controllable:No
Description:The Marker state to apply to values falling in-between the coarsen and refine thresholds.
use_interpolated_stateFalseFor the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.
Default:False
C++ Type:bool
Unit:(no unit assumed)
Controllable:No
Description:For the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

Optional Parameters

control_tagsAdds user-defined labels for accessing object parameters via control logic.
C++ Type:std::vector<std::string>
Unit:(no unit assumed)
Controllable:No
Description:Adds user-defined labels for accessing object parameters via control logic.
enableTrueSet the enabled status of the MooseObject.
Default:True
C++ Type:bool
Unit:(no unit assumed)
Controllable:No
Description:Set the enabled status of the MooseObject.
outputsVector of output names where you would like to restrict the output of variables(s) associated with this object
C++ Type:std::vector<OutputName>
Unit:(no unit assumed)
Controllable:No
Description:Vector of output names where you would like to restrict the output of variables(s) associated with this object

Advanced Parameters

(moose/test/tests/markers/value_threshold_marker/value_threshold_marker_test.i)

[Mesh]
  type = GeneratedMesh
  dim = 2
  nx = 10
  ny = 10
  nz = 0
  zmax = 0
  elem_type = QUAD4
[]

[Variables]
  [./u]
    order = FIRST
    family = LAGRANGE
  [../]
[]

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

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

[Executioner]
  type = Steady

  solve_type = 'PJFNK'
[]

[Adaptivity]
  [./Markers]
    [./marker]
      type = ValueThresholdMarker
      coarsen = 0.3
      variable = u
      refine = 0.7
    [../]
    [./inverted_marker]
      type = ValueThresholdMarker
      invert = true
      coarsen = 0.7
      refine = 0.3
      variable = u
      third_state = DO_NOTHING
    [../]
  [../]
[]

[Outputs]
  exodus = true
[]

Description
Example Input Syntax
Input Parameters