gnssr4water.fresnel.plotfresnel module#

This code is to plot the reflection points on a map for vizualisation purpose

@author: Lubin Roineau, ENSG-Geomatics (internship at UT-ITC Enschede), Aug 26, 2022

gnssr4water.fresnel.plotfresnel.calc_extent(lon, lat, dist)#

This function calculate extent of map

Parameters:

  • lat (float) – Location of latitude and longitudee in degrees.

  • lon (float) – Location of latitude and longitudee in degrees.

Returns:

dist – Distance to edge from centre in meters.

Return type:

float

gnssr4water.fresnel.plotfresnel.fresnelMap(lon, lat, dist=25, filezone=None, filewb=None, azmin=None, azmax=None, alti=False, save=False, sitename=None, dirName=None)#

This function add Fresnel zones to a satellite background.

Parameters:

  • lat (float) – Location of latitude and longitudee in degrees.

  • lon (float) – Location of latitude and longitudee in degrees.

  • dist (float) – Distance to edge from centre in meters, value 25 is default.

  • filezone (str) – Path of the file for the Fresnel Zone, can be either gpkg or shp or kml.

  • filewb (str) – Path of the file for the waterbody, can be either gpkg or shp or kml.

  • azmin (int) – Define custom azimuth mask, min can be superior to max if mask overlap azimuth 0.

  • azmax (int) – Define custom azimuth mask, min can be superior to max if mask overlap azimuth 0.

  • alti (Boolean) – If True, return information on altimeter tracks.

  • save (Boolean) – Decide wether the return image will be saved or not.

  • sitename (str) – Name of the location, used for plot title and name of file if saved.

  • dirName (str) – Directory where files will be stored.

Return type:

Plot of Fresnel Zones with satellite background.

gnssr4water.fresnel.plotfresnel.image_spoof(self, tile)#

This function reformats web requests from OSM for cartopy.

Heavily based on code by Joshua Hrisko at: https://makersportal.com/blog/2020/4/24/geographic-visualizations-in-python-with-cartopy

gnssr4water.fresnel.plotfresnel.osm_image(lon, lat, dist, style='satellite', sitename=None, shp=True, save=False)#

This function makes OpenStreetMap satellite or map image.

Parameters:

  • lat (float) – Location of latitude and longitudee in degrees.

  • lon (float) – Location of latitude and longitudee in degrees.

  • dist (float) – Distance to edge from centre in meters.

  • style (String) – Decide wether background is “map” or “satellite”.

  • sitename (String) – Name of the location to be written on plot.

  • save (boolean) – Decide wether the return image will be saved or not.

Return type:

Plot with map or satellite background.