[][src]Crate nav_types

Easily work with global positions and vectors.

This crate is intended to allow easy and safe interoperability between different global position and vectors in different coordinate systems. The create is built on top of nalgebra and strives to be compatible with types from that crate.

Example

use nav_types::{ECEF, WGS84, ENU, NED};

// Define positions using latitude and longitude on the WGS84 ellipsoid
let oslo = WGS84::new(59.95, 10.75, 0.0);
let stockholm = WGS84::new(59.329444, 18.068611, 0.0);

println!("Great circle distance between Oslo and Stockholm: {:?}",
    oslo.distance(&stockholm));

// Calculate vectors between positions
// This is equivalent of doint `ECEF::from(stockholm) - ECEF::from(oslo)`
let vec = stockholm - oslo;
println!("Vector between Oslo and Stockholm: {:?}", vec);

// Easily convert between ENU and NED vectors
let ned_vec = NED::new(1f32, 0.0, 1.0);
let new_vec = vec + ned_vec;

// Add vectors to positions
let stockholm_2 = ECEF::from(oslo) + new_vec;

Where to begin

If you are unsure where to begin I would recommend you to research which type of date you have available. Most of the time this is where you should start. If no source is available or you are free to choose I recommend that you start with ECEF and ENU. ECEF is efficient to calculate with and ENU is quite straight forward and used in many contexts.

Structs

ECEF

Earth Centered Earth Fixed position

ENU

East North Up vector

NED

North East Down vector

NVector

N-Vector position

WGS84

Geodetic position