Tellurian.Geospatial 2.3.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Tellurian.Geospatial --version 2.3.0
NuGet\Install-Package Tellurian.Geospatial -Version 2.3.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Tellurian.Geospatial" Version="2.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Tellurian.Geospatial --version 2.3.0
#r "nuget: Tellurian.Geospatial, 2.3.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Tellurian.Geospatial as a Cake Addin
#addin nuget:?package=Tellurian.Geospatial&version=2.3.0

// Install Tellurian.Geospatial as a Cake Tool
#tool nuget:?package=Tellurian.Geospatial&version=2.3.0

Tellurian.Geospatial

Strongly typed object model for geospatial calculations and transformations. All types are also serializable with the DataContractSerializer and System.Text.Json. From release 2.3.0 this package only supports .NET 6+.

Released under MIT license 2020.

Namespace Tellurian.Geospatial

Types for basic calculations of dictances etc. and building blocks for more advanced spatial algorithms.

  • Angle representing 0 ⇐ degrees < 360 and radians 0 ⇐ radians < 2Π.
  • Distance representing zero or positive distances in meters and kilometers.
  • Position with Latitude and Longitude representing a two dimensional location on earth surface. The user must decide on which datum a position is expressed, for exampe WGS 84, ETRS 89 or similar.
  • Speed representing a zero or positive speed in m/s and km/h.
  • Stretch between two Positions representing propertes for stretches on earth surface, ie. distance, direction, on track distance etc.
  • Vector represening a Distance with an Angle.

Each of these objects has value safe initializers and useful methods for calculating distances, angles etc.

Namespace Tellurian.Geospatial.Surfaces

Types for modelling surfaces. Added from release 2.1.0.

  • CircularSurface representing a ReferencePosition with a Radius.
  • PolygonalSurface representing a ReferencePosition sourrounded by a polygonal border.

Surfaces has a Includes(Position) method that tells if a Position lies on or within the surface's border. You can create your own by derive from Surface base class.

Namespace Tellurian.Geospatial.Transform

Types and methods for transforming between cartesian and planar coordinates.

  • EarthEllipsoid represents the form of the earth. There are a few preconfigured, see below. You can easy create other.
  • MapProjection represents how coordinates are mapped to the earth. There are a few preconfigured, see below. You can easy create other.
  • GridCoordinate represents a planar coordinate.
  • GaussKrügerTransformer uses the objects above to transform between cartesian and planar coordinates.

There are built-in map projections for planar coordinates:

  • MapProjections.UTMxx, where 'xx' is any of zone 32-35 used in Europe.
  • MapProjections.Sweref99TM and MapProjections.RT90 used in Sweden.

There are built-in ellipsoids:

  • Ellipsoids.WGS84 used for most GPS-devices.
  • Ellipsoids.GRS80 used for many transformations to/from planar coordinates.
  • Ellipsoids.Hayford1910

Namespace Tellurian.Geospatial.DistanceCalculators

The method for calculating distances between Positions is pluggable because applications have different requirements regarding precision and speed of calculation. The following DistanceCalculator is included:

  • HaversineDistanceCalculator is a fast calculation that is suitable for distances down to decimeters, suitable for tracking of movable objects. This is also the default DistanceCalculator.

You can write additional distance calculators by implementing the IDistanceCalculator interface and use it to calculate distances of Stretches.

References

This implementation is inspired by part of Latitude/longitude spherical geodesy tools
MIT Licence (c) Chris Veness 2002-2020
https://www.movable-type.co.uk/scripts/latlong.html
https://www.movable-type.co.uk/scripts/geodesy/docs/module-latlon-spherical.html https://github.com/chrisveness/geodesy

Implementation of the GaussKrügerTransformer is based on formulas from Swedish Land Survey (Lantmäteriet)
https://www.lantmateriet.se/sv/Kartor-och-geografisk-information/GPS-och-geodetisk-matning/Om-geodesi/Formelsamling/

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net6.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.5.0 463 8/12/2022
2.3.1 409 7/30/2022
2.3.0 389 7/24/2022
2.2.0 680 12/1/2020
2.1.0 715 11/18/2020
2.0.0 647 11/17/2020
1.1.2 837 8/11/2019
1.1.1 770 8/11/2019
1.1.0 791 8/10/2019
1.0.0 970 2/10/2019

2.3.0 Upgraded to .NET 6. inclucing refactorings to use new C# features.