DtUtmReferencePoints are used to represent an independent reference point for a UTM coordinate system. More...

Collaboration diagram for DtUtmReferencePoint:

Public Member Functions
	DtUtmReferencePoint ()
	Default CTOR.
	DtUtmReferencePoint (const DtDegMinSec &latRef, const DtDegMinSec &lonRef, int standardOffsets=1, long zone=0, const DtMapDatum &mapDatum=DtCurrentMapDatum(), double scaleFactor=0.9996)
	Constructor lat lon are represented by deg, min, sec, direction, where positive direction is north & WEST.
virtual	~DtUtmReferencePoint ()
	Default DTOR.
virtual void	geod2utm (double alat, double alon, double x, double y)
	Convert between geodetic and utm (geodetic lat & lon need to be in radians)
virtual void	utm2geod (double x, double y, double lat, double lon)
	Convert between utm and geodetic (geodetic lat & lon will be in radians)
virtual const DtMapDatum &	mapDatum () const
	get the MAP Datum to be used with this reference point
virtual void	useMapDatum (const DtMapDatum &mapDatum)
	set the MAP Datum to be used with this reference point
virtual const DtReferenceEllipsoid *	ellipsoid () const
	return the reference ellipsoid used by our DtMapDatum
void	init (const DtDegMinSec &latRef, const DtDegMinSec &lonRef, int standardOffsets=1, long zone=0, const DtMapDatum &mapDatum=DtCurrentMapDatum())
	Initializes the UTM reference point.
virtual void	uninitialize ()
	Uninitializes the reference point.
virtual bool	isInitialized () const
	Returns true if the reference point is initialized, and false otherwise.
virtual double	scale () const
	Returns the UTM scale.
virtual void	setScale (double scale)
	Sets the UTM scale.
virtual double	xOrigin () const
virtual void	setXOrgin (double x_origin)
virtual double	yOrigin () const
virtual void	setYOrgin (double y_origin)
virtual int	standardOffsets () const
virtual void	setStandardOffsets (int so)
virtual DtDegMinSec	latRef () const
virtual void	setLatRef (const DtDegMinSec &lat_ref)
virtual DtDegMinSec	longRef () const
virtual void	setLongRef (const DtDegMinSec &lat_ref)
virtual long	zoneOrigin () const
virtual void	setZoneOrigin (long zo)
virtual double	standardFalseEasting () const
virtual void	setStandardFalseEasting (double sfe)
virtual double	standardFalseNorthing () const
virtual void	setStandardFalseNorthing (double sfn)
virtual double	standardFalseNorthingCrossover () const
virtual void	setStandardFalseNorthingCrossover (double sfnc)
Protected Member Functions
void	initDatumConstants ()
void	initUtm (const double lat[4], const double lon[4], long zone=0)
void	degree (const double a[3], double *b) const

virtual void	geod2utm (double lat, double lon, long zone, double northing, double *easting)
	These conversion utilities do all the hard work lat and lon are always in deg,min,sec format.
virtual void	utm2geod (double northing, double easting, long zone, double lat, double lon)
	These conversion utilities do all the hard work lat and lon are always in deg,min,sec format.
Static Protected Member Functions
static void	setLongitudeFudgeFactor (double val)
	Set a small value to be added to the reference longitude to prevent floating point error when the longitude is right on a zone boundary.
Protected Attributes
int	myInited
int	myStandardOffsets
double	myXOrigin
double	myYOrigin
long	myZoneOrigin
DtDegMinSec	myLatRef
DtDegMinSec	myLonRef
DtReferenceEllipsoid	myEllipsoid
	reference ellipsoid
DtFloat64	mySemiMajor
	Used for conversion calculations.
DtFloat64	mySemiMinor
DtFloat64	myE_sq
DtFloat64	myEp_sq
DtFloat64	myEf
DtFloat64	myScale
double	myStandardFalseEasting
	These are used when we're using standard offsets.
double	myStandardFalseNorthing
double	myStandardFalseNorthingCrossover
Static Protected Attributes
static double	theLongitudeFudgeFactor

Detailed Description

DtUtmReferencePoints are used to represent an independent reference point for a UTM coordinate system.

In older versions of VR-Link UTM conversions depended on a single Reference point which was set with the DtUtmInit call. All UTM conversions later were preformed with regards to that initial point. This class is used to allow the user to choose a different point for every conversion. An example of this is provided in the VR-Link users guide in section 5.12

Constructor & Destructor Documentation

DtUtmReferencePoint::DtUtmReferencePoint ( )

Default CTOR.

DtUtmReferencePoint::DtUtmReferencePoint	(	const DtDegMinSec &	latRef,
		const DtDegMinSec &	lonRef,
		int	standardOffsets = `1`,
		long	zone = `0`,
		const DtMapDatum &	mapDatum = `DtCurrentMapDatum()`,
		double	scaleFactor = `0.9996`
	)

Constructor lat lon are represented by deg, min, sec, direction, where positive direction is north & WEST.

virtual DtUtmReferencePoint::~DtUtmReferencePoint ( ) [virtual]

Default DTOR.

Member Function Documentation

void DtUtmReferencePoint::degree	(	const double	a[3],
		double *	b
	)		const `[protected]`

virtual const DtReferenceEllipsoid* DtUtmReferencePoint::ellipsoid ( ) const [virtual]

return the reference ellipsoid used by our DtMapDatum

virtual void DtUtmReferencePoint::geod2utm	(	double	alat,
		double	alon,
		double *	x,
		double *	y
	)		`[virtual]`

Convert between geodetic and utm (geodetic lat & lon need to be in radians)

virtual void DtUtmReferencePoint::geod2utm	(	double	lat,
		double	lon,
		long *	zone,
		double *	northing,
		double *	easting
	)		`[protected, virtual]`

These conversion utilities do all the hard work lat and lon are always in deg,min,sec format.

Exceptions:

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

void DtUtmReferencePoint::init	(	const DtDegMinSec &	latRef,
		const DtDegMinSec &	lonRef,
		int	standardOffsets = `1`,
		long	zone = `0`,
		const DtMapDatum &	mapDatum = `DtCurrentMapDatum()`
	)

Initializes the UTM reference point.

void DtUtmReferencePoint::initDatumConstants ( ) [protected]

void DtUtmReferencePoint::initUtm	(	const double	lat[4],
		const double	lon[4],
		long	zone = `0`
	)		`[protected]`

virtual bool DtUtmReferencePoint::isInitialized ( ) const [virtual]

Returns true if the reference point is initialized, and false otherwise.

virtual DtDegMinSec DtUtmReferencePoint::latRef ( ) const [virtual]

virtual DtDegMinSec DtUtmReferencePoint::longRef ( ) const [virtual]

virtual const DtMapDatum& DtUtmReferencePoint::mapDatum ( ) const [virtual]

get the MAP Datum to be used with this reference point

virtual double DtUtmReferencePoint::scale ( ) const [virtual]

Returns the UTM scale.

virtual void DtUtmReferencePoint::setLatRef ( const DtDegMinSec & lat_ref ) [virtual]

static void DtUtmReferencePoint::setLongitudeFudgeFactor ( double val ) [static, protected]

Set a small value to be added to the reference longitude to prevent floating point error when the longitude is right on a zone boundary.

virtual void DtUtmReferencePoint::setLongRef ( const DtDegMinSec & lat_ref ) [virtual]

virtual void DtUtmReferencePoint::setScale ( double scale ) [virtual]

Sets the UTM scale.

virtual void DtUtmReferencePoint::setStandardFalseEasting ( double sfe ) [virtual]

virtual void DtUtmReferencePoint::setStandardFalseNorthing ( double sfn ) [virtual]

virtual void DtUtmReferencePoint::setStandardFalseNorthingCrossover ( double sfnc ) [virtual]

virtual void DtUtmReferencePoint::setStandardOffsets ( int so ) [virtual]

virtual void DtUtmReferencePoint::setXOrgin ( double x_origin ) [virtual]

virtual void DtUtmReferencePoint::setYOrgin ( double y_origin ) [virtual]

virtual void DtUtmReferencePoint::setZoneOrigin ( long zo ) [virtual]

virtual double DtUtmReferencePoint::standardFalseEasting ( ) const [virtual]

virtual double DtUtmReferencePoint::standardFalseNorthing ( ) const [virtual]

virtual double DtUtmReferencePoint::standardFalseNorthingCrossover ( ) const [virtual]

virtual int DtUtmReferencePoint::standardOffsets ( ) const [virtual]

virtual void DtUtmReferencePoint::uninitialize ( ) [virtual]

Uninitializes the reference point.

Any UTM coordinate using this reference point will become essentially invalid, as the reference point will move to lat/lon of 0/0. Will set all values to default and the reference ellipsoid to WGS84.

virtual void DtUtmReferencePoint::useMapDatum ( const DtMapDatum & mapDatum ) [virtual]

set the MAP Datum to be used with this reference point