EIVA GEOCALC

A GEODETIC TOOLBOX

FRONT PAGE HEADING 24.3

Last update: 05/11/2019
Version:
 Contents

1 Introduction ..................................................................................................................... 3

2 Geodesy ........................................................................................................................... 4

2.1 Defining Geodesy ....................................................................................................... 5

2.2 Defining datum shift.................................................................................................... 7

3 Convert a point ................................................................................................................ 9

4 Shift a point ................................................................................................................... 11

5 Convert a file ................................................................................................................. 13

6 Shift a file ....................................................................................................................... 15

7 14 parameter shift ......................................................................................................... 17

8 Chen and Millero 1977 .................................................................................................. 18

9 Position vs KP/DOL ...................................................................................................... 19

10 File formats ................................................................................................................ 20

10.1 XY ......................................................................................................................... 20
10.2 Decimal degree ..................................................................................................... 20
10.3 Degree and minutes .............................................................................................. 20
10.4 Degree, minutes and seconds .............................................................................. 21
10.5 Radians ................................................................................................................. 21

11 XTF Converter ............................................................................................................ 22

12 About .......................................................................................................................... 22

Page 2 of 22
 1 Introduction

GeoCalc is a toolbox with utilities to convert between geographical and external

coordinates, to perform datum shifts, etc.

The main window lists the actual setting (source geodesy, datum shift and destination
geodesy), includes buttons and menu entries to change geodesy and buttons and menus to
perform various calculations.

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 3 of 22
Last update: 5/11/2019
 The lower part of the window is a result list box containing a listing of all calculations.
Pressing the Clear button can empty this list. If having the system display file based
calculations is undesirable, then deselect the List ASCII file conversion tick box.

2 Geodesy
The calculator is based on a rather advanced geodesy setting (as known in a.o. NaviEdit).

The operator must define a source geodesy (ellipsoid and projection), a set of datum shift
parameters (method and 7 parameters) and a destination geodesy (ellipsoid and projection)
as illustrated above.

The data conversions (singe point, ASCII file or XTF file) are all performed in the source
geodesy as it is simple a conversion between X/Y and Lat/Long.

The data shift routines (single point or ASCII file) operate between source and destination
and it utilizes the defined datum shift parameters.

Page 4 of 22
 2.1 Defining Geodesy

Press the Change button and the above pop-up dialogue opens. The system uses a DLL
that is shared across various EIVA products for this functionality.

It is possible to select between a series of available ellipsoids and projections. Depending

on the type, it is possible to enter various parameters (e.g. UTM zone in the above sample).

When operating in the US; it is possible to use a set of pre-defined zones via the Load US
State Plane button:

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 5 of 22
Last update: 5/11/2019
 Alternatively, the Load EPSG System button allows access to the European Petroleum
Survey Group’s (EPSG) defined set of coordinate reference systems:

Page 6 of 22
 2.2 Defining datum shift

Press the Change button and the above pop-up dialogue opens. The system uses a DLL
that is shared across various EIVA products for this functionality.

It is possible to select between a series of predefined shifts or to select a user defined shift
whereby a 7 parameter custom shift can be entered.

Only the Normal method or the North Sea method should be selected – the other two
are not supported in this utility module. Selecting the unsupported methods results

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 7 of 22
Last update: 5/11/2019
 in the following error message:

GeoCalc supports most combinations of shifts between settings. Some requested

shift combinations are illogical. Some illegal combinations are caught by the module
and will yield a warning similar to the following:

Page 8 of 22
 3 Convert a point
Press the convert point button or activate the menu Calculate -> Convert point menu entry
and the following pop-up dialogue opens:

It is now possible to convert between X/Y and Lat/Long in the selected source geodesy (see
the top line). Entering the coordinates and pressing the left/right arrow buttons performs the
conversion.

The geographical coordinates may be entered/displayed in three formats:

• DD.dddddd
Decimal degree with an unbounded number of digits (Eg. 12.345678°)
• DD MM SS.ssss
Degree, minutes and seconds with an unbounded number of digits (Eg. 12°20’
44.4408”)
• DD MM.mmmmm
Degree and minutes with an unbounded number of digits (Eg. 12°20.74068’)

The sign (+/-) of the geographical coordinates are defined by E/W or N/S.

It’s possible to print (always on default printer) the result by pressing the printer icon. The
printing functionality is based on a freeware printer utility, and the result is a bitmap similar
to the following:

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 9 of 22
Last update: 5/11/2019
 The printer functionality only works if the screen colour resolution is set to either 32 bit true
colour or 256 colours.

The result of each conversion will further be displayed in the main window list box.

Page 10 of 22
 4 Shift a point
Click the shift point button or activate the menu Calculate -> Shift point menu entry and the
following pop-up dialogue opens:

Here it is possible to shift coordinates between a source and destination geodesy. The
upper part of the window allows entry of the coordinates as either X/Y or Lat/Long
(DD.ddddd, DD MM.mmmm or DD MM SS.ssssss). Having entered the values, they may be
shifted by clicking the From <source> or From <destination> buttons. The results will be
displayed in the middle portion of the dialogue. The left side gives results in source geodesy
and right side in destination geodesy.

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 11 of 22
Last update: 5/11/2019
 The 7 parameters used in the calculated shift are included in the lower part of the dialogue.

The dialogue can be printed using the printer icon and the result are displayed in the main
window list box:

Page 12 of 22
 5 Convert a file
It’s possible to convert an entire ASCII file between X/Y and Lat/long.

1 If all results of the ASCII file point conversions should be displayed in the main list
box, then select the “List ASCII file conversion” check box.
2 If the post-conversion file should be opened, then select the “Display file after
creation”check box.
3 Click Convert ASCII File or select Calculate -> Convert ASCII File in the menu
4 Select the file(s) to convert.
5 The format of the input file must be specified for each converted file:

If the file is in Lat/Long, then the format of the fields must be specified. A selection can
be made between decimal degrees (DD.dddd, DD MM.mmmm or DD MM SS.ssss) or
radians (RR.rrrr). For additional details on these formats, refer to a later section below.

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 13 of 22
Last update: 5/11/2019
 6 Next, specify the output file format:

• In the left section, select position format. Multiple formats may be selected.
• In the right section, specify the format of the Lat/Long output coordinates
(required).
• If a date, time, and exported geodesy header should be included in the
output file, then select the Include Header checkbox.
• If the original data contained in the input file should be included in the
output, then select the Include Original Text checkbox.
7 The system now creates a new file named as the original but with the added
extension “-Conv.txt”:

Page 14 of 22
 6 Shift a file
It’s possible to convert an entire ASCII file between X/Y and Lat/long.

1. If all results of the ASCII file point conversions should be displayed in the main list
box, then select the “List ASCII file conversion” check box.
2. If the post-conversion file should be opened, then select the “Display file after
creation”check box.
3. Click the Shift ASCII File button or activate Calculate -> Shift ASCII File in the menu
4. Select the file(s) to convert
5. For each file the format of the input file must be specified:

If the file is in Lat/Long, then the format of the fields must be specified. A selection
can be made between decimal degrees (DD.dddd, DD MM.mmmm or DD MM
SS.ssss) or radians (RR.rrrr). For additional details on these formats, refer to a later
section below.

6. Next, specify whether the shift is forward or backward, i.e. from source or from
destination:

7. Next, specify the format of the output file:

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 15 of 22
Last update: 5/11/2019
 8. In the left section, select the format to display the position (multiple choice).
9. In the right section, specify the format to display lat/long
10. If a date, time, and exported geodesy header should be included in the output file,
then select the Include Header checkbox.
11. If the original data contained in the input file should be included in the output, then
select the Include Original Text checkbox.
12. The system will create a new file named as the original but with the extension –
Shift.txt:

Page 16 of 22
 7 14 parameter shift
GeoCalc version 4.3 and onwards supports the time based 14 paramter shift (as seen in
a.o. NaviPac and NaviScan). The tool is activated via the Calculate menu;

The left side f the dialogue is the shift definition, where you enter the base shift, the time
variant and the definition date. See eg http://etrs89.ensg.ign.fr/memo-V8.pdf

The parameters can be saved for later use by the Save as default button

Right side of the dialogue is the calculator part.

• In the top part you enter the date you want to check
• The middle part is the resulting 7 parameter shift
• The lower part is input and output position

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 17 of 22
Last update: 5/11/2019
 8 Chen and Millero 1977
The Calculate -> Chen and Millero menu selection allows calculations on CTD data:

If pressure (in deci bar), temperature (degree Celsius) and salinity (PSU) are entered and
the Calculate SV button is clicked, then the sound velocity based on the official UNESCO
formula will be calculated.

If pressure, temperature and sound velocity are entered instead and the Calculate Sal
button is clicked, then an iterative calculation will be performed to determine the
corresponding salinity. This is done in a cyclic process searching for the salinity salinity
value that gives the best fitting sound velocity.

Page 18 of 22
 9 Position vs KP/DOL
The program includes a calculator in the Calculation menu that allows data conversion
between position (Easting, Northing) and runline data (KP and DOL) 2

In the Runline File field, a runline file must be selected. Runline files that are supported are
RLX and RLN from the NaviPac format library.

After specifying the runline file, position or kp/dol values can be entered and converted
using the two left-most buttons (From E/N, From KP/DOL).

The two right-most buttons allow this process to run against one or more ASCII input files.

The files must be very simply formatted and must have either easting, northing or kp, dol as
the first two items depending on the desired process.

2
KP is Kilometer Point and DOL is Distance Off Line

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 19 of 22
Last update: 5/11/2019
 10 File formats
The reader for ASCII files is intelligent and will search for the correct data in the input files.

The search is performed after the following simple rule check:

• All lines starting with a ‘#’ are considered to be comments and will be ignored.
• All non-comment lines must include exactly one position
• The selected position format can start at any number, as specified in the input
dialogue – e.g. XY file will search for the no-skip + two numerical fields in a line
• All non-numerical characters are ignored, eg. “ xyz 123.45 XXX 2345.68” results
in the two numbers 123.45 and 2345.68.
• The reader is limited to the following fixed separators:
‘,’ ‘:’ ‘;’ ‘|'
After a delimiter the reader will always read a number or fail (i.e. “ xy:z 123.45
XXX 2345.68” will fail as it contains a ‘:’ followed by a non-number).

10.1 XY
The file contains positions as easting and northing (or the opposite) with as many digits as
required.
Sample:

519999.9973,5999999.9052, 54.146556, 9.306175

10.2 Decimal degree

The file contains positions as latitude and longitude (or the opposite) represented as
decimal degree with as many digits as required.
Sample:

decimal degree 54.146556, 9.306175

Western and southern values must be defined with a negative sign (-).

10.3 Degree and minutes

The file contains positions as latitude and longitude (or the opposite) represented as degree
and decimal minutes with an unbound number of digits. The reader will search for 4
numbers in each line.
Sample:

Page 20 of 22
 dd mm_mmmmmmmmmmmm 054°08.793345' 009°18.370483'

Western and southern values must be defined with a negative sign (–) in front of both
degree and minutes.

10.4 Degree, minutes and seconds

The file contains positions as latitude and longitude (possibly in opposite order) represented
as degree, minutes and decimal seconds with an unbound number of digits. The reader will
search for 6 numbers in each line.
Sample:

Lat and long in dd mm dd 54°08'47.60072" 9°18'22.22899"

Western and southern values must be defined with a negative sign (–) in front of degree,
minutes and seconds. Eg:
54° 8' 51.7705" -20° -41' -37.7968"

10.5 Radians
The file contains positions as latitude and longitude (possibly in opposite order) represented
as radians with an unbound number of digits. The reader will search for 2 numbers in each
line.
Sample:

XXX___ZZZ 0.945036, 0.162423

NaviPac_GeoCalc_A_Geodetic_Toolbox.docx
Page 21 of 22
Last update: 5/11/2019
 11 XTF Converter
GeoCalc contains a special XTF converter module that reads XTF files (Simrad based) and
converts positions in lat/long to X/Y coordinates using the source geodesy.

Select Calculate-> Convert XTF file and select the file to be converted. A new file is created
with the original name plus an extension “.XY.XTF”.

During the conversion some errors might occur:

The file has a flag (XTFFILEHEADER.NaviUnits) that must be 3 if positions are in lat/long.
The above example with 0 is a file already in X/Y co-ordinates.

The file header format (XTFFILEHEADER.FileFormat) should always be 123. If the above
happens, please check if the file is in XTF format.

12 About
The Help -> About menu results in the following dialogue:

In case of problems, please note version number and release data and contact EIVA a/s
(support@eiva.com)

Page 22 of 22