OceanBrowser

From GHER

(Difference between revisions)
Jump to: navigation, search
(Submitting)
(Acknowledgements)
 
(43 intermediate revisions not shown)
Line 1: Line 1:
-
OceanBrowser allows to visualize gridded fields on-line.  
+
OceanBrowser is a web-service that allows the on-line visualisation of gridded fields.  
-
 
+
It is used in SeaDataNet (http://gher-diva.phys.ulg.ac.be/web-vis/) and chemical data in EMODnet (http://gher-diva.phys.ulg.ac.be/emodnet/).
-
It is used in SeaDataNet (http://gher-diva.phys.ulg.ac.be/web-vis/), chemical data in EMODNET (http://gher-diva.phys.ulg.ac.be/emodnet/) and for data set product by the GHER (http://gher-diva.phys.ulg.ac.be/gher-data/).
+
-
 
+
-
 
+
-
Within the SeaDataNet and EMODNET (Chemical lot) projects, several national ocean data centers have created gridded climatologies of different ocean properties using the data analysis software DIVA. In order to give a common viewing service to those interpolated products, the GHER has developed OceanBrowser which is based on open standards from the Open Geospatial Consortium (OGC), in particular Web Map Service (WMS) and Web Feature Service (WFS). These standards define a protocol for describing, requesting and querying two-dimensional maps at a given depth and time. The software OceanBrowser is composed by a client and server part. The server essentially supports the standardized requests for listing all available layers and format and projection in which they are available, provides a rendered picture of the required layer, and provides additional information of a given location (often the value of the field).
+
-
The server is built entirely upon open source software. It is written in python using Matplotlib and basemap for graphical output. It is embedded in Apache and runs on a dedicated Linux server (two Intel Xeon E5420 quad-cores) at the University of Liege.
+
-
The client part runs in a web browser and uses the JavaScript library OpenLayers to display the layers from the server. A simplified version of OceanBrowser is also used in Diva-on-web, an on-line tool to create interpolated fields from in situ ocean data.
+
 +
Within the SeaDataNet, SeaDataCloud and EMODnet (Chemical lot) projects, several national ocean data centers have created gridded climatologies of different ocean properties using the data analysis software tools [https://github.com/gher-ulg/DIVA DIVA] or [https://github.com/gher-ulg/DIVAnd.jl DIVAnd]. In order to give a common viewing service to those interpolated products, the GHER has developed OceanBrowser which is based on open standards from the Open Geospatial Consortium (OGC), in particular Web Map Service (WMS) and Web Feature Service (WFS). These standards define a protocol for describing, requesting and querying two-dimensional maps at a given depth and time.
= Features =
= Features =
 +
OceanBrowser currently supports the following operations:
OceanBrowser currently supports the following operations:
-
 
+
* Horizontal sections of the 4-dimensional fields (longitude, latitude, depth and time) can be visualized at a selected depth and time. The climatological fields can also be interpolated and visualized on arbitrary vertical sections.
-
* Horizontal sections of the 4-dimensional fields (longitude, latitude, depth and time) can be visualized at a selected depth and time. The climatological fields can also be interpolated and visualized on arbitrary vertical sections (Figure 1).
+
* The maps displayed in the browser are created dynamically and therefore several options are made available to the user to customize the graphical rending of those layers. Layers can be displayed either using interpolated shading, filled contours or simple contours and several options controlling the color-map are also available.
* The maps displayed in the browser are created dynamically and therefore several options are made available to the user to customize the graphical rending of those layers. Layers can be displayed either using interpolated shading, filled contours or simple contours and several options controlling the color-map are also available.
* The horizontal and vertical sections can be animated in order to study the evolution in time.
* The horizontal and vertical sections can be animated in order to study the evolution in time.
* Image can be saved in raster format (PNG) and vector image formats (SVG, EPS, PDF). It can also be saved as a KML file so that the current layer can be visualized in programs like Google Earth and it can be combined with other information imported in such programs.
* Image can be saved in raster format (PNG) and vector image formats (SVG, EPS, PDF). It can also be saved as a KML file so that the current layer can be visualized in programs like Google Earth and it can be combined with other information imported in such programs.
-
* The underlying 4-dimensional NetCDF file can be either downloaded as a whole from the interface or only as a subset using the linked OPeNDAP server based on pydap.
+
* The underlying 4-dimensional NetCDF file can be either downloaded as a whole from the interface or only as a subset using the linked OPeNDAP server.
* The web interface can also import third-party layers by using standard WMS requests. The user needs only to specify the URL of the WMS server and its supported version.
* The web interface can also import third-party layers by using standard WMS requests. The user needs only to specify the URL of the WMS server and its supported version.
 +
 +
= Usage =
 +
 +
* Select a domain and variable in the "Add layer/Select data product" dialog. Under the variable name, the variable with two error thresholds (0.3 and 0.5) can be chosen. In "additional fields" the full field without error thresholds are available as well as data distribution (Logarithm10 of number of data in bins), outliers distribution (Logarithm10 of number of outliers data in bins), relative error and the near bottom value (deepest value). A "data bin" is a grid cell of the interpolated grid.
 +
 +
* To remove a field from the map, click on the "remove" button.
 +
 +
* After changing the depth and/or time dimension, the map can be refreshed with the "update" button.
 +
 +
[[File:OceanBrowser_select_data_product.png]]
 +
* Several data sets can be visualized at the same time. For example, ocean temperature from the North Sea, Atlantic Ocean and Mediterranean Sea can be visualized at the same time. The consistency of the several ocean products in adjacent regions can be easily assessed and potential problems can be highlighted (Figure 1). This feature is available for horizontal as well for as for vertical sections. By choosing simple contours of one field in combination with filled contours of other field one visually sees the correspondence or location of frontal structures.
* Several data sets can be visualized at the same time. For example, ocean temperature from the North Sea, Atlantic Ocean and Mediterranean Sea can be visualized at the same time. The consistency of the several ocean products in adjacent regions can be easily assessed and potential problems can be highlighted (Figure 1). This feature is available for horizontal as well for as for vertical sections. By choosing simple contours of one field in combination with filled contours of other field one visually sees the correspondence or location of frontal structures.
-
== Future outlook ==
+
== Change style ==
-
The upcoming HTML5 standard brings a large range of new features to modern web browsers which will also be useful to visualize ocean data. WebGL is a technology which allows displaying 3 dimensional data in a web browser using hardware acceleration. An experimental JavaScript library, called EarthGL (figure 2), has been developed which allows displaying horizontal and vertical sections of ocean fields on a globe with realistic topography [6]. This JavaScript library is strongly inspired by OpenLayers and should be familiar to developers using the library. WebGL is currently supported by Google Chrome (version 9) and the  development version of Mozilla Firefox and Safari.
+
 
 +
The appearance of the field can be customized by clicking on the style button (http://gher-diva.phys.ulg.ac.be/web-vis/img/config.png) where you can range color map, color range, plot style (flat shading, contours and filled contours).
-
= Basic Usage =
+
[[File:OceanBrowser_config_layer.png|Style dialog‎]]
-
* Select a domain and variable in the "Add layer" dialog.
+
[[File:OceanBrowser_plotting_style.svg|700px]]
-
* Per default the surface layer and the first time slice is shown. This can be changed in the depth and time select boxes next to the color bar (on the right). After the choice is confirmed by clicking on 'Plot/update', the map is redrawn.
+
-
* The appearance of the field can be customized by clicking on the style button (http://gher-diva.phys.ulg.ac.be/web-vis/img/config.png).
+
-
* To remove a field from the map, click on the cross (http://gher-diva.phys.ulg.ac.be/web-vis/img/close.png) next to the color bar (on the right).
+
== Icons ==
== Icons ==
Line 44: Line 48:
* http://gher-diva.phys.ulg.ac.be/web-vis-test/css/theme/emodnet-chemical/img/drag-rectangle-on.png, http://gher-diva.phys.ulg.ac.be/web-vis-test/css/theme/emodnet-chemical/img/drag-rectangle-off.png: zoom by drawing a rectangle is enabled or disabled (default). Click to draw a first corner of the rectangle and then drag it to the desired size.
* http://gher-diva.phys.ulg.ac.be/web-vis-test/css/theme/emodnet-chemical/img/drag-rectangle-on.png, http://gher-diva.phys.ulg.ac.be/web-vis-test/css/theme/emodnet-chemical/img/drag-rectangle-off.png: zoom by drawing a rectangle is enabled or disabled (default). Click to draw a first corner of the rectangle and then drag it to the desired size.
-
== Download ==
+
== Horizontal Sections ==
-
You can open the download dialog by clicking on the download icon (http://gher-diva.phys.ulg.ac.be/web-vis/img/download.png) next to the color bar.
+
Per default the surface layer and the first time slice is shown. This can be changed in the depth and time select boxes next to the color bar (on the right). After the choice is confirmed by clicking on 'Update', the map is redrawn.
-
You can either download the data (netCDF or OPeNDAP) or download images for the current layer.
+
-
=== Data ===
 
-
The entire NetCDF file can be downloaded by clicking on the "HTTP" link or via OPeNDAP. Useful software to access the data in netCDF/OPeNDAP are:
+
The location of the observations are shown with a marker on the map. The marker is semi-transparent so that stronger colors give an indication of density of the observations at the particular location.
-
;ncBrowse: [http://www.epic.noaa.gov/java/ncBrowse/ A Graphical netCDF File Browser]
+
== Vertical section ==
-
;Panoply: [http://www.giss.nasa.gov/tools/panoply/ netCDF, HDF and GRIB Data Viewer]
+
-
;Ncview: [http://meteora.ucsd.edu/~pierce/ncview_home_page.html a netCDF visual browser]
+
-
=== Images ===
+
* Vertical sections can be extracted by selecting the corresponding tab on the upper left.
 +
* The overview map shows the same time instance and depth levels as the horizontal view (which is the the first time instance of the surface layer per default).
 +
* With a mouse a section can be draw in the overview map. A simple click starts a section or adds a point and double-click finishes it.
 +
* After a section is finished it will appear, the field will be interpolated onto the requested section and drawn in the central part (labeled "vertical section" in the figure below). The coordinates of this plots are distance in arc degrees from the starting point (1 arc degree is always equal to 1 degree in the North-South direction and approximately 111 km) and depth (0 is the surface and value are negative in water).
-
It is also possible to download the current view as an image file by specifying the width and height of the image and the longitude and latitude range.
+
[[File:Vertical_section.svg|700px]]
-
= Feedback =
+
Instead of drawing a section by the mouse, one can generate a section based on a fixed distance from coast or depth. The corresponding option has be chosen in "Interaction mode".
 +
The work-flow is illustrated in the following figure. As multiple disconnected line segments are at a fixed distance form coast (or constant ocean depth). One has the select by the mouse in the overview map the desired section.
-
Question and comments can be addressed to Alexander Barth (a dot barth at ulg dot ac dot be)
+
[[File:vertical_section_dist.svg|700px]]
-
= Adding files =
+
= Downloading data products =
 +
You can open the download dialog by clicking on the download icon (http://gher-diva.phys.ulg.ac.be/web-vis/img/download.png) next to the color bar.
 +
You can either download the data (netCDF or OPeNDAP) or download images for the current layer.
-
== Gridded field ==
+
== Data products ==
-
=== NetCDF attributes ===
+
-
The basic idea of OceanBrowser is to impose the least constraint on the netCDF file. Here is a summary of rules used to create the virtual folder hierarchy:
+
Data products can be downloaded as NetCDF files by using the button labeled "Download NetCDF". A NetCDF file will contain the DIVA analysis for a single parameter as well as meta data as NetCDF attributes. User can also download subset of the data products by using the button "OPeNDAP Service". By click this button, a new window will open with the attributes of the NetCDF file. The URL of this window need to be copied into your OPeNDAP application.
-
* Every folder under the root directory appears as a virtual folder in the web browser
 
-
* Every netCDF file appears also as a virtual folder. Its name is the global netCDF attribute ''title''. If this attribute does not exist then the global netCDF attribute description is used. If none of those attributes are found then the netCDF file name is used.
+
[[File:OceanBrowser_download.png]]
-
* The ''long_name'' attribute of the variables is used to list the netCDF variable. If this attribute does not exist, the netCDF variable name is used.
+
Useful software to access the data in netCDF/OPeNDAP are:
-
* The ''units'' attribute is also used and displayed
+
;ncBrowse: [http://www.epic.noaa.gov/java/ncBrowse/ A Graphical netCDF File Browser]
 +
;Panoply: [http://www.giss.nasa.gov/tools/panoply/ netCDF, HDF and GRIB Data Viewer]
 +
;Ncview: [http://meteora.ucsd.edu/~pierce/ncview_home_page.html a netCDF visual browser]
-
=== Grid specification ===
 
-
The netCDF variable that represent the space-time grid must satisfy certain requirements to be recognized:
+
== Bulk downloading ==
-
{| border="1"
+
If you want to download all NetCDF files for a specific zone you can use the command [https://en.wikipedia.org/wiki/Wget wget]. For example to download the all analyses from EMODNET Chemistry from the Baltic Sea you can use:
-
|-
+
-
! Dimension
+
-
! netCDF variable name
+
-
! Units
+
-
|-
+
-
| longitude
+
-
| must contain 'lon' or be equal to x
+
-
| degree east (only between -180 and 180)
+
-
|-
+
-
| latitude
+
-
| must contain 'lat' or be equal to y
+
-
| degree north
+
-
|-
+
-
| depth
+
-
| depth or z
+
-
| m
+
-
|-
+
-
| time
+
-
| must contain 'time' or be equal to t
+
-
| arbitrary (specified in units attribute)
+
-
|}
+
-
Notes:
 
-
* the coordinate variable depth and time should not depend on longitude and latitude
+
wget -nH --cut-dirs=2 -np -r -A '*nc' '<nowiki>http://ec.oceanbrowser.net/data/emodnet-domains/Baltic Sea/</nowiki>'
-
* The time and depth dimension may be omitted.
+
-
* The netCDF coordinate variables and parameter must have the same dimension name
+
-
* The netCDF file may contain much more attributes which are ignored
+
-
* A data set '''should not be split across several file''' (one data set -> one file). For example, instead of having one file for different time instances, the time dimension should be embedded in the netcdf file.
+
-
* Where possible, the file should be CF compliant (http://cf-pcmdi.llnl.gov/documents/cf-conventions/1.4/cf-conventions.html). You can check if your files are CF compliant [http://puma.nerc.ac.uk/cgi-bin/cf-checker.pl here]
+
-
* According to the CF convention, the order of the dimensions must be: '''time, depth, latitude and longitude'''
+
-
* If the variables contains some missing values or land point, then the variable should have the attribute _FillValue (of the same type than the netCDF variable). All grid points corresponding to those missing values or land point, should be equal to this fill value. This fill value should be a regular number (non NaN or Inf) outside of the range of typical values of the variable.
+
-
The ncdump output of a minimal example netCDF file that can be used:
+
Replace "Baltic Sea", to download the data for a different region. The names of the regions can be seen [http://ec.oceanbrowser.net/data/emodnet-domains/ here] for EMODNET Chemistry and [http://sdn.oceanbrowser.net/data/SeaDataNet-domains/ here] for SeaDataNet. This command will preserve the subdirectory structure.
-
netcdf data.nc {
+
wget is generally already installed in Linux. Windows user can install it from [http://gnuwin32.sourceforge.net/packages/wget.htm here] and Mac OS X user can use [http://brew.sh/ Homebrew], for example.
-
dimensions:
+
-
time = 100 ;
+
-
lon = 70 ;
+
-
lat = 80 ;
+
-
variables:
+
-
float time(time) ;
+
-
time:units = "days since 1900-01-01" ;
+
-
float lon(lon) ;
+
-
lon:units = "degree_east" ;
+
-
float lat(lat) ;
+
-
lat:units = "degree_north" ;
+
-
float temperature(time, lat, lon) ;
+
-
temperature:long_name = "Temperature" ;
+
-
temperature:units = "degree_Celsius" ;
+
-
temperature:_FillValue = -999.f ;
+
-
+
-
        :institution = "Your institution" ;
+
-
        :title = "Temperature of Ligurian Sea" ;
+
-
}
+
-
=== Uploading files ===
+
== Images ==
-
Before uploading a file, please:
+
It is also possible to download the current view as an image file by specifying the width and height of the image and the longitude and latitude range.
-
* check visually the interpolated field, and
+
-
* verify the required netCDF attributes (in particular long_name, unit, title, institution (see above)) are present and accurate. NetCDF attributes can be edited by using programs like matlab, octave, [http://nco.sourceforge.net/ nco], ...
+
-
If you notice strange characters in one of the attribute, you can edit with the command ncatted, available within [http://nco.sourceforge.net/ nco] program. Here is a small example:
+
= Future outlook =
-
+
The upcoming HTML5 standard brings a large range of new features to modern web browsers which will also be useful to visualize ocean data. WebGL is a technology which allows displaying 3 dimensional data in a web browser using hardware acceleration. An experimental JavaScript library, called EarthGL (figure 2), has been developed which allows displaying horizontal and vertical sections of ocean fields on a globe with realistic topography. This JavaScript library is strongly inspired by OpenLayers and should be familiar to developers using the library. WebGL is implemented by the current version of all major browsers as long as the graphics drivers supports WebGL.
-
ncatted -O -a date,global,o,c,2010-08-15 filename.nc
+
-
*date  = name of the attribute
+
= Additional information =
-
*global = name of the variable
+
-
*o      = overwrite
+
-
*c      = character
+
-
So this command will replace the actual value of 'date' by the chain of characters '2010-08-15'.
+
* For partners of the SeaDataNet and EMODNET Chemistry, [[OceanBrowser Import Data|description about importing data]] has been written.
 +
* [[OceanBrowser WMS Server]]
-
To upload a new file, you need the program [http://linux.about.com/od/commands/l/blcmdl1_sftp.htm sftp] (not regular ftp). sftp is default on linux. On Windows you will need a program like [http://winscp.net/ WinSCP], [http://www.putty.org/ putty] or [http://filezilla-project.org/ FileZilla].
+
= Feedback =
-
A sample session of uploading a file 'file' in directory 'dir' would be on linux:
+
Question and comments can be addressed to Alexander Barth (a dot barth at ulg dot ac dot be)
-
sftp usename@gher-diva.phys.ulg.ac.be
 
-
Connecting to gher-diva.phys.ulg.ac.be...
 
-
username@gher-diva.phys.ulg.ac.be's password:
 
-
sftp> ls
 
-
...
 
-
sftp> cd dir
 
-
sftp> put file
 
-
Uploading file to /home/username/file
 
-
...
 
-
sftp> quit
 
-
Contact us for the username and password. After the file upload, the viewer is not updated automatically. Please sent us an email so that we can update the viewing service.
+
= Source code =
-
SeaDataNet file should go in the directory SeaDataNet and EMODNET files, in the directory EMODNET.
+
-
== Observation index files ==
+
OceanBrowser is combined with a software called "Diva on web". Both can be installed following the instruction detailed [[Installing Diva on web on your server|here]].
-
 
+
-
=== Format ===
+
-
The index file is an ASCII table where the columns are separated by space (at least one space character). Each line of this file describes a plot. The index file has at least 9 columns:
+
-
 
+
-
# longitude (in decimal degrees East)
+
-
# latitude (in decimal degrees North)
+
-
# start depth (in meters, positive in water)
+
-
# end depth  (in meters, positive in water)
+
-
# start time (yyyy-mm-ddTHH:MM:SS)
+
-
# end time (yyyy-mm-ddTHH:MM:SS)
+
-
# P011-code
+
-
# absolute URL of the image. If the image should be hosted on our server, the URL has the following structure: <nowiki>http://gher-diva.phys.ulg.ac.be/emodnet-chemistry/images/<institution>/<filename.svg></nowiki>. The filename should only contain letters (a-z,A-Z), digits (0-9), underscore (_), hyphen (-) and dot (.). Using other characters (including a space) causes problems.
+
-
# comma-separated list of '''global''' CDI identifiers used in the image.
+
-
 
+
-
The dot is used as decimal separator.
+
-
Columns 7, 8 and 9 can be repeated multiple times if there are various parameters measured at the same location and time span.
+
-
Lines starting with // are comments and are ignored.
+
-
 
+
-
For example:
+
-
 
+
-
13.596167      45.663833      0      0      2006-05-10T00:00:00    2007-02-13T00:00:00    SDN:P011::AMONAADC      <nowiki>http://gher-diva.phys.ulg.ac.be/emodnet-chemistry/images/OGS/ECOMADR_1_SED_0_AMONAADC.svg</nowiki> SDN:CDI:12345,SDN:CDI:12346
+
-
 
+
-
=== Guidelines for plots ===
+
-
 
+
-
* It is suggested to use ODV for manual generation of plots (other tools might be used for batch mode).
+
-
* The minimum number of points per plot should be 4 or 5.
+
-
* Data centers will generate plots in EPS format (one of the formats available using ODV) and then convert them in SVG format with software like Inkscape (Linux) or IRFAN View (Windows). SVG plots will be visualized through the Ocean Browser service.
+
-
* Only the SVG files will be submitted to OceanBrowser.
+
-
* Scatter points plots should be used without lines to connect plotted measures.
+
-
 
+
-
 
+
-
For more information see the Action List of the Liverpool meeting (24 November 2011).
+
-
 
+
-
=== Submitting ===
+
-
 
+
-
Before you submit:
+
-
* check that all plots are fine
+
-
* check that the index file has the correct format
+
-
* check your CDIs. For example the CDI '''SDN:CDI:285916''' should be in the Maris CDI catalog at the address:
+
-
http://seadatanet.maris2.nl/v_cdi_v3/print_ajax.asp?n_code=285916
+
-
* check the file using the validator at http://gher-diva.phys.ulg.ac.be/emodnet-chemistry/html/validator.html.
+
-
 
+
-
Send the new products to emodnet-timeseriesprod at googlegroups dot com for a general revision about guidelines points: temporal resolution, data availability, software used...before publishing to the Ocean Browser
+
= Acknowledgements =
= Acknowledgements =
-
Funding was provided by SeaDataNet (FP7) and Emodnet Chemistry (DG-MARE).
+
Funding was provided by SeaDataNet (FP7) and EMODnet Chemistry (DG-MARE).
GEBCO project is acknowledged for providing the GEBCO world map, [http://www.gebco.net/ http://www.gebco.net/]
GEBCO project is acknowledged for providing the GEBCO world map, [http://www.gebco.net/ http://www.gebco.net/]
 +
 +
[[Category:OceanBrowser]]

Latest revision as of 09:37, 6 December 2018

OceanBrowser is a web-service that allows the on-line visualisation of gridded fields. It is used in SeaDataNet (http://gher-diva.phys.ulg.ac.be/web-vis/) and chemical data in EMODnet (http://gher-diva.phys.ulg.ac.be/emodnet/).

Within the SeaDataNet, SeaDataCloud and EMODnet (Chemical lot) projects, several national ocean data centers have created gridded climatologies of different ocean properties using the data analysis software tools DIVA or DIVAnd. In order to give a common viewing service to those interpolated products, the GHER has developed OceanBrowser which is based on open standards from the Open Geospatial Consortium (OGC), in particular Web Map Service (WMS) and Web Feature Service (WFS). These standards define a protocol for describing, requesting and querying two-dimensional maps at a given depth and time.

Contents

Features

OceanBrowser currently supports the following operations:

  • Horizontal sections of the 4-dimensional fields (longitude, latitude, depth and time) can be visualized at a selected depth and time. The climatological fields can also be interpolated and visualized on arbitrary vertical sections.
  • The maps displayed in the browser are created dynamically and therefore several options are made available to the user to customize the graphical rending of those layers. Layers can be displayed either using interpolated shading, filled contours or simple contours and several options controlling the color-map are also available.
  • The horizontal and vertical sections can be animated in order to study the evolution in time.
  • Image can be saved in raster format (PNG) and vector image formats (SVG, EPS, PDF). It can also be saved as a KML file so that the current layer can be visualized in programs like Google Earth and it can be combined with other information imported in such programs.
  • The underlying 4-dimensional NetCDF file can be either downloaded as a whole from the interface or only as a subset using the linked OPeNDAP server.
  • The web interface can also import third-party layers by using standard WMS requests. The user needs only to specify the URL of the WMS server and its supported version.

Usage

  • Select a domain and variable in the "Add layer/Select data product" dialog. Under the variable name, the variable with two error thresholds (0.3 and 0.5) can be chosen. In "additional fields" the full field without error thresholds are available as well as data distribution (Logarithm10 of number of data in bins), outliers distribution (Logarithm10 of number of outliers data in bins), relative error and the near bottom value (deepest value). A "data bin" is a grid cell of the interpolated grid.
  • To remove a field from the map, click on the "remove" button.
  • After changing the depth and/or time dimension, the map can be refreshed with the "update" button.

File:OceanBrowser_select_data_product.png

  • Several data sets can be visualized at the same time. For example, ocean temperature from the North Sea, Atlantic Ocean and Mediterranean Sea can be visualized at the same time. The consistency of the several ocean products in adjacent regions can be easily assessed and potential problems can be highlighted (Figure 1). This feature is available for horizontal as well for as for vertical sections. By choosing simple contours of one field in combination with filled contours of other field one visually sees the correspondence or location of frontal structures.

Change style

The appearance of the field can be customized by clicking on the style button (config.png) where you can range color map, color range, plot style (flat shading, contours and filled contours).

Style dialog‎

Icons

  • zoom-plus-mini.png: zoom in
  • zoom-minus-mini.png: zoom out
  • zoom-world-mini.png: reset zoom
  • north-mini.png, east-mini.png, south-mini.png, west-mini.png: move to North, East, South or West
  • include-all-layers.png: Change zoom level to include all layers
  • panning-hand-on.png, panning-hand-off.png: panning mode is enabled (default) or disabled
  • drag-rectangle-on.png, drag-rectangle-off.png: zoom by drawing a rectangle is enabled or disabled (default). Click to draw a first corner of the rectangle and then drag it to the desired size.

Horizontal Sections

Per default the surface layer and the first time slice is shown. This can be changed in the depth and time select boxes next to the color bar (on the right). After the choice is confirmed by clicking on 'Update', the map is redrawn.


The location of the observations are shown with a marker on the map. The marker is semi-transparent so that stronger colors give an indication of density of the observations at the particular location.

Vertical section

  • Vertical sections can be extracted by selecting the corresponding tab on the upper left.
  • The overview map shows the same time instance and depth levels as the horizontal view (which is the the first time instance of the surface layer per default).
  • With a mouse a section can be draw in the overview map. A simple click starts a section or adds a point and double-click finishes it.
  • After a section is finished it will appear, the field will be interpolated onto the requested section and drawn in the central part (labeled "vertical section" in the figure below). The coordinates of this plots are distance in arc degrees from the starting point (1 arc degree is always equal to 1 degree in the North-South direction and approximately 111 km) and depth (0 is the surface and value are negative in water).

Instead of drawing a section by the mouse, one can generate a section based on a fixed distance from coast or depth. The corresponding option has be chosen in "Interaction mode". The work-flow is illustrated in the following figure. As multiple disconnected line segments are at a fixed distance form coast (or constant ocean depth). One has the select by the mouse in the overview map the desired section.

Downloading data products

You can open the download dialog by clicking on the download icon (download.png) next to the color bar. You can either download the data (netCDF or OPeNDAP) or download images for the current layer.

Data products

Data products can be downloaded as NetCDF files by using the button labeled "Download NetCDF". A NetCDF file will contain the DIVA analysis for a single parameter as well as meta data as NetCDF attributes. User can also download subset of the data products by using the button "OPeNDAP Service". By click this button, a new window will open with the attributes of the NetCDF file. The URL of this window need to be copied into your OPeNDAP application.


File:OceanBrowser_download.png

Useful software to access the data in netCDF/OPeNDAP are:

ncBrowse
A Graphical netCDF File Browser
Panoply
netCDF, HDF and GRIB Data Viewer
Ncview
a netCDF visual browser


Bulk downloading

If you want to download all NetCDF files for a specific zone you can use the command wget. For example to download the all analyses from EMODNET Chemistry from the Baltic Sea you can use:


wget -nH --cut-dirs=2 -np -r -A '*nc' 'http://ec.oceanbrowser.net/data/emodnet-domains/Baltic Sea/'


Replace "Baltic Sea", to download the data for a different region. The names of the regions can be seen here for EMODNET Chemistry and here for SeaDataNet. This command will preserve the subdirectory structure.

wget is generally already installed in Linux. Windows user can install it from here and Mac OS X user can use Homebrew, for example.

Images

It is also possible to download the current view as an image file by specifying the width and height of the image and the longitude and latitude range.

Future outlook

The upcoming HTML5 standard brings a large range of new features to modern web browsers which will also be useful to visualize ocean data. WebGL is a technology which allows displaying 3 dimensional data in a web browser using hardware acceleration. An experimental JavaScript library, called EarthGL (figure 2), has been developed which allows displaying horizontal and vertical sections of ocean fields on a globe with realistic topography. This JavaScript library is strongly inspired by OpenLayers and should be familiar to developers using the library. WebGL is implemented by the current version of all major browsers as long as the graphics drivers supports WebGL.

Additional information

Feedback

Question and comments can be addressed to Alexander Barth (a dot barth at ulg dot ac dot be)


Source code

OceanBrowser is combined with a software called "Diva on web". Both can be installed following the instruction detailed here.

Acknowledgements

Funding was provided by SeaDataNet (FP7) and EMODnet Chemistry (DG-MARE).

GEBCO project is acknowledged for providing the GEBCO world map, http://www.gebco.net/

Personal tools