gnssrefl.refl_zones_cl module

gnssrefl.refl_zones_cl.main()
gnssrefl.refl_zones_cl.parse_arguments()
gnssrefl.refl_zones_cl.reflzones(station: str, azim1: int = 0, azim2: int = 360, lat: float = None, lon: float = None, height: float = None, RH: float = None, fr: int = 1, el_list: float = [], azlist: float = [], system: str = 'gps', output: str = None)

This module creates “stand-alone” Fresnel Zones maps for google Earth. At a minimum it requires a four station character name as input. The output is a KML file.

If the station is in either your local coordinate file or in the UNR database that comes with gnssrefl, those latitude, longitude, and ellipsoidal height values are used. For information on the local coordinate file see the file formats section of the documentation. You may override those stored values with the optional lat lon height inputs.

The output file will be stored in REFL_CODE/Files/kml unless you specify an output name. In that case it will go into your working directory

The defaults are that it does all azimuths, elevation angles of 5-10-15, GPS L1, and uses the height of the station above sea level to use for the RH. If you want to specify the reflector height, set -RH. If you are making a file for an interior lake or river, you will need to use this option. Similarly, for a soil moisture or snow reflection zone map, where height above sea level is not important, you will want to set the RH value accordingly.

Examples

refl_zones p041 -RH 2

standard Fresnel zones for all azimuths, GPS and L1 frequency, RH of 2 meters

refl_zones sc02 -fr 2 -azlist 40 240

Fresnel zones for limited azimuths, GPS and L2 frequency. RH is mean sea level

refl_zones p041 -RH 5 -system galileo

Fresnel zones for reflector height of 5 meters and Galileo L1

refl_zones xxxx -RH 5 -lat 40 -lon 120 -height 10

Using a station not in the UNR database, so station position given Note that this is the ellipsoidal height.

Parameters:

  • station (str) – station name

  • azim1 (int, optional) – min azimuth angle in deg

  • azim2 (int, optional) – max azimuth angle in deg

  • lat (float, optional) – latitude in deg

  • lon (float, optional) – longitude in deg

  • height (float, optional) – ellipsoidal height in m

  • RH (float, optional) – user-defined reflector height (m) default is to use sea level as the RH

  • fr (int, optional) – frequency (only 1,2, or 5 allowed)

  • el_list (list of floats, optional) – elevation angles desired (deg) default is 5, 10, 15

  • azlist (list of floats, optional) – azimuth angle regions (deg) Must be in pairs, i.e. 0 90 180 270

  • system (str, optional) – name of constellation (gps,glonass,galileo, beidou allowed) default is gps

  • output (str, optional) – name for kml file

Return type:

Creates a KML file for Google Earth