Visibility – ephemerista.analysis.visibility

The visibility.py module.

This module provides the Visibility class for conducting visibility analyses.

pydantic model ephemerista.analysis.visibility.Pass

The Pass class.

This class models a ground station pass and provides modelled observables.

Fields:

• observables (list[ephemerista.assets.Observables])

• times (list[ephemerista.time.Time])

• window (ephemerista.analysis.visibility.Window)

field observables: list[Observables] [Required]

Observables.

field times: list[Time] [Required]

Time steps for observables.

field window: Window [Required]

The visibility window.

interpolate(time)

Interpolate observables for a given time within the window.

Return type:

Observables

plot()

Plot the observables.

pydantic model ephemerista.analysis.visibility.Visibility

The Visibility analysis.

This analysis finds windows of visibility between ground stations and spacecraft within the provided scenario.

Fields:

• bodies (list[ephemerista.bodies.Origin])

• end_time (ephemerista.time.Time | None)

• scenario (ephemerista.scenarios.Scenario)

• start_time (ephemerista.time.Time | None)

field bodies: list[Origin] = []

field end_time: Time | None = None (alias 'endTime')

field scenario: Scenario [Required]

field start_time: Time | None = None (alias 'startTime')

analyze(ensemble=None)

Run the analysis.

Return type:

VisibilityResults

pydantic model ephemerista.analysis.visibility.VisibilityResults

Results of the Visibility analysis.

Fields:

• passes (dict[uuid.UUID, dict[uuid.UUID, list[ephemerista.analysis.visibility.Pass]]])

• results_type (Literal['visibility'])

• scenario (ephemerista.scenarios.Scenario)

field passes: dict[Annotated[UUID], dict[Annotated[UUID], list[Pass]]] [Required]

field results_type: Literal['visibility'] = 'visibility' (alias 'type')

field scenario: Scenario [Required]

get(observer, target)

Return all passes for a given observer and target combination.

Return type:

list[Pass]

to_dataframe(observer, target)

Convert the results to a Pandas data frame.

Return type:

DataFrame

total_duration(observer, target)

Return the sum of all visibility durations for a given observer and target combination.

Return type:

float

events

pydantic model ephemerista.analysis.visibility.Window

The Window class.

This class models a visibility window.

Fields:

• start (ephemerista.time.Time)

• stop (ephemerista.time.Time)

field start: Time [Required]

Start time of the window.

field stop: Time [Required]

End time of the window.

property duration: float

duration of the window in seconds.

Type:

float