armi.reactor.zones module

A Zone object is a collection of locations in the Core. A Zones object is a collection of Zone objects. Together, they are used to conceptually divide the Core for analysis.

class armi.reactor.zones.Zone(name: str, locations: typing.Optional[typing.List] = None, zoneType: type = <class 'armi.reactor.assemblies.Assembly'>)

Bases: object

A group of locations in the Core, used to divide it up for analysis. Each location represents an Assembly or a Block.

VALID_TYPES = (<class 'armi.reactor.assemblies.Assembly'>, <class 'armi.reactor.blocks.Block'>)

addLoc(loc: str) → None

Adds the location to this Zone.

Parameters

loc (str) – Location within the Core.

Notes

This method does not validate that the location given is somehow “valid”. We are not doing any reverse lookups in the Reactor to prove that the type or location is valid. Because this would require heavier computation, and would add some chicken-and-the-egg problems into instantiating a new Reactor.

Return type

None

removeLoc(loc: str) → None

Removes the location from this Zone.

Parameters

loc (str) – Location within the Core.

Notes

This method does not validate that the location given is somehow “valid”. We are not doing any reverse lookups in the Reactor to prove that the type or location is valid. Because this would require heavier computation, and would add some chicken-and-the-egg problems into instantiating a new Reactor.

Return type

None

addLocs(locs: List) → None

Adds the locations to this Zone.

Parameters

items (list) – List of str objects

removeLocs(locs: List) → None

Removes the locations from this Zone.

Parameters

items (list) – List of str objects

addItem(item: Union[armi.reactor.assemblies.Assembly, armi.reactor.blocks.Block]) → None

Adds the location of an Assembly or Block to a zone.

Parameters

item (Assembly or Block) – A single item with Core location (Assembly or Block)

removeItem(item: Union[armi.reactor.assemblies.Assembly, armi.reactor.blocks.Block]) → None

Removes the location of an Assembly or Block from a zone.

Parameters

item (Assembly or Block) – A single item with Core location (Assembly or Block)

addItems(items: List) → None

Adds the locations of a list of Assemblies or Blocks to a zone.

Parameters

items (list) – List of Assembly/Block objects

removeItems(items: List) → None

Removes the locations of a list of Assemblies or Blocks from a zone.

Parameters

items (list) – List of Assembly/Block objects

class armi.reactor.zones.Zones

Bases: object

Collection of Zone objects.

Build a Zones object.

property names: List

Ordered names of contained zones.

Returns

Alphabetical collection of Zone names

Return type

list

addZone(zone: armi.reactor.zones.Zone) → None

Add a zone to the collection.

Parameters

zone (Zone) – A new Zone to add to this collection.

Return type

None

addZones(zones: List) → None

Add multiple zones to the collection, then validate that this Zones collection still make sense.

Parameters

zones (List (or Zones)) – A multiple new Zone objects to add to this collection.

Return type

None

removeZone(name: str) → None

Delete a zone by name.

Parameters

name (str) – Name of zone to remove

Return type

None

removeZones(names: List) → None

Delete multiple zones by name.

Parameters

names (List (or names)) – Multiple Zone names to remove from this collection.

Return type

None

checkDuplicates() → None

Validate that the the zones are mutually exclusive.

That is, make sure that no item appears in more than one Zone.

Return type

None

getZoneLocations(zoneNames: List) → Set

Get the location labels of a particular (or a few) zone(s).

Parameters

zoneNames (str, or list) – the zone name or list of names

Returns

zoneLocs – List of location labels of this/these zone(s)

Return type

set

getAllLocations() → Set

Return all locations across every Zone in this Zones object.

Returns

A combination set of all locations, from every Zone

Return type

set

findZoneItIsIn(a: Union[armi.reactor.assemblies.Assembly, armi.reactor.blocks.Block]) → Optional[armi.reactor.zones.Zone]

Return the zone object that this Assembly/Block is in.

Parameters

a (Assembly or Block) – The item to locate

Returns

zone

Return type

Zone object that the input item resides in.

sortZones(reverse=False) → None

Sorts the Zone objects alphabetically.

Parameters

reverse (bool, optional) – Whether to sort in reverse order, by default False

summary() → None

Summarize the zone defintions clearly, and in a way that can be copy/pasted back into a settings file under “zoneDefinitions”, if the user wants to manually re-use these zones later.

Examples

zoneDefinitions: - ring-1: 001-001 - ring-2: 002-001, 002-002 - ring-3: 003-001, 003-002, 003-003