stilt.observations.slant_points#

stilt.observations.slant_points(longitude, latitude, altitudes, *, zenith, azimuth, anchor=None)[source]#

Return (longitude, latitude, altitude) points along a line of sight.

Each point is (altitude - anchor) * tan(zenith) meters from (longitude, latitude) along the azimuth bearing, on a flat local tangent plane. Pass the result to stilt.Receptor.from_points().

Parameters:

  • longitude (float) – Where the path passes through anchor, in degrees.

  • latitude (float) – Where the path passes through anchor, in degrees.

  • altitudes (TypeAliasType) – Altitudes of the points, in meters. They are returned unchanged. Use altitudes above sea level, since heights above ground would bend the path with the terrain.

  • zenith (float) – Angle of the path from the local vertical, in degrees, from 0 up to 90.

  • azimuth (float) – Bearing toward the instrument or the sun, in degrees clockwise from north. The path rises in this direction.

  • anchor (float | None) – Altitude at which the path passes through (longitude, latitude). Defaults to the first altitude.

Return type:

list[tuple[float, float, float]]