Skip to main content

Datum Definitions

Updated

The DataSourceEditor GUI allows you to add, change and delete user-defined Horizontal Datums, and to view all Horizontal Datums. Optionally, you can pass ObjectType.HorizontalDatum into the DataSourceEditor constructor to filter the editor window to only show Horizontal Datums, ObjectType.VerticalDatum for Vertical Datums, or ObjectType.Datum for both.

More:

Create a new Datum

  1. Create a DataSourceEditor object and display it with the Show method.

  2. With the Horizontal Datum folder selected, right-click in the right-hand pane and select New Object, or click the Add (+) button below the pane. A new blank Horizontal Datum Editor dialog will open. To create a new Vertical Datum, do the same, but with the Vertical Datum folder selected. There are two tabs on both the Horizontal and the Vertical Datum Editor:

    Identification

    The Identification tab is used to name the object and associate identifying codes with it (if applicable).  


    • The Name field is where you need to enter the appropriate name for the definition; the name entered is the name that will be used to select the object in the main list.  
    • The Remarks field can be used to add notes on a definition and is optional.  
    • The Identifiers list may be used to add identifying codes for an object that may be referenced in other databases.  The GC code is a unique identifier assigned by GeoCalc which cannot be altered.  To enter additional codes, right-click in the space below.
    • Deprecated may be checked to indicate an object is no longer being used, either because there are errors in the definition, or because it has been superseded by another object. If this is checked, you will be provided with a date picker to set the date on which the object was deprecated. This will default to the current date.

    Details

    The Details tab is used to define the object's parameters.  For Horizontal Datums you must select the ellipsoid the datum is based on, as well as the prime meridian used. Vertical Datums have only the Datum Type definition.

    Datum Type: Choose to specify whether the datum definition is Dynamic or Ensemble. None is the default selection if neither one is specified.

    • Dynamic: Allows you to choose a Frame Reference Epoch to include time evolution in the definition. This is the starting epoch for the datum.
    • Ensemble: Defines the datum as a collection of multiple realizations of the same horizontal or vertical reference system.

    Datum Type definitions play no functional role in GeoCalc at this time and is only used for informational purposes.

  3. Click OK to close the Horizontal or Vertical Datum Editor.

  4. To save the definition permanently, click the Save button on the right hand side of the DataSourceEditor dialog.

  5. Click OK to close the DataSourceEditor dialog, your new definition is complete and may be used within GeoCalc.

Change an existing Datum

  1. Create a DataSourceEditor object and display it with the Show method.

  2. Select the object from the Datum list.

    You can only edit objects shown in blue.

  3. Double click the object you want to edit to open its definition.

  4. Change any of the values and press the OK button.

  5. To save the definition permanently, click the Save button on the right hand side of the DataSourceEditor dialog.

Delete an existing Datum

  1. Create a DataSourceEditor object and display it with the Show method.

  2. Select the unit from the Datum list.

    You can only delete objects shown in blue.

  3. Select the object, right-click it and select Delete Object or click the Trash Can button below the object list.

  4. To save the deletion permanently, click the Save button on the right hand side of the DataSourceEditor dialog.