Class: Ellipsoid

Constructor

new Ellipsoid(equatorialSize, polarSize)

Parameters:

Name	Type	Description
`equatorialSize`	number	Equatorial ellipsoid size.
`polarSize`	number	Polar ellipsoid size.

Source: ellipsoid/Ellipsoid.ts, line 17

Methods

cartesianToLonLat(cart) → {LonLat}

Converts 3d cartesian coordinates to geodetic

Parameters:

Name	Type	Description
`cart`	Vec3	Cartesian coordinates

Source: ellipsoid/Ellipsoid.ts, line 274

Returns:

Geodetic coordinates

Type:: LonLat

cartesianToLonLatRes(cart, res) → {LonLat}

Converts 3d cartesian coordinates to geodetic

Parameters:

Name	Type	Description
`cart`	Vec3	Cartesian coordinates
`res`	LonLat	Link geodetic coordinates variable

Source: ellipsoid/Ellipsoid.ts, line 283

Returns:

Geodetic coordinates

Type:: LonLat

direct(lonLat, azimuth, dist)

Calculates the destination point given start point lat / lon, azimuth(deg) and distance (m). Source: http://movable-type.co.uk/scripts/latlong-vincenty-direct.html and optimized / cleaned up by Mathias Bynens http://mathiasbynens.be/ Based on the Vincenty direct formula by T. Vincenty, “Direct and Inverse Solutions of Geodesics on the Ellipsoid with application of nested equations”, Survey Review, vol XXII no 176, 1975 http://www.ngs.noaa.gov/PUBS_LIB/inverse.pdf

Parameters:

Name	Type	Description
`lonLat`	LonLat	Origin coordinates
`azimuth`	number	View azimuth in degrees
`dist`	number	Distance to the destination point coordinates in meters

Source: ellipsoid/Ellipsoid.ts, line 395

Returns:

geodeticToCartesian(lon, lat, height, res) → {Vec3}

Gets cartesian ECEF 3d coordinates from geodetic coordinates.

Parameters:

Name	Type	Default	Description
`lon`	Number		Longitude.
`lat`	Number		Latitude.
`height`	Number	0	Height.
`res`	Vec3		Output result variable.

Source: ellipsoid/Ellipsoid.ts, line 185

Returns:

Type:: Vec3

getBearingDestination(lonLat1, bearing, distance) → {LonLat}

Parameters:

Name	Type	Default	Description
`lonLat1`
`bearing`		0
`distance`		0

Source: ellipsoid/Ellipsoid.ts, line 543
To Do: this is not precise function, needs to be replaced or removed

Returns:

Type:: LonLat

getEquatorialSize() → {number}

Gets ellipsoid equatorial size.

Source: ellipsoid/Ellipsoid.ts, line 130

Returns:

Type:: number

getGreatCircleDestination(lonLat, azimuth, dist) → {LonLat}

Parameters:

Name	Type	Description
`lonLat`	LonLat	Origin coordinates
`azimuth`	number	View azimuth in degrees
`dist`	number	Distance to the destination point coordinates in meters

Source: ellipsoid/Ellipsoid.ts, line 320

Returns:

Destination point coordinates

Type:: LonLat

getIntermediatePointOnGreatCircle(lonLat1, lonLat2, fraction) → {LonLat}

Returns the point at given fraction between two points on the great circle.

Parameters:

Name	Type	Description
`lonLat1`	LonLat	Longitude/Latitude of source point.
`lonLat2`	LonLat	Longitude/Latitude of destination point.
`fraction`	number	Fraction between the two points (0 = source point, 1 = destination point).

Source: ellipsoid/Ellipsoid.ts, line 570

Returns:

Intermediate point between points.

Type:: LonLat

getPolarSize() → {number}

Gets ellipsoid polar size.

Source: ellipsoid/Ellipsoid.ts, line 147

Returns:

Type:: number

getSurfaceNormal3v(coord) → {Vec3}

Gets ellipsoid surface normal.

Parameters:

Name	Type	Description
`coord`	Vec3	Spatial coordinates.

Source: ellipsoid/Ellipsoid.ts, line 301

Returns:

Type:: Vec3

hitRay(origin, direction) → {Vec3}

Returns cartesian coordinates of the intersection of a ray and an ellipsoid. If the ray doesn't hit ellipsoid returns null.

Parameters:

Name	Type	Description
`origin`	Vec3	Ray origin point.
`direction`	Vec3	Ray direction.

Source: ellipsoid/Ellipsoid.ts, line 467

Returns:

Type:: Vec3

inverse(lonLat1, lonLat2) → {IInverseResult}

Returns inverse Geodesic solution for two points

Parameters:

Name	Type	Description
`lonLat1`	LonLat	start coordinates point
`lonLat2`	LonLat	end coordinates point

Source: ellipsoid/Ellipsoid.ts, line 333

Returns:

Contains distance, initialAzimuth, and finalAzimuth values

Type:: IInverseResult

lonLatToCartesian(lonlat) → {Vec3}

Calculate cartesian coordinates by its ECEF geodetic coordinates.

Parameters:

Name	Type	Description
`lonlat`	LonLat	Geodetic coordinates.

Source: ellipsoid/Ellipsoid.ts, line 164

Returns:

Type:: Vec3

lonLatToCartesianRes(lonlat, res) → {Vec3}

Calculate cartesian coordinates by its ECEF geodetic coordinates.

Parameters:

Name	Type	Description
`lonlat`	LonLat	Geodetic coordinates.
`res`	Vec3	Output variable reference.

Source: ellipsoid/Ellipsoid.ts, line 174

Returns:

Type:: Vec3

projToSurface(p) → {LonLat}

Gets Wgs84 geodetic coordinates from cartesian ECEF.

Parameters:

Name	Type	Description
`p`	Vec3	Cartesian coordinates.

Source: ellipsoid/Ellipsoid.ts, line 210

Returns:

Type:: LonLat

rhumbDistanceTo(startLonLat, endLonLat) → {number}

Returns the distance travelling from ‘this’ point to destination point along a rhumb line.

Parameters:

Name	Type	Description
`startLonLat`	LonLat	coordinates.
`endLonLat`	LonLat	coordinates

Source: ellipsoid/Ellipsoid.ts, line 76

Returns:

Distance in m between this point and destination point (same units as radius).

Type:: number

(static) getBearing(lonLat1, lonLat2) → {number}

REMOVE ASAP after

Parameters:

Name	Type	Description
`lonLat1`
`lonLat2`

Source: ellipsoid/Ellipsoid.ts, line 110

Returns:

Type:: number

(static) getIntermediatePointOnGreatCircle(lonLat1, lonLat2, fraction) → {LonLat}

Returns the point at given fraction between two points on the great circle.

Parameters:

Name	Type	Description
`lonLat1`	LonLat	Longitude/Latitude of source point.
`lonLat2`	LonLat	Longitude/Latitude of destination point.
`fraction`	number	Fraction between the two points (0 = source point, 1 = destination point).

Source: ellipsoid/Ellipsoid.ts, line 570

Returns:

Intermediate point between points.

Type:: LonLat