ConfigIR

class lsst.pipe.base.pipelineIR.ConfigIR(python: str | None = None, dataId: dict | None = None, file: list[str] = <factory>, rest: dict = <factory>)

Bases: object

Intermediate representation of configurations read from a pipeline yaml file.

Attributes Summary

dataId

A dataId that is used to constrain these config overrides to only quanta with matching dataIds.

python

A string of python code that is used to modify a configuration.

Methods Summary

formatted(parameters)

Return a new ConfigIR object that is formatted according to the specified parameters.

maybe_merge(other_config)

Merge another instance of a ConfigIR into this instance if possible.

to_primitives()

Convert to a representation used in yaml serialization.

Attributes Documentation

dataId: dict | None = None

A dataId that is used to constrain these config overrides to only quanta with matching dataIds. This field can be None if there is no constraint. This is currently an unimplemented feature, and is placed here for future use.

python: str | None = None

A string of python code that is used to modify a configuration. This can also be None if there are no modifications to do.

Methods Documentation

formatted(parameters: ParametersIR) ConfigIR

Return a new ConfigIR object that is formatted according to the specified parameters.

Parameters:
parametersParametersIR

Object that contains variable mappings used in substitution.

Returns:
configConfigIR

A new ConfigIR object formatted with the input parameters.

maybe_merge(other_config: ConfigIR) Generator[ConfigIR, None, None]

Merge another instance of a ConfigIR into this instance if possible. This function returns a generator that is either self if the configs were merged, or self, and other_config if that could not be merged.

Parameters:
other_configConfigIR

An instance of ConfigIR to merge into this instance.

Yields:
GeneratorConfigIR

A generator containing either self, or self and other_config if the configs could be merged or not respectively.

to_primitives() dict[str, str | dict | list[str]]

Convert to a representation used in yaml serialization.