ICoordinateTransform

Description

interface Tinman.Terrain.Georef.ICoordinateTransform

Derived from

ICoordinateFlip

Extended by

CoordinateTransform abstract
IMapTransform

A ICoordinateTransform object provides a mapping between map coordinates (easting and northing) and geographic coordinates (latitude and longitude).

In the scope of this interface, geographic latitude and longitude are always specified in radians (or degrees where LatLon is used) and the latter is always interpreted relative to PrimeMeridian.Greenwich. A ICoordinateTransform object is then responsible for applying the following transformations:

For a ICoordinateTransform object created for a geographic coordinate system, the map coordinates represent the longitude and latitude after conversion to the geographic unit (see CoordinateSystem.GeographicUnit) and adjustment to the prime meridian (see GeodeticDatum.Meridian), although they are still being referred to as easting and northing.

See also

CoordinateSystem.CreateCoordinateTransform
ICoordinateOperation.CreateCoordinateTransform

Public / Methods

Flags

[Pure]
public method Flags → (1)

flags in : CoordinateSystemFlags

The coordinate system flags to apply.

returns → ICoordinateTransform

The resulting coordinate transform.

Applies the given coordinate system flags to this transform.

The given flags will change the interpretation of easting and northing values that are passed to MapToGeographic or returned from GeographicToMap.

Geographic​Clip

[Pure]
public method GeographicClip → (2)

latitude in : float64

The latitude angle, in radians.

longitude in : float64

The longitude angle, in radians.

returns → bool

true if the given coordinates are considered to be bad, false if they are ok.

Checks if the given coordinates lie within a bad region of this transformation.

Bad regions are where heavy distortion or coordinate wrap-around occurs. This method is intended to be used for visualization. It should not be used for data processing.

Geographic​To​Map

[Pure]
public method GeographicToMap → (2)

latitude in : float64

The latitude angle, in radians.

longitude in : float64

The longitude angle, in radians.

returns → Vec2D

The resulting easting (Vec2D.X) and northing (Vec2D.Y) values, in map units.

Performs the forward calculation.

Map​To​Geographic

[Pure]
public method MapToGeographic → (2)

easting in : float64

The easting coordinate, in map units.

northing in : float64

The northing coordinate, in map units.

returns → Vec2D

The resulting longitude (Vec2D.X) and latitude (Vec2D.Y) angles in radians, in terms of horizontal datum of geodata.

Performs the reverse calculation.

Extensions

Geographic​To​Map

2 overloads

[Pure]
public static method GeographicToMap1 → (1)

latLon in : LatLon

The latitude and longitude angles.

returns → Vec2D

The resulting easting (see Vec2D.X) and northing (see Vec2D.Y) values.

Performs the forward calculation.

[Pure]
public static method GeographicToMap2 → (1)

lonLat in : Vec2D

The longitude (Vec2D.X) and latitude (Vec2D.Y) angles, in radians.

returns → Vec2D

The resulting easting (see Vec2D.X) and northing (see Vec2D.Y) values.

Performs the forward calculation.

Map​To​Geographic

[Pure]
public static method MapToGeographic → (1)

eastingNorthing in : Vec2D

The easting (see Vec2D.X) and northing (see Vec2D.Y) values.

returns → Vec2D

The resulting longitude (see Vec2D.X) and latitude (see Vec2D.Y) angles, in radians.

Performs the reverse calculation.

Map​To​Geographic​Lat​Lon

2 overloads

[Pure]
public static method MapToGeographicLatLon1 → (2)

easting in : float64

The easting coordinate, in map units.

northing in : float64

The northing coordinate, in map units.

returns → LatLon

The resulting longitude and latitude.

Performs the reverse calculation.

[Pure]
public static method MapToGeographicLatLon2 → (1)

eastingNorthing in : Vec2D

The easting (see Vec2D.X) and northing (see Vec2D.Y) values.

returns → LatLon

The resulting longitude and latitude angles.

Performs the reverse calculation.