eomatch.mu_stac.MatchupCatalogue.add_event

MatchupCatalogue.add_event(event: MatchupEvent) → Item

Add a MatchupEvent to the catalogue, returning its STAC Item.

If the event has a registered matchup_set, its matchups are also added to the catalogue. The event Item carries a related link (matchup:role=matchup) for each matchup Item, so that get_events() can navigate forward from event to matchups without scanning the whole matchup collection.

If an Item with the same ID already exists in the catalogue, it is reused rather than duplicated, and any matchups in event’s matchup_set not already linked to it are added and linked. This matters because stac_id depends only on platforms, collections, and start time — not location — so two searches over different regions (e.g. different ROIs sharing one catalogue) that happen to rediscover the same underlying orbitx crossover produce the same event ID but can carry different matchups; without merging, whichever search adds the event first would silently drop the other’s matchups.