Errorfractionmarker

Marks elements for refinement or coarsening based on the fraction of the min/max error from the supplied indicator.

Description

The ErrorFractionMarker utilizes the value from an Indicator as a measure of "error" on each element. Using this error approximation the following algorithm is applied:

ErrorFractionMarker example calculation.

ErrorFractionMarker example calculation.

  1. The elements are sorted by increasing error.

  2. The elements comprising the "refine" fraction, from highest error to lowest, of the total error are marked for refinement.

  3. The elements comprising the "coarsen" fraction, from lowest error to highest, of the total error are marked for refinement.

Example Input Syntax

[Adaptivity<<<{"href": "../../syntax/Adaptivity/index.html"}>>>]
  [Indicators<<<{"href": "../../syntax/Adaptivity/Indicators/index.html"}>>>]
    [error]
      type = AnalyticalIndicator<<<{"description": "Compute the square of the error as the difference between an unknown variable and an analytical solution.", "href": "../indicators/AnalyticalIndicator.html"}>>>
      variable<<<{"description": "The name of the variable that this Indicator operates on"}>>> = u
      function<<<{"description": "The analytic solution to compare against"}>>> = solution
    []
  []
  [Markers<<<{"href": "../../syntax/Adaptivity/Markers/index.html"}>>>]
    [marker]
      type = ErrorFractionMarker<<<{"description": "Marks elements for refinement or coarsening based on the fraction of the min/max error from the supplied indicator.", "href": "ErrorFractionMarker.html"}>>>
      coarsen<<<{"description": "Elements within this percentage of the min error will be coarsened.  Must be between 0 and 1!"}>>> = 0.1
      indicator<<<{"description": "The name of the Indicator that this Marker uses."}>>> = error
      refine<<<{"description": "Elements within this percentage of the max error will be refined.  Must be between 0 and 1!"}>>> = 0.3
    []
  []
[]
(../moose/test/tests/markers/error_fraction_marker/error_fraction_marker_test.i)

Input Parameters

  • indicatorThe name of the Indicator that this Marker uses.

    C++ Type:IndicatorName

    Controllable:No

    Description:The name of the Indicator that this Marker uses.

Required Parameters

  • blockThe list of blocks (ids or names) that this object will be applied

    C++ Type:std::vector<SubdomainName>

    Controllable:No

    Description:The list of blocks (ids or names) that this object will be applied

  • clear_extremesTrueWhether or not to clear the extremes during each error calculation. Changing this to `false` will result in the global extremes ever encountered during the run to be used as the min and max error.

    Default:True

    C++ Type:bool

    Controllable:No

    Description:Whether or not to clear the extremes during each error calculation. Changing this to `false` will result in the global extremes ever encountered during the run to be used as the min and max error.

  • coarsen0Elements within this percentage of the min error will be coarsened. Must be between 0 and 1!

    Default:0

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Elements within this percentage of the min error will be coarsened. Must be between 0 and 1!

  • refine0Elements within this percentage of the max error will be refined. Must be between 0 and 1!

    Default:0

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Elements within this percentage of the max error will be refined. Must be between 0 and 1!

Optional Parameters

  • control_tagsAdds user-defined labels for accessing object parameters via control logic.

    C++ Type:std::vector<std::string>

    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

    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>

    Controllable:No

    Description:Vector of output names where you would like to restrict the output of variables(s) associated with this object

Advanced Parameters