[[PageOutline(2-5,Contents,pullout)]] = Welcome to Ocean Visuals Documentation = This documentation will give an overview of OV's main user interface, its concepts and features; of the onboard installation and its administration. == Terminology == #terms * AIS - [https://en.wikipedia.org/wiki/Automatic_Identification_System 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 == #web-ui At the highest level the Web UI functionality at https://web.oceanavisuals.no is divided into 2 groups: anonymous users, public data; authenticated users, enhanced data. Anonymous users have access to the [#overview public data] and the aggregated [#stats-view statistics] of that data. Authenticated users have access to additional information regarding: * [wiki:ObservationsView Private Observers and their Observations] * [wiki:MapsAIS Maps with an AIS Layer] * Detailed Incident Reports with AIS history * [wiki:OnboardAdministration Onboard Administration] === Overview === #overview 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 positions. The major UI components in the //Overview// view, annotated in [#fig1-1 figure 1.1] are: 1. Observation Type and Observer selection 2. Observer tracking 3. Latest Data panel 4. Map ==== Figure 1.1 - Overview view #fig1-1 {{{ #!html 1 2 3 4 }}} [[Image(overview.png, nolink, usemap="#fig1-1-map")]] ===== 1. Observation Type and Observers Selection #fig1-1-ctrl1 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 the latest AIS position, whichever has the newer time-stamp. ===== 2. Observer Tracking #fig1-1-ctrl2 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 #fig1-1-ctrl3 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 #fig1-1-ctrl4 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. === Statistics View === #stats-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 [#fig2-1 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 #fig2-1 [[Image(statistics.png, nolink)]]