Manual_AIS_KRONSBERG
Manual_AIS_KRONSBERG
1 of 59
Track Server User Guide
Table of contents
1 INTRODUCTION............................................................................................. 5
1.1 Architecture.........................................................................................................5
1.2 Port database .......................................................................................................7
3 EDIT FILTERS............................................................................................... 10
3.1 Make a filter ......................................................................................................11
3.2 Filter operators ..................................................................................................11
3.3 Filter attributes ..................................................................................................12
3.4 Computed attributes .......................................................................................... 16
3.5 Valid checks ......................................................................................................17
3.6 Port filters..........................................................................................................18
3.7 Geometry filters ................................................................................................ 18
3.8 Distance to closest vessel or AtoN....................................................................20
3.9 Weather attributes ............................................................................................. 21
3.10 Special attributes ............................................................................................... 22
3.11 Examples ...........................................................................................................22
2 of 59
Track Server User Guide
6 LIST .................................................................................................................42
7 VESSEL DETAILS......................................................................................... 43
8 EXPORT ..........................................................................................................45
11 ADMINISTRATION ...................................................................................... 58
3 of 59
Track Server User Guide
1 INTRODUCTION
The Track Server is a Web based system with map and table display of vessel track
data. The main functionality of the system is to provide simple access to “near” real
time and historical tracking data for vessels either through a list or a map view.
The Track Server includes a variety of functionalities, e.g.
User defined layers/filters and areas (“bookmarks”)
Search vessel using name, call-sign, IMO number etc.
Target tracking with CPA (Closest Point of Approach) calculations
Integrated database with historical data
Integrated port database
“Smart links” to other web applications
Export data
Track layers may be integrated into other GIS systems using Web Map Services
This User Guide is based on the online help pages which are delivered as part of the
web application. The online help pages are composed to suit the generic Track display
application, and may differ from this document on a number of instances.
This document will describe the main functionality of the system based on the most
important functionality provided by the top level menu (which is available in all the
major operation modes of the application).
The start page (menu page) of the application is described in chapter 2. Chapter 3
presents the basic building blocks necessary for the application to display and select
information by use of filters. The map functionality is covered in chapters 4 and 5, and
the “List” view of the filtered data in chapter 6. How to display detailed vessel
information is described in chapter 7. Functionality for data export is dealt with in
chapter 8. Finally, the Alert Module (chapter 9), Traffic analysis (chapter 10) and
Administration help (chapter 11) are described.
1.1 Architecture
The Track Server may receive vessel track data from many sources of different kind.
Mostly it uses AIS data as input (IEC format), but it also supports data from Satellite
tracking of fishing vessel (NAF format) and other formats. When it comes to AIS data,
the server supports the following AIS messages:
Position report
Extended position report
5 of 59
Track Server User Guide
SAR aircraft
Base station
Static voyage (class A and class B)
Aids to Navigation
Person On Board
VTS target
MetHyd (wind, current, waves etc.)
The server also supports the “comment block” (with time stamp) for AIS messages so
that non real-time data can be processed by the system.
source 1
Mobile Google
Web browser
application Earth
source 2
source n
Track Web Map Web
data Server Server
Alert
RSS KML
Module
Module
SMS
Historical
Data Track server
Figure 1.1 Architecture
The data from the different sources (usually of the same type) is collected by different
“connectors” and then merged into a common track table. This table is kept in memory
and at regular intervals a snapshot of the track table is saved. From this collection of
historical snapshots one can go back in time and look at the situation at a given time.
The Track Server serves it clients as web application. Each user has an account with its
own data (filters, areas etc.) and must login in with a user id and password. Which data
a user can see, is controlled by a user filter which might be empty.
The Track Server is also a WMS (Web Map Service) server. The WMS servers supplies
the web application with map layers with track data, but the WMS layers can also be
used by other GIS applications.
6 of 59
Track Server User Guide
The port database is also used to “decode” destination and record which port a vessel
stays at and departs from.
7 of 59
Track Server User Guide
All Track data are accessible through filters. A filter defines which of the vessels you
want to handle through definition of one or more filter constraints. If a vessel satisfies
all constraints in a filter (or at least one depending on the setting), it is accepted and can
be handled further.
From this page you can "create filter", and "edit" or "delete" existing filters. You can
also "list" all vessels for a filter; look at them on a "map" or "export" data from a filter.
If you want to look at track data over a time period, you can choose "tails" or “density
plot”. “Statistics” will display table statistics for this filter. Apart from accessing data
through filters, you can access all vessels through the "list all" or "map all" buttons.
From this page you can also reach the “Administrator” page, which is visible if the user
has an admin role. The "support" page gives access to an email-address to send
messages to support.
2.1 Search
It is possible from this page to search directly for vessels. One can search either by:
Name
IMO Number
Call sign
8 of 59
Track Server User Guide
MMSI number
Destination
Country
To Port Name
In Port Name
From Port Name
For "Name", "Call sign", "Destination", "Country" and the port filters, wildcards ("*")
can be used to "broaden" the search. Wildcards can be placed either in front and/or
behind the search string, e.g. "fjord*", "*knutsen". Search strings are case insensitive.
9 of 59
Track Server User Guide
3 EDIT FILTERS
When selecting “Edit Mode Menu” on the Start (Menu) Page, the list of filters will
change to display extended filter options.
By clicking on “Edit Filter” the page which enables the user to edit the selected filter
will be displayed.
With a filter you can choose which vessels to display. By using a filter when looking at
vessels (either on the map or as a list) or exporting vessel data, only the vessels that
either satisfy all the filter constraints (AND) or one of the filter constraints (OR) of the
filter will be visible.
10 of 59
Track Server User Guide
When you have added or edited a filter, you can go directly to view the result as a list or
on a map, or export the data to another application (the filter must be saved first with a
name). You can also go back to the main menu.
When all constraints are added, you can save the filter using a "filter name". With this
filter name you can view the vessel(s) on a map, list all vessels or export data from the
vessels.
When all editing is done, you must save the filter again in order to make the changes
available. Filters can also be deleted.
If you have a list of values to choose from, you can use the "equal" ("="), "not equal"
("!=") or "exist" ("exist") operation. With a decimal value type, you can use the "greater
than" (">"), "less than" ("<") or "equal" ("=") operation. You can also choose the "exist"
operator and sometimes the "valid" operator. A decimal value may contain a decimal
point (".") and a sign ("+" or "-"). With a string value type, you can use the "equal"
11 of 59
Track Server User Guide
("=") or "not equal" ("!=") operation. You can also use a "wildcard" ("*") in front of
and/or behind the value (for some of the constraints) to allow more vessels to match the
constraint. Another type of value is an identifier or id. An id is a value that identifies a
vessel such as MMSI number or IMO number. With an id you can use the "equal" ("="),
"exist" and "valid" operation. Another value type is Boolean. Here you can only choose
from "true" or "false". For the geometry filters, the operations are "inside" and
"outside". Here it is also possible to add a name for the geometry after colon (":")
character.
Most of the constraint values are single values, but sometimes you can define multiple
values. This means that a vessel satisfies the constraint if it matches one of the values
defined. The different values are separated by comma (",") and the operation available
only the "equal" operation.
12 of 59
Track Server User Guide
13 of 59
Track Server User Guide
14 of 59
Track Server User Guide
15 of 59
Track Server User Guide
Active
The vessel data is updated continuously. But if the vessel is not updated within the
system defined inactivity time (usually 15 minutes) , the vessel becomes "inactive".
Inactive time
When using the active attribute, the system defined inactivity times are used to control
whether the vessel will be shown or not. With this attribute, you can choose your own
inactivity time to control whether the vessel will be displayed.
Max speed
For each vessel the media speed over ground is recorded. Using this attribute you can
select high speed crafts even if they currently are not moving so fast.
16 of 59
Track Server User Guide
ETA diff
The difference between ETA time and now time is computed (ETA - now). With the
attribute you can e.g. find which vessel that will arrive at a port within the next 12
hours.
Distance sailed
The distance sailed by the vessel since the beginning of the month
This is the difference between COG and heading minus 90. This value can be used to
check whether a vessel is drifting or not. Setting this value to e.g. < 30, means that the
constraint is triggered if the angle between COG and heading is between 120 and 60
degrees. If sea current is available (see weather attributes), course through water (CTW)
is also calculated and the minimum value of the difference between heading and COG
and heading and CTW is used.
Sun altitude
The altitude of the sun is computed from position and time. The color scheme used
when coloring the track with this attribute corresponds to the sun altitude settings for
dark (less than -18), astronomical twilight (-18 to -12), nautical twilight (-12 to -6) and
civil twilight (-6 to -0.83) and several choices of bright (day).
Attribute Invalid if
MMSI number A corresponding country is not found
IMO number Number of digits are wrong
Call sign A corresponding country is not found or the country found using
MMSI number is not the same
Ship name A ship name has prefixes such as M/T, M/F etc.
ETA diff The difference between "now" and ETA is greater than 1 month or
less than - 6 if ship is moving
Max Draught Max draught is less than 0.1 meter
Length Invalid length is less than 2 meter and width/length ratio less than
1
17 of 59
Track Server User Guide
Attribute Invalid if
Width Width is less than 1 meter and width/length ratio less than 1
This filter uses a port list. This list is compared with destination to find the best
matching port (To Port). The position of the ports is used to find in which port the
vessels are staying (In Port) and when the vessel leave port, the current port becomes
the departure port (From Port).
Some geometry filters are a little different. The Polyline filter allows only for drawing
of lines. The "Passline" allow you to filter ships which are passing a line (polyline), i.e.
when the track from the vessel intersects the line. You can look at vessel passing from
left to right, right to left or both. These filters use the following parameters:
18 of 59
Track Server User Guide
At the server some geometries are already defined. You can choose from them using a
"named inside", "named outside" and some similar options for named Passline filtering.
The “Histogram” filter also calculates a histogram of the passages across a passage line
in the directions set in the filter. As a default, the number of columns used is dependent
of the scale in which the histogram is shown (with a default width for each column of
15 pixels). One can however also set the width of each column (in meter) as an extra
parameter at the end of the filter values. When vessel data from this histogram is
exported, one can add extra parameters to be included. These parameters are:
Note that the pass direction (left to right or right to left) is defined as the direction a
vessel pass looking from the first position in the pass line (or histogram) to the next.
There are also some special kind of filters which are used to filter out vessels which are
at a quay or in a harbour.
The “HarbourHalt” filter is a regular polygon filter with some added constraints, namely
that the vessel has halted for more than five minutes. With this filter it is also sufficient
that some part of the vessel (defined by position, the dimension and heading) is inside
the polygon.
The “QuayHalt” filter is similar and also checks whether the vessel has halted for more
than five minutes. This filter however is defined by a polyline and checks whether at
least 55% of the vessel is inside a polygon defined by this line and a width (defined by
<width> or a default value defined by the length of the line segment) and that the vessel
is alongside the quay (minimum difference is 30 degrees).
The geometric attributes may also be drawn by the user. When “Draw” is pressed, a
new map windows pops up where one can draw the shape.
19 of 59
Track Server User Guide
To start drawing, press the “add point” button . One can then continue to add
points until one is finished with the drawing and can press “done” . The
coordinates are then shown as attribute values. Sometimes one then has to add an extra
parameter such as width or radius to complete the drawing (polygons are automatically
20 of 59
Track Server User Guide
The shortest distance and the related time stamp is saved and can be displayed with
different colors or used in traffic analysis. One could i.e. filter out all pilot boarding
operations by making a filter which combines “closest vessel distance” and “ship type”
(equal pilot). The closest vessel to vessel distances are also stored for each position in
the track.
21 of 59
Track Server User Guide
The attributes can also be used for coloring the tracks. The color scheme for wind is
based on the limits used in the Beaufort scale and with corresponding settings for wave
height. If COG and SOG is defined, Course Through Water (CTW) and Speed Through
Water (STW) is calculated.
Bounding box
This "constraint" defines the default map region (minimum longitude, minimum
latitude, maximum longitude, and maximum latitude) to be displayed when this filter is
used.
Colour
This "constraint" defines the color for which the vessel is plotted.
VDO vessel
If a VDO message is used for a vessel (not VDM), this constraint is triggered. A VDO
message is an AIS messages from “own” ship meaning that vessels with this constraint
triggered are vessels which transmit the AIS messages they receive.
3.11 Examples
These are some examples of some constraints.
22 of 59
Track Server User Guide
23 of 59
Track Server User Guide
4 MAP PAGE
The Map Page is available from the Start Page, either by clicking on “Map All” or by
clicking “Map” for a filter. The Map Page can also be reached from the List Page for a
filter.
24 of 59
Track Server User Guide
4.2 Animation
From this page you can create a GIF animation of vessel movements for a specified
time period. When generating the animation, the currently selected background map and
layers are used. By selecting "from date" and "to date" the system will calculate the
number of frames the animation will contain (maximum is 50). You can also specify a
value for "image delay" which is the delay in seconds between each frame and how
many time steps to skip between each frame.
To start processing, choose "Start". When the processing is finished, 100 % will show
up as status and a link to the generated file will appear.
Press "stop" to stop the generation process. If you want to create an animation for
another period before the previous is done, you must press "stop" before you can start
creating a new one. Pressing "stop" will also delete the generated file.
4.3 Areas
It is possible to quickly navigate (zoom/pan) to a set of predefined areas. An area is
defined by first choosing an area (using zoom/pan) and then select "edit area" and
25 of 59
Track Server User Guide
saving this area under a name. To select an area, choose the named area in the combo
box. The "default" area is the area computed when "map" page is entered.
By choosing “Edit Area”, you can edit areas. If you want to save the area (map region)
that you are currently using, you can specify a name and press "Save". If you want to
delete an already defined area, just select the area and push "Delete selected area"
(Notice: After one has changed some settings, one must press the "refresh" button
in order for the updates to take effect.)
A set of different map servers are available. For each of those map servers, one can
choose which layers to display.
The map server which is currently open (selected) is automatically selected as the server
used for GetFeature (WMS) requests ("Info" button, ).
The Track server has one or more background map servers available. If you have more
than one, you can choose which to use. This is very useful in case the default
background map server is not working.
26 of 59
Track Server User Guide
A set of map servers for foreground maps can be configured for this application. These
layers can contains information such as:
27 of 59
Track Server User Guide
4.5.1 Refresh
4.5.1.1 Refresh rate
The map layer is updated at regular intervals. With this field you can set how often the
map will be updated (in seconds). You cannot set this interval lower than 5 seconds. If
set to 0, the map does not update automatically.
4.5.1.2 Refresh
This button allows you to center the map on those vessels that satisfy the filters
which are chosen.
By pressing the "Make vessel list" button , a list of the vessels that are included in
the selected filters is generated. This list is either shown on the right side of the map, as
a floating window on top of the map or in a new tab.
When the vessel list is shown, one can press one of the vessel names, and the map will
be centered on this vessel. You can also select or unselect which vessels to display.
28 of 59
Track Server User Guide
When you are done with the vessel list, just press "Delete" and the vessel list is removed
and you are back to normal filter operation.
4.5.2 Search
The search frame allows you to search for vessels using name, call sign etc. Choose
which attribute to use in the search, type the search criteria and press "Search". The map
will then display those vessels which satisfy the search criteria. At the same time the
map will be centered on those vessels.
4.5.3 Settings
4.5.3.1 Presentation style
You can choose a presentation style for the vessel map layer:
Default
Basic
Small
Minimal
No text
Always text
Always track
Always text and track
No inactive
Track only
Track only, no inactive
Track only, color track
Track Call sign
Call sign timestamp
Time Stamp
Always track and time
Icons
29 of 59
Track Server User Guide
The "Basic" presentation style is similar to the "Default" style with the following
differences: It does not show COG/SOG vector and track. It uses a smaller font, and the
text display is turned on at lower zoom level. The "Small" style does display track, but
the text is small and without any frame and the "Minimal" style does only display the
vessel symbol.
When using "Always text", the text for each vessel is shown in all scales. The "Always
track" presentation is similar to "default" styles but the track is displayed for all scales.
“Always text and track” shows text and track in all scales. The "No inactive" is similar
to the "Always track", but does not show the parts of the track where the ship was not
active (red color). In the same way "Track only", "Track only, color track" and "Track
only, no inactive" only show the track. The two first, "Track only" and "Track only,
color track", show the inactive parts of the track where the ship was not active and the
last, "Track only, no inactive" does not. However, "Track only, color track" shows the
inactive parts colored by the same colors as the previous active position.
“Track callsign” is similar “Always text”, but shows call-sign instead of name.
“Timestamp” is similar to “Small”, but with the text style of “Default”. In addition it
shows the time for the vessel if the time for the last position compared to the time of the
display is more than one hour old. If the position is on another day compared to the
“current time”, the date is also added. “Call sign timestamp” is similar to “Timestamp”
but also shows the call-sign for the vessel. “Always track and time” is similar to
“Always track”, but add time on positions when long tracks are shown.
4.5.3.2 Color by
Vessel (the triangle displayed at the vessels position) and vessel tracks may be colored
by different attributes. In case the attribute is a continuous value (e.g. speed, length
etc.), the vessel is colored by a color for different ranges of this attribute using a
"rainbow" color range. If the attribute is discrete, the values with the highest counts are
colored by different discrete color. If the vessel does not have this value, it is colored by
“Not defined”. The rest of the values are colored by a common color, as "Various”. The
default color scheme uses “blue” for moving vessels, “yellow” for halted vessels and
“red” for inactive vessels.
For the available selections for “Color by”, the continuous attributes are marked with
“c” and the discrete with “d”. For some attributes that are available for each position,
each segment of the track may have different colors. These are marked with “t”.
Default
Cargo (d)
Closest AtoN distance (c, t)
Closest vessel distance (c ,t)
Country (d)
Current Speed (c, t)
30 of 59
Track Server User Guide
4.5.3.3 TimeScale
This layer shows time in the upper left corner and a scale in the lower right corner.
4.5.3.4 Legend
When the vessels and tracks are color coded, the legend shows the value or value range
for each color. The number inside the color tells how many vessels that have this color
(and value of attribute).
4.5.3.5 Geometry
Some filters contain geometry such as polygon, rectangle or similar. This geometry can
be displayed with this option.
31 of 59
Track Server User Guide
4.5.3.6 Graticule
4.5.3.7 Ports
This system has a worldwide port list from DataLoy. This list of ports can be shown
with this option.
Data is received from so called base stations. These base stations do also send out
messages. When checked, you can see the location (and a 50 nm ring) of all base station
from which another base station receive a signal. That means that you can see base
station in other networks even if you don't receive any signal from them. If this signal
from the base station is lost (not active), the color turns red.
4.5.3.9 MetHyd
With this option on, you can display AIS messages with meteorological and
hydrological data.
4.5.3.10 AtoNo
4.5.4 Layers
Each defined filter is available as a map layer. The layers are listed in alphabetical order
in the “Layers” section. Each layer can be turned on or off by using the check box in
front of the layer name. In addition, borders or other layers that are defined on the server
may be listed here.
32 of 59
Track Server User Guide
5 MAP FUNCTIONALITY
In this chapter we describe the functionality and presentation available in the map view.
The map view is linked to the map page as shown in figure 4.1.
This command toggles the display of the left size of the map window
5.1.2 Refresh
5.1.4 Zoom/Pan
With these tools you can change the region to display. After the button is pressed, the
command is activated and you must click (or drag) in the map to perform a command
33 of 59
Track Server User Guide
This tool makes is possible to measure distances on the map. Move cursor to first
position and press and drag to next position to measure distance. Distance display is
removed when a new tool is selected.
5.1.6 Go to position
With this tool you can go to a specified position and the map is then centered at
this position. You can specify the position in either longitude/latitude (decimal degrees)
or in east/north UTM coordinates (UTM zone 32, 33, 34 or 35). After the position is
entered, you press "OK" and the map is centered and a marker is displayed at the given
position. When you are finished using this tool press "Close", and the position input
dialog will disappear.
34 of 59
Track Server User Guide
5.1.8 Snapshot
With this command you can take a snapshot (image) of the currently displayed map.
When the command is activated, a new window or tab pops up containing both
background and foreground maps. This map is rendered with a higher color resolution,
with anti-aliasing on and annotated with date and time for the data shown.
Take a snapshot
5.1.11 Tracking
With these commands you can start and stop tracking of a vessel. When a vessel is
tracked, the display region for the map will be automatically adjusted to contain the
tracked vessel if the refresh rate is set. The name of the tracked vessel will be displayed
in the upper right corner.
35 of 59
Track Server User Guide
If the destination of the vessel is recognized and the time to the destination is less than
24 hours, a dotted line is drawn from the tracked vessel and to the destination. At the
destination, the direct distance and time to go with the current speed of the vessel are
displayed.
When a vessel is tracked and “Feature info” is used, the Time to Closest Point of
Approach (TCPA) and the distance between the tracked vessel and the object selected
(which also can be a screen position) at the Closest Point of Approach is shown. A solid
line is also drawn between the tracked vessel and the CPA and a dotted line between the
CPA and the other object (or where the other object will be at CPA)
If a MetOc layer is available and displayed, the following new controls are available:
36 of 59
Track Server User Guide
5.1.13 Tags
A sticky label is displayed for each of the selected vessels. The labels are removed
if the map region is changed or the map is refreshed.
37 of 59
Track Server User Guide
With the “Vessel Track” tool one can select vessels and display those vessels with
long tracks. The vessels are displayed with long tracks until one select the “Vessel
Track” tool once more. The length of theses long tracks can be set by the administrator.
When the vessel list is visible, pressing this button will hide the list. Pressing once
more, will make the list visible again.
38 of 59
Track Server User Guide
The vessel is displayed on the map as a colored triangle. The size of the triangle
indicates how big the vessel is. A small triangle indicates a small vessel and a large
triangle a large vessel.
The triangle can have different colors. As default a vessel gets the following color:
Also shown for the vessel is a black heading vector if heading is defined. If the vessel is
turning (and rate of turn is defined), a line perpendicular to the heading vector is shown.
This vector points in the direction the vessel is moving, is proportional to the rate of
turn and is red if the vessel is turning to port or green if turning to starboard.
The triangle can also be colored by an attribute such as country, SOG, etc.
39 of 59
Track Server User Guide
5.2.2 COG/SOG
When you zoom further in you will also see the COG/SOG vector The COG/SOG
vector is magenta and shows how far the vessel will travel with the current speed and
course in 10 minutes.
5.2.3 Track
You will also see the track. The track shows the distance travelled by the vessel for the
last 10 minutes (configurable on server). If the speed is above an operator set limit
(usually 5 knots), the track is blue; if the speed is below, and the track is yellow. If the
delta times between the positions is greater than the maximum inactive time (usually 15
minutes but configurable on server), the track has a red color. The track can also be
colored by an attribute (e.g. country, SOG, etc.).
At the track the different positions are also shown at regular screen intervals. For
different styles and scales, the time in hours and minutes is also displayed. If the date is
changed between the two positions, the date is also displayed. The direction of the track
is shown with arrows.
Attached to the vessel position is a text box. This text box will show the name of the
ship, if it is available. Otherwise it will show the call sign. Depending of the status for
the vessel, the following information will also be shown in the text box:
5.2.5 Dimension
When you zoom in even closer, the outline of the ship will be shown if the dimensions
of the ship are known. If the heading of the ship is known the outline of the ship will be
oriented after the heading and shown in black (heading color). If only course over
ground is available, the color of the outline will be magenta.
40 of 59
Track Server User Guide
41 of 59
Track Server User Guide
6 LIST
One can navigate to this page either by clicking on the “List” link of a filter in the
“Menu page” or from the “Map Page” by clicking on the “List” link.
From this page you can go directly to view all vessels for this filter on the map, export
all vessels for this filter or you can go directly to the main menu.
At this page you can list all vessels that satisfy the current filter. Only some vessels
(approximately 15) are presented simultaneously. To view the other vessels (if there are
more), you can press "next", "previous", "first", "last" or go to a numbered page. If you
want to refresh the content for this filter, press the "refresh" button.
Vessel information
If you want more detailed information for a vessel, press the "detail" link in the action
column and the "detail" page will be presented. If you want to look at the vessel in map,
press the "map" link and the vessel will be presented centered on the map in the "map"
page.
42 of 59
Track Server User Guide
7 VESSEL DETAILS
When the user clicks on the “Details” link of a vessel in a list of vessels, this page will
be displayed. The page shows detailed information about each vessel.
From this page you can go directly to view this vessel on the map, list all vessels for the
current filter or you can go directly to the main menu.
43 of 59
Track Server User Guide
If you want to update information about this vessel, press the refresh button.
At the end of the attribute list, there are some links to other web sites with additional
information concerning this vessel. These web sites may be protected by a "username"
and "password" and you must yourself supply these data in order to enter the site. Some
of the web sites use standard authentication mechanisms which makes it possible for
you to store the "username" and the "password" for this site in the browser. This makes
it more easy to use these sites.
A site may or may not have information about this ship and this system does not (for the
moment) check whether the site has some information. You may therefore sometimes
encounter "blank" pages when you try to enter a site.
44 of 59
Track Server User Guide
8 EXPORT
One can navigate to this page either by clicking on the “Export” link of a filter in the
“START/Menu page” or from the “MAP page” by clicking on the “Export” link.
From this page you can export data to a "tab" separated file (tsv). This file contains a
header line with the name of all attributes and a line for each of the vessels exported.
Each attribute is separated by a "tab" character. On this page you can select the
attributes you want to include in the export. By default only IMO number is selected.
When you have selected the attributes you want to export, you press the "Export" button
and then you can download a file containing the data.
To export all the positions for one vessel, use the field “Long Lat Time”. This column
will then contain a comma separated list of Longitude, Latitude and Date/time.
Attributes exported
45 of 59
Track Server User Guide
9 ALERT MODULE
The alert module makes it possible to send alerts by e-mail or SMS if certain conditions
are valid. The alerts are connected to the filters and may be added at the filter page.
The alerts are defined by filters. A filter defines at set of vessels and an alert may be
sent if a new vessel is included in this set (e.g. a vessel entering a region), is excluded
from this set (e.g. leaving the region) or both. (For the first condition we say that the
vessel is going from false to true and for the second we say the vessel is going from true
to false.) To create an alarm for a filter one chooses “edit filter” for the filter one wishes
to add an alarm for and presses “Add Alarm”, or if an alarm is already defined, press
“Edit” on the alarm you want to change.
46 of 59
Track Server User Guide
Here one can add the name of the alarm and what to be included as subject for the e-
mail sent by this alarm.
Where this alarm should be sent, can be set by adding a list of comma separated e-mail
addresses or a list of mobile telephone numbers (SMS). If one wants the alarm only to
be valid for some vessels (within the filter chosen), one can select a set of MMSI
number for which the alarm should be valid for. One can also restrict the time range
(from date/time and to date/time) for when the alarm should be valid.
As mentioned before, one can select whether one wants the alarm to be sent when the
vessel is included in the filter set (false to true), is excluded from it (true to false) or
both. Finally one can also select whether the alarm is a “one off” or is “recurrent”.
When the alarm is set up, e-mails and SMS’s are sent when the alarm conditions is
triggered. The alarm conditions are checked at regular intervals and if several vessels
fulfil the condition, all the vessels are listed in the e-mail sent to the recipient. A typical
e-mail will then look like this:
Here the subject of the e-mail is put together from the subject specified in the alarm and
the name of the vessel. Together with information of the vessel and the alarm condition,
information on last departed port, current port (if any) and destination port is included.
A link is also included which makes is possible to see the vessel at the time (snapshot
time) just after the event occurred. Pressing this link, will for this e-mail result in the
following map.
47 of 59
Track Server User Guide
48 of 59
Track Server User Guide
Country
Ship Type
Cargo
Name
Vessel Operation
Navigational Status
RAIM Flag
Destination
To Port Name
In Port Name
From Port Name
On Route Port Name
To Country
In Country
From Country
49 of 59
Track Server User Guide
Time Halted
Distance Sailed
Length
Width
Max Draught
Sun Altitude
Speed Over Ground
Max Speed
Course Over Ground
Heading
Rate Of Turn
Source Name
If the statistics is collected over time, it is possible to display the distribution of the
statistics over time such as
Month
Week Of Year
Day Of Year
Day Of Week
Hour Of Day
50 of 59
Track Server User Guide
If the number of time periods for a given time distribution is greater than 24, it will not
be possible to use this distribution. If you e.g. collect statistics for 30 days, the "Day Of
Year" will not be available.
10.2 Tails
In order to enable access to this page, the user must choose “Edit Mode Menu” in the
main page followed by clicking “Tails” for a filter.
From this page you can prepare to view vessel data for a specified time period. By
selecting "from date" and "to date" and pressing "start", the system will collect vessel
data for the selected time period and process them into one dataset. You can also set the
from-time by specifying "Number of days back". If you set the "minimum time
difference" greater than 0 (zero), vessels with the same identification (i.e. the same
vessel) with non-overlapping tails where the time difference between the first and the
last position of the two vessels are greater than this difference, will be counted as two
vessels. This is useful when one wants to "count" the same vessels several times (e.g.
when passing a line).
From the "menu" page you have already chosen a filter to use for the processing. In this
page you can change this and choose other filters as well.
51 of 59
Track Server User Guide
To start processing you choose "Start". When the processing is finished, 100 %
complete will show up as status and you can continue to "map", "list" or "statistics" for
viewing the result. If you want to look at another period, you must press "stop" before
you can start collecting data for the new period. Pressing "stop" will also delete the file
which is created when the data is collected. Previously generated "tails" can also be
deleted by pressing "Delete tail".
52 of 59
Track Server User Guide
In this dataset the vessel will have "tails" (tracks) which covers the time period. To save
space and processing time, the "tails" are thinned using the well-known "Douglas-
Peucker” line simplification algorithm". With this algorithm "unnecessary" points
where the vessel travels along a straight line at a constant speed are removed whereas
points where the vessel is turning or changing speed are preserved.
53 of 59
Track Server User Guide
From this page you can prepare to view vessel density data for a specified time period,
set of filters, grid resolution and area. The following density data is generated (field
marked * is normalized to a value per square kilometer if “Normalized” is set):
Comments:
By selecting "from date" and "to date" and pressing "Start", the system will collect
vessel data for the selected time period and filters set and process them into one dataset.
54 of 59
Track Server User Guide
You can also set from time by specifying "Number of days back". By setting the
"Minimum time difference", vessel tracks from the same vessel will be concatenated if
the time difference between the first and the last position of the two vessel tracks are
less than this difference.
From the "Menu" page you have already chosen a filter to use for the processing. In this
page you can change this and add or change other filters as well.
However, whatever method you choose to set the cell size, no more than 1.000.000 cells
can be used
To choose which area to process, you select one of the areas in "Select area". This will
select a previously saved area.
To start processing you choose "Start". When the processing is finished, 100 %
complete will show up as status and you can continue to "Map" for viewing the result.
55 of 59
Track Server User Guide
When viewing the result, you select which variable to view and a style to present the
data. The style is divided into 3 different parts:
The density grid can also be exported as a NetCDF file by choosing "Download
NetCDF File".
If you want to look at another period, you must press "Stop" before you can start
collecting data for the new period. Pressing "Stop" will also delete the file which is
created when the data is collected.
56 of 59
Track Server User Guide
The vessel data collected with density plot can also be exported from the map display
page (use “Export”) as a tab separated and can later be imported into an excel
spreadsheet. For the density plot, the average speed, total time and distance is also
computed for each vessel and can be exported.
57 of 59
Track Server User Guide
11 ADMINISTRATION
Admin help is available for the system administrator. When logging in as system
administrator, “Administration” will be available in the main menu. From the Admin
Help page you can:
The administrator message is displayed on all pages except the Map page and is
activated when this "page" is saved.
The speed set is the limit between the "low speed color" and the "high speed color" for
the vessel track. This color setting is only effective for data from "Satellite tracking of
Fishing Vessels". The setting is activated when the "page" is saved.
At the bottom of the page, all "connectors" are listed with status. Information about
number of messages per second and kilobits per second is shown for most connectors.
These figures are updated every minute.
Selecting "Restart Connectors" will close and reconnect the data connectors of the
system.
58 of 59
Track Server User Guide
12 SHOW USERS
If you have problem logging into your account because the limit for number of
concurrent users has been exceeded or you just want to see who is using your account,
you can select “Show users” from the main menu (this is dependent that this feature is
available in your system). The screen will then show all the users (IP addresses) that are
using your account.
If you select “who is”, a page will show has registered this IP address.
59 of 59