GeographicLib.NET 1.52.0

GeographicLib.NET

GeographicLib is a small set of C++ classes for performing conversions between geographic, UTM, UPS, MGRS, geocentric, and local cartesian coordinates,for gravity (e.g., EGM2008), geoid height and geomagnetic field (e.g., WMM2020) calculations, and for solving geodesic problems.

GeographicLib.NET is a native .NET implementation of GeographicLib written in pure C#.

What's different from NETGeographicLib

Unlike the original NETGeographicLib, GeographicLib.NET is implemented in pure C# without binding the original C++ GeograpbicLib library by using C++/CLI or P/Invoke, thus achieves higher level of portability.

You should be able to use GeographicLib.NET with any target framework and platform that supports .NET Standard 2.0 or above.

Features

Bellow is a list of implemented features.

• Projections (AlbersEqualArea, AzimuthalEquidistant, CassiniSoldner, Gnomonic, LambertConformalConic, PolarStereographic and TransverseMercator)
• Geocodes (GARS, Geohash, Georef, MGRS and OSGB)
• Coordinate conversions (UTMUPS, Geocentric and LocalCartesian)
• Coordinate parsing/formatting (DMS and GeoCoords)
• Geodesic (Geodesic, GeodesicLine, GeodesicExact and GeodesicLineExact)
• Rhumb (Rhumb and RhumbLine)
• PolygonArea (PolygonArea<T>, PolygonArea, PolygonAreaExact and PolygonAreaRhumb)
• Geoid (Geoid)
• GravityModel (GravityCircle, NormalGravity and GravityModel)
• MagneticModel (MagneticModel, MagneticCircle)
• Auxilary classes (MathEx, Ellipoid, EllipticFunction and SphericalHarmonic)

Geodesic and GeodesicExact are tested with the test set for geodesic.

TransverseMercator and TransverseMercatorExact are tested with data generated by 64-bit TransverseMercatorProj utility ran on Windows.

Managed implemetation of C mathematical functions in MathEx are tested with data generated by 64-bit Windows Universal C Runtime.

Installing

Stable

Stable releases of GeographicLib.NET are hosted on NuGet. You can install them using the following command:

dotnet add package GeographicLib.NET

Preview

Preview versions of GeographicLib.NET are hosted on NuGet pre-release channel. You can install them using the following command:

dotnet add package GeographicLib.NET --prerelease

Mathematical Functions

GeographicLib uses several C mathematical functions that are not available in all versions of .NET. These functions are:

• remquo
• hypot
• log1p
• expm1
• frexp
• log2 (available since .NET 5.0)
• fma (available since .NET 5.0)
• scalbn (available since .NET 5.0)
• copysign (available since .NET 5.0)
• atanh (available since .NET Standard 2.1)
• asinh (available since .NET Standard 2.1)
• cbrt (available since .NET Standard 2.1)

GeographicLib.NET provides managed implementations of these functions (ported from musl libc).

GeographicLib.MathEx class will use implementations provided by .NET runtime whenenver possible, and will fallback to managed implementations when not available in .NET runtime.

You can also force GeographicLib.MathEx to fallback to platform dependent implementations provided by system C runtime libraries, rather than managed implementations, by setting GeographicLib.MathEx.UseManagedCMath property to false. These functions provide better performance, but may produce different results on different platform in some edge cases.

Documentation

GeographicLib.NET includes a detailed XML documentation for all public APIs. Since the API surface of GeographicLib.NET is highly compatible with the original GeographicLib, you can also refer the original documentation here for usage and explanation.

Change Log

GeographicLib.NET adopts changes made in original GeographicLib and aligns its version number with original GeographicLib releases.

Bellow is a list of stable releases of GeographicLib.NET and changes made in .NET side in each release. For changes adopted from original GeographicLib, please refer the its change log here.

Version 1.52.0 (released 2021/07/07)

• BREAKING

  • Modify overloads of Forward and Reverse in AlbersEqualArea, AzimuthalEquidistant, CassiniSoldner and LambertConformalConic to return coordinates as tuples.
  • Modify methods using out parameters defined in NormalGravity, GravityModel, GravityCircle, MagneticModel and MagnegticCircle to return results as tuples.

• NEW

  • Add constructor overloads that accept IEllipsoid as parameter for AlbersEqualArea and LambertConformalConic.
  • Add managed implementation of log2.
  • Add overloads of Direct and Inverse in Geodesic/GeodesicLine, GeodesicExact/GeodesicLineExact and Rhumb/RhumbLineExact, that return the computation results as a single object.
  • Add definitions of popular reference ellipsoids in Ellipsoid class.

• FIX

  • Fix stack overflow bug for Forward(double lon0, double lat, double lon) and Reverse(double lon0, double x, double y) in TransverseMercatorExact.

Version 1.51.0 (released 2021/03/14)

Initial stable release.