jord: Geographical Position Calculations
This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.
Properties
| Versions | 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.3.1.0, 0.3.1.0, 0.4.0.0, 0.4.1.0, 0.4.2.0, 0.5.0.0, 0.6.0.0, 1.0.0.0, 2.0.0.0 |
|---|---|
| Change log | ChangeLog.md |
| Dependencies | base (>=4.9 && <5), haskeline (>=0.7 && <0.8), jord [details] |
| License | BSD-3-Clause |
| Copyright | 2018 Cedric Liegeois |
| Author | Cedric Liegeois |
| Maintainer | Cedric Liegeois <ofmooseandmen@yahoo.com> |
| Category | Geography |
| Home page | https://github.com/ofmooseandmen/jord |
| Bug tracker | https://github.com/ofmooseandmen/jord/issues |
| Source repo | head: git clone https://github.com/ofmooseandmen/jord |
| Uploaded | by CedricLiegeois at 2018-08-12T04:23:41Z |
Modules
[Index] [Quick Jump]
- Data
Downloads
- jord-0.3.1.0.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
Package maintainers
For package maintainers and hackage trustees
Readme for jord-0.3.1.0
[back to package description]Jord - Geographical Position Calculations
Jord [Swedish] is Earth [English]
What is this?
Jord is a Haskell library that implements various geographical position calculations using the algorithms described in Gade, K. (2010). A Non-singular Horizontal Position Representation.
- Transformation between ECEF (earth-centred, earth-fixed), Latitude/Longitude and N-Vector positions for spherical and ellipsoidal earth model
- Transformation between Latitude/Longitude and N-Vector positions
- Local, Body and North, East, Down Frames: delta between positions, target position from reference position and delta
- surface distance, initial & final bearing, interpolated position, great circle intersections, cross track distance, ...
How do I build it?
If you have Stack, then:
$ stack build --test
How do I use it?
import Data.Geo.Jord
-- Delta between positions in frameL
let p1 = decimalLatLongHeight 1 2 (metres (-3))
let p2 = decimalLatLongHeight 4 5 (metres (-6))
let w = decimalDegrees 5 -- wander azimuth
deltaBetween p1 p2 (frameL w) wgs84 -- = deltaMetres 359490.579 302818.523 17404.272
-- destination position from 531914N0014347W having travelled 500Nm on a heading of 96.0217°
-- using mean earth radius derived from the WG84 ellipsoid
destination (readLatLong "531914N0014347W") (decimalDegrees 96.0217) (nauticalMiles 500) r84
-- surface distance between 54°N,154°E and its antipodal position
-- using mean earth radius derived from the WG84 ellipsoid
let p = decimalLatLong 54 154
surfaceDistance p (antipode p) r84
Jord comes with a REPL (built with haskeline):
$ jord-exe
jord> finalBearing (destination (antipode 54°N,154°E) 54° 1000m) 54°N,154°E
jord> angle: 126°0'0.0" (126.0)