SOCIB Data Center is working on building a data treatment architecture that covers all data stages. This architecture is composed by the following stages: acquisition, processing, quality controls, storage and distribution.
The SDDS is a layer of RESTful web services intended to provides information and data of SOCIB platforms. This layer is located at the distribution stage.
Note that only fixed stations and trajectories are available for now.
description: provides a list of platforms. Each platform entry contains nested information to get access to the NetCDF files that match the parameters of the request
endpoint request paramters:
All the parameters are optional
response format: List platforms provides a list of platforms. Each platform entry contains nested information to get access to the NetCDF files that matches the requirements. Each platform contains the attributes:
Each instrument contains the attributes:
Each deployment contains the attributes:
Each platform product contains the attributes:
Description: Fixed station list provides the deployed platform list of type fixed. Each platform has the attributes:
Each instrument has the attributes:
Each variable has the attributes:
Servlet request: units = the units category to convert the variable units and measure. Three unit categories are allowed, see the unit categories section
Description: By requesting a standard variable name (underscore separated) provides a list of variable entries where the parameter is present. Each entry contains the following information:
Servlet request: parameter = the wanted parameter (http://cf-pcmdi.llnl.gov/documents/cf-standard-names/standard-name-table/current/cf-standard-name-table.html/) given in an underscore separated string. Note that some standard name variables are defined by SOCIB
url: apps.socib.es/DataDiscovery/list-parameter-platforms?parameter=sea_water_temperature
Description: The service provides brief information about the fixed station:
Servlet request: id_platform = the platform id
url: apps.socib.es/DataDiscovery/mooring-details?id_platform=<requested_id_platform>. E.g. apps.socib.es/DataDiscovery/mooring-details?id_platform=14
Description: Fixed station last data (overview mode) provides platform information and the latest most important data, for the four most important variables
Each instrument has the attributes:
Each variable has the attributes:
Servlet request: id_platform = the platform id, mode = overview and units = the units category to convert the variable units and measure. Three unit categories are allowed, see the unit categories section
Description: Fixed station last data (catalog mode) provides the same information than overview mode, but the whole variable collection.
Servlet request: id_platform = the platform id, mode = catalog and units = the units category to convert the variable units and measure. Three unit categories are allowed, see the unit categories section
url: apps.socib.es/DataDiscovery/mooring-last-data?id_platform=<requested_id_platform>&mode=catalog. E.g. apps.socib.es/DataDiscovery/mooring-last-data?id_platform=14&mode=catalog
See the specification of the get variable data service
Description: Fixed station services provides information related to platform data distribution services:
Each instrument has the attributes:
Servlet request: id_platform = the platform id
url: apps.socib.es/DataDiscovery/mooring-services?id_platform=<requested_id_platform>. E.g. apps.socib.es/DataDiscovery/mooring-services?id_platform=14
Description: Fixed station info provides technical information of the platform. This information includes:
Each instrument has the attributes:
Each sensor has the attributes:
Each variable has the attributes:
Servlet request: id_platform = the platform id
Description: List deployments provides the deployed instruments of platforms with data type trajectory or trajectory profile. Each deployment has the attributes
The platform has the attributes
Each instrument has the attributes:
Servlet request:
All the parameters are optional
url: apps.socib.es/DataDiscovery/list-deployments
Description: Deployment info provides the GeoJson feature collection related to a specific deployment. The first feature is LineString type with the trajectory coordinates and a collection of properties (the dataset metadata, from the NetCDF global attributes). The second feature is point type, with the coordinates of the initial deployment and the properties:
The next features are point type, with the coordinates and the properties:
Servlet request:id_platform = the platform id, id_deployment = the deployment id, [ndays = the number of days to be displayed]. If ndays equals 0 or isn't set then return all the trajectory points. [sample = the frequency for providing the point density over the trajectory linestring. E.g. sample=10 means providing 1 point of each 10 points from the latest one]
url: apps.socib.es/DataDiscovery/deployment-info?id_platform=63&id_deployment=67&ndays=30
Description: Deployment profile list provides metadata information about the set of profiles that are contained within the requested deployment. The response is compound of metadata information that describes the deployment, platform information, a list of variables, a list of times and maximum depths of each profile and a feature collection that allows to locate the profiles.
The platform has the attributes
Servlet request:
url: apps.socib.es/DataDiscovery/list-deployment-profiles?id_deployment=163
Description: Deployment profiles info provides metadata and data related to the set of profiles contained within the requested deployment. The response is compound of metadata information that describes the deployment, platform information, a list of variables, a list of times and maximum depths of each profile and a profiles data object containing the requested variables profiles. To discover information needed in the request of this service a previous request to Deployment profiles List must be performed.
The platform has the attributes
Servlet request:
Description: Trajectory list provides the deployed platform list of data type trajectory. Each deployment has the attributes
The platform has the attributes
Each instrument has the attributes:
Servlet request:instrument_type = the instrument type name. Must be one of the following list: Surface-drifter, Profiler-drifter or Glider
url: apps.socib.es/DataDiscovery/list-trajectories
Description: Trajectory info provides the GeoJson feature collection. The first feature is LineString type with the trajectory coordinates and a collection of properties (the dataset metadata, from the NetCDF global attributes). The second feature is point type, with the coordinates of the initial deployment and the properties:
The next features are point type, with the coordinates and the properties:
Servlet request:id_platform = the platform id, id_deployment = the deployment id, [ndays = the number of days to be displayed]. If ndays equals 0 or isn't set then return all the trajectory points. [sample = the frequency for providing the point density over the trajectory linestring. E.g. sample=10 means providing 1 point of each 10 points from the latest one]. If sample equals 0 only the initial and latest point is returned.
url: apps.socib.es/DataDiscovery/trajectory-info?id_platform=63&id_deployment=67&ndays=30
Description: The service provide the variable metadata, data and quality controls in Json and csv format.
The Json format is:
The dataList and qcDataList has the attributes
The csv format is comma separate attributes values of the:
Servlet request:id_deployment = the deployment id (must be given if the platform is a surface drifter, auv or research vessel), id_platform = the platform id, id_instrument = the instrument id (OMIT if is platform product), id_variable = the variable id, [output = {json|csv}]. If non-defined, default value is 50). The output could be json (default) or csv comma separated
Url 1: apps.socib.es/DataDiscovery/variable-plotting-data?id_platform=<requested_platform_id>& id_variable=<requested_variable_id>&output=<output_mode>. E.g. apps.socib.es/DataDiscovery/variable-plotting-data?id_platform=14&id_variable=10477&output=json
Url 2: apps.socib.es/DataDiscovery/variable-plotting-data?id_platform=<requested_platform_id>&id_deployment=<requested_deployment_id>& id_variable=<requested_variable_id>&output=<output_mode>. E.g. apps.socib.es/DataDiscovery/variable-plotting-data?id_platform=113&id_deployment=100&id_instrument=134&id_variable=89932&sample=50
http://apps.socib.es/DataDiscovery/Description: List beaches provides a list of all the sites where the beach monitoring is being performed
Each site contains the following fields
url: apps.socib.es/DataDiscovery/list-beaches
Description: Beach latest images provides the latest images taken by the SIRENA beach video monitoring system installed in the requested site (GET requested):
Returns a list of objects representing each camera installed. Providing the following information for each camera:
Servlet request:
url: apps.socib.es/DataDiscovery/beach-latest-images?code=clm
Description: Beach forecast provides beach site information in a specific (GET requested) site of SWAN forecasting:
Within each time a set of objects indexed by standard name can be found :
Servlet request:code
description: provides a list of media sources. Can be a set of static images produced by a model forecast or a set of static images produced by an HF-Radar. Each media source entry contains nested information about the media sources
endpoint request parameters:
All the parameters are optional
response format: List media sources provides a list of media sources. Each media source contains nested information describing it and contains the following attributes attributes:
Each media parameter contains:
example: http://apps.socib.es/DataDiscovery/list-media-sources?source_type=forecasting
description: provides a the details of a specific media source.
endpoint request parameters:
response format: Media source info provides information to get access to the media products generated by a specific media source. Each response contains nested information describing it and contains the following attributes attributes:
Each media parameter content contains:
example: http://apps.socib.es/DataDiscovery/media-source-info?id=wmopv2¶meter=sea_water_salinity
description: provides a list of the standard names of the most important parameters
response format: List important parameters provides a list of strings representing the names of the standard names of the most important parameters. They're sorted by relevance, the first in the list is the most important.
example: http://apps.socib.es/DataDiscovery/list-important-parameters
The platform or instrument type name param must be one of the following types or subtypes:
CTD
Drifter
Mooring
AUV
GPS
Research Vessel
Thermosalinometer
Velocimeter
The standard names (CF standard names subset) that can be found in the datasets are:
sea_water_temperature
air_temperature
wind_speed
wind_from_direction
water_surface_height_above_reference_datum
air_pressure
sea_water_salinity
sea_water_speed
direction_of_sea_water_velocity
sea_surface_wave_from_direction
sea_surface_wave_significant_height
Description:Three units categories are allowed for the units parameter, each one define the output units for the standard names wind_speed, wind_speed_of_gust, sea_water_speed and platform_speed_wrt_ground:
Platform product: Is the result of deriving new variables from the information collected from different instruments within the platform
Bounding box position: [geospatial_lat_min, geospatial_lat_max, geospatial_lon_min, geospatial_lon_max]