Stochastic Tools Failure Analysis Report

Introduction

The FAR for the Stochastic Tools module describes the system functional and non-functional requirements that describe the expected interactions that the software shall provide.

Dependencies

The Stochastic Tools module is developed using MOOSE and can itself be based on various MOOSE modules, as such the FAR for the Stochastic Tools module is dependent upon the following documents.

Failure Analysis Requirements

The following is a complete list for all the requirements related to failure analysis for the Stochastic Tools module.

  • stochastic_tools: Distributions
  • 19.4.3The system shall produce an error if a distribution is retrieved with the differing type than supplied.

    Specification(s): normal_direct_type_error

    Design: Normal

    Issue(s): #12720

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • stochastic_tools: Ics
  • 19.6.2The system shall generate an error the random initial condition is used with both a distribution and min or max value defined.

    Specification(s): test_err_distribution_and_min_max

    Design: RandomIC

    Issue(s): #5567#11901#9710

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 19.6.1

  • stochastic_tools: Samplers
  • 19.9.2The system shall throw an error when
    1. the selected sampler type is not of an adaptive type when performing adaptive decision;

    Specification(s): ais_errors/ais_error1

    Design: Adaptive Importance Sampling (AIS)

    Issue(s): #17664

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.9.4The system shall throw an error when
    1. the selected sampler type is not of an adaptive type.

    Specification(s): pss_errors/pss_error1

    Design: Parallel Subset Simulation (PSS)

    Issue(s): #19398

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.9.6The system shall throw an error when performing 1D Cartesian sampling if
    1. the specified grid does not form a triplet,
    2. the number of nominal values specified does not match the number of sample columns,
    3. the number of grid points is not an integer, or
    4. the number of grid points is negative.

    Specification(s): errors/no_triplet, errors/wrong_num_values, errors/non_int, errors/negative

    Design: Cartesian1D

    Issue(s): #24566

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.9.20The system shall error out when the number of nested Monte Carlo loops does not match the number of sets of distributions.

    Specification(s): error

    Design: NestedMonteCarlo

    Issue(s): #20130

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.9.22The system shall error if the SOBOL sampling method is setup with input sampling matrices
    1. with differing number of rows;
    2. with differing number of columns; and
    3. if the matrices are the same.

    Specification(s): errors/row_mismatch, errors/col_mismatch, errors/same_matrix

    Design: Sobol

    Issue(s): #8065

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • stochastic_tools: Transfers
  • 19.11.4The 'StochasticToolsTransfer object shall error if the 'execute_on' parameter is defined when the corresponding MultiApp object is running in batch mode.

    Specification(s): StochasticToolsTransfer_execute_on_error

    Design: SamplerParameterTransfer

    Issue(s): #8863

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.5The 'StochasticToolsTransfer' object shall error if the 'execute_on' parameter does not match the corresponding MultiApp object is running in normal mode.

    Specification(s): StochasticToolsTransfer_execute_on_check

    Design: SamplerParameterTransfer

    Issue(s): #8863

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.6The system shall report a reasonable error if parameters for a trasnfer between multiapps are provided to stochastics transfer, which do not support this currently

    Specification(s): direction_error

    Design: SamplerParameterTransfer

    Issue(s): #8863

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.9The system shall produce an error if neither a 'SamplerTransientMultiApp' nor SamplerFullSolveMultiApp is provided in SamplerPostprocessorTransfer.

    Specification(s): wrong_multi_app

    Design: StochasticResults

    Issue(s): #9419

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.10The system shall produce an error if the 'result' object in 'SamplerPostprocessorTransfer' is not a 'StochasticResults object'.

    Specification(s): require_stochastic_results

    Design: StochasticResults

    Issue(s): #9419

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.12The system shall error if the supplied name is invalid when attempting to transfer a single value from a sub-application.

    Specification(s): invalid_sub_pp_name

    Design: SamplerPostprocessorTransfer

    Issue(s): #8065

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.13When sub-application solve does not converge, the system shall either
    1. abort run,
    2. transfer last computed postprocessor value,
    3. or transfer NaN.

    Specification(s): solve_not_converge/abort, solve_not_converge/last_computed, solve_not_converge/nan

    Design: SamplerPostprocessorTransfer

    Issue(s): #8065

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunExceptionCheckFilesCSVDiff

  • 19.11.14The system shall support the ability to transfer reporter data from each sub-application for a set of stochastic data
    1. in normal mode,
    2. in batch mode,
    3. with distributed output,
    4. with more processors than samples,
    5. and error if transferring unsupported type.

    Specification(s): transfer/normal, transfer/batch, transfer/distributed, transfer/more_cpus, transfer/invalid_type

    Design: SamplerReporterTransfer

    Issue(s): #16166

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): JSONDiffRunException

  • 19.11.15The system shall produce an error if neither a 'SamplerTransientMultiApp' nor SamplerFullSolveMultiApp is provided in SamplerParameterTransfer.

    Specification(s): multiapp_type

    Design: SamplerParameterTransfer

    Issue(s): #11363

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.16The system shall produce an error if the sampler sub-application does not contain a Control object with the name 'stochastic'.

    Specification(s): control_missing

    Design: SamplerTransientMultiApp

    Issue(s): #11363

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.17The system shall produce an error if supplied vector of real values is not sized correctly within the SamplerParameterTransfer object.

    Specification(s): num_parameters_wrong

    Design: SamplerParameterTransfer

    Issue(s): #11363

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.18The system shall produce an error if a vector of values is supplied to a scalar parameter.

    Specification(s): not_vector

    Design: SamplerParameterTransfer

    Issue(s): #11363

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.19The system shall produce an error if sampling method differs between the sub-application and the associated sub-application data transfer.

    Specification(s): sampler_mismatch

    Design: SamplerParameterTransfer

    Issue(s): #11363

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 19.11.22The system shall error if the transferred vector to a sub-application
    1. if the vector parameter does not exist;
    2. if the sub-application does not consume all of the supplied data;

    Specification(s): errors/invalid_name, errors/extra_data

    Design: SamplerParameterTransfer

    Issue(s): #8065

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException