Coordinate Reference Systems

This page describes use and application of Coordinate Reference Systems in Orbit.
For basic concepts and theory about the coordinate system, datum and projection, see Coordinate Reference System in Theory.

Orbit supports Horizontal and Vertical Coordinate Reference Systems.
Geographic and projected Horizontal CRS can be used and combined on the fly. Geocentric CRS are supported but need be converted upon import to a supported Geographic or Projected CRS. Use of CRS units foot (ft) or US survey foot (USft) required special attention.

Horizontal CRS Definitions

EPSG registry

Orbit has the objective to support the most recent definition of horizontal coordinate reference systems as defined by the OGP (International Association of Oil and Gas Producers) and described in the EPSG library. Orbit respects the order of axes as defined by the EPSG Library.

Supported Projection methods (EPSG Code).
Missing methods are added upon request, contact Orbit support.

Supported Transformation methods (EPSG Code).
Missing methods and local grid-based corrections are added upon request, contact Orbit support.

Local Horizontal CRS Definitions

Orbit supports Local Horizontal CRS and Grid Corrections as defined by local authorities.
New definitions are added upon request, contact Orbit support.

Local Horizontal CRS definitions are not available by default.

  1. Download, unzip and copy the CRS configuration files into the Orbit CRS directory
    <Orbit installation directory>/program/system/crs/
  2. Restart Orbit.
    The Local Horizontal CRS definitions are linked automatically to the corresponding EPSG code.

Note related to OSTN02 and OSTN15 for ESPG 27700, 29901 and 29903.

Notes related to Amersfoort RD New and NAP height, ESPG 28992 + 5709

Custom Horizontal CRS Definitions

Orbit supports Custom Horizontal CRS via a Prj file as defined by the OGC.

Copy the OGC structured Prj file into the Orbit CRS directory and restart Orbit :
<Orbit installation directory>/program/system/crs/

Following file name syntax must be applied to the copied Prj file :
<number>_<description>.prj

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.

Vertical CRS Definitions

Global and Local Vertical CRS Definitions

Orbit supports Global and Local Geoid references for combined use of WGS84 Ellipsoidal and Orthometric height.
New definitions are added upon request, contact Orbit support.

Vertical CRS definitions are not available by default.

  1. Download, unzip and copy the CRS configuration files into the Orbit CRS directory :
    <Orbit installation directory>/program/system/crs/
  2. 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 :
    vertical_<EPSG Vertical CRS>.ini
    For example
    available.in.horizontal.crs 4326;3395;31370
  3. Restart Orbit.

Custom Vertical CRS Definitions

Orbit supports Custom Vertical CRS via a Geoid Height Raster definition.

In cooperation with the Orbit Support team, Geoid reference resource files can be converted into the required Orbit CRS configuration files.
One of the following resources representing the Geoid height 1) can be used to create the CRS configuration files :

Custom Vertical CRS via Offset or Scaling

Scaled and offset vertical CRS definitions.

Inverted CRS definitions

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.

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.

International feet and US survey feet

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://www.epsg-registry.org/ as the reference database. In United States, the Federal definition of the CRS is metric at all time, but State law defines the CRS in International feet or US survey feet.

MapCanvas CRS

The MapCanvas CRS can be set to any CRS supported by Orbit - feet or metric. Although for optimal rendering performance, we do advice to use the CRS of the resources which are currently viewed.

Absolute measurements (2D and 3D Coordinates) use the MapCanvas CRS. In case the vertical MapCanvas CRS is in feet, than the Z-coordinate will be visualized in feet in the measurement sidebar.

Resource CRS

A resource can have any CRS supported by Orbit - feet or metric. But be careful with the following:

When using these converted resources, display and exports can still be set to ft or ftUS to get exactly the expected results. A user won't notice the data is actually stored using the parent metric CRS.

Units of Measurements

see Preferences of Map Canvas

Orbit Dataset CRS

Every single resource has a CRS.
If no Orbit dataset CRS is set, Orbit will read the resource assuming that dataset has the same coordinate system as the MapCanvas (see below). When combining resources with different coordinate system it is strongly recommended to define the coordinate system for every single resource.
Orbit supports imagery to be reprojected on the fly.

There are two ways to set the CRS of a dataset in Orbit :

The dataset CRS is saved in the Orbit Resource Descriptor file :

Orbit Map CRS

All resources are displayed in the Map CRS. If the Dataset CRS differs from the Map CRS than 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 large vector or point cloud resource will take more time to load and will slow down map rendering. It is advised to avoid on the fly re-projection by using the Dataset CRS as Map CRS. When using multiple resource having different Dataset CRS, it is advised to use the Dataset CRS of the resources having most vertices as Map CRS.

Deformations
Re-projecting means deforming. To retain shape, angles and presentation it's again advised to used the dataset crs as map crs.

Define Map CRS
The Map CRS can be changed quickly via the map status bar “Coordinate Reference System selection” window.
Open this window via a single click on the current map crs in the map statusbar.

The map crs on start-up is defined in your workspace

Default behavior and preferences
If no datasets are visible in the current workspace, than the first visible datset crs will be used as map crs.

1)
Local Vertical CRS Definitions, Geoid height represents the height offset from Geoid reference to Ellipsoid reference. A Digital Terrain or Surface Model is not a Geoid Model.