CoordinateSystemTransform

Description

sealed class Tinman.Terrain.Georef.CoordinateSystemTransform

A CoordinateSystemTransform object is used to transform coordinates from one CoordinateSystem (geographic or projected) into another one.

The CoordinateSystemTransform class wraps zero, one or two ICoordinateTransforms (for projected source and/or target coordinate system) and zero or one IDatumTransforms (for different GeodeticDatums).

Public / Constructors

Coordinate​System​Transform


public constructor CoordinateSystemTransform → (4)

source in : CoordinateSystem

[not-null]
The source coordinate system.

target in : CoordinateSystem

[not-null]
The target coordinate system.

datum opt : IDatumTransform = null

Optional datum transform. If null, a lookup will be performed into the current GeoRegistry (see datumLookup opt).

datumLookup opt : bool = true

Perform a lookup into the current GeoRegistry if datum opt is null?

Creates a new instance of CoordinateSystemTransform.

GeorefException

If the geo-reference parameters are incomplete or invalid.

For


public static method For → (2)

source in : CoordinateSystem

The source coordinate system.

target in : CoordinateSystem

The target coordinate system.

returns → CoordinateSystemTransform

The created CoordinateSystemTransform object or null if source in or target in is null or no transformation is necessary (according to IsIdentity) or if the geo-reference parameters are incomplete or invalid.

Creates a new instance of CoordinateSystemTransform.

Public / Methods

Datum


[Pure]
public static method Datum → (4)

source in : CoordinateSystem

[not-null]
The source coordinate system.

target in : CoordinateSystem

[not-null]
The target coordinate system.

datum opt : IDatumTransform = null

The datum transform to use. If null, a lookup will be performed into the current GeoRegistry (see datumLookup opt).

datumLookup opt : bool = true

Perform a lookup into the current GeoRegistry if datum opt is null?

returns → IDatumTransform

The IDatumTransform object.

Returns the IDatumTransform to use for conversions between source in and target in.

Reverse


public method Reverse → ()

returns → CoordinateSystemTransform

The reverse transform.

Return the reverse coordinate system transform.

Transform​Scale


[Pure]
public method TransformScale → (1)

scale in : float64

The scale in the source coordinate system.

returns → float64

The scale in the target coordinate system.

Transforms the given scale.

When transformation between a geographic coordinate system and a projected or local coordinate system, the geographic scale factor (see CoordinateSystem.GeographicScale) will be taken into account, in addition to the unit conversion factor.

Public / Attributes

Is​Identity


public attribute IsIdentity → (get)

value : bool

true if this is the identity transform, false if not.

Checks if this coordinate system transform is the identity transform.

This property only refers to the numerical identity of the transformation, i.e. output coordinates will be equal to input coordinates.

Source


public attribute Source → (get)

value : CoordinateSystem

[not-null]
The source coordinate system.

The source coordinate system.

Source​Transform


public attribute SourceTransform → (get)

value : ICoordinateTransform

[not-null]
The ICoordinateTransform object.

Returns the ICoordinateTransform object that has been created for Source.

Target


public attribute Target → (get)

value : CoordinateSystem

[not-null]
The target coordinate system.

The target coordinate system.

Target​Transform


public attribute TargetTransform → (get)

value : ICoordinateTransform

[not-null]
The ICoordinateTransform object.

Returns the ICoordinateTransform object that has been created for Target.