Professional Documents
Culture Documents
SeaDarQ V 5 Reference Guide (Doc Rev D)
SeaDarQ V 5 Reference Guide (Doc Rev D)
Reference Guide
documentation revision D
identification data
documentation title SeaDarQ v 5
Oil Spill Detection & Hydrography
Reference Guide
documentation revision
D
publication date
14-mar-2018
software product
SeaDarQ
software product version
v 5.x
issuing organization
Nortek BV
1
Contents
Contents .................................................................................................................................................................. 3
I Introduction ............................................................................................................................................... 5
1 Overview ................................................................................................................................................... 5
2 Purpose...................................................................................................................................................... 5
3 Assumptions and scope ............................................................................................................................. 5
4 Main sections ............................................................................................................................................ 5
II Background Topics and Concepts ............................................................................................................. 7
1 Overview ................................................................................................................................................... 7
2 Modes of operation ................................................................................................................................... 7
3 Basic Principles ......................................................................................................................................... 8
4 SeaDarQ software configuration settings ................................................................................................ 11
5 Starting the system .................................................................................................................................. 14
6 User Interface Elements .......................................................................................................................... 15
7 Alarms and alarm stages ......................................................................................................................... 25
8 A note about examples ............................................................................................................................ 27
9 Background correction / Range correction.............................................................................................. 28
10 Confidence map / quality map ................................................................................................................ 33
11 False alarms ............................................................................................................................................ 35
12 Blocked areas .......................................................................................................................................... 47
13 Shadow detector ...................................................................................................................................... 52
14 Coastline database and land-mask .......................................................................................................... 55
15 AIS .......................................................................................................................................................... 56
16 Line- and histogram windows ................................................................................................................. 58
17 Using polygons ....................................................................................................................................... 59
18 Difference between “snapshot” and “Geo snapshot”.............................................................................. 62
19 Loading and using a Geo-encoded image ............................................................................................... 62
20 Latitude and longitude in degrees versus meters UTM ........................................................................... 62
21 Recording data ........................................................................................................................................ 63
22 Hydrography ........................................................................................................................................... 64
III Dialogs .................................................................................................................................................... 76
1 Overview ................................................................................................................................................. 76
2 Layers dialog ........................................................................................................................................... 77
3 Recording dialog ..................................................................................................................................... 80
4 Image alignment dialog ........................................................................................................................... 83
5 Polygon settings dialog ........................................................................................................................... 84
6 Snapshot Settings dialog ......................................................................................................................... 85
7 Alarm Settings dialog.............................................................................................................................. 87
8 GeoTIFF Snapshot settings dialog .......................................................................................................... 88
9 Diagnostics Window ............................................................................................................................... 90
10 NMEA log window ................................................................................................................................. 94
11 Statistics Window ................................................................................................................................... 96
12 Font Selection dialog .............................................................................................................................. 97
13 Line window ........................................................................................................................................... 98
14 Histogram window ................................................................................................................................ 103
15 Configuration Settings dialog ............................................................................................................... 107
16 File Settings dialog ............................................................................................................................... 120
17 Hydro configuration dialog window ..................................................................................................... 121
18 Hydro Info configuration dialog window.............................................................................................. 132
19 Wave Buoy Settings dialog ................................................................................................................... 135
20 Individual Wave Buoy Settings dialog ................................................................................................. 136
21 Depth Map cell assignation dialog ........................................................................................................ 137
IV Menus.................................................................................................................................................... 138
1 Overview ............................................................................................................................................... 138
2 Configuration menu .............................................................................................................................. 139
3 View menu ............................................................................................................................................ 141
4 Screen menu .......................................................................................................................................... 143
5 Diagnostics menu .................................................................................................................................. 144
6 Recording menu .................................................................................................................................... 145
7 Image menu ........................................................................................................................................... 146
8 Polygon menu ....................................................................................................................................... 147
9 AIS menu .............................................................................................................................................. 148
10 Snap Shot menu .................................................................................................................................... 149
11 Oil Spill Detection (OSD) View menu ................................................................................................. 150
12 Geo Snap Shot menu ............................................................................................................................. 151
13 File menu .............................................................................................................................................. 152
14 Hydro menu .......................................................................................................................................... 153
15 Hydro Info menu ................................................................................................................................... 156
16 Depth map right-click menu ................................................................................................................. 157
17 Individual wave buoy right-click menu ................................................................................................ 158
V File-formats Hydrography..................................................................................................................... 159
1 Introduction ........................................................................................................................................... 159
2 Wave Report ......................................................................................................................................... 160
3 Virtual Wave Buoys .............................................................................................................................. 162
4 Depth map ............................................................................................................................................. 163
5 Depth Contour file ................................................................................................................................ 165
6 Exclusion File ....................................................................................................................................... 167
Detailed Contents ................................................................................................................................................ 169
List of figures ...................................................................................................................................................... 175
List of tables ........................................................................................................................................................ 179
I Introduction
1 OVERVIEW
This section gives a brief sketch of this reference manual, what it is for, and (under Assumptions and scope) what
it does not describe.
2 PURPOSE
The purpose of this document is to give a full, exhaustive description of the use of all functionality in the
SeaDarQ software system – but details of hardware, installation, and maintenance are described elsewhere, in
particular in the Installation and Maintenance Guide. “All functionality” is used in a limited sense; it is limited to
“everything about the use of the SeaDarQ software for Oil Spill Detection operational use and Hydrography”.
See the next section, “assumptions and scope”, for more details.
Although the SeaDarQ system has some other modules for specialized purposes, these are not described here;
their existence is merely referred to. They are not described or explained in any detail in this reference manual.
This manual is only about Oil Spill Detection and Hydrography.
This manual does not describe some of the additional modules that can operate in concert with SeaDarQ, such as
the wave spectra module, the FTP client, or the MatLab interface. These modules tend to be extra, external
programs, that are not installed by default (although when installed they do interact with SeaDarQ).
Separate Technical Notes may describe additional modules like these (and additional functionality specific to the
SeaDarQ Scientific license).
Although there are other aspects to the software, the focus is on operational use of the software. Installation and
configuration are mentioned, but for details of installation and configuration of the hardware and software, other
documents exist. Rather than repeat the information, these other documents are referred to.
The why of Oil Spill Detection and Hydrography, the fact that we´re talking about Oil Spill Detection and
Hydrography on sea, and that we´re using a radar system for this, are all taken for granted and not dwelled upon.
Throughout this manual, familiarity with the Microsoft Windows environment is taken for granted.
4 MAIN SECTIONS
The material in this reference manual is divided into several sections.
Section II, Background Topics and Concepts, describes a number of concepts that either relate to the basic
principles that the oil spill detection methods and hydrography calculations used in the SeaDarQ software rely
on, or that describe the important aspects of operational use of the system. In section II, the spotlight is on the
why of using these features; the how is described to some extent, but details about menus or dialogs that are used
(the mechanics, so to speak) are left to their own sections.
Section III, Dialogs, describes all the dialog windows that are available in the software, how to get to each, and
what each item in the dialogs does. For a limited number of dialog windows, there is an extensive description of
their use, but for most the details of how and why to use them is described in the topics in section II.
Section IV, Menus, describes all menus that are available in the software, and what each item in the menus does.
The details of how and why to use them is described in the topics in section II.
Section V, File-formats Hydrography, describes various file formats that are relevant to the Hydrography
calculations SeaDarQ can perform (dependent on license). Most of the file formats describe themselves (through
readable header comments). This section expands a little on these descriptions with more details, and includes
how to generate and/or use these files.
1 OVERVIEW
This section describes a variety of background topics and concepts that form the basis that the software is built
upon. This includes, e.g., the physics of radar reflection off the sea surface, and how that is used to detect the
possible presence of oil on the surface. These physics can also be used to calculate hydrographic properties.
2 MODES OF OPERATION
SeaDarQ knows different modes of operation, as is clear from the Configuration menu. Not all other menus are
available in all modes; the section “Menus” – “Overview” gives some details.
The current manual focusses on “Oil Spill Detection from Radar” and “Hydrography” (the latter will be enabled
in parallel to Oil Spill Detection, depending on the license).
Oil Spill Detection and Hydrography (formerly known as Wave Processing) know two sub-modes, reflecting the
source of radar data to be processed:
from radar
from file
The “from radar” mode gets the radar data from a live feed, via the SeaDarQ Acquisition Unit that is connected
to the SeaDarQ computer via a network connection.
The “from file” mode gets its data from pre-recorded raw radar data files. (Actually, these raw radar data files
also include NMEA data that was read in to the system concurrently with the radar data.) In “from file” processing
mode, the SeaDarQ Acquisition Unit is not required.
2.1 Oil Spill Detection
In Oil Spill Detection mode, use is made of the following facts:
radar energy is reflected by small capillary waves and similar small-scale surface effects (also known as
sea surface clutter)
oil slicks suppress these surface effects, resulting in areas of low radar reflection
In effect, the software is looking for dark areas in the radar image, and tries to determine whether any such areas
it finds match additional criteria that lend credit to the notion that an oil slick causes such dark areas. The source
for such oil slicks is assumed to be a spill.
2.2 Hydrography (Wave Processing)
The small capillary waves (and other small-scale surface effects) also make it possible to track the sea surface in
detail, in particular the larger scale waves. The parameters that describe these larger scale waves can yield
information about the depth-averaged currents and the local depth, through the dispersion relation.
3 BASIC PRINCIPLES
3.1 Introduction
3.1.1 Overview
This section describes the basic principles that underpin the SeaDarQ Oil Spill Detection and Hydrography
system.
3.1.2 Purpose
This section is intended to provide a place to refer to for general background principles that the SeaDarQ Oil
Spill Detection and Hydrography system depends on. By having this single central place to refer to, it will not be
necessary to repeat details in different places again and again.
transmitting radar
reflecting target
distance, taking into account values for a variety of parameters. Figure 2 shows an example of results from
CARPET, showing the distance (on the vertical axis) at which the sea surface clutter return signal can still be
detected, as a function of the sea state (horizontal axis). (Sea state is linked to the wind conditions.) Table 1 lists
a number of the parameters that CARPET takes into account.
Some notes:
The example behaviour of sea surface clutter return visibility distance versus sea state is inherent to the
radar and radar antenna properties. This behaviour is independent of oil spill detection or hydrography
processing software system.
There are many subtleties to this figure. It is shown here without detailed explanation (somewhat out of
context), to illustrate that the detection range involves more than you might think.
This section describes additional software configuration of SeaDarQ, especially User Interface settings. The
focus is mostly on Oil Spill Detection mode.
This section mentions SeaDarQ menus and configuration dialogs, but does not go into all details of these menus
and windows. For details, see the sections IV “Menus” and III “Dialogs”, which discuss each menu item and
each dialog option in more detail.
4.2 General configuration
After completion of installation and configuration as described in the Installation and Maintenance Guide, you
may decide on adjustment of certain settings in the SeaDarQ program itself.
Notes:
In the process of fine-tuning configuration settings, it is useful to save the configuration settings
of a certain moment in time to an XML configuration file (see Configuration Export XML
Configuration; also in this Reference Guide, in the section Menus). This allows for a fallback in
case the fine-tuning turns out unsatisfactory.
Changes to configuration settings are not saved automatically: if not saved explicitly, a change
of operating mode or a restart of the program will revert to the settings in the registry (for that
mode).
The following sub-sections (Radar Configuration, Image Configuration, and Tracker Configuration) describe
some recommended configuration steps for SeaDarQ. Operational Image Configuration is described after that.
Advanced options are the subject of the next section (after these sub-sections).
The general recommendation / best practise is: keep the range below 3 to 7 km (about 2 to 4½ miles, or about 1½
to 4 nm).
Beyond that, the following list has some settings to consider and decide upon (with some details on how to select
them, with defaults where applicable):
AIS: layer transparent, show Items in the AIS menu (see section IV-9)
labels off, show tracks on
Rings on/off as desired On-screen selection in “Settings” panel (see section II-6.8)
North up Item in the Screen menu (see section IV-4)
Degrees / meter UTM Item in the View menu (see section IV-3) default: degrees
Km / nm as desired Item in the View menu (see section IV-3) default km
UTC / local time as desired Item in the View menu (see section IV-3) default UTC
Details in the Navigation Panel:
o Range Always shown
o Lat, Lon Latitude and longitude, always shown; units as selected
(degrees or meter UTM)
o HDG Heading, optional; default: not shown
select via ConfigurationSettingsProcessing Parameters
o STW Speed through water, optional; default: not shown
select via ConfigurationSettingsProcessing Parameters
o DPTH Depth, optional; default: not shown
select via ConfigurationSettingsProcessing Parameters
Note that some of the navigation panel items require a suitable NMEA source to be connected to a NMEA input
port on the SeaDarQ Acquisition Unit.
It may also be necessary to adjust the Oil Spill Detection alarm thresholds. These thresholds are the minimum
area and time present of a detection before triggering an alarm. See Tab “Alarms Settings” in the Configuration
Settings dialog (section III-15.3.7).
4.3 Advanced options
Via the Configuration menu, it is possible to switch on (enable) Advanced Options.
Note: changes to configuration settings are not saved automatically: if not saved explicitly, a change of operating
mode or a restart of the program will revert back to the settings in the registry (for that mode).
Hint: When the system is configured and working correctly, save the configuration to an XML file for
safekeeping, so you have a good base-line to fall back on should future changes to settings prove unsatisfactory.
As soon as the SeaDarQ Acquisition Unit receives radar data4, and the Acquisition Unit transmits the radar data
to the software, the SeaDarQ software will display the data (provided the radar layer is enabled – for Oil Spill
Detection, you should switch this layer off as soon as you are satisfied the system receives the radar data).
Checks to perform:
The indicator SYSTEM in the status panel shows green (see section II-6.12, Status)
The red rotation marker is moving along the outside of the radar image (see section II-6.3, Radar image)
Assuming GPS and gyro systems are providing valid position and heading information via the NMEA
ports, the LAT, LON, and HDG indications in the navigation panel will show valid data (see also section
II-6.9, Navigation).
As long as DMODE is not OFF, the Oil Spill Detection algorithms will start processing the incoming radar data.
For the first 32 rotations (assuming that is the corresponding enhancement level, STD; see section II-6.8,
Settings) the OSD indicators in the status panel will be dark red, with a moving dot, indicating that the Oil Spill
Detection system is initializing (building up its averaging stack). After this, the OSD indicators will turn green.
The SeaDarQ Oil Spill Detection system is now operational.
For Hydrography applications, see section II-22, Hydrography. You have to make a number of specialized
settings first.
4
Note that a Sperry radar passes out slow-rate “fake” radar data when it is in stand-by mode, before it is rotating
and truly transmitting.
6.1.1 Overview
This section describes the elements that are visible on the SeaDarQ main screen during normal operation in Oil
Spill Detection mode.
6.1.2 Purpose
The purpose of this description is to familiarize the user with the main elements that are present on the SeaDarQ
screen.
e b
f
i
k j
c
a
The sub-section “Layers” describes how to change the relevant layer settings. For a detailed description of all
available layers, see the description of the Layers Dialog window in the section Dialogs.
Interpretation and practical use of the different layers is described throughout this manual, as and where
appropriate.
Note that for normal Oil Spill Detection operation, the Enhanced layer should be visible, which means the Radar
layer should be hidden.
There are certain elements and features of the radar screen that warrant some extra explanation (see figure 7).
radar active indication To indicate that the SeaDarQ system is receiving radar signals, there is a thin red
rotation marker moving around the edge of the radar image.
ship direction If the SeaDarQ system is installed on a ship, by a blue line from the centre of the radar
image to its edge indicates the ship’s direction (heading or bearing).
Notes:
The menu-option Screen North Up determines whether the top of the radar image (the “up”
direction) corresponds to North, or to the ships direction.
Display of the ship’s heading depends on the heading or bearing signal (a.k.a. gyro) being connected to
one of the NMEA ports on the Acquisition Unit that is part of the SeaDarQ system.
course over ground COG = Course over Ground = GPS-derived actual course. This may be different from
the ship’s direction, due to currents and wind. Provided the SeaDarQ Acquisition Unit
receives this GPS signal, a small blue line-marker at the edge of the radar image
indicates this.
panning
To pan, press and hold the “middle” mouse button (that is, the scroll wheel) and move the mouse.
The two “press any key” methods of temporarily and completely zooming out and centering, described just
above, under “zooming in and out”, also work with respect to panning.
(a) (b) (c) (d) (e) (f) (g) (h) (i) (j) (k) (l) (m) (n)
Notes:
The three “file” buttons (f), (g), and (h), are only visible in “Oil Spill Detection from file” mode
“Remove the current polygon” is a typo, it removes all polygons
(b) Manual Rec: Status of the snapshot taker: Manual or Auto When started to take snapshots
(status) (this refers to regular snapshots) in automatic mode, also
indicates the time between
snapshots
(c) BRG / DIST Shows the direction (bearing, BRG) in
degrees and the distance (DIST) in
kilometres (km) or nautical miles (NM) of
the point on the radar image that the cursor
is over
(d) N/S E/W Shows the geographical coordinates of the (Assumes the geographical
point on the radar image that the cursor is location of the radar is given,
over either as a static position, or
via NMEA by a GPS device)
(e) UTC Shows the time, either as UTC (Universal see IV-3, View menu
Coordinated Time), or as local time (without
the “UTC” label), depending on the choice
for this
(f) ….-..-.. Shows the date (in the format yyyy-mm-dd)
Note: you can toggle between a blank status bar and one that shows the information described by using the ALT
key (provided SeaDarQ is not in full screen mode).
Actually, ALT is intercepted by Windows, and pre-selects the “Windows meta menu” (containing Restore,
Move, etc.) in keyboard select mode
6.7 Layers
The “Layers” panel lists the layers that are most important in Oil Spill Detection mode, and allows a quick and
convenient way to cycle through the three different modes there are for each layer.
Figure 10 shows the “Layers” panel in isolation.
Note that the order in which the layers are listed can change, depending on the way SeaDarQ is started, and the
history of SeaDarQ processing modes.
The high-to-low sequencing of layers with regards to visibility and obscuring of deeper (lower) layers can be
seen in the “Layers” dialog window; see the section Dialogs for details.
The second column in this panel indicates the visibility of each of the layers. There are three options for the
visibility of a layer:
show A layer with status “show” is visible, provided a higher layer with status “show” does
not obscure it. A layer with status “show” will block (obscure) the visibility of deeper
(lower) layers.
transp (transparent) A layer with status “transparent” is visible, but allows the next deeper layer
(or layers) with status “visible” (or “transparent”) to show through
hide A layer with status “hide” is not visible, and does not obstruct the view of deeper layers
Some notes:
Below these layers is the confidence map (layer “Quality” in the “Layers” dialog window), so if both
layers radar and enhanced are hidden or transparent, this confidence map will be visible (provided it is
enabled in the Layers dialog window).
There are extensive possibilities to adjust the colours, transparency, and visibility of these and all other
available layers through the “Layers” dialog window. Details can be found in the section Dialogs, in the
sub-section Layers Dialog.
For normal Oil Spill Detection mode, the Radar layer should be switched off (hide), making the
Enhanced layer the primary working layer.
Table 4 lists the layers in this panel that are relevant for Oil Spill detection, with a short description. Where
relevant, the table indicates where you can find further details. Other layers (Depth, Current, Length, and
DContour, are relevant for Hydrography; the Hydrography section, II-22, and in particular subsection II-22.1.6,
describes their use.)
Table 4: Description of the standard layers in "Oil Spill from Radar" mode
layer name description remarks
IMAGE if an image has been loaded (see reference), this is the see section “Loading and using a
layer that contains it Geo-encoded image”
ENHANCED the enhanced, processed radar image
RADAR the raw radar image
AIS information from the Automatic Identification System, see section “AIS”
provided this information is fed into the SeaDarQ
system via NMEA
6.8 Settings
The details which show up in the panel “Settings” depends on both the SeaDarQ operating mode, and on whether
Advanced Options are enabled or not in the Configuration menu. This section only describes SeaDarQ in Oil
Spill Detection mode. Figure 11 and figure 12 show the panel for the situation where Advanced Options are
disabled and enabled, respectively.
Note that the order in which the settings are listed can change, depending on the way SeaDarQ is started, and the
history of SeaDarQ processing modes.
Changing the active option for these settings works similar as described for “Layers” (with the exception of the
slider controls):
hovering the mouse over a setting and using the scroll wheel cycles through the options for that setting
double-left-clicking changes the setting to the next option
double-right-clicking changes the setting to the previous option
Options to change the setting of the slider controls are:
hovering the mouse over the slider bar and using the scroll wheel to move the slider left or right
clicking-and-dragging the slider to the desired setting
Note that double-clicking on and single- or double-clicking next to a slider do not have an effect
If “Scaling” is set to manual, two extra sliders appear, “Gain” and “Offset”. Under normal circumstances, scaling
should be kept to auto. The scaling setting does not appear in this panel if Enable Advanced Options in the
Configuration Menu is not switched on (indicated by a check-mark). This is also true of the setting for the
enhancement level (enh lvl)
Table 5 lists the different setting abbreviations in the Settings panel, what the abbreviation stands for, and what
the possible settings are.
Figure 11: The settings panel, with "Advanced Figure 12: The settings panel, with "Advanced
Options" disabled Options" enabled (and “Scaling” set to “Manual”)
Note that for Oil Spill Detection mode, the enhancement level should be set to MAX, otherwise false alarms on
all sorts of shadows will occur.
6.9 Navigation
The details that show up in the “Navigation” panel (see figure 13) depend on the configuration settings (see
section III-15.3.2, Configuration Settings dialog, Tab “Processing Parameters”). By default, range and location
(latitude and longitude) are shown (where range is the maximum distance SeaDarQ was configured to use for the
radar image – see Configuring Radar). In addition, it is possible to show heading ( HDG), speed (STW, for Speed
Through the Water), and depth (DPTH). For these last three parameters, SeaDarQ depends on external data-feeds
from NMEA devices.
Whether latitude and longitude are shown as degrees north/south and east/west, or as meters UTM, can be
selected through the “View” menu.
6.10 Meteo
The “Meteo” panel (see figure 14) will show the wind speed (WSPEED) and wind direction (WDIR), provided a
(NMEA) wind-sensor is connected to the system.
Figure 16 shows an example of the details listed for a detected spill; table 6 lists the parameters reported, with
some comments. (Note that where this table mentions “oil spill”, this can refer to all categories of oil spill that
SeaDarQ uses internally, as described in Section 7, Alarms and alarm stages.)
Note: The volume estimation depends on assigning a thickness estimate (in mm) to the (potential) oil spill
outline; see section II-7, in particular II-7.4.1, “Reaction to an alarm / possible follow-up actions”. The
default value for the thickness is 0 mm, so without any operator action to assign a thickness, the volume
will be reported as 0 m3.
6.12 Status
The contents of the “Status” panel (see figure 17) depend on some specific settings in the Configuration
Setup… window, on tab “Processing Parameters”. Some of the entries are only relevant for the Hydrography
module (and do not show on screen if the Hydrography license is not activated). Table 7 lists the abbreviations in
the Status panel, what they stand for, and what option in the Processing Parameters tab determines their
visibility.
Note that several of the operator actions mentioned above can also be performed in a slightly different form in
the “Oil spills detected” panel. See the section “User Interface Elements” for details.
7.2 Purpose
The reason alarms are subdivided into stages is the risk of a false alarm, and the potential cost of reacting to a
false alarm. The different stages alert the operator that something could be amiss; as the alarm progresses
through the stages, it satisfies more and more characteristics of a true oil slick, warranting more and more
attention. In the end, though, the operator has the final say, and is the one to decide if an alarm represents a true
oil spill.
False alarms and a number of their possible causes are detailed in the section “False Alarms”.
7.3 Enabling alarms in SeaDarQ
Alarms are enabled at installation, and by default. Should they have been disabled for whatever reason, the way
to (re-) enable them is to check all elements that are needed for its proper operation:
Make sure DMODE is not switched off (set it to its default of LOW FAR, low false alarm rate)
the Enhanced layer is the one of interest, so make sure it is visible (layers dialog) and not obscured by
the Radar layer
Check that the alarm thresholds are sensible or close to defaults (see section Tab “Alarms Settings”;
defaults are 1000 m2 for the area threshold, and 5 minutes for the persistence threshold).
Make sure the Shadow detector is switched on (Tab “Shadow Detector” in the Configuration Settings
dialog)
Make sure the range correction is set to automatic, normal mode (see Line window, Advanced Options
enabled). Note that if advanced options are disabled, SeaDarQ will automatically switch range
correction to automatic, normal mode.
The quickest way to get the whole system operating with its default settings is of course to Reset it to Factory
Defaults (see Configuration menu). Of course, this will also abandon any other special settings that might have
been configured.
An alternative could be to restore from an XML configuration file; of course, this does require the forethought of
saving such a file when the system is fine-tuned into a good operating state.
7.4 Use
See also “Oil Spills Detected” in section 6, “User Interface Elements”
Figure 21: Radar image, range correction off Figure 22: Enhanced image, range correction off
Figure 23: Radar image, range correction on Figure 24: Enhanced image, range correction on
9.4 Use
In SeaDarQ, Automatic Background Correction is switched on by default, using the “Normal Mode” range
correction algorithms. See below under “Advanced use” for use of other options.
9.5 Practical examples
The example in figure 26 shows a situation where the (unprocessed) radar intensity not only shows its normal
behaviour with respect to distance, but also shows a slightly different behaviour depending on direction, due to
the direction the wind is blowing. The figures to the right of the radar image show how the radar intensity falls
off with distance from the centre. The top-right image and the one immediately below it show this behaviour for
different directions, 20° and 115° from the North, respectively.
020°
Figure 25: Radar intensity along a line from the center in the 020°
direction
115°
Figure 26: Radar image, range Figure 27: Radar intensity along a line from the center in the 115°
correction off direction
Figure 28: Radar intensity along a line from the center in the 020°
direction
Figure 29: Radar image, range Figure 30: Radar intensity along a line from the center in the 115°
correction on direction
The three images in the bottom of the figure show the same situation, but with the automatic range correction
switched on. Not only is the radar image itself much more uniform, the radar intensity behaviour along the 20°
and 115° lines shows, too, that the range-corrected intensity hardly changes with distance, and that the difference
between the two directions is much less as well.
The real usefulness of this range correction becomes apparent when we compare the images in figure 31 to
figure 35, showing the same situation: there is an oil spill present. (The images are from several minutes later
than the ones in the previous figure; the ship has changed course, as is apparent from the blue heading line.)
The top two images show the raw radar image and the enhanced image, without range correction.
The second row of images shows the radar and enhanced images with normal automatic range correction. The
last image on the bottom row is identical to the enhanced image with normal automatic range correction, with the
addition of the automatic detection that is the important feature of SeaDarQ.
It is clear that with normal automatic range correction on the oil spill is much easier to recognize.
Figure 31: Radar image, range correction off Figure 32: Enhanced image, range correction off
Figure 33: Radar image, range correction on Figure 34: Enhanced image, range correction on
Figure 36: Rain, range correction Figure 37: Rain, range correction Figure 38: Rain, range correction
off (radar image) off (enhanced image) off (confidence map)
Figure 39: Rain, range correction Figure 40: Rain, range correction Figure 41: Rain, range correction
normal (radar image) normal (enhanced image) normal (confidence map)
Figure 42: Rain, range correction Figure 43: Rain, range correction Figure 44: Rain, range correction
rain mode (radar image) rain mode (enhanced image) rain mode (confidence map)
Figure 46: An oil spill on the radar image Figure 47: An oil spill on the radar image (zoomed in)
Figure 50: The same oil spill on the Figure 51: The same oil spill on the
confidence/quality map image confidence/quality map image (zoomed in)
Figure 52: The same oil spill as an alarm on the Figure 53: The same oil spill as an alarm on the
enhanced image enhanced image (zoomed in)
Use of the confidence or quality map is not necessary in normal oil spill detection operations. The information in
the confidence or quality map is used internally by the program; the final result is presented to the user through
the on-screen oil spill alarms.
11 FALSE ALARMS
Figure 54: Radar shadow from structures on the ship Figure 55: Radar shadow from structures on the ship
(radar image) (radar image, detail)
Figure 56: Radar shadow from structures on the ship Figure 57: Radar shadow from structures on the ship
(enhanced image) (enhanced image, detail)
Figure 58: Radar shadow from structures on the ship Figure 59: Radar shadow from structures on the ship
(false alarm) (false alarm, detail)
The structures that cause these radar shadows are in a fixed position with respect to the ship. The SeaDarQ
facility “Blocked areas” is included especially to deal with these kinds of shadows. In the example, constructing
three pie areas to cover the long stretched radar shadows, and a small circle to block the disturbing signals close
to the ship, effectively tell the Oil Spill Detection algorithms to ignore and not trigger any alarms based on these
areas. Note that these areas move along with the ship.
Figure 60 (previously shown in the section “Confidence map/Quality map”) shows blocked areas that could be
constructed for this case, as they would appear on the raw radar image. Figure 61 shows that now the oil spill
that is present in the area does trigger an alarm, and the radar shadows caused by the ship’s structures still show
up on the enhanced image, but no longer trigger false alarms.
For further details on the construction, use, and especially saving for future re-use of blocked areas, see the
section “Blocked Areas”.
Similar to how structures like the mast on the ship itself can cause radar shadows that can result in false alarms,
other ships in the vicinity can also cause radar shadows that can result in false alarms. Figure 62 to figure 69
show an example
Again, the nearby ship causes such an hard radar-echo that there is barely any energy left in the radar signal for
the area behind this nearby ship, resulting in a dark area that the Oil Spill Detection algorithms can mistake for
an oil spill, triggering a (false) alarm.
The dark radar shadow is more clearly visible in the enhanced image, and the Oil Spill Detection algorithms
mistaking the area for an oil spill and assigning it a high confidence level, can be seen by the red colour of the
area in the pictures of the confidence or quality map. Finally, figure 68 and figure 69 show that this indeed
results in the triggering of an alarm.
Figure 62: Radar shadow behind nearby ships (radar Figure 63: Radar shadow behind a nearby ship (radar
image) image, detail)
Figure 64: Radar shadow behind nearby ships Figure 65: Radar shadow behind a nearby ship
(enhanced image) (enhanced image, detail)
Figure 66: Radar shadow behind nearby ships Figure 67: Radar shadow behind a nearby ship
(confidence/quality map) (confidence/quality map, detail)
Figure 68: Radar shadow behind nearby ships Figure 69: Radar shadow behind a nearby ship
(enhanced image with false alarm) (enhanced image with false alarm, detail)
SeaDarQ has an extra, specialized set of algorithms that can recognize this kind of situation, called the shadow
detector. Simply having the shadow detector enabled (for details see the section “Shadow Detector”, and the
“Configuration Settings Dialog”, tab “Shadow Detector”), results in the radar shadow being blocked (by an
automatically, dynamically adjusting blocked area), as shown in the raw radar image of figure 70 and figure 71.
The enhanced image is no different from the situation without the shadow detector, except that this time no
alarms are triggered for this area. This is illustrated by the dark blue, low confidence assignation to the area in
the confidence / quality map, shown in figure 74 and figure 75.
Figure 70: The shadow detector blocks off the radar Figure 71: The shadow detector blocks off the radar
shadow behind nearby ships (radar image) shadow behind nearby ships (radar image, detail)
Figure 72: Because the shadow detector blocks off Figure 73: Because the shadow detector blocks off
radar shadow behind nearby ships, they do not cause radar shadow behind nearby ships, they do not cause
false alarms (enhanced image) false alarms (enhanced image, detail)
Figure 74: Effect of the shadow detector on the Figure 75: Effect of the shadow detector on the
confidence/quality map (dark blue areas) confidence/quality map (dark blue area, detail)
Figure 76 shows a situation with a number of small islands not very far from the ship equipped with the
SeaDarQ system. Similar as with structures on the ship itself, or other ships in the vicinity, an island can block
the radar energy from reaching an area behind it, resulting in a dark patch that can trigger the oil spill detection
algorithms into issuing a false alarm.
Figure 76: Nearby islands cause radar shadows behind them (overall enhanced image, and detailed views)
The images in figure 77 show a number of alarms, most of which are false because they are caused by a radar
shadow behind one or another of the islands.
Figure 77: Radar shadows behind nearby islands cause false alarms (enhanced image, overall and detail)
There are two features in SeaDarQ that can prevent false alarms of this kind, caused by islands. One is the
Coastline Database, the other the Shadow Detector.
As described in a bit more detail in the section “Coastline database and land-mask”, SeaDarQ uses a database
with worldwide geographic information on coastlines. The images above show these coastlines, where the
landmass is coloured a darker green. Close inspection of the images (or the extra zoomed in one in figure 77)
show that some, but not all, of the islands in the area are included in this database.
The islands being in the database does nothing yet about the radar shadows behind them. For this, the extra
option “extend radar line as land” needs to be used. This option is present in the tab “Coast Line Settings” of the
dialog window “Configuration Settings”, as “When radar line hits land, mark the rest of the radar line as land”.
Figure 78 shows the effect of this option on the overall radar image: it is very similar to the “blocked area” and
“shadow detector” features, but linked to the stationary geographical features (the blocked areas do move as the
ship moves, as they are linked to the radar lines).
Figure 80: Coastline database with land-extension feature combined with shadow detector avert false alarms
caused by radar shadows (radar image, enhanced image with alarms, enhanced image detail)
Figure 81: Enhanced image and enhanced image with alarms: the alarm in the centre of these images correctly
identifies an oil spill; the two smaller alarms are false alarms (see text for details)
Ocean waves can be large enough that their crests shield off their troughs from the radar energy. Figure 82
shows an example, where the range correction is switched off to make the effect more clearly visible. Some of
the troughs are actually darker than the oil spill that is present in the 035° direction from the ship.
Figure 82: Crests and troughs of ocean waves show Figure 83: Crests and troughs of ocean waves are
up on the raw radar image (WNW and ESE parts of averaged out in the enhanced image; range correction
the image) makes the intensity in the image uniform
Even in older versions of SeaDarQ, this effect was easily countered, by averaging the raw radar image over a
number of radar revolutions, resulting in the so-called enhanced image. The ocean waves travel enough of a
distance over this time-period, that their crests and troughs are averaged out and pretty much disappear in the
enhanced image. An oil slick does not move a significant distance in this time, and thus is not averaged away,
but instead appears more pronounced. The effect of the averaging becomes even better if the normal automatic
range correction is not switched off. The result is shown in figure 83, showing the enhanced image.
This averaging out of waves (and other small and relatively fast-moving objects visible in the raw radar image)
is the reason that in normal operational oil-spill detection use, SeaDarQ should have the radar image hidden, and
the enhanced image as the one being viewed.
Figure 84 through to figure 89 show a situation where the direction from which the wind is blowing is such that
in the lee of the coast there is significantly less wind. This results in an area of lower radar background intensity,
as there are less of the wind-generated disturbances that cause this background radar intensity level. The effect is
a darker area, vaguely noticeable in the raw radar image, but more clearly visible in the enhanced image and
even more so in the confidence or quality map. In some cases, this will lead to false alarms.
Figure 86: Wind shadow in the lee of the coast Figure 87: Wind shadow in the lee of the coast
(enhanced image) (enhanced image, detail)
Figure 90: Wake behind the ship vaguely visible Figure 91: Wake behind the ship vaguely visible (radar
(opposite the blue heading line; radar image) image, detail)
Figure 94: Wake behind the ship (confidence/quality Figure 95: Wake behind the ship (confidence/quality
map) map, detail)
Although in this case the wake is identifiable in the confidence or quality map, the level of confidence is not high
enough to cause a false alarm. If the wake does cause false alarms, this can be countered easily by constructing
an extra blocked area to block off the wake.
11.4.4 Rain
As mentioned in the section “Background Correction / Range Correction”, rain shows up in the radar image as a
bright, moving object (see figure 96, figure 97 and figure 98). It can disturb the oil spill detection algorithms by
changing the overall radar background intensity level.
Rain will also block the radar energy so that it does not penetrate through high intensity rain. The result is lower
radar backscatter intensity behind the rain.
Passing rain showers can often have regions of reduced winds and consequently a reduced radar backscatter
signal. This way, rain can lead to a false alarm.
Figure 97: Rain visible in the Figure 98: Rain visible in the
Figure 96: Rain visible in the raw
enhanced image (detail; bright confidence/quality map (detail;
radar image (detail)
areas) blue areas)
In SeaDarQ, this will usually not pose a problem with range correction set to normal, automatic mode. For
extreme cases, the range correction can be set to the special “rain mode”, but so far, this seems necessary only
rarely.
12 BLOCKED AREAS
12.1 Introduction
Sometimes, the radar image shows artefacts that interfere with the Oil Spill Detection algorithms. Examples are
the radar-shadow of a fixed structure (e.g., a nearby oilrig), or even the radar-shadow of parts of the structure (or
ship) where the radar is mounted. Figure 99 and figure 100 show examples.
Figure 99: Radar shadows and blanked area at an Figure 100: Radar shadows from structures on a
oil-rig ship
Figure 101: Configuration settings dialog Figure 102: Configuration settings dialog window,
window, blocked areas tab (allow edit box not ticked) blocked areas tab (allow edit box ticked)
The next table (table 9) lists the meaning of the properties in the columns “Start Range”, “End Range”, “Start
Angle”, and “End Angle”
Table 9: Properties of blocked areas on the tab "Blocked Areas" in the Configuration Settings dialog
shape start range end range start angle end angle comments
(in meters, radially from the radar)
circle not applicable radius of the not applicable not applicable circles are always
circle centred around the radar
ring inner radius outer radius not applicable not applicable ditto for rings
pie inner radius outer radius the edges of the pie-segment
(the angles are relative to the
heading (ship’s direction/bearing))
Note that all circle-segments have the radar location as their centre.
12.4 Options for the type of blocked area and their effect
As described in the previous paragraph, there are three options for the type of blocking to use for a blocked area.
These are:
processing Exclude the area from processing by the oil spill detection algorithms – neither artefacts
nor real spills within this area will trigger an alarm. The automatic range correction
algorithm will use the radar signal returns from within the area.
Select this option for small circles at the centre of the image, and for regions that are
small.
range correction Exclude the area from the automatic range correction algorithm. The oil spill detection
algorithms will process the area, so these algorithms can trigger alarms within this area.
all Combination of the effects of the settings “processing” and “range correction”, as
described above – the oil spill detection algorithms will not process the radar signal
returns from within the area, and the range correction algorithm will not use the radar
signal returns from within the area, either.
Select this option for large regions, in particular for land not detected by the coastline
database or for regions where the radar does not transmit (radar blanking areas).
The last subsection of this section gives some examples and further guidance on what option to use in what sort
of circumstances.
Figure 103: Structures on the ship cause radar Figure 104: Structures on the ship cause radar
shadows (radar image) shadows (radar image, detail)
Figure 107: Blocked areas constructed to prevent Figure 108: Blocked areas constructed to prevent
radar shadows from structures on the ship from radar shadows from structures on the ship from
causing false alarms (radar image) causing false alarms (radar image, detail)
13 SHADOW DETECTOR
13.1 Description
The “Shadow Detector” is a feature in the SeaDarQ software that recognizes situations where a high-radar-
reflection object (e.g., a ship) blocks the radar-energy, resulting in a dark area behind the object (as seen from the
radar antenna): a so-called radar shadow.
13.2 Purpose
The dark areas in the radar image that represent these radar shadows may trigger the automatic oil spill detection
algorithms into raising an alarm, which will be a false alarm. To bring down the number of false alarms, the
shadow detection algorithms mark off these radar shadows in a way that prevents the oil spill detection
algorithms from triggering an alarm.
13.3 Enabling the Shadow Detector
The Shadow Detector is switched on by default in SeaDarQ. Switching it on or off is done in the Configuration
Settings dialog window, on the tab `Shadow Detector`. The Configuration Settings dialog window is accessed
through the menu “Configuration”. (See the relevant sections elsewhere in this reference guide for details.)
13.4 Use
Switch the feature on as described above.
13.5 Practical example
The areas that are blocked off by the Shadow Detector show as narrow black pie segments in the raw radar
image, and as dark blue (low probability) pie segments in the Confidence / Quality map. These blocked off areas
do not show in the enhanced image (which is the default image to use for oil spill detection operation).
The examples below show the situation with the Shadow Detector off on the left, and with the Shadow Detector
on the right. In sequence, they show the raw radar image, the enhanced image (including alarms), and the
confidence/quality map. More detail is shown in the zoomed-in images, which follow the same pattern.
Figure 113: High values (yellow, red) in the Figure 114: Shadow detector suppresses high values
confidence/quality map caused by radar shadows in the confidence/quality map caused by radar
behind nearby ships shadows behind nearby ships
Figure 119: High values (yellow, red) in the Figure 120: Shadow detector suppresses high values
confidence/quality map caused by radar shadows in the confidence/quality map caused by radar
behind nearby ships (detail) shadows behind nearby ships (detail)
15 AIS
15.1 Description
AIS is the Automatic Identification System, by which ships transmit information about their identity, location,
course, and speed (amongst others). SeaDarQ can display some of this information on the radar image, provided
an AIS receiver (aka base station) is connected to one of the NMEA input ports on the SeaDarQ Acquisition
Unit.
15.2 Purpose
The primary purpose is to identify other ships that are in the field of view. It can for instance be useful to know
which ships are participating in oil spill recovery operations and which ones are marine traffic.
15.3 AIS display options
If an AIS receiver with NMEA output is installed, it can be connected to the SeaDarQ system via one of the
NMEA input ports on the SeaDarQ Acquisition Unit.
The level of detail that is shown about each ship transmitting AIS information depends on the settings in the AIS
menu, and on the visibility setting of the AIS layer:
If the AIS layer is visible (or transparent), each ship transmitting AIS information is visible as a blue
dot
If the mouse is hovered over one of these ships, the AIS label of that ship is shown in red, and if tracks
are shown, its track is indicated as a series of red dots
If “Show Labels” is enabled in the AIS menu, the AIS labels for all ships are shown continuously in
blue
If “Show Tracks” is enabled in the AIS menu, the track of each ship is shown as smaller dots.
15.4 Use
Have the AIS layer visible and transparent; whether or not to enable tracks and labels depends on how much ship
traffic there is. If there are many ships nearby, switch off the label display, but maybe leave the tracks enabled. If
the tracks clutter and confuse the display too much, switch these off, too.
To identify a ship, hover over the blue dot indicating its position.
To view a ship’s track, select to show tracks, and hover over the blue dot indicating the ship’s position to have its
label and track both highlighted in red.
15.5 Practical examples
Figure 121 to figure 126 show some examples of the various options there are for AIS information display.
Figure 121 shows the enhanced image without any AIS information (the AIS layer is switched off).
Figure 122 has the AIS layer visible, and both options to show labels and tracks enabled. There are many ships
nearby, and the display is quite cluttered.
Figure 121: AIS layer hidden Figure 122: AIS labels and tracks both enabled
Figure 123 has the AIS layer visible, but the menu options to show labels and tracks are both turned off. In this
situation, the positions of the ships as transmitted via AIS are indicated by blue dots. If you hover the mouse
over one of these dots, the ship’s identifying information, as transmitted via AIS, is shown highlighted in a red
label, similar as in figure 124 (except that in figure 124 the tracks are shown).
Figure 125, similar to figure 124, has tracks enabled and labels disabled. Figure 126 shows how both the label
and the track are highlighted in red when the mouse is hovered over a moving ship.
16.1.1 Description
The Line Window shows a curve of the intensity of the returned radar signal (the radar echo) as a function of the
distance to the radar antenna, and allows selection of a number of pre-defined range correction curves or manual
editing of a range correction curve.
16.1.2 Purpose
The intensity of the radar echo drops off with distance, which can make it difficult to distinguish the diminished
radar echo caused by an oil slick from the background. The range correction curve that is available in the Line
Window makes it possible to have a background intensity that is corrected for this drop-off with distance,
resulting in a uniform background intensity. This makes oil slicks at greater distances easier to distinguish.
16.1.4 Use
The use of the Line Window, in particular the range curve, is mentioned in the section “Background Correction /
Range Correction”, and described in detail (the “mechanics”, so to speak) in the sub-section “Line Window” in
the section “Dialogs”.
16.2.1 Description
The Histogram Window shows how often each (radar echo) intensity occurs over the entire radar-image, by
means of a histogram (i.e., the relative number of pixels of each intensity in the image).
16.2.2 Purpose
The histogram window is still present in the software, but this is for historical reasons mostly;
manipulation of the histogram affects the display, but it does not affect the detection algorithms.
16.2.4 Use
The use of the Histogram Window (the “mechanics”, so to speak) is described in the sub-section “Histogram
Window” in the section “Dialogs”.
17 USING POLYGONS
17.1 Purpose
Polygons were a tool in SeaDarQ v 2.x to assist in estimating the extent and volume of a (potential) oil-spill. In
later versions of SeaDarQ, this tool is still available, although the information displayed in the “Oil Spills
Detected” panel now covers a large part of this functionality.
One important use of polygons was estimating the size (surface-area) and volume of an oil spill. To this end,
SeaDarQ calculates the surface area of each polygon (in corresponding real-world units, either km2 or nm2).
Combined with an estimate for the oil slick layer thickness (default 0.1 mm, but this can be adjusted by the
operator), SeaDarQ also calculates the volume (in m3).
In later versions of SeaDarQ (v 3 and later), the surface area of automatically detected (potential) oil spills is also
calculated (and continuously re-calculated as the detected area changes over time).
Polygons can also be used to communicate the location and extent of a detected oil spill (or other feature), as the
user-specified polygons can be saved to file, in terms of the geographic location of the control points. Such a file
could be transferred, e.g., to other Oil Spill Response Vessels, to communicate location and extent.
Polygons and lines can also be used to aid in determining changes to an observed feature, in terms of location
and extent. A feature of interest could be marked out by a bounding polygon; if the feature moves very slowly
over time, comparison to the geographically stationary polygon or line can make this movement better visible.
17.2.1 Creation
Create a new polygon by either selecting “Add Polygon” from the Polygon menu, or by clicking the New
Polygon button on the toolbar. The new polygon will have three control points, and will have its lower edge
centered on the origin (i.e., the radar location).
Create a new line by either selecting “Add Line” from the Polygon menu, or by clicking the New Line button on
the toolbar. The new line will have two control points, and will be centered on the origin (i.e., the radar location).
17.2.3 Properties
A line will constantly be labelled with the distance (in km or nm, depending on the setting in the View menu)
between each pair of consecutive points.
A polygon will constantly be labelled with the enclosed area (in km2 or nm2, depending on the setting in the
View menu), and with the volume in m3. The volume is calculated using the thickness (in mm) of the polygon. A
new polygon is created with a default thickness of 0.1 mm, whatever the setting in the Polygon Settings dialog
window.
You can change the thickness for all polygons in the image by using the Polygon Settings dialog window,
through a right-click on the Polygon menu and changing the value there. Note that this will only change the
thickness for all polygons present at that time; new polygons will still be created with the default thickness of 0.1
mm.
You can change the thickness of an individual polygon by right-clicking it, and selecting “Settings…” from the
pop-up menu that will appear. The Polygon Settings dialog window that will appear is identical to the one that
shows after a right-click of the Polygon menu, except:
It only applies to the polygon it was popped-up from
It does not have the “Font” tab
Note that a subsequent change of the “general” thickness through the general Polygon Settings dialog window
(via right-clicking the Polygon menu) will override any previously set individual layer thicknesses.
17.2.7 Summary
The following table summarizes the instructions given above.
delete one line right-click on a segment of the line (but away from
control-points) and select “Remove Line” from the
pop-up menu
change layer thickness for right-click inside the polygon (but away from
one polygon control-points) and select “Settings …” from the pop-
up menu; change the layer thickness in the “Polygon
Settings” dialog window that appears
change layer thickness for right-click the “Polygon” menu, and change the layer
all polygons thickness in the “Polygon Settings” dialog window
that appears
save all polygons and lines menu Polygon ► Save to File … does not save layer
to file toolbar, button Save Polygons thicknesses
load polygons and lines menu Polygon ► Load from File … deletes all current
from file toolbar, button Load Polygons polygons and lines
SeaDarQ allows two options for the geographic coordinate system: latitude and longitude can be either in
degrees or in meters UTM.
The option to have the latitude and longitude available in meters UTM, too, is there because meters UTM is the
preferred system in disciplines that might use the Hydrography and Wave Processing mode of SeaDarQ.
Which one to use is a matter of preference.
The choice of geographic coordinate system can be made in the menu “View”; see its description in the section
“Menus”.
21 RECORDING DATA
There are several options in SeaDarQ to document a case by recording data. These options range from taking a
snapshot of the screen to writing the radar video data to a raw recording (which will include the NMEA inputs).
Single snapshot
Multiple snapshots at specified intervals
Geo snapshots
Recording of raw radar lines (including NMEA signals)
Note: recording the raw data also creates an XML configuration file, using the same filename as the recording
(but with an XML extension). When exchanging recordings, exchanging the XML configuration files alongside
with them will ensure viewing options and other settings (e.g. blocked areas) are the same as when the recording
took place.
It is also possible to create a log-file of the detections made by SeaDarQ. See the description of the “Alarm
Settings dialog”, where this logging can be enabled, a file-name can be specified, and what to log can be
specified.
The log-file is readable text, and contains latitude-longitude information of the points marking out the
detection/alarm area(s).
22 HYDROGRAPHY
22.1 General background / Theory of operation
22.1.1 Introduction
The "hydrography" module (formerly "Wave processing") can calculate a number of hydrographic parameters
from the SeaDarQ radar images. These parameters include the currents, wavelengths, and depths at chosen grid
points. This can be done because the sea surface clutter, that reflects the radar waves, also makes it possible to
observe features of the larger waves that the ripples and surface clutter ride on. This makes it possible to measure
important parameters of the waves, such as wavelength, wave period or frequency, and wave direction. By
exploiting the dispersion relation, which is a relationship between wavelength, wave period, water depth, and
current, it is possible to calculate the water depth and the magnitude and direction of the water current.
22.1.2 Purpose
Being able to determine the local water currents has some application to the Oil Spill Detection module, as it
may aid in estimating the expected behaviour of a spill. Note, however, that wind is generally speaking more
important in estimating spill movement.
Next to this application to oil spills, being able to determine the currents and waves at a (large) number of points,
simultaneously, is of interest on its own, for applications outside of oil spill detection. For instance, it can be
used to get an overall impression of the behaviour of currents and/or waves in an area, and over time. Based on
this overall view, it might then be decided which locations are most promising to do more detailed, point-wise
measurements with current- and/or wave meters and/or buoys.
22.1.3 Use
In SeaDarQ 5, the hydrography module can be used concurrently with the Oil Spill Detection mode. (For the
limited Workboat version, this is limited to a single calculation point.) The next paragraphs illustrate how to
operate this feature.
22.1.4 Prerequisites
Using the hydrography module (enabling the hydrographic calculations) requires a few decisions up-front:
Do the calculation results need to be saved to file for later post-processing? (This is separate from the
possibility of recording the raw radar data.)
At what points (in what area) do the calculations need to be performed?
Are the standard, default calculation settings sufficient?
Is there a particular calculation result that is of most interest?
Note that using non-standard calculation settings, i.e., changing the calculation parameters, is not trivial, and
should only be undertaken if you know what you are doing.
22.1.5 Assumptions
The same base prerequisite exists as for oil spill detection: the process depends on the presence of sea surface
clutter to make other features of the sea surface detectable. This means there needs to be a wind speed of at least
2 m/s; otherwise, there will be insufficient sea surface clutter to make the surface visible to the radar. (There is
also relation between the sea state and the range at which sea surface features can be observed by radar; see
section II-3.2.3, Detection range)
In order to calculate currents, waves need to be present and detectable in the radar image, and the wavelength of
these needs to fit at least several times into the area used for the calculations for each point. Usually, this will not
be a problem, but especially when changing the calculation parameters, this needs to be taken into account (for
details, see section II-22.3.3 Calculation Parameters).
The detailed information that is required for successful calculations, which needs to be extracted from the radar
image, means that the range should be kept relatively short; say between 3 and 6 km (2 to 3 nm).
Note that the example will indicate what settings and options to use in SeaDarQ, but will not go through the
details of how to effect these settings; refer to the other sections in the Reference Guide for those details.
Steps:
Make sure SeaDarQ receives the radar data (either have the radar layer shown or semi-transparent, or the
enhanced layer, and verify the red rotation marker is moving around the edge of the radar image).
Select an area to generate the grid: for this example, select the full area via the menu "Hydro", item "Full
Area".
Make sure to switch the Current and (wave) Length layers to Show.
Start the calculations: menu "Hydro", "Start".
At this point, SeaDarQ starts pre-processing the radar stream: gathering data from 64 radar revolutions. This is
indicated on the status bar at the bottom of the SeaDarQ window, with the notification "Hydro:PreProcessing",
followed by a percentage. Other than this increasing percentage, there will no indication yet that the
hydrographic calculations are happening.
Once enough data has been gathered (PreProcessing at 100%) SeaDarQ will start drawing current vectors and
wavelength/direction vectors at each grid point, starting at the lower left, and will start interpolating the
calculated depths.
When you hover the mouse over one of the grid points, the panel at the bottom right will show the numerical
values (depth, current, (wave)length, and height) for that point.
Which parameters are shown as an overlay over the radar image is in large part controlled by the visibility
settings of the relevant layers in the Layers panel (top left of the screen; see section II-6.7 for details).
The relevant layers are:
depth shows the numerical values of the calculated depth at each grid point -- hide is good for this
one, otherwise the other layers risk being totally obscured by all the numerical values at each
grid point ...
current shows (yellow) vectors for the calculated current magnitude and direction
length shows (red) vectors for the wavelength and -direction
dcontour shows contour lines and an interpolated gradient for the calculated depths
Figure 127: The Layers panel, including extra layers for hydrography
check that this interval is sufficient to finish a calculation run. In between runs, the status bar will show the
message "Hydro:Armed", to indicate that another data-collection and -processing run is pending.
In order to save the calculation results of all runs to file, not only should the writing of the results to file be
enabled (tab "Wave Report", item "Generate report" ticked), but the option to generate filenames automatically
should be enabled, too. Enabling the option to use the creation time as part of the filename tends to be the most
convenient choice. For further details, see the section III-17.3.5 Tab "Wave Report".
The time needed for the calculations per grid point (or virtual wave buoy) can be estimated at 3 seconds. (The
reference for this is a computer with a 2.1 GHz Intel Xeon E5 with 16 GB of RAM).
22.3.1 Introduction
There are a number of special cases that the software allows for:
You can specify the detailed parameters for the calculations. See section II-22.3.3 Calculation Parameters.
You can add virtual wave buoys at locations of your own choice, to have the software calculate the
hydrographic parameters at specific points. See section II-22.3.4.
You can load an exclusion file, to prevent calculations in non-simple areas where the calculations do not
make sense (for example, on an island). See section II-22.3.5.
You can pre-specify the depth. See section II-22.3.6 Depth Map.
You can set up the software to repeat the calculations at specific times and/or intervals. See section II-22.3.7.
You can have the software show the depth contours it calculates, and you can export these to file. See section
II-22.3.8.
Wave height and Wave spectra are special topics that this manual does not describe in detail. Sections II-
22.3.9 and II-22.3.10 touch upon some reasons for that.
The following sections describe backgrounds and use for these advanced special cases. The menu options and
dialog windows that play a role in these cases are mentioned, but details of these menus and dialogs are
described separately.
In pre-processing, data is gathered. In particular, the radar images from a number of consecutive radar rotations
are needed, as many as the cubic depth (see section II-22.3.3: Calculation Parameters).
In the second step, processing, data in space (neighbouring points) and time (consecutive radar images) is used
for each calculation point to determine the hydrographic parameters. This involves Fourier transforms to ω-k
space, and fitting to a 3D version of the dispersion relation.
Note that saving the general SeaDarQ configuration after a hydrographic calculation will also save the Fourier
coefficients that were calculated, related to the (calculation/cube) grid. As long as this grid is not changed, these
pre-calculated Fourier coefficients can be re-used in subsequent calculations, saving some calculation time. (This
calculation of Fourier coefficients is also behind the fact that the first round of hydrographic calculations always
takes longer than subsequent ones, in a series of calculations).
Note that the grid on which the hydrographic parameters are calculated (i.e., the grid on which the results are
presented) is not the same as the "neighbouring points in space" used for the calculations. The "points in space"
used for the calculations are related to the radar data acquisition (in fact, the pixels in the Cartesian image that
the radar data is mapped to). See figure 130 in section II-22.3.3 for an illustrative sketch.
Considerations for the size of the first grid (the points where the hydrographic calculations are done):
Choosing a small grid distance leads to too many grid points where calculations are done, which has the
following consequences:
long calculation time (O(3s) per point)5
oversampling (too much overlap in pixels used per grid point, so the results in each grid point are not
independent)
Note that there is also a limit inside the software on the maximum number of grid points; this is O( 5000 ).
Choosing a large grid distance, and hence fewer grid points for the calculations does not lead to intrinsic
disadvantages. It does lead to a sparse sampling of the field.
To give some rough estimates for the expected calculation times, consider the following situation:
standard grid = 300m
assume 3.84 km range (= radius of radar circle), leading to a pixel size of 7.5m
5
Note that on multi-core processor computers, points are allocated to different cores as available, so processing
does happen in parallel. The examples do not take this into account.
With a calculation time of 3s per point, this would give (for a single processing core):
468 *3s -> 1404 s = 23'24"
441 * 3s -> 1323 s = 22'03'
This does not take the pre-processing phase into account, in which the required number of radar images --64 by
default-- is gathered, taking the time of a radar revolution each.
The estimate for the calculation time of 3s per point assumes the following other settings and situation:
cube size 128
cubic depth 64
depth between 5 and 40 m
a situation with both enough surface clutter to make the waves visible (wind speed > 2 m/s)
a developed wave field within the range of the radar
The settings have a straightforward influence on the calculations. The situational requirements (wave field and
wind speed) are meant here to ensure the calculations converge quickly.
Some notes regarding situations for which the calculations of the hydrographic parameter results at a grid point
are skipped:
the calculation cube should contain at least 80% water (as opposed to land)
the result grid point itself should not be on land
The distinction land or water is made based on the exclusion file (if that is in use). If no exclusion file is used,
these considerations do not apply, and calculation attempts are made regardless of whether the grid point is over
land or not.
For the calculations on each of the grid-points, data from the surrounding "cube-size" area is used (in essence,
pixels in each direction), in a time-stack of "cubic depth" (see figure 129). "Cubic" or not determines whether
this is truly cubic (equal in both the number of pixels in the spatial dimensions and in the number of time-slices).
Figure 129: The calculation grid: cubic size and cubic depth
Figure 130: The results grid points and their individual calculation grids
The cube size should be chosen such that the longest wavelength expected fits in this area several times (see the
sketch in figure 129). The cube size (in meters) follows from the pixel size in the radar image. This pixel size in
turn follows from the radar range, and the number of sampling points per radar line, which is 512 by default.
This leads to the criterion that ( (radar range) / 512)*(cube size) > n*(max wavelength), where n = O( 5+ ).
As an example, for a pixel size of 7.5 m, i.e., a radar range of 3.8 km (~ 2 nm), and a default cube size of 128,
the maximum wavelength that can be determined is about 190 m.
The smallest wavelength that can be determined is 2 pixels (the situation here is more complicated than a
straightforward application of the Nyquist-Shannon sampling theorem). With the example values, that would be
a wavelength of about 15 m.
The calculations include a Fourier transform into ω-k space, where a fit to the (transformed) dispersion relation
is done. This fit is an iterative approximation, where in each step the local water depth is solved for first, and the
currents are solved for next. There are situations where it helps to limit the solution search space (and speed up
convergence to the solution) by introducing constraints. Constraints can be specified for minimum and maximum
depth (used for the current calculation step), for maximum current (used for the depth calculation step), and for
maximum wavelength. If the water depth is expected or known to be "deep" (>> wavelength), in practice deeper
than 30 or 40 m, a fixed depth should be specified.
The number of radar images used per calculation (64 by default) represents the time dimension. These are also
referred to as "radar (time) slices". Choosing fewer radar slices decreases the calculation time per point, but
using fewer points in time does lead to less stability in the calculations (i.e., more grid points where the
calculations do not converge, and hence do not give a result). Choosing too many radar slices at some point leads
to many extra calculations that do not contribute to the results.
The number of “cube” points, i.e., cubic size and cubic depth, has an influence on the minimum and maximum
dimensions in Fourier space. Too many cube points do not lead to more data. Instead, the data stays where it is,
but empty ω-k space is added. Figure 131 illustrates this.
Figure 131: Altering parameters influences the minimum and maximum dimensions in ω-k space, and may add
empty space
Altering the calculation parameters can lead to better or faster results. However, altering the parameters without
proper understanding of their effect can have adverse effects, rendering the calculations useless. Tread carefully.
Most of the calculation parameters can be altered via the Hydro configuration dialog window. See section III-17
for details on the Hydro configuration dialog window.
One example where it may be very useful to specify exactly where SeaDarQ should perform its hydrographic
calculations is for comparison with a (real) wave- or current measurement buoy, or some other instrument
deployed at sea. By defining a virtual wave buoy at the same coordinates, a direct comparison (possibly in post-
processing) will be possible.
Another example is to define a much smaller number of points where SeaDarQ should perform its calculations,
in order to reduce the calculation time required. Yet another example is to generate a grid outside of SeaDarQ, in
order to have the SeaDarQ results on the same grid as that used in some other software.
Such a smaller set of points could be selected from grid points originally generated by SeaDarQ itself. This takes
a number of steps.
Virtual Wave Buoys use either relative coordinates (meters East and North with respect to the ship and its
heading) or absolute coordinates (in meters UTM).
To generate a grid in UTM coordinates, switch the SeaDarQ coordinate system to UTM (menu "View", item
"UTM").
Select an area (using the applicable menu-options and controls, see section IV-14) where you want SeaDarQ
to generate the grid (you can visualise it by selecting "Lock Grid" from the menu "Hydro").
Instruct SeaDarQ to generate a wave report with coordinates in UTM (see section III-17.3.5); specify a
specific filename (and possibly location) for the wave report (see section III-17.3.5).
Do one cycle of wave processing (menu "Hydro", item "Start"); SeaDarQ will first need to do its pre-
processing, and after doing the actual calculations, write the results to file (the wave report).
Based on this wave report file in UTM, you can now make a selection of the points you want to use, and put
these into a file in wave buoy format (*.buo, see section V-3).
An alternative is to generate a sparse grid by script, especially in relative mode. Just choose your own grid size
(in meters), and remember that the radar is the grid origin (0,0). See also the virtual wave buoy file format
specification and example (in section V-3).
Adding one or more wave buoys "by hand" can be done via the menu "Hydro", item "Add buoy". This will add a
virtual wave buoy in the radar location, which can subsequently be dragged to its desired location (provide the
grid is not locked). Right-clicking a wave buoy will allow specification of some of its individual
parameters/properties. The menu item "Buoy settings ..." allows changing the default properties for all the buoys
that are defined. A right-click on a wave buoy and selecting "Settings ..." allows setting of the properties of this
specific wave buoy.
Another option is to use predefined virtual wave buoys, by reading them in from file. This is done via the Hydro
configuration menu, using the option "Use wave buoy file" on the tab "Wave module".
Wave buoys can have an absolute geographic location, or a relative location. If the radar is on a moving ship, a
wave buoy with a relative location will move along with the ship.
This is the primary method of preventing hydrographic calculations over land. Although the software uses a
coastline database and land-mask feature for oil spill detection, application of these to the hydrography part has
not been implemented yet.
You can load an exclusion file via the "Hydro" configuration dialog window: it is the option "Use exclusion file"
on the tab "Wave Module".
Section V-6, file format of an exclusion file, gives most of the details needed for the use of an exclusion file
(including the creation).
Normally, the SeaDarQ hydrographic calculations include a calculation of the depth for each grid point. In cases
where the bottom topography is complicated, this can hamper the convergence of the SeaDarQ calculations,
either leading to long processing times, or even leading to non-convergence of the calculations (meaning no
results for that grid point). Especially in cases where there is a sharp transition from shallow to deep within a
calculation grid, the software cannot cope: within that grid, there are 2 different dispersion relations, one for the
shallow part with short waves, and a different one for the deep part with longer waves. To help the calculations
at that point, it is possible to fill in a local depth via the depth map.
Note that it is not necessary to specify depths for every depth map cell; just the ones where the bottom
topography would/could cause problems.
Figure 132: Short and long waves over the shallow and deep parts of a gully
Figure 133: The dispersion relations are different over the shallow and deep parts of a gully
You can load a previously created depth map via the "Hydro" configuration dialog window, via the option "Use
depth map".
You can create a depth map via the menu option "Create Depth Map" in the menu "Hydro"; this toggles the
"depth map mode" on. After specifying the values for each of the 16x16 cells (see below for details), you can
save this depth map to file by right-clicking in the image and selecting "Save to file" from the pop-up menu.
22.3.7 Timers
See also section III-17.3.2 for the details of the Hydro Timers tab.
The timer controls on the tab "Hydro Timers" in the Hydro configuration dialog window control the repetition of
the hydrographic calculations. The default is to do only a single run of the hydrographic calculations, but using
the controls in the "Hydro Timers" configuration tab, the calculations can be repeated multiple times, at specified
times or intervals.
The timers and associated controls allow multiple runs of the hydrographic calculations.
The "Hydro Timers" tab is part of the "Hydro" configuration dialog window, which is accessed by right-clicking
the "Hydro" menu.
Section III-17.3.2 gives details for each of the controls on the "Hydro Timers" configuration tab.
It is common to combine the repeated hydrographic calculations with the (automatic) generation of wave reports,
so the results can be used and/or analysed in post-processing.
Specifying "-1" for the number of runs will result in the calculations being repeated ad infinitum.
It is strongly advised to not repeat the calculations without pause in between, as this would prevent SeaDarQ
from cleaning up internal buffers in between the calculations. It is best to use a timer interval such that there is a
little respite after finishing a calculation run. The exact interval for this needs to be checked "experimentally", as
the total processing time for a run depends on the calculation parameters, in particular the number of grid points
for which the calculations need to be performed. Limiting the grid by selecting a suitable area for the
calculations may help.
Notes:
The number of grid points is determined indirectly, through the radar range and the grid distance selected on
the "Wave Module" tab (and possibly reduced through selection of an area to limit the calculations --or rather
the grid generation-- to).
Selecting a non-default number for the cube size and the cubic depth will also influence the calculation time.
Other than triggering on a timer, it is also possible to trigger on an external event. However, this option has
not seen active use since Windows XP. The external program to support this mechanism is only available by
special request, and would first require some in-house testing. See footnote 6 on page 82 for a few more
details.
The depth contours can give a good indication of the bottom topography in the area.
Depth contours, and a false colour gradient in between them, are visualised on the DCONTOUR layer. To still
be able to see layers lower in the stack, it is common to set this layer to "transparent" (see section II-6.7 Layers
for details). Once calculated, the depth contour lines can be saved to file via the menu "Hydro Info", item "Save
Depth Contour". The contours are saved to file as a series of geographic points forming each line, for each of the
contour line values. (See the description of the depth contour file format in section V-5 for a bit more detail.)
Note that the false colour gradients in between the contours are not saved to file.
Saving the depth contours to file is a "one-shot operation"; it is not possible to save the contours automatically
after every calculation round. However, the depth values at the grid points are part of the information saved with
"wave reports", so if depth information is needed for each calculation round, that is the way to get it. (See section
V-2 for information on the wave report file format.)
The bottom topography, as derived from the depth results from the hydrographic calculations, is only available if
the water is shallow enough for this to make sense. If the expected depth is more than 40m (or rather, such that
the water is "deep" with respect to the waves, i.e., the depth is more than the wavelength), a fixed depth should
be specified (in the Wave Module configuration), otherwise the SeaDarQ calculations may not converge.
The default is for 5 contour lines, evenly spaced between the minimum and maximum depth values encountered.
This can be changed on the tab "Depth Contour Settings" in either the Hydro configuration dialog window
(section III-17.3.4), or in the Hydro Info configuration dialog window (see section III-18.3.2).
Sometimes, the contour-lines can exhibit a lot of jaggedness. This can be reduced via the setting for "Limit
Edge" on the tab Depth Contour Settings in the Hydro configuration dialog. This limit edge is the maximum
distance the algorithm accepts to look for points in order to smooth out the contour line. (See figure 135.)
Figure 135: The "Limit Edge" value may help to reduce the jaggedness of contour lines
III Dialogs
1 OVERVIEW
The following table, table 10, lists important dialog windows that are available and can be encountered in
SeaDarQ.
The column “remarks” mentions how a dialog window can be accessed.
The next sections describe each dialog window, including the different tabs that some of them have.
Note that the standard buttons “OK”, “Cancel”, and “Apply”, are mentioned as standard Windows buttons, and
not explained. Their meaning and intended use is assumed to be obvious.
Table 10: Overview of dialog boxes and windows in the SeaDarQ software
2 LAYERS DIALOG
2.1 Accessing the Layers dialog
The Layers dialog window can be opened in several ways:
by a right-click on the “Screen” menu
by selecting the item “Layers …” in the “Screen” menu
by clicking the “Layers” button in the Button or Tool Bar
2.2 Purpose and use
The Layers dialog window allows adjustment of various aspects of the different layers that are used in the main
SeaDarQ image. This includes the possibility of switching individual layers on or off.
The aspects of each layer that can be adjusted are:
its visibility (whether it is visible at all – but note that layers higher in the stack may obscure lower
layers)
its transparency (whether lower layers “shine through” or not, and if so, to what degree)
the main colour used for items in this layer, with separate choices for the colour used “during the day”
and the one used “during the night” (where day and night in this case refer to the relevant choice in the
“View” menu)
2.3 Details
Note that which layers are listed in the
Layers dialog (and which ones are
available via the on-screen Layers
panel) depends on the modules and
licenses that are active in SeaDarQ.
Examples in this section assume a
combined license for the Oil Spill
Detection and Hydrography modules.
The list (in figure 136) at the left shows
the layers available in the system, in
order.
Whether a specific layer is visible on
the screen or not, is first of all
determined by the setting for that layer
in the column “Show”. A tick-mark in
that column indicates that the layer is
visible.
The order of the layers means that a
layer higher in this list will obscure a
layer lower in the list, provided both
are marked “Visible”, i.e., “Show”.
A layer marked “Transparent” will
allow lower layers to “shine through”.
The slider for “Alpha”, in the right-
most column, determines the level of
transparency that applies to this layer if
“Transparent” is selected.
By default, each layer has a specific
colour for display during daytime
hours, and a more muted colour for
night-time hours. The drop-down
selection boxes in the columns “Day
Color” and “Night Color” allow the
Figure 136: Layers dialog window user to select different colours to their
own liking instead.
Display using day- or night-time colours is determined by selection of the appropriate option in the menu
“View”:
The Daytime colours are used when the option “Day” is selected in the “View” menu.
The Nighttime colours are used when the option “Night” is selected in the “View” menu.
Visibility and transparency of a number of layers can be controlled from the “Layers” panel in the main screen.
These layers are “Image”, “Enhanced”, “Radar”, “Depth”, “Current”, “Length”, “DContour”, and “AIS”. Use of
the “Layers” panel is described in the section “User Interface Elements”.
The table below (table 11) lists the layers again, with a short description of each layer, and if relevant, an
indication of where to find additional details.
The table following it (table 12) summarizes the options for each layer (i.e., the columns in the dialog window).
Table 12: Options for each layer, as available in the layers dialog window
option / column description reference
Layer The name of the layer
Show Visibility of the layer
Transparent Whether the layer is transparent or not
Day color The colour to use for the items in this layer, when menu “View”
“Day-time colors” are active
The drop-down selection box leads to a standard
Windows colour selection dialog, allowing another
colour to be chosen
Night color The colour to use for the items in this layer, when menu “View”
“Night-time colors” are active
The drop-down selection box leads to a standard
Windows colour selection dialog, allowing another
colour to be chosen
Alpha The level of transparency that applies to this layer, if
the corresponding checkbox in column “Transparent”
is ticked. The sliders allow adjustment of the
transparency for each layer.
Moving the slider to the left increases the
transparency (i.e., allows more of lower lying layers
to shine through), moving the slider to the right
decreases the transparency (i.e., allows less of lower
lying layers to shine through).
By default, the slider is in the middle, corresponding
to a transparency of 50%.
3 RECORDING DIALOG
3.1 Accessing the Recording dialog
The Recording dialog window can only be opened by a right-click of the “Recording” menu.
3.2 Purpose and use
The recording dialog window contains the settings for the raw radar recordings that SeaDarQ can make. It has 2
tabs. The “Recording” tab allows for the specification of the file the recording should be saved in. The tab
“Conditions” allows for specification of when the recording or recordings should start.
Recording stores the unprocessed radar lines on disk, with the addition of the NMEA data that is fed into the
SeaDarQ system (typically data from the ship’s navigation instruments and the received AIS data from ships
nearby). The system supports multiple, timed, and triggered recordings with recording limits. The storage time is
limited by the capacity of the used disks and the number of disks.
To start recording, select “Start” from the “Recording” menu. If no start conditions are set, the recording will
start immediately. If start conditions are set, the recording will start automatically when one of the conditions is
met. The recording will stop when the recording limit is reached, or when “Stop” is selected from the
“Recording” menu.
The status bar at the bottom of the screen shows the state of the recording (“Stopped”, “Writing”, or “Armed”,
the last state indicating it is waiting for one of the start conditions to be met).
Note that when making multiple recordings, you should let the system create filenames automatically, otherwise
the filename you specify will be re-used, and the file overwritten. Automatically generated filenames are
constructed from the date and time the recording starts, thereby making sure each filename is unique and files
will not be overwritten.
3.3 Details
The elements in the “Recording” tab of this dialog are described in the next list:
When choosing the maximum size for a recording file (the “Recording Limit”), please keep the following in
mind:
At the default resolution (1024 points per radar line), 4 GB of data corresponds to about 15 minutes of
recording
Certain file-systems have a limit to the maximum file size it can handle. In particular, the FAT file
system cannot handle files larger than 4 GB. This problem can crop up if you want to transfer the
recorded file or files to a DVD or USB stick. (Single-layer single-sided DVDs have a size limit of 4.7
GB anyway)
Selecting “Unlimited” for the recording limit has the potential of filling the disk that the file is saved to
completely. Use this option with care, and only when an operator is present continuously. Manually
stop the recording before the disk is filled completely.
Do not store recordings on the Windows system disk. The recording sub-system does not check whether
it might fill the disk completely, it just goes ahead and records. Completely filling the Windows system
disk will render the system inoperable.
The following table lists the elements in the tab “Conditions” of the Recording Settings dialog box:
6
This requires the program ExternTrigger.exe. ExternTrigger.exe is not part of a default installation; it is
available at special request. However, this option has not seen active use since Windows XP. ExternTrigger.exe
is only available by special request, and would first require some in-house testing. The program works by
monitoring the CTS line (pin 8) of serial port 1 (COM1). An external signal should take this line high to activate
the trigger.
Remarks:
For an unlimited number of recordings, the same warnings apply that do to an unlimited file size.
element description
Offset X translate the image this amount in the X direction
Offset (Y) translate the image this amount in the Y direction
Rotation rotate the image by this number of degrees (clockwise or counter clockwise)
OK / Cancel / Apply (Standard elements of Windows)
element description
Layer thickness Specify the layer thickness (in mm) used to calculate the volume in all polygons
defined on-screen
OK / Cancel / Apply (Standard elements of Windows)
Note: for the difference between a “regular” snapshot and a “Geo” Snapshot, see the section “Difference
between ‘Snapshot’ and ‘Geo Snapshot’ ”.
6.3 Details
element description
Create a filename When checked, the system will generate filenames based on the date and time, in
automatically the format “screen at yyyy-MM-dd hh.mm.ssUTC.tif”
When un-checked, the system will overwrite the selected file
File name If the option to generate a filename automatically is not switched on, you can
specify a filename here.
The button “…” leads to a standard Windows file-selection dialog.
If the filename selected corresponds to an existing file, this file will be overwritten.
Location The directory where the snapshot(s) will be stored.
The button “…” leads to a standard Windows file-location selection dialog.
element description
Put Location and Time on If this option is checked, the geographic information (latitude and longitude in
Image degrees or UTM, depending on the relevant selection in the “View” menu) and time
(in UTC) will be printed at the bottom of the image.
Automatic Snapshot In this area, parameters controlling the automatic, repeated taking of snapshots can
be specified.
Time between snapshots The time-interval in minutes between snapshots.
Number of images The maximum number of snapshots to take in one sequence (an automatic stop
criterion).
OK / Cancel / Apply (Standard elements of Windows)
element description
Create a file name When checked, the system will generate filenames based on the date and time, in
automatically the format “yyyy-MM-dd hh.mm.ssUTC.tif”
When un-checked, the system will overwrite the selected file
element description
File name If the option to generate a filename automatically is not switched on, you can
specify a filename here.
The button “…” leads to a standard Windows file-selection dialog.
If the filename selected corresponds to an existing file, this file will be overwritten.
Use creation time for If this check-box is not ticked, instead of the date and time of creating the snapshot,
filename the data and time of the original recording is used to construct the filename.
This is mostly useful when processing pre-recorded radar-data, in “… from file”
operational modes
Location The directory where the snapshot(s) will be stored.
The button “…” leads to a standard Windows file-location selection dialog.
Time between snapshots The time in minutes between snapshots.
Note that in the case of processing pre-recorded radar-data (in “… from file”
operational mode), the time between snapshots is the elapsed computer-time, not
the time that is inherent in the recording. The distinction is especially important as
the playback time of a recording does not necessarily correspond to the original real
time, so to speak.
Use Recording Time If this option is checked and the snapshots are made from a recording that is played
back, the timestamp used to automatically name the snapshots (if selected, see “Use
creation time …” above) is based on the timestamps embedded in the recording, not
the system time at the moment of playback.
If this option is checked and snapshots are made from live data, the system time is
used.
Put Location and Time on If this option is checked, the geographic information (latitude and longitude in
Image degrees or UTM, depending on the relevant selection in the “View” menu) and time
(in UTC) will be printed at the bottom of the image.
Auto Start If this checkbox is ticked, automatic taking of snapshot will start immediately when
the system starts (using the settings saved with “Save configuration”)
Create Tiff with 16bit gray If this checkbox is ticked, the Tiff images that are created will use a 16-bit
scale grayscale. As not all image processing software can read in 16-bit images, it is
possible to save he images as 8-bit grayscale images instead by unticking this box
OK / Cancel / Apply (Standard elements of Windows)
Note: if “Create a file name automatically” is un-ticked, the internal time-stamp of the recording is used for the
filename.
9 DIAGNOSTICS WINDOW
9.1 Accessing the Diagnostics Window
The Diagnostics window is reached by either
a right-click on the Diagnostics menu,
or
selection of the Show Diagnostics item in the Diagnostics menu.
9.2 Purpose and use
The Diagnostics window allows the inspection of a number of parameters that indicate the status of certain
operational aspects of the acquisition of radar data / radar lines.
9.3 Details
The exact contents of the Diagnostics window depend on the type of radar that the system is connected to.
Figure 144 shows the Diagnostics window with a generic radar.
Figure 145 shows the Diagnostics window with a Sperry BridgeMaster E radar, controlled by SeaDarQ.
A comparison of these figures shows that the contents of the Diagnostics window in the case of a generic radar
are a sub-set of contents in the case of a Sperry BridgeMaster E radar.
The following section lists the elements that are present in the Diagnostics Window. For more detailed guidance
on how to use the information this provides, including some suggestions on what to do if the indicators suggest
something is wrong, see the SeaDarQ Installation and Maintenance Guide.
Figure 145: Radar Settings dialog window (Sperry BridgeMaster E radar, controlled by SeaDarQ)
statistics description
performance counters
Angle A running count of the number of pulses from the angular encoder, which starts
over when the counter reaches the number of “Radar Encoder Pulses” set in the
device driver window
Max. angle The maximum that the angle counter reaches.
(This could be different from the “Radar Encoder Pulses” set in the device driver if
the “Radar Encoder Pulses” is set to too high a value)
Min. angle The minimum value that the angle counter reaches.
Delta time The time (in µs) between radar lines (i.e., the time between trigger pulses)
statistics description
performance counters
Max. delta time The maximum delta time encountered
Min. delta time The minimum delta time encountered
Lost lines The number of times the internal buffers stall due to lack of data.
Trigger timeouts A running count of trigger time-outs
Number of lines A running count of the number of radar lines read in (i.e., the number of trigger
pulses received)
Clear performance Reset the counters and statistics to 0.
counters
10.3 Details
The NMEA Log window has two menus, View and Ports. A description of the items in these menus follows.
The View menu (see figure 147) has the following menu items:
Auto Scroll
Toggles between automatic scrolling (ticked) and no automatic scrolling.
When ticked (automatic scrolling enabled), new NMEA data will be
added to the bottom of the list, and the list will automatically scroll up.
Clear
Clear the list (immediate, one-time action).
Show Unused
Show Errors
Figure 147: The NMEA log
Show Blocked
window's View menu
These three menu items allow selective filtering of the NMEA messages,
by toggling them on and off. Only the messages that are checked (have a tick-mark in front of them) in the
menu will show in the Log Window.
The Ports menu (see figure 148) has one item for each port.
The items in this menu allow selection of which ports to show the
messages of in the Log Window. (This does not influence the NMEA
messages processed by the SeaDarQ system; it only changes what is
shown in the Log Window.)
11 STATISTICS WINDOW
11.1 Accessing the Statistics Window
You get access to the Statistics Window by selecting the item “Statistics” from the “Configuration” menu.
11.3 Details
The Font Selection dialog window or tab is a standard Windows font selection dialog window.
12.3 Details
element description
Font The font family to use
Font style The font style to use
(regular, bold, italic)
Size The font size to use (in
points)
Effects This groups together the
Color and transparency
controls
Color The colour to use for the
font
Alpha When the “Transparent”
option-box is ticked, the
slider below allows
adjusting the amount of
transparency
Transparent When ticked, makes the font
transparent; the level of
transparency can be adjusted
with the slider (Alpha)
Sample This region will show a text-
Figure 150: Font Selection dialog window (or tab)
sample with the current
selections for the font
Proof If ticked, any changes to Font (family), Font style and Font Size will be applied to the
relevant text immediately, as if Apply was clicked after every change
OK / Cancel / Apply (Standard elements of Windows)
13 LINE WINDOW
13.1 Accessing the Line Window
The Line window can be accessed by one of the following means:
via the menu “View” “Line Window”
by clicking the toolbar button “Line Window”
The exact appearance and the available functionality depend on whether Advanced Options are enabled or not.
In the sub-section “The details”, these differences are addressed where relevant.
13.2 Purpose and use
In the Line window, it is possible to look at the details of the radar-intensity versus distance, for a selected angle
(pie) from the radar outwards. With “Advanced Options” enabled, this can be used for manual background /
range correction. Details of the interface elements (the mechanics, so to speak) will be described here; details of
practical use will be described in the sub-section “Background correction” of the main section “Background
Topics and Concepts”.
13.3 Details
It is not possible to change the top-to-bottom order of these sub-windows, nor is it possible to arrange them side-
by-side instead of vertically.
Another element to note is the two radial lines that appear in the main radar/enhanced image. These lines
demarcate the pie-sector for which the radar-line intensities versus distance are shown in the Line Window. At
the end of these axial lines is a small yellow dot that changes colour to red when the mouse pointer is hovered
over them. By clicking-and-dragging these dots, these demarcation lines can be moved (rotated about the centre)
individually. Figure 152 shows a close-up of these lines and the dots at their ends.
Figure 152: Demarcation lines (with yellow dots) determining the Figure 153: Histogram overlay can be
radar lines that are used in the Line Window (detail) repositioned by dragging the green
arrow left or right
The Line Window in fact shows a color-coded histogram of the radar intensities within the demarcated pie area,
as it changes with distance. This color-coded histogram can be observed in a more traditional fashion via a
sliding window within the Line Window. This more traditional histogram is rotated a quarter turn from its truly
traditional appearance. Figure 153 shows a close-up.
The radial distance for which this “traditional” histogram is shown is selected by means of the base-line of this
histogram. This base-line is indicated as the heavier white line at the left-hand side of the sliding window, and by
the green arrow at its bottom. The base-line / distance can be changed by dragging the green arrow (which
changes colour to red when the mouse hovers over it) to the desired location (distance) in the Line Window.
As the base-line / arrow is dragged to another location, it continuously updates the histogram to show the
distribution (relative abundance) of radar intensities at that distance (within the demarcation pie).
Do note that the entire radial collection of histograms (as visualised by the colour-banded curve) is built-up over
a number of consecutive radar revolutions. In other words, it can take some time before the curve is fully built
up.
Figure 154: "Range Correction Curve" menu Figure 155: Menu items and sub-menu in the "Range
appears by enabling Advanced Options Correction Curve" menu
The next table describes the menu-items as well as the two toolbar buttons.
add a control point position the mouse on or very close to the correction (see note below)
curve, until a red dot is attached to the cursor, and
click for a new control-point at that location, or click-
and-drag to create a new control-point at the location
where the mouse is released
add a control point in the either click the toolbar button “Add Control Point”, (see note below)
middle of the window or select the menu-item “Add Point” from the (local)
delete one control point right-click on or close to the control-point (move the instant, without undo
mouse close to or over the control point until its
colour changes from yellow to red)
reset the range correction either click the toolbar button “Reset”, or select the
curve to its default “Reset” menu-item from the (local) menu “Range
Correction Curve”
Note: if you manually remove all control-points, including the ones at the very ends of the curve, the first two
control-points you then add (either with the mouse or through button or menu-item) will automatically be added
at the two ends of the curve, irrespective of the location on the curve you are trying to add these first two points.
Resetting the curve to its default will always result in a flat curve with one control point at either end.
14 HISTOGRAM WINDOW
14.1 Accessing the Histogram window
The Histogram window can be accessed by one of the following means:
via the menu “View” “Histogram Window”
by clicking the toolbar button “Histogram View”
The exact appearance and the available functionality depend on whether Advanced Options are enabled or not.
In the sub-section “The details”, these differences are addressed where relevant.
14.2 Purpose and use
The histogram window is there for historical reasons, mostly. It shows the relative abundance of intensities over
the entire radar image (i.e., the relative number of pixels of each intensity in the image). It is not influenced by
the selection-area for the Line Window (the “pie” in between the “demarcation” lines), but it is influenced by the
range correction selected in the Line Window (be that none, one of the standard automatic ones, or a user-
constructed custom correction curve).
When “Advanced Options” are not enabled (see Configuration Enable Advanced Options), the Histogram
Window only shows this relative abundance of intensities over the entire radar image (i.e., the number of pixels
of each intensity in the image, a.k.a. the intensity distribution). The horizontal axis shows intensities, where 0
corresponds to the lowest intensity (black), and 100 corresponds to the highest intensity (white, or rather, the
brightest green). The blue (filled) shape indicates the relative abundance of each intensity.
With “Advanced Options” enabled, the Histogram Window offers the option to perform histogram intensity
mapping, of the enhanced image and of the radar image. In this case, it still shows the intensity distribution in
blue, but it also shows two intensity mapping curves. Manipulation of these intensity-mapping curves is
described here under “The details”, “Advanced Option enabled”.
14.3 Details
The main SeaDarQ screen shrinks to make room for the extra window. Note that the relative horizontal sizes of
the sub-windows can be changed by dragging the dividing border until the desired sizes are obtained.
As mentioned above, the histogram window shows how often each pixel-intensity appears in the entire image.
The intensities are shown on the horizontal axis, with dark being on the left-hand-side, and bright being on the
right-hand-side. The vertical axis shows how often each intensity appears in the image, relatively speaking. The
scale on the vertical axes is arbitrary in this case.
0% 50% 100%
Blue – White – Red
0% 50% 100%
Note: as the radar image (layer) is green, applying the
B-W-R colour-mapping has no visible result, unless
the colour for the radar layer is chosen as white
add a control point position the mouse on or very close to the correction
curve, until a red dot is attached to the cursor, and
click for a new control-point at that location, or click-
delete one control point right-click on or close to the control-point (move the instant, without undo
mouse close to or over the control point until its
colour changes from yellow to red) see note below
reset the mapping curve to either click the toolbar button “Reset”, or select the
its default “Reset” menu-item from the (local) menu “Enhanced
Color Curve” or “Radar Color Curve”
Note: if you try to remove a control-point at the right-hand end of a mapping curve, SeaDarQ will crash.
14.3.5 Threshold
Each of the layers that have mapping curves in the Histogram Window (both the Radar and the Enhanced layers)
has an adjustable threshold line in the Histogram Window if Advanced Options are enabled.
The threshold lines are indicated by movable vertical lines in the Histogram Window with a green arrow
underneath. The threshold line is a white line for the Enhanced layer, and a green line for the Radar layer. Either
line can be moved by clicking-and-dragging the corresponding arrow. Either arrow will change its colour from
green to red to indicate it will be selected, if the mouse hovers close to it.
The threshold for a layer determines the minimum un-mapped intensity that will be displayed in that layer.
The default for the thresholds is 0, meaning that all intensities will be shown.
Note that these thresholds are for display purposes only, they do not affect the automatic detection algorithms.
Note: changes to configuration settings are not saved automatically: if not saved explicitly, a
change of operating mode or a restart of the program will revert back to the settings in the registry
(for that mode).
element description
File locations Specify the main directory where snapshots and
recordings will be saved by default. (Snapshots will
be saved into a sub-directory “Images”)
Location You can enter a description of the ship or radar
location where this SeaDarQ system is located.
Figure 162: Configuration Settings dialog window, tab "Coast Line Server"
element description
Database specify the file-location of the coastline database
(This is normally factory-installed, and should not
need change)
Figure 168: Configuration Settings dialog window, tab "NMEA Serial Ports"
16.3 Details
element description
Replay when recording ends After a recording reaches its end, start again from the start
Play file on open When a recording has been opened for playback, don’t wait until “Play” is
selected, but start playing it immediately
Play back speed The slider can be used to adjust the playback speed of the recording.
Note that playback speed depends on many factors, such as computer processor
speed and disk access speed. There is currently no exact selection for real-time
speed.
% Read The progress bar in the bottom area of the window shows the percentage of the
recording that has been played back so far.
OK / Cancel / Apply (Standard elements of Windows)
17.3 Details
The Hydro configuration dialog window contains 5 or 6 tabs that organize the settings into groups that of related
items.
The tab "Font" is only present if Advanced Options are enabled (via menu "Configuration"; see section IV-2).
The following subsections describe each of the tabs in detail.
The parameters on this tab determine when the hydrographic parameters are calculated.
The parameters on this tab determine display of the calculated hydrographic parameters.
Figure 173: Hydro configuration dialog window, tab "Depth Contour Settings"
The parameters on this tab determine display, including colours, of the calculated depth contours.
Colours can be selected for both day- and night-display, where normally for night-display more muted colours
are chosen. See section III-2 Layers dialog for more details on day- versus night-display.
The parameters on this tab determine the writing to file of the hydrographic calculation results.
The settings on this tab determine the font used for the contour line values and for the depth values.
This dialog box is identical to the one in section III-12 (Font Selection dialog).
18.3 Details
The Hydro Info configuration dialog window contains 2 or 3 tabs that organize the settings into groups that of
related items.
The tab "Font" is only present if Advanced Options are enabled (via menu "Configuration"; see section IV-2).
Each of the tabs is also present in the Hydro configuration dialog; see there for their descriptions.
Figure 176: Hydro Info configuration dialog window, tab "Hydro Settings"
Figure 177: Hydro Info configuration dialog window, tab "Depth Contour Settings"
19.3 Details
20.3 Details
21.3 Details
IV Menus
1 OVERVIEW
Figure 182 shows the menu-bar of the main screen of SeaDarQ. Please be aware that the exact order of the
menus is not fixed, and may differ depending on the currently active module(s) and the recent history of module
use. Which menus are visible depends on the processing mode SeaDarQ is in.
Table 13 lists the menus, and gives a very brief description of the general purpose of the menu-items contained
in each menu.
Most menus in the menu bar allow accelerated access to a configuration dialog window specific to the general
purpose of that menu, by right-clicking the menu name. Table 13 also lists which dialog window opens when
you right-click that menu.
2 CONFIGURATION MENU
2.1 General purpose
selection of operating / processing mode (module), saving and loading of configuration file, enabling/disabling
of advanced options, and access to the general SeaDarQ software configuration settings dialog
2.2 Menu items
Figure 183 shows the menu items in the Configuration Menu.
Each item is described in more detail below.
Load an XML file with configuration settings you wish to use. Selecting this menu item will open a standard
Windows “Open File …” dialog window, allowing you to select an existing XML configuration file.
For the difference between saving the configuration and exporting the configuration to XML, refer to the
section “SeaDarQ software configuration settings”
Set Configuration as Default
Take the current configuration settings and use these as the defaults that SeaDarQ uses when it starts up
(including in particular the processing mode).
Note that changes to a combination of configuration settings that is not explicitly saved or marked to use as
default will not survive a restart of SeaDarQ, nor even a change of processing mode.
For the difference between saving the configuration and exporting the configuration to XML, refer to the
section “SeaDarQ software configuration settings”
Restore Factory Defaults
Discard all changes to configuration settings, and reload a standard default set of settings that is predefined as
“Factory Defaults”.
Note that even a change of configuration settings to the Factory Defaults that is not explicitly saved or
marked to use as default will not survive a restart of SeaDarQ, nor even a change of processing mode.
For the difference between saving the configuration and exporting the configuration to XML, refer to the
section “SeaDarQ software configuration settings”
Setup…
Selection of this menu-item will open the general, multi-tabbed SeaDarQ Configuration Settings dialog
window. For the variety of configuration settings that can be set in this dialog window (and its different tabs),
see the section “Configuration Settings dialog” (and “SeaDarQ software configuration settings”).
Note that certain special configuration settings will only be accessible if “Advanced Options” is enabled.
Statistic…
This menu item opens the (Pin) Statistics Window. The Statistics window gives a limited view of the internal
state of activity inside SeaDarQ. This is sometimes useful in troubleshooting.
Enable Advanced Options
Selection of this menu-item toggles the possibility of changing Advanced Options in various configuration
parts of the SeaDarQ software. If there is a tick-mark in front of this menu-item (as in figure 183), access to
“Advanced Options” is switched on; absence of a tick-mark indicates that “Advanced Options” are currently
not accessible.
Exit
Close down the SeaDarQ program.
Please be aware that closing down the SeaDarQ program does not lead to a question about saving of
configuration settings; changes to configuration settings and even selection of a different processing mode
are discarded when exiting the program. If you wish to save configuration settings, you have to do so
explicitly through use of the menu-items “Save Configuration” or “Export XML Configuration”. If you wish
SeaDarQ to start in the current processing mode after a restart, you have to select the current processing
mode as default through the menu-item “Set Configuration as Default”.
2.3 Right-click dialog window
A right-click on the Configuration Menu does not lead to any dialog window.
3 VIEW MENU
3.1 General purpose
enabling / disabling of specific extra windows (Line and Histogram window)
visibility of Status and Toolbars,
and various aspects of the main display
3.2 Menu items
Figure 184 shows the menu items in the View Menu.
Each item is described in more detail below.
Line Window
Toggles the presence of the “Line” window, which shows the radar
intensity of a number of radar lines as a function of distance from the
radar antenna. If the Line Window is visible, the icon in front of this
menu-item acquires a thin outline, somewhat suggesting the
appearance of “pressed” button.
If “Advanced Options” are enabled, this window also gives access to
a menu (attached to the Line Window) that allows advanced control
over various aspects of the Range Correction that is used.
For details on the Line Window, see the section “Line Window”.
For details on the Range Correction, see both the sections “Line
Window” and “Range Correction”.
Histogram Window
Toggles the presence of the “Histogram” window, which shows a
histogram of the intensities in the entire radar image. If the
Histogram Window is visible, the icon in front of this menu-item
acquires a thin outline, somewhat suggesting the appearance of
“pressed” button.
If “Advanced Options” are enabled, this window also gives access to
options to manipulate the colour curve (colour mapping) for the
radar image and the colour curve for the enhanced image.
For details on the Histogram window and on manipulation of colour
curves, see the sections “Histogram window”.
Full screen Figure 184: View menu
Toggles exclusive take-over of the entire Windows screen real-
estate.
If “Full screen” is enabled (indicated by means of a tick-mark in front of this menu-item), the SeaDarQ
window takes up the entire screen, and stays on top of all other windows, rendering other windows
inaccessible.
Status Bar
Toggles the presence of the status bar at the bottom of the SeaDarQ window. If the Status Bar is present, a
tick-mark is present in front of this menu-item.
For information about the details that are shown in the Status Bar, see the section “Status Bar” in the chapter
“User Interface Elements”.
Toolbars
Toggles the presence / accessibility of toolbars in various SeaDarQ windows. If toolbars are accessible, a
tick-mark is present in front of this menu-item.
Toolbars can be present in the main SeaDarQ window, and in the Line and Histogram windows, provided
Advanced Options are enabled. The “Toolbars” menu-item-toggle influences the toolbars in all of these
windows.
Km
This menu-item selects kilometres as the unit of distance in the SeaDarQ interface.
It is mutually exclusive with the “Nm” menu-item, which selects nautical miles as the unit of distance; a tick-
mark in front of one of these menu-items indicates which one is selected.
Nm
This menu-item selects nautical miles as the unit of distance in the SeaDarQ interface.
It is mutually exclusive with the “Km” menu-item, which selects kilometres as the unit of distance; a tick-
mark in front of one of these menu-items indicates which one is selected.
Day
Selects the “Day” colour- and intensity scheme for display.
This menu-item is mutually exclusive with the menu-item “Night”. Which of the two is active, is indicated
by a tick-mark in front of the active one.
Refer to the description of the “Layers” dialog window for an overview of the colours that are used for the
different layers for “Day” and “Night” display. If required, these colours can be changed in the “Layers”
dialog window.
Night
Selects the “Night” colour- and intensity scheme for display.
This menu-item is mutually exclusive with the menu-item “Day”. Which of the two is active, is indicated by
a tick-mark in front of the active one.
Refer to the description of the “Layers” dialog window for an overview of the colours that are used for the
different layers for “Day” and “Night” display. If required, these colours can be changed in the “Layers”
dialog window.
Degrees
Selects degrees and (decimal) minutes as the units for geographical location.
This menu-item is mutually exclusive with the menu-item “UTM”. Which of the two is active, is indicated by
a tick-mark in front of the active one.
UTM
Selects “meters UTM” as the units for geographical location.
This menu-item is mutually exclusive with the menu-item “Degrees”. Which of the two is active, is indicated
by a tick-mark in front of the active one.
Local Time
Selects the local time as the time to display.
This menu-time is mutually exclusive with the menu-item “UTC”. A tick-mark before the menu-item
indicates the active one.
UTC
Selects UTC (Universal Coordinated Time) as the time to display.
This menu-time is mutually exclusive with the menu-item “Local Time”. A tick-mark before the menu-item
indicates the active one.
4 SCREEN MENU
4.1 General purpose
several other aspects of the main display
4.2 Menu items
Figure 185 shows the menu items in the Screen Menu. Each item is described in more
detail below.
North Up
Toggles how the radar image is displayed, in terms of what the top of the screen
represents: North, or the direction (heading) of the ship.
If the top of the image represents North, (i.e., if “North Up” is selected) the icon in
front of this menu-item acquires a thin outline, somewhat suggesting the Figure 185: Screen
appearance of “pressed” button. If the top of the image represents the ship’s menu
heading (“North Up” is de-selected), the icon is displayed without the “pressed”
outline.
Irrespective of the selection of this menu-item, the ship’s heading is indicated on the radar image by a blue
line from the centre of the radar image to its edge. Obviously, when the top of the image represents the
heading of the ship, this blue line points straight up. The compass ring around the edge of the image adjusts
in correspondence with the setting of this menu item and the ship’s heading.
Fit
Reverts back to a window-filling zoomed-out display of the radar image.
For the various ways of zooming in to and out of the radar image, see the section “Radar Image” in the
chapter “User Interface Elements”
Layers…
Opens the “Layers” dialog window, allowing a range of customizations of the various layers in the radar
image. These range from visibility of individual layers to day- and night-time colours, and even the degree of
transparency.
For details on the Layers dialog window, see the section “Layers dialog”.
4.3 Right-click dialog window
Opens the “Layers” dialog window, allowing a range of customizations of the various layers in the radar image.
These range from visibility of individual layers to day- and night-time colours, and even the degree of
transparency.
For details on the Layers dialog window, see the section “Layers dialog”.
5 DIAGNOSTICS MENU
5.1 General purpose
The sole purpose of the Diagnostics menu is to open the Diagnostics window (see section III-9).
Show Diagnostics
Figure 186: Diagnostics menu
Open the Diagnostics window.
6 RECORDING MENU
6.1 General purpose
recording of raw radar data
For details, see the description of the Recording dialog window elsewhere in this guide.
6.2 Menu items
Figure 187 shows the menu items in the Recording Menu. Each item is described in
more detail below.
Start
Starts the recording of raw radar data to a SeaDarQ DRQ file.
Configuration settings for the file should have been made prior to starting the Figure 187: Recording
recording; these are made in the “Recording” dialog window, which can be menu
accessed by right-clicking the “Recording” menu.
The “Start” and “Stop” menu-items are, of course, mutually exclusive, and indicate which of the two states
the recording subsystem is in. The current state is indicated both by a tick-mark (with a thin outline,
suggesting a “pressed” button) and by being greyed-out and not selectable (as it makes no sense to re-select
the state that this subsystem is already in). The menu-item corresponding to the alternate, not-selected state,
does not have a tick-mark, is not greyed out, and is selectable.
Stop
Stops the recording of raw radar data to a SeaDarQ DRQ file.
Configuration settings for the file should have been made prior to starting the recording; these are made in
the “Recording” dialog window, which can be accessed by right-clicking the “Recording” menu.
The “Start” and “Stop” menu-items are, of course, mutually exclusive, and indicate which of the two states
the recording subsystem is in. The current state is indicated both by a tick-mark (with a thin outline,
suggesting a “pressed” button) and by being greyed-out and not selectable (as it makes no sense to re-select
the state that this subsystem is already in). The menu-item corresponding to the alternate, not-selected state,
does not have a tick-mark, is not greyed out, and is selectable.
6.3 Right-click dialog window
Opens the “Recording” dialog window, which gives access to a number of configurable / adjustable settings that
are relevant for recordings, amongst others the filename to use, where to store the file, and the maximum size of
the recording file.
For details on the Recording dialog window, see the section “Recording dialog”.
Also, heed the warnings about file size limits and the risk of completely filling a disk in the computer.
7 IMAGE MENU
7.1 General purpose
overlay of an image from file
See also:
the description of the Image Alignment dialog window
7.2 Menu items
Figure 188 shows the menu items in the Image Menu. Each item is described in
more detail below.
Load from File…
Load a GeoTIFF encoded image from file.
Selecting this menu item will open a standard Windows “Open File …”
dialog window, allowing you to select the file that contains the image you
wish to load. Figure 188: Image menu
The image will be loaded into the Image layer.
Remove
Delete any and all images in the Image layer.
Alignment…
Image Alignment dialog window
7.3 Right-click dialog window
Image Alignment dialog window
8 POLYGON MENU
8.1 General purpose
creation, manipulation, saving and loading of polygons
See also:
sub-section “Using Polygons” in the section “Background Topics and Concepts” elsewhere in this
Reference Guide
the description of the Polygon Settings dialog window elsewhere in this guide.
9 AIS MENU
9.1 General purpose
display aspects of the incoming Automatic Identification System information
The AIS module will display AIS information from ships in the neighbourhood, when an AIS receiver is
connected to the system. The AIS information is also stored in recordings and thus can be reviewed when a
recording is played back.
If the AIS layer is visible, each ship that transmits AIS information is indicated by a blue dot on the screen.
Whether additional information is shown for ships, depends on the selections activated in the AIS menu.
What information is available on a ship depends on the information that ship transmits.
If the mouse is hovered over the dot indicating a ship with AIS information, the AIS label of that ship is shown
in red, and, if tracks are shown, the ships track is indicated in red dots.
If “Show Labels” is enabled, the labels for all ships transmitting AIS information are shown continuously in blue
(or the colour selected for the AIS layer).
If “Show Tracks” is enabled (on), the ships tracks (so determined from the AIS information they transmit) are
indicated in smaller dots.
You can find examples in the sub-section “AIS” in the section “Background Topics and Concepts”.
9.2 Menu items
Figure 190 shows the menu items in the AIS Menu. Each item is described
in more detail below.
Show Labels
Toggles the display of AIS ship identification strings.
If “Show Labels” is active (indicated by a tick-mark in front of this
menu-item), each ship in the image that transmits AIS information is
labelled with a subset of this information, typically the MMSI Figure 190: AIS menu
number.
If “Show Labels” is inactive (indicated by lack of a tick-mark in front of this menu-item), a subset of the AIS
information that a ship in the image transmits is only shown as an attached label if the mouse is hovered over
the (blue) dot indicating the ship.
Show Additional Info
Toggles the display in the AIS label of extra information that is available from the AIS strings – typically, the
ship’s name and its destination. Note that this information is not broadcast as often as the MMSI number, and
depends on some of this information being filled in at the transmitting ship.
Show Tracks
Toggles the display of ship tracks that can be deduce from the AIS information sent out by ships.
If “Show Tracks” is active (indicated by a tick-mark in front of this menu-item), ship tracks are shown.
If “Show Tracks” is inactive (indicated by lack of a tick-mark in front of this menu-item), ship tracks are not
shown.
9.3 Right-click dialog window
Font selection dialog window.
This allows control of the font and font appearance used for the labels displaying the AIS information.
Start Automatic
Start automatically taking regular snapshots of the screen, using the current settings for snapshots, as can be
set via the Snapshot Settings dialog window. The current settings include the time between snapshots. Taking
snapshots will continue until the “Stop Automatic” menu-item is selected.
Once automatic taking of snapshots is started:
the “Start Automatic” menu-item will get a tick-mark in front of it, to indicate that it is active;
the “Start Automatic” menu-item will also grey-out and become un-selectable;
the “Stop Automatic” menu-item will no longer have a tick-mark in front of it;
the “Stop Automatic” menu-item will no longer be greyed-out, and it becomes selectable
Stop Automatic
Stop automatically taking regular snapshots of the screen.
Once automatic taking of regular snapshots is stopped:
the “Start Automatic” menu-item will no longer have a tick-mark in front of it;
the “Start Automatic” menu-item will not be greyed-out, and it becomes selectable
the “Stop Automatic” menu-item will get a tick-mark in front of it, to indicate that it is the current
state;
the “Stop Automatic” menu-item will also be greyed-out and un-selectable;
Note that once automatic snapshot taking has started, changes in the Snapshot Settings dialog (which is still
accessible) do not take effect until after the session of snapshots “in progress” is finished or stopped.
Start automatic
Figure 193: Geo Snapshot
Start automatically taking GeoTIFF encoded snapshots of the screen, using menu
the current settings for GeoTIFF snapshots, as can be set via the GeoT IFF
Snapshot Settings dialog window. The current settings include the time between snapshots. Taking snapshots
will continue until the “Stop Automatic” menu-item is selected.
Once automatic taking of GeoTIFF encoded snapshots is started:
the “Start Automatic” menu-item will get a tick-mark in front of it, to indicate that it is active;
the “Start Automatic” menu-item will also grey-out and become un-selectable;
the “Stop Automatic” menu-item will no longer have a tick-mark in front of it;
the “Stop Automatic” menu-item will no longer be greyed-out, and it becomes selectable
Stop automatic
Stop automatically taking GeoTIFF encoded snapshots of the screen.
Once automatic taking of GeoTIFF encoded snapshots is stopped:
the “Start Automatic” menu-item will no longer have a tick-mark in front of it;
the “Start Automatic” menu-item will not be greyed-out, and it becomes selectable
the “Stop Automatic” menu-item will get a tick-mark in front of it, to indicate that it is the current
state;
the “Stop Automatic” menu-item will also be greyed-out and un-selectable;
Note that once automatic snapshot taking has started, changes in the Snapshot Settings dialog (which is still
accessible) do not take effect until after the session of snapshots “in progress” is finished or stopped.
13 FILE MENU
13.1 General purpose
playback of recorded radar data
See also:
The File Settings dialog window
The Recording menu (to create a SeaDarQ recording)
The Recording dialog window (for various configuration options for recordings)
Note: this menu is only available if one of the “from file” modes is selected from the Configuration menu (in the
context of this manual: Oil Spill Detection from File)
13.2 Menu items
Figure 194 shows the menu items in the File Menu. Each item is briefly described
below.
Settings…
Opens the File Settings dialog window
Open
Open a SeaDarQ recording for playback.
Selecting this menu item will open a standard Windows “Open File …” dialog
window, allowing you to select a file with a previously made SeaDarQ Figure 194: File menu
recording. If an XML configuration file exists in the same directory as the
recording, and with the same name as the recording, this configuration file will be loaded automatically. This
way, various configuration settings, in particular any blocked areas, will be re-established for playback of the
recording.
SeaDarQ recordings by default have an extension “.drq”
Note that when “Play file on open” is selected in the File Settings dialog window, the recording starts playing
immediately.
Play
Start playing the recording that was selected via the “Open” menu item.
Notes:
When “Play file on open” is selected in the File Settings dialog window, the recording starts playing
immediately
When “Replay when recording ends” is selected in the File Settings dialog window, the recording
will start playing again from the start after it reaches its end
Stop
Stop playing the recording.
13.3 Right-click dialog window
File settings dialog window
14 HYDRO MENU
14.1 General purpose
The items in this menu control the processing of hydrographic parameters, i.e., currents and waves.
menu. Selecting the same option again will not result in any change (in this case, the tick-mark does not
function as a toggle).
Note that changes to the area-selection after processing has started have no effect until processing is stopped
(either forcibly via "Abort", or by finishing the processing cycles that were configured via "Hydro Timers" –
see II-22.2.4, II-22.3.7 and III-17.3.2). Note the implication in case of "endless" processing.
Within the selected area, a rectangular grid of points will be constructed, according to the parameters set on
the tab "Wave Module" in the "Hydro "configuration dialog window (III-17.3.1).
Note that areas are relative to the bearing line, i.e., the heading. If the heading changes, the area will rotate
with the bearing line.
Circle Area
Select a circular area as the area for which to calculate the hydrography results.
After selecting this option, an outline of the area currently selected will show as an overlay on the SeaDarQ
radar image. Two small yellow dots are part of the outline, and function as control points for the area shape.
(If no area shape was selected previously in this session, either the full area of the radar will be selected, or
two overlapping control points will show. If some area has been selected earlier, the control points of the
previous area selection will be used as the starting points for the current selection -- even if the previous area
selection was a different shape.)
For a circle area, dragging this control point determines the radius of the circle area. A second control point
determines an inner radius; in effect, this allows selection of a circular band or annulus. If the control point
for the inner circle is dragged to the center of the radar image, the complete circle (up to the outer radius) is
selected.
Of the five options "No Area", "Full Area", "Circle Area", "Pie Area", and "Rectangle Area", only a single
one can be active. If a particular option has been selected, a tick-mark will be placed in front of it in the
menu. Selecting the same option again will not result in any change (in this case, the tick-mark does not
function as a toggle).
Note that changes to the area-selection after processing has started have no effect until processing is stopped
(either forcibly via "Abort", or by finishing the processing cycles that were configured via "Hydro Timers" –
see II-22.2.4, II-22.3.7 and III-17.3.2). Note the implication in case of "endless" processing.
Within the selected area, a rectangular grid of points will be constructed, according to the parameters set on
the tab "Wave Module" in the "Hydro "configuration dialog window (III-17.3.1).
Note that areas are relative to the bearing line, i.e., the heading. If the heading changes, the area will rotate
with the bearing line.
Pie Area
Select a pie-shaped area, determined by an outer radius, an inner radius, a starting angle, and an ending angle,
as the area for which to calculate the hydrography results.
After selecting this option, an outline of the area currently selected will show as an overlay on the SeaDarQ
radar image. Two small yellow dots are part of the outline, and function as control points for the area shape.
(If no area shape was selected previously in this session, either the full area of the radar will be selected, or
two overlapping control points will show. If some area has been selected earlier, the control points of the
previous area selection will be used as the starting points for the current selection -- even if the previous area
selection was a different shape.)
For a pie area, one control point determines outer radius and starting angle, and the other one inner radius and
ending angle.
Of the five options "No Area", "Full Area", "Circle Area", "Pie Area", and "Rectangle Area", only a single
one can be active. If a particular option has been selected, a tick-mark will be placed in front of it in the
menu. Selecting the same option again will not result in any change (in this case, the tick-mark does not
function as a toggle).
Note that changes to the area-selection after processing has started have no effect until processing is stopped
(either forcibly via "Abort", or by finishing the processing cycles that were configured via "Hydro Timers" –
see II-22.2.4, II-22.3.7 and III-17.3.2). Note the implication in case of "endless" processing.
Within the selected area, a rectangular grid of points will be constructed, according to the parameters set on
the tab "Wave Module" in the "Hydro "configuration dialog window (III-17.3.1).
Note that areas are relative to the bearing line, i.e., the heading. If the heading changes, the area will rotate
with the bearing line.
Rectangle Area
Select a rectangle as the area for which to calculate the hydrography results.
After selecting this option, an outline of the area currently selected will show as an overlay on the SeaDarQ
radar image. Two small yellow dots are part of the outline, and function as control points for the area shape.
(If no area shape was selected previously in this session, either the full area of the radar will be selected, or
two overlapping control points will show. If some area has been selected earlier, the control points of the
previous area selection will be used as the starting points for the current selection -- even if the previous area
selection was a different shape.)
For a rectangle, the control points determine two opposing corners of the rectangle.
Of the five options "No Area", "Full Area", "Circle Area", "Pie Area", and "Rectangle Area", only a single
one can be active. If a particular option has been selected, a tick-mark will be placed in front of it in the
menu. Selecting the same option again will not result in any change (in this case, the tick-mark does not
function as a toggle).
Note that changes to the area-selection after processing has started have no effect until processing is stopped
(either forcibly via "Abort", or by finishing the processing cycles that were configured via "Hydro Timers" –
see II-22.2.4, II-22.3.7 and III-17.3.2). Note the implication in case of "endless" processing.
Within the selected area, a rectangular grid of points will be constructed, according to the parameters set on
the tab "Wave Module" in the "Hydro "configuration dialog window (III-17.3.1).
Note that areas are relative to the bearing line, i.e., the heading. If the heading changes, the area will rotate
with the bearing line.
Buoy Settings...
This menu item leads to the buoy settings dialog window (see section III-19).
Add Buoy
Add a virtual wave buoy. The new virtual wave buoy will be added in the center of the radar image, where
the radar is. A yellow dot indicates its position. You can click and drag it to the location you want. (If
necessary, remember that the status bar will show you the geographic location of the location of the mouse
pointer, as well as the distance and bearing of the location of the mouse pointer with respect to the radar
location.)
For more details on how and why (what for) to use virtual wave buoys, see sub-sections II-22.2.3 and II-
22.3.4.
Save Buoys
Saves the information about the currently defined virtual wave buoys to a file (*.buo)
This option is greyed out if no virtual wave buoys have been defined.
Remove Wave Buoys
Remove all previously defined virtual wave buoys.
This option is greyed out if no virtual wave buoys have been defined.
Lock Grid
Enabling this option fixes the geographic position of the current grid-points. Even when initially defined in
relation to the position of a ship carrying the radar, after "Lock Grid" the grid points stay where they are, also
when the ship moves. As a side effect, the outline of the selected area is no longer shown, but instead the
grid-points themselves are shown.
Disabling this option does not fix the geographic position of the grid-points until the actual calculations take
place. This means that as the ship moves, the grid-points move with it (in between calculations).
This menu option functions as a toggle: selecting it switches the option to its opposite value. If "Lock Grid"
is enabled, this will be indicated by the presence of a tick-mark in front of it. If the option is disabled, there
will be no tick-mark in front of it.
Create Depth Map
Switches on the mode where a depth map can be created. (Switching off this mode has to be done from the
tab "Wave Module" in the "Hydro" configuration dialog window (see section III-17.3.1).
14.3 Right-click dialog window
Right-click on the "Hydro" menu to access the multi-tabbed Hydrography Configuration dialog window. For
details on the Hydrography Configuration dialog window, see the section III-17.
V File-formats Hydrography
1 INTRODUCTION
This section describes the formats of various files that are used (or can be used) with the hydrography module.
Most of the file formats are plain text, and self-documenting, in the sense that they include a description of their
contents.
The file descriptions in the following sections have a standardized set-up, as follows:
File type
Mentions the names that are used in this manual for this kind of file.
Default extension
Mentions the filename-extension that is used for this kind of file.
Accessing this type of file
This subsection describes how this kind of file can be accessed (opened and saved) from within the SeaDarQ
software. Where applicable, the section describes how to create a file of this type, either from within or
outside of SeaDarQ.
Create/save
This subsection describes how to create and save this kind of file from within SeaDarQ (via what menu or
dialog-window, under what option).
Load
This subsection describes how to load this kind of file from within SeaDarQ (via what menu or dialog-
window, under what option).
File contents and use
This subsection contains a description of the kind of information that this type of file contains, and an
indication of how to use the information in this type of file.
Detailed format description
This subsection contains a description of the file format, to the extent necessary to understand it in
combination with the sample file fragment in the next section.
Example
Fragments of a sample file; the fragments include:
the start of the file (which generally speaking describes the rest of the file),
a (possibly abridged) data segment (containing at least a handful of sample data lines),
and the end of the file.
Where lines from the file are too long to fit onto the page, they are broken up over multiple lines on the page.
This is indicated with the symbols “\\” at the end of the line. The remainder of the line may be lined up in a
way to reduce clutter on the page.
2 WAVE REPORT
2.1 File type
Wave report
2.2 Default extension
*.log
2.3 Accessing this type of file
Create/save
Wave report files can be generated as part of the wave processing. It is important to enable this option before
starting the actual wave processing; this option may not take effect when enabled after wave processing has
started.
When this option is enabled, a wave report file will be generated automatically at the end of processing the entire
field, and before starting the next processing step (if multiple runs have been specified). If generation of a wave
report file was not enabled for a wave-processing run, it is not possible to save the results after the fact.
Enabling the generation of wave report files is done via the Hydro configuration dialog window, on the tab
"Wave Report". Enable generation of the wave reports by putting a tick-mark in the check-box "Generate
report", enable automatic generation of file names if you want to create multiple wave reports (in case you
enabled multiple wave processing runs on the tab "Hydro Timers"), and specify a hard-disk location for storage
of the files. For details, see the descriptions in section III-17.3.5 Tab "Wave Report".
Load
To inspect or visualize the results that were saved to a wave report file, you can load a wave report file via the
menu option "Load from File" in the menu "Hydro Info". Note that the data in the wave report file contains the
original geolocation of every grid point, so if you load a wave report file that contains data for another location
than the current radar position, the results may be displayed "off-screen".
What details are visible on-screen depends on what layers are selected as "visible" (see section II-22.1).
2.4 File contents and use
A wave report file contains all of the end results of the hydrography calculations for all grid points that were
defined, and, if applicable, all virtual wave buoys for which the option "Exclude from wave report" was not
checked. These end-results are the current (in magnitude and direction), the wavelength and -direction (of the
dominant waves), the calculated depth, and the wave height. These values can be visualized in the same ways as
direct calculation results can be visualized (see section II-22.1), i.e., as an overlay on the radar image, and as
numerical values if the cursor is hovered over one of the grid-points.
As the data in a wave report file is written as plain text, and includes both certain overall information in some 11
header lines, and descriptive comments and a column header line, it is not difficult to read the results into other
programs for further processing and/or visualization. One option that is often used for post-processing is
MatLab, but other programs can also be used.
2.5 Detailed format description
The wave report files are plain text.
Every wave report file contains a description of the headers that are used in the data section, a section with
general data (creation date, cell size, radar rotation time, amongst others), followed by a data section.
The data section starts with a line of headers, followed by a separate line for each grid point.
Each data line contains the location of the grid-point, date and time for the measurement, a status-word, and the
actual calculated data (depth, current magnitude, current angle, wavelength, wave period, wave angle, wave
height, and sigma.
Note that the wave height in general requires additional information and calibration before it contains
meaningful information.
2.6 Example
Data = {
#Lat Lon Date Time Status Depth Current CAngle \\
WaveLgth Period WAngle WaveHght Sigma
51°54.503 N 003°57.886 E 2007-09-18 13:40:43 0000000e 16.23 0.000 0.000 \\
76.3 9.0 335.8 0.6 0.0
51°54.501 N 003°58.147 E 2007-09-18 13:40:43 0000000f 100.00 5.353 144.289 \\
78.6 4.9 154.8 0.4 0.0
52°01.337 N 004°02.941 E 2007-09-18 13:40:43 0000000f 12.98 0.434 71.909 \\
94.8 9.5 342.5 0.4 0.1
Load
A previously saved wave buoy file can be loaded via the option "Use wave buoy file" on the "Wave Module" tab
of the "Hydro" settings dialog window (which can be accessed by right-clicking the "Hydro" menu). This
recreates wave buoys in all locations specified in the wave buoy file. For those wave buoys in the file that had an
identifier string assigned, the identifying string will be loaded and assigned again as well.
3.4 File contents and use
A wave buoy file can be used to save the details, in particular the locations, of the virtual wave buoys that were
added. This can be used to recreate the virtual wave buoys in the same locations in a new session.
The location of each wave buoy can also be used to cross-reference the wave-buoy data points in a Wave Report
file.
If individual wave buoys were assigned an identifier string, this will also be stored in the wave buoy file.
3.5 Detailed format description
Wave buoy files are stored in plain text. A wave buoy file starts with a small descriptive section. Following this
descriptive section is a data section, containing one line per wave buoy.
Each wave buoy line starts with a word indicating if the position is absolute (i.e., a geo-location), or relative to
the ship's position. Following this position type indicator are the latitude and longitude of the buoy (to be
interpreted according to the position type), an 8-digit number, and the wave buoy label if one was assigned.
Note that if the position is relative to the ship's position, the position is specified in meters.
If the position is absolute, the position is specified in meters UTM. Preceding the Easting and Northing
coordinates (in meters) is the UTM zone number. (Note that elsewhere, the UTM zone number is followed by a
letter to indicate the latitude band. This practice is not part of the UTM coordinate system, but belongs to the
closely related MRGS, the Military Grid Reference System.)
The 8-digit number is a set of flags that indicate any special properties of the wave buoy. Currently only a very
small set of flags is used; see table 14 for a list.
Table 14: Flags in the Wave Buoy File
flag meaning
0000 0000 position is absolute
0000 0001 position is relative to radar location
0000 0020 location (position) is locked
3.6 Example
4 DEPTH MAP
4.1 File type
depth map, depth file
4.2 Default extension
*.dpt
4.3 Accessing this type of file
Create/save
To create a depth map file, enable this option by use of the menu-option "Create depth Map" in the menu
"Hydro". Note that ticking the box "Use depth map" on the tab "Wave Module" in the Hydro configuration
dialog window, does not actually enable this mode.
Once enabled, double-click on the area in the radar-image that you want to assign a depth to. A dialog box
"Depth Map" (see figure 181 in section III-21) allows entry of the value (in meters). After clicking "Apply" and
"OK", a semi-transparent overlay colour will indicate the assigned depth in the cell.
Once all cells have been assigned a value, right-click anywhere on the image to access the depth map right-click
menu (see section IV-16). The first menu option allows saving of the file.
Load
A previously created depth map file can be loaded for use via the tab "Wave Module" in the Hydro configuration
dialog window. Tick the box "Use depth map", and use the button on the right of the file-name box underneath
the tick-box, in order to select the depth map file to use.
4.4 File contents and use
A depth map file contains an assigned depth for the cells that the image was divided into for this purpose. In
exceptional cases, pre-assigning a depth in this way, instead of having SeaDarQ calculate it itself, can improve
the convergence of the calculations. Proper and meaningful use of this option is subject to a deep understanding
of the inner workings of SeaDarQ, and should not be attempted in the absence of such deep understanding.
4.5 Detailed format description
A depth map file is saved in plain text format.
A depth map file starts with a descriptive section, containing (amongst others) the location (i.e., the location of
the centre of the image, the location of the radar), and the number of cells in X and Y and their size.
Following this descriptive section is the data section, containing as many rows and columns as there are cells in
X and Y. For each cell, the file specifies the depth that was assigned to that cell.
4.6 Example
0.0 0.0
0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
20.0 20.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
20.0 15.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 10.0 10.0 0.0 0.0 0.0\\
0.0 0.0
0.0 12.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 10.0 15.0 15.0 0.0 0.0\\
0.0 0.0
50.0 40.0 30.0 20.0 30.0 20.0 10.0 5.0 2.0 5.0 10.0 0.0 0.0 0.0\\
0.0 0.0
0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0\\
0.0 0.0
}
# End of File
Load
You cannot load a depth contour into SeaDarQ. The saving of depth contours is intended to export them from
SeaDarQ, and make them available for external visualisation, processing, or other use.
5.4 File contents and use
In a depth contour file, you can save all the depth contours that resulted from the SeaDarQ hydrography
calculations. For each contour value, the file contains the (geographic) location of the points that make up the
contour (or contours). Different contour lines are separated by a line containing "9999 9999 9999".
The contour values are based on the results from SeaDarQ's calculations. For details, see section II-22.3.8.
How depth contour files can be used is up to the user. They could be useful to get an impression of the (shallow
water) bathymetry in the area covered by the radar. Note that the format is a standard hydrographic data format
that should be readable by suitable external software.
5.5 Detailed format description
The file format for depth contours is a standard format used in hydrography elsewhere, and is known as the S-57
(ENC) / AML format.
It is in plain text; per line, it contains three values: the latitude and longitude of the point, and the depth value of
the contour line this point is a part of. The file contains multiple lines per depth-value (that is, multiple points to
construct the contour line from).
The end of a contour line is indicated by a lines containing the values "9999 9999 9999".
Positive latitude/longitude values indicate N/W; negative latitude/longitude values indicate S/E.
5.6 Example
6 EXCLUSION FILE
6.1 File type
exclusion file
6.2 Default extension
*.tif
6.3 Accessing this type of file
Create/save
An exclusion file cannot be created inside SeaDarQ directly, but the start-off image often can be. E.g., when you
want to do wave processing with a landmass in the radar image, it is possible to take a Geo Snap Shot of the
radar image with the landmass visible in it (possibly through use of the coastline database). The TIFF image
generated this way is geo-encoded. Careful manipulation in some external image-processing software can
transform this GeoTIFF image into one that has black for the landmass or other areas where wave-processing
should be inhibited (RGB value = 0,0,0) and white for the areas where wave-processing should happen normally
(RGB value = 255,255,255). A program such as GeoTIFF Tools can be used before and after the image
manipulation to verify that the geo-location part of the file is still accurate.
Load
Once a GeoTIFF file has been prepared to indicate where in the image wave processing should be inhibited, use
the option "Use exclusion file" on the tab "Wave Module" in the "Hydro" settings dialog window. This window
can be accessed by right-clicking the menu "Hydro".
6.4 File contents and use
An exclusion file is essentially a geo-referenced bit-image, indicating certain areas where wave processing
should not take place. Instead of an actual bit-image, the file uses the GeoTIFF format, but should only use the
values 0,0,0 (black) and 255,255,255 (white). The black areas indicate where processing should not take place.
This type of area-exclusion can be used in cases where the area where processing should take place cannot easily
be delineated using the standard area demarcation tools (circle, pie, rectangle).
Note that the area excluded this way using a GeoTIFF image is fixed in location. This means it is only suitable to
exclude areas that are fixed in location, e.g., land, islands, and/or fixed platforms. It is not suited to exclude areas
that move along with a moving ship, be that radar shadows or towed objects.
6.5 Detailed format description
An exclusion file is (or needs to be) in GeoTIFF format, that is, a TIFF file with geo-coordinate information
embedded.
For use as a SeaDarQ exclusion file, it needs to be "binary", as in two-valued:
black: value = 0,0,0
description: inhibit processing
white: value = 255,255,255
description: allow processing
6.6 Example
There is no textual sample, as this is a binary file format. The paragraphs just above describe how to create one.
The next three images (figure 199 (a), (b), and (c)) show an illustration of the use of these exclusion files. The
first image (a) shows a screenshot of a radar recording at the Dutch island Ameland. The second image (b)
shows a TIFF exclusion file for that area (based on the coastline database for that area). The third image (c)
shows an overlay of (another) radar image and the exclusion file.
Figure 199: Illustration of the use of an exclusion file: (a): The Dutch island Ameland; (b): the exclusion map;
(c): overlay of the exclusion map and a radar image
Detailed Contents
Contents .................................................................................................................................................................. 3
I Introduction ............................................................................................................................................... 5
1 Overview ................................................................................................................................................... 5
2 Purpose...................................................................................................................................................... 5
3 Assumptions and scope ............................................................................................................................. 5
4 Main sections ............................................................................................................................................ 5
II Background Topics and Concepts ............................................................................................................. 7
1 Overview ................................................................................................................................................... 7
2 Modes of operation ................................................................................................................................... 7
2.1 Oil Spill Detection ................................................................................................................................................... 7
2.2 Hydrography (Wave Processing) ............................................................................................................................. 7
3 Basic Principles ......................................................................................................................................... 8
3.1 Introduction ............................................................................................................................................................. 8
3.1.1 Overview ..................................................................................................................................................... 8
3.1.2 Purpose........................................................................................................................................................ 8
3.1.3 Assumptions / scope.................................................................................................................................... 8
3.2 Description .............................................................................................................................................................. 8
3.2.1 Radar reflection off the sea surface ............................................................................................................. 8
3.2.2 Oil spill detection ........................................................................................................................................ 8
3.2.3 Detection range ........................................................................................................................................... 9
4 SeaDarQ software configuration settings ................................................................................................ 11
4.1 Overview ............................................................................................................................................................... 11
4.2 General configuration ............................................................................................................................................ 11
4.2.1 Radar Configuration .................................................................................................................................. 11
4.2.2 Image Configuration ................................................................................................................................. 12
4.2.3 Settings for Operational Use ..................................................................................................................... 12
4.3 Advanced options .................................................................................................................................................. 13
4.4 Save configuration ................................................................................................................................................. 13
5 Starting the system .................................................................................................................................. 14
6 User Interface Elements .......................................................................................................................... 15
6.1 Introduction ........................................................................................................................................................... 15
6.1.1 Overview ................................................................................................................................................... 15
6.1.2 Purpose...................................................................................................................................................... 15
6.1.3 Assumptions and scope ............................................................................................................................. 15
6.2 SeaDarQ main screen ............................................................................................................................................ 15
6.3 Radar image ........................................................................................................................................................... 16
6.4 Button bar / toolbar ................................................................................................................................................ 18
6.5 Status bar ............................................................................................................................................................... 18
6.6 Menu bar ............................................................................................................................................................... 19
6.7 Layers .................................................................................................................................................................... 19
6.8 Settings .................................................................................................................................................................. 20
6.9 Navigation ............................................................................................................................................................. 22
6.10 Meteo ..................................................................................................................................................................... 22
6.11 Oil spills detected .................................................................................................................................................. 23
6.12 Status ..................................................................................................................................................................... 24
7 Alarms and alarm stages ......................................................................................................................... 25
7.1 Description ............................................................................................................................................................ 25
7.2 Purpose .................................................................................................................................................................. 25
7.3 Enabling alarms in SeaDarQ ................................................................................................................................. 25
7.4 Use......................................................................................................................................................................... 26
7.4.1 Reaction to an alarm / possible follow-up actions ..................................................................................... 26
7.4.2 reported properties .................................................................................................................................... 26
8 A note about examples ............................................................................................................................ 27
9 Background correction / Range correction.............................................................................................. 28
9.1 Description ............................................................................................................................................................ 28
9.2 Purpose .................................................................................................................................................................. 28
9.3 Range correction in SeaDarQ ................................................................................................................................ 28
9.4 Use......................................................................................................................................................................... 29
9.5 Practical examples ................................................................................................................................................. 29
List of figures
Figure 58: Radar shadow from structures on the ship (false alarm) .................................................................... 36
Figure 59: Radar shadow from structures on the ship (false alarm, detail) .......................................................... 36
Figure 60: Radar shadow from structures on the ship countered by blocked areas (radar image) ...................... 37
Figure 61: Radar shadow from structures on the ship countered by blocked areas (enhanced image, no
false alarms) ....................................................................................................................................... 37
Figure 62: Radar shadow behind nearby ships (radar image) .............................................................................. 38
Figure 63: Radar shadow behind a nearby ship (radar image, detail) .................................................................. 38
Figure 64: Radar shadow behind nearby ships (enhanced image) ....................................................................... 38
Figure 65: Radar shadow behind a nearby ship (enhanced image, detail) ........................................................... 38
Figure 66: Radar shadow behind nearby ships (confidence/quality map) ........................................................... 38
Figure 67: Radar shadow behind a nearby ship (confidence/quality map, detail) ............................................... 38
Figure 68: Radar shadow behind nearby ships (enhanced image with false alarm)............................................. 39
Figure 69: Radar shadow behind a nearby ship (enhanced image with false alarm, detail) ................................ 39
Figure 70: The shadow detector blocks off the radar shadow behind nearby ships (radar image) ...................... 39
Figure 71: The shadow detector blocks off the radar shadow behind nearby ships (radar image, detail) ............ 39
Figure 72: Because the shadow detector blocks off radar shadow behind nearby ships, they do not cause
false alarms (enhanced image) ........................................................................................................... 40
Figure 73: Because the shadow detector blocks off radar shadow behind nearby ships, they do not cause
false alarms (enhanced image, detail)................................................................................................. 40
Figure 74: Effect of the shadow detector on the confidence/quality map (dark blue areas) ................................ 40
Figure 75: Effect of the shadow detector on the confidence/quality map (dark blue area, detail) ....................... 40
Figure 76: Nearby islands cause radar shadows behind them (overall enhanced image, and detailed views) ..... 41
Figure 77: Radar shadows behind nearby islands cause false alarms (enhanced image, overall and detail) ....... 41
Figure 78: Effect of coast-line database with land-extension feature on the radar image ................................... 42
Figure 79: Effect of both the coast-line database with land-extension feature and the shadow detector on
the radar image ................................................................................................................................... 42
Figure 80: Coastline database with land-extension feature combined with shadow detector avert false
alarms caused by radar shadows (radar image, enhanced image with alarms, enhanced image
detail).................................................................................................................................................. 42
Figure 81: Enhanced image and enhanced image with alarms: the alarm in the centre of these images
correctly identifies an oil spill; the two smaller alarms are false alarms (see text for details) ........... 42
Figure 82: Crests and troughs of ocean waves show up on the raw radar image (WNW and ESE parts of
the image) ........................................................................................................................................... 43
Figure 83: Crests and troughs of ocean waves are averaged out in the enhanced image; range correction
makes the intensity in the image uniform ........................................................................................... 43
Figure 84: Wind shadow in the lee of the coast (radar image; NNE part of the image, wind from ENE) ........... 44
Figure 85: Wind shadow in the lee of the coast (radar image, detail) .................................................................. 44
Figure 86: Wind shadow in the lee of the coast (enhanced image) ...................................................................... 44
Figure 87: Wind shadow in the lee of the coast (enhanced image, detail) ........................................................... 44
Figure 88: Wind shadow in the lee of the coast (confidence/quality map) .......................................................... 44
Figure 89: Wind shadow in the lee of the coast (confidence/quality map, detail). The high-confidence
areas (red, yellow) could lead to false alarms..................................................................................... 44
Figure 90: Wake behind the ship vaguely visible (opposite the blue heading line; radar image) ........................ 45
Figure 91: Wake behind the ship vaguely visible (radar image, detail) ............................................................... 45
Figure 92: Wake behind the ship vaguely visible (opposite the blue heading line; enhanced image) ................. 45
Figure 93: Wake behind the ship vaguely visible: the somewhat blocky dark- and light-grey stripe
(enhanced image, detail) ..................................................................................................................... 45
Figure 94: Wake behind the ship (confidence/quality map) ................................................................................ 46
Figure 95: Wake behind the ship (confidence/quality map, detail) ..................................................................... 46
Figure 96: Rain visible in the raw radar image (detail) ....................................................................................... 46
Figure 97: Rain visible in the enhanced image (detail; bright areas) ................................................................... 46
Figure 98: Rain visible in the confidence/quality map (detail; blue areas) .......................................................... 46
Figure 99: Radar shadows and blanked area at an oil-rig .................................................................................... 47
Figure 100: Radar shadows from structures on a ship ........................................................................................... 47
Figure 101: Configuration settings dialog window, blocked areas tab (allow edit box not ticked) ....................... 48
Figure 102: Configuration settings dialog window, blocked areas tab (allow edit box ticked) ............................. 48
Figure 103: Structures on the ship cause radar shadows (radar image) ................................................................. 50
Figure 104: Structures on the ship cause radar shadows (radar image, detail) ....................................................... 50
Figure 105: Radar shadows caused by structures on the ship itself cause false alarms (enhanced image) ............ 50
Figure 106: Radar shadows caused by structures on the ship itself cause false alarms (enhanced image,
detail).................................................................................................................................................. 50
Figure 107: Blocked areas constructed to prevent radar shadows from structures on the ship from causing
false alarms (radar image) .................................................................................................................. 51
Figure 108: Blocked areas constructed to prevent radar shadows from structures on the ship from causing
false alarms (radar image, detail) ....................................................................................................... 51
Figure 109: Radar shadows behind nearby ships (radar image) ............................................................................. 52
Figure 110: Radar shadows behind nearby ships dynamically blocked off by the shadow detector (radar
image) ................................................................................................................................................. 52
Figure 111: False alarms caused by radar shadows behind nearby ships (enhanced image) ................................. 53
Figure 112: Shadow detector prevents false alarms from radar shadows behind nearby ships (enhanced
image) ................................................................................................................................................. 53
Figure 113: High values (yellow, red) in the confidence/quality map caused by radar shadows behind
nearby ships ........................................................................................................................................ 53
Figure 114: Shadow detector suppresses high values in the confidence/quality map caused by radar
shadows behind nearby ships ............................................................................................................. 53
Figure 115: Radar shadows behind nearby ships (radar image, detail) .................................................................. 53
Figure 116: Radar shadows behind nearby ships dynamically blocked off by the shadow detector (radar
image, detail) ...................................................................................................................................... 53
Figure 117: False alarms caused by radar shadows behind nearby ships (enhanced image, detail) ....................... 54
Figure 118: Shadow detector prevents false alarms from radar shadows behind nearby ships (enhanced
image, detail) ...................................................................................................................................... 54
Figure 119: High values (yellow, red) in the confidence/quality map caused by radar shadows behind
nearby ships (detail) ........................................................................................................................... 54
Figure 120: Shadow detector suppresses high values in the confidence/quality map caused by radar
shadows behind nearby ships (detail) ................................................................................................. 54
Figure 121: AIS layer hidden ................................................................................................................................. 56
Figure 122: AIS labels and tracks both enabled ..................................................................................................... 56
Figure 123: AIS layer visible, both labels and tracks not enabled ......................................................................... 57
Figure 124: AIS tracks enabled, labels disabled, but the label shows highlighted in red when the mouse
hovers over a (stationary) ship ........................................................................................................... 57
Figure 125: AIS tracks enabled, labels not enabled ............................................................................................... 57
Figure 126: AIS tracks enabled, labels disabled, but label and track show (highlighted in red) when the
mouse hovers over a (moving) ship .................................................................................................... 57
Figure 127: The Layers panel, including extra layers for hydrography ................................................................. 65
Figure 128: Grid points within the radar range ...................................................................................................... 69
Figure 129: The calculation grid: cubic size and cubic depth ................................................................................ 69
Figure 130: The results grid points and their individual calculation grids ............................................................. 70
Figure 131: Altering parameters influences the minimum and maximum dimensions in ω-k space, and may
add empty space ................................................................................................................................. 70
Figure 132: Short and long waves over the shallow and deep parts of a gully ..................................................... 72
Figure 133: The dispersion relations are different over the shallow and deep parts of a gully .............................. 72
Figure 134: The grid cells for a depth map ............................................................................................................ 73
Figure 135: The "Limit Edge" value may help to reduce the jaggedness of contour lines ..................................... 75
Figure 136: Layers dialog window ........................................................................................................................ 77
Figure 137: Recording dialog window, tab "Recording" ....................................................................................... 80
Figure 138: Recording dialog window, tab "Conditions" ...................................................................................... 82
Figure 139: Image alignment dialog window ........................................................................................................ 83
Figure 140: Polygon Settings dialog window, tab "Polygon Settings" .................................................................. 84
Figure 141: Snapshot Settings dialog window ....................................................................................................... 85
Figure 142: Alarm Settings dialog window, tab "Alarms Settings" ....................................................................... 87
Figure 143: GeoTIFF Snapshot Settings dialog window ....................................................................................... 88
Figure 144: Radar Settings dialog window (generic radar) .................................................................................... 90
Figure 145: Radar Settings dialog window (Sperry BridgeMaster E radar, controlled by SeaDarQ) .................... 91
Figure 146: The NMEA Log Window ................................................................................................................... 94
Figure 147: The NMEA log window's View menu ............................................................................................... 95
Figure 148: The NMEA log window's Ports menu ................................................................................................ 95
Figure 149: The Statistics window ........................................................................................................................ 96
Figure 150: Font Selection dialog window (or tab) ............................................................................................... 97
Figure 151: Line Window, Advanced Options NOT enabled ................................................................................ 98
Figure 152: Demarcation lines (with yellow dots) determining the radar lines that are used in the Line
Window (detail) .................................................................................................................................. 99
Figure 153: Histogram overlay can be repositioned by dragging the green arrow left or right ............................. 99
Figure 154: "Range Correction Curve" menu appears by enabling Advanced Options ....................................... 100
Figure 155: Menu items and sub-menu in the "Range Correction Curve" menu ................................................. 100
Figure 156: Histogram Window, Advanced Options NOT enabled .................................................................... 103
Figure 157: Menus in the Histogram Window with "Advanced Options" enabled .............................................. 104
Figure 158: Menu items and sub-menu in the “Enhanced Color Curve” menu ................................................... 104
Figure 159: Configuration Settings dialog window, tab "General" ...................................................................... 107
Figure 160: Configuration Settings dialog window, tab "Processing Parameters" .............................................. 108
Figure 161: Configuration Settings dialog window, tab "Blocked Areas" ........................................................... 110
Figure 162: Configuration Settings dialog window, tab "Coast Line Server"...................................................... 111
Figure 163: Configuration Settings dialog window, tab "CoastLine Settings" .................................................... 112
Figure 164: Configuration Settings dialog window, tab "Shadow Detector" ....................................................... 113
Figure 165: Configuration Settings dialog window, tab "Alarms Settings" ........................................................ 114
Figure 166: Configuration Settings dialog window, tab "Radar Configuration" ................................................. 115
Figure 167: Configuration Settings dialog window, tab "Detection Settings" ..................................................... 117
Figure 168: Configuration Settings dialog window, tab "NMEA Serial Ports" ................................................... 118
Figure 169: File Settings dialog window ............................................................................................................. 120
Figure 170: Hydro configuration dialog window, tab "Wave Module" ............................................................... 122
Figure 171: Hydro configuration dialog window, tab "Hydro Timers" ............................................................... 125
Figure 172: Hydro configuration dialog window, tab "Hydro Settings" .............................................................. 126
Figure 173: Hydro configuration dialog window, tab "Depth Contour Settings" ................................................ 128
Figure 174: Hydro configuration dialog window, tab "Wave Report" ................................................................. 129
Figure 175: Hydro configuration dialog window, tab "Font" .............................................................................. 131
Figure 176: Hydro Info configuration dialog window, tab "Hydro Settings" ...................................................... 132
Figure 177: Hydro Info configuration dialog window, tab "Depth Contour Settings" ......................................... 133
Figure 178: Hydro Info configuration dialog window, tab "Font" ....................................................................... 134
Figure 179: Wave Buoy Settings dialog window ................................................................................................. 135
Figure 180: Individual (right-click) Wave Buoy Settings dialog window ........................................................... 136
Figure 181: Depth Map cell depth assignation dialog window ............................................................................ 137
Figure 182: The SeaDarQ main menu.................................................................................................................. 138
Figure 183: Configuration menu .......................................................................................................................... 139
Figure 184: View menu........................................................................................................................................ 141
Figure 185: Screen menu ..................................................................................................................................... 143
Figure 186: Diagnostics menu ............................................................................................................................. 144
Figure 187: Recording menu ................................................................................................................................ 145
Figure 188: Image menu ...................................................................................................................................... 146
Figure 189: Polygon menu ................................................................................................................................... 147
Figure 190: AIS menu .......................................................................................................................................... 148
Figure 191: Snapshot menu .................................................................................................................................. 149
Figure 192: Oil Spill Tracker menu ..................................................................................................................... 150
Figure 193: Geo Snapshot menu .......................................................................................................................... 151
Figure 194: File menu .......................................................................................................................................... 152
Figure 195: Hydro menu ...................................................................................................................................... 153
Figure 196: Hydro Info menu .............................................................................................................................. 156
Figure 197: Depth map right-click menu ............................................................................................................. 157
Figure 198: Wave buoy right-click menu ............................................................................................................ 158
Figure 199: Illustration of the use of an exclusion file: (a): The Dutch island Ameland; (b): the exclusion
map; (c): overlay of the exclusion map and a radar image ............................................................... 168
List of tables
Table 1: Most important parameters and values used in the CARPET calculations......................................... 10
Table 2: Details of the toolbar buttons ............................................................................................................. 18
Table 3: Details that are shown in the status bar .............................................................................................. 19
Table 4: Description of the standard layers in "Oil Spill from Radar" mode ................................................... 20
Table 5: Description of the different settings in the Settings panel .................................................................. 21
Table 6: Parameters reported for (suspected) oil spills ..................................................................................... 23
Table 7: Details for the status panel ................................................................................................................. 24
Table 8: How to accomplish various editing operations on blocked areas ....................................................... 48
Table 9: Properties of blocked areas on the tab "Blocked Areas" in the Configuration Settings dialog .......... 49
Table 10: Overview of dialog boxes and windows in the SeaDarQ software .................................................... 76
Table 11: List of layers and their use.................................................................................................................. 78
Table 12: Options for each layer, as available in the layers dialog window ....................................................... 79
Table 13: List of menus in the SeaDarQ software ............................................................................................ 138
Table 14: Flags in the Wave Buoy File ............................................................................................................ 162