Ray Tracing System Design Description

This template follows INL template TEM-140, "IT System Design Description."

note

This document serves as an addendum to Framework System Design Description and captures information for Software Design Description (SDD) specific to the Ray Tracing application.

Framework System Design Description

Introduction

Frameworks are a software development construct aiming to simplify the creation of specific classes of applications through abstraction of low-level details. The main object of creating a framework is to provide an interface to application developers that saves time and provides advanced capabilities not attainable otherwise. The MOOSE, mission is just that: provide a framework for engineers and scientists to build state-of-the-art, computationally scalable finite element based simulation tools.

MOOSE was conceived with one major objective: to be as easy and straightforward to use by scientists and engineers as possible. MOOSE is meant to be approachable by non-computational scientists who have systems of PDEs they need to solve. Every single aspect of MOOSE was driven by this singular principle from the build system to the API to the software development cycle. At every turn, decisions were made to enable this class of users to be successful with the framework. The pursuit of this goal has led to many of the unique features of MOOSE:

A streamlined build system
An API aimed at extensible
Straightforward APIs providing sensible default information
Integrated, automatic, and rigorous testing
Rapid, continuous integration development cycle
Codified, rigorous path for contributing
Applications are modular and composable

Each of these characteristics is meant to build trust in the framework by those attempting to use it. For instance, the build system is the first thing potential framework users come into contact with when they download a new software framework. Onerous dependency issues, complicated, hard to follow instructions or build failure can all result in a user passing on the platform. Ultimately, the decision to utilize a framework comes down to whether or not you trust the code in the framework and those developing it to be able to support your desired use-case. No matter the technical capabilities of a framework, without trust users will look elsewhere. This is especially true of those not trained in software development or computational science.

Developing trust in a framework goes beyond utilizing "best practices" for the code developed, it is equally important that the framework itself is built upon tools that are trusted. For this reason, MOOSE relies on a well-established code base of libMesh and PETSc. The libMesh library provides foundational capability for the finite element method and provides interfaces to leading-edge numerical solution packages such as PETSc.

With these principles in mind, an open source, massively parallel, finite element, multiphysics framework has been conceived. MOOSE is an on-going project started in 2008 aimed toward a common platform for creation of new multiphysics tools. This document provides design details pertinent to application developers as well as framework developers.

Use Cases

The MOOSE Framework is targeted at two main groups of actors: Developers and Users. Developers are the main use case. These are typically students and professionals trained in science and engineering fields with some level of experience with coding but typically very little formal software development training. The other user group is Users. Those who intend to use an application built upon the framework without writing any computer code themselves. Instead they may modify or create input files for driving a simulation, run the application, and analyze the results. All interactions through MOOSE are primarily through the command-line interface and through a customizable block-based input file.

System Purpose

The Software Design Description provided here is description of each object in the system. The pluggable architecture of the framework makes MOOSE and MOOSE-based applications straightforward to develop as each piece of end-user (developer) code that goes into the system follows a well-defined interface for the underlying systems that those object plug into. These descriptions are provided through developer-supplied "markdown" files that are required for all new objects that are developed as part of the framework, modules and derivative applications. More information about the design documentation can be found in Documenting MOOSE.

System Scope

The purpose of this software is to provide several libraries that can be used to build an application based upon the framework. Additionally, several utilities are provided for assisting developers and users in end-to-end FEM analysis. A brief overview of the major components are listed here:

Component	Description
framework library	The base system from which all MOOSE-based applications are created
module libraries	Optional "physics" libraries that may be used in an application to provide capability
build system	The system responsible for creating applications for a series of libraries and applications
test harness	The extendable testing system for finding, scheduling, running, and reporting regression tests
"peacock"	The graphical user interface (GUI) for building input files, executing applications, and displaying results
MooseDocs	The extendable markdown system for MOOSE providing common documentation and requirements enforcement
"stork"	The script and templates for generating a new MOOSE-based application ready for building and testing
examples	A set of complete applications demonstrating the use of MOOSE's pluggable systems
tutorials	Step by step guides to building up an application using MOOSE's pluggable systems
unit	An application for unit testing individual classes or methods of C++ code

Dependencies and Limitations

The MOOSE platform has several dependencies on other software packages and has scope that is constantly evolving based upon funding, resources, priorities, and lab direction. However, the software is open-source and many features and even bugs can be offloaded to developers with appropriate levels of knowledge and direction from the main design team. The primary list of software dependencies is listed below. This list is not meant to be exhaustive. Individual operating systems may require specific packages to be installed prior to using MOOSE, which can be found on the Install MOOSE pages.

Software Dependency	Description
libMesh	Finite Element Library and I/O routines
PETSc	Solver Package
hypre	Multigrid Preconditioner
MPI	A distributed parallel processing library (MPICH)

Figure 1: A diagram of the MOOSE code platform.

References

ISO/IEC/IEEE 24765:2010(E). Systems and software engineering—Vocabulary. first edition, December 15 2010.

@manual{ISO-systems-software,
    author = "24765:2010(E), ISO/IEC/IEEE",
    title = "Systems and software engineering---Vocabulary",
    edition = "First",
    year = "2010",
    month = "December 15"
}

ASME NQA-1. ASME NQA-1-2008 with the NQA-1a-2009 addenda: Quality Assurance Requirements for Nuclear Facility Applications. first edition, August 31 2009.

@manual{ASME-NQA-1-2008,
    author = "NQA-1, ASME",
    title = "ASME NQA-1-2008 with the NQA-1a-2009 addenda: Quality Assurance Requirements for Nuclear Facility Applications",
    orginization = "American Socieity of Mechanical Engineers",
    year = "2009",
    month = "August 31",
    edition = "First"
}

Definitions and Acronyms

This section defines, or provides the definition of, all terms and acronyms required to properly understand this specification.

Definitions

- Pull (Merge) Request: A proposed change to the software (e.g. usually a code change, but may also include documentation, requirements, design, and/or testing). - Baseline: A specification or product (e.g., project plan, maintenance and operations (M&O) plan, requirements, or design) that has been formally reviewed and agreed upon, that thereafter serves as the basis for use and further development, and that can be changed only by using an approved change control process (NQA-1, 2009). - Validation: Confirmation, through the provision of objective evidence (e.g., acceptance test), that the requirements for a specific intended use or application have been fulfilled (24765:2010(E), 2010). - Verification: (1) The process of: evaluating a system or component to determine whether the products of a given development phase satisfy the conditions imposed at the start of that phase. (2) Formal proof of program correctness (e.g., requirements, design, implementation reviews, system tests) (24765:2010(E), 2010).

Acronyms

Acronym	Description
API	Application Programming Interface
DOE-NE	Department of Energy, Nuclear Energy
FE	finite element
FEM	Finite Element Method
GUI	graphical user interface
HIT	Hierarchical Input Text
HPC	High Performance Computing
I/O	Input/Output
INL	Idaho National Laboratory
MOOSE	Multiphysics Object Oriented Simulation Environment
MPI	Message Passing Interface
PDEs	partial differential equations
SDD	Software Design Description

Design Stakeholders and Concerns

Design Stakeholders

Stakeholders for MOOSE include several of the funding sources including Department of Energy, Nuclear Energy (DOE-NE) and the INL. However, Since MOOSE is an open-source project, several universities, companies, and foreign governments have an interest in the development and maintenance of the MOOSE project.

Stakeholder Design Concerns

Concerns from many of the stakeholders are similar. These concerns include correctness, stability, and performance. The mitigation plan for each of these can be addressed. For correctness, MOOSE development requires either regression or unit testing for all new code added to the repository. The project contains several comparisons against analytical solutions where possible and also other verification methods such as MMS. For stability, MOOSE maintains multiple branches to incorporate several layers of testing both internally and for dependent applications. Finally, performance tests are also performed as part of the the normal testing suite to monitor code change impacts to performance.

System Design

The MOOSE framework itself is composed of a wide range of pluggable systems. Each system is generally composed of a single or small set of C++ objects intended to be specialized by a Developer to solve a specific problem. To accomplish this design goal, MOOSE uses several modern object-oriented design patterns. The primary overarching pattern is the "Factory Pattern". Users needing to extend MOOSE may inherit from one of MOOSE's systems to providing an implementation meeting his or her needs. The design of each of these systems is documented on the mooseframework.org wiki in the Tutorial section. Additionally, up-to-date documentation extracted from the source is maintained on the the mooseframework.org documentation site after every successful merge to MOOSE's stable branch. After these objects are created, the can be registered with the framework and used immediately in a MOOSE input file.

System Structure

The MOOSE framework architecture consists of a core and several pluggable systems. The core of MOOSE consists of a number of key objects responsible for setting up and managing the user-defined objects of a finite element simulation. This core set of objects has limited extendability and exist for every simulation configuration that the framework is capable of running.

Adaptivity

Adaptivity/Indicators

Adaptivity/Markers

AuxKernels

AuxKernels/MatVecRealGradAuxKernel

AuxKernels/MaterialVectorAuxKernel

AuxKernels/MaterialVectorGradAuxKernel

AuxScalarKernels

AuxVariables

AuxVariables/MultiAuxVariables

BCs

BCs/CavityPressure

BCs/CoupledPressure

BCs/InclinedNoDisplacementBC

BCs/Periodic

BCs/Pressure

Bounds

Closures

Components

Constraints

Contact

ControlLogic

Controls

CoupledHeatTransfers

Covariance

DGKernels

Dampers

Debug

Debug/MaterialDerivativeTest

DeprecatedBlock

DiracKernels

Distributions

DomainIntegral

Executioner

Executioner/Adaptivity

Executioner/Predictor

Executioner/Quadrature

Executioner/TimeIntegrator

Executioner/TimeStepper

Executors

FVBCs

FVInterfaceKernels

FVKernels

FluidPropertiesInterrogator

Functions

GeochemicalModelInterrogator

GlobalParams

GrayDiffuseRadiation

HeatStructureMaterials

ICs

ICs/PolycrystalICs

ICs/PolycrystalICs/BicrystalBoundingBoxIC

ICs/PolycrystalICs/BicrystalCircleGrainIC

ICs/PolycrystalICs/PolycrystalColoringIC

ICs/PolycrystalICs/PolycrystalRandomIC

ICs/PolycrystalICs/PolycrystalVoronoiVoidIC

ICs/PolycrystalICs/Tricrystal2CircleGrainsIC

InterfaceKernels

Kernels

Kernels/CHPFCRFFSplitKernel

Kernels/DynamicTensorMechanics

Kernels/HHPFCRFFSplitKernel

Kernels/PFCRFFKernel

Kernels/PolycrystalElasticDrivingForce

Kernels/PolycrystalKernel

Kernels/PolycrystalStoredEnergy

Kernels/PoroMechanics

Kernels/RigidBodyMultiKernel

Kernels/TensorMechanics

Materials

Mesh

Mesh/Partitioner

Modules

Modules/CompressibleNavierStokes

Modules/FluidProperties

Modules/HeatConduction

Modules/HeatConduction/ThermalContact

Modules/HeatConduction/ThermalContact/BC

Modules/IncompressibleNavierStokes

Modules/NavierStokesFV

Modules/Peridynamics

Modules/Peridynamics/Mechanics

Modules/Peridynamics/Mechanics/GeneralizedPlaneStrain

Modules/Peridynamics/Mechanics/Master

Modules/PhaseField

Modules/PhaseField/Conserved

Modules/PhaseField/DisplacementGradients

Modules/PhaseField/EulerAngles2RGB

Modules/PhaseField/GrainGrowth

Modules/PhaseField/GrandPotential

Modules/PhaseField/Nonconserved

Modules/PorousFlow

Modules/PorousFlow/BCs

Modules/TensorMechanics

Modules/TensorMechanics/CohesiveZoneMaster

Modules/TensorMechanics/DynamicMaster

Modules/TensorMechanics/GeneralizedPlaneStrain

Modules/TensorMechanics/GlobalStrain

Modules/TensorMechanics/LineElementMaster

Modules/TensorMechanics/Master

Modules/TensorMechanics/MaterialVectorBodyForce

MortarGapHeatTransfer

MultiApps

NodalKernels

NodalNormals

Outputs

PorousFlowBasicTHM

PorousFlowFullySaturated

PorousFlowUnsaturated

Postprocessors

Preconditioning

Problem

RayBCs

RayKernels

ReactionNetwork

ReactionNetwork/AqueousEquilibriumReactions

ReactionNetwork/SolidKineticReactions

Reporters

Samplers

ScalarKernels

SpatialReactionSolver

StochasticTools

Surrogates

ThermalContact

TimeDependentReactionSolver

TimeIndependentReactionSolver

Trainers

Transfers

UserObjects

Variables

Variables/CHPFCRFFSplitVariables

Variables/HHPFCRFFSplitVariables

Variables/PFCRFFVariables

Variables/PolycrystalVariables

VectorPostprocessors

XFEM

The MooseApp is the top-level object used to hold all of the other objects in a simulation. In a normal simulation a single MooseApp object is created and "run()". This object uses it's Factory objects to build user defined objects which are stored in a series of Warehouse objects and executed. The Finite Element data is stored in the Systems and Assembly object while the domain information (the Mesh) is stored in the Mesh object. A series of threaded loops are used to run parallel calculations on the objects created and stored within the warehouses.

MOOSE's pluggable systems are documented on the mooseframework.org wiki. Each of these systems has set of defined polymorphic interfaces and are designed to accomplish a specific task within the simulation. The design of these systems is fluid and is managed through agile methods and ticket request system on the Github.org website.

Data Design and Control

At a high level, the system is designed to process HIT input files to construct several objects that will constitute an FE simulation. Some of the objects in the simulation may in turn load other file-based resources to complete the simulation. Examples include meshes or data files. The system will then assemble systems of equations and solve them using the libraries of the Code Platform. The system can then output the solution in one or more supported output formats commonly used for visualization.

Human-Machine Interface Design

MOOSE is a command-line driven program. All interaction with MOOSE and MOOSE-based codes is ultimately done through the command line. This is typical for HPC applications that use the MPI interface for running on super computing clusters. Optional GUIs may be used to assist in creating input files and launching executables on the command line.

System Design Interface

All external system interaction is performed either through file Input/Output (I/O) or through local Application Programming Interface (API) calls. Neither the framework, nor the modules are designed to interact with any external system directly through remote procedure calls. Any code to code coupling performed using the framework are done directly through API calls either in a static binary or after loading shared libraries.

Security Structure

The framework does not require any elevated privileges to operate and does not run any stateful services, daemons or other network programs. Distributed runs rely on the MPI library.

Requirements Cross-Reference

ray_tracing: AddRayBCAction
13.1.1
The system shall throw an error when adding a RayBC and the provided RayTracingStudy
1. could not be found
2. or is not a RayTracingStudy.
Specification(s): provided/missing, provided/not_a_study
Design: AddRayBCAction
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57
13.1.2
The system shall throw an error when adding a RayBC and RayTracingStudy was not provided
1. and multiple studies were found
2. or when no studies were found.
Specification(s): not_provided/multiple, not_provided/missing
Design: AddRayBCAction
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57

ray_tracing: AddRayKernelAction
13.1.3
The system shall throw an error when adding a RayKernel and the provided RayTracingStudy
1. could not be found
2. or is not a RayTracingStudy.
Specification(s): provided/missing, provided/not_a_study
Design: AddRayKernelAction
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57
13.1.4
The system shall throw an error when adding a RayKernel and RayTracingStudy was not provided
1. and multiple studies were found
2. or when no studies were found.
Specification(s): not_provided/multiple, not_provided/missing
Design: AddRayKernelAction
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57

ray_tracing: RayTracingStudy
13.2.1
A RayTracingObject shall return a useful error when
1. the study is provided via param and is of the wrong type
2. the study is provided by default and is of the wrong type
Specification(s): errors/get_study_bad_param, errors/get_study_bad_default
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57
13.5.4The system shall support the output of the total number of rays started, the total distance traveled by rays, and the number of processor crossings the rays have encountered.
Specification(s): test
Design: RayTracingStudyResult RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.8.1The system shall support the console output of information pertaining to a Ray.
Specification(s): get_info
Design: RayTracingStudy Ray
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): RunApp
60
13.8.2The system shall provide a method for determining the equality of rays
Specification(s): equality
Design: RayTracingStudy Ray
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): RunApp
57
13.8.3
The system shall report a reasonable error from a ray when
1. checking if a ray is at its end point without an end point being set
2. retrieving a ray's end point when its end point has not been set
3. setting a ray's start point that has already been set
4. setting a ray's starting direction multiple times without clearing it
5. setting a ray's start point that is not contained within the mesh bounding box
6. setting a ray's starting incoming side without setting its starting element
7. setting a ray's starting incoming side to an invalid side
8. setting a ray's starting incoming side to one that does not contain the starting point
9. setting a ray's starting point to a point that is not contained within a given starting element
10. setting a ray's starting direction before setting its starting information,
11. setting a ray's starting direction to the zero vector
12. setting a ray's end point before setting its start point
13. setting a ray's end point to the same as its start point
14. setting a ray's end point and starting direction
15. setting a ray's max distance after setting its end point
16. setting a ray's end point after setting its max distance
17. setting a ray's end point to a point that is not within the mesh bounding box
18. setting a ray's starting maximum distance before setting its start information
19. setting a ray's starting maximum distance to a negative value
20. setting the starting element for a ray to an inactive element
Specification(s): errors/at_end_without_set, errors/end_point_without_set, errors/set_start_again, errors/set_direction_again, errors/set_start_fail_bbox, errors/set_side_without_elem, errors/set_invalid_side, errors/set_bad_side, errors/set_bad_start, errors/set_direction_before_start, errors/set_zero_direction, errors/set_end_before_start, errors/set_end_equal_start, errors/set_end_with_direction, errors/set_distance_with_end, errors/set_end_with_distance, errors/set_end_fail_bbox, errors/set_distance_before_start, errors/set_distance_negative, errors/set_start_inactive
Design: RayTracingStudy Ray
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57
13.9.1
The system shall be able to trace rays in a mesh that utilizes adaptiviy with the element types
1. QUAD4,
2. TRI3,
3. HEX8,
4. and EDGE2.
Specification(s): elem_tests/quad4, elem_tests/tri3, elem_tests/hex8, elem_tests/edge2
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60 60 60
13.9.2
The system shall support the use of side normals to cull potential exiting sides within ray tracing for
1. two-dimensional meshes
2. and for three-dimensional meshes.
Specification(s): dim/2d, dim/3d
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60
13.9.3The system shall be able to trace rays within EDGE2 elements.
Specification(s): test
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56
13.9.4The system shall be able to trace rays within EDGE3 elements.
Specification(s): test
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56
13.9.5The system shall be able to trace rays within EDGE4 elements.
Specification(s): test
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56
13.9.6
The system shall be able to trace rays within planar HEX20 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.7
The system shall be able to trace rays within planar HEX27 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.8
The system shall be able to trace rays within planar HEX8 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.9
The system shall support the ending of traced rays on internal sidesets in
1. one-dimensional meshes,
2. two-dimensional meshes,
3. and three-dimensional meshes.
Specification(s): kill/1d, kill/2d, kill/3d
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60 60
13.9.10
The system shall support the specular reflection of traced rays on internal sidesets in
1. one-dimensional meshes,
2. two-dimensional meshes,
3. and three-dimensional meshes.
Specification(s): reflect/1d, reflect/2d, reflect/3d
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60 60
13.9.11The system shall throw an error if RayBCs are defined on internal sidesets, but the study does not have internal sideset capability enabled.
Specification(s): internal_sidesets_disabled
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.9.12The system shall throw an error if RayBCs are defined on internal sidesets and said internal sidesets are not bounded by different subdomains.
Specification(s): not_subdomain_bounded
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.9.13The system shall be able to trace rays on 3D meshes that have nonplanar faces.
Specification(s): test
Design: RayTracingStudy
Issue(s): #16028 #16170
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.9.14The system shall by default warn that tracing on non-planar faces is an approximation.
Specification(s): warning
Design: RayTracingStudy
Issue(s): #16028 #16170
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.9.15
The system shall be able to trace rays within planar PRISM15 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.16
The system shall be able to trace rays within planar PRISM18 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.17
The system shall be able to trace rays within planar PRISM6 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.18
The system shall be able to trace rays within planar PYRAMID13 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.19
The system shall be able to trace rays within planar PYRAMID14 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.20
The system shall be able to trace rays within planar PYRAMID5 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.21
The system shall be able to trace rays within planar QUAD4 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from boundary sides centroids using an angular quadrature,
5. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56
13.9.22
The system shall be able to trace rays within planar QUAD8 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from boundary sides centroids using an angular quadrature,
5. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56
13.9.23
The system shall be able to trace rays within planar QUAD9 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from boundary sides centroids using an angular quadrature,
5. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56
13.9.24
The system shall report an error when a ray hits a boundary during tracing and
1. the boundary does not have any RayBCs
2. and then the boundary does not have any RayBCs that change the trajectory of the ray or end the ray.
Specification(s): error/both, error/one
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57
13.9.25
The system shall be able to trace rays within planar TET10 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.26
The system shall be able to trace rays within planar TET4 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from the centroids of boundary edges in the direction of all other edge centroids in the same element,
5. from boundary sides centroids using an angular quadrature,
6. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/ete, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56 56
13.9.27
The system shall be able to trace rays within planar TRI3 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from boundary sides centroids using an angular quadrature,
5. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56
13.9.28
The system shall be able to trace rays within planar TRI6 elements
1. from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element,
2. from the centroids of boundary sides in the direction of all other vertices in the same boundary element,
3. from the centroids of all boundary sides to the centroids of all other boundary elements,
4. from boundary sides centroids using an angular quadrature,
5. and from boundary element centroids using an angular quadrature.
Specification(s): tests/vtv, tests/ctv, tests/ctc, tests/side_aq, tests/centroid_aq
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
56 56 56 56 56
13.9.29The system shall support not setting the incoming side at the beginning of a trace.
Specification(s): test
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.10.3
The system shall be able to create additional rays during tracing with RayBCs in
1. two-dimensional meshes
2. and in three-dimensional meshes.
Specification(s): tests/2d, tests/3d
Design: RayBCs RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60
13.10.4
The system shall be able to trace rays using a
1. last in, first out buffer
2. and with a circular buffer.
Specification(s): tests/lifo, tests/circular
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60
13.10.5
The RayTracingStudy shall return a useful error when
1. the same ray is added to be traced multiple times,
2. when local rays that have the same ID are added to be traced,
3. when rays that have the same ID on different processors are added to be traced,
4. when the domain is not covered with ray kernels,
5. when ray names are provided to a ray tracing object and the study does not register ray names,
6. when a ray name is provided to a ray tracing object and said name is not registered to a ray,
7. when the study is set to execute with residual kernels and non-residual kernels,
8. when the study is set to execute with residual kernels and an eigenvalue executioner,
9. when the trajectory of a ray is changed after it has started tracing,
10. when a ray's counters are reset when not generating rays
11. when tracing in a mesh with adaptivity and an unsupported element type
12. when tracing in a mesh when the average subdomain hmax is a poor approximation due to stretched elements
13. when ray data is registered too late
14. when ray data is registered with the same name across systems
15. when requesting a ray data index for an invalid name
16. when requesting a ray data name for an invalid index
17. when requesting ray kernels before they are setup
18. when requesting ray bcs before they are setup
19. when obtaining the ray bank when banking is disabled
20. when obtaining the ray bank when it is not available
21. when registering a ray when ray registration is disabled
22. when getting a registered ray ID when ray registration is disabled
23. when getting a registered ray name when ray registration is disabled
24. when requesting a registered ray ID for a ray that is not registered
25. when requesting a registered ray name for a ray that is not registered
26. when reserving space in the ray buffer outside of registration, and
27. when requesting a subdomain hmax for an invalid subdomain
28. building an element extrema edge for invalid vertices
29. requesting cached element normals when element normal caching has not been setup
30. getting the index of ray data when aux data with the same name exists
31. getting the index of ray aux data when data with the same name exists
32. registering a ray more than once with the same name
Specification(s): tests/duplicate_ray, tests/local_non_unique_id, tests/global_non_unique_id, tests/ray_kernel_coverage_check, tests/unneeded_rays, tests/ray_not_found, tests/mixed_pre_kernel_execute, tests/eigenvalue, tests/error_if_tracing, tests/reset_counters, tests/adapt_bad_type, tests/hmax_vary, tests/register_ray_data_late, tests/register_ray_data_same_name, tests/ray_data_index_bad_name, tests/ray_data_name_bad_index, tests/get_ray_kernels_early, tests/get_ray_bcs_early, tests/get_bank_disabled, tests/get_bank_bad, tests/register_ray_no_registration, tests/registered_ray_id_no_registration, tests/registered_ray_name_no_registration, tests/registered_ray_id_missing, tests/registered_ray_name_missing, tests/reserve_bad, tests/subdomain_hmax_missing, tests/elem_extrema_build_edge, tests/get_elem_normals_unimplemented, tests/ray_data_index_other_exists, tests/ray_data_aux_index_other_exists, tests/register_ray_again
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 5757 30 57 57 57 57 57 57 57
13.10.6The system shall be able to change the trajectory of rays during tracing within RayKernels.
Specification(s): test
Design: RayKernels RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.10.7
The system shall be able to create additional rays during tracing within RayKernels in
1. two-dimensional meshes
2. and in three-dimensional meshes.
Specification(s): tests/2d, tests/3d
Design: RayBCs RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60
13.10.8
The system shall support the tracing of rays using
1. an asynchronous method,
2. a bulk-synchronous method,
3. and the harm method.
Specification(s): tests/smart, tests/bs, tests/harm
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60 60
13.10.9The system shall support the tracing of rays across multiple subdomains.
Specification(s): test
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60
13.10.10
The system shall support the storage and manipulation of data and auxiliary data on a ray when
1. sizing the Ray data on acquire
2. and when not sizing the Ray data on acquire.
Specification(s): test/sized, test/unsized
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60
13.10.11The system shall support the re-use of traced rays.
Specification(s): test
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.10.12The system shall support the failure of a trace gracefully via a warning.
Specification(s): no_bc
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.10.13The system shall support ending rays by a user-set maximum distance.
Specification(s): max_distance
Design: RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60

ray_tracing: IntegralRayKernelBase
13.3.1
The system shall support line integrals in the
1. rz coordinate system
2. and in the rspherical coordinate system.
Specification(s): line_integral/rz, line_integral/rspherical
Design: IntegralRayKernelBase
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60

ray_tracing: RayTracingMeshOutput
13.4.1
The system shall support the mesh output of traced rays on meshes of element types
1. QUAD4,
2. TRI3,
3. HEX8, and
4. TET4.
Specification(s): elem_type/quad4, elem_type/tri3, elem_type/hex8, elem_type/tet4
Design: RayTracingMeshOutput
Issue(s): #16028 #16320
Collection(s): FUNCTIONAL
Type(s): Exodiff
60 60 60 60
13.4.2The system shall support the mesh output of traced rays using the Nemesis format.
Specification(s): nemesis
Design: RayTracingNemesis RayTracingMeshOutput
Issue(s): #16028 #16320
Collection(s): FUNCTIONAL
Type(s): Exodiff
57
13.4.3
The system shall support the mesh output of traced rays using the fewest segments possible to represent the trace in
1. Exodus format and
2. in Nemesis format.
Specification(s): no_segments/exodus, no_segments/nemesis
Design: RayTracingMeshOutput
Issue(s): #16028 #16320
Collection(s): FUNCTIONAL
Type(s): Exodiff
57 57
13.4.4
The sytem shall support the output of ray data when outputting rays in a mesh format using
1. exodus and
2. nemesis formats.
Specification(s): data/exodus, data/nemesis
Design: RayTracingMeshOutput
Issue(s): #16028 #16320
Collection(s): FUNCTIONAL
Type(s): Exodiff
57 60
13.4.5
The system shall report an error when ouputting rays in a mesh format when
1. ray data is requested to be output but it is not cached,
2. aux data is requested to be output but it is not cached,
3. both nodal and non-nodal data is requested to be output,
4. and when nodal data is requested to be output but segment-wise information is not cached.
Specification(s): errors/no_cached_data, errors/no_cached_aux_data, errors/data_nodal_and_non_nodal, errors/nodal_no_segments
Design: RayTracingMeshOutput
Issue(s): #16028 #16320
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57
13.4.6The system shall report a warning when rays are requested to be output in a mesh format but cached ray inforamtion is not found.
Specification(s): no_segments_warning
Design: RayTracingMeshOutput
Issue(s): #16028 #16320
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.7.20The system shall provide the ability to output the segment wise accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.
Specification(s): simple_diffusion_rays
Design: VariableIntegralRayKernel RayTracingMeshOutput
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60
13.7.21The system shall provide the ability to output the segment wise, linearly approximated, accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.
Specification(s): simple_diffusion_rays_nodal
Design: VariableIntegralRayKernel RayTracingMeshOutput
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60

ray_tracing: RayTracingNemesis
13.4.2The system shall support the mesh output of traced rays using the Nemesis format.
Specification(s): nemesis
Design: RayTracingNemesis RayTracingMeshOutput
Issue(s): #16028 #16320
Collection(s): FUNCTIONAL
Type(s): Exodiff
57

ray_tracing: RayDataValue
13.5.1The system shall support the ability to output the data stored on a ray.
Specification(s): test
Design: RayDataValue
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.5.2
The system shall report an error when ouputting a single data value stored on a ray when
1. the RayTracingStudy does not support accessing rays by name,
2. the RayTracingStudy does not support the banking of rays on completion,
3. the named ray was not found,
4. the named ray data was not found,
5. the named ray aux data was not found,
6. the ray with the given id was not found,
7. neither an ID or name was provided, and
8. both an ID and name was provided.
Specification(s): errors/no_registration, errors/no_banking, errors/ray_name_not_found, errors/data_name_not_found, errors/aux_data_name_not_found, errors/id_not_found, errors/neither_provided, errors/both_provided
Design: RayDataValue
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57 57 57

ray_tracing: RayIntegralValue
13.5.3
The system shall report an error when sampling the integrated value by a ray and
1. the provided IntegralRayKernel is not an IntegralRayKernel,
2. the provided IntegralRayKernel was not found,
3. a Ray with the given name was not found,
4. the provided study does not support Ray registration,
5. or the provided study does not support Ray banking.
Specification(s): errors/not_integral_ray_kernel, errors/kernel_not_found, errors/ray_not_found, errors/no_registration, errors/no_banking
Design: RayIntegralValue
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57

ray_tracing: RayTracingStudyResult
13.5.4The system shall support the output of the total number of rays started, the total distance traveled by rays, and the number of processor crossings the rays have encountered.
Specification(s): test
Design: RayTracingStudyResult RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60

ray_tracing: RayBCs
13.6.1The system shall support the dependency resolution of RayBCs.
Specification(s): test
Design: RayBCs
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.6.2The system shall throw a reasonable error when adding a dependency for a RayBC that does not exist.
Specification(s): missing
Design: RayBCs
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.6.3
The system shall report an error when changing a ray direction within a RayBC when
1. the ray was set to not continue by another RayBC,
2. the ray already had its direction changed,
3. the end point of the ray was set upon generation,
4. and when the direction is changed to the zero vector.
Specification(s): change_direction/should_not_continue, change_direction/again, change_direction/end_set, change_direction/zero
Design: RayBCs
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57
13.6.4The system shall support the specular reflection of rays on a boundary.
Specification(s): test
Design: ReflectRayBC RayBCs
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.6.5The system shall report a reasonable warning when using an approximation to reflect a ray on a side that is not planar.
Specification(s): non_planar_warning
Design: ReflectRayBC RayBCs
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.10.3
The system shall be able to create additional rays during tracing with RayBCs in
1. two-dimensional meshes
2. and in three-dimensional meshes.
Specification(s): tests/2d, tests/3d
Design: RayBCs RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60
13.10.7
The system shall be able to create additional rays during tracing within RayKernels in
1. two-dimensional meshes
2. and in three-dimensional meshes.
Specification(s): tests/2d, tests/3d
Design: RayBCs RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60

ray_tracing: ReflectRayBC
13.6.4The system shall support the specular reflection of rays on a boundary.
Specification(s): test
Design: ReflectRayBC RayBCs
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.6.5The system shall report a reasonable warning when using an approximation to reflect a ray on a side that is not planar.
Specification(s): non_planar_warning
Design: ReflectRayBC RayBCs
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57

ray_tracing: ADRayKernel
13.7.1
The system shall throw a reasonable error if an ADRayKernel
1. is used with a coordinate system other than xyz or
2. is used in an explicit manner.
Specification(s): errors/xyz_only, errors/implicit_only
Design: ADRayKernel
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57

ray_tracing: AuxRayKernel
13.7.2The system shall throw a reasonable error if a non-supported auxiliary variable is used with a ray aux kernel.
Specification(s): const_monomial_only
Design: AuxRayKernel
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57

ray_tracing: RayKernels
13.7.3The system shall support the coupling of variables on rays that contribute to the residual and Jacobian.
Specification(s): test
Design: RayKernels
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60
13.7.4The system shall be able to produce the exact Jacobian with coupled variables on rays.
Specification(s): test_jac
Design: RayKernels
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): PetscJacobianTester
30
13.7.5The system shall support the coupling of variables using automatic differentiation on rays that contribute to the residual and Jacobian.
Specification(s): test_ad
Design: RayKernels
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60
13.7.6The system shall be able to produce the exact Jacobian using automatic differentiation on rays.
Specification(s): test_ad_jac
Design: RayKernels
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): PetscJacobianTester
30
13.7.7The system shall support the dependency resolution of RayKernels.
Specification(s): test
Design: RayKernels
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.7.8The system shall throw a reasonable error when adding a dependency for a RayKernel that does not exist.
Specification(s): missing
Design: RayKernels
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.7.9
The system shall report an error when changing a ray start and/or direction within a RayKernel when
1. the ray was set to not continue by another RayKernel,
2. the ray was set to not continue by another RayKernel and it is at its end point,
3. the ray's trajectory was already changed,
4. the ray's end point has been set,
5. the ray's start point is not within the current element, and
6. when the ray's new direction is set to the zero vector.
Specification(s): change_direction/should_not_continue, change_direction/should_not_continue_at_end, change_direction/changed_again, change_direction/end_set, change_direction/out_of_elem, change_direction/zero_direction
Design: RayKernels
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57
13.10.6The system shall be able to change the trajectory of rays during tracing within RayKernels.
Specification(s): test
Design: RayKernels RayTracingStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60

ray_tracing: FunctionIntegralRayKernel
13.7.10The system shall provide the ability to compute the integral of a Function along a line.
Specification(s): test
Design: FunctionIntegralRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.7.11The system shall provide the ability to compute the average value of a Function along a line.
Specification(s): average
Design: FunctionIntegralRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60

ray_tracing: LineSourceRayKernel
13.7.12The system shall provide an ability to produce a source term along a line.
Specification(s): test
Design: LineSourceRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60
13.7.13
The system shall provide an ability to solve a 2D diffusion problem with a line source term, with
1. finite elements
2. and finite volumes.
Specification(s): simple_diffusion/fe, simple_diffusion/fv
Design: LineSourceRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60 60

ray_tracing: MaterialIntegralRayKernel
13.7.14The system shall provide the ability to compute the integral of a material property along a line.
Specification(s): test
Design: MaterialIntegralRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.7.15The system shall provide the ability to compute the average value of a material property along a line.
Specification(s): average
Design: MaterialIntegralRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60

ray_tracing: RayDistanceAux
13.7.16The system shall be able to store the distance traversed by a ray in each element in an auxiliary field.
Specification(s): test
Design: RayDistanceAux
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60

ray_tracing: RayKernel
13.7.17
The system shall throw a reasonable error if a RayKernel
1. is utilized with a coordinate system other than xyz or
2. if the execute flag for the associated ray study is not set correctly to use the RayKernel.
Specification(s): errors/xyz_only, errors/bad_execute_on
Design: RayKernel
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57

ray_tracing: VariableIntegralRayKernel
13.7.18The system shall provide the ability to compute the integral of a variable along a line.
Specification(s): test
Design: VariableIntegralRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.7.19The system shall provide the ability to compute the average value of a variable along a line.
Specification(s): average
Design: VariableIntegralRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60
13.7.20The system shall provide the ability to output the segment wise accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.
Specification(s): simple_diffusion_rays
Design: VariableIntegralRayKernel RayTracingMeshOutput
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60
13.7.21The system shall provide the ability to output the segment wise, linearly approximated, accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.
Specification(s): simple_diffusion_rays_nodal
Design: VariableIntegralRayKernel RayTracingMeshOutput
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60
13.7.22
The system shall provide the ability to compute the line integral of a variable for a 2D diffusion problem, with
1. finite elements
2. and finite volumes.
Specification(s): simple_diffusion/fe, simple_diffusion/fv
Design: VariableIntegralRayKernel
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): CSVDiff
60 60

ray_tracing: Ray
13.8.1The system shall support the console output of information pertaining to a Ray.
Specification(s): get_info
Design: RayTracingStudy Ray
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): RunApp
60
13.8.2The system shall provide a method for determining the equality of rays
Specification(s): equality
Design: RayTracingStudy Ray
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): RunApp
57
13.8.3
The system shall report a reasonable error from a ray when
1. checking if a ray is at its end point without an end point being set
2. retrieving a ray's end point when its end point has not been set
3. setting a ray's start point that has already been set
4. setting a ray's starting direction multiple times without clearing it
5. setting a ray's start point that is not contained within the mesh bounding box
6. setting a ray's starting incoming side without setting its starting element
7. setting a ray's starting incoming side to an invalid side
8. setting a ray's starting incoming side to one that does not contain the starting point
9. setting a ray's starting point to a point that is not contained within a given starting element
10. setting a ray's starting direction before setting its starting information,
11. setting a ray's starting direction to the zero vector
12. setting a ray's end point before setting its start point
13. setting a ray's end point to the same as its start point
14. setting a ray's end point and starting direction
15. setting a ray's max distance after setting its end point
16. setting a ray's end point after setting its max distance
17. setting a ray's end point to a point that is not within the mesh bounding box
18. setting a ray's starting maximum distance before setting its start information
19. setting a ray's starting maximum distance to a negative value
20. setting the starting element for a ray to an inactive element
Specification(s): errors/at_end_without_set, errors/end_point_without_set, errors/set_start_again, errors/set_direction_again, errors/set_start_fail_bbox, errors/set_side_without_elem, errors/set_invalid_side, errors/set_bad_side, errors/set_bad_start, errors/set_direction_before_start, errors/set_zero_direction, errors/set_end_before_start, errors/set_end_equal_start, errors/set_end_with_direction, errors/set_distance_with_end, errors/set_end_with_distance, errors/set_end_fail_bbox, errors/set_distance_before_start, errors/set_distance_negative, errors/set_start_inactive
Design: RayTracingStudy Ray
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57 57

ray_tracing: ConeRayStudy
13.10.1
The system shall be able to generate rays emitting from a point in a cone using angular quadrature in
1. two-dimensional meshes
2. and in three-dimensional meshes.
Specification(s): tests/2d, tests/3d
Design: ConeRayStudy
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): Exodiff
60 60
13.10.2
The ConeRayStudy shall report a useful error when
1. the provided directions are inconsistent in size
2. the provided scaling factors are inconsistent in size
3. the provided half cone angles are inconsistent in size
4. the provided half cone angles are not valid angles
5. the provided polar quadrature orders are inconsistent in size
6. the provided azimuthal quadrature orders are inconsistent in size
7. it is run with an invalid mesh dimension
Specification(s): errors/direction_size, errors/scaling_factors_size, errors/half_cone_angles_size, errors/half_cone_angles_valid, errors/polar_quad_orders_size, errors/azimuthal_quad_orders_size, errors/1d
Design: ConeRayStudy
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57 57

ray_tracing: RepeatableRayStudy
13.10.14
The system shall report an error when utilizing the repeatable ray study when
1. both directions and points are provided,
2. neither directions and points are provided,
3. the number of start points provided is inconsistent,
4. the number of directions provided is inconsistent,
5. both end points and maximum distances are provided,
6. the number of maximum distances provided is inconsistent,
7. the provided maximum distance is non-positive,
8. the number of end points provided is inconsistent,
9. the initial data size is inconsistent with the number of rays,
10. the initial data size is inconsistent with the provided data names,
11. initial data is provided but data names are not provided,
12. the initial aux data size is inconsistent with the number of rays,
13. the initial aux data size is inconsistent with the provided aux data names,
14. and aux initial data is provided but aux data names are not provided.
Specification(s): errors/directions_or_end_points, errors/neither_directions_or_end_points, errors/start_size, errors/directions_size, errors/max_distance_with_end, errors/max_distance_size, errors/max_distance_positive, errors/end_points_size, errors/initial_data_size, errors/initial_data_individual_size, errors/data_names_not_set, errors/initial_aux_data_size, errors/initial_aux_data_individual_size, errors/aux_data_names_not_set
Design: RepeatableRayStudy
Issue(s): #17030
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57 57 57 57 57 57 57 57 57

ray_tracing: RepeatableRayStudyBase
13.10.15
The RepeatableRayStudyBase shall support the
1. outputting of checkpoint files and
2. shall be capable of restarting from the output data.
Specification(s): test/checkpoint, test/recover
Design: RepeatableRayStudyBase
Issue(s): #16028 #16848
Collection(s): FUNCTIONAL
Type(s): CSVDiffRunApp
57 57
13.10.16The RepeatableRayStudyBase shall report a useful warning when rays are to be replicated but claiming is disabled.
Specification(s): replicated_no_claim
Design: RepeatableRayStudyBase
Issue(s): #16028 #16848
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.10.17The RepeatableRayStudyBase shall return a useful error when a ray is added with a non-unique ID.
Specification(s): non_unique_id_error
Design: RepeatableRayStudyBase
Issue(s): #16028 #16848
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57
13.10.18
The RepeatableRayStudyBase shall return a useful error with replicated ray functionality when
1. additional rays are created in a non-replicated manner on a subset of processors,
2. a ray exists with a non-replicated ID on a processor,
3. a non-replicated ray exists on a processor,
4. and a ray is created with starting element information when it should not.
Specification(s): replicated_errors/additional, replicated_errors/non_replicated_id, replicated_errors/non_replicated, replicated_errors/starting_elem_set
Design: RepeatableRayStudyBase
Issue(s): #16028 #16848
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57
13.10.19
The RepeatableRayStudyBase shall return a useful error after defining rays when
1. no rays were defined or
2. a null ray was defined.
Specification(s): define_errors/no_rays, define_errors/null_ray
Design: RepeatableRayStudyBase
Issue(s): #16028 #16848
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57

ray_tracing: RayTracingAngularQuadrature
13.11.1
The system shall provide a reasonable error when using angular quadrature for ray tracing and
1. the provided polar order is non-positive
2. the provided azimuthal order is non-positive
3. the minimum polar cosine is greater than the maximum polar cosine
4. the minimum polar cosine is less than negative one
5. the maximum polar cosine is greater than one
6. the dimension is less than two
7. the Gauss-Legendre order is non-positive
8. an invalid direction index is requested
9. an orthonormal vector is requested from a vector that has a zero norm
Specification(s): errors/non_positive_polar_order, errors/non_positive_azimuthal_order, errors/mu_min_larger, errors/mu_min_too_small, errors/mu_max_too_big, errors/dim1, errors/non_positive_gauss_legendre_order, errors/check_direction, errors/orthonormal_vector_zero
Design: RayTracingAngularQuadrature
Issue(s): #16028
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
57 57 57 57 57 57 57 57 57

ray_tracing: PerProcessorRayTracingResultsVectorPostprocessor
13.12.1The system shall support the output of information pretaining to the tracing of rays on a per-processor basis.
Specification(s): test
Design: PerProcessorRayTracingResultsVectorPostprocessor
Issue(s): #16028
Collection(s): FUNCTIONAL
Type(s): RunApp
60


[missing]
  type = RunException
  input = 'add_raybc_action.i'
  cli_args = 'RayBCs/active=missing_study_by_name'
  expect_err = "NullRayBC 'missing_study_by_name': Could not find the requested study 'dummy'."
  allow_test_objects = true

  detail = 'could not be found '
[]


[not_a_study]
  type = RunException
  input = 'add_raybc_action.i'
  cli_args = 'RayBCs/active=not_a_study UserObjects/active=not_a_study'
  expect_err = "NullRayBC 'not_a_study' requested the study not_a_study but the provided study is not a RayTracingStudy-derived object."
  allow_test_objects = true

  detail = 'or is not a RayTracingStudy.'
[]


[multiple]
  type = RunException
  input = 'add_raybc_action.i'
  cli_args = 'RayBCs/active=multiple_studies "UserObjects/active=\'study another_study\'"'
  expect_err = "While constructing the NullRayBC 'multiple_studies', multiple RayTracingStudy objects were found."
  allow_test_objects = true

  detail = 'and multiple studies were found '
[]


[missing]
  type = RunException
  input = 'add_raybc_action.i'
  cli_args = 'RayBCs/active=missing_study'
  expect_err = "NullRayBC 'missing_study' did not provide a RayTracingStudy to associate with via the 'study' parameter and a study was not found."
  allow_test_objects = true

  detail = 'or when no studies were found.'
[]


[missing]
  type = RunException
  input = 'add_raykernel_action.i'
  cli_args = 'RayKernels/active=missing_study_by_name'
  expect_err = "NullRayKernel 'missing_study_by_name': Could not find the requested study 'dummy'."
  allow_test_objects = true

  detail = 'could not be found '
[]


[not_a_study]
  type = RunException
  input = 'add_raykernel_action.i'
  cli_args = 'RayKernels/active=not_a_study UserObjects/active=not_a_study'
  expect_err = "NullRayKernel 'not_a_study' requested the study not_a_study but the provided study is not a RayTracingStudy-derived object."
  allow_test_objects = true

  detail = 'or is not a RayTracingStudy.'
[]


[multiple]
  type = RunException
  input = 'add_raykernel_action.i'
  cli_args = 'RayKernels/active=multiple_studies "UserObjects/active=\'study another_study\'"'
  expect_err = "While constructing the NullRayKernel 'multiple_studies', multiple RayTracingStudy objects were found."
  allow_test_objects = true

  detail = 'and multiple studies were found '
[]


[missing]
  type = RunException
  input = 'add_raykernel_action.i'
  cli_args = 'RayKernels/active=missing_study'
  expect_err = "NullRayKernel 'missing_study' did not provide a RayTracingStudy to associate with via the 'study' parameter and a study was not found."
  allow_test_objects = true

  detail = 'or when no studies were found.'
[]


[get_study_bad_param]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'RayKernels/test/get_study_bad=true RayKernels/test/study=study'
  allow_test_objects = true
  expect_err = '\(RayKernels/test/study\):.*Supplied study of type RayTracingStudyTest is not the required study type RepeatableRayStudy'
  detail = 'the study is provided via param and is of the wrong type'
[]


[get_study_bad_default]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'RayKernels/test/get_study_bad=true'
  allow_test_objects = true
  expect_err = 'The following error occurred in the object "test", of type "RayTracingObjectTest"..*Supplied study of type RayTracingStudyTest is not the required study type RepeatableRayStudy'
  detail = 'the study is provided by default and is of the wrong type'
[]


[test]
  type = 'CSVDiff'
  input = 'ray_tracing_study_result.i'
  csvdiff = 'ray_tracing_study_result_out.csv'
  allow_test_objects = true

  # ignore the partitioning-specific columns
  override_columns = 'total_processor_crossings max_processor_crossings'
  override_rel_err = '1e12 1e12'
  override_abs_zero = '1e-10 1e-10'

  requirement = 'The system shall support the output of the total number of rays started, the total distance traveled by rays, and the number of processor crossings the rays have encountered.'
[]


[get_info]
  type = 'RunApp'
  input = 'ray_lots.i'
  allow_test_objects = true
  cli_args = 'UserObjects/study/get_info=true'
  requirement = 'The system shall support the console output of information pertaining to a Ray.'
[]


[equality]
  type = RunApp
  input = 'ray_lots.i'
  allow_test_objects = true
  cli_args = "UserObjects/study/equality=true
                UserObjects/other_study/type=RepeatableRayStudy
                UserObjects/other_study/start_points='0 0 0'
                UserObjects/other_study/end_points='0.1 0.1 0'
                UserObjects/other_study/names=ray
                UserObjects/other_study/ray_kernel_coverage_check=false"
  requirement = 'The system shall provide a method for determining the equality of rays'
  expect_out = 'Ray equality test passed 22440 checks'
[]


[at_end_without_set]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/at_end_without_set=true'
  expect_err = 'Cannot use Ray::atEnd\(\) for a Ray that does not have an end set'
  allow_test_objects = true
  detail = 'checking if a ray is at its end point without an end point being set'
[]


[end_point_without_set]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/end_point_without_set=true'
  expect_err = 'Cannot use Ray::endPoint\(\) for a Ray that does not have an end set'
  allow_test_objects = true
  detail = 'retrieving a ray\'s end point when its end point has not been set'
[]


[set_start_again]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_start_again=true'
  expect_err = 'Starting point was already set via Ray::setStart\(\) and is being changed.'
  allow_test_objects = true
  detail = 'setting a ray\'s start point that has already been set'
[]


[set_direction_again]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_direction_again=true'
  expect_err = 'Cannot change a Ray\'s starting direction using Ray::setStartingDirection\(\)'
  allow_test_objects = true
  detail = 'setting a ray\'s starting direction multiple times without clearing it'
[]


[set_start_fail_bbox]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_start_fail_bbox=true'
  expect_err = 'Mesh does not contain starting point.'
  allow_test_objects = true
  detail = 'setting a ray\'s start point that is not contained within the mesh bounding box'
[]


[set_side_without_elem]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_side_without_elem=true'
  expect_err = 'Starting incoming side is set but starting element is not set.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting incoming side without setting its starting element'
[]


[set_invalid_side]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_invalid_side=true'
  expect_err = 'Starting incoming side is not valid for its starting element.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting incoming side to an invalid side'
[]


[set_bad_side]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_bad_side=true'
  expect_err = 'Starting incoming side does not contain the starting point.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting incoming side to one that does not contain the starting point'
[]


[set_bad_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_bad_start=true'
  expect_err = 'Starting element does not contain the starting point.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting point to a point that is not contained within a given starting element'
[]


[set_direction_before_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_direction_before_start=true'
  expect_err = 'Cannot use Ray::setStartingDirection\(\) before Ray::setStart\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s starting direction before setting its starting information,'
[]


[set_zero_direction]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_zero_direction=true'
  expect_err = 'Starting direction in Ray::setStartingDirection\(\) is the zero vector.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting direction to the zero vector'
[]


[set_end_before_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_before_start=true'
  expect_err = 'Cannot use Ray::setStartingEndPoint\(\) before Ray::setStart\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point before setting its start point'
[]


[set_end_equal_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_equal_start=true'
  expect_err = 'End point is equal to the start point in Ray::setStartingEndPoint\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point to the same as its start point'
[]


[set_end_with_direction]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_with_direction=true'
  expect_err = 'Cannot use Ray::setStartingEndPoint\(\) after Ray::setStartingDirection\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point and starting direction'
[]


[set_distance_with_end]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_distance_with_end=true'
  expect_err = 'Cannot use Ray::setStartingMaxDistance\(\) after Ray::setStartingEndPoint\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s max distance after setting its end point'
[]


[set_end_with_distance]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_with_distance=true'
  expect_err = 'Cannot use Ray::setStartingEndPoint\(\) after Ray::setStartingMaxDistance\(\)'
  allow_test_objects = true
  detail = 'setting a ray\'s end point after setting its max distance'
[]


[set_end_fail_bbox]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_fail_bbox=true'
  expect_err = 'End point is not within the mesh for Ray::setStartingEndPoint\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point to a point that is not within the mesh bounding box'
[]


[set_distance_before_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_distance_before_start=true'
  expect_err = 'Cannot use Ray::setStartingMaxDistance\(\) before Ray::setStart\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s starting maximum distance before setting its start information'
[]


[set_distance_negative]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_distance_negative=true'
  expect_err = 'Starting max distance is <= 0'
  allow_test_objects = true
  detail = 'setting a ray\'s starting maximum distance to a negative value'
[]


[set_start_inactive]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_start_inactive=true
                  Adaptivity/steps=1
                  Adaptivity/marker=uniform
                  Adaptivity/max_h_level=2
                  Adaptivity/initial_steps=2
                  Adaptivity/Markers/uniform/type=UniformMarker
                  Adaptivity/Markers/uniform/mark=refine'
  expect_err = 'Starting element is not active'
  allow_test_objects = true
  detail = 'setting the starting element for a ray to an inactive element'
[]


[quad4]
  type = 'CSVDiff'
  input = 'adaptivity_2d.i'
  cli_args = 'Mesh/gmg/elem_type=QUAD4 Outputs/file_base=adaptivity_quad4_out'
  csvdiff = 'adaptivity_quad4_out.csv'
  allow_test_objects = true
  detail = 'QUAD4, '
[]


[tri3]
  type = 'CSVDiff'
  input = 'adaptivity_2d.i'
  csvdiff = 'adaptivity_tri3_out.csv'
  cli_args = 'Mesh/gmg/elem_type=TRI3 Outputs/file_base=adaptivity_tri3_out'
  allow_test_objects = true
  detail = 'TRI3, '
[]


[hex8]
  type = 'CSVDiff'
  input = 'adaptivity_3d.i'
  csvdiff = 'adaptivity_hex8_out.csv'
  cli_args = 'Mesh/gmg/elem_type=HEX8 Outputs/file_base=adaptivity_hex8_out'
  allow_test_objects = true
  detail = 'HEX8, '
[]


[edge2]
  type = 'CSVDiff'
  input = 'adaptivity_1d.i'
  csvdiff = 'adaptivity_edge2_out.csv'
  cli_args = 'Mesh/gmg/elem_type=EDGE2 Outputs/file_base=adaptivity_edge2_out'
  allow_test_objects = true
  detail = 'and EDGE2.'
[]


[2d]
  type = 'CSVDiff'
  input = 'backface_culling.i'
  csvdiff = 'backface_culling_2d_out.csv'
  abs_zero = 1e-8
  cli_args = 'Mesh/gmg/dim=2
                  RayBCs/active=kill_2d
                  Outputs/file_base=backface_culling_2d_out'
  allow_test_objects = true
  detail = 'two-dimensional meshes '
[]


[3d]
  type = 'CSVDiff'
  input = 'backface_culling.i'
  csvdiff = 'backface_culling_3d_out.csv'
  abs_zero = 1e-8
  cli_args = 'Mesh/gmg/dim=3
                  RayBCs/active=kill_3d
                  Outputs/file_base=backface_culling_3d_out
                  UserObjects/study/edge_to_edge=true'
  allow_test_objects = true
  detail = 'and for three-dimensional meshes.'
[]


[test]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'Mesh/gmg/elem_type=edge2
                Mesh/gmg/dim=1
                RayBCs/active=kill_1d
                UserObjects/lots/vertex_to_vertex=true
                UserObjects/lots/centroid_to_vertex=true
                UserObjects/lots/centroid_to_centroid=true
                Outputs/file_base=lots_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'
  requirement = 'The system shall be able to trace rays within EDGE2 elements.'
[]


[test]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'Mesh/gmg/elem_type=edge3
                Mesh/gmg/dim=1
                RayBCs/active=kill_1d
                UserObjects/lots/vertex_to_vertex=true
                UserObjects/lots/centroid_to_vertex=true
                UserObjects/lots/centroid_to_centroid=true
                Outputs/file_base=lots_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'
  requirement = 'The system shall be able to trace rays within EDGE3 elements.'
[]


[test]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'Mesh/gmg/elem_type=edge4
                Mesh/gmg/dim=1
                RayBCs/active=kill_1d
                UserObjects/lots/vertex_to_vertex=true
                UserObjects/lots/centroid_to_vertex=true
                UserObjects/lots/centroid_to_centroid=true
                Outputs/file_base=lots_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'
  requirement = 'The system shall be able to trace rays within EDGE4 elements.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex20
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex20
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex20
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex20
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex20
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex20
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex27
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex27
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex27
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex27
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex27
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex27
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex8
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex8
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex8
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex8
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex8
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=hex8
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[1d]
  type = 'CSVDiff'
  input = 'internal_sidesets_1d.i'
  csvdiff = 'internal_sidesets_1d_kill_out.csv'
  cli_args = 'Outputs/file_base=internal_sidesets_1d_kill_out
                  RayBCs/active=\'kill_internal\''
  allow_test_objects = true

  detail = 'one-dimensional meshes, '
[]


[2d]
  type = 'CSVDiff'
  input = 'internal_sidesets_2d.i'
  csvdiff = 'internal_sidesets_2d_kill_out.csv'
  cli_args = 'Outputs/file_base=internal_sidesets_2d_kill_out
                  RayBCs/active=\'kill_internal\''
  allow_test_objects = true

  detail = 'two-dimensional meshes, '
[]


[3d]
  type = 'CSVDiff'
  input = 'internal_sidesets_3d.i'
  csvdiff = 'internal_sidesets_3d_kill_out.csv'
  cli_args = 'Outputs/file_base=internal_sidesets_3d_kill_out
                  RayBCs/active=\'kill_internal\''
  allow_test_objects = true

  detail = 'and three-dimensional meshes.'
[]


[1d]
  type = 'CSVDiff'
  input = 'internal_sidesets_1d.i'
  csvdiff = 'internal_sidesets_1d_reflect_out.csv'
  cli_args = 'Outputs/file_base=internal_sidesets_1d_reflect_out
                  "RayBCs/active=\'kill_external reflect_internal\'"'
  allow_test_objects = true

  detail = 'one-dimensional meshes, '
[]


[2d]
  type = 'CSVDiff'
  input = 'internal_sidesets_2d.i'
  csvdiff = 'internal_sidesets_2d_reflect_out.csv'
  cli_args = 'Outputs/file_base=internal_sidesets_2d_reflect_out
                  "RayBCs/active=\'kill_external reflect_internal\'"'
  allow_test_objects = true

  detail = 'two-dimensional meshes, '
[]


[3d]
  type = 'CSVDiff'
  input = 'internal_sidesets_3d.i'
  csvdiff = 'internal_sidesets_3d_reflect_out.csv'
  cli_args = 'Outputs/file_base=internal_sidesets_3d_reflect_out
                  "RayBCs/active=\'kill_external reflect_internal\'"'
  allow_test_objects = true

  detail = 'and three-dimensional meshes.'
[]


[internal_sidesets_disabled]
  type = RunException
  input = 'internal_sidesets_1d.i'
  cli_args = 'UserObjects/study/use_internal_sidesets=false
                RayBCs/active=\'kill_internal\''
  expect_err = 'RayBCs are defined on internal sidesets, but the study is not set to use internal sidesets during tracing.'
  allow_test_objects = true

  requirement = 'The system shall throw an error if RayBCs are defined on internal sidesets, but the study does not have internal sideset capability enabled.'
[]


[not_subdomain_bounded]
  type = RunException
  input = 'internal_sidesets_2d.i'
  cli_args = 'Mesh/change_subdomain/type=RenameBlockGenerator
                Mesh/change_subdomain/input=interior_top
                Mesh/change_subdomain/old_block=5
                Mesh/change_subdomain/new_block=1'
  expect_err = 'RayBCs exist on internal sidesets that are not bounded by a different'
  allow_test_objects = true

  requirement = 'The system shall throw an error if RayBCs are defined on internal sidesets and said internal sidesets are not bounded by different subdomains.'
[]


[test]
  type = 'CSVDiff'
  input = 'nonplanar.i'
  csvdiff = 'nonplanar_out.csv'
  allow_test_objects = true
  abs_zero = 1e-8
  requirement = 'The system shall be able to trace rays on 3D meshes that have nonplanar faces.'
[]


[warning]
  type = RunException
  input = 'nonplanar.i'
  cli_args = 'UserObjects/lots/warn_non_planar=true'
  expect_err = 'Ray tracing on non-planar faces is an approximation and may fail.'
  allow_test_objects = true
  requirement = 'The system shall by default warn that tracing on non-planar faces is an approximation.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism15
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism15
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/nz=4
                  Mesh/gmg/elem_type=prism15
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism15
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism15
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism15
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism18
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism18
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/nz=4
                  Mesh/gmg/elem_type=prism18
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism18
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism18
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism18
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism6
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism6
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/nz=4
                  Mesh/gmg/elem_type=prism6
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism6
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism6
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=prism6
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid13
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid13
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/elem_type=pyramid13
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid13
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid13
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid13
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid14
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid14
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/elem_type=pyramid14
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid14
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid14
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid14
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ntn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid5
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=ntn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctn_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid5
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctn_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/ny=4
                  Mesh/gmg/elem_type=pyramid5
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid5
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid5
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/elem_type=pyramid5
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'vtv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad4
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=vtv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad4
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad4
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad4
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad4
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'vtv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad8
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=vtv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad8
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad8
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad8
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad8
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'vtv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad9
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=vtv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad9
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad9
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad9
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad9
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[one]
  type = RunException
  input = 'raybc_check.i'
  expect_err = 'Boundaries that did not have any RayBCs\:.*1 \(right\)'
  cli_args = 'RayBCs/active=top'
  detail = 'and then the boundary does not have any RayBCs that change the trajectory of the ray or end the ray.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'vtv_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet10
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=vtv_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctv_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet10
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctv_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet10
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet10
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet10
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet10
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'vtv_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet4
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=vtv_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctv_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet4
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctv_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet4
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[ete]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ete_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet4
                  UserObjects/lots/edge_to_edge=true
                  Outputs/file_base=ete_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary edges in the direction of all other edge centroids in the same element, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet4
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/dim=3
                  Mesh/gmg/nx=3
                  Mesh/gmg/ny=3
                  Mesh/gmg/nz=3
                  Mesh/gmg/elem_type=tet4
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out
                  RayBCs/active=kill_3d'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'vtv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri3
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=vtv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri3
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri3
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri3
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri3
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[vtv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'vtv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri6
                  UserObjects/lots/vertex_to_vertex=true
                  Outputs/file_base=vtv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary vertices on boundary sides in the direction of the vertices on the other side of the same boundary element, '
[]


[ctv]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctv_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri6
                  UserObjects/lots/centroid_to_vertex=true
                  Outputs/file_base=ctv_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of boundary sides in the direction of all other vertices in the same boundary element, '
[]


[ctc]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'ctc_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri6
                  UserObjects/lots/centroid_to_centroid=true
                  Outputs/file_base=ctc_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from the centroids of all boundary sides to the centroids of all other boundary elements, '
[]


[side_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'side_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri6
                  UserObjects/lots/side_aq=true
                  Outputs/file_base=side_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'from boundary sides centroids using an angular quadrature, '
[]


[centroid_aq]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'centroid_aq_out.csv'
  cli_args = 'Mesh/gmg/elem_type=tri6
                  UserObjects/lots/centroid_aq=true
                  Outputs/file_base=centroid_aq_out'
  allow_test_objects = true
  abs_zero = 1e-8
  method = '!dbg'

  detail = 'and from boundary element centroids using an angular quadrature.'
[]


[test]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'unset_incoming_side_out.csv'
  cli_args = 'Mesh/gmg/elem_type=quad4
                UserObjects/lots/vertex_to_vertex=true
                UserObjects/lots/centroid_to_vertex=true
                UserObjects/lots/centroid_to_centroid=true
                UserObjects/lots/side_aq=true
                UserObjects/lots/set_incoming_side=false
                Outputs/file_base=unset_incoming_side_out'
  allow_test_objects = true
  abs_zero = 1e-8
  requirement = 'The system shall support not setting the incoming side at the beginning of a trace.'
[]


[2d]
  type = 'CSVDiff'
  input = 'bc_create_ray.i'
  csvdiff = 'bc_create_ray_2d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=bc_create_ray_2d_out'
  detail = 'two-dimensional meshes '
[]


[3d]
  type = 'CSVDiff'
  input = 'bc_create_ray.i'
  csvdiff = 'bc_create_ray_3d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=bc_create_ray_3d_out
                  Mesh/active=gmg_3d
                  "RayBCs/active=\'kill_3d create_3d\'"'
  detail = 'and in three-dimensional meshes.'
[]


[lifo]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'UserObjects/lots/work_buffer_type=lifo
                  Outputs/file_base=lots_out'
  allow_test_objects = true
  detail = 'last in, first out buffer '
[]


[circular]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'UserObjects/lots/work_buffer_type=circular
                  Outputs/file_base=lots_out'
  allow_test_objects = true
  detail = 'and with a circular buffer.'
[]


[duplicate_ray]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/add_duplicate_ray=true'
  allow_test_objects = true
  expect_err = 'Multiple shared_ptrs were found that point to the same Ray'
  detail = 'the same ray is added to be traced multiple times,'
[]


[local_non_unique_id]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/add_local_non_unique_id_ray=true
                  Mesh/gmg/nx=50'
  allow_test_objects = true
  expect_err = 'Multiple Rays exist with ID 0 on processor'
  detail = 'when local rays that have the same ID are added to be traced,'
[]


[global_non_unique_id]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/add_global_non_unique_id_ray=true
                  Mesh/gmg/nx=50'
  allow_test_objects = true
  min_parallel = 2
  expect_err = 'Ray with ID 0 exists on ranks'
  detail = 'when rays that have the same ID on different processors are added to be traced,'
[]


[ray_kernel_coverage_check]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/ray_kernel_coverage_check=true'
  expect_err = 'Subdomains { 0 } do not have RayKernels defined!'
  allow_test_objects = true
  detail = 'when the domain is not covered with ray kernels,'
[]


[unneeded_rays]
  type = RunException
  input = 'errors.i'
  cli_args = 'RayKernels/null/type=NullRayKernel RayKernels/null/rays=dummy'
  expect_err = 'Rays cannot be supplied when the study does not require Ray registration'
  allow_test_objects = true
  detail = 'when ray names are provided to a ray tracing object and the study does not register ray names,'
[]


[ray_not_found]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/active=repeatable
                  RayKernels/null/type=NullRayKernel
                  RayKernels/null/rays=dummy'
  expect_err = 'Supplied ray \'dummy\' is not a registered Ray'
  allow_test_objects = true
  detail = 'when a ray name is provided to a ray tracing object and said name is not registered to a ray,'
[]


[mixed_pre_kernel_execute]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/execute_on='INITIAL PRE_KERNELS'"
  expect_err = 'PRE_KERNELS cannot be mixed with any other execution flag.'
  allow_test_objects = true
  detail = 'when the study is set to execute with residual kernels and non-residual kernels,'
[]


[eigenvalue]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/execute_on=PRE_KERNELS
                  Executioner/type=Eigenvalue'
  expect_err = 'is not supported for an eigenvalue solve.'
  allow_test_objects = true
  slepc = true
  detail = 'when the study is set to execute with residual kernels and an eigenvalue executioner,'
[]


[error_if_tracing]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/ray_error_if_tracing=true'
  expect_err = 'Cannot use Ray::clearStartingInfo\(\) after it has started tracing'
  allow_test_objects = true
  detail = 'when the trajectory of a ray is changed after it has started tracing,'
[]


[reset_counters]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/ray_reset_counters=true'
  expect_err = 'Ray::resetCounters\(\) can only be used during generateRays()'
  allow_test_objects = true
  detail = 'when a ray\'s counters are reset when not generating rays'
[]


[adapt_bad_type]
  type = RunException
  input = 'errors.i'
  cli_args = 'Mesh/gmg/elem_type=EDGE3
                  Adaptivity/steps=1
                  Adaptivity/marker=uniform
                  Adaptivity/max_h_level=2
                  Adaptivity/initial_steps=1
                  Adaptivity/Markers/uniform/type=UniformMarker
                  Adaptivity/Markers/uniform/mark=refine'
  allow_test_objects = true
  expect_err = 'Element type EDGE3 is not supported in ray tracing with adaptivity'
  detail = 'when tracing in a mesh with adaptivity and an unsupported element type'
[]


[hmax_vary]
  type = RunException
  input = 'errors.i'
  cli_args = 'Mesh/active=2d
                  Mesh/2d/type=GeneratedMeshGenerator
                  Mesh/2d/dim=2
                  Mesh/2d/xmax=1000'
  allow_test_objects = true
  expect_err = 'Element hmin varies significantly from subdomain hmax.'
  detail = 'when tracing in a mesh when the average subdomain hmax is a poor approximation due to stretched elements'
[]


[register_ray_data_late]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/register_ray_data_late=true'
  expect_err = 'Cannot register Ray data after initialSetup()'
  allow_test_objects = true
  detail = 'when ray data is registered too late'
[]


[register_ray_data_same_name]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/register_ray_data_same_name=true'
  expect_err = 'Cannot register Ray aux data with name foo because Ray \(non-aux\) data already exists with said name.'
  allow_test_objects = true
  detail = 'when ray data is registered with the same name across systems'
[]


[ray_data_index_bad_name]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/ray_data_index_bad_name=true'
  expect_err = 'Unknown Ray data with name foo'
  allow_test_objects = true
  detail = 'when requesting a ray data index for an invalid name'
[]


[ray_data_name_bad_index]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/ray_data_name_bad_index=true'
  expect_err = 'Unknown Ray data with index 123'
  allow_test_objects = true
  detail = 'when requesting a ray data name for an invalid index'
[]


[get_ray_kernels_early]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/get_ray_kernels_early=true'
  expect_err = 'Should not call getRayKernels\(\) before initialSetup\(\)'
  allow_test_objects = true
  detail = 'when requesting ray kernels before they are setup'
[]


[get_ray_bcs_early]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/get_ray_bcs_early=true'
  expect_err = 'Should not call getRayBCs\(\) before initialSetup\(\)'
  allow_test_objects = true
  detail = 'when requesting ray bcs before they are setup'
[]


[get_bank_disabled]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/type=RayTracingStudyNoBankingTest'
  expect_err = 'The Ray bank is not available because the private parameter \'_bank_rays_on_completion\' is set to false.'
  allow_test_objects = true
  detail = 'when obtaining the ray bank when banking is disabled'
[]


[get_bank_bad]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/get_ray_bank_generating=true'
  expect_err = 'Cannot get the Ray bank during generation or propagation.'
  allow_test_objects = true
  detail = 'when obtaining the ray bank when it is not available'
[]


[register_ray_no_registration]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/register_ray_no_registration=true'
  expect_err = 'Cannot use registerRay\(\) with Ray registration disabled'
  allow_test_objects = true
  detail = 'when registering a ray when ray registration is disabled'
[]


[registered_ray_id_no_registration]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/registered_ray_id_no_registration=true'
  expect_err = 'Should not use registeredRayID\(\) with Ray registration disabled'
  allow_test_objects = true
  detail = 'when getting a registered ray ID when ray registration is disabled'
[]


[registered_ray_name_no_registration]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/registered_ray_name_no_registration=true'
  expect_err = 'Should not use registeredRayName\(\) with Ray registration disabled'
  allow_test_objects = true
  detail = 'when getting a registered ray name when ray registration is disabled'
[]


[registered_ray_id_missing]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/type=RayTracingStudyWithRegistrationTest
                  UserObjects/study/registered_ray_id_missing=true'
  expect_err = 'Attempted to obtain ID of registered Ray foo, but a Ray with said name is not registered.'
  allow_test_objects = true
  detail = 'when requesting a registered ray ID for a ray that is not registered'
[]


[registered_ray_name_missing]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/type=RayTracingStudyWithRegistrationTest
                  UserObjects/study/registered_ray_name_missing=true'
  expect_err = 'Attempted to obtain name of registered Ray with ID 0, but a Ray with said ID is not registered.'
  allow_test_objects = true
  detail = 'when requesting a registered ray name for a ray that is not registered'
[]


[reserve_bad]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/reserve_bad=true'
  expect_err = 'Can only reserve in Ray buffer during generateRays\(\)'
  allow_test_objects = true
  detail = 'when reserving space in the ray buffer outside of registration, and'
[]


[subdomain_hmax_missing]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/subdomain_hmax_missing=true'
  expect_err = 'Subdomain 1337 not found in subdomain hmax map'
  allow_test_objects = true
  detail = 'when requesting a subdomain hmax for an invalid subdomain'
[]


[elem_extrema_build_edge]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/elem_extrema_build_edge=true'
  expect_err = 'Element does not contain vertices in ElemExtrema'
  allow_test_objects = true
  # will hit assertions before the error outside of opt
  method = opt
  detail = 'building an element extrema edge for invalid vertices'
[]


[get_elem_normals_unimplemented]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/get_elem_normals_unimplemented=true'
  expect_err = 'Unimplemented element normal caching in RayTracingStudyTest::getElemNormals\(\)'
  allow_test_objects = true
  detail = 'requesting cached element normals when element normal caching has not been setup'
[]


[ray_data_index_other_exists]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/ray_data_index_other_exists=true'
  expect_err = 'However, Ray aux data with said name was found.'
  allow_test_objects = true
  detail = 'getting the index of ray data when aux data with the same name exists'
[]


[ray_data_aux_index_other_exists]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/ray_data_aux_index_other_exists=true'
  expect_err = 'However, Ray non-aux data with said name was found.'
  allow_test_objects = true
  detail = 'getting the index of ray aux data when data with the same name exists'
[]


[register_ray_again]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/type=RayTracingStudyWithRegistrationTest
                  UserObjects/study/register_ray_again=true'
  expect_err = 'A ray with the name "foo" is already registered'
  allow_test_objects = true
  detail = 'registering a ray more than once with the same name'
[]

[test]
  type = 'CSVDiff'
  input = 'kernel_change_ray.i'
  csvdiff = 'kernel_change_ray_out.csv'
  allow_test_objects = true
  issues = '#16028'
  design = 'RayKernels/index.md RayTracingStudy.md'
  requirement = 'The system shall be able to change the trajectory of rays during tracing within RayKernels.'
[]


[2d]
  type = 'CSVDiff'
  input = 'kernel_create_ray.i'
  csvdiff = 'kernel_create_ray_2d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=kernel_create_ray_2d_out'
  detail = 'two-dimensional meshes '
[]


[3d]
  type = 'CSVDiff'
  input = 'kernel_create_ray.i'
  csvdiff = 'kernel_create_ray_3d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=kernel_create_ray_3d_out
                  Mesh/active=gmg_3d
                  RayBCs/active=kill_3d'
  detail = 'and in three-dimensional meshes.'
[]


[smart]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'UserObjects/lots/method=smart
                  Outputs/file_base=lots_out'
  allow_test_objects = true
  detail = 'an asynchronous method, '
[]


[bs]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'UserObjects/lots/method=bs
                  UserObjects/lots/allow_new_work_during_execution=false
                  Outputs/file_base=lots_out'
  allow_test_objects = true
  detail = 'a bulk-synchronous method, '
[]


[harm]
  type = 'CSVDiff'
  input = '../lots.i'
  csvdiff = 'lots_out.csv'
  cli_args = 'UserObjects/lots/method=harm
                  UserObjects/lots/allow_new_work_during_execution=false
                  Outputs/file_base=lots_out'
  allow_test_objects = true
  detail = 'and the harm method.'
[]

[test]
  type = 'Exodiff'
  input = 'multiple_subdomains.i'
  exodiff = 'multiple_subdomains_out.e'
  allow_test_objects = true
  issues = '#16028'
  design = 'RayTracingStudy.md'
  requirement = 'The system shall support the tracing of rays across multiple subdomains.'
[]


[unsized]
  type = 'CSVDiff'
  input = 'ray_data.i'
  # needs to be a separate file because recover tests will fail
  # when appending to an output from another test in the same directory
  csvdiff = 'ray_data_unsized_out.csv'
  allow_test_objects = true
  detail = 'and when not sizing the Ray data on acquire.'
  cli_args = 'UserObjects/test1/use_unsized_rays=true
                  UserObjects/test2/use_unsized_rays=true
                  UserObjects/test3/use_unsized_rays=true
                  UserObjects/test4/use_unsized_rays=true
                  Outputs/file_base=ray_data_unsized_out'
[]

[test]
  type = 'CSVDiff'
  input = 'reuse_rays.i'
  csvdiff = 'reuse_rays_out.csv'
  allow_test_objects = true
  issues = '#16028'
  design = 'RayTracingStudy.md'
  requirement = 'The system shall support the re-use of traced rays.'
[]


[no_bc]
  type = 'RunException'
  input = 'tolerate_failure.i'
  expect_err = 'Ray on processor .* and thread .* failed to trace'
  requirement = 'The system shall support the failure of a trace gracefully via a warning.'
  allow_warnings = true
  should_crash = false
[]

[max_distance]
  type = 'CSVDiff'
  input = 'max_distance.i'
  csvdiff = 'max_distance_out.csv'
  issues = '#16028'
  design = 'RayTracingStudy.md'
  requirement = 'The system shall support ending rays by a user-set maximum distance.'
[]


[nemesis]
  type = Exodiff
  input = 'ray_mesh_output.i'
  cli_args = 'Mesh/Partitioner/type=GridPartitioner
                Mesh/Partitioner/nx=2
                Mesh/Partitioner/ny=2
                Outputs/rays/type=RayTracingNemesis
                "Outputs/rays/output_properties=\'ray_id intersections pid processor_crossings trajectory_changes\'"
                Outputs/rays/file_base=nemesis_rays'
  exodiff = 'nemesis_rays.e.4.0 nemesis_rays.e.4.1 nemesis_rays.e.4.2 nemesis_rays.e.4.3'
  min_parallel = 4
  max_parallel = 4
  recover = false
  requirement = 'The system shall support the mesh output of traced rays using the Nemesis format.'
  design = 'RayTracingNemesis.md RayTracingMeshOutput.md'
[]


[exodus]
  type = Exodiff
  input = 'ray_mesh_output.i'
  cli_args = 'Mesh/Partitioner/type=GridPartitioner
                  Mesh/Partitioner/ny=3
                  UserObjects/study/segments_on_cache_traces=false
                  "Outputs/rays/output_properties=\'ray_id intersections pid processor_crossings trajectory_changes\'"
                  Outputs/rays/file_base=no_segments_rays'
  exodiff = 'no_segments_rays.e'
  min_parallel = 3
  max_parallel = 3
  recover = false
  detail = 'Exodus format and'
[]


[nemesis]
  type = Exodiff
  input = 'ray_mesh_output.i'
  cli_args = 'Mesh/Partitioner/type=GridPartitioner
                  Mesh/Partitioner/ny=2
                  Outputs/rays/type=RayTracingNemesis
                  UserObjects/study/segments_on_cache_traces=false
                  "Outputs/rays/output_properties=\'ray_id intersections pid processor_crossings trajectory_changes\'"
                  Outputs/rays/file_base=no_segments_nemesis_rays'
  exodiff = 'no_segments_nemesis_rays.e.2.0 no_segments_nemesis_rays.e.2.1'
  min_parallel = 2
  max_parallel = 2
  recover = false
  detail = 'in Nemesis format.'
[]


[nemesis]
  type = Exodiff
  input = 'ray_mesh_output_data.i'
  cli_args = 'Mesh/Partitioner/type=GridPartitioner
                  Mesh/Partitioner/nx=2
                  Outputs/rays/type=RayTracingNemesis
                  Outputs/rays_nodal/type=RayTracingNemesis'
  exodiff = 'ray_mesh_output_data_rays.e.2.0 ray_mesh_output_data_rays.e.2.1 ray_mesh_output_data_rays_nodal.e.2.0 ray_mesh_output_data_rays_nodal.e.2.1'
  min_parallel = 2
  max_parallel = 2
  recover = false
  detail = 'nemesis formats.'
[]


[no_cached_data]
  type = RunException
  input = 'ray_mesh_output_errors.i'
  cli_args = 'Outputs/rays/output_data=true'
  expect_err = "In order to output Ray data in output 'rays', the RayTracingStudy 'study' must set data_on_cache_traces = true"

  detail = 'ray data is requested to be output but it is not cached,'
[]


[no_cached_aux_data]
  type = RunException
  input = 'ray_mesh_output_errors.i'
  cli_args = 'Outputs/rays/output_aux_data=true'
  expect_err = "In order to output Ray aux data in output 'rays', the RayTracingStudy 'study' must set aux_data_on_cache_traces = true"

  detail = 'aux data is requested to be output but it is not cached,'
[]


[data_nodal_and_non_nodal]
  type = RunException
  input = 'ray_mesh_output_errors.i'
  cli_args = 'UserObjects/study/data_on_cache_traces=true
                  Outputs/rays/output_data=true
                  Outputs/rays/output_data_nodal=true'
  expect_err = "Either choose output_data = true or output_data_nodal = true, not both."

  detail = 'both nodal and non-nodal data is requested to be output,'
[]


[nodal_no_segments]
  type = RunException
  input = 'ray_mesh_output_errors.i'
  cli_args = 'UserObjects/study/data_on_cache_traces=true
                  UserObjects/study/segments_on_cache_traces=false
                  Outputs/rays/output_data_nodal=true'
  expect_err = "Not supported when study segments_on_cache_traces = false"

  detail = 'and when nodal data is requested to be output but segment-wise information is not cached.'
[]


[no_segments_warning]
  type = RunException
  input = 'ray_mesh_output_errors.i'
  expect_err = "No cached trace segments were found in the study 'study'."

  design = 'RayTracingMeshOutput.md'
  requirement = 'The system shall report a warning when rays are requested to be output in a mesh format but cached ray inforamtion is not found.'
[]


[simple_diffusion_rays]
  type = 'Exodiff'
  input = 'simple_diffusion_line_integral.i'
  exodiff = 'simple_diffusion_line_integral_rays.e'
  design = 'VariableIntegralRayKernel.md RayTracingMeshOutput.md'
  cli_args = 'UserObjects/study/always_cache_traces=true UserObjects/study/data_on_cache_traces=true Outputs/rays/output_data=true Outputs/rays/execute_on=TIMESTEP_END'
  requirement = 'The system shall provide the ability to output the segment wise accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.'
[]


[simple_diffusion_rays_nodal]
  type = 'Exodiff'
  input = 'simple_diffusion_line_integral.i'
  exodiff = 'simple_diffusion_line_integral_rays_nodal.e'
  design = 'VariableIntegralRayKernel.md RayTracingMeshOutput.md'
  cli_args = 'UserObjects/study/always_cache_traces=true UserObjects/study/data_on_cache_traces=true Outputs/rays/execute_on=TIMESTEP_END Outputs/rays/output_data_nodal=true Outputs/rays/file_base=simple_diffusion_line_integral_rays_nodal'
  requirement = 'The system shall provide the ability to output the segment wise, linearly approximated, accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.'
[]


[nemesis]
  type = Exodiff
  input = 'ray_mesh_output.i'
  cli_args = 'Mesh/Partitioner/type=GridPartitioner
                Mesh/Partitioner/nx=2
                Mesh/Partitioner/ny=2
                Outputs/rays/type=RayTracingNemesis
                "Outputs/rays/output_properties=\'ray_id intersections pid processor_crossings trajectory_changes\'"
                Outputs/rays/file_base=nemesis_rays'
  exodiff = 'nemesis_rays.e.4.0 nemesis_rays.e.4.1 nemesis_rays.e.4.2 nemesis_rays.e.4.3'
  min_parallel = 4
  max_parallel = 4
  recover = false
  requirement = 'The system shall support the mesh output of traced rays using the Nemesis format.'
  design = 'RayTracingNemesis.md RayTracingMeshOutput.md'
[]


[no_registration]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = 'LotsOfRaysRayStudy "lots" does not support Ray registration'
  cli_args = 'UserObjects/active=lots Postprocessors/active=no_registration'
  allow_test_objects = true

  detail = 'the RayTracingStudy does not support accessing rays by name,'
[]


[no_banking]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = "DisableRayBankingStudy \"no_banking_study\" does not bank Rays on completion."
  cli_args = 'UserObjects/active=no_banking_study Postprocessors/active=no_banking'
  allow_test_objects = true

  detail = 'the RayTracingStudy does not support the banking of rays on completion,'
[]


[ray_name_not_found]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = "Could not find a registered Ray with the name 'dummy'"
  cli_args = 'UserObjects/active=repeatable Postprocessors/active=ray_name_not_found'
  allow_test_objects = true

  detail = 'the named ray was not found,'
[]


[data_name_not_found]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = "The RepeatableRayStudy \"repeatable\" does not have Ray data associated with the name 'dummy'"
  cli_args = 'UserObjects/active=repeatable Postprocessors/active=data_name_not_found'
  allow_test_objects = true

  detail = 'the named ray data was not found,'
[]


[aux_data_name_not_found]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = "The RepeatableRayStudy \"repeatable\" does not have Ray aux data associated with the name 'dummy'"
  cli_args = 'UserObjects/active=repeatable Postprocessors/active=aux_data_name_not_found'
  allow_test_objects = true

  detail = 'the named ray aux data was not found,'
[]


[id_not_found]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = "Could not find a Ray with the ID 1 in the Ray banks."
  cli_args = 'UserObjects/active=repeatable Postprocessors/active=id_not_found RayBCs/active=kill'
  allow_test_objects = true

  detail = 'the ray with the given id was not found,'
[]


[neither_provided]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = "Must have either the 'ray_id' or the 'ray_name' param set."
  cli_args = 'UserObjects/active=repeatable Postprocessors/active=neither_provided RayBCs/active=kill'
  allow_test_objects = true

  detail = 'neither an ID or name was provided, and'
[]


[both_provided]
  type = RunException
  input = 'ray_data_value_errors.i'
  expect_err = "Either 'ray_id' or 'ray_name' must be set, but not both"
  cli_args = 'UserObjects/active=repeatable Postprocessors/active=both_provided RayBCs/active=kill'
  allow_test_objects = true

  detail = 'both an ID and name was provided.'
[]


[not_integral_ray_kernel]
  type = RunException
  input = 'ray_integral_value_errors.i'
  cli_args = 'RayKernels/active=null Postprocessors/active=not_integral_ray_kernel'
  expect_err = "NullRayKernel is not derived from an IntegralRayKernel."

  detail = 'the provided IntegralRayKernel is not an IntegralRayKernel,'
[]


[kernel_not_found]
  type = RunException
  input = 'ray_integral_value_errors.i'
  cli_args = 'RayKernels/active=null Postprocessors/active=kernel_not_found'
  expect_err = "The RayKernel by the name 'dummy' was not found."

  detail = 'the provided IntegralRayKernel was not found,'
[]


[ray_not_found]
  type = RunException
  input = 'ray_integral_value_errors.i'
  cli_args = 'RayKernels/active=variable_integral Postprocessors/active=ray_not_found'
  expect_err = "Could not find a Ray named 'dummy'"

  detail = 'a Ray with the given name was not found,'
[]


[no_registration]
  type = RunException
  input = 'ray_integral_value_errors.i'
  cli_args = 'UserObjects/active=lots RayKernels/active=variable_integral Postprocessors/active=no_registration'
  expect_err = "Cannot be used because the supplied LotsOfRaysRayStudy does not have Ray registration enabled."
  allow_test_objects = true

  detail = 'the provided study does not support Ray registration,'
[]


[no_banking]
  type = RunException
  input = 'ray_integral_value_errors.i'
  cli_args = 'UserObjects/active=no_banking_study RayKernels/active=variable_integral Postprocessors/active=no_banking'
  expect_err = "Cannot be used because the supplied DisableRayBankingStudy does not bank Rays on completion."
  allow_test_objects = true

  detail = 'or the provided study does not support Ray banking.'
[]


[test]
  type = 'CSVDiff'
  input = 'ray_tracing_study_result.i'
  csvdiff = 'ray_tracing_study_result_out.csv'
  allow_test_objects = true

  # ignore the partitioning-specific columns
  override_columns = 'total_processor_crossings max_processor_crossings'
  override_rel_err = '1e12 1e12'
  override_abs_zero = '1e-10 1e-10'

  requirement = 'The system shall support the output of the total number of rays started, the total distance traveled by rays, and the number of processor crossings the rays have encountered.'
[]


[test]
  type = CSVDiff
  input = 'ray_bc_dependencies.i'
  csvdiff = 'ray_bc_dependencies_out.csv'
  allow_test_objects = true

  requirement = 'The system shall support the dependency resolution of RayBCs.'
[]


[missing]
  type = RunException
  input = 'ray_bc_dependencies.i'
  cli_args = 'RayBCs/add_1/depends_on=dummy'
  allow_test_objects = true
  expect_err = 'The RayBoundaryCondition \'dummy\' does not exist'

  requirement = 'The system shall throw a reasonable error when adding a dependency for a RayBC that does not exist.'
[]


[should_not_continue]
  type = RunException
  input = 'raybc_errors.i'
  cli_args = "RayBCs/active='kill change'
                  RayBCs/change/depends_on=kill"
  expect_err = "Cannot changeRayDirection\(\) for a Ray that should not continue"
  allow_test_objects = true

  detail = 'the ray was set to not continue by another RayBC,'
[]


[again]
  type = RunException
  input = 'raybc_errors.i'
  cli_args = "RayBCs/active='change change_again'"
  expect_err = "Cannot change direction for a ray whose direction has already been changed"
  allow_test_objects = true

  detail = 'the ray already had its direction changed,'
[]


[end_set]
  type = RunException
  input = 'raybc_errors.i'
  cli_args = "Mesh/active='gmg internal'
                  UserObjects/active=set_end_study
                  RayBCs/active=change_internal"
  expect_err = "Cannot change the direction of a Ray whose end point is set upon generation"
  allow_test_objects = true

  detail = 'the end point of the ray was set upon generation,'
[]


[zero]
  type = RunException
  input = 'raybc_errors.i'
  cli_args = "RayBCs/active=change_zero"
  expect_err = "Cannot set zero vector direction for a Ray"
  allow_test_objects = true

  detail = 'and when the direction is changed to the zero vector.'
[]


[test]
  type = 'CSVDiff'
  input = 'reflect_ray_bc.i'
  csvdiff = 'reflect_ray_bc_out.csv'
  allow_test_objects = true

  requirement = 'The system shall support the specular reflection of rays on a boundary.'
[]


[non_planar_warning]
  type = RunException
  input = 'reflect_ray_bc_nonplanar.i'
  expect_err = 'A Ray is being reflected on a non-planar side.'
  allow_test_objects = true

  requirement = 'The system shall report a reasonable warning when using an approximation to reflect a ray on a side that is not planar.'
[]


[2d]
  type = 'CSVDiff'
  input = 'bc_create_ray.i'
  csvdiff = 'bc_create_ray_2d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=bc_create_ray_2d_out'
  detail = 'two-dimensional meshes '
[]


[3d]
  type = 'CSVDiff'
  input = 'bc_create_ray.i'
  csvdiff = 'bc_create_ray_3d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=bc_create_ray_3d_out
                  Mesh/active=gmg_3d
                  "RayBCs/active=\'kill_3d create_3d\'"'
  detail = 'and in three-dimensional meshes.'
[]


[2d]
  type = 'CSVDiff'
  input = 'kernel_create_ray.i'
  csvdiff = 'kernel_create_ray_2d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=kernel_create_ray_2d_out'
  detail = 'two-dimensional meshes '
[]


[3d]
  type = 'CSVDiff'
  input = 'kernel_create_ray.i'
  csvdiff = 'kernel_create_ray_3d_out.csv'
  allow_test_objects = true
  cli_args = 'Outputs/file_base=kernel_create_ray_3d_out
                  Mesh/active=gmg_3d
                  RayBCs/active=kill_3d'
  detail = 'and in three-dimensional meshes.'
[]


[test]
  type = 'CSVDiff'
  input = 'reflect_ray_bc.i'
  csvdiff = 'reflect_ray_bc_out.csv'
  allow_test_objects = true

  requirement = 'The system shall support the specular reflection of rays on a boundary.'
[]


[non_planar_warning]
  type = RunException
  input = 'reflect_ray_bc_nonplanar.i'
  expect_err = 'A Ray is being reflected on a non-planar side.'
  allow_test_objects = true

  requirement = 'The system shall report a reasonable warning when using an approximation to reflect a ray on a side that is not planar.'
[]


[xyz_only]
  type = RunException
  input = 'errors.i'
  cli_args = 'Problem/coord_type=RZ'
  expect_err = 'Not valid on coordinate systems other than XYZ'
  detail = 'is used with a coordinate system other than xyz or'
[]


[implicit_only]
  type = RunException
  input = 'errors.i'
  cli_args = 'RayKernels/line_source/implicit=false'
  expect_err = 'ADRayKernels do not currently support explicit solves.'
  detail = 'is used in an explicit manner.'
[]


[const_monomial_only]
  type = RunException
  input = 'const_monomial_only.i'
  expect_err = 'Only CONSTANT MONOMIAL variables are supported'
  requirement = 'The system shall throw a reasonable error if a non-supported auxiliary variable is used with a ray aux kernel.'
[]


[test]
  type = 'Exodiff'
  input = 'coupled_line_source_ray_kernel.i'
  exodiff = 'coupled_line_source_ray_kernel_out.e'
  allow_test_objects = true

  requirement = 'The system shall support the coupling of variables on rays that contribute to the residual and Jacobian.'
[]


[test_jac]
  type = 'PetscJacobianTester'
  input = 'coupled_line_source_ray_kernel.i'
  run_sim = True
  ratio_tol = 1e-7
  difference_tol = 1e-6
  allow_test_objects = true

  requirement = 'The system shall be able to produce the exact Jacobian with coupled variables on rays.'
[]


[test_ad]
  type = 'Exodiff'
  input = 'coupled_line_source_ray_kernel.i'
  exodiff = 'coupled_line_source_ray_kernel_out.e'
  cli_args = 'RayKernels/active=source_ad'
  allow_test_objects = true

  requirement = 'The system shall support the coupling of variables using automatic differentiation on rays that contribute to the residual and Jacobian.'
[]


[test_ad_jac]
  type = 'PetscJacobianTester'
  input = 'coupled_line_source_ray_kernel.i'
  run_sim = True
  ratio_tol = 1e-7
  difference_tol = 1e-6
  cli_args = 'RayKernels/active=source_ad'
  allow_test_objects = true

  requirement = 'The system shall be able to produce the exact Jacobian using automatic differentiation on rays.'
[]


[test]
  type = CSVDiff
  input = 'ray_kernel_dependencies.i'
  csvdiff = 'ray_kernel_dependencies_out.csv'
  allow_test_objects = true

  requirement = 'The system shall support the dependency resolution of RayKernels.'
[]


[missing]
  type = RunException
  input = 'ray_kernel_dependencies.i'
  cli_args = 'RayKernels/add_1/depends_on=dummy'
  allow_test_objects = true
  expect_err = 'The RayKernel \'dummy\' does not exist'

  requirement = 'The system shall throw a reasonable error when adding a dependency for a RayKernel that does not exist.'
[]


[should_not_continue]
  type = RunException
  input = 'raykernel_errors.i'
  cli_args = "RayKernels/active='kill change_after_kill'"
  expect_err = "Cannot changeRayStartDirection\(\) for a Ray that should not continue."
  allow_test_objects = true

  detail = 'the ray was set to not continue by another RayKernel,'
[]


[should_not_continue_at_end]
  type = RunException
  input = 'raykernel_errors.i'
  cli_args = "UserObjects/active=end_study
                  RayKernels/active='kill change_after_kill'"
  expect_err = "It has also hit its user-set end point."
  allow_test_objects = true

  detail = 'the ray was set to not continue by another RayKernel and it is at its end point,'
[]


[changed_again]
  type = RunException
  input = 'raykernel_errors.i'
  cli_args = "RayKernels/active='change change_again'"
  expect_err = "Cannot change a Ray\'s trajectory when its trajectory has already been changed"
  allow_test_objects = true

  detail = 'the ray\'s trajectory was already changed,'
[]


[end_set]
  type = RunException
  input = 'raykernel_errors.i'
  cli_args = "UserObjects/active=end_study
                  UserObjects/end_study/end_points='1 0 0'
                  RayKernels/active='change'"
  expect_err = "Cannot change the direction of a Ray whose end point is set upon generation \(via setStartingEndPoint\(\)\)."
  allow_test_objects = true

  detail = 'the ray\'s end point has been set,'
[]


[out_of_elem]
  type = RunException
  input = 'raykernel_errors.i'
  cli_args = "RayKernels/active='change_out_of_elem'"
  expect_err = "is not within the element that the RayKernel was executed on"
  allow_test_objects = true

  detail = 'the ray\'s start point is not within the current element, and'
[]


[zero_direction]
  type = RunException
  input = 'raykernel_errors.i'
  cli_args = "RayKernels/active='change_zero'"
  expect_err = "Cannot set zero vector direction for a Ray"
  allow_test_objects = true

  detail = 'when the ray\'s new direction is set to the zero vector.'
[]

[test]
  type = 'CSVDiff'
  input = 'kernel_change_ray.i'
  csvdiff = 'kernel_change_ray_out.csv'
  allow_test_objects = true
  issues = '#16028'
  design = 'RayKernels/index.md RayTracingStudy.md'
  requirement = 'The system shall be able to change the trajectory of rays during tracing within RayKernels.'
[]


[test]
  type = 'CSVDiff'
  input = 'function_integral_ray_kernel.i'
  csvdiff = 'function_integral_ray_kernel_out.csv'
  requirement = 'The system shall provide the ability to compute the integral of a Function along a line.'
[]


[average]
  type = 'CSVDiff'
  input = 'function_integral_ray_kernel.i'
  csvdiff = 'function_integral_ray_kernel_average.csv'
  cli_args = 'Outputs/file_base=function_integral_ray_kernel_average
                RayKernels/function_integral/average=true'
  requirement = 'The system shall provide the ability to compute the average value of a Function along a line.'
[]


[test]
  type = 'Exodiff'
  input = 'line_source_ray_kernel.i'
  exodiff = 'line_source_ray_kernel_out.e'
  requirement = 'The system shall provide an ability to produce a source term along a line.'
[]


[test]
  type = 'CSVDiff'
  input = 'material_integral_ray_kernel.i'
  csvdiff = 'material_integral_ray_kernel_out.csv'

  requirement = 'The system shall provide the ability to compute the integral of a material property along a line.'
[]


[average]
  type = 'CSVDiff'
  input = 'material_integral_ray_kernel.i'
  csvdiff = 'material_integral_ray_kernel_average.csv'
  cli_args = 'Outputs/file_base=material_integral_ray_kernel_average
                RayKernels/material_integral/average=true'

  requirement = 'The system shall provide the ability to compute the average value of a material property along a line.'
[]


[test]
  type = 'Exodiff'
  input = 'ray_distance_aux.i'
  exodiff = 'ray_distance_aux_out.e'
  allow_test_objects = true
  requirement = 'The system shall be able to store the distance traversed by a ray in each element in an auxiliary field.'
[]


[xyz_only]
  type = RunException
  input = 'errors.i'
  cli_args = 'Problem/coord_type=RZ'
  expect_err = 'Not valid on coordinate systems other than XYZ'
  detail = 'is utilized with a coordinate system other than xyz or'
[]


[bad_execute_on]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/execute_on=initial'
  expect_err = 'In this case, the study must use the execute_on = PRE_KERNELS'
  detail = 'if the execute flag for the associated ray study is not set correctly to use the RayKernel.'
[]


[test]
  type = 'CSVDiff'
  input = 'variable_integral_ray_kernel.i'
  csvdiff = 'variable_integral_ray_kernel_out.csv'
  design = 'VariableIntegralRayKernel.md'
  requirement = 'The system shall provide the ability to compute the integral of a variable along a line.'
[]


[average]
  type = 'CSVDiff'
  input = 'variable_integral_ray_kernel.i'
  csvdiff = 'variable_integral_ray_kernel_average.csv'
  cli_args = 'Outputs/file_base=variable_integral_ray_kernel_average
                RayKernels/variable_integral/average=true
                RayKernels/aux_variable_integral/average=true'
  design = 'VariableIntegralRayKernel.md'
  requirement = 'The system shall provide the ability to compute the average value of a variable along a line.'
[]


[simple_diffusion_rays]
  type = 'Exodiff'
  input = 'simple_diffusion_line_integral.i'
  exodiff = 'simple_diffusion_line_integral_rays.e'
  design = 'VariableIntegralRayKernel.md RayTracingMeshOutput.md'
  cli_args = 'UserObjects/study/always_cache_traces=true UserObjects/study/data_on_cache_traces=true Outputs/rays/output_data=true Outputs/rays/execute_on=TIMESTEP_END'
  requirement = 'The system shall provide the ability to output the segment wise accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.'
[]


[simple_diffusion_rays_nodal]
  type = 'Exodiff'
  input = 'simple_diffusion_line_integral.i'
  exodiff = 'simple_diffusion_line_integral_rays_nodal.e'
  design = 'VariableIntegralRayKernel.md RayTracingMeshOutput.md'
  cli_args = 'UserObjects/study/always_cache_traces=true UserObjects/study/data_on_cache_traces=true Outputs/rays/execute_on=TIMESTEP_END Outputs/rays/output_data_nodal=true Outputs/rays/file_base=simple_diffusion_line_integral_rays_nodal'
  requirement = 'The system shall provide the ability to output the segment wise, linearly approximated, accumulated integral of a variable along a line with a 2D, finite-element diffusion problem.'
[]


[get_info]
  type = 'RunApp'
  input = 'ray_lots.i'
  allow_test_objects = true
  cli_args = 'UserObjects/study/get_info=true'
  requirement = 'The system shall support the console output of information pertaining to a Ray.'
[]


[equality]
  type = RunApp
  input = 'ray_lots.i'
  allow_test_objects = true
  cli_args = "UserObjects/study/equality=true
                UserObjects/other_study/type=RepeatableRayStudy
                UserObjects/other_study/start_points='0 0 0'
                UserObjects/other_study/end_points='0.1 0.1 0'
                UserObjects/other_study/names=ray
                UserObjects/other_study/ray_kernel_coverage_check=false"
  requirement = 'The system shall provide a method for determining the equality of rays'
  expect_out = 'Ray equality test passed 22440 checks'
[]


[at_end_without_set]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/at_end_without_set=true'
  expect_err = 'Cannot use Ray::atEnd\(\) for a Ray that does not have an end set'
  allow_test_objects = true
  detail = 'checking if a ray is at its end point without an end point being set'
[]


[end_point_without_set]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/end_point_without_set=true'
  expect_err = 'Cannot use Ray::endPoint\(\) for a Ray that does not have an end set'
  allow_test_objects = true
  detail = 'retrieving a ray\'s end point when its end point has not been set'
[]


[set_start_again]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_start_again=true'
  expect_err = 'Starting point was already set via Ray::setStart\(\) and is being changed.'
  allow_test_objects = true
  detail = 'setting a ray\'s start point that has already been set'
[]


[set_direction_again]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_direction_again=true'
  expect_err = 'Cannot change a Ray\'s starting direction using Ray::setStartingDirection\(\)'
  allow_test_objects = true
  detail = 'setting a ray\'s starting direction multiple times without clearing it'
[]


[set_start_fail_bbox]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_start_fail_bbox=true'
  expect_err = 'Mesh does not contain starting point.'
  allow_test_objects = true
  detail = 'setting a ray\'s start point that is not contained within the mesh bounding box'
[]


[set_side_without_elem]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_side_without_elem=true'
  expect_err = 'Starting incoming side is set but starting element is not set.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting incoming side without setting its starting element'
[]


[set_invalid_side]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_invalid_side=true'
  expect_err = 'Starting incoming side is not valid for its starting element.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting incoming side to an invalid side'
[]


[set_bad_side]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_bad_side=true'
  expect_err = 'Starting incoming side does not contain the starting point.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting incoming side to one that does not contain the starting point'
[]


[set_bad_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_bad_start=true'
  expect_err = 'Starting element does not contain the starting point.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting point to a point that is not contained within a given starting element'
[]


[set_direction_before_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_direction_before_start=true'
  expect_err = 'Cannot use Ray::setStartingDirection\(\) before Ray::setStart\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s starting direction before setting its starting information,'
[]


[set_zero_direction]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_zero_direction=true'
  expect_err = 'Starting direction in Ray::setStartingDirection\(\) is the zero vector.'
  allow_test_objects = true
  detail = 'setting a ray\'s starting direction to the zero vector'
[]


[set_end_before_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_before_start=true'
  expect_err = 'Cannot use Ray::setStartingEndPoint\(\) before Ray::setStart\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point before setting its start point'
[]


[set_end_equal_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_equal_start=true'
  expect_err = 'End point is equal to the start point in Ray::setStartingEndPoint\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point to the same as its start point'
[]


[set_end_with_direction]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_with_direction=true'
  expect_err = 'Cannot use Ray::setStartingEndPoint\(\) after Ray::setStartingDirection\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point and starting direction'
[]


[set_distance_with_end]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_distance_with_end=true'
  expect_err = 'Cannot use Ray::setStartingMaxDistance\(\) after Ray::setStartingEndPoint\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s max distance after setting its end point'
[]


[set_end_with_distance]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_with_distance=true'
  expect_err = 'Cannot use Ray::setStartingEndPoint\(\) after Ray::setStartingMaxDistance\(\)'
  allow_test_objects = true
  detail = 'setting a ray\'s end point after setting its max distance'
[]


[set_end_fail_bbox]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_end_fail_bbox=true'
  expect_err = 'End point is not within the mesh for Ray::setStartingEndPoint\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s end point to a point that is not within the mesh bounding box'
[]


[set_distance_before_start]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_distance_before_start=true'
  expect_err = 'Cannot use Ray::setStartingMaxDistance\(\) before Ray::setStart\(\).'
  allow_test_objects = true
  detail = 'setting a ray\'s starting maximum distance before setting its start information'
[]


[set_distance_negative]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_distance_negative=true'
  expect_err = 'Starting max distance is <= 0'
  allow_test_objects = true
  detail = 'setting a ray\'s starting maximum distance to a negative value'
[]


[set_start_inactive]
  type = RunException
  input = 'errors.i'
  cli_args = 'UserObjects/study/set_start_inactive=true
                  Adaptivity/steps=1
                  Adaptivity/marker=uniform
                  Adaptivity/max_h_level=2
                  Adaptivity/initial_steps=2
                  Adaptivity/Markers/uniform/type=UniformMarker
                  Adaptivity/Markers/uniform/mark=refine'
  expect_err = 'Starting element is not active'
  allow_test_objects = true
  detail = 'setting the starting element for a ray to an inactive element'
[]


[direction_size]
  type = 'RunException'
  input = 'cone_ray_study_errors.i'
  cli_args = "UserObjects/study/directions='2 1 0 1 0 0'"
  expect_err = 'Not the same size as start_points'
  detail = 'the provided directions are inconsistent in size'
[]


[scaling_factors_size]
  type = 'RunException'
  input = 'cone_ray_study_errors.i'
  cli_args = "UserObjects/study/scaling_factors='1 1'"
  expect_err = 'Not the same size as start_points'
  detail = 'the provided scaling factors are inconsistent in size'
[]


[half_cone_angles_size]
  type = 'RunException'
  input = 'cone_ray_study_errors.i'
  cli_args = "UserObjects/study/half_cone_angles='1 1'"
  expect_err = 'Not the same size as start_points'
  detail = 'the provided half cone angles are inconsistent in size'
[]


[half_cone_angles_valid]
  type = 'RunException'
  input = 'cone_ray_study_errors.i'
  cli_args = "UserObjects/study/half_cone_angles='-10'"
  expect_err = 'Must be > 0 and <= 90 degrees'
  detail = 'the provided half cone angles are not valid angles'
[]


[polar_quad_orders_size]
  type = 'RunException'
  input = 'cone_ray_study_errors.i'
  cli_args = "UserObjects/study/polar_quad_orders='1 2'"
  expect_err = 'Not the same size as start_points'
  detail = 'the provided polar quadrature orders are inconsistent in size'
[]


[azimuthal_quad_orders_size]
  type = 'RunException'
  input = 'cone_ray_study_errors.i'
  cli_args = "UserObjects/study/azimuthal_quad_orders='1 2'"
  expect_err = 'Not the same size as start_points'
  detail = 'the provided azimuthal quadrature orders are inconsistent in size'
[]


[1d]
  type = 'RunException'
  input = 'cone_ray_study_errors.i'
  cli_args = 'Mesh/active=1d Mesh/1d/type=GeneratedMeshGenerator Mesh/1d/dim=1'
  expect_err = 'Does not support 1D'
  detail = 'it is run with an invalid mesh dimension'
[]


[directions_or_end_points]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/directions='1 0 0'"
  expect_err = "Can only use 'directions' or 'end_points', but not both"

  detail = 'both directions and points are provided,'
[]


[start_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/start_points='1 0 0 1 0 0'"
  expect_err = "Not the same size as names"

  detail = 'the number of start points provided is inconsistent,'
[]


[directions_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/directions='1 0 0 1 0 0'"
  expect_err = "Not the same size as names"

  detail = 'the number of directions provided is inconsistent,'
[]


[max_distance_with_end]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/max_distances=1"
  expect_err = "Can only be used when trajectories are set with the 'directions' parameter"

  detail = 'both end points and maximum distances are provided,'
[]


[max_distance_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/directions='1 0 0'
                  UserObjects/study/max_distances='1 2'"
  expect_err = "Must be the same size as 'start_points'"

  detail = 'the number of maximum distances provided is inconsistent,'
[]


[max_distance_positive]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/directions='1 0 0'
                  UserObjects/study/max_distances='-1'"
  expect_err = "Values must be positive"

  detail = 'the provided maximum distance is non-positive,'
[]


[end_points_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0 1 0 0'"
  expect_err = "Not the same size as names"

  detail = 'the number of end points provided is inconsistent,'
[]


[initial_data_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/ray_data_names=dummy
                  UserObjects/study/initial_ray_data='0; 0'"
  expect_err = "Data for 2 ray\(s\) was provided, but 1 ray\(s\) were defined"

  detail = 'the initial data size is inconsistent with the number of rays,'
[]


[initial_data_individual_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/ray_data_names=dummy
                  UserObjects/study/initial_ray_data='0 0'"
  expect_err = "Data for index 0 \(ray 'ray'\) is not the size of 'ray_data_names'"

  detail = 'the initial data size is inconsistent with the provided data names,'
[]


[data_names_not_set]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/initial_ray_data='1'"
  expect_err = "Can only be used if 'ray_data_names' is set"

  detail = 'initial data is provided but data names are not provided,'
[]


[initial_aux_data_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/ray_aux_data_names=dummy
                  UserObjects/study/initial_ray_aux_data='0; 0'"
  expect_err = "Aux data for 2 ray\(s\) was provided, but 1 ray\(s\) were defined"

  detail = 'the initial aux data size is inconsistent with the number of rays,'
[]


[initial_aux_data_individual_size]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/ray_aux_data_names=dummy
                  UserObjects/study/initial_ray_aux_data='0 0'"
  expect_err = "Data for index 0 \(ray 'ray'\) is not the size of 'ray_aux_data_names'"

  detail = 'the initial aux data size is inconsistent with the provided aux data names,'
[]


[aux_data_names_not_set]
  type = RunException
  input = 'errors.i'
  cli_args = "UserObjects/study/end_points='1 0 0'
                  UserObjects/study/initial_ray_aux_data='1'"
  expect_err = "Can only be used if 'ray_aux_data_names' is set"

  detail = 'and aux initial data is provided but aux data names are not provided.'
[]


[checkpoint]
  type = 'RunApp'
  input = 'recover.i'
  allow_test_objects = true
  cli_args = 'Outputs/checkpoint=true Executioner/num_steps=1'
  recover = false
  detail = 'outputting of checkpoint files and'
[]


[recover]
  type = 'CSVDiff'
  input = 'recover.i'
  csvdiff = 'recover_out.csv'
  cli_args = '--recover'
  allow_test_objects = true
  prereq = 'test/checkpoint'
  delete_output_before_running = false
  recover = false
  detail = 'shall be capable of restarting from the output data.'
[]


[replicated_no_claim]
  requirement = 'The RepeatableRayStudyBase shall report a useful warning when rays are to be replicated but claiming is disabled.'
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/type=RepeatableRayStudyDefineNoClaimTest'
  allow_test_objects = True
  expect_err = '_define_rays_replicated is being set to false.'
[]


[non_unique_id_error]
  requirement = 'The RepeatableRayStudyBase shall return a useful error when a ray is added with a non-unique ID.'
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/create_non_unique_id_rays=true'
  allow_test_objects = true
  expect_err = 'Multiple Rays exist with ID 0 on processor'
[]


[additional]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/create_additional_ray_pid=0'
  min_parallel = 2
  max_parallel = 2
  allow_test_objects = true
  expect_err = 'The size of _rays on rank 1 does not match the size of rays on rank 0.'
  detail = 'additional rays are created in a non-replicated manner on a subset of processors,'
[]


[non_replicated_id]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/create_non_replicated_id_ray_pid=0'
  min_parallel = 2
  max_parallel = 2
  allow_test_objects = true
  expect_err = 'A Ray was found on rank 1 with an ID that does not exist on rank 0.'
  detail = 'a ray exists with a non-replicated ID on a processor,'
[]


[non_replicated]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/create_non_replicated_ray_pid=0'
  min_parallel = 2
  max_parallel = 2
  allow_test_objects = true
  expect_err = 'A Ray was found on rank 1 that does not exist on rank 0.'
  detail = 'a non-replicated ray exists on a processor,'
[]


[starting_elem_set]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/define_ray_with_starting_elem=true'
  allow_test_objects = true
  expect_err = 'A Ray was found in _rays after defineRays\(\) that has a starting element or incoming side set.'
  detail = 'and a ray is created with starting element information when it should not.'
[]


[no_rays]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/define_no_rays=true'
  allow_test_objects = true
  expect_err = 'No Rays were moved to _rays in defineRays\(\)'

  detail = 'no rays were defined or'
[]


[null_ray]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/study/define_nullptr_ray=true'
  allow_test_objects = true
  expect_err = 'A nullptr Ray was found in _rays after defineRays\(\).'

  detail = 'a null ray was defined.'
[]


[non_positive_polar_order]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/non_positive_polar_order=true'
  allow_test_objects = true
  expect_err = 'polar_order must be positive in RayTracingAngularQuadrature'
  detail = 'the provided polar order is non-positive'
[]


[non_positive_azimuthal_order]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/non_positive_azimuthal_order=true'
  allow_test_objects = true
  expect_err = 'azimuthal_order must be positive in RayTracingAngularQuadrature'
  detail = 'the provided azimuthal order is non-positive'
[]


[mu_min_larger]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/mu_min_larger=true'
  allow_test_objects = true
  expect_err = 'mu_min must be < mu_max in RayTracingAngularQuadrature'
  detail = 'the minimum polar cosine is greater than the maximum polar cosine'
[]


[mu_min_too_small]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/mu_min_too_small=true'
  allow_test_objects = true
  expect_err = 'mu_min must be >= -1 in RayTracingAngularQuadrature'
  detail = 'the minimum polar cosine is less than negative one'
[]


[mu_max_too_big]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/mu_max_too_big=true'
  allow_test_objects = true
  expect_err = 'mu_max must be <= 1 in RayTracingAngularQuadrature'
  detail = 'the maximum polar cosine is greater than one'
[]


[dim1]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/dim1=true'
  allow_test_objects = true
  expect_err = 'RayTracingAngularQuadrature only supports dimensions 2 and 3'
  detail = 'the dimension is less than two'
[]


[non_positive_gauss_legendre_order]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/non_positive_gauss_legendre_order=true'
  allow_test_objects = true
  expect_err = 'Order must be positive in gaussLegendre\(\)'
  detail = 'the Gauss-Legendre order is non-positive'
[]


[check_direction]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/check_direction=true'
  allow_test_objects = true
  expect_err = 'RayTracingAngularQuadrature does not have direction 1337'
  detail = 'an invalid direction index is requested'
[]


[orthonormal_vector_zero]
  type = 'RunException'
  input = 'errors.i'
  cli_args = 'UserObjects/test/orthonormal_vector_zero=true'
  allow_test_objects = true
  expect_err = 'Vector v has norm close to 0 in orthonormalVector\(\)'
  detail = 'an orthonormal vector is requested from a vector that has a zero norm'
[]

[test]
  type = 'RunApp' # exodiff
  input = 'per_processor_ray_tracing_results_vector_postprocessor.i'
  # TODO: find out a test for this that is not platform dependent so we can do exodiff
  # exodiff = 'per_processor_ray_tracing_results_vector_postprocessor_out.e'
  # min_parallel = 4
  # max_parallel = 4
  # min_threads = 1
  # max_threads = 1
  allow_test_objects = true
  issues = '#16028'
  design = 'PerProcessorRayTracingResultsVectorPostprocessor.md'
  requirement = 'The system shall support the output of information pretaining to the tracing of rays on a per-processor basis.'
[]

Introduction
Use Cases
References
Definitions and Acronyms
Design Stakeholders and Concerns
System Design
Adaptivity
AuxKernels
AuxScalarKernels
AuxVariables
BCs
Bounds
Closures
Components
Constraints
Contact
ControlLogic
Controls
CoupledHeatTransfers
Covariance
DGKernels
Dampers
Debug
DeprecatedBlock
DiracKernels
Distributions
DomainIntegral
Executioner
Executors
FVBCs
FVInterfaceKernels
FVKernels
FluidPropertiesInterrogator
Functions
GeochemicalModelInterrogator
GlobalParams
GrayDiffuseRadiation
HeatStructureMaterials
ICs
InterfaceKernels
Kernels
Materials
Mesh
Modules
MortarGapHeatTransfer
MultiApps
NodalKernels
NodalNormals
Outputs
PorousFlowBasicTHM
PorousFlowFullySaturated
PorousFlowUnsaturated
Postprocessors
Preconditioning
Problem
RayBCs
RayKernels
ReactionNetwork
Reporters
Samplers
ScalarKernels
SpatialReactionSolver
StochasticTools
Surrogates
ThermalContact
TimeDependentReactionSolver
TimeIndependentReactionSolver
Trainers
Transfers
UserObjects
Variables
VectorPostprocessors
XFEM
Requirements Cross - Reference