armi.reactor.tests.test_components module

Tests functionalities of components within ARMI.

class armi.reactor.tests.test_components.MockCompositionDependentExpander

Bases: Material

Dummy material that has a composition-dependent thermal expansion coefficient.

linearExpansionPercent(Tk: float = None, Tc: float = None) → float

Composition-dependent linear expansion coefficient.

Parameters:

• Tk (float, optional) – Temperature in Kelvin.

• Tc (float, optional) – Temperature in Celsius.

density(Tk: float = None, Tc: float = None) → float

Return density that preserves mass when thermally expanded in 3D (in g/cm^3).

Notes

Since refDens is specified at the material-dep reference case, we don’t need to specify the reference temperature. It is already consistent with linearExpansion Percent. - p*(dp/p(T) + 1) =p*( p + dp(T) )/p = p + dp(T) = p(T) - dp/p = (1-(1 + dL/L)**3)/(1 + dL/L)**3

class armi.reactor.tests.test_components.TestComponentFactory(methodName='runTest')

Bases: TestCase

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

getCircleVoidDict()

getCircleFuelDict()

test_factory()

Creating and verifying void and fuel components.

Test Case: Example void and fuel components are initialized. T_ARMI_COMP_DEF0

signature: test_factory requirements: R_ARMI_COMP_DEF

test_componentInitializationAndDuplication()

Initialize and duplicate a component, veifying the parameters.

Test Case: Verify the parameters of an initialized component. T_ARMI_COMP_DEF1

signature: test_componentInitializationAndDuplication requirements: R_ARMI_COMP_DEF

test_factoryBadShapeName()

test_invalidCoolantComponentAssignment()

class armi.reactor.tests.test_components.TestGeneralComponents(methodName='runTest')

Bases: TestCase

Base test for all individual component tests.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Component

componentMaterial = 'HT9'

componentDims = {'Thot': 25.0, 'Tinput': 25.0}

class armi.reactor.tests.test_components.TestComponentNDens(methodName='runTest')

Bases: TestGeneralComponents

Test component number density setting.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Circle

componentDims = {'Thot': 25.0, 'Tinput': 25.0, 'id': 0.0, 'od': 0.5}

test_setNumberDensity()

Test setting a single number density.

Test Case: Users can set Component number density. T_ARMI_COMP_NUCLIDE_FRACS0

signature: test_setNumberDensity requirements: R_ARMI_COMP_NUCLIDE_FRACS

test_setNumberDensities()

Test setting multiple number densities.

Test Case: Users can set Component number densities. T_ARMI_COMP_NUCLIDE_FRACS1

signature: test_setNumberDensities requirements: R_ARMI_COMP_NUCLIDE_FRACS

test_setNumberDensitiesWithExpansion()

test_changeNDensByFactor()

Test the ability to change just the component number densities.

test_changeNDensByFactorWithExtraParams()

Test scaling other parameters when component number density is scaled.

class armi.reactor.tests.test_components.TestComponent(methodName='runTest')

Bases: TestGeneralComponents

Test the base component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Component

test_initializeComponentMaterial()

Creating component with single material.

Test Case: Components are made of one material. T_ARMI_COMP_1MAT0

signature: test_initializeComponentMaterial requirements: R_ARMI_COMP_1MAT

test_solid_material()

Determine if material is solid.

Test Case: Components have material properties. T_ARMI_COMP_MAT

signature: test_solid_material requirements: R_ARMI_COMP_MAT

class armi.reactor.tests.test_components.TestNullComponent(methodName='runTest')

Bases: TestGeneralComponents

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of NullComponent

test_cmp()

Test null component.

test_nonzero()

test_getDimension()

Test getting empty component.

Test Case: Retrieve a null dimension. T_ARMI_COMP_DIMS0

signature: test_getDimension requirements: R_ARMI_COMP_DIMS

class armi.reactor.tests.test_components.TestUnshapedComponent(methodName='runTest')

Bases: TestGeneralComponents

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of UnshapedComponent

componentMaterial = 'HT9'

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'area': 3.141592653589793}

test_getComponentArea()

test_getBoundingCircleOuterDiameter()

test_component_less_than()

Ensure that comparisons between components properly reference bounding circle outer diameter.

Test Case: Order components by their outermost diameter T_ARMI_COMP_ORDER

signature: test_component_less_than requirements: R_ARMI_COMP_ORDER

test_fromComponent()

class armi.reactor.tests.test_components.TestShapedComponent(methodName='runTest')

Bases: TestGeneralComponents

Abstract class for all shaped components.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_preserveMassDuringThermalExpansion()

Test that when we thermally expand any arbitrary shape, mass is conserved.

test_volumeAfterClearCache()

Test volume after cache has been cleared.

Test Case: Clear cache after a dimensions updated. T_ARMI_COMP_VOL0

signature: test_volumeAfterClearCache requirements: R_ARMI_COMP_VOL

test_densityConsistent()

Testing the Component matches quick hand calc.

test_density()

Testing the Component density gets the correct 3D material density.

class armi.reactor.tests.test_components.TestDerivedShape(methodName='runTest')

Bases: TestShapedComponent

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of DerivedShape

componentMaterial = 'Sodium'

componentDims = {'Thot': 400.0, 'Tinput': 25.0, 'area': 1.0}

test_getBoundingCircleOuterDiameter()

test_computeVolume()

Test the computeVolume method on a number of components in a block.

Test Case: Compute the volume of a DerivedShape inside solid shapes. T_ARMI_COMP_FLUID

signature: test_computeVolume requirements: R_ARMI_COMP_FLUID

class armi.reactor.tests.test_components.TestDerivedShapeGetArea(methodName='runTest')

Bases: TestCase

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_getAreaColdTrue()

Prove that the DerivedShape.getArea() works at cold=True.

class armi.reactor.tests.test_components.TestComponentSort(methodName='runTest')

Bases: TestCase

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_sorting()

Test that components are sorted as expected.

class armi.reactor.tests.test_components.TestCircle(methodName='runTest')

Bases: TestShapedComponent

Test circle shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Circle

componentDims = {'Thot': 25.0, 'Tinput': 25.0, 'id': 5.0, 'mult': 1.5, 'od': 10}

test_getThermExpansFactorConsMassLinExpanPerc()

Test that when ARMI thermally expands a circle, mass is conserved.

Test Case: Calculate thermal expansion. T_ARMI_COMP_EXPANSION0

signature: test_getThermExpansFactorConsMassLinExpanPerc requirements: R_ARMI_COMP_EXPANSION

test_getDimension()

Test getting component dimension at specific temperature.

Test Case: Retrieve a dimension at a temperature. T_ARMI_COMP_DIMS1

signature: test_getDimension requirements: R_ARMI_COMP_DIMS

Test Case: Calculate thermal expansion. T_ARMI_COMP_EXPANSION1

signature: test_getDimension requirements: R_ARMI_COMP_EXPANSION

test_thermallyExpands()

Test that ARMI can thermally expands a circle.

test_getBoundingCircleOuterDiameter()

test_getCircleInnerDiameter()

test_dimensionThermallyExpands()

test_getArea()

Calculate area of circle.

Test Case: Calculate area of circle. T_ARMI_COMP_VOL1

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_componentInteractionsLinkingByDimensions()

Tests linking of Components by dimensions.

The component gap, representing the fuel-clad gap filled with Void, is defined with dimensions that depend on the fuel outer diameter and clad inner diameter. The resolveLinkedDims() method links the gap dimensions appropriately when the Component is constructed, and the test shows the area of the gap is calculated correctly based on the thermally-expanded dimensions of the fuel and clad Components.

Test Case: Show the dimensions of a liquid Component can be defined to depend on the solid Components that bound it. T_ARMI_COMP_FLUID1

signature: test_componentInteractionsLinkingByDimensions requirements: R_ARMI_COMP_FLUID

test_badComponentName()

This shows that resolveLinkedDims cannot support names with periods in them.

test_componentInteractionsLinkingBySubtraction()

Tests linking of components by subtraction.

test_getNumberDensities()

Test that demonstrates that number densities can be retrieved on from component.

test_changeNumberDensities()

Test that demonstates that the number densities on a component can be modified.

test_fuelMass()

test_theoreticalDensitySetter()

Ensure only fraction theoretical densities are supported.

class armi.reactor.tests.test_components.TestComponentExpansion(methodName='runTest')

Bases: TestCase

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

tCold = 20

tWarm = 50

tHot = 500

coldOuterDiameter = 1.0

test_HT9Expansion()

test_UZrExpansion()

test_B4CExpansion()

runExpansionTests(mat: str, isotope: str)

componentMassIndependentOfInputTemp(mat: str)

expansionConservationHotHeightDefined(mat: str, isotope: str)

Demonstrate tutorial for how to expand and relationships conserved at during expansion.

Notes

• height taken as hot height and show how quantity is conserved with inputHeightsConsideredHot = True (the default)

expansionConservationColdHeightDefined(mat: str)

Demonstrate that material is conserved at during expansion.

Notes

• height taken as cold height and show how quantity is conserved with inputHeightsConsideredHot = False

class armi.reactor.tests.test_components.TestTriangle(methodName='runTest')

Bases: TestShapedComponent

Test triangle shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Triangle

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'base': 3.0, 'height': 2.0, 'mult': 30}

test_getArea()

Calculate area of triangle.

Test Case: Calculate area of triangle. T_ARMI_COMP_VOL2

signature: test_getArea requirements: R_ARMI_COMP_VOL

Test Case: Triangle shaped component T_ARMI_COMP_SHAPES1

signature: test_getArea requirements: R_ARMI_COMP_SHAPES

test_thermallyExpands()

Test that ARMI can thermally expands a triangle.

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestRectangle(methodName='runTest')

Bases: TestShapedComponent

Test rectangle shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Rectangle

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'lengthInner': 4.0, 'lengthOuter': 6.0, 'mult': 2, 'widthInner': 3.0, 'widthOuter': 5.0}

test_negativeArea()

test_getBoundingCircleOuterDiameter()

Get outer diameter bounding circle.

Test Case: Rectangle shaped component T_ARMI_COMP_SHAPES2

signature: test_getBoundingCircleOuterDiameter requirements: R_ARMI_COMP_SHAPES

test_getCircleInnerDiameter()

test_getArea()

Calculate area of rectangle.

Test Case: Calculate area of rectangle. T_ARMI_COMP_VOL3

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

Test that ARMI can thermally expands a rectangle.

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestSolidRectangle(methodName='runTest')

Bases: TestShapedComponent

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of SolidRectangle

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'lengthOuter': 5.0, 'mult': 1, 'widthOuter': 5.0}

test_getBoundingCircleOuterDiameter()

Test get bounding circle of the outer diameter.

test_getArea()

Calculate area of solid rectangle.

Test Case: Calculate area of solid rectangle. T_ARMI_COMP_VOL4

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

Test that ARMI can thermally expands a solid rectangle.

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestSquare(methodName='runTest')

Bases: TestShapedComponent

Test square shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Square

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'mult': 1, 'widthInner': 2.0, 'widthOuter': 3.0}

test_negativeArea()

test_getBoundingCircleOuterDiameter()

Get bounding circle outer diameter.

Test Case: Square shaped component T_ARMI_COMP_SHAPES3

signature: test_getBoundingCircleOuterDiameter requirements: R_ARMI_COMP_SHAPES

test_getCircleInnerDiameter()

test_getArea()

Calculate area of square.

Test Case: Calculate area of square. T_ARMI_COMP_VOL5

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

Test that ARMI can thermally expands a square.

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestCube(methodName='runTest')

Bases: TestShapedComponent

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Cube

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'heightInner': 10.0, 'heightOuter': 20.0, 'lengthInner': 4.0, 'lengthOuter': 5.0, 'mult': 2, 'widthInner': 3.0, 'widthOuter': 5.0}

test_negativeVolume()

test_getVolume()

Calculate area of cube.

Test Case: Calculate area of cube. T_ARMI_COMP_VOL6

signature: test_getVolume requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

Test that ARMI can thermally expands a cube.

class armi.reactor.tests.test_components.TestHexagon(methodName='runTest')

Bases: TestShapedComponent

Test hexagon shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Hexagon

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'ip': 5.0, 'mult': 1, 'op': 10.0}

test_getPerimeter()

Get perimeter of hexagon.

Test Case: Hexagon shaped component T_ARMI_COMP_SHAPES4

signature: test_getPerimeter requirements: R_ARMI_COMP_SHAPES

test_getBoundingCircleOuterDiameter()

test_getCircleInnerDiameter()

test_getArea()

Calculate area of hexagon.

Test Case: Calculate area of hexagon. T_ARMI_COMP_VOL7

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

Test that ARMI can thermally expands a hexagon.

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestHoledHexagon(methodName='runTest')

Bases: TestShapedComponent

Test holed hexagon shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of HoledHexagon

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'holeOD': 3.6, 'mult': 1.0, 'nHoles': 7, 'op': 16.5}

test_getBoundingCircleOuterDiameter()

test_getCircleInnerDiameter()

test_getArea()

Calculate area of holed hexagon.

Test Case: Calculate area of holed hexagon. T_ARMI_COMP_VOL8

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

Test that ARMI can thermally expands a holed hexagon.

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestHexHoledCircle(methodName='runTest')

Bases: TestShapedComponent

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of HexHoledCircle

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'holeOP': 3.6, 'mult': 1.0, 'od': 16.5}

test_getCircleInnerDiameter()

test_getArea()

Calculate area of hex holed circle.

Test Case: Calculate area of hex holed circle. T_ARMI_COMP_VOL9

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

Test that ARMI can thermally expands a holed hexagon.

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestHoledRectangle(methodName='runTest')

Bases: TestShapedComponent

Tests HoledRectangle, and provides much support for HoledSquare test.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of HoledRectangle

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'holeOD': 3.6, 'lengthOuter': 16.0, 'mult': 1.0, 'widthOuter': 10.0}

dimsToTestExpansion = ['lengthOuter', 'widthOuter', 'holeOD', 'mult']

setClassDims()

test_getBoundingCircleOuterDiameter()

test_getCircleInnerDiameter()

test_getArea()

Calculate area of holed rectangle.

Test Case: Calculate area of holed rectangle. T_ARMI_COMP_VOL10

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

test_dimensionThermallyExpands()

class armi.reactor.tests.test_components.TestHoledSquare(methodName='runTest')

Bases: TestHoledRectangle

Test holed square shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of HoledSquare

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'holeOD': 3.6, 'mult': 1.0, 'widthOuter': 16.0}

dimsToTestExpansion = ['widthOuter', 'holeOD', 'mult']

setClassDims()

test_thermallyExpands()

test_getCircleInnerDiameter()

class armi.reactor.tests.test_components.TestHelix(methodName='runTest')

Bases: TestShapedComponent

Test helix shaped component.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Helix

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'axialPitch': 1.0, 'helixDiameter': 2.0, 'id': 0.1, 'mult': 1.5, 'od': 0.25}

test_getBoundingCircleOuterDiameter()

test_getCircleInnerDiameter()

test_getArea()

Calculate area of helix.

Test Case: Calculate area of helix. T_ARMI_COMP_VOL11

signature: test_getArea requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

test_dimensionThermallyExpands()

test_validParameters()

Testing the Helix class performs as expected with various inputs.

class armi.reactor.tests.test_components.TestSphere(methodName='runTest')

Bases: TestShapedComponent

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of Sphere

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'id': 0.0, 'mult': 3, 'od': 1.0}

test_getVolume()

Calculate area of sphere.

Test Case: Calculate volume of sphere. T_ARMI_COMP_VOL12

signature: test_getVolume requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

class armi.reactor.tests.test_components.TestRadialSegment(methodName='runTest')

Bases: TestShapedComponent

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of RadialSegment

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'height': 160, 'inner_radius': 110, 'mult': 1, 'outer_radius': 170}

test_getVolume()

test_thermallyExpands()

test_getBoundingCircleOuterDiameter()

class armi.reactor.tests.test_components.TestDifferentialRadialSegment(methodName='runTest')

Bases: TestShapedComponent

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

componentCls

alias of DifferentialRadialSegment

componentDims = {'Thot': 430.0, 'Tinput': 25.0, 'height': 160, 'inner_axial': 60, 'inner_radius': 110, 'radius_differential': 60}

test_getVolume()

test_updateDims()

Test Update dimensions.

Test Case: Dimensions can be updated. T_ARMI_COMP_VOL13

signature: test_updateDims requirements: R_ARMI_COMP_VOL

test_thermallyExpands()

test_getBoundingCircleOuterDiameter()

class armi.reactor.tests.test_components.TestMaterialAdjustments(methodName='runTest')

Bases: TestCase

Tests to make sure enrichment and mass fractions can be adjusted properly.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_setMassFrac()

Make sure we can set a mass fraction properly.

test_setMassFracOnComponentMaterial()

Checks for valid and invalid mass fraction assignments on a component’s material.

test_adjustMassFrac_invalid()

test_adjustMassFrac_U235()

test_adjustMassFrac_U()

test_adjustMassFrac_clear_ZR()

test_adjustMassFrac_set_ZR()

test_adjustMassFrac_leave_same()

test_adjustMassEnrichment()

test_getEnrichment()

test_finalizeLoadDBAdjustsTD()

Ensure component is fully loaded through finalize methods.

class armi.reactor.tests.test_components.TestPinQuantities(methodName='runTest')

Bases: TestCase

Test methods that involve retrieval of pin quantities.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_getPinMgFluxes()

Test proper retrieval of pin multigroup flux for fuel component.