Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
dev:technology:core:crs [2022/01/25 14:23] mihaela [Vertical CRS Definitions] |
dev:technology:core:crs [2024/04/04 18:27] (current) glen |
||
---|---|---|---|
Line 9: | Line 9: | ||
Use of CRS units foot (ft) or US survey foot (USft) required special attention. | Use of CRS units foot (ft) or US survey foot (USft) required special attention. | ||
- | ===== Horizontal CRS Definitions ===== | + | ===== Horizontal CRS Definitions ===== |
==== EPSG registry ==== | ==== EPSG registry ==== | ||
Line 28: | Line 28: | ||
* Oblique_Stereographic (9809) | * Oblique_Stereographic (9809) | ||
* Transverse_Mercator (9807) | * Transverse_Mercator (9807) | ||
+ | * Transverse_Mercator_South_Orientated (9808) | ||
Supported Transformation methods (EPSG Code). \\ | Supported Transformation methods (EPSG Code). \\ | ||
Line 40: | Line 41: | ||
==== Local Horizontal Definitions ==== | ==== Local Horizontal Definitions ==== | ||
- | Orbit supports Local Horizontal CRS and Grid Corrections as defined by local authorities. \\ | + | Orbit supports Local Horizontal CRS and Grid Corrections as defined by local authorities. |
- | New definitions are added upon request, contact Orbit support. | + | |
- | * EPSG 2039, {{:dev: | + | * EPSG 2039, {{: |
- | * EPSG 9300, {{:dev: | + | * EPSG 2100, {{:technology: |
- | * EPSG 9301, {{:dev: | + | * EPSG 9320, {{: |
- | * EPSG 9322, {{:dev: | + | * EPSG 9321, {{: |
- | * EPSG 9366, {{:dev: | + | * EPSG 9322, {{: |
- | * EPSG 9370, {{:dev: | + | * EPSG 9300, {{:technology: |
- | * EPSG 9455, {{:dev: | + | * EPSG 9301, {{: |
- | * EPSG 27700, {{:dev: | + | * EPSG 9366, {{: |
- | * EPSG 27700, {{:dev: | + | * EPSG 9370, {{: |
- | * EPSG 28992, {{:dev: | + | * EPSG 9455, {{: |
+ | * EPSG 9738, {{:technology: | ||
+ | * EPSG 9972, {{: | ||
+ | * EPSG 27700, {{: | ||
+ | * EPSG 27700, {{: | ||
+ | * EPSG 28992, {{: | ||
* ESPG 29901, OSNI 1952 / Irish National Grid (OSTN02), Northern Ireland. | * ESPG 29901, OSNI 1952 / Irish National Grid (OSTN02), Northern Ireland. | ||
- | * ESPG 29901, {{:dev: | + | * ESPG 29901, {{: |
* EPSG 29903, TM75 / Irish Grid (OSTN02), Ireland. | * EPSG 29903, TM75 / Irish Grid (OSTN02), Ireland. | ||
- | * EPSG 29903, {{:dev: | + | * EPSG 29903, {{: |
- | * EPSG 31370, {{:dev: | + | * EPSG 31370, {{: |
+ | |||
+ | === Adding available Local Horizontal Definitions === | ||
Local Horizontal CRS definitions are not available by default. | Local Horizontal CRS definitions are not available by default. | ||
- | - Download, unzip and copy the CRS configuration files into the Orbit CRS directory \\ ''< | + | - Download, unzip, and copy the CRS configuration files into the Orbit CRS directory \\ ''< |
- Restart Orbit. \\ The Local Horizontal CRS definitions are linked automatically to the corresponding EPSG code. | - Restart Orbit. \\ The Local Horizontal CRS definitions are linked automatically to the corresponding EPSG code. | ||
- | Note related | + | === Request New Local Horizontal Definitions === |
+ | |||
+ | New definitions are added upon request, contact Orbit support. | ||
+ | |||
+ | === About OSTN02 and OSTN15 === | ||
+ | |||
+ | Related | ||
* OSTN02 and OSTN15 Local Horizontal CRS grid definitions include the corresponding Local Vertical CRS definition. | * OSTN02 and OSTN15 Local Horizontal CRS grid definitions include the corresponding Local Vertical CRS definition. | ||
* OSTN02 and OSTN15 grid files cannot be combined! Both are using the same EPSG codes. Do not copy both versions in the Orbit CRS directory. It is the one or the other. | * OSTN02 and OSTN15 grid files cannot be combined! Both are using the same EPSG codes. Do not copy both versions in the Orbit CRS directory. It is the one or the other. | ||
* Orbit' | * Orbit' | ||
- | |||
- | Notes related to Amersfoort RD New and NAP height, ESPG 28992 + 5709 | ||
- | * Amersfoort RD New Local Horizontal CRS definition includes the corresponding NAP height Local Vertical CRS definition. | ||
==== Custom Horizontal CRS ==== | ==== Custom Horizontal CRS ==== | ||
Line 78: | Line 88: | ||
''< | ''< | ||
- | Following | + | The following |
''< | ''< | ||
* < | * < | ||
* < | * < | ||
* Example " | * Example " | ||
+ | * Scale_Factor : maximum 3 digits | ||
The Custom Horizontal CRS will be available via the Orbit CRS Window by entering a) the projection name as stated in the prj content, b) its number as used in the prj file name, or c) via the CRS By Country list under Undefined Area. | The Custom Horizontal CRS will be available via the Orbit CRS Window by entering a) the projection name as stated in the prj content, b) its number as used in the prj file name, or c) via the CRS By Country list under Undefined Area. | ||
+ | |||
+ | ==== Data Transformation ==== | ||
+ | |||
+ | Orbit embeds the latest set of TOWGS84 transformation parameters known by the EPSG library. | ||
+ | |||
+ | Customization for the Geodetic CRS can be set via ''< | ||
+ | * Note: Strict data input is required within the.ini file. Data must imported Tab separated(reference transformations_to_4326.ini) | ||
==== Snake Grids ==== | ==== Snake Grids ==== | ||
Snake Grids are supported in orbit as Local Horizontal Definitions, | Snake Grids are supported in orbit as Local Horizontal Definitions, | ||
- | These specific horizontal definitions | + | These specific horizontal definitions |
- | === World Coordinates | + | === World Coordinates |
ETRS89/ | ETRS89/ | ||
Line 97: | Line 115: | ||
The Grid Shift Binary (GSB) defines the raster to interpolate a correction for each global lat/lon coordinate(WGS84/ | The Grid Shift Binary (GSB) defines the raster to interpolate a correction for each global lat/lon coordinate(WGS84/ | ||
Next, a custom horizontal projection is applied to obtain cartesian coordinates from the geographic coordinates. | Next, a custom horizontal projection is applied to obtain cartesian coordinates from the geographic coordinates. | ||
+ | |||
+ | ==== Inverted CRS definitions ==== | ||
+ | |||
+ | Orbit follows CRS specifications, | ||
+ | |||
+ | Unfortunately, | ||
+ | To consume user data provided as Easting-Northing, | ||
+ | The inverted CRS are in the range of 3 million. E.g ESPG 3001 (NE) and 3003001 (EN). | ||
+ | |||
+ | All CRS defined by EPSG to be Northing-Easing are pre-added to the list of Inverted CRS, and any EPSG code can be added to this list: <Install Dir>/ | ||
+ | |||
+ | |||
===== Vertical CRS Definitions ===== | ===== Vertical CRS Definitions ===== | ||
- | ==== Global and Local Vertical CRS Definitions | + | ==== Global and Local Vertical CRS ==== |
Orbit supports Global and Local Geoid references for the combined use of WGS84 Ellipsoidal and Orthometric height. \\ | Orbit supports Global and Local Geoid references for the combined use of WGS84 Ellipsoidal and Orthometric height. \\ | ||
New definitions are added upon request, contact Orbit support. | New definitions are added upon request, contact Orbit support. | ||
- | * EPSG 3855, {{:dev: | + | * EPSG 3855, {{: |
- | * EPSG 3855, {{:dev: | + | * EPSG 3855, {{: |
- | * EPSG 3900, {{:dev: | + | * EPSG 3900, {{: |
- | * EPSG 5610, {{:dev: | + | * EPSG 5610, {{: |
- | * EPSG 5613, {{:dev: | + | * EPSG 5613, {{: |
- | * EPSG 5773, {{:dev: | + | * EPSG 5621, {{: |
- | * EPSG 5701, ODN height, United Kingdom. \\ This Vertical CRS is included in the corresponding Local Horizontal CRS definition, see above. \\ This Vertical CRS includes additionally following | + | * EPSG 5701, ODN height, United Kingdom. \\ This Vertical CRS is included in the corresponding Local Horizontal CRS definition, see above. \\ Configurations for 5701 include additional |
* EPSG 5740, ODN Orkney height. | * EPSG 5740, ODN Orkney height. | ||
* EPSG 5741, Fair Isle height. | * EPSG 5741, Fair Isle height. | ||
Line 123: | Line 153: | ||
* EPSG 5749, St Marys height. | * EPSG 5749, St Marys height. | ||
* EPSG 5750, Douglas height. | * EPSG 5750, Douglas height. | ||
- | * EPSG 5703, {{: | + | * EPSG 5703, North American Vertical Datum of 1988 for the conterminous United States as defined by [[http:// |
* EPSG 6640, NMVD03 height, Northern Marianas Vertical Datum of 2003. | * EPSG 6640, NMVD03 height, Northern Marianas Vertical Datum of 2003. | ||
* EPSG 6641, PRVD02 height, Puerto Rico Vertical Datum of 2002. | * EPSG 6641, PRVD02 height, Puerto Rico Vertical Datum of 2002. | ||
Line 129: | Line 159: | ||
* EPSG 6643, ASVD02 height, American Samoa Vertical Datum of 2002. | * EPSG 6643, ASVD02 height, American Samoa Vertical Datum of 2002. | ||
* EPSG 6644, GUVD04 height, Guam Vertical Datum of 2004. | * EPSG 6644, GUVD04 height, Guam Vertical Datum of 2004. | ||
- | * EPSG 5705, {{ :209: | + | * EPSG 5705, {{: |
- | * EPSG 5709, NAP height, Netherlands. \\ This Vertical CRS is included in the corresponding Local Horizontal CRS definition, see above. | + | * EPSG 5709, {{: |
- | * EPSG 5720, {{ :dev: | + | * EPSG 5710, {{: |
- | * EPSG 5710, {{:dev: | + | * EPSG 5720, {{: |
* EPSG 5731, Malin Head height, Ireland. \\ This Vertical CRS is included in the corresponding Local Horizontal CRS definition, see above. | * EPSG 5731, Malin Head height, Ireland. \\ This Vertical CRS is included in the corresponding Local Horizontal CRS definition, see above. | ||
* EPSG 5732, Belfast height, Northern Ireland. \\ This Vertical CRS is included in the corresponding Local Horizontal CRS definition, see above. | * EPSG 5732, Belfast height, Northern Ireland. \\ This Vertical CRS is included in the corresponding Local Horizontal CRS definition, see above. | ||
- | * EPSG 5782, {{ :dev: | + | * EPSG 5773, {{:technology: |
- | * EPSG 5941,{{:dev: | + | * EPSG 5782, {{: |
- | * EPSG 7839, {{ :dev: | + | * EPSG 5783, {{:technology: |
- | * EPSG 9245, {{ :dev: | + | * EPSG 5941,{{: |
- | * EPSG 9988, {{ :dev: | + | * EPSG 6360, North American Vertical Datum of 1988 for the conterminous United States as defined by [[http:// |
- | * EPSG 9988, {{ : | + | * EPSG 7839, {{: |
+ | * EPSG 9245, {{: | ||
+ | * EPSG 9988, {{: | ||
Vertical CRS definitions are not available by default. This means that the vertical CRS can't be assigned to a horizontal CRS without relying on a resource representing the Geoid height. This resource doesn' | Vertical CRS definitions are not available by default. This means that the vertical CRS can't be assigned to a horizontal CRS without relying on a resource representing the Geoid height. This resource doesn' | ||
- Download, unzip and copy the CRS configuration files into the Orbit CRS directory : \\ ''< | - Download, unzip and copy the CRS configuration files into the Orbit CRS directory : \\ ''< | ||
- | - Verify and enter if missing the EPSG codes (semicolon separated) of the Horizontal CRS that needs to be linked to the Vertical CRS into following Vertical CRS configuration file : \\ '' | + | - Verify and enter if missing the EPSG codes (semicolon separated) of the Horizontal CRS that needs to be linked to the Vertical CRS into following Vertical CRS configuration file : \\ '' |
- Restart Orbit. | - Restart Orbit. | ||
- | ==== Custom Vertical CRS Definitions | + | ==== Custom Vertical CRS ==== |
Orbit supports Custom Vertical CRS via a Geoid Height Raster definition. | Orbit supports Custom Vertical CRS via a Geoid Height Raster definition. | ||
Line 157: | Line 189: | ||
* XYZ ascii file space, comma or semicolon separated. | * XYZ ascii file space, comma or semicolon separated. | ||
- | + | ==== Custom Vertical CRS via Offset or Scaling | |
- | === Custom Vertical CRS via Offset or Scaling === | + | |
Scaled and offset vertical CRS definitions. Custom Vertical CRS relies on already existing EPSG codes.\\ | Scaled and offset vertical CRS definitions. Custom Vertical CRS relies on already existing EPSG codes.\\ | ||
Line 164: | Line 195: | ||
Into the Orbit CRS directory :''< | Into the Orbit CRS directory :''< | ||
- | * Create a Vertical CRS prj file ''< | + | * Create a Vertical CRS prj file ''< |
* Create a Vertical CRS configuration file : '' | * Create a Vertical CRS configuration file : '' | ||
- Define the type transformation \\ '' | - Define the type transformation \\ '' | ||
- | - Enter the EPSG codes (semicolon separated) of the Horizontal CRS that needs to be linked to the Vertical CRS. For example : \\ '' | + | - Enter the EPSG codes (semicolon separated) of the Horizontal CRS that needs to be linked to the Vertical CRS. \\ For example: |
- | - Add the value of the offset. For example | + | - Add the value of the offset. |
Restart Orbit to acknowledge in the software the new custom CRS. | Restart Orbit to acknowledge in the software the new custom CRS. | ||
- | ===== Inverted CRS definitions ===== | + | ==== Datum Transformation |
- | For any coordinate system, Orbit follows the order of axes as defined by the EPSG library. As a result, Orbit expects data to also respect the order as defined by EPSG definition. | + | Datum transformations are applied as defined by EPSG on XY coordinates. Z values are conserved as is, and no transformation is applied. \\ |
- | + | ||
- | In practice, for various reasons like changes in the CRS definitions by local mapping authorities or different order of axes implementations in other software, data may be stored using a different order. | + | |
- | Because of this, you will find that some coordinate systems are listed as both the original crs and the inverted one in the Orbit CRS Library. | + | |
- | + | ||
- | To define the projection of any resource, the original CRS should be used if the data is stored according to the EPSG order axes definition, and the inverted CRS should be used for data in which the order is reversed. | + | |
- | + | ||
- | ===== Datum Transformation ===== | + | |
- | + | ||
- | Datum transformations are applied as defined by EPSG on XY coordinates. Z values are conserved as is, no transformation is applied. \\ | + | |
Datum transformation on Z values can be enabled e.g. to combine multiple 3D data resources with different ellipsoid height definitions. | Datum transformation on Z values can be enabled e.g. to combine multiple 3D data resources with different ellipsoid height definitions. | ||
See [[dev: | See [[dev: | ||
- | ===== International | + | ===== Imperial CRS, International |
Projected CRS using International feet (ft) or US survey feet (ftUS) units require special attention. | Projected CRS using International feet (ft) or US survey feet (ftUS) units require special attention. | ||
- | The Orbit Core and Map Components support Projected CRS using ft and ftUS. Orbit uses https:// | + | The Orbit Core and Map Components support Projected CRS using ft and ftUS. Orbit uses https:// |
- | ==== MapCanvas | + | Some Extensions expect data to be stored as meters or degrees to operate properly. \\ |
+ | When converting ft or ftUS Projected | ||
- | The MapCanvas CRS can be set to any CRS supported by Orbit - feet or metric. Although for optimal rendering performance, | + | ===== Orbit CRS Settings ===== |
- | Absolute measurements (2D and 3D Coordinates) use the MapCanvas | + | === Map CRS === |
- | ==== Resource | + | All visible Datasets are re-projected on-the-fly into the Map CRS, if the Dataset CRS differs from the Map CRS. Orbit supports imagery to be reprojected. |
- | A resource | + | The Map CRS can be set to any supported |
- | * Some Orbit Extensions expect data to be stored | + | For optimal rendering performance, |
- | * For Oblique, UAS and Mobile Mapping | + | If no Datasets are visible in the workspace, then the first visible Dataset CRS will set the Map CRS. |
- | * All resources of a run or project should have the same CRS. | + | |
- | When using these converted resources, display and exports | + | The Map CRS can be set via [[dev: |
+ | The Map CRS is stored | ||
+ | The Start-Up Map CRS can be set and locked via [[dev: | ||
- | ==== Units of Measurements ==== | + | === Dataset CRS === |
- | see [[dev: | + | Orbit applies a CRS for every Dataset. If no Dataset CRS is set, Orbit assumes the Dataset CRS to be the same as the Map CRS. \\ |
+ | When combining Datasets with the different CRS, it is advised to define the CRS for every Dataset. \\ | ||
- | ===== Orbit Dataset CRS ===== | + | The Dataset CRS must be set correctly to any supported geocentric, geographic, or projected |
+ | * For ft and ftUS datasets it is advised to convert at import to the equivalent Metric Projected CRS (see note about Imperial CRS above). | ||
+ | * For Mapping Resources it is advised to convert at import all included Datasets into the same Dataset CRS. | ||
- | Every single resource has a CRS. \\ | + | The Dataset |
- | If no Orbit dataset | + | The Dataset |
- | There are two ways to set the CRS of a dataset in Orbit : | + | === Measurement Units === |
- | * [[dev: | + | |
- | * [[dev: | + | |
- | The dataset | + | Absolute measurements (2D and 3D Coordinates) use the MapCanvas CRS. In case the vertical MapCanvas |
- | * [[dev: | + | |
- | ===== Orbit Map CRS ====== | + | see [[dev: |
- | + | ||
- | All resources are displayed in the Map CRS. If the Dataset CRS differs from the Map CRS then the dataset will be re-projected on the fly to be displayed on Map. | + | |
- | + | ||
- | === Optimize Performance === | + | |
- | + | ||
- | Re-projecting datasets from their source Dataset CRS into another target Map CRS requires processing time. Consequently, | + | |
- | + | ||
- | === Deformations === | + | |
- | + | ||
- | Re-projecting means deforming. To retain shape, angles, and presentation it's again advised to use the Dataset CRS as Map CRS. | + | |
- | + | ||
- | === Define Map CRS === | + | |
- | + | ||
- | The Map CRS can be changed quickly via the map status bar " | + | |
- | Open this window via a single click on the current Map CRS in the [[dev: | + | |
- | + | ||
- | The map CRS on start-up is defined in your workspace | + | |
- | * Orbit desktop Standalone : [[dev: | + | |
- | * Orbit desktop Client, set by administrator via the [[dev: | + | |
- | + | ||
- | === Default behavior and preferences === | + | |
- | + | ||
- | If no datasets are visible in the current workspace then the first visible dataset CRS will be used as Map CRS. | + | |
Last modified:: 2022/01/25 14:23