srtm_height_profile#

pycraf.pathprof.srtm_height_profile(lon_t, lat_t, lon_r, lat_r, step, generic_heights=False)[source]#

Extract a height profile from SRTM data.

Parameters:
lon_t, lat_tQuantity

Geographic longitude/latitude of start point (transmitter) [deg]

lon_r, lat_rQuantity

Geographic longitude/latitude of end point (receiver) [deg]

stepQuantity

Distance resolution of height profile along path [m]

generic_heightsbool

If generic_heights is set to True, heights will be set to zero. This can be useful for generic (aka flat-Earth) computations. (Default: False)

Returns:
lonsQuantity 1D array

Geographic longitudes of path.

latsQuantity 1D array

Geographic latitudes of path.

distanceQuantity scalar

Distance between start and end point of path.

distancesQuantity 1D array

Distances along the path (with respect to start point).

heightsQuantity 1D array

Terrain height along the path (aka Height profile).

bearingQuantity scalar

Start bearing of path.

backbearingQuantity scalar

Back-bearing at end point of path.

backbearingsQuantity 1D array

Back-bearings for each point on the path.

Notes

  • distances contains distances from Transmitter.

  • SRTM data tiles (*.hgt) need to be accessible by pycraf. It is assumed that these are either present in the current working directory or in the path defined by the SRTMDATA environment variable (sub-directories are also parsed). Alternatively, use the SrtmConf manager to change the directory, where pycraf looks for SRTM data, during run-time. The SrtmConf manager also offers additional features such as automatic downloading of missing tiles or applying different interpolation methods (e.g., splines). For details see Working with SRTM data.