Distributed Oceanographic Matchup Service (DOMS)
DOMS API
| Data Subsetting API | ||
| In Situ Data | ||
| End Point | Description | Sample Call |
|---|---|---|
| http://rda-data.ucar.edu:8890/ws/search/icoads | International Comprehensive Ocean-Atmosphere Data Set (ICOADS) Release 3, Individual Observations | http://rda-data.ucar.edu:8890/ws/search/icoads?startTime=2012-08-01T00:00:00Z&... |
| http://doms.coaps.fsu.edu/ws/search/samos | Shipboard Automated Meteorological and Oceanographic System (SAMOS) Data | http://doms.coaps.fsu.edu/ws/search/samos?startTime=2012-08-01T00:00:00Z&... |
| https://doms.jpl.nasa.gov/ws/search/spurs | Salinity Processes in the Upper Ocean Regional Study - 1 (SPURS-1) Data | https://doms.jpl.nasa.gov/ws/search/spurs?startTime=2012-08-01T00:00:00Z&... |
| https://doms.jpl.nasa.gov/ws/search/spurs2 | Salinity Processes in the Upper Ocean Regional Study - 2 (SPURS-2) Data | https://doms.jpl.nasa.gov/ws/search/spurs2?startTime=2016-07-01T00:00:00Z&... |
| Parameter | Required | Sample | Note |
|---|---|---|---|
| startTime | optional | 2012-08-01T00:00:00Z | start time in the format of YYYY-MM-DDTHH:mm:ssZ |
| endTime | optional | 2013-10-31T23:59:59Z | end time in the format of YYYY-MM-DDTHH:mm:ssZ |
| bbox | optional | -45,15,-30,30 | bounding box with coordinates specified in this order: west, south, east, north |
| variable | optional | sss | sst, sss, or wind |
| minDepth | optional | -5 | minimum depth value in meters |
| maxDepth | optional | 5 | maximum depth value in meters |
| platform | optional | 1 | platform ID |
| startIndex | optional | 0 | start index of entries in the result; used for pagination; default is 0 |
| itemsPerPage | optional | 10 | number of results per page; default is 10 |
| pretty | optional | true | return formatted results if set to true |
| Data Matchup API | ||
| End Point | Description | Sample Call |
|---|---|---|
| https://doms.jpl.nasa.gov/nexus/domslist | Provides a list of available data sets | https://doms.jpl.nasa.gov/nexus/domslist |
| https://doms.jpl.nasa.gov/nexus/domsvalues | Fetches stats and data values for the selected in situ source and bounding box | https://doms.jpl.nasa.gov/nexus/domsvalues?source=spurs&... |
| https://doms.jpl.nasa.gov/nexus/match_spark | Executes the data matchup service | https://doms.jpl.nasa.gov/nexus/match_spark?primary=JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1&matchup;=spurs... |
| Parameter | Required | Sample | Note |
|---|---|---|---|
| primary | required | JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1 | The Primary dataset used to find matches for. One of the satellite "shortName" as supplied by https://doms.jpl.nasa.gov/nexus/domslist |
| matchup | required | spurs | The Dataset(s) being searched for measurements that match the measurements in Primary. One or more (comma-separated) of the insitu "name" as supplied by https://doms.jpl.nasa.gov/nexus/domslist |
| startTime | required | 2012-09-25T00:00:00Z | Starting time in format YYYY-MM-DDTHH:mm:ssZ |
| endTime | required | 2012-09-30T23:59:59Z | Ending time in format YYYY-MM-DDTHH:mm:ssZ |
| b | required | -40,25,-45,30 | Minimum (Western) Longitude, Minimum (Southern) Latitude, Maximum (Eastern) Longitude, Maximum (Northern) Latitude |
| platforms | required | 1,2,3,4,5,6,7,8,9 | Platforms to include for matchup consideration |
| depthMin | optional | 0 | Minimum depth of measurements allowed to be considered for matchup |
| depthMax | optional | 5 | Maximum depth of measurements allowed to be considered for matchup |
| tt | optional (default: 86400) | 86400 | Tolerance in time (seconds) when comparing two measurements. |
| rt | optional (default: 1000.0) | 1000.0 | Tolerance in radius (meters) when comparing two measurements |
| parameter | optional (default: sst) | sst | The parameter of interest used for the match up. One of 'sst', 'sss', 'wind'. |
| matchOnce | optional (default: False) | false | True/False flag used to determine if more than one match per primary point is returned. If true, only the nearest point will be returned for each primary point. If false, all points within the tolerances will be returned for each primary point. |
The following output formats are supported: JSON, CSV, NETCDF The JSON output contains a data array of matched observations. Each object in the data array contains the observation from the primary dataset along a matches array that contains the observations from the secondary dataset(s). The CSV output file contains rows of DOMS global attributes followed by rows of matched observations. Each row of matched observations consists of the following columns id, source, lon, lat, time, platform, depth, sea_water_salinity, sea_water_temperature, wind_speed, wind_direction, wind_u, wind_v from the primary dataset and id, source, lon, lat, time, platform, depth, sea_water_salinity, sea_water_temperature, wind_speed, wind_direction, wind_u, wind_v from the secondary dataset(s). Here is a structural diagram of the NetCDF layout:  Each row of each variable array represents a value, with the value being represented the same across rows given the same index. The ‘id’ variable is a numeric unique identifier for each value. The ‘primary_id’ variable either a) is set to -1 if the value is from the primary dataset, or b) to the id of the primary value. Data is inserted in a primary/secondary/secondary/etc order such that each matched set can be delineated by the first value having a primary_id set to -1. Note that the output file format is still work in progress and will change in future releases. | |||
| Data Analytics API | ||
| End Point | Description | Sample Call |
|---|---|---|
| https://doms.jpl.nasa.gov/nexus/stats | Computes time series statistics | https://doms.jpl.nasa.gov/nexus/stats?ds=... |
| Parameter | Required | Sample | Note |
|---|---|---|---|
| ds | required | one of shortName value as supplied by /list | The dataset on which to generate the statistics |
| minLat | required | -90 : 90 | minimum latitude on which to generate statistics |
| maxLat | required | -90 : 90 | maximum latitude on which to generate statistics |
| minLon | required | -180 : 180 | minimum longitude on which to generate statistics |
| maxLon | required | -180 : 180 | maximum longitude on which to generate statistics |
| startTime | required | 1190962800000 | Start time in which to calculate statistics, in milliseconds since epoch (Jan 1st, 1970) |
| endTime | required | 1317193200000 | End time for which statistics will be calculated, in milliseconds since epoch (Jan 1st, 1970) |
| output | optional | JSON | Data formatting for results. Default is ‘JSON’. Alternative is ‘CSV’ for comma-seperated values. |