BlackBear Requirements Traceability Matrix

This template follows INL template TEM-214, "IT System Requirements Traceability Matrix."

commentnote

This document serves as an addendum to Framework Requirements Traceability Matrix and captures information for RTM specific to the BlackBear application.

Introduction

Minimum System Requirements

In general, the following is required for MOOSE-based development:

A POSIX compliant Unix-like operating system. This includes any modern Linux-based operating system (e.g., Ubuntu, Fedora, Rocky, etc.), or a Macintosh machine running either of the last two MacOS releases.

HardwareInformation
CPU Architecturex86_64, ARM (Apple Silicon)
Memory8 GB (16 GBs for debug compilation)
Disk Space30GB

LibrariesVersion / Information
GCC9.0.0 - 12.2.1
LLVM/Clang10.0.1 - 19
Intel (ICC/ICX)Not supported at this time
Python3.10 - 3.13
Python Packagespackaging pyaml jinja2

System Purpose

The purpose of BlackBear is to simulate the progression of degradation in structural components (e.g., buildings, bridges, dams) due to exposure to the environmental conditions they experience over their lifetime. In addition, BlackBear predicts the response of those structures in the presence of that long-term degradation to loading conditions of interest to assess the effects of degradation on their integrity.

System Scope

BlackBear models the effects of environmental exposure on structures. The environmental conditions that can induce aging include evolving mechanical loading and exposure to temperature and moisture. The materials modeled by BlackBear include those typically used in the construction of civil structures, such as concrete and steel. Under normal service, these structures can experience a variety of degradation mechanisms. For example, steel and other metals can degrade due to corrosion, embrittlement, and stress corrosion cracking. Concrete can experience degradation due to expansive reactions, chemical attacks, leaching, and mechanical mechanisms induced by conditions such as freeze/thaw cycles and fatigue.

In addition to modeling the degradation mechanisms, BlackBear also models the response of these structures to a variety of loading conditions that these structures are expected to safely withstand. These include a variety of normal thermal and mechanical service loading conditions, as well as wind and earthquake loading conditions. BlackBear includes models to represent the behavior of structural materials under those conditions, which can induce creep, plasticity, damage, fracture, and failure of these materials.

Assumptions and Dependencies

The BlackBear application is developed using MOOSE and is based on various modules, as such the RTM for BlackBear is dependent upon the files listed at the beginning of this document.

Pre-test Instructions/Environment/Setup

Ideally all testing should be performed on a clean test machine following one of the supported configurations setup by the test system engineer. Testing may be performed on local workstations and cluster systems containing supported operating systems.

The repository should be clean prior to building and testing. When using "git" this can be done by doing a force clean in the main repository and each one of the submodules:


git clean -xfd
git submodule foreach 'git clean -xfd'

All tests must pass in accordance with the type of test being performed. This list can be found in the Software Test Plan.

Changelog Issue Revisions

Errors in changelog references can sometimes occur as a result of typos or conversion errors. If any need to be noted by the development team, they will be noted here.

Currently, the BlackBear development team has not discovered or identified any errors in issue references related to the changelog. This document will be updated if any such issues are discovered.

System Requirements Traceability

Functional Requirements

  • blackbear: Concrete Asr Validation
  • 9.4.1Blackbear shall model the expansion induced by alkali-silica reaction as demonstrated with
    1. a comparison of the ASR volumetric strain to an analytic function,
    2. a maximum volumetric expansion of 0.76e-3, characteristic time of 66.84, and latency time of -126.1,
    3. and a maximum volumetric expansion of 0.38e-3, characteristic time of 17.24, and latency time of -2.55.

    Specification(s): ASRtest/case1, ASRtest/case2, ASRtest/case3

    Design: Concrete ASR Eigenstrain

    Issue(s): #89

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

    888
  • blackbear: Function Offset Bc
  • 9.11.1Blackbear shall support Dirichlet type boundary conditions defined by a function
    1. for a planar boundary with positive offset location along nodal normal direction
    2. for a curved boundary with negative offset location along nodal normal direction

    Specification(s): test_bc/test_rectangular, test_bc/test_circular

    Design: FunctionOffsetDirichletBC

    Issue(s): #356

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

    718
  • blackbear: Mazars Tensile Bar
  • 9.13.1BlackBear shall provide the Mazars scalar damage model for concrete, correctly predicting the response of a multi-element concrete bar loaded in tension

    Specification(s): tensile_bar

    Design: Mazars Damage

    Issue(s): #24

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

    8
  • blackbear: Neml Ancillary
  • 9.14.1NEMLStateAux outputs state to aux system

    Specification(s): neml_aux_output

    Design: NEMLStateAux

    Issue(s): #343

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    8
  • 9.14.2NEMLMaterialPropertyReset in fact resets the state variable after reaching the critical temperature

    Specification(s): neml_anneal_state

    Design: NEMLMaterialPropertyReset

    Issue(s): #343

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    8
  • blackbear: Neml Benchmark
  • 9.15.1Blackbear shall be capable of running a TM model with inelastic material exhibiting linear strain hardening.

    Specification(s): neml_LSH

    Design: NEML Stress

    Issue(s): #59

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    71
  • 9.15.2Blackbear shall be capable of using the NEML library to simulate an inelastic material exhibiting linear strain hardening.

    Specification(s): TM_LSH

    Design: NEML Stress

    Issue(s): #59

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    71
  • 9.15.3Blackbear shall be capable of running a TM model with inelastic material exhibiting power law creep behavior.

    Specification(s): test5a_lim

    Design: NEML Stress

    Issue(s): #59

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    71
  • 9.15.4Blackbear shall be capable of using the NEML library to simulate an inelastic material exhibiting power law creep behavior.

    Specification(s): test5a_lim_neml

    Design: NEML Stress

    Issue(s): #59

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    71
  • blackbear: Neml Complex
  • 9.16.1BlackBear shall be capable of using the NEML library to compute the response of an inelastic material

    Specification(s): neml_inelastic

    Design: NEML Stress

    Issue(s): #59

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    8
  • 9.16.2BlackBear shall be capable of using a timestep limit computed by the NEML coupling material

    Specification(s): neml_inelastic_dt

    Design: NEML Stress

    Issue(s): #169

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    8
  • blackbear: Neml Damage
  • 9.17.1BlackBear shall output the damage value for NEML models.

    Specification(s): neml_damage_output

    Design: NEML Stress

    Issue(s): #305

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

    8
  • blackbear: Neml Lagrangian Jacobian
  • 9.18.1Jacobian is exact with relative tolerance of 1e-7 for small strain kinematics using the total Lagrangian formulation

    Specification(s): small_total

    Design: CauchyStressFromNEML

    Issue(s): #312

    Collection(s): FUNCTIONAL

    Type(s): PetscJacobianTester

    5
  • 9.18.2Jacobian is exact with relative tolerance of 1e-7 for small strain kinematics using the updated Lagrangian formulation

    Specification(s): small_updated

    Design: CauchyStressFromNEML

    Issue(s): #312

    Collection(s): FUNCTIONAL

    Type(s): PetscJacobianTester

    5
  • 9.18.3Jacobian is exact with relative tolerance of 1e-7 for large strain kinematics using the total Lagrangian formulation

    Specification(s): large_total

    Design: CauchyStressFromNEML

    Issue(s): #312

    Collection(s): FUNCTIONAL

    Type(s): PetscJacobianTester

    5
  • 9.18.4Jacobian is exact with relative tolerance of 1e-7 for large strain kinematics using the updated Lagrangian formulation

    Specification(s): large_updated

    Design: CauchyStressFromNEML

    Issue(s): #312

    Collection(s): FUNCTIONAL

    Type(s): PetscJacobianTester

    5
  • blackbear: Neml Simple
  • 9.19.2BlackBear shall be capable of using the NEML library to compute the response of a linearly elastic material parsed from xml. Parameters defined in the xml can be overwritten by variables in the input file.

    Specification(s): neml_linear_elastic_variableOverwrite

    Design: NEML Stress

    Issue(s): #59

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    62
  • 9.19.3BlackBear shall be capable of using the NEML library to compute the response of a linearly elastic material defined in a material class

    Specification(s): neml_linear_elastic_simpleMaterial

    Design: NEML Stress

    Issue(s): #78

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    8
  • blackbear: Neml Stochasticsimple
  • 9.20.1BlackBear shall provide the ability to use the NEML library to model material response, and allow for parameters defined in the xml file to be overridden in the BlackBear input file

    Specification(s): neml_simple_stochastic

    Design: NEML Stress

    Issue(s): #78

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    8
  • blackbear: Steel Creep Damage Oh
  • 9.21.1Blackbear shall compute steel creep damage considering stress triaxiality as per Oh et al (2011)
    1. and apply it reduce the finite element stress of a simple problem to simulate creep failure.
    2. and apply it to reduce the finite element stress of a simple problem to simulate creep failure when using automatic differentiation.
    3. and apply it to reduce the finite element stress of a simple two-dimensional problem to simulatecreep failure when using automatic differentiation.
    4. and apply it to reduce the finite element stress of a simple two-dimensional problem to simulatecreep failure when using hand-coded Jacobians.

    Specification(s): creepdamage/steel_creep_damage, creepdamage/ad_steel_creep_damage, creepdamage/ad_steel_creep_damage_2d, creepdamage/steel_creep_damage_2d

    Design: Steel Creep Damage (Oh et al)

    Issue(s): #231

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

    88
  • 9.21.2Blackbear shall compute steel creep damage
    1. using a single creep strain name in the input.
    2. using a vector of creep strain names in the input to reproduce creep strain and damage from equivalent single power law.

    Specification(s): vector/singlecreeplaw, vector/multicreeplaw

    Design: Steel Creep Damage (Oh et al)

    Issue(s): #307

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

    8

Usability Requirements

No requirements of this type exist for this application, beyond those of its dependencies.

Performance Requirements

No requirements of this type exist for this application, beyond those of its dependencies.

System Interface Requirements

References

No citations exist within this document.