empyrean.Events

class Events(summary, close_approach_starts, close_approach_ends, periapses, impacts, possible_impacts, atmospheric_entries, atmospheric_exits, capture_starts, capture_ends, shadow_entries, shadow_exits, covariance_regime_changes)

Bases: object

All events detected during propagation, grouped by type.

Methods

__init__(summary, close_approach_starts, ...)
count_by_type()	Per-event-type row count, including summary.
select_orbit(orbit_ids)	Return a new Events containing only rows whose orbit_id matches one of the requested IDs.

Attributes

summary
close_approach_starts
close_approach_ends
periapses
impacts
possible_impacts
atmospheric_entries
atmospheric_exits
capture_starts
capture_ends
shadow_entries
shadow_exits
covariance_regime_changes

Parameters:

• summary (EventSummary)

• close_approach_starts (CloseApproachStarts)

• close_approach_ends (CloseApproachEnds)

• periapses (Periapses)

• impacts (Impacts)

• possible_impacts (PossibleImpacts)

• atmospheric_entries (AtmosphericEntries)

• atmospheric_exits (AtmosphericExits)

• capture_starts (CaptureStarts)

• capture_ends (CaptureEnds)

• shadow_entries (ShadowEntries)

• shadow_exits (ShadowExits)

• covariance_regime_changes (CovarianceRegimeChanges)

summary: EventSummary

close_approach_starts: CloseApproachStarts

close_approach_ends: CloseApproachEnds

periapses: Periapses

impacts: Impacts

possible_impacts: PossibleImpacts

atmospheric_entries: AtmosphericEntries

atmospheric_exits: AtmosphericExits

capture_starts: CaptureStarts

capture_ends: CaptureEnds

shadow_entries: ShadowEntries

shadow_exits: ShadowExits

covariance_regime_changes: CovarianceRegimeChanges

count_by_type()

Per-event-type row count, including summary.

Useful as a quick triage view — events.count_by_type() answers “did the propagation produce any close approaches / impacts / captures?” without a multi-line group-by.

Return type:

dict[str, int]

select_orbit(orbit_ids)

Return a new Events containing only rows whose orbit_id matches one of the requested IDs.

Filters every per-event-type table at once, including the summary, so callers don’t have to remember which 13 tables to thread the filter through.

Return type:

Events

Parameters:

orbit_ids (str | Iterable[str])