struct

Kozai::Illumination::PassIllumination

Inherits Struct < Value < Object

What the illumination of one pass looks like.

All three interval lists are in UTC and in order, and any of them can be empty. They are lists rather than single spans because a pass need not contain exactly one of anything: a satellite in a high orbit can be above the horizon for hours and cross the shadow more than once, which is the same reason Passes.narrow does not assume a single hump.

Constructors

new(sunlit : Array(Tuple(Time, Time)), dark : Array(Tuple(Time, Time)), visible : Array(Tuple(Time, Time)), sun_elevation : Float64, phase_angle : Float64, shadow : Shadow)
Source

Instance methods

category

How the pass reads.

NOTE: a pass can fail both tests at once — a daylight pass with the satellite eclipsed as well. The station's own sky is named first, because it is the condition the observer can check by looking up.

Source
dark

When the Sun is below the station's twilight threshold.

Source
phase_angle

Sun–satellite–observer angle at culmination, degrees.

Small means the satellite is nearly back-lit from the observer's point of view and looks its brightest; near 180 it is a thin crescent. This is reported rather than turned into a magnitude, because a magnitude needs the satellite's own brightness and size, and an element set carries neither.

Source
shadow

Whether the satellite is in shadow at culmination.

Source
sun_elevation

The Sun's elevation at the station at culmination, degrees.

Source
sunlit

When the satellite is not in full shadow.

Source
visible

The overlap: when there is something to see.

Source
visual?

Whether any part of the pass can be seen.

Source