armi.operators.operator module¶

The standard ARMI operator.

This builds and maintains the interface stack and loops through it for a certain number of cycles with a certain number of timenodes per cycle.

This is analogous to a real reactor operating over some period of time, often from initial startup, through the various cycles, and out to the end of plant life.

Implementation: ARMI controls the time flow of the reactor, by running a sequence of Interfaces at each time step. IMPL_EVOLVING_STATE_0

has_dead_links: True

has_forbidden_dead_links: True

links outgoing: REQ_EVOLVING_STATE

class armi.operators.operator.Operator(cs)[source]¶

Bases: object

Orchestrates an ARMI run, building all the pieces, looping through the interfaces, and manipulating the reactor.

This Standard Operator loops over a user-input number of cycles, each with a user-input number of subcycles (called time nodes). It calls a series of interaction hooks on each of the Interface in the Interface Stack.

Figure 1. The computational flow of the interface hooks in a Standard Operator

Note

The Framework Architecture has some additional narrative on this topic.

Variables

~Operator.cs (CaseSettings object) – Global settings that define the run.
~Operator.cycleNames (list of str) – The name of each cycle. Cycles without a name are None.
~Operator.stepLengths (list of list of float) – A two-tiered list, where primary indices correspond to cycle and secondary indices correspond to the length of each intra-cycle step (in days).
~Operator.cycleLengths (list of float) – The duration of each individual cycle in a run (in days). This is the entire cycle, from startup to startup and includes outage time.
~Operator.burnSteps (list of int) – The number of sub-cycles in each cycle.
~Operator.availabilityFactors (list of float) – The fraction of time in a cycle that the plant is producing power. Note that capacity factor is always less than or equal to this, depending on the power fraction achieved during each cycle. Note that this is not a two-tiered list like stepLengths or powerFractions, because each cycle can have only one availabilityFactor.
~Operator.powerFractions (list of list of float) – A two-tiered list, where primary indices correspond to cycles and secondary indices correspond to the fraction of full rated capacity that the plant achieves during that step of the cycle. Zero power fraction can indicate decay-only cycles.
~Operator.interfaces (list) – The Interface objects that will operate upon the reactor

Constructor for operator.

Parameters: cs (CaseSettings object) – Global settings that define the run.
Raises: OSError – If unable to create the FAST_PATH directory.

inspector¶: alias of armi.operators.settingsValidation.Inspector

property burnSteps¶

property maxBurnSteps¶

property stepLengths¶

property cycleLengths¶

property powerFractions¶

property availabilityFactors¶

property cycleNames¶

property atEOL¶

Return whether we are approaching EOL.

For the standard operator, this will return true when the current cycle is the last cycle (cs[“nCycles”] - 1). Other operators may need to impose different logic.

initializeInterfaces(r)[source]¶

Attach the reactor to the operator and initialize all interfaces.

This does not occur in __init__ so that the ARMI operator can be initialized before a reactor is created, which is useful for summarizing the case information quickly.

Parameters: r (Reactor) – The Reactor object to attach to this Operator.

operate()[source]¶

Run the operation loop.