pyguymer3.geo.find_min_max_dist_bearing¶

pyguymer3.geo.find_min_max_dist_bearing(midLon, midLat, lons, lats, /, *, angConv=0.1, angHalfRange=180.0, debug=True, dist=1000.0, eps=1e-12, first=True, iIter=0, nAng=9, nIter=100, space='EuclideanSpace', startAng=180.0)[source]¶

Find the bearing which points towards the minimum maximum distance to some locations

This function finds the bearing which points towards the minimum maximum distance (in either Euclidean space or Geodesic space) to some locations around a middle location.

Parameters:

midLon (float) – the middle longitude (in degrees)
midLat (float) – the middle latitude (in degrees)
lons (numpy.ndarray) – the longitudes (in degrees)
lats (numpy.ndarray) – the latitudes (in degrees)
angConv (float, optional) – the angle change which classifies as converged (in degrees)
angHalfRange (float, optional) – the angle either side of the starting angle to search over (in degrees)
debug (bool, optional) – print debug messages
dist (float, optional) – the distance around the middle location to search over (in degrees or metres)
eps (float, optional) – the tolerance of the Vincenty formula iterations
first (bool, optional) – flag whether this is the first call of an interative/recursive sequence (if the first call then this function just returns the angle with the minimum maximum distance; if not the first call then fit a polynomial degree 2 to the values and return the calculated root)
iIter (int, optional) – the current iteration
nAng (int, optional) – the number of angles around the middle location to search over
nIter (int, optional) – the maximum number of iterations (particularly the Vincenty formula)
space (str, optional) – the geometric space to perform the distance calculation in (either “EuclideanSpace” or “GeodesicSpace”)
startAng (float, optional) – the starting angle to search over (in degrees)

Returns:

rootAng – the angle which points towards the minimum maximum distance to some locations (in degrees)

Return type:

float

Notes

References