OceanBrowser Import Data


Jump to: navigation, search


Gridded field

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:

  • 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.
  • 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.
  • The units attribute is also used and displayed

Grid specification

The netCDF variable that represent the space-time grid must satisfy certain requirements to be recognized:

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)


  • the coordinate variable depth and time should not depend on longitude and latitude
  • 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 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:

netcdf data.nc {
	time = 100 ;
	lon = 70 ;
	lat = 80 ;
	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

Before uploading a file, please:

  • check visually the interpolated field (using for instance software as described here), 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, nco, ...

If you notice strange characters in one of the attribute, you can edit with the command ncatted, available within nco program. Here is a small example:

ncatted -O -a date,global,o,c,2010-08-15 filename.nc
  • date = name of the attribute
  • 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'.

To upload a new file, you need the program sftp (not regular ftp). sftp is default on linux. On Windows you will need a program like WinSCP, putty or FileZilla.

A sample session of uploading a file 'file' in directory 'dir' would be on linux:

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. SeaDataNet file should go in the directory SeaDataNet and EMODNET files, in the directory EMODNET.

XML description generated by divadoxml-gui should be submitted to Sextant following the instructions here: http://www.ifremer.fr/isi/sextant/emodnet-chemistry/EMODNET-CHEMISTRY-QUICKSTART-1.0.pdf. If you have any question about submitting the XML file, you can contact Ifremer at sextant@ifremer.fr.

Observation index files


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:

  1. longitude (in decimal degrees East)
  2. latitude (in decimal degrees North)
  3. start depth (in meters, positive in water)
  4. end depth (in meters, positive in water)
  5. start time (yyyy-mm-ddTHH:MM:SS)
  6. end time (yyyy-mm-ddTHH:MM:SS)
  7. P011-code
  8. absolute URL of the image. If the image should be hosted on our server, the URL has the following structure: http://gher-diva.phys.ulg.ac.be/emodnet-chemistry/images/<institution>/<filename.svg>. 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.
  9. 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      http://gher-diva.phys.ulg.ac.be/emodnet-chemistry/images/OGS/ECOMADR_1_SED_0_AMONAADC.svg 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).


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:


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

Personal tools