GCOOS Data Portal: Advance Data Access

This interface will alllow you to access the GCOOS repository. Users are provided with option to retrieve the data in standard via interactive map or direct access via SOS using the IOOS DIF schema. Please refer to the GCOOS Utility page for more on the services and utilities you may use.

  • Direct Call Interactive
  • Direct Call Instructions
  • SOS Test Server Implementation
  • LDN SOS Test Servers

Data Call Interactive


The following is a form to interactively retrieve data using a form (see the tab on Direct Call Instructions for more on this). To retrieve data, simply provide the inputs and click on the [Retrieve Data] button to generate the CSV file.

Spatial Coverage
(The default values provided are the coordinates for a full coverage of the Gulf of Mexico. You may use the map in the introductory page to get new coordinates if necessary.)
  North  
West
+
East
  South  

Temporal Coverage
(The date input will not be validated when retrieving records.)

  Year Month Day
From
To

Observation
(NOTE: Summary tables will be provided in the future.)

Select the observation to retrieve:

Output Format
(NOTE: Only CSV format is supported to date.)

Select the output format: and sorted by:

 

 

Data Call Instructions


The following is the syntax for direct data retrieval from GCOOS repository.

Syntax:

http://gcoos.rsmas.miami.edu/dp/get_data.php?bbox={1}&start={2}&stop={3}&obs={4}&fmt={5}&sortBy={6}

where:

{1} westlon,southlat,eastlon,northlat, where:

  • westlon = longitude of western edge of bounding box expressed as a floating point number
  • southlat = latitude of southern edge of bounding box expressed as a floating point number
  • eastlon = longitude of eastern edge of bounding box expressed as a floating point number
  • norhtlat = latitude of northern edge of bounding box expressed as a floating point number

{2} start date beginning at 00:00:00 UTC formatted as yyyymmdd

{3} stop date ending at 23:59:59 UTC formatted as yyyymmdd

{4} observation to retrieve

  • current: for the ocean current data (speed, direction, meridional and zonal velocities)
  • water_temperature: for water temperature data
  • salinity: for salintity measurements
  • winds: for winds (speed, direction and gust)
  • air_pressure: for barometric readings
  • air_temperature: for air temperature readings
  • dew_point: for dew point measurements
  • sea_surface_elevation: water level/height/tide readings
  • do: for dissolved oxygens (various water depths and bottom)
  • solar: solar radiations
  • water_level: water level measurements

{5} desired output format. Only csv is currently supported.

{6} ascending sort order:

dates: sort the output by dates;
provider: sorth the ouput by data provider, then dates; or
station: sort the outp by the name of the station.

Example:

To access the water temperature data in the repository for all the Gulf region for the period November 01, 2008 (time: 00:00:00 UTC) to November 15, 2008 (23:59:59 UTC) and sorted by dates, the call should be: http://gcoos.rsmas.miami.edu/dp/get_gcoos_data3.php?bbox=-98.4,21.7,-80.5,31.0&start=20081101&stop=20081115&obs=water_temperature&fmt=csv&sortBy=dates

SOS Implementation


NOTICE! No changes to namespace (URNs) for platforms and sensors will be implemented to this portal while the issue is still being discussed in the community. Changes to the syntactic architecture of the URN will be announced before the implementation.

This SOS Server (http://gcoos.rsmas.miami.edu/dp/sos_server.php) implements the IOOS DIF Schema ver. 0.6.1. Please note the following syntax and parameters for direct access:

GetCapabilities
  Purpose: Returns a metadata for this service
  Status Not fully implemented
  Parameters request = GetCapabilities
    service = SOS
  Example http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetCapabilities&service=SOS
     
DescribeSensor
  Purpose Return sensor characteristics
  Status Not fully implemented
  Parameters request = DescribeSensor
    OutputFormat = text/xml;subtype="sensorML/1.0.0"
    procedure = URN of sensor (see getCapabilities output for sensor's URN)
    service = SOS
    version = 1.0.0 {this is in reference to sensorML ver. 1.0.0}
  Example http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=DescribeSensor&service=SOS&version=1.0.0&outputformat=text/xml;subtype=
%22sensorML/1.0.0%22&procedure=urn:x-noaa:def:sensor:ndbc::42013:1
     
GetObservation
  Purpose Returns observation data for a station within a user-defined time frame
  Status Not fully implemented (bounding box not implemented)
  Parameters request = GetObservation
    service = SOS
    version = 1.0.0
    offering = urn:x-noaa:def:station::<NDBC ID>
    observedproperty=(currents||salinity||waterlevel||watertemperature||winds)
    responseformat=(text/xml;schema="ioos/0.6.1"||application/ioos+xml;version=0.6.1)
    eventtime=(DateTime || DateTime1/DateTime2)
     
  Example

On Water Temperature

(To get most recent water temperature data from station 42050)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42050&observedproperty=waterTemperature&responseformat=text/xml;schema=%22ioos/0.6.1%22

(To get water temperature for a specific time from station 42050)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42050&observedproperty=watertemperature&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-19T03:30Z

(To get water temperature for a time range from station 42050)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42050&observedproperty=watertemperature&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T00:00Z/2008-11-05T00:00Z

On Sea Surface Elevation

(To get most recent sea surface elevation data from station ANCF1)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::ANCF1&observedproperty=waterLevel&responseformat=text/xml;schema=%22ioos/0.6.1%22

(To get sea surface elevation for a specific time from station ANCF1)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::ANCF1&observedproperty=waterlevel&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T02:36Z

(To get sea surface elevation for a time range from station ANCF1)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::ANCF1&observedproperty=waterlevel&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T00:00Z/2008-11-05T00:00Z

On Salinity

(To get most recent salinity data from station SHPF1)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::SHPF1&observedproperty=salinity&responseformat=text/xml;schema=%22ioos/0.6.1%22

(To get salinity for a specific time from station SHPF1)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::SHPF1&observedproperty=salinity&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T15:48Z

(To get salinity for a time range from station SHPF1)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::SHPF1&observedproperty=salinity&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T00:00Z/2008-11-05T00:00Z

On Winds

(To get most recent winds data from station 42047)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42047&observedproperty=winds&responseformat=text/xml;schema=%22ioos/0.6.1%22

(To get winds for a specific time from station 42047)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42047&observedproperty=winds&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-02T21:09Z

(To get winds for a time range from station 42047)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42047&observedproperty=winds&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T00:00Z/2008-11-05T00:00Z

On Ocean Currents

(To get most recent currents data from station 42043)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42043&observedproperty=currents&responseformat=text/xml;schema=%22ioos/0.6.1%22

(To get currents data for a specific time from station 42043)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42043&observedproperty=currents&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T08:30Z

(To get currents data for a time range from station 42043)
http://gcoos.rsmas.miami.edu/dp/sos_server.php?request=GetObservation&service=SOS&offering=urn:x-noaa:def:station:ndbc::42043&observedproperty=currents&responseformat=text/xml;schema=%22ioos/0.6.1%22&eventtime=2008-11-01T00:00Z/2008-11-05T00:00Z

Majority of the GCOOS local data nodes (LDN) have implemented their independent SOS servers. The following is a directory for the SOS implementations and links to schema used. A link is also available to read latest data. The module reads the results of the "GetCapabilities" and list all offerings and requirements and from there, using the "GetObservation" functionality, reads the latest data.

GCOOS Data Providers SOS URL Version and Status
Functional SOS Servers
Dauphin Island Sea Lab, State of Alabama's Marine Science Institution, (DISL) http://gcoos.disl.org/cgi-bin/oostethys_sos.cgi

{Click here to read latest using GCOOS parser.}
OOSTethys Implementation and functional
Texas Coastal Ocean Observation Network (TCOON) http://lighthouse.tamucc.edu/sos/oostethys_sos.cgi

{Click here to read latest using GCOOS parser. WARNING! TCOON is reporting a lot of stations and this request can take 15mins. to complete}
OOSTethys Implementation and functional.
Mote Marine Laboratory (MOTE) http://coolcomms.mote.org/cgi-bin/sos/oostethys_sos.cgi

{Click here to read latest using GCOOS parser.}
OOSTethys Implementation and functional.

Coastal Ocean Monitoring and Prediction System, University of South Florida (COMPS)

http://compsdev1.marine.usf.edu/cgi-bin/sos/v1.0/oostethys_sos.cgi

{Click here to read latest using GCOOS parser. WARNING! COMPS is reporting a lot of stations and this request can take 10mins. to complete}
OOSTethys Implementation and functional.
Central Gulf Ocean Observing System, Department of Marine Science, The University of Southern Mississippi (CenGOOS) http://www.cengoos.org/cgi-bin/oostethys_sos.cgi

{Click here to read latest using GCOOS parser.}
OOSTethys Implementation and functional
SOS Servers still in Development (as of 31 August 2009)
Wave-Current-Surge Information System for Coastal Louisiana, Coastal Studies Institue, Louisiana State University (WAVCIS) http://www.wavcis.lsu.edu/SOS/server.asp

{Click here to read latest using GCOOS parser.}
OOSTethys Implementation and in development.
Texas Automated Buoy System (TABS) http://sos-ws.tamu.edu/tethys/tabs

{Click here to read latest using GCOOS parser.}
OOSTethys Implementation and in development.
Louisiana Universities Marine Consortium (LUMCON)

http://weather.lumcon.edu/sos/server.asp

{Click here to read latest using GCOOS parser.}
OOSTethys Implementation but still in development.