Welcome to Ocean Visuals Documentation

This documentation will give an overview of Ocean Visuals Web UI - the web based user interface, its concepts and features.

Terminology

• AIS - ​Automatic Identification System is used to provide information of nearby (to an Observer) vessel information
• Device - a device represents a physical grouping of Observation Types e.g. a LIDAR which measures: oil pollution, colored dissolved organic matter (CDOM), water transparency etc.
• Incident - a collection of Observations where a specified Observation Type is out of the normal range(s) for that specified Observation Type
• Observation - a group of measurements for one or several Observation Types at a specific time and location (latitude, longitude)
• Observation Type - a single measurable entity - an instrument / a sensor - providing a scalar value e.g. temperature, oil pollution, water transparency etc.
• Observer - a vessel or a stationary platform carrying one or several Devices for Observation gathering.

Web UI

At the highest level the Web UI functionality at an Onboard installation or at web.oceanavisuals.no is divided into 2 groups: anonymous users, public data; authenticated users, enhanced data.

Anonymous users have access to the public data and the aggregated statistics of that data.

Authenticated users have access to additional information depending on the specific installation.

Basics, Public Interface

By default when opening the Web UI the Overview view is selected. The main purpose of the Overview view is to present a quick high-level overview of various Observation points and Observer position(s).

The major UI components in the Overview view, annotated in figure 1.1 are:

1. Observation Type and Observer selection
2. Observer tracking
3. Latest Data panel
4. Map

Figure 1.1 - Overview view

1. Observation Type and Observers Selection

The selected Observer Type in conjunction with the authentication state will determine which Observers are accessible - that is will provide data - and visible in the Observers selection and on the Map.

When opened the Observers selection provides information on:

• accessible Observers
• last contact from an Observer - if latest contact (ping) is more than 1 minute ago a specific time-stamp is shown instead of a short OK

Clicking on an Observer in the list will focus and zoom in the Map on the latest Observer position.

The latest Observer position is either the latest Observation position or (at ​https://web.oceanvisuals.no) the latest AIS position, whichever has the newer time-stamp.

2. Observer Tracking

Enabling tracking for an Observer will focus and zoom in the Map on the selected Observer's latest position. The map will continuously update itself and "follow" the Observer's latest positions automatically on each successive position update.

3. Latest Data Panel

If no specific Observer is selected, the Latest Data Panel samples the latest Observations of all available Observation Types over all the available Observers and automatically updates itself as the Observations are coming in.

If an Observer is selected the Latest Data Panel only show the data resulting from that selected Observer.

4. Map

The Map reacts to user input from the Observation Type and Observers selection and can be navigated independently by utilizing the mouse for dragging and zooming. Explicit buttons for controlling zooming are located in the left upper corner of the Map.

NOTE: the AIS information and legend are visible only for authenticated users at ​https://web.oceanvisuals.no.

Statistics View

The purpose of the Statistics view is to provide an overview of aggregated Observations per selected Observation Type and year.

The major UI components in the Statistics view, annotated in figure 2.1 are:

1. Observation Type selection
2. Observation Type legend
3. Year selection / Month selection
4. Day selection
5. Hour selection
6. Observation selection
7. Observation details

Navigation

The basic navigation pattern for Statistics view is from top left -> down -> right.

• start with the Observation Type (1), selecting the Observation Type will also update its legend (2).
• next, pick a year (3), default is the current calendar year
• depending on your interest use the Month (3), Day (4) and Hour (5) selections to filter your search
• the map on the right will update accordingly and load the Observations matching the specified Month, Day and Hour filter
• on the map click on an Observation (cluster) icon (6) to zoom in until specific Observation icons appear, clicking on the specific Observation icon will open up Observation details (7)

As in the Overview view the Map can be independently manipulated to zoom in or to zoom out on various locations of interest.

Figure 2.1 - Statistics, Oil Pollution

Onboard Operations

An authenticated onboard operator (on a Vessel) has access to additional functionality:

• Geofencing
• Incident view
• Observations view
• Devices view

Geo-fencing

When geofencing is enabled it will override some manual Device mode operations inside and/or outside of a geofence.

For example, when a geofence's "inside state" is configured to turn the Device off, a manual Device mode change to Normal or Fast may trigger and Observation, but the next GPS update received from the Device will re-active the geofence's "inside state" and turn the Device off again.

In the same way, when a geofence's "outside state" is configured to turn the Device on, a manual Device mode change to Off will only turn the Device off for a brief period, until the next GPS update arrives from the Device and re-activates the geofence's "outside state".

At present a fixed set of preconfigured geofences is provided. Additions and/or removals to the list of geofences is done by Ocean Visuals personnel, due to the intricacies of configuring the Device states properly.

For requesting additional geofences, please compile a list of GPS coordinates (latitude, longitude - degrees, WGS84) + radius and send it to webmaster{at}oceanvisuals{dot}no.

Incidents

Observations

Devices