ObservationGroup

class astro_metadata_translator.ObservationGroup(members, translator_class=None, pedantic=None)

Bases: MutableSequence[ObservationInfo]

A collection of ObservationInfo headers.

Parameters:

• members (iterable of ObservationInfo or dict-like) – ObservationInfo to seed the group membership. If dict-like values are used they will be passed to the ObservationInfo constructor.

• translator_class (MetadataTranslator-class, optional) – If any of the members is not an ObservationInfo, translator class to pass to the ObservationInfo constructor. If None the translation class will be determined automatically.

• pedantic (bool, optional) – If any of the members is not an ObservationInfo, passed to the ObservationInfo constructor to control whether a failed translation is fatal or not. None indicates that the ObservationInfo constructor default should be used.

Methods Summary

extremes()	Return the oldest observation in the group and the newest.
from_simple(simple)	Convert simplified form back to ObservationGroup.
insert(index, value)	S.insert(index, value) -- insert value before index
model_dump_json(**kwargs)	Serialize to JSON using Pydantic-compatible semantics.
model_validate_json(json_data, **kwargs)	Deserialize from JSON using Pydantic-compatible semantics.
newest()	Return the newest observation in the group.
oldest()	Return the oldest observation in the group.
property_values(property)	Return a set of values associated with the specified property.
reverse()	S.reverse() -- reverse IN PLACE
sort([key, reverse])
to_simple()	Convert the group to simplified form.

Methods Documentation

extremes()

Return the oldest observation in the group and the newest.

If there is only one member of the group, the newest and oldest can be the same observation.

Return type:

tuple[ObservationInfo, ObservationInfo]

Returns:

• oldest (ObservationInfo) – Oldest observation.

• newest (ObservationInfo) – Newest observation.

classmethod from_simple(simple)

Convert simplified form back to ObservationGroup.

Parameters:

simple (list of dict) – Object returned by to_simple.

Returns:

group – Reconstructed group.

Return type:

ObservationGroup

insert(index, value)

S.insert(index, value) – insert value before index

Parameters:

• index (int)

• value (ObservationInfo | MutableMapping[str, Any])

Return type:

None

model_dump_json(**kwargs)

Serialize to JSON using Pydantic-compatible semantics.

Parameters:

**kwargs (Any) – Parameters passed to pydantic.BaseModel.model_dump_json.

Returns:

json_data – JSON string representing the model.

Return type:

str

classmethod model_validate_json(json_data, **kwargs)

Deserialize from JSON using Pydantic-compatible semantics.

Parameters:

• json_data (str | bytes | bytearray) – JSON representation of the model.

• **kwargs (Any) – Parameters passed to pydantic.BaseModel.model_validate_json.

Returns:

group – Model constructed from the JSON.

Return type:

ObservationGroup

newest()

Return the newest observation in the group.

Returns:

newest – The newest ObservationInfo in the ObservationGroup.

Return type:

ObservationInfo

oldest()

Return the oldest observation in the group.

Returns:

oldest – The oldest ObservationInfo in the ObservationGroup.

Return type:

ObservationInfo

property_values(property)

Return a set of values associated with the specified property.

Parameters:

property (str) – Property of an ObservationInfo.

Returns:

values – All the distinct values for that property within this group.

Return type:

set

reverse()

S.reverse() – reverse IN PLACE

Return type:

None

sort(key=None, reverse=False)

Parameters:

• key (Callable | None, default: None)

• reverse (bool, default: False)

Return type:

None

to_simple()

Convert the group to simplified form.

Returns:

simple – Simple form is a list containing the simplified dict form of each ObservationInfo.

Return type:

list of dict