hawcsimulator.steps.limb_observation.observation__limb

hawcsimulator.steps.limb_observation.observation__limb(viewing_tangent_altitudes: ndarray, time: Timestamp, tangent_latitude: float, tangent_longitude: float, observer_altitude: float, sample_wavelengths: ndarray, observer_longitude: float | None = None, observer_latitude: float | None = None, tangent_solar_zenith_angle: float | None = None, tangent_solar_azimuth_angle: float | None = None, maximum_allowed_sza: float = 88) → ObservationContainer

Creates an idealized limb viewing observation based on a set of viewing tangent altitudes and optionally solar angles at the tangent point. The observation is created assuming the solar angles are the same for every tangent altitude.

Parameters:

• viewing_tangent_altitudes (np.array) – Tangent altitudes for the observation in [m], assuming no refraction

• time (pd.Timestamp) – Time of the observation. Primarily used when the solar angles are not specified to calculate the sun position

• tangent_latitude (float) – Tangent latitude in [degrees]

• tangent_longitude (float) – Tangent longitude in [degrees]

• observer_altitude (float) – Altitude of the observer in [m]

• sample_wavelengths (np.ndarray) – Observation sample wavelengths for the instrument in [nm]

• observer_latitude (float) – Latitude of the observer in [degrees], optional, only required if time based solar angles are used

• observer_longitude (float) – Longitude of the observer in [degrees], optional, only required if time based solar angles are used

• tangent_solar_zenith_angle (float | None, optional) – Solar zenith angle in [degrees], by default None indicating it will be calculated from the observation time

• tangent_solar_azimuth_angle (float | None, optional) – Relative solar azimuth angle in [degrees] where 0 degrees is forward scatter, by default None indicating it will be calculated from the observation time

Return type:

ObservationContainer