CoordinateOperationMethod

Description

[ShutdownSurvive]
abstract class Tinman.Terrain.Georef.CoordinateOperationMethod

Derived from

GeoObject abstract

Abstract base class for coordinate operation methods.

This class also provided various default implementations for well-known transformations.

Public / Constants

Albers


public static readonly attribute Albers → (CoordinateOperationMethod)

Albers (conic, equal-area)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9822: Albers Equal Area

  • GeoTIFF-11: CT_AlbersEqualArea

  • OpenGIS WKT: Albers_Conic_Equal_Area

  • PROJ: +proj=aea

Cassini


public static readonly attribute Cassini → (CoordinateOperationMethod)

Cassini-Soldner (cylindrical)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9806: Cassini-Soldner

  • GeoTIFF-18: CT_CassiniSoldner

  • OpenGIS WKT: Cassini_Soldner

  • PROJ: +proj=cass

Equirectangular


public static readonly attribute Equirectangular → (CoordinateOperationMethod)

Equidistant (cylindrical)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-1028: Equidistant Cylindrical

  • GeoTIFF-17: CT_Equirectangular

  • OpenGIS WKT: Equirectangular

  • PROJ: +proj=eqc

Face


public static readonly attribute Face → (CoordinateOperationMethod)

Maps geographic coordinates (latitude, longitude) onto a cubemap face.

The mapping from geographic coordinates and cubemap face coordinates is established by the Cubemap class (see Cubemap.GeographicToCube2 and Cubemap.CubeToFace2). Map coordinates (easting, northing) are mapped to cubemap face coordinates as follows:

a = r * pi / 4
map(-a, -a) => face(0, 0);
map( a, -a) => face(n, 0);
map(-a,  a) => face(0, n);
map( a,  a) => face(n, n);

where n is the maximum cubemap coordinate and r is the radius of the reference sphere (will be Ellipsoid.RadiusOfAuthalicSphere for ellipsoids).

These parameters are defined for this transform:

The latitude and longitude parameters are only used to choose the cubemap face. It is recommended to obtain their values by using LatLon.ForCubemapFace.

Lambert​Azimuthal


public static readonly attribute LambertAzimuthal → (CoordinateOperationMethod)

Lambert (azimuthal, equal-area)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9820: Lambert Azimuthal Equal Area

  • GeoTIFF-10: CT_LambertAzimEqualArea

  • OpenGIS WKT: Lambert_Azimuthal_Equal_Area

  • PROJ: +proj=laea

Lambert​Conic


public static readonly attribute LambertConic → (CoordinateOperationMethod)

Lambert (conic, conformal)

These parameters are defined for this transform:

For the 1SP variant:

For the 2SP variant:

The following coordinate operation methods are mapped to this transform factory:

  • PROJ: +proj=lcc

For the 1SP variant:

  • EPSG-9801: Lambert Conic Conformal (1SP).

  • GeoTIFF-9: CT_LambertConfConic_Helmert

  • OpenGIS WKT: Lambert_Conformal_Conic_1SP

For the 2SP variant:

  • EPSG-9802: Lambert Conic Conformal (2SP)

  • GeoTIFF-8: CT_LambertConfConic_2SP

  • OpenGIS WKT: Lambert_Conformal_Conic_2SP

Lambert​Cylindrical


public static readonly attribute LambertCylindrical → (CoordinateOperationMethod)

Lambert (cylindrical, equal-area)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9835: Lambert Cylindrical Equal Area

  • GeoTIFF-28: CT_CylindricalEqualArea

  • OpenGIS WKT: Cylindrical_Equal_Area

  • PROJ: +proj=cea

Mercator


public static readonly attribute Mercator → (CoordinateOperationMethod)

Mercator (cylindrical, conformal)

These parameters are defined for this transform:

For the A variant:

For the B variant:

The following coordinate operation methods are mapped to this transform factory:

  • GeoTIFF-7: CT_Mercator

  • PROJ: +proj=merc

For the A variant:

  • EPSG-9804: Mercator (variant A)

  • OpenGIS WKT: Mercator_1SP

For the B variant:

  • EPSG-9805: Mercator (variant B)

  • OpenGIS WKT: Mercator_2SP

Oblique​Mercator​A


public static readonly attribute ObliqueMercatorA → (CoordinateOperationMethod)

Oblique Mercator (cylindrical, conformal)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9812: Hotine Oblique Mercator (variant A)

  • GeoTIFF-3: CT_ObliqueMercator

  • OpenGIS WKT: Hotine_Oblique_Mercator

  • PROJ: +proj=omerc

Oblique​Mercator​B


public static readonly attribute ObliqueMercatorB → (CoordinateOperationMethod)

Oblique Mercator (cylindrical, conformal)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9815: Hotine Oblique Mercator (variant B)

  • GeoTIFF-9815: CT_HotineObliqueMercatorAzimuthCenter

  • OpenGIS WKT: Hotine_Oblique_Mercator_Azimuth_Center

  • PROJ: +proj=omerc

Oblique​Stereographic


public static readonly attribute ObliqueStereographic → (CoordinateOperationMethod)

Oblique Stereographic (azimuthal, conformal)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9809: Oblique Stereographic

  • GeoTIFF-14: CT_Stereographic

  • GeoTIFF-16: CT_ObliqueStereographic

  • OpenGIS WKT: Stereographic

  • OpenGIS WKT: Oblique_Stereographic

  • PROJ: +proj=sterea

Polar​Stereographic


public static readonly attribute PolarStereographic → (CoordinateOperationMethod)

Polar Stereographic (azimuthal, conformal)

These parameters are defined for this transform:

For the variant A:

The following coordinate operation methods are mapped to this transform factory:

  • GeoTIFF-15: CT_PolarStereographic

  • OpenGIS WKT: Polar_Stereographic

  • PROJ: +proj=stere

For the variant A:

  • EPSG-9810: Polar Stereographic (variant A)

For the variant B:

  • EPSG-9829: Polar Stereographic (variant B)

Popular​Mercator


public static readonly attribute PopularMercator → (CoordinateOperationMethod)

Popular Visualisation Pseudo Mercator

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-1024: Popular Visualisation Pseudo Mercator

  • OpenGIS WKT: Mercator_Auxiliary_Sphere

Sinusoidal


public static readonly attribute Sinusoidal → (CoordinateOperationMethod)

Sinusoidal (pseudo-cylindrical, equal-area)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • GeoTIFF-24: CT_Sinusoidal

  • OpenGIS WKT: Sinusoidal

  • PROJ: +proj=sinu

Toast


public static readonly attribute Toast → (CoordinateOperationMethod)

TOAST (Tessellated Octahedral Adaptive Subdivision Transform)
https://docs.worldwidetelescope.org/data-guide/1/spherical-projections/toast-projection

The following figure illustrates the mapping that is established by this coordinate operation:

(A)-----(B)-----(C)
 |      /|\      |       |   X  |   Y  |  LAT | LON-1 | LON-2 |
 |     / | \     |    ---+------+------+------+-------+-------+
 |    /  |  \    |     A | -90° |  90° | 90°S |   -   |   -   |
 |  (D)  |  (E)  |     B |   0° |  90° |  0°  |  90°E |  90°W |
 |  /    |    \  |     C |  90° |  90° | 90°S |   -   |   -   |
 | /     |     \ |     D | -45° |  45° |  0°  | 135°E |  45°W |
 |/      |      \|     E |  45° |  45° |  0°  |  45°E | 135°W |
(F)-----(G)-----(H)    F | -90° |   0° |  0°  | 180°  |   0°  |
 |\      |      /|     G |   0° |   0° | 90°N |   -   |   -   |
 | \     |     / |     H |  90° |   0° |  0°  |   0°  | 180°  |
 |  \    |    /  |     I | -45° | -45° |  0°  | 135°W |  45°E |
 |  (I)  |  (J)  |     J |  45° | -45° |  0°  |  45°W | 135°E |
 |    \  |  /    |     K | -90° | -90° | 90°S |   -   |   -   |
 |     \ | /     |     L |   0° | -90° |  0°  |  90°W |  90°E |
 |      \|/      |     M |  90° | -90° | 90°S |  45°W | 135°E |
(K)-----(L)-----(M)

X: Easting, Y: Northing, LAT := Latitude
LON-1: Longitude (inside), LON-2: Longitude (outside)

These parameters are defined for this transform:

The sign of the CoordinateOperationParameter.Scale parameters chooses between the inside and outside projections:

The floor of the absolute value of the CoordinateOperationParameter.Scale parameter chooses the projection variant:

  • 0 : linear interpolation, according to the figure above.

  • 1 : spherical interpolation using the base octahedron.

  • n : spherical interpolation using the (n-1)-th octahedron subdivision.

Commonly used subdivision levels are 0 (e.g. Hallo Northern SKY planetarium program) and 6 (e.g. WorldWide Telescope). The maximum value for n is 8; larger values will be clamped.

Transverse​Mercator


public static readonly attribute TransverseMercator → (CoordinateOperationMethod)

Transverse Mercator (cylindrical, conformal)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9807: Transverse Mercator

  • GeoTIFF-1: CT_TransverseMercator

  • OpenGIS WKT: Transverse_Mercator

  • PROJ: +proj=tmerc

Transverse​Mercator​South


public static readonly attribute TransverseMercatorSouth → (CoordinateOperationMethod)

Transverse Mercator South Oriented (cylindrical, conformal)

These parameters are defined for this transform:

The following coordinate operation methods are mapped to this transform factory:

  • EPSG-9808: Transverse Mercator (South Oriented)

  • GeoTIFF-27: CT_TransvMercator_SouthOriented

  • OpenGIS WKT: Transverse_Mercator_South_Orientated

Public / Constructors

Topocentric


public method Topocentric → (3)

datum in : GeodeticDatum

[not-null]
The geodetic datum to use.

center in : LatLon

Geographic coordinates of the map origin. The longitude angle is interpreted absolute, i.e. it is not relative to the prime meridian of datum in.

unit opt : UnitOfMeasure = null

Unit of projected coordinates. If null, UnitOfMeasure.Metre will be used.

returns → CoordinateSystem

The projected coordinate system.

Creates a coordinate system which uses this coordinate operation method and is centered at the given coordinates.

The following coordinate operation parameters are initialized by this method:

The final values for easting and northing will be chosen so that center in is mapped to Vec2D.Zero.

GeorefException

If the geo-reference parameters are incomplete or invalid.

Public / Methods

Create​Coordinate​Transform


public abstract method CreateCoordinateTransform → (2)

ellipsoid in : Ellipsoid

[not-null]
The ellipsoid specification.

parameters in : ICoordinateOperationParameters

[not-null]
The parameter values.

returns → ICoordinateTransform

The created ICoordinateTransform object.

Creates a new instance of ICoordinateTransform, using the given parameters.

GeorefException

If parameters in are incomplete.

Default​Parameters


[EmptyBody]
public virtual method DefaultParameters → (1)

parameters in : CoordinateOperation

[not-null]
The parameters to update.

Sets default parameter values for undefined parameters.

Validate​Parameters


public method ValidateParameters → (1)

parameters in : ICoordinateOperationParameters

[not-null]
The parameters to validate.

returns → CoordinateOperationParameter [ ]

The missing parameters or null if all required parameters are present.

Validates the given parameters for this coordinate operation method.

Protected / Constructors

Coordinate​Operation​Method

2 overloads


protected constructor CoordinateOperationMethod1 → (1)

serialType in : ISerialTypeInfo

[not-null]
The serial type ID.

Creates a new instance of CoordinateOperationMethod.


protected constructor CoordinateOperationMethod2 → (2)

serialType in : ISerialTypeInfo

[not-null]
The serial type ID.

name in : string

Human-readable name of the geo object. If empty or null, GeoObject.UserDefined will be used instead.

Creates a new instance of CoordinateOperationMethod.

Protected / Methods

Do​Validate​Parameters


[EmptyBody]
protected virtual method DoValidateParameters → (2)

parameters in : ICoordinateOperationParameters

The parameters to check.

missing in : ICollector<CoordinateOperationParameter>

Output for missing parameters.

Validates the given parameters for this coordinate operation method.

Map​To​Origin


protected virtual method MapToOrigin → (1)

map in : Vec2D

The map coordinates, as returned by ICoordinateTransform.GeographicToMap.

returns → Vec2D

The coordinate operation parameter values to use:
Vec2D.X : CoordinateOperationParameter.Easting
Vec2D.Y : CoordinateOperationParameter.Northing

Computes coordinate operation parameter values that will move the given map in coordinates to the coordinate system origin.

Configuration

Config


public static attribute Config → (get)

value : IConfigurator<CoordinateOperationMethod>

[not-null]
The configurator object.

The configurator object for this type.