PROTOTYPE IOOS® Sensor Observation Service (SOS)

Link to SOS server:

• URL Prefix - http://sdf.ndbc.noaa.gov/sos/server.php - append arguments as described below:
• http://sdf.ndbc.noaa.gov/sos/test.shtml - for exercising NDBC SOS server via POST

Available Functions:

• GetCapabilities - This function returns metadata about this service.
  (Not fully implemented.)
  Parameters include:
  • request = GetCapabilities
  • service = SOS
• DescribeSensor - This function returns detailed sensor charactertistics.
  (Not fully implemented. Only returns position at this time.)
  Parameters include:
  • request = DescribeSensor
  • OutputFormat = text/xml;subtype="sensorML/1.0.0"
  • procedure = urn of sensor to describe (see procedure in GetCapabilities response)
  • service = SOS
  • version = 1.0.0
• GetObservation - This function returns observation data of the specified type for the stations within the specified start and stop dates.
  (Not fully implemented - Collections are not available for currents.)
  Parameters include:
  • request = GetObservation
  • service = SOS
  • version = 1.0.0
  • offering = urn:x-noaa:def:station:noaa.nws.ndbc::<station ID> for single station or urn:x-noaa:def:network:noaa.nws.ndbc::all for use with collections. Other networks may be added in the future.
  • observedproperty = one of the following:
    • Currents
    • Salinity
    • WaterLevel
    • WaterTemperature
    • Waves
    • Winds
  • responseformat = one of the following:
    • text/xml;schema="ioos/0.6.1"
    • application/ioos+xml;version=0.6.1
  • eventtime (optional parameter) = <DateTime or DateTime1/DateTime2>
    • DateTime is formatted as 2008-06-04-T00:00:00Z or 2008-06-04-T00:00Z. At this time, only the seconds are optional.
    • When this parameter is omitted, the most recent observation is returned.
  • featureofinterest (optional parameter) = one of the following:
    • A bounding box coded as: BBOX:<min_lon>,<min_lat>,<max_lon>,<max_lat>
    • A named feature of interest from the getCapabilities response. NDBC currently supports only DART® (tsunami event) features of interest. You can view data from these named features of interest on the Feature of Interest Demonstration Page.

Sample Requests

GetCapabilities

• GetCapabilities

DescribeSensor

• DescribeSensor for adcp0 sensor on 41012
• DescribeSensor for station 41012

Water Level

• Single Station Requests
  • GetObservation for a single point - Station 46403, most recent water level observation
  • GetObservation for a single point - Station 46403 water level observations for a specific time
  • GetObservation for a single point - Station 46403 water level observations for a time range
• Collection Requests
  • GetObservation for all stations in the network, most recent water level observation
  • GetObservation for all stations in the network, water level observation for a specific time
  • GetObservation for all stations in the network, water level observation for a time range
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 35N 65W, most recent water level observation
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 35N 65W, water level observation for a specific time
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 35N 65W, water level observation for a time range

Water Temperature

• Single Station Requests
  • GetObservation for a single point - Station 41012, most recent water temperature observation
  • GetObservation for a single point - Station 41012, water temperature observation for a specific time
  • GetObservation for a single point - Station 41012, water temperature observation for a time range
• Collection Requests
  • GetObservation for all stations in the network, most recent water temperature observation
  • GetObservation for all stations in the network, water temperature observation for a specific time
  • GetObservation for all stations in the network, water temperature observation for a time range
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, most recent water temperature observation
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, water temperature observation for a specific time
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, water temperature observation for a time range

Salinity

• Single Station Requests
  • GetObservation for a single point - Station 41012, most recent salinity observation
  • GetObservation for a single point - Station 41012, salinity observation for a specific time
  • GetObservation for a single point - Station 41012, salinity observation for a time range
• Collection Requests
  • GetObservation for all stations in the network, most recent salinity observation
  • GetObservation for all stations in the network, salinity observation for a specific time
  • GetObservation for all stations in the network, salinity observation for a time range
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 35N 70W, most recent salinity observation
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 35N 70W, salinity observation for a specific time
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 35N 70W, salinity observation for a time range

Winds

• Single Station Requests
  • GetObservation for a single point - Station 41012, most recent winds observation
  • GetObservation for a single point - Station 41012, winds observation for a specific time
  • GetObservation for a single point - Station 41012, winds observation for a time range
• Collection Requests
  • GetObservation for all stations in the network, most recent winds observation
  • GetObservation for all stations in the network, winds observation for a specific time
  • GetObservation for all stations in the network, winds observation for a time range
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, most recent winds observation
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, winds observation for a specific time
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, winds observation for a time range

Waves

• Single Station Requests
  • GetObservation for a single point - Station 42002, most recent waves observation
  • GetObservation for a single point - Station 42002, waves observation for a specific time
  • GetObservation for a single point - Station 42002, waves observation for a time range
• Collection Requests
  • GetObservation for all stations in the network, most recent waves observation
  • GetObservation for all stations in the network, waves observation for a specific time
  • GetObservation for all stations in the network, waves observation for a time range
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, most recent waves observation
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, waves observation for a specific time
  • GetObservation for all stations in the network within a bounding box starting at 25N 90W and ending at 30N 85W, waves observation for a time range

Ocean Currents

• Single Station Requests
  • GetObservation for a single point - Station 46088, most recent ocean currents observation
  • GetObservation for a single point - Station 46088 ocean currents for a specific time
  • GetObservation for a single point - Station 46088 ocean currents for a time range
  • GetObservation for a vertical profile - Station 41012, most recent ocean currents observation
  • GetObservation for an ocean currents vertical profile - Station 41012 for a specific time
  • GetObservation for an ocean currents vertical profile - Station 41012 for a time range
  • GetObservation for a vertical profile - Station 42361, most recent ocean currents observation with additional quality metadata - still need method to define quality flag meanings. For now they are listed below:

    The nine quality flags represent the results of the following quality tests based on their position (left to right) in the flags field:

    • Flag 1 represents the overall bin status.
    • Flag 2 represents the ADCP Built-In Test (BIT) status.
    • Flag 3 represents the Error Velocity test status.
    • Flag 4 represents the Percent Good test status.
    • Flag 5 represents the Correlation Magnitude test status.
    • Flag 6 represents the Vertical Velocity test status.
    • Flag 7 represents the North Horizontal Velocity test status.
    • Flag 8 represents the East Horizontal Velocity test status.
    • Flag 9 represents the Echo Intensity test status.

    Valid flag values are:

    • 0 = quality not evaluated;
    • 1 = failed quality test;
    • 2 = questionable or suspect data;
    • 3 = good data/passed quality test; and
    • 9 = missing data.
• Collection Requests - Collections are now available for ocean currents data on a limited basis. Our system is capable of rendering currents data for 5-7 stations and one days worth of data. We are working to improve our services and will provide updates as soon as possible.
  • GetObservation for all stations in the network, most recent ocean currents observation
  • GetObservation for all stations in the network, ocean currents observation for a specific time
  • GetObservation for all stations in the network within a bounding box starting at 28N 89.5W and ending at 28.5N 89W, most recent ocean currents observation
  • GetObservation for all stations in the network within a bounding box starting at 28N 89.5W and ending at 28.5N 89W, ocean currents observation for a specific time
  • GetObservation for all stations in the network within a bounding box starting at 28N 89.5W and ending at 28.5N 89W, ocean currents observation for a time range

Sample page using XSL

There is a sample page which fetches the most recent ocean currents observation for a given station via a GET method and transforms the XML via XSL to HTML for display in the browser. Some sample links are:

• Sample XSL transform for 46088 - Single Point
• Sample XSL transform for 41012 - Vertical Profile
• Sample XSL transform for 42361 - Longer Vertical Profile

Station List

IOOS® DIF Station List

PowerPoint Presentation

NDBC presentation on IOOS® DIF SOS project

Alternate Data Access

Access data via map
Access data via KML (Temporary Demo)