armi.settings.caseSettings module

This defines a Settings object that acts mostly like a dictionary. It is meant to be treated mostly like a singleton, where each custom ARMI object has access to it. It contains global user settings like the core power level, the input file names, the number of cycles to run, the run type, the environment setup, and hundreds of other things.

A settings object can be saved as or loaded from an XML file. The ARMI GUI is designed to create this settings file, which is then loaded by an ARMI process on the cluster.

A master case settings is created as masterCs

class armi.settings.caseSettings.Settings(fName=None)

Bases: object

A container for global settings, such as case title, power level, and many run options.

It is accessible to most ARMI objects through self.cs (for ‘Case Settings’). It acts largely as a dictionary, and setting values are accessed by keys.

The settings object has a 1-to-1 correspondence with the ARMI settings input file. This file may be created by hand or by the GUI in submitter.py.

NOTE: The actual settings in any instance of this class are immutable.

Instantiate a settings object

Parameters

fName (str, optional) – Path to a valid yaml settings file that will be loaded

instance = <Settings name:armiRun total:148 altered:28>

defaultCaseTitle = 'armi'

_failOnLoad = None

This is state information.

The command line can take settings, which override a value in the current settings file; however, if the settings file is listed after a setting value, the setting from the settings file will be used rather than the one explicitly provided by the user on the command line. Therefore, _failOnLoad is used to prevent this from happening.

property inputDirectory

getter for settings file path

property caseTitle

getter for settings case title

property environmentSettings

getter for environment settings

getSetting(key, default=None)

Return a copy of an actual Setting object, instead of just its value.

NOTE: This is used very rarely, try to organize your code to only need a Setting value.

keys()

values()

items()

duplicate()

return a duplicate copy of this settings object

revertToDefaults()

Sets every setting back to its default value

failOnLoad()

This method is used to force loading a file to fail.

After command line processing of settings has begun, the settings should be fully defined. If the settings are loaded

loadFromInputFile(fName, handleInvalids=True, setPath=True)

Read in settings from an input file.

Supports YAML and two XML formats, the newer (tags are the key, etc.) and the former (tags are the type, etc.). If the extension is xml, it assumes XML format. Otherwise, YAML is assumed.

Passes the reader back out in case you want to know something about how the reading went like for knowing if a file contained deprecated settings, etc.

_prepToRead(fName)

loadFromString(string, handleInvalids=True)

Read in settings from a string.

Supports two xml formats, the newer (tags are the key, etc.) and the former (tags are the type, etc.)

Passes the reader back out in case you want to know something about how the reading went like for knowing if a file contained deprecated settings, etc.

_applyReadSettings(path=None)

initLogVerbosity()

Central location to init logging verbosity

writeToXMLFile(fName, style='short')

Write out settings to an xml file

Parameters

• fName (str) – the file to write to

• style (str) – the method of XML output to be used when creating the xml file for the current state of settings

writeToYamlFile(fName, style='short')

Write settings to a yaml file.

Notes

This resets the current CS’s path to the newly written path.

Parameters

• fName (str) – the file to write to

• style (str) – the method of output to be used when creating the file for the current state of settings

writeToYamlStream(stream, style='short')

Write settings in yaml format to an arbitrary stream.

updateEnvironmentSettingsFrom(otherCs)

Updates the environment settings in this object based on some other cs (from the GUI, most likely)

Parameters

• otherCs (Settings object) – A cs object that environment settings will be inherited from.

• enables users to run tests with their environment rather than the reference environment (This) –

modified(caseTitle=None, newSettings=None)

Return a new Settings object containing the provided modifications.

setModuleVerbosities(force=False)

Attempt to grab the module-level logger verbosities from the settings file, and then set their log levels (verbosities).

NOTE: This method is only meant to be called once per run.

Parameters

force (bool, optional) – If force is False, don’t overwrite the log verbosities if the logger already exists. IF this needs to be used mid-run, force=False is safer.