refine_pass

ssapy.compute.refine_pass(orbit, observer, time, propagator=KeplerianPropagator(), horizon=np.float64(0.3490658503988659), maxSpan=86400.0)[source][source]

Refine a satellite overhead pass.

Parameters:
  • orbit (Orbit) – Orbit in question.

  • observer (EarthObserver.) – Observer for which to refine pass.

  • time (float or astropy.time.Time) – A time when satellite is visible to observer. (Found using find_passes, for instance) If float, then should correspond to GPS seconds; i.e., seconds since 1980-01-06 00:00:00 UTC

  • propagator (Propagator, optional) – The propagator instance to use.

  • horizon (float or Quantity, optional) – Minimum altitude for which to consider a satellite “visible”. If float, then should be in radians.

  • maxSpan (float or Quantity, optional) – Maximum amount of time before or after time to search for rise/set times, or time of max altitude. If float, then seconds.

Returns:

Key/values are: tStart : Time

Time at which Orbit rises above horizon

tEndTime

Time at which Orbit rises above horizon

tMaxAltTime

Time Orbit passes through maximum altitude

maxAltQuantity

Maximum altitude

durationQuantity

Duration of pass.

illumAtStartbool

Is satellite illuminated at tStart?

illumAtEndbool

Is satellite illuminated at tEnd?

tTerminatorTime or None

If illumAtStart != illumAtEnd, then time satellite passes through cylindrical terminator shadow. Otherwise, None.

sunAltStartQuantity

Altitude of sun at tStart

sunAltEndQuantity

Altitude of sun at tEnd

Return type:

dict