PolynomialChaosLocalSensitivity

This vector postprocessor uses a trained PolynomialChaos surrogate and computes local sensitivities of a quantity of interest , for a parameter at a point () is defined as:

Example Syntax

[local_sense]
  type = PolynomialChaosLocalSensitivity
  pc_name = poly_chaos
  local_points_sampler = grid
  local_points = '3.14159 3.14159 2.7182 3.14159 3.14159 2.7182 2.7182 2.7182'
  output_points = true
  sensitivity_parameters = '0 1'
  execute_on = final
[]
(modules/stochastic_tools/test/tests/surrogates/poly_chaos/master_2d_quad_locs.i)

As shown above, sample points () can be defined by either inputting them as a vector directly, or using a sampler defined like:

[grid]
  type = CartesianProduct
  linear_space_items = '2.5 0.5 10  2.5 0.5 10'
[]
(modules/stochastic_tools/test/tests/surrogates/poly_chaos/master_2d_quad_locs.i)

The parameter with which to take the sensitivity with respect to is defined by inputting the variable numbers in "sensitivity_parameters", which will correspond to the order of distributions set up by the training sampler. If this input is empty or ignored, the sensitivity with respect to every parameter is calculated.

Input Parameters

  • pc_nameName of PolynomialChaos.

    C++ Type:UserObjectName

    Options:

    Description:Name of PolynomialChaos.

Required Parameters

  • contains_complete_historyFalseSet this flag to indicate that the values in all vectors declared by this VPP represent a time history (e.g. with each invocation, new values are added and old values are never removed). This changes the output so that only a single file is output and updated with each invocation

    Default:False

    C++ Type:bool

    Options:

    Description:Set this flag to indicate that the values in all vectors declared by this VPP represent a time history (e.g. with each invocation, new values are added and old values are never removed). This changes the output so that only a single file is output and updated with each invocation

  • execute_onTIMESTEP_ENDThe 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.

    Default:TIMESTEP_END

    C++ Type:ExecFlagEnum

    Options:NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, CUSTOM

    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.

  • local_pointsPoints specifying desired location of sensitivity measurement.

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

    Options:

    Description:Points specifying desired location of sensitivity measurement.

  • local_points_samplerSampler specifying desired location of sensitivity measurement.

    C++ Type:SamplerName

    Options:

    Description:Sampler specifying desired location of sensitivity measurement.

  • output_pointsFalseTrue to include local points in output.

    Default:False

    C++ Type:bool

    Options:

    Description:True to include local points in output.

  • parallel_typeREPLICATEDSet how the data is represented within the VectorPostprocessor (VPP); 'distributed' indicates that data within the VPP is distributed and no auto communication is preformed, this setting will result in parallel output within the CSV output; 'replicated' indicates that the data within the VPP is correct on processor 0, the data will automatically be broadcast to all processors unless the '_auto_broadcast' param is set to false within the validParams function.

    Default:REPLICATED

    C++ Type:MooseEnum

    Options:DISTRIBUTED, REPLICATED

    Description:Set how the data is represented within the VectorPostprocessor (VPP); 'distributed' indicates that data within the VPP is distributed and no auto communication is preformed, this setting will result in parallel output within the CSV output; 'replicated' indicates that the data within the VPP is correct on processor 0, the data will automatically be broadcast to all processors unless the '_auto_broadcast' param is set to false within the validParams function.

  • sensitivity_parametersParameters to take derivative with respect to, matchs columns in training sampler. Default is to find local sensitivity of all parameters.

    C++ Type:std::vector<unsigned int>

    Options:

    Description:Parameters to take derivative with respect to, matchs columns in training sampler. Default is to find local sensitivity of all parameters.

Optional Parameters

  • allow_duplicate_execution_on_initialFalseIn the case where this UserObject is depended upon by an initial condition, allow it to be executed twice during the initial setup (once before the IC and again after mesh adaptivity (if applicable).

    Default:False

    C++ Type:bool

    Options:

    Description:In the case where this UserObject is depended upon by an initial condition, allow it to be executed twice during the initial setup (once before the IC and again after mesh adaptivity (if applicable).

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

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

    Options:

    Description:Adds user-defined labels for accessing object parameters via control logic.

  • enableTrueSet the enabled status of the MooseObject.

    Default:True

    C++ Type:bool

    Options:

    Description:Set the enabled status of the MooseObject.

  • force_preauxFalseForces the GeneralUserObject to be executed in PREAUX

    Default:False

    C++ Type:bool

    Options:

    Description:Forces the GeneralUserObject to be executed in PREAUX

  • force_preicFalseForces the GeneralUserObject to be executed in PREIC during initial setup

    Default:False

    C++ Type:bool

    Options:

    Description:Forces the GeneralUserObject to be executed in PREIC during initial setup

  • outputsVector of output names were you would like to restrict the output of variables(s) associated with this object

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

    Options:

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

  • use_displaced_meshFalseWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

    Default:False

    C++ Type:bool

    Options:

    Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

Advanced Parameters

Input Files