Table of Contents
TGIS_CSDatum class
DK for Java | tatukgis.jdk.TGIS_CSDatum | Classes | Constructors | Methods | Properties
Datum definition combining an ellipsoid and datum transformation parameters used to relate coordinates to WGS84 (World Geodetic System 1984, EPSG:4326).
Syntax
// Java public class TGIS_CSDatum extends TGIS_CSAbstract { };
// Oxygene type TGIS_CSDatum = public class( TGIS_CSAbstract ) end;
Inheritance
→ TGIS_Object → TGIS_CSAbstract
Constructors
| Name | Visibility | Description | |
|---|---|---|---|
| TGIS_CSDatum() | public | Creates a coordinate system definition with default values. (Inherited from TGIS_CSAbstract) |
|
| TGIS_CSDatum(int, java.lang.String) | public | Creates a coordinate system definition element with an EPSG (European Petroleum Survey Group) code and WKT (Well-Known Text) name. (Inherited from TGIS_CSAbstract) |
|
| TGIS_CSDatum(int, java.lang.String, int, int) | public | Create a datum definition. | |
| TGIS_CSDatum(int, java.lang.String, int, int, int) | public | Create a datum definition. | |
Methods
| Name | Visibility | Description | |
|---|---|---|---|
| Assign | public | Copies the shared definition fields from another object. (Overrides TGIS_CSAbstract.Assign) |
|
| FromWGS | public | Shifts a geodetic coordinate from WGS84 (World Geodetic System 1984) to this datum. | |
| FromWGS3D | public | Shifts a geodetic 3D coordinate from WGS84 (World Geodetic System 1984) to this datum. | |
| FromWGS3D_Ref | public | Shifts a geodetic 3D coordinate from WGS84 (World Geodetic System 1984) to this datum. | |
| MarkDeprecated | public | Marks this coordinate system definition as deprecated or current. (Inherited from TGIS_CSAbstract) |
|
| ToString | public | (Inherited from TGIS_CSAbstract) |
|
| ToWGS | public | Shifts a geodetic coordinate from this datum to WGS84 (World Geodetic System 1984). | |
| ToWGS3D | public | Shifts a geodetic 3D coordinate from this datum to WGS84 (World Geodetic System 1984). | |
| ToWGS3D_Ref | public | Shifts a geodetic 3D coordinate from this datum to WGS84 (World Geodetic System 1984). | |
Properties
| Name | Visibility | Description | |
|---|---|---|---|
| Deprecated | public | Indicates whether this definition is deprecated. (Inherited from TGIS_CSAbstract) |
|
| Description | public | Description of the coordinate system definition. (Inherited from TGIS_CSAbstract) |
|
| DescriptionEx | public | Descriptive name; for internal use of TGIS_CSAbstractListHelper. (Inherited from TGIS_CSAbstract) |
|
| Ellipsoid | public | Ellipsoid definition used by the datum. | |
| EPSG | public | EPSG code. (Inherited from TGIS_CSAbstract) |
|
| Fallback | public | EPSG (European Petroleum Survey Group) code of the fallback coordinate transformation used when the grid shift transformation has a fallback defined. | |
| FriendlyName | public | Friendly name constructed from the WKT name and EPSG code. (Inherited from TGIS_CSAbstract) |
|
| MasterEPSG | public | EPSG code of the object for which the current object is an alias. (Inherited from TGIS_CSAbstract) |
|
| Transform | public | Default coordinate transformation definition. | |
| WKT | public | WKT name. (Inherited from TGIS_CSAbstract) |
|
Remarks
PURPOSE: Encapsulates a geodetic datum, including its ellipsoid and default transformation path. Datums define how longitude/latitude coordinates relate to the Earth's physical surface, making them essential for integrating spatial data from different sources.
BEHAVIOR: Resolves the ellipsoid from the supplied EPSG (European Petroleum Survey Group) code and raises an exception if it does not exist. It also resolves the default transformation and, when that transformation is a grid shift transform, assigns the fallback EPSG code to that transform and stores it on the datum.
USAGE: Use a datum when looking up a predefined geodetic datum and its default transformation metadata.
datum = TGIS_CSDatum(...) ellipsoid = datum.Ellipsoid transform = datum.Transform
CONSTRAINTS: A valid ellipsoid EPSG code is required or construction raises EGIS_Exception. Fallback handling is applied only for grid shift transformations.