NaviScan Configuration
NaviScan Configuration
NAVISCAN CONFIGURATION
1 Introduction ..................................................................................................................... 3
Page 2 of 47
4.4 Options ..................................................................................................................... 32
4.4.1 Global Parameters ............................................................................................. 33
4.4.2 Fansweep port setup ......................................................................................... 41
4.4.3 Enable trace log ................................................................................................. 43
4.5 Tools ......................................................................................................................... 43
4.6 Help .......................................................................................................................... 45
5 Definitions ..................................................................................................................... 45
1 Introduction
The purpose of NaviScan is to collect data from multibeam sensors and to generate a file
with exact positions of each scan. To do this, navigation information is needed along with
gyro, roll/pitch/heave and bathy sensor.
Due to time tagging considerations the NaviScan software package is split into two parts:
1. NaviScan Config (the Off-line/Setup part) with several utilities for setting up the
system and handling the raw data files.
2. NaviScan Online (the Online/Acquisition part) taking care of the data acquisition
and data logging to raw data file/s.
In NaviScan Config the user can specify and configure external interfaces, including
geodesy settings, interface identification, sensor data format, sensor C-O and exact location
on the vehicle (eg vessel/ROV) of each sensor.
All information is written to the configuration file NaviScan.BIN, which is read by the
NaviScan Online program before the data acquisition starts.
NaviScan Configuration.docx
Page 3 of 47
Last update: 27/5/2020
1.1 Related manuals
The guide to NaviScan Online can be found in NaviScan Configuration menu bar under
Help / NaviScan General Course.
A sensor list with their data formats are described here Help / Data Formats (NaviScan
reference manual).
2 Getting started
After installing NaviScan, two desktop shortcuts to NaviScan Config and NaviScan Online
are created. Start the NaviScan Config program from the desktop shortcut or activate it
from the Windows Start menu:
On first start the message box opens asking the user if he/she wants to make a new setup.
Press Yes.
NaviScan opens with the default layout. The following screenshot shows the UI elements.
Page 4 of 47
Figure 3 NaviScan Config layout: (1) Configuration file information bar, (2) Tree view or
Explorer panel, (3) Menu bar, (4) Toolbar, (5) Property view or Information window, (6) Help
and status bar
Note that the file must be a binary file in NaviScan Config format in order to make any
sense to the NaviScan Config program. Therefor use the option Save as type NaviScan
Config Files (*.bin) as shown in the screenshot above.
NaviScan Configuration.docx
Page 5 of 47
Last update: 27/5/2020
This file is also used by the NaviScan Online program. You can use two or more
configuration files but note that only the file named NaviScan.BIN is used by the online
program.
• File level
Here the name of the configuration file is visualized at the very top of the Panel
• Sensor type or Instrument type level
Here the instrument types are listed. An instrument type could for instance be
Echosounder
• Individual sensor or Instrument level
Here instruments are listed. Instruments are organized relative to their type. In the
list to the left, Instrument Type Gyro has two instruments in the child level, NMEA
and Ship’s Gyro
This represents the top level of the configuration. Right-click on an item on the file level
gives you the option to, eg Expand tree.
Page 6 of 47
Figure 6 Context menu of NaviScan.BIN
• NaviScan.bin
- Expand tree
NaviScan Configuration.docx
Page 7 of 47
Last update: 27/5/2020
• System Parameters
o User note
It gives name and date of the current setup and it allows the operator to
type relevant information, eg who-am-I etc. It’s recommended that this
information is filled, as it’s stored together with the configuration data.
o waterline
Offset from reference point to water line, positive up
o useBathy
Enable use of bathy in result calculation (else waterline relative)
o useHeave
Enable use of heave in result calculations (normally not for ROV)
Specifies whether the heave from RPH sensor should be used.
When mounted on a ROV the heave must be disabled and a bathy sensor
must be defined.
Page 8 of 47
Note: The heave will be recorded anyhow so you can reselect this in
NaviEdit.
o Scan Window
Across and vertical scan window beam flagging filter over all scans
o Depth min
System z filter min window in absolute reference system with bathy
included, -20000 to 20000 meter positive down
o Depth max
o Across min
System x filter min window rel ref point, in local vessel reference system,
-20000 to 20000 meter positive starboard
o Across max
• Geodesy
ProjEllip
NaviScan Configuration.docx
Page 9 of 47
Last update: 27/5/2020
▪ Edit Projection Ellipsoid
Allows to change the geodesy settings
▪ DatumShift
Edit Datumshift
▪ ITRF
On a sensor type that support multiple sensors of same type, you can use the option Add
New to add a new sensor. It will lead you through all steps of adding the sensor, include eg
Sensor type, port. Offset needs to be set in the sensors property view.
Figure 10 Instrument search option, Company, Instrument, Datastring and Help. Number of
predefined sensors.
After selecting the sensor, the Port settings view opens, where the port is configured.
Page 10 of 47
Figure 11 Port settings eg serial communication for the used sensors.
After port settings, NaviScan opens and in the sensor property view, offsets can be entered.
NaviScan Configuration.docx
Page 11 of 47
Last update: 27/5/2020
Figure 12 Context menu on sensor level, Move up, Move down, Delete
On sensor types, it is possible to add by right clicking on the type in the tree window.
Page 12 of 47
3 The Toolbar
The toolbar has the following items (from left to right):
• New
• Open
• Save
• Move sensor down/Move sensor up
Move the sensor up and down in priority. The sensor that in the top is the primary,
and is the one, used in NaviScan Online. The rest is just logged and can be used at
a later stage in eg NaviEdit.
• Expand tree
• Delete
Delete the sensor from the configuration. This can also be achieved by pressing
Delete on the keyboard.
• Start NaviScan Online
The toolbar can be disabled (from the View menu) and it can be moved to another location.
The toolbar functionalities are also accessible from the main menu of the NaviScan
Configuration program or from the Explorer Panel.
4 Menu bar
The menu bar consists of six options: File, Equipment, View, Options, Tools, Help. These
are described in the following:
NaviScan Configuration.docx
Page 13 of 47
Last update: 27/5/2020
4.1 File
The File menu has options used to handle the NaviScan configuration file.
• New
Standard Windows facilities for file handling. Here the NaviScan.BIN file can be
created, saved and opened. The name of the configuration file, to be used online,
must always be NaviScan.BIN
• Open…
Opens an existing configuration file for editing. By selecting this item a standard
Windows file dialogue is opened to select filename, directory and drive.
The NaviScan.BIN should be stored at this location, C:\EIVA\NaviScan\Db\.
• Save
Saves the configuration to the file opened. The filename, drive and directory are
shown at the top of the NaviScan Configuration screen.
The NaviScan.BIN should be stored at this location, C:\EIVA\NaviScan\Db\.
• Save As…
Saves the configuration file using a standard file dialogue to specify filename,
directory, drive for the file to be saved. The Save As command is useful when using
two or more configuration, but note that only the file named NaviScan.BIN is used
by the NaviScan Online program.
• Add Shared NaviPac Setup
todo
• Recent File
If you maintain more files, this shows the last four files.
• Exit
Terminates the program with prompting for saving current settings.
Page 14 of 47
4.2 Equipment
Choose the Equipment entry to add a new sensor/instrument, among a list of types and
drivers, to the configuration. Note that the items of the menu are greyed and cannot be
selected, unless the Explorer Panel has focus (move the mouse cursor to the Explorer
Panel).
NaviScan Config has a large set of predefined sensors or the user can specify a data input
format him/herself.
The data format of the predefined sensors is specified in chapter 1.1.
Choose the Equipment option and choose Add sensor. Now a list of available sensor
types is shown:
NaviScan Configuration.docx
Page 15 of 47
Last update: 27/5/2020
Select a sensor type and proceed:
PPS usage: Select which PPS event from RS232 control signals to use, or none.
Page 16 of 47
often not accurate enough for MBE acquisition!
It is normally important that the NaviScan computer time is synchronised with the
sonar time.
This is data communication with NaviPac. Runline information is retrieved every second.
NaviScan Configuration.docx
Page 17 of 47
Last update: 27/5/2020
4.2.3 GYRO
Figure 18 Sensor NMEA Gyro with Sensor & help option showing the expected data format
At gyro setup the gyro system is identified; the gyro offset must only be defined when free
format is selected:
4.2.4 MOTION
When configuring a motion sensor, the interface for the roll, pitch and heave sensor (RPH
sensor) is defined:
Page 18 of 47
Figure 19 Interfacing Motion sensor
4.2.5 BATHY
If mounted on a ROV, bathy sensor must be defined to give the exact depth of the ROV,
otherwise go to the System Parameters and disable the useBathy option.
NaviScan Configuration.docx
Page 19 of 47
Last update: 27/5/2020
Figure 20 Bathy properties
Specifies how NaviScan shall read the data from the string
• Bathy depth
Expected data format
• Termination character
The ASCII number of the last character – eg 10 for <LF>
For the sensors giving pressure instead of depth (eg Digiquartz), you must specify the
following three parameters:
• Water density
• Gravity
• Pressure at surface
• Pressure Scale
Page 20 of 47
Water Density, Pressure of surface and Gravity can be modified by user, and those settings
will be used in the depth calculation by applying a simple Saunders and Fofnoff:
Depth = (Pressure – PressureAtSurface)/(1000 * Gravity * WaterDensity)
Note: For the HoneywellPPTR20 sensor set Pressure at surface to 0, because this sensor
internally is connected to the surface pressure, and therefore subtracts itself the surface
pressure (outputs the differential pressure).
Please note that the bathy driver also utilises a series of other related inputs:
4.2.6 AUXILIARY
NaviScan offers special auxiliary input for sensors that doesn’t match the other sensors
Auxiliary data will be stored as raw packets in NaviScan without any display or control, but
will be available in NaviEdit for further use.
NaviScan Configuration.docx
Page 21 of 47
Last update: 27/5/2020
4.2.7 RAWDATA
A raw input will read into the online program and recorded in the SBD format. There will not
be any data display or handling in NaviScan or NaviEdit.
4.2.8 DOPPLERLOG
If NaviScan is operated in areas where the raw navigation is outside the specifications for
precision, you may improve it by using a Doppler Velocity Log. By combining position, gyro
and velocity, you get the best overall result.
Page 22 of 47
Figure 24 DopplerLog: RDI DVL PD6 (Ascii)
4.2.9 NAVIGATION
In this dialogue, you can select the positioning system supplying the navigation information:
NaviScan Configuration.docx
Page 23 of 47
Last update: 27/5/2020
Figure 25 Positioning setup
Page 24 of 47
For the positioning equipment following data has to be defined when free format is selected:
This defines the age of the data from navigation system. The age can either be a constant
delay or specified in the serial string.
• Fixed
Defines a constant delay in milliseconds. Corresponds to the Extra latency.
• Offset
The string includes the age given as milliseconds and this field points out where
NaviScan must read the field by defining the number of chars before it.
• Absolute
The string includes an absolute timestamp which is used to determine the latency.
• Extra latency
Here you may add an extra age of data
This defines (for non-fixed systems) where NaviScan reads the various data fields by
defining the number of characters before the field:
• Time (Optional) Where to find the timestamp in the telegram (format "hh:mm:ss")
• Easting Where to find easting co-ordinate in the telegram (format "EEEEEEEE.EE")
• Northing Where to find northing co-ordinate in the telegram (format
"NNNNNNNN.NN")
If you are using a position input with geographical coordinates – eg NMEA GGA or Applanix
POSMV, then you need to tell NaviScan how to convert these to easting and northing. This
is done via standard definitions similar to NaviPac. Please refer to NaviPac manual for
further information (https://eiva.freshdesk.com/support/solutions/articles/43000520809-
geodetic-control).
4.2.10 ECHOSOUNDER
NaviScan Config predefined echo sounders are 2GRobotics, Atlas, Benthos, BlueView,
CathX, EdgeTech, Hi-Target, Imagenex, ITER Systems, Klein, Kongsberg, L-3,
NewtonLabs, Norbit, Picotech, R2Sonic, Reson, Sonardyne, Teledyne Odom, Tritech,
Wassp.
NaviScan Configuration.docx
Page 25 of 47
Last update: 27/5/2020
Figure 27 An example of echo sounder interfacing, and sensor properties
4.2.11 SIDESCAN
Here you can select which sidescan sonar you want to interface into NaviScan – it can
either be standalone SideScan or MBE SS systems (eg R2Sonic Snippets).
Page 26 of 47
Figure 28 Edgetech sidescan sonar
Specify the pipe tracker system you are using as shown in the dialog below:
NaviScan Configuration.docx
Page 27 of 47
Last update: 27/5/2020
Figure 29 Sensor interfacing: Pipe tracker and its sensor properties
The pipe diameter can be defined in the sensor’s properties. This value is used for
calculating the correct depth.
Pre-defined pipe tracker sensors: DOF Subsea, Innovatum, Optimal Ranging (Innovatum),
Reson, Teledyne, Tinsley.
Page 28 of 47
4.2.13 LASERSCANNER
The Free data format accepts data in any fixed position ASCII string with a known
termination.
The sensor type Free setup is used, if the sensor you wish to interface is not listed and has
an ASCII output.
The Free setup shows how the input format is defined for the
predefined sensors. Only when using the free format these fields can
Free Format be edited; offsets for the relevant data are specified here.
NOTE: The offset is the number of characters skipped before the
actual parameter is read.
The String Layout shows an ASCII string generated on basis of
String Layout format defined at Free setup. When the free format is selected the
String Layout isn't generated before clicking the Generate String
button.
Termination For the free format, you most enter the binary code for string
character termination, eg 10 for <LF> or 13 for <CR>
NaviScan Configuration.docx
Page 29 of 47
Last update: 27/5/2020
To avoid any confusion, a few examples are shown below, describing how to set offsets.
As the procedure is the same for each sensor/free input, one example motion sensor is
described.
Our ASCII data could look like this. (All examples below would work with values set above)
1 2 3
0123456789012345678901234567890
xx-5.345xx+3.234xxxxxxx0.321xxxxxx…
xx1.654xxx-2.234421xxxx-1.645xxxxx…
xx1.1xxxxx4.21xxxxxxxxx1.23xxxxxxx…
As you can see, you only have to set the offset value to the start of where you expect to get
the data including the sign.
IMPORTANT:
As this is a generic driver, there is one thing, which is very important.
Just because the Serial string in the dialog shows “*rrr.rr…..”, doesn’t it mean, that it will
only read 6 characters..
Page 30 of 47
It reads the floating point number, which comes directly after the offset.
Some instruments require special setting that aren’t handled in the general instrument
setup:
RDI DVL NaviScan expects that the DVL is mounted correctly (or
compensated as such inside the DVL). We have seen some
scenarios where it has been rotated 180 degree. To get an
optimal behaviour you may compensate for this (negating the
readings)
Applanix POSMV This relates purely to the network interface towards Applanix
POSMV
• Attitude:
NaviScan reads as default attitude (gyro and roll/pitch/heave)
from the 102 packet. You may change this to use packet 103
instead.
• Position:
The position is as default taken from the special position packet
(1). You may alternatively use the attitude packet (102(103)
Digiquartz NaviScan expects that the Digiquartz data is given in PSI. If this
isn't the case then you may enter a scale divider here.
Heave The selected unit has been observed sending heave in both
upwards and downwards reference (positive up or positive
down) coordinate system. NaviScan has no way of detecting
this - so you may have to tell NaviScan to change sign of the
heave.
NaviScan Configuration.docx
Page 31 of 47
Last update: 27/5/2020
This has so far been observed for the following units Seapath
Ixsea GC2 Ixsea RB
4.3 View
Facility to toggle the Status Bar on and off.
• Toolbar
• Status Bar
• Expand tree
4.4 Options
Figure 33 Options Global parameter, Fansweep port setup, Enable trace log, Open
NaviScan tracelog
Page 32 of 47
4.4.1 Global Parameters
Selecting this menu point, opens a dialog where you can setup different online settings.
It is common to all settings that they have influence on the online behavior and it will not be
effective until NaviScan Online has been restarted.
• Real-time Export
NaviScan offers the user besides data recording various outputs to data QC in a.o.
NaviPac
NaviScan Configuration.docx
Page 33 of 47
Last update: 27/5/2020
Option Description
Send to
Helmsman/Online3D
Page 34 of 47
$NBDBT,,,<Depth>,M,,<cr><lf>, where <Depth> is the
centre-beam depth.
Example:
$NBDBT,,,23.43,M,,<cr><lf>
NaviScan offers a utility where you may mark targets (eg Pipe
touch-down) on the online DTM view and export the position to
an external client.
In this section you enable this function and define the output
settings. Please refer to the NaviScan manual
NaviScanTouchDownMonitor.pdf for details
SchillingFollow
Multibeam derived top of pipe send out for every scan of MBE 1
NaviScan Configuration.docx
Page 35 of 47
Last update: 27/5/2020
• MBE/SS
In this section you can control settings for various MBE sonar’s
Page 36 of 47
MaximumSwath in m.
Edgetech4600
MaximumDepth in m.
MinimumDepth in m
Use NaviPac Repeater
npIpAddr 127.0.0.1
npPosPort 2320
npRphPort 2321
Klein_calfile
Klein
Klein_timestamplocaltime
Klein_5900_wingIP
Klein_5900:wingPort
Klein:soundvelcm
Solstice
NaviScan Configuration.docx
Page 37 of 47
Last update: 27/5/2020
• Height Calculations tab
Define the height reference for vessel mounted systems
Page 38 of 47
Method If NaviScan is used together with a GPS based position system (eg
NMEA or POSMV input) then you may control the height reference
and thus change from WGS84 to local zero
Method: How do we get from GPS ellipsoidal height to local zero
(eg DVR90)
• NONE
Use the height as it is
• EIVA KMS
Should NaviScan use a EIVA geoidal file with distance between
GPS height and local zero? This format is identical to the GRI files
supplied by KMS – sample file found at \eiva\navipac\setup if using
NaviPac
• GCG05
Use the German Quasigeoid model for the separation. This
requires a license from the supplier. See
http://www.geodatenzentrum.de/docpdf/quasigeoid.pdf .
VORF:
Use the UK Vertical Offshore Reference Frame
Geoid File Reference to the geoid file with the height reduction – only valid for
EIVA, GCG05, VORF or EGG97 files.
Compiled Geoid NaviScan uses a compiled binary version of the source file. It’s
File saved at same location with a .BIN extension.
NaviScan Configuration.docx
Page 39 of 47
Last update: 27/5/2020
GpsTide These GpsTide correction settings only apply to the instruments:
GPSTideGGA and GPSTidePosmv.
The instrument GpsTideNP is not affected by these settings, and
will be logged exactly as received from NaviPac.
WaterLine WaterLine is the z distance from the ships ref point to the
projection of the ref point on the sea surface plane, under normal
working load, z positive up, only used when no present dyndraft is
enabled, and only for GpsTideGPS and GpsTidePosmv calc.
UseDynDraft Use the first present dynamic draft type bathy sensor in setup,
instead of fixed waterline (if a dyndraft is not present, waterline is
still used), only used for GpsTideGPS and GpsTidePosmv calc
UseSpeedCorr
SpeedCorrFile
• NaviScan
Page 40 of 47
This section defines various settings related to NaviScan performance. Very rarely changed!
View update rate How often must NaviScan update the graphical views. Use with
care
Buffer Size How many samples do you want to be displayed in the time-
based windows in the NaviScan Online program.
Note: The bigger the amounts of samples, the more CPU load!!
FallingPPS For GPS time with 2 trig per cycle, trig on falling edge, instead
of default rising edge.
Use Scanfish SV When using NaviScan together with a ScanFish you may get
online updated sound velocity profiles (via the SVMon program)
and apply that to the data for improved online QC
SVMon Port
Fake receive
timestamp
Selecting this item opens the configuration file (StnAtlas.ini) in notepad, where the individual
ports for the Atlas fansweep MBE (bathymetry) and the sidescan can be seen. The IP
address is set in the normal way using interface setup but can be overwritten for a specific
item in the StnAtlas.ini file
NaviScan Configuration.docx
Page 41 of 47
Last update: 27/5/2020
Figure 37 Atlas fansweep
The Fansweep Port setup option opens a file, StnAtlas.ini, where the individual ports for a
Fansweep MBE with sidescan option can be defined.
The instrument is configured in the normal way, via the equipment/interface configuration.
Once this is accomplished, the StnAtlas.ini file must be configured along the following
guidelines:
There are 6 types or packages, for which individual ports must be defined:
a. „fs20_lot‟: Standard parameters for echo sounder
b. fs20_depth_1 to _8: Bathymetry packages containing depth
Page 42 of 47
c. fs20_angle_1 to _5: Bathymetry packages containing angle
d. fs20_sidescan_1 to _4: Sidescan packages containing sidescan image data
e. fs20_tpe: Total Propagated Error telegram
f. fs20_offset:a port offset will be added to all the port numbers if this line is present
anywhere in the StnAtlas.ini file eg fs20_offset=25000.
To change the IP address for the TPE telegram, which seems to be required for fs20 (or to
change the IP address for a specific item in general) just write the IP address behind the
item, separated by a space: fs20_tpe=3159 192.168.1.89
For a more detailed description of these ports and packages, refer to the general Atlas
Fansweep documentation.
Activating this item will toggle the Error trace log on and off. The traces can be used for
debugging.
NaviScan Online will hereafter generate dump files in the NaviScan\bin folder which could
help EIVA tracking down problems. Please send these files to [email protected]
4.5 Tools
NaviScan Configuration.docx
Page 43 of 47
Last update: 27/5/2020
Extract To extract information to MS Excel readable
files for quality control
hmsystemid=9
hmasddatatype=8
hmmbechannel=es_targets_port
hmmotionchannel=fs20_motion_1
For the SVP to Fansweep program these items
are used:
XDR Port=3070
z-keel=0.050
SBD Minimizer
Page 44 of 47
4.6 Help
Figure 39 Help
5 Definitions
All depending on the type of sensor offset and mount angles can be set. Below is described
how these are defined.
5.1 Offsets
The offset is defined as the (X,Y,Z) distance [m], from the primary position/navigation
sensor, and to the sensor, where X is positive starboard, Y is positive front and Z is positive
up, as shown in figure below.
NaviScan Configuration.docx
Page 45 of 47
Last update: 27/5/2020
5.2 Mount angles
The mount angle defines the exact alignment of the sensor.
The mounting is specified by roll angle, pitch angle and heading angle; the roll angle is
measured positive starboard down, the pitch angle positive bow up and the heading angle
zero front and positive clockwise as shown in the figure below:
Page 46 of 47
6 Version descriptions
Version Date Author Description
9.0 21.10.2016 ANS Transferred to new template
NaviScan Configuration.docx
Page 47 of 47
Last update: 27/5/2020