sasktran2.viewinggeo.ecef_to_sasktran2_ray

sasktran2.viewinggeo.ecef_to_sasktran2_ray#

sasktran2.viewinggeo.ecef_to_sasktran2_ray(observer: ndarray, look_vector: ndarray, time: Timestamp, geoid: Geodetic | None = None, solar_handler: SolarGeometryHandlerBase | None = None, ground_elevation: float = 0.0) → GroundViewingSolar | TangentAltitudeSolar[source]#

Converts an observer, look vector in ECEF coordinates and time to a sasktran2 viewing ray object

Parameters:

  • observer (np.ndarray) – Observer position in ECEF (ITRF) coordinates

  • look_vector (np.ndarray) – Look vector from the observer in ECEF (ITRF) coordinates. The vector does not need to be normalized.

  • time (pd.Timestamp) – Time of the observation. Used to lookup the sun position if applicable.

  • geoid (sk.Geodetic) – Geodetic object to use for the internal calculations. Defaults to WGS84

  • solar_handler (sk.solar.SolarGeometryHandlerBase) – Object used to lookup the solar angles for each ray. Defaults to None in which case a SolarHandlerForced object is used with 0 solar zenith and 0 solar azimuth

Returns:

A ground-viewing ray when the look vector intersects the requested ground elevation, otherwise a limb-viewing ray.

Return type:

sk.GroundViewingSolar or sk.TangentAltitudeSolar