keplemon.events

events

CloseApproach

distance instance-attribute

Distance between the two bodies in kilometers

epoch instance-attribute

UTC epoch of the close approach

primary_id instance-attribute

Satellite ID of the primary body in the close approach

secondary_id instance-attribute

Satellite ID of the secondary body in the close approach

CloseApproachReport

Parameters:

Name	Type	Description	Default
start	Epoch	CA screening start time	required
end	Epoch	CA screening end time	required
distance_threshold	float	Distance threshold for CA screening in kilometers	required

close_approaches instance-attribute

List of close approaches found during the screening

FieldOfViewCandidate

direction instance-attribute

Measured direction to the candidate satellite in the sensor's topocentric frame

satellite_id instance-attribute

ID of the candidate satellite

FieldOfViewReport

candidates instance-attribute

List of candidate satellites within the field of view

epoch instance-attribute

UTC epoch of the field of view report

fov_angle instance-attribute

Field of view angle of the sensor in degrees

reference_frame instance-attribute

Reference frame of the output direction elements

sensor_direction instance-attribute

Direction of the sensor in the observatory's topocentric frame

sensor_position instance-attribute

TEME position of the sensor in the observatory's topocentric frame in kilometers

HorizonAccess

end instance-attribute

State of the satellite at the end of the access period

observatory_id instance-attribute

ID of the observatory for which the access is calculated

satellite_id instance-attribute

ID of the satellite for which the access is calculated

start instance-attribute

State of the satellite at the start of the access period

HorizonAccessReport

Parameters:

Name	Type	Description	Default
start	Epoch	UTC epoch of the start of the access report	required
end	Epoch	UTC epoch of the end of the access report	required
min_elevation	float	Minimum elevation angle for access in degrees	required
min_duration	TimeSpan	Minimum duration of access	required

accesses instance-attribute

List of horizon accesses found during the screening

duration_threshold instance-attribute

Minimum duration of a valid access

elevation_threshold instance-attribute

Minimum elevation angle for access in degrees

end instance-attribute

UTC epoch of the end of the access report

start instance-attribute

UTC epoch of the start of the access report

ManeuverEvent

Represents a detected maneuver for a satellite.

delta_v instance-attribute

Delta-V vector in RIC (radial, in-track, cross-track) frame in meters per second

epoch instance-attribute

UTC epoch of the detected maneuver

satellite_id instance-attribute

Satellite ID of the maneuvering body

ManeuverReport

Parameters:

Name	Type	Description	Default
start	Epoch	Maneuver detection start time	required
end	Epoch	Maneuver detection end time	required
distance_threshold	float	Distance threshold for matching in kilometers	required
velocity_threshold	float	Velocity threshold for maneuver detection in meters per second	required

distance_threshold instance-attribute

Distance threshold for matching in kilometers

end instance-attribute

UTC epoch of the end of the maneuver report

maneuvers instance-attribute

List of detected maneuvers

start instance-attribute

UTC epoch of the start of the maneuver report

velocity_threshold instance-attribute

Velocity threshold for maneuver detection in meters per second

ProximityEvent

Represents a time period where two satellites remain within a distance threshold.

end_epoch instance-attribute

UTC epoch of the end of the proximity event

maximum_distance instance-attribute

Maximum distance between the two bodies during the event in kilometers

minimum_distance instance-attribute

Minimum distance between the two bodies during the event in kilometers

primary_id instance-attribute

Satellite ID of the primary body

secondary_id instance-attribute

Satellite ID of the secondary body

start_epoch instance-attribute

UTC epoch of the start of the proximity event

ProximityReport

Parameters:

Name	Type	Description	Default
start	Epoch	Proximity screening start time	required
end	Epoch	Proximity screening end time	required
distance_threshold	float	Distance threshold for proximity screening in kilometers	required

distance_threshold instance-attribute

Distance threshold for proximity screening in kilometers

end instance-attribute

UTC epoch of the end of the proximity report

events instance-attribute

List of proximity events found during the screening

start instance-attribute

UTC epoch of the start of the proximity report

UCTValidityReport

Report containing UCT validity analysis results.

This report provides information about a UCT's validity based on: - Observation associations with the UCT - Proximity events with approved satellites (possible cross-tags) - Close approaches with approved satellites (possible maneuver origins) - Observability status during the analysis window

associations instance-attribute

List of observation associations where the UCT matched orphan observations

observability instance-attribute

Observability status of the UCT during the analysis window

possible_cross_tags instance-attribute

List of proximity events with approved satellites that could indicate cross-tagging

possible_origins instance-attribute

List of close approaches with approved satellites that could indicate maneuver origins

satellite_id instance-attribute

ID of the UCT satellite being analyzed

validity instance-attribute

Validity assessment based on the analysis results