utmCoord.h File Reference

This file declares DtUtmCoord. More...

Go to the source code of this file.

Classes
class	DtUtmCoord
	Instances of DtUtmCoord are used to represent UTM coordinates. More...

Functions
void	DtUtmInit (const DtDegMinSec &latRef, const DtDegMinSec &lonRef, int standardOffsets=1, long zone=0)
	These functions are defined for backwards compatibility only.
const DtDcm &	DtNedToEnuDcm ()
const DtDcm &	DtEnuToNedDcm ()
double	DtUtmGridDeclination (const DtUtmCoord &utm)
	Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.
double	DtUtmGridDeclination (double lat, double lon)
void	DtGridDeclinationDcm (double gridDecl, DtDcmRef utm2ned)
void	DtGeodToUtm (const DtGeodeticCoord &in, DtUtmCoord &out)
	Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.
void	DtUtmToGeod (const DtUtmCoord &utm, DtGeodeticCoord &out)
	Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.
void	DtGeocToUtm (const DtVector &in, DtUtmCoord &out)
	Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.
void	DtUtmToGeoc (const DtUtmCoord &in, DtVector &out)
	Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.

Variables
const DtDegMinSec	DtUtmLatRef1_1 = { 35.0, 15.0, 0.0, DtNorth }
	Some constants: Origin of the IITSEC '92 terrain database.
const DtDegMinSec	DtUtmLonRef1_1 = { 122.0, 3.0, 59.0, DtWest }
const DtDegMinSec	DtUtmLatRef_IITSEC_93 = { 35.0, 15.0, 0.0, DtNorth }
	Origin of the IITSEC '94 & '95 terrain database.
const DtDegMinSec	DtUtmLonRef_IITSEC_93 = { 122.0, 4.0, 0.0, DtWest }
const DtDegMinSec	DtUtmLatRefZone10 = { 0.0, 0.0, 0.0, DtNorth }
	The standard UTM reference for a zone is the point along the zone's central meridian at the equator.
const DtDegMinSec	DtUtmLonRefZone10 = { 123.0, 0.0, 0.0, DtWest }

Detailed Description

This file declares DtUtmCoord.

Function Documentation

const DtDcm& DtEnuToNedDcm

(

)

void DtGeocToUtm	(	const DtVector &	in,
		DtUtmCoord &	out
	)

Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.

Exceptions

DtException

Both functions throw if the UTM reference point is not initialized.

void DtGeodToUtm	(	const DtGeodeticCoord &	in,
		DtUtmCoord &	out
	)

Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.

Exceptions

DtException

Both functions throw if the UTM reference point is not initialized.

void DtGridDeclinationDcm	(	double	gridDecl,
		DtDcmRef	utm2ned
	)

const DtDcm& DtNedToEnuDcm

(

)

double DtUtmGridDeclination

(

const DtUtmCoord &

utm

)

Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.

These functions will not work if DtUtmInit() has not been called first.

double DtUtmGridDeclination	(	double	lat,
		double	lon
	)

void DtUtmInit	(	const DtDegMinSec &	latRef,
		const DtDegMinSec &	lonRef,
		int	standardOffsets = 1,
		long	zone = 0
	)

These functions are defined for backwards compatibility only.

DtUtmInit must always be called first if users want to use VR-Link's global reference point. Otherwise, users can choose to create and manage their own reference points which they pass to each utm coord instance. VR-Link's global reference point is used by default. If standardOffsets is true, the standard false easting (500,000 m) and false northing (10,000,000 m only when south of equator) will be applied. DtUtmInit expects lonRef between +/- 180. The UTM zone will be set by the zone that the reference point falls in, where zone N extends from (N*6 - 186) to (N*6 - 180).

void DtUtmToGeoc	(	const DtUtmCoord &	in,
		DtVector &	out
	)

Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.

Exceptions

DtException

Both functions throw if the UTM reference point is not initialized.

void DtUtmToGeod	(	const DtUtmCoord &	utm,
		DtGeodeticCoord &	out
	)

Use of these functions is discouraged in favor of DtUtmCoord member functions which perform conversions.

Exceptions

DtException

Both functions throw if the UTM reference point is not initialized.

Variable Documentation

const DtDegMinSec DtUtmLatRef1_1 = { 35.0, 15.0, 0.0, DtNorth }

Some constants: Origin of the IITSEC '92 terrain database.

const DtDegMinSec DtUtmLatRef_IITSEC_93 = { 35.0, 15.0, 0.0, DtNorth }

Origin of the IITSEC '94 & '95 terrain database.

const DtDegMinSec DtUtmLatRefZone10 = { 0.0, 0.0, 0.0, DtNorth }

The standard UTM reference for a zone is the point along the zone's central meridian at the equator.

Standard UTM positions also use the standard false easting and false easting (see DtUtmInit).

This is the standard UTM reference position for UTM zone 10.

const DtDegMinSec DtUtmLonRef1_1 = { 122.0, 3.0, 59.0, DtWest }

const DtDegMinSec DtUtmLonRef_IITSEC_93 = { 122.0, 4.0, 0.0, DtWest }

const DtDegMinSec DtUtmLonRefZone10 = { 123.0, 0.0, 0.0, DtWest }