CoarsenedPiecewiseLinear

Perform a point reduction of the tabulated data upon initialization, then evaluate using a linear interpolation.

Description

The CoarsenedPiecewiseLinear performs preprocessing and linear interpolation on an x/y data set. The object acts like PiecewiseLinear except that it reduces the number of function point at the start of the simulation. It uses the Ramer-Douglas-Peucker algorithm for data reduction.

Example Input Syntax

[Functions]
  [./ic_function]
    type = PiecewiseLinear
    data_file = piecewise_linear_columns.csv #Will generate error because data is expected in rows
    scale_factor = 1.0
  [../]
[]

Input Parameters

epsilonSignificant distance in the function below which points are considered removable noise
C++ Type:double
Controllable:No
Description:Significant distance in the function below which points are considered removable noise

Required Parameters

axisThe axis used (x, y, or z) if this is to be a function of position
C++ Type:MooseEnum
Options:x, y, z
Controllable:No
Description:The axis used (x, y, or z) if this is to be a function of position
data_fileFile holding CSV data
C++ Type:FileName
Controllable:No
Description:File holding CSV data
execute_onLINEARThe list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, CUSTOM, ALWAYS.
Default:LINEAR
C++ Type:ExecFlagEnum
Options:NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, CUSTOM, ALWAYS
Controllable:No
Description:The list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, CUSTOM, ALWAYS.
formatrowsFormat of csv data file that is in either in columns or rows
Default:rows
C++ Type:MooseEnum
Options:columns, rows
Controllable:No
Description:Format of csv data file that is in either in columns or rows
scale_factor1Scale factor to be applied to the ordinate values
Default:1
C++ Type:double
Controllable:Yes
Description:Scale factor to be applied to the ordinate values
xThe abscissa values
C++ Type:std::vector<double>
Controllable:No
Description:The abscissa values
x_index_in_file0The abscissa index in the data file
Default:0
C++ Type:unsigned int
Controllable:No
Description:The abscissa index in the data file
x_scale1Scaling factor to apply to the function nodes for the purpose of computing distances in the Douglas-Peucker point reduction algorithm. This permits shifting the weight between x and y-direction distances.
Default:1
C++ Type:double
Controllable:No
Description:Scaling factor to apply to the function nodes for the purpose of computing distances in the Douglas-Peucker point reduction algorithm. This permits shifting the weight between x and y-direction distances.
x_titleThe title of the column/row containing the x data in the data file
C++ Type:std::string
Controllable:No
Description:The title of the column/row containing the x data in the data file
xy_dataAll function data, supplied in abscissa, ordinate pairs
C++ Type:std::vector<double>
Controllable:No
Description:All function data, supplied in abscissa, ordinate pairs
xy_in_file_onlyTrueIf the data file only contains abscissa and ordinate data
Default:True
C++ Type:bool
Controllable:No
Description:If the data file only contains abscissa and ordinate data
yThe ordinate values
C++ Type:std::vector<double>
Controllable:No
Description:The ordinate values
y_index_in_file1The ordinate index in the data file
Default:1
C++ Type:unsigned int
Controllable:No
Description:The ordinate index in the data file
y_scale1Scaling factor to apply to the function nodes for the purpose of computing distances in the Douglas-Peucker point reduction algorithm. This permits shifting the weight between x and y-direction distances.
Default:1
C++ Type:double
Controllable:No
Description:Scaling factor to apply to the function nodes for the purpose of computing distances in the Douglas-Peucker point reduction algorithm. This permits shifting the weight between x and y-direction distances.
y_titleThe title of the column/row containing the y data in the data file
C++ Type:std::string
Controllable:No
Description:The title of the column/row containing the y data in the data file

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.

Advanced Parameters

(../../../SoftwareDownloads/moose/test/tests/misc/check_error/function_file_test1.i)

# Test for usage of missing function
[Mesh]
  [./square]
    type = GeneratedMeshGenerator
    nx = 2
    ny = 2
    dim = 2
  [../]
[]

[Variables]
  active = 'u'

  [./u]
    order = FIRST
    family = LAGRANGE
    [./InitialCondition]
      type = FunctionIC
      function = ic_function
    [../]
  [../]

[]

[Functions]
  [./ic_function]
    type = PiecewiseLinear
    data_file = piecewise_linear_columns.csv #Will generate error because data is expected in rows
    scale_factor = 1.0
  [../]
[]

[Kernels]
  active = 'diff'

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

[BCs]
  active = 'left right'

  [./left]
    type = DirichletBC
    variable = u
    boundary = 3
    value = 0
  [../]

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

[Executioner]
  type = Steady

  solve_type = 'PJFNK'
[]

[Outputs]
  file_base = out
[]

Description
Example Input Syntax
Input Parameters