stilt.observations.slant_points

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

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

Each altitude sits (altitude - anchor) * tan(zenith) metres from (longitude, latitude) along the azimuth bearing, on a local flat tangent plane. zenith is degrees from the local vertical and azimuth is degrees clockwise from north: the bearing from the ground point toward the instrument or the sun, which is the direction the path rises toward. anchor is the altitude at which the path passes through (longitude, latitude) and defaults to the first altitude.

Altitudes are returned unchanged, in whatever datum they were given. Use mean-sea-level altitudes for a slant; terrain-following (AGL) heights would bend the path. Pass the result to stilt.Receptor.from_points().

Return type:

list[tuple[float, float, float]]

Parameters:

• longitude (float)

• latitude (float)

• altitudes (_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | bool | int | float | complex | str | bytes | _NestedSequence[bool | int | float | complex | str | bytes])

• zenith (float)

• azimuth (float)

• anchor (float | None)