Geodetics Documentation. 29 January 2021

1.2.1.1 How-to Open an existing Project . . . 9

1.2.1.2 How-to Open a Project with a recorded database . . . 11

1.2.1.3 How-to Open a Project from folder . . . 13

1.2.1.4 How-to Use a Copied template with different Geodetics . . . 15

1.2.1.5 How-to Use the Geoid Model Migration Tool . . . 16

1.3 Questions & Answers . . . 24

1.3.1 EPSG database? What is EPSG? . . . 25

1.3.2 What is WKT? . . . 26

1.4 Reference Manual . . . 28

1.4.1 Geodetic Configuration Overview Dialog . . . 29

1.4.2 Search Dialog . . . 34

1.4.3 Setup Coordinate System . . . 39

1.4.4 Setup Engineering Coordinate System . . . 40

1.4.5 Setup Geographic Coordinate System . . . 42

1.4.6 Setup Map Projection . . . 44

1.4.7 Setup Transform . . . 46

1.4.8 Setup Vertical Datum . . . 48

1.4.9 Test Coordinate Reference System . . . 49

1.5 Release Notes . . . 53

Geodetic User Interface Documentation

Geodetic Setup - Getting Started How-to Articles

How-to Videos Questions & Answers Reference Manual Release Notes Technical Information Webinars

1. 2. 3. 4.

Geodetic Setup - Getting Started

Geodetic User Interface

On this page:

Introduction

1. Importing a WKT string

2. Selecting a Predefined Geodetic Configuration 3. Using the Guided Setup

4. Defining a Coordinate System through the 'Edit' button

Introduction

It is possible to define the Geodetics when a new Project is created for both Qimera and Qinsy, or it can be edited from the Qinsy Console if using Qinsy. In Qimera, this is only done during the project creation stage.

When a new project is created, Qinsy will fill in the last used Geodetics by default;

It is possible to edit these by selecting the 'Edit' button;

The Create Project dialog has a common look and feel between Qinsy and Qimera, but the lower section of the dialog where Geodetics are configured varies slightly. This is done in order to accommodate different workflows that existed in the two products prior to the creation of the new Geodetic Interface.

When the Geodetic User Interface is selected, it is possible to define the Geodetics in four ways:

Importing a WKT string Selecting a Predefined Geodetic Setup

Using the Geodetic Wizard Using the Edit option The start up the experience for Qimera allows for very simple configurations to be chosen, such as:

Automatic selection of a projection once files are added Selection of a single coordinate reference system where a transformation is not required

Creation of a Full Geodetic Configuration, including definition of

transformations

The Qinsy start up experience uses the Overview Wizard exclusively to provide the full advanced configuration option, the other options are hidden.

Qimera Project Setup Qinsy Project Setup

1.

When a WKT string is created or available, it is possible to import this Press 'Load' and select 'Load Configuration from File'

Windows File Explorer will pop up where the user can select the WKT string

When the WKT string is selected, the Geodetic User Interface will automatically extract the info that is available

The large icons in front of every entry box indicate the status of the entry:

2. Selecting a Predefined Geodetic Configuration

Press 'Load' and select 'Load Predefined Configuration'

A pop-up window will appear where the user can select the

configuration that will be used

3. Using the Guided Setup

When the Guided Setup (wizard) is used, the user needs to define at least the Project Coordinate Reference System (1)

When the user wants to transform from a different Input Source Coordinate System (2) to a Projected Coordinate System (1), then also a transformation (3) needs to be selected

It is possible to define the Project Coordinate System in three ways:

Using the Drop down menu, and selecting the wanted Coordinate System

1. 2. 3. 4. 5. 6.

4. Defining a Coordinate System through the 'Edit' button

When the Coordinate System is defined through the 'Edit' button, the following screen will appear:

Project Coordinate System: This is the name of the system that is used Geographical Coordinate System: it will show the name and EPSG code of the selected System Map Projection: How the data is projected Local Engineering Coordinate System: Same as Local Construction Grid previously

Vertical Datum: Used Geoid for vertical calculations

Survey Units: Possibility to define the survey units

How-to Articles

How-to Geodetic Upgrade Qinsy 8.18.3 to 9.3

How-to Open an existing Project

How-to Open a Project with a recorded database How-to Open a Project from folder

How-to Use a Copied template with different Geodetics How-to Use the Geoid Model Migration Tool

Related pages:

EPSG database? What is EPSG? What is WKT?

Geodetic Setup - Getting Started

How-to Open an existing Project

QINSy 8.X.XX to Qinsy 9.0.0

When Qinsy 9.0 is started and an existing 8.X.XX project is selected, it will ask the user to upgrade the project, because it was created in an older version.

It is also possible to upgrade the recorded databases but a warning will be shown that it will not be possible to use the upgraded databases in an older Qinsy version.

When the upgrade is done, Qinsy will show the following information:

Template back-up

Once Qinsy extracted the Geodetic information from the original DB and has copied it to the project itself:

During the upgrade from version 8.X.XX to version 9.X.XX, a back-up of the database was generated. This database can still be used in an older QINSy version.

How-to Open a Project with a recorded database

Create a project with recorded databases from an older version

It is possible to create a project from a folder that only contains recorded databases or a template, like QINSy 8.X. XX

Select 'Build Project from Folder' and Qinsy will open the Windows File Explorer where it is possible to select the folder that contains the data

If the folder only contains recorded databases, Qinsy will show the 'Database Upgrader'

The user needs to update the recorded databases

A back-up is created, and will be placed in the Backup folder in the database folder of the project tree

If the folder only contains recorded databases, Qinsy will show the following warning:

When 'OK' is selected, the Geodetic User Interface is opened so that the user can define the Geodetics

How-to Open a Project from folder

Project from folder (with 8.18.3 data), template is available and

geodetics are extracted

When Qinsy 9 is opened with a project that was created in an older Qinsy version, the project Upgrader will pop up: It is possible to upgrade the recorded databases and the template

Qinsy will create a back-up of the files. These files are placed in the folder 'Backup'. This folder can be found in the Database folder of the Qinsy Project tree

If the user wants to revert back to the Qinsy version that is used to record the data, delete the '_backup'.

When the upgrade is done, Qinsy will show the information that the Geodetics are extracted from the existing template

If the cloning is done, check the Geodetics in the Geodetic User Interface, and verify that everything is correct

How-to Use a Copied template with different Geodetics

Using a template with already set geodetics

If you open a Project with already set geodetics and you try to add an existing template with different geodetics:

Qinsy offers to synchronize the geodetics that are present in the copied template with the following warning:

The warning contains:

An explanation regarding a geodetic difference between the selected template and the geodetics in the project

An option to update the template geodetics with the geodetics from the project

The option to make a backup of this selected template The option to cancel the update

'Cancel'

If the user selects 'Cancel', the following warning will pop-up: Nothing is updated and extracted;

The template is not selected and it is not possible to go online with the template that has different Geodetic Settings; The user can change this by opening the 'Setup' and select the template with different Geodetic Settings;

How-to Use the Geoid Model Migration Tool

Questions & Answers Workflow overview How do I use this tool?

Questions & Answers

The Geoid Model Migration Tool is used to update user created geoid models so they can be used in Qinsy 9. Why is this update needed?

In QINSy 8 the models were all listed in the Geoidmodels.xml file. In Qinsy 9 we started working with EPSG and WKT files. Because of this, the information for the Geoidmodels.xml is now also moved to WKT.

Each geoid model file (this can be *.bin, *.gtx, *.grd, etc.) will have to be accompanied by a WKT file. Why is this tool needed?

You may ask why we don't do this automatically?

This is because we have seen many customers updating the Geoidmodels.xml manually.

Since there are some differences in how we use the Geoidmodels.xml and WKT, we want to make sure these are created correctly. When do I need to use this tool?

When you have files listed in the following folder that don't have a WKT yet but are included in the Geoidmodels.xml: C:\Users\Public\Documents\QPS\Shared\Geo\Geoid

This may look like shown in the picture below:

Do I need to use this tool if I use QGFVOM files?

No, these files do not need to be updated and can be used directly in Qinsy 9 and Qimera 2.

Workflow overview

Below you will find the steps in more detail. This is just to give you a general idea of the workflow. Open any Qinsy project;

Open the Geoid Model Migration Tool; Update the models in order to create WKT files;

Once all the models are updated, you need to restart Qinsy; Then open the project dialog to create a new project; Setup your geodetics and select the user created model. Open the Test tool to confirm a test coordinate.

How do I use this tool?

In this part you can find the following items.

General

Updating geographic models Updating projected models Verification

General

Finding the tool in Qinsy

The tool can be opened in the Qinsy Console.

If it is not there you can add it like shown below.

Updating models

1. 2. 3.

Select the Geoidmodels.xml files from which you would like to update the models. By default this will be the location of the user created models.

Select the model for which you would like to create a WKT.

Make sure to check the ID numbers so that they are all unique.

Click 'Upgrade'.

Updating geographic models

1. 2. 3. 4. 5. 6. a. b. 7. 8.

The dialog will then look like this:

This is the path where the geoid model file is located; Shows you the file format which in this case is Geographic; Horizontal unit for the Latitude and Longitude;

Vertical unit for the separation values; Extents of the area and the step size;

This shows you if a model is Absolute or Relative:

Absolute - separation values are referenced to a Datum (for example ETRS '89 or NAD '83 (2011)); Relative - separation values are referenced to another offset model (which is Absolute).

Select the datum on which the separation model was created. So in this case the Latitude and Longitude were defined on WGS '84. This is the datum to which the separation value is linked.

1. 2. 3. 4. 5. 6. a. b. 7. 8. 9. 10.

Updating projected models

Some models have Easting/Northing coordinates with a separation value.

The dialog will then look like this:

This is the path where the geoid model file is located; Shows you the file format which in this case is Projected; Horizontal unit for the Easting and Northing;

Vertical unit for the separation values; Extents of the area and the step size;

This shows you if a model is Absolute or Relative:

Absolute - separation values are referenced to a Datum (for example ETRS '89 or NAD '83 (2011)); Relative - separation values are referenced to another offset model (which is Absolute).

Select which datum and projection on which the separation model was created. This is the datum to which the separation value is linked.

So in this case the value will be applied to GDA94. Here you can select what you target vertical datum can be;

This is more administrative. This can be a model for which an EPSG code is defined. Or, like in this case, LAT, for example.

Here you can edit the name of the model that is shown in the Geodetic User Interface;

QGFVOM

a. b. 12. 13. a. b. 1. 2. 1. 2. 3.

Spline - spline interpolation using 16 points (4 by 4 window around the current position); Bilinear - linear interpolation using 4 points around the current position.

A fixed Transform accuracy can be edited here; Model ID that is extracted from the Geoidmodels.xml:

Make sure the ID is unique to prevent conflicts;

TIP - If you hover you mouse over it, a range for ID numbers will be shown.

Verification

In the tool

Once it is upgraded you can check the following from the tool:

You can select Edit if you want to make any additional changes; Open the containing folder to check if the WKT was created. In the Geodetic UI

Close the tool; Restart Qinsy;

Set up your geodetics. More info on how to set this up can be found here:

4.

5.

a. b.

Open the geodetic test tool to confirm if the model is working.

The following example shows what you can expect:

The separation value from the model applied on that location; The resulting height relative to LAT in this example. Some people might see this as a chart datum. If this does not work

It could be that the test coordinate is outside the model; Maybe the model was not recognized properly by Qinsy. In that case try the following:

Restart Qinsy; Open the Geodetic UI;

Select another vertical model and then select you user defined model again. Try the test tool again.

It could be that the model was not updated properly. In that case:

Open the Geoid Model Migration Tool again; Select you model on the right side; Click 'Edit' and check the settings.

Questions & Answers

EPSG database? What is EPSG? What is WKT?

EPSG database? What is EPSG?

The EPSG group created the EPSG database which is a collection of definitions of coordinate reference systems and coordinate transformations which may be global, regional, national or local in application.

Each system or entry in the EPSG database has a unique code, so that it is possible to search for information when only the code is available. Some examples:

EPSG 4326 : Refers to the WGS84 Coordinate Reference System; EPSG 6326 : Refers to the datum that is used with WGS84; EPSG 8901 : Refers to the Prime Meridian that passes Greenwich; EPSG 6422 : Refers to the Ellipsoid that is used with WGS84;

What is WKT?

WKT stands for Well-Known Text and is a text markup language for representing vector geometry objects on a map, spatial reference systems of spatial objects and transformations between spatial reference systems.

At this moment, Qinsy supports a variant of WKT version 1. The WKT file that is used in Qinsy contains also transformations that normally are not supported by WKT version 1.

However, the Qinsy WKT version is not the same as WKT version 2 and will not work for the transformations that are available in WKT version 2. WKT can represent the following distinct geometric objects:

Point, MultiPoint LineString, MultiLineString Polygon, MultiPolygon, Triangle PolyhedralSurface

TIN (Triangulated irregular network) GeometryCollection

WKT Export / Import

When a Geodetic Configuration is created in the Qinsy Geodetic Configuration User Interface, it is possible to export this configuration to a WKT string and send it to another user.

The next user can simply import this WKT string through the Load function of the Geodetic User Interface and will have the same configuration as defined by the first user.

Example

The following WKT example shows the information of the ETRS89 to Dutch Datum transformation: TRANSFORM["ETRS89 (EUREF89) to Dutch Datum (RD)",

GEOGCS["ETRS89",

DATUM["European Terrestrial Reference System 1989",

SPHEROID["GRS 1980", 6378137, 298.257222101, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]], AUTHORITY["EPSG", "7019"]], AUTHORITY["EPSG", "6258"]], PRIMEM["Greenwich", 0, AUTHORITY["EPSG", "8901"]], UNIT["degree", 0.0174532925199433, AUTHORITY["EPSG", "9102"]], AUTHORITY["EPSG", "4258"]], GEOGCS["Amersfoort", DATUM["Amersfoort",

SPHEROID["Bessel 1841", 6377397.155, 299.1528128, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]], AUTHORITY["EPSG", "7004"]], AUTHORITY["EPSG", "6289"]],

PRIMEM["Greenwich", 0, AUTHORITY["EPSG", "8901"]],

UNIT["degree", 0.0174532925199433, AUTHORITY["EPSG", "9102"]], AUTHORITY["EPSG", "4289"]],

PARAM_MT["molodensky_badekas",

PARAMETER["cx", 3904046.173, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]]], PARAMETER["cy", 368161.312, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]]], PARAMETER["cz", 5013449.051, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]]], PARAMETER["dx", -593.0248, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]]], PARAMETER["dy", -25.9984, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]]], PARAMETER["dz", -478.7459, UNIT["meter", 1, AUTHORITY["EPSG", "9001"]]],

PARAMETER["ex", -1.9342, UNIT["microradian", 9.9999999999999995e-007, AUTHORITY["EPSG", "9109"]]], PARAMETER["ey", 1.6677, UNIT["microradian", 9.9999999999999995e-007, AUTHORITY["EPSG", "9109"]]], PARAMETER["ez", -9.1019, UNIT["microradian", 9.9999999999999995e-007, AUTHORITY["EPSG", "9109"]]], PARAMETER["ppm", -4.0725, UNIT["part per million", 9.9999999999999995e-007, AUTHORITY["EPSG", "9202"]]], AUTHORITY["EPSG", "9636"]],

Reference Manual

The purpose of the Geodetic User Interface (UI) is to enable a user to configure geodetics under a number of circumstances within the QPS Product Suite.

Examples are configuring geodetics for Qinsy acquisition operations or configuring geodetics for a Qimera project.

The Geodetic UI will be consistent across all products with only slight variations in configuration entry points for each product. The following pages describe the function of each page or panel of the Geodetic UI:

Geodetic Configuration Overview Dialog Search Dialog

Setup Coordinate System

Setup Engineering Coordinate System Setup Geographic Coordinate System Setup Map Projection

Setup Transform Setup Vertical Datum

Geodetic Configuration Overview Dialog

Geodetic Configuration Overview Guided Setup

Project Coordinate System Widget Vertical Coordinate System Widget Source Coordinate System Widget Transformation Widget Load Button Save Button Test Button Help Button Advanced Setup Configuration Tree Add Button Project Coordinate System Source Coordinate System Custom Project Coordinate System Transformation Custom Transformation Edit Button Remove Button Map Tab Parameters Tab WKT Tab

Geodetic Configuration Overview

This dialog is a shared component between Qinsy, Qimera and Fledermaus 8 and is used to set up a full Geodetic Configuration. You can choose between the Guided Setup or Advanced Setup using the labeled button at the top of the dialog.

A Geodetic Configuration consists of, at a minimum, a Project Coordinate System.

Additionally it can contain a Source Coordinate System and optionally a Transformation between the datum in the Project Coordinate System and the datum in the Source Coordinate System.

You can also optionally have a Vertical Coordinate System.

Guided Setup

The Guided Setup walks you through the configuration steps by implying a specific order to the steps you must take to setup a Geodetic Configuration.

The first step is the selection of the Project Coordinate System. For Qinsy and Qimera, this is the geodetic definition for your processed products such as QPD files and Dynamic Surfaces.

After you have selected a Project Coordinate System you can configure a Vertical Coordinate System. Once your Project Coordinate System is configured, you can add a Source Coordinate System.

For Qinsy and Qimera, this can define the coordinate system used when importing navigation information.

After you add a Source Coordinate System, you will be able to configure a specific Transformation that is used to transform coordinates between your Source Coordinate System and the target geographic component of your Project Coordinate System.

Project Coordinate System Widget

Use the combo box to see a list of Recently Used, User Defined and EPSG Defined projected coordinate systems. You can select from the list or start typing to filter the contents of the list.

Optionally you can use the Search button to launch the Search Coordinate Reference Systemdialog which allows you to search for Projecte or coordinate systems.

d Compound

Finally you can use the Edit button to launch the Setup Coordinate Systemdialog.

This dialog allows you to create a completely custom coordinate system. Use the Remove button to remove the current component from the configuration.

Vertical Coordinate System Widget

Use the Edit button to launch the Setup Vertical Datumdialog.

This button becomes enabled once you have defined the Project Coordinate System.

Source Coordinate System Widget

Use the combo box to see a list of Recently Used, User Defined and EPSG Defined geographic coordinate systems. You can select from the list or start typing to filter the contents of the list.

Optionally you can use the Search button to launch the Search Coordinate Reference Systemdialog which allows you to search for Geogra coordinate systems.

phic

Finally you can use the Edit button to launch the Setup Geographic CRSdialog. This dialog allows you to create a completely custom geographic coordinate system.

Use the Remove button to remove the current component from the configuration. This widget becomes enabled once you have defined the Project Coordinate System.

Transformation Widget

Use the Search button to launch the Searchdialog which searches specifically for transformations between the Source Coordinate and the geographic component of your

System Project Coordinate System.

Use the Edit button to launch the Setup Transformdialog.

It will pre-populate the Source/Target Coordinate System with your Source Coordinate System and your the geographic component of your Projec t Coordinate System.

You can then proceed to create a custom transform for your configuration. Use the Remove button to remove the current component from the configuration.

This widget becomes enabled once you have defined the Project Coordinate System and a Source Coordinate System.

Load Button

The Load Predefined Configuration option will launch the Load Predefined Geodetic Configuration dialog shown below. Simply select a configuration from the list.

Save Button

The Save As User Defined Configuration option will launch the dialog shown below.

The configuration will be available in the Load Predefined Geodetic Configuration dialog the next time it is used.

The Save Configuration to File option will export the current configuration to a file. Use this option if you need to send your configuration to other users.

Test Button

The Test button will launch the Test Coordinate Reference System dialog.

Help Button

The Help button with launch the Geodetic User Interface help documentation.

Advanced Setup

Configuration Tree

The Configuration Tree shows you the detailed information about your current configuration.

If you select on an entry, you can see more detail using the Map, Paramters and WKT tab of the dialog. Using a selection in the tree, you can also edit or remove an entry using the buttons described below.

Add Button

Project Coordinate System

This launches the Search Coordinate Reference Systemdialog and allows you to search for either Projected or Compound coordinate systems. If your configuration already has a Project Coordinate System, the one you choose will replace the existing one in your configuration.

Qinsy and Qimera require the Project Coordinate System to be a Projected coordinate system as apposed to a Geographic coordinate system. Source Coordinate System

This launches the Search Coordinate Reference Systemdialog and allows you to search for Geographic coordinate systems. If your configuration already has a Source Coordinate System, the one you choose will replace the existing one in your configuration. Custom Project Coordinate System

This launches the Setup Coordinate Systemdialog.

This dialog allows you to create a completely custom coordinate system for the Project Coordinate System part of your configuration. Transformation

This launches the Searchdialog and searches specifically for transformations between the Source Coordinate System and the geographic component of your Project Coordinate System.

Custom Transformation

This launches the Setup Transformdialog.

It will pre-populate the Source/Target Coordinate System with your Source Coordinate System and your the geographic component of your Proje ct Coordinate System.

You can then proceed to create a custom transform for your configuration.

Edit Button

The Edit button will bring up the Setup dialog for the currently selected configuration component.

Remove Button

The Remove button will remove the currently selected configuration component.

Map Tab

For more details on this tab, see the Map Tab section of the Search dialog.

Parameters Tab

For more details on this tab, see the Parameters Tab section of the Search dialog.

WKT Tab

Search Dialog

Search Dialog

The Search Dialog is used for any type of geodetic component searching. When you search, you will always get the same user experience. The only difference is the geodetic component you are searching on. For example, the Search Dialog is used to search for geographic or projected coordinate systems, map projections, geodetic datums, and transformations. For the purpose of this reference manual section, we will use projected coordinate system searching as our example.

Filtering

Filtering allows you to reduce the number of geodetic items that are searched whenever the search edit text is changed. The first filter is the geodetic item type. For example, if you are searching for a project coordinate system, your choices are All, Projected, and Compound. The first filter will change according to what geodetic item type you are searching (i.e. coordinate systems, datum, transformation...) . The second filter is the geodetic Area that will be searched. The first two choices are All Areas and Map. These first choices will be followed by every available country area from Aaland Islands through Zimbabwe. All Areas will not restrict you search by area. The Map option will restrict your search to the geodetic items that define an area of use that intersects the current map view. When this option is chosen, as you pan/zoom around the map,

the tree view will change to display the geodetic items available in that area. To reset any filter simply click on the button.

Search

The search text area is used to search for text tokens or EPSG codes of the geodetic items. If the search text is blank, the object list will contain every geodetic item that fits the constraints of your filters. As you type, the geodetic list is automatically updated with results that contain your search text. Remember you can search for numeric EPSG codes or text tokens. The text tokens will search both the geodetic item name and the region name. Examples of search text are: "32619", "Amersfoort", "GDA2020 MGA". The first yields the specific coordinate system with that EPSG code. The second example yields 2 projected and 1 compound coordinate system. The last yields 14 coordinate systems. If you have only 1 search token and it is numeric, the interface will consider that as an EPSG code and search accordingly. If you have more than one search token, it will use those to search against the geodetic item name and the area of use. If all tokens are found, the item will be added to the list. This can be considered an "AND" search of your tokens so the more tokens you have, the more refined the search will be. The only variant of the multiple search token logic is when you are searching for transformations. If you have 2 search tokens and they are both numeric, these will be used as the source or target entries for a transformation. For example, in the search text box for the Geodetic Configuration Overview

, you could enter "4230 4326" which would give you a number of results for transformations between ED50 and WGS 84.

Dialog

When you select one of the results from your query in the geodetic list, the corresponding area of use will be highlighted on the map and displayed in text under the map next to the "Area:" label (if an area is defined for this geodetic item). It will additionally fill out the Parameters tab and the WKT tab with the relevant information for the geodetic item.

The button is a quick way to search based on the current map view. This button will clear the search tokens and just search on the area. The geodetic list will be filled with the items whose area of use intersects the current map view. If you want to add tokens to an map area search, change the second filter to Map and then add the specific search tokens.

The results list contains the result of the search combined with the selected filters. The results list will show the geodetic item Name, EPSG code and Region. The Region is the primary component of the detailed area of use. When you select an entry from this list, the selected item will be used to highlight an area of use on the map, fill in the Parameter tab and fill in the WKT string tab. Additionally, when you select an entry from this list and click the OK button, that item will be loaded to the widget that called it.

This tab shows the current map view highlighting the selected geodetic item's area of use. It can also be used as a spatial component of your search.

Map Navigation

Use the left-mouse-button to click and drag the map to a new location. Use the mouse wheel to zoom in and out of the map.

Map Toolbar

Use this button to zoom in on the map.

Use this button to zoom out on the map.

Use this button to zoom to the center of the selected area of use.

Use this button to zoom out to the extents of the map.

This tab shows the attributes and associated values of the selected geodetic item.

Setup Coordinate System

Setup Coordinate System Project Coordinate System Geographic Coordinate System Map Projection Local Engineering Coordinate System Vertical Datum Survey Unit

Setup Coordinate System

This dialog is used to set up a coordinate system. You can create a coordinate system from scratch or edit one in order to create a custom coordinate system. You can create a Geographic, Projected or Compound coordinate system. There is an implied sequence for using this dialog which is why some components are not enabled until you fill in certain pieces.

Each component of the Coordinate System consists of a Name and EPSG field and has either a Search or Setup button where applicable. Using the search button brings up the Search Dialog for that particular geodetic type. Using the Setup button will bring up the Setup dialog specific to that geodetic type.

Project Coordinate System

The Project Coordinate System is the full name of the coordinate system and the associated EPSG code. This widget is read only. The construction of this name is automated by the GUI and is not editable. It is composed by joining the following: Geographic Coordinate System Name, "/", Map Projection Name, "+", Vertical Coordinate System Name, "+", Engineering Coordinate System Name. If you create a custom coordinate system or edit an existing coordinate system, the EPSG code will initially be blank until you save your work and the coordinate system has been added to your local catalog.

Geographic Coordinate System

The Geographic Coordinate System is the name of the geographic coordinate system used in the composite coordinate system. This widget and the associated EPSG code is read only. Click on the Search button to bring up the Search Dialog for Geographic Coordinate Systems. Click on the Setup button to go to Setup Geographic Coordinate System.

Map Projection

The Map Projection is the name of the projection grid used in the Projected Coordinate System. This widget and the associated EPSG code is read only. Click on the Search button to bring up the Search Dialog for Map Projections. Click on the Setup button to go to Setup Map

. Projection

Local Engineering Coordinate System

The Local Engineering Coordinate System is the name of the local engineering grid used in the Project Coordinate System. This widget and the associated EPSG code is read only. Click on the Setup button to go to Setup Engineering Coordinate System.

Vertical Datum

The Vertical Datum is the name of the vertical coordinate system used in the Project Coordinate System. This widget and the associated EPSG code is read only. Click on the Search button to bring up the Search Dialog for Vertical Coordinate Systems. Click on the Setup button to go to S

. etup Vertical Datum

Setup Engineering Coordinate System

Setup Engineering Coordinate System Name

Datum Type

Local Grid (Point and Azimuth) Local Grid (Two Common Points)

Setup Engineering Coordinate System

This dialog is used to setup a local engineering grid to transform your horizontal coordinates into a local reference frame. This is frequently used in construction operations to that the coordinates are all referenced to a local grid.

Name

The Name field is completely custom and will not have an EPSG code. Enter the name you want to have for your Engineering Grid.

Datum

The Datum field is also completely custom and will not have an EPSG code. Enter the name you want to have for your Engineering Grid datum.

Type

Select the type of Engineering Grid that you want to use.

Local Grid (Point and Azimuth)

This is the parameter view for this type. A simple example is that you enter an Easting and Northing point in your survey area such as (4401340.0, 343256.0).

If you leave the Easting/Northing values of the Engineering Grid as 0.0, then the Projection Grid position becomes the (0.0,0.0) location and ever other position is referenced to this point.

It is essentially an Affine transformation to get to the local grid coordinates. You can also add an Azimuth value for both the Engineering Grid and the Projection Grid to get a relative azimuth.

Finally you can have Easting and Northing scaling values.

Setup Geographic Coordinate System

Setup Geographic Coordinate System Name

Datum Ellipsoid Prime Meridian

Setup Geographic Coordinate System

This dialog is used to setup a Geographic Coordinate System. You can create one from scratch or modify an existing Geographic Coordinate System. There is an implied hierarchy to the customization of the data which will result in text fields automatically getting Custom appended to the text name. The custom rules for this are as follows:

Directly modifying the Prime Meridian table data will automatically add 'Custom' to the Prime Meridian, Datum and Name fields. Directly modifying the Ellipsoid table data will automatically add 'Custom' to the Ellipsoid, Datum and Name fields.

Selecting a Prime Meridian using the combo box will automatically add 'Custom' to the Datum and Name fields. Selecting an Ellipsoid using the combo box will automatically add 'Custom' to the Datum and Name fields.

Changing the Prime Meridian name to a custom name will automatically add 'Custom' to the Datum and Name fields. Changing the Ellipsoid name to a custom name will automatically add 'Custom' to the Datum and Name fields. Selecting a new Datum using search will automatically add 'Custom' to the Name field.

Changing the Datum name to a custom name will automatically add 'Custom' to the Name field.

Wikipedia Geodetic Datum Wikipedia Reference Ellipsoid

Name

This field is editable but the EPSG is read only. Use the Search button to launch the Search Dialog to search for a new Geographic Coordinate System. If you change the Coordinate System name to a custom name, the EPSG will clear.

Datum

This field is editable but the EPSG is read only. Use the Search button to launch the Search Dialog to search for a new Datum. The custom rules above apply for any type of editing.

Ellipsoid

Use the combo box to select a different ellipsoid or modify the parameter values to create a custom ellipsoid. You can also change the units using the combo box which affects both the storage and display of the parameter data. The custom rules above apply for any type of editing. The parameter table contains the following parameters:

Semi-major - Length of the semi-major axis of the ellipsoid

Semi-minor - Length of the semi-minor axis of the ellipsoid

Inverse Flattening - Inverse flattening value of the ellipsoid - This is the length unit of the ellipsoid Unit (length)

If the Semi-major or Semi-minor values are changed, the Inverse Flattening will automatically update. If the Inverse Flattening is changed, the Se value will automatically update. If any of these value are manually changed, you are creating a custom ellipsoid which will result in the

mi-minor El

and fields having appended if the name is not already a custom name.

lipsoid, Datum Name Custom

Prime Meridian

Use the combo box to select a different prime meridian or modify the parameter values to create a custom prime meridian. You can also change the units using the combo box which affects both the storage and display of the parameter data. The custom rules above apply for any type of editing. The parameter table contains the following parameter:

Longitude - Longitude of Prime Meridian relative to Greenwich in the United Kingdom. - This is the angle unit for the longitude

Setup Map Projection

Setup Map Projection Name Type Parameters

Horizontal Offset Model Supported Projection Types

Setup Map Projection

This dialog is used to set up the Map Projection for the Project Coordinate System.

If you select a different projection Type from the combo box or edit any of the values in the Parameter table, your Map Projection Name will automatically have 'Custom' appended.

You can edit this name but if you choose a name that is a standard Map Projection, the dialog will automatically update all values.

Wikipedia Map Projection.

Name

This field is editable but the EPSG is read only. Use the Search button to launch the Search Dialog to search for a new Map Projection. If you change the Name to a custom name, the EPSG will clear.

Type

The Projection Type combo contains all of the currently supported projection types. If you change the projection type, your Map Projection becomes a custom projection. The list of supported projection types can be found below.

Parameters

The parameters shown will depend on the selected projection type. If you modify parameters of an existing Map Projection, the Name will automatically have 'Custom' appended.

The possible unit fields that will appear in the table are as follows: - This is the unit for time parameters such as

Unit (scale) Scale factor at natural origin

- This is the unit for length parameters such as

Unit (length) False Easting

- This is the unit for angular parameters such as

Unit (angle) Longitude of natural origin

Horizontal Offset Model

The Horizontal Offset Model combo box supports only the following offset models that are dependent on the Projected Coordinate System you select.

If there are no horizontal offset models available, the widget will be disabled. RDNAPTRANS correctiegrid (2000)

RDNAPTRANS correctiegrid (2004) RDNAPTRANS correctiegrid (2008)

BD72LB72,BD72/LB72 correctiegrid (Belgium)

Supported Projection Types

Projection Authority

Albers Equal Area {EPSG: 9822}

American Polyconic {EPSG: 9818}

Equidistant Cylindrical {EPSG: 1028} Equidistant Cylindrical (Spherical) {EPSG: 1029} Hotine Oblique Mercator (variant A) {EPSG: 9812} Hotine Oblique Mercator (variant B) {EPSG: 9815} Lambert Azimuthal Equal Area {EPSG: 9820} Lambert Conic Conformal (1SP) {EPSG: 9801} Lambert Conic Conformal (2SP Belgium) {EPSG: 9803} Lambert Conic Conformal (2SP Michigan) {EPSG: 1051} Lambert Conic Conformal (2SP) {EPSG: 9802} Lambert Conic Conformal (West Orientated) {EPSG: 9826}

Mercator (Spherical) {EPSG: 1026}

Mercator (variant A) {EPSG: 9804}

Mercator (variant B) {EPSG: 9805}

Mercator (variant C) {EPSG: 1044}

New Zealand Map Grid {EPSG: 9811}

Oblique Stereographic {EPSG: 9809}

Polar Stereographic (variant A) {EPSG: 9810} Polar Stereographic (variant B) {EPSG: 9829} Polar Stereographic (variant C) {EPSG: 9830} Popular Visualisation Pseudo Mercator {EPSG: 1024}

Pseudo Plate Carree {EPSG: 9825}

Swiss Oblique Cylindrical {EPSG: 9814}

Transverse Mercator {EPSG: 9807}

Setup Transform

Setup Transform Name

Source Coordinate System Target Coordinate System Method

Parameters

Supported Transform Methods

Setup Transform

This dialog is used to setup a transform between two geographic coordinate systems.

If you select a different transform Method from the combo box or edit any of the values in the Parameters table, your Transform Name will automatically have 'Custom' appended.

You can edit this name but if you choose a name that is a standard Transform, the dialog will automatically update all values.

Name

This field is editable but the EPSG is read only. Use the Search button to launch the Search Dialog to search for a new Transform. If you change the Transform name to a custom name, the EPSG will clear.

Source Coordinate System

This is the geographic coordinate system that you are transforming "from".

If you are using this dialog from the Geodetic Overview this value may already be filled in.

Use the Search button to launch the Search Dialog to search for a new Source Geographic Coordinate System.

If the transformation is reversable, you can use the Invert Source and Target to swap the source/target and update the transformation values automatically.

Target Coordinate System

This is the geographic coordinate system that you are transforming "to". If you are using this dialog from the Geodetic Overview this value may already be filled in.

Use the Search button to launch the Search Dialog to search for a new Target Coordinate System.

If the transformation is reversable, you can use the Invert Source and Target to swap the source/target and update the transformation value automatically.

Method

The Method combo contains all of the currently supported transform types.

If you change the method, your Transform becomes a custom Transform and 'Custom' will automatically be appended to the name . The list of supported transform methods can be found below.

Parameters

The parameters shown will depend on the selected transform method. If you modify parameters of an existing Transform, the Name will automatically have 'Custom' appended.

- This is the unit for length parameters such as

Unit (length) X-axis translation

- This is the unit for angular parameters such as

Unit (angle) X-axis rotation

- This is the unit for time parameters such as

Unit (scale) Scale difference

Unit (time) - This is the unit for time parameters such as Coordinate Epoch

Supported Transform Methods

Method Authority

Geocentric translations {EPSG: 9603/1031} Coordinate Frame rotation {EPSG: 9607/1032} Position Vector transformation {EPSG: 9606/1033} Molodensky-Badekas (CF) {EPSG: 9636} Molodensky-Badekas (PV) {EPSG: 1061/1063}

Geographic2D offsets {EPSG: 9619}

NADCON {EPSG: 9613}

NTv2 {EPSG: 9615}

Norway Offshore Interpolation {EPSG: 9620} Time-dependent Coordinate Frame {EPSG: 1056} Time-dependent Position Vector {EPSG: 1053}

Setup Vertical Datum

Setup Vertical Datum Geoid Height Model Height Correction Model Fixed Height Offset Vertical Datum Datum

Setup Vertical Datum

This dialog is used to setup a vertical coordinate system which can contain any combination of an absolute height model, a relative height model and a manual/fixed offset.

This will result in a compound coordinate system which contains either a projected or geographic horizontal coordinate system and the configured vertical coordinate system.

Geoid Height Model

Use the combo box to select a Geoid Height Model.

If you have not set the Vertical Coordinate System, it will automatically be set based on the vertical coordinate system of the model.

Height Correction Model

Use the combo box to select a Height Correction Model.

Selecting a relative height model will override the Vertical Coordinate System according to the vertical coordinate system of the Height Correction

.

Model

Fixed Height Offset

Click the checkbox to enable entry of a Fixed Height Offset. Enter a number directly or use the spin box to change the value.

Vertical Datum

You can set the Vertical Datum using the Search button to launch theSearch Dialog which will search on vertical coordinate systems only.

Note that this is typically set via your choice of the Geoid Height Model and/or Height Correction Model.

Datum

Test Coordinate Reference System

Test Coordinate Systems Data Entry Fields

Geographic Coordinates Projected Coordinates Geographic Units Format Option Projected Units Formation Option Export Button

Print Button

Test Coordinate Systems

This dialog is accessed via the Test button from the Geodetic Configuration Overview Dialog.

It will take the configuration coordinate systems and put them in the Input and Output Coordinate System combo boxes. You then choose which coordinate system you want as your Input and which one you want as your Output.

You will then be able to convert from one to the other.

If you choose a geographic coordinate system, you will have to enter coordinates as: Latitude, Longitude, Ellipsoidal Height or

Geocentric X, Y, Z

If you choose a projected coordinate system, you can enter coordinates as: Latitude, Longitude, Ellipsoidal Height or

Easting, Northing, Orthometric Height or Geocentric X, Y, Z

Then simply use the Convert buttons to convert one set of coordinates to the other.

Data Entry Fields

The following fields allow you to enter coordinates to test. Some of these fields are read only and will be disabled by default.

Geographic Coordinates

When you have selected a geographic coordinate system as your coordinate system choice, you must enter coordinates as geographic or geocentric.

If your coordinate system is projected, you can enter either projected or geographic coordinates. Data Field Name Description

Latitude Latitude of input or converted position. Longitude Longitude of input or converted position. Ellipsoidal Height (h) Ellipsoidal height of input or converted position.

Geoid Height (N) Combined vertical offset model value. Read only by default Convergence Convergence of input or converted position. Read only by default Geocentric XYZ Geocentric X, Y, Z of input or converted position.

Orthometric Height (H) Vertical Coordinate System height of input or converted position. Convergence Convergence of input or converted position. Read only by default. Scale Easting Easting scale of input or converted position. Read only by default. Scale Northing Northing scale of input or converted position. Read only by default. Geocentric XYZ Geocentric X, Y, Z of input or converted position.

Geographic Units Format Option

Available formats for geographic units are shown below (d=degrees, m=minutes, s=seconds, H=hemisphere). The formats can include either a hemisphere or a sign (+/-).

When entering or displaying degrees, minutes, seconds separately, the separating character can be either a space or a semi-colon.

Format Example ddd mm ss.ss H 3 37 39.30 E ddd mm.mmmm H 3 37.6550 E ddd.mmmmmm H 3.627584 E +dd mm ss.ss +3 37 39.30 +ddd mm.mmmm +3 37.6550 +dd.dddddd +3.627584 ddd;mm;ss.sH 3;37;39.3E ddd;mm;ss.sssH 3;37;39.301E ddd;mm;ss.sssssH 3;37;39.30150E ddd;mm.mmmmmH 3;37.65502E ddd;mm.mmmmmmmH 3;37.6550249E ddd.dddddddH 3.6275837E ddd.dddddddddH 3.627583749E

Projected Units Formation Option

The Projected Units choices are all available "length" units from the geodetic catalog. By default, the units are meters. The projected units choices are:

millimetre centimetre metre foot US survey foot Clarke's foot fathom nautical mile German legal metre US survey chain US survey link US survey mile kilometre Clarke's yard Clarke's chain Clarke's link

British yard (Sears 1922) British foot (Sears 1922) British chain (Sears 1922) British link (Sears 1922) British yard (Benoit 1895 A) British foot (Benoit 1895 A)

British chain (Benoit 1895 A) British link (Benoit 1895 A) British yard (Benoit 1895 B) British foot (Benoit 1895 B) British chain (Benoit 1895 B) British link (Benoit 1895 B) British foot (1865) Indian foot Indian foot (1937) Indian foot (1962) Indian foot (1975) Indian yard Indian yard (1937) Indian yard (1962) Indian yard (1975) Statute mile Gold Coast foot British foot (1936) yard

chain link

British yard (Sears 1922 truncated) British foot (Sears 1922 truncated) British chain (Sears 1922 truncated) British link (Sears 1922 truncated)

Export Button

The Export button will export the numerical values to an HTML page. An example of this is shown below.

Print Button

Release Notes

Technical Information