GeoscienceAustralia / GeodePy

A toolkit for Geodesy and Surveying in Python
Apache License 2.0
91 stars 47 forks source link

Vincentys utm functions #114

Closed BatchelorJ closed 4 years ago

BatchelorJ commented 4 years ago

Updated functions in geodepy.geodesy module to reflect new changes for Vincenty's functions working with UTM coordinates, grid bearings and grid distances.

Breaking Changes

Additional Features

Note that as vincinv_utm and vincdir_utm are now inputting and outputting measurements relating to grids (bearings and distances), working with points between neighbouring UTM zones could cause large corrections and failures. These functions rely on geodepy.convert.grid2geo, which will raise errors when points are more than 3330km of the Central Meridian. The output grid distances, which have to be related to only one of the input zones, don't mean much anyway when working with points separated by more than 1 zone. In these cases, it would be strongly suggested to use geodepy.geodesy.vincinv and geodepy.geodesy.vincdir as these work with geographic values (latitudes and longitudes, geodetic azimuths and ellipsoidal distances).

I've used http://www.mygeodesy.id.au/documents/Trav_Comp_V2.1.pdf as the primary reference, which looks like its the source of the solutions present in the GDA94 and GDA2020 tech manuals.

BatchelorJ commented 4 years ago

Thanks mate, as we discussed I'll finish working on the new angle features before releasing a new version.