armi.reactor.converters.axialExpansionChanger.axialExpansionChanger module

Enable component-wise axial expansion for assemblies and/or a reactor.

armi.reactor.converters.axialExpansionChanger.axialExpansionChanger.getDefaultReferenceAssem(assems)

Return a default reference assembly.

armi.reactor.converters.axialExpansionChanger.axialExpansionChanger.makeAssemsAbleToSnapToUniformMesh(assems, nonUniformAssemFlags, referenceAssembly=None)

Make this set of assemblies aware of the reference mesh so they can stay uniform as they axially expand.

class armi.reactor.converters.axialExpansionChanger.axialExpansionChanger.AxialExpansionChanger(detailedAxialExpansion: bool = False)

Bases: object

Axially expand or contract assemblies or an entire core.

Variables:

• linked (AssemblyAxialLinkage) – establishes object containing axial linkage information

• expansionData (ExpansionData) – establishes object to store and access relevant expansion data

Notes

• Is designed to work with general, vertically oriented, pin-type assembly designs. It is not set up to account for any other assembly type.

• Useful for fuel performance, thermal expansion, reactivity coefficients, etc.

Build an axial expansion converter.

Parameters:

detailedAxialExpansion (bool, optional) – A boolean to indicate whether or not detailedAxialExpansion is to be utilized.

linked: Optional[AssemblyAxialLinkage]

expansionData: Optional[ExpansionData]

classmethod expandColdDimsToHot(assems: list, isDetailedAxialExpansion: bool, referenceAssembly=None)

Expand BOL assemblies, resolve disjoint axial mesh (if needed), and update block BOL heights.

Parameters:

• assems (list[Assembly]) – list of assemblies to be thermally expanded

• isDetailedAxialExpansion (bool) – If False, assemblies will be forced to conform to the reference mesh after expansion

• referenceAssembly (Assembly, optional) – Assembly whose mesh other meshes will conform to if isDetailedAxialExpansion is False. If not provided, will assume the finest mesh assembly which is typically fuel.

Notes

Calling this method will result in an increase in mass via applyColdHeightMassIncrease!

See also

armi.reactor.converters.axialExpansionChanger.axialExpansionChanger.AxialExpansionChanger.applyColdHeightMassIncrease()

performPrescribedAxialExpansion(a: Assembly, components: list, percents: list, setFuel=True)

Perform axial expansion/contraction of an assembly given prescribed expansion percentages.

Parameters:

• a (Assembly) – ARMI assembly to be changed

• components (list[Component]) – list of Components to be expanded

• percents (list[float]) – list of expansion percentages for each component listed in components

• setFuel (boolean, optional) – Boolean to determine whether or not fuel blocks should have their target components set This is useful when target components within a fuel block need to be determined on-the-fly.

Notes

• percents may be positive (expansion) or negative (contraction)

performThermalAxialExpansion(a: Assembly, tempGrid: list, tempField: list, setFuel: bool = True, expandFromTinputToThot: bool = False)

Perform thermal expansion/contraction for an assembly given an axial temperature grid and field.

Parameters:

• a (Assembly) – ARMI assembly to be changed

• tempGrid (float, list) – Axial temperature grid (in cm) (i.e., physical locations where temp is stored)

• tempField (float, list) – Temperature values (in C) along grid

• setFuel (boolean, optional) – Boolean to determine whether or not fuel blocks should have their target components set This is useful when target components within a fuel block need to be determined on-the-fly.

• expandFromTinputToThot (bool) – determines if thermal expansion factors should be calculated from c.inputTemperatureInC to c.temperatureInC (True) or some other reference temperature and c.temperatureInC (False)

reset()

setAssembly(a: Assembly, setFuel=True, expandFromTinputToThot=False)

Set the armi assembly to be changed and init expansion data class for assembly.

Parameters:

a (Assembly) – ARMI assembly to be changed

setFuelboolean, optional

Boolean to determine whether or not fuel blocks should have their target components set This is useful when target components within a fuel block need to be determined on-the-fly.

expandFromTinputToThot: bool

determines if thermal expansion factors should be calculated from c.inputTemperatureInC to c.temperatureInC (True) or some other reference temperature and c.temperatureInC (False)

Notes

When considering thermal expansion, if there is an axial temperature distribution on the assembly, the axial expansion methodology will NOT perfectly preserve mass. The magnitude of the gradient of the temperature distribution is the primary factor in determining the cumulative loss of mass conservation.

applyColdHeightMassIncrease()

Increase component mass because they are declared at cold dims.

Notes

A cold 1 cm tall component will have more mass that a component with the same mass/length as a component with a hot height of 1 cm. This should be called when the setting inputHeightsConsideredHot is used. This adjusts the expansion factor applied during applyMaterialMassFracsToNumberDensities.

axiallyExpandAssembly()

Utilizes assembly linkage to do axial expansion.

manageCoreMesh(r)

Manage core mesh post assembly-level expansion.

Parameters:

r (Reactor) – ARMI reactor to have mesh modified

Notes

• if no detailedAxialExpansion, then do “cheap” approach to uniformMesh converter.

• update average core mesh values with call to r.core.updateAxialMesh()

• oldMesh will be None during initial core construction at processLoading as it has not yet been set.