Electromagnetics Failure Analysis Report

Introduction

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

Dependencies

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

Framework Failure Analysis Report

Failure Analysis Requirements

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

electromagnetics: Auxkernels
4.1.5
The system shall throw an error if
1. the electric field is supplied as a vector and scalar components to the AzimuthMagneticTimeDerivRZ object.
2. only the x-component of the electric field is supplied to the AzimuthMagneticTimeDerivRZ object.
3. if only the y-component of the electric field is supplied to the AzimuthMagneticTimeDerivRZ object.
Specification(s): exceptions/both_scalar_and_vector_error_azim_magnetic_time_deriv, exceptions/x_comp_only_error_azim_magnetic_time_deriv, exceptions/y_comp_only_error_azim_magnetic_time_deriv
Design: AzimuthMagneticTimeDerivRZ
Issue(s): #28758
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
27 27 27
4.1.9
The system shall provide an error while
1. calculating the current density when both electrostatic and electromagnetic field variables are provided by the user.
2. calculating the current density when an electrostatic calculation is requested but an electromagnetic field variable is provided.
3. calculating the current density when an electromagnetic calculation is requested but an electrostatic field variable is provided.
Specification(s): errors/two_vars, errors/ES_electric_field_var, errors/EM_potential_var
Design: CurrentDensity / ADCurrentDensity
Issue(s): #21095
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
27 27 27

electromagnetics: Bcs
4.2.4The system shall present an error to the user whenever the mode of operation for VectorEMRobinBC is set to absorbing, but incoming wave information is supplied.
Specification(s): waves_absorbing_error
Design: VectorEMRobinBC
Issue(s): #21100
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
Prerequisite(s): 4.2.2
27

electromagnetics: Benchmarks
4.3.10The system shall present an error to the user whenever the mode of operation for EMRobinBC is set to absorbing, but incoming wave information is supplied.
Specification(s): absorbing_error
Design: EMRobinBC
Issue(s): #21100
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
Prerequisite(s): 4.3.9
7

electromagnetics: InterfaceKernel Objects
4.4.8The system shall supply an error if both user-supplied and system-calculated contact conductance is requested when determining the effect of electrostatic contact on an interface.
Specification(s): electrostatic_contact_conductance_error
Design: ElectrostaticContactCondition
Issue(s): #21091
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
Prerequisite(s): 4.4.6
27

electromagnetics: Postprocessors
4.6.1The system shall supply an error if the ReflectionCoefficient object is used on meshes with a dimension larger than one.
Specification(s): dim_error
Design: ReflectionCoefficient
Issue(s): #13744
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
27


[both_scalar_and_vector_error_azim_magnetic_time_deriv]
  type = 'RunException'
  input = 'error_azim_magnetic_time_deriv.i'
  cli_args = 'AuxKernels/aux_azim_dB_dt/Efield_X=aux_E_real_x AuxKernels/aux_azim_dB_dt/Efield_Y=aux_E_real_y AuxKernels/aux_azim_dB_dt/Efield=E_real'
  expect_err = 'Both a vector and scalar components of the electric field were provided! Please only choose one.'
  detail = 'the electric field is supplied as a vector and scalar components to the AzimuthMagneticTimeDerivRZ object.'
[]


[x_comp_only_error_azim_magnetic_time_deriv]
  type = 'RunException'
  input = 'error_azim_magnetic_time_deriv.i'
  cli_args = 'AuxKernels/aux_azim_dB_dt/Efield_X=aux_E_real_x'
  expect_err = 'Neither a vector nor two scalar components of the electric field were provided! Please check the input parameters.'
  detail = 'only the x-component of the electric field is supplied to the AzimuthMagneticTimeDerivRZ object.'
[]


[y_comp_only_error_azim_magnetic_time_deriv]
  type = 'RunException'
  input = 'error_azim_magnetic_time_deriv.i'
  cli_args = 'AuxKernels/aux_azim_dB_dt/Efield_Y=aux_E_real_y'
  expect_err = 'Neither a vector nor two scalar components of the electric field were provided! Please check the input parameters.'
  detail = 'if only the y-component of the electric field is supplied to the AzimuthMagneticTimeDerivRZ object.'
[]


[two_vars]
  type = RunException
  input = error_test.i
  cli_args = 'AuxKernels/current_density/potential=potential AuxKernels/current_density/electric_field=electric_field'
  expect_err = 'In current_density, both electrostatic potential and electric field variables have been provided. Please only provide one or the other!'
  detail = 'calculating the current density when both electrostatic and electromagnetic field variables are provided by the user.'
[]


[ES_electric_field_var]
  type = RunException
  input = error_test.i
  cli_args = 'AuxKernels/current_density/electric_field=electric_field'
  expect_err = 'In current_density, an electric field vector variable has been provided when `electrostatic = TRUE`'
  detail = 'calculating the current density when an electrostatic calculation is requested but an electromagnetic field variable is provided.'
[]


[EM_potential_var]
  type = RunException
  input = error_test.i
  cli_args = 'AuxKernels/current_density/potential=potential AuxKernels/current_density/electrostatic=false'
  expect_err = 'In current_density, an electrostatic potential variable has been provided when `electrostatic = FALSE`'
  detail = 'calculating the current density when an electromagnetic calculation is requested but an electrostatic field variable is provided.'
[]


[waves_absorbing_error]
  type = RunException
  input = portbc_waves.i
  prereq = waves
  cli_args = 'BCs/sides_real/mode=absorbing'
  expect_err = 'In sides_real, mode was set to Absorbing, while an incoming'
  requirement = 'The system shall present an error to the user whenever the mode of operation for VectorEMRobinBC is set to absorbing, but incoming wave information is supplied.'
  design = 'VectorEMRobinBC.md'
  issues = '#21100'
[]


[absorbing_error]
  type = 'RunException'
  input = 'waveguide2D_test.i'
  prereq = test
  cli_args = 'BCs/port_real/mode=absorbing'
  expect_err = 'In port_real, mode was set to Absorbing, while an incoming'
  requirement = 'The system shall present an error to the user whenever the mode of operation for EMRobinBC is set to absorbing, but incoming wave information is supplied.'
  design = 'EMRobinBC.md'
  issues = '#21100'
[]


[electrostatic_contact_conductance_error]
  type = RunException
  input = 'contact_conductance_supplied.i'
  cli_args = 'InterfaceKernels/electrostatic_contact/mean_hardness=1.0'
  expect_err = 'In electrostatic_contact, both user-supplied electrical contact conductance'
  prereq = electrostatic_contact_conductance_supplied
  requirement = 'The system shall supply an error if both user-supplied and system-calculated contact conductance is requested when determining the effect of electrostatic contact on an interface.'
  design = 'ElectrostaticContactCondition.md'
  issues = '#21091'
[]

[dim_error]
  type = RunException
  input = 'reflection_pp_test.i'
  expect_err = 'The ReflectionCoefficient object is not currently configured to work with 2D or 3D meshes'
  requirement = 'The system shall supply an error if the ReflectionCoefficient object is used on meshes with a dimension larger than one.'
  design = 'ReflectionCoefficient.md'
  issues = '#13744'
[]

Introduction
Dependencies
Failure Analysis Requirements