uataq.instruments.Instrument.resolve_group

Instrument.resolve_group(group=None)

Pick which research group’s data to read this instrument from.

Parameters:

group (str | Mapping[str, str] | None) – A group name, used as given; a mapping of instrument name to group name, from which this instrument’s entry is used (instruments the mapping does not name fall back to automatic selection); or None to select automatically.

Returns:

The group name.

Return type:

str

Raises:

InvalidGroupError – If no registered groupspace operates this instrument.

Notes

Automatic selection reads the configured operators of this instrument: the default group when it is one of them, otherwise the sole operator, otherwise the first configured. It is a configuration lookup, not a search of the archive – it does not check whether that group actually holds data for a given time range, and it ignores group_dates. plan_reads() is the time-aware version that uataq.sites.Site.read_data() uses.