...
| Term | Definition |
|---|---|
begin | A dataProductDelivery service filter that represents the starting datatime of a time interval for a data product request. Example: &begin=2015-04-24T00:00:01.000Z |
beginDeployment | A web service filter that represents the starting datetime of a time interval for a deployment. Example: &beginDeployment=2015-04-24T00:00:01.000Z |
bbox | A 3D Bounding Box, representing the minimum and maximum extents (latitude, longitude, depth) of all geographic features in a collection. Example: "bbox":{"maxDepth":987.0,"maxLat":48.316839,"maxLon":-126.0501233333,"minDepth":981.0,"minLat":48.3165166667,"minLon":-126.050872} |
cvTerm | A web service output value that represents a controlled vocabulary term for the specific item. Example: "cvTerm":{"deviceCategory":[{"uri":"http://vocab.nerc.ac.uk/collection/L05/current/130/","vocabulary":"SeaDataNet device categories"}] |
Data Product | Can include both raw data (such as tabular scalar data, manufacturers formats) and visualizations (such as graphs, charts and maps). Data products can also be represented in a number of different formats, such as:
|
Data Product Options | Additional, data product specific, filters that are used to define how the data in a data product is compiled, modified or delivered.
Example: &dataProductCode=TSSD&extension=csv&dpo_qualityControl=1&dpo_resample=none&dpo_dataGaps=0 or "dataProductCode":"TSSD","extension":"csv",'dpo_qualityControl':1,'dpo_resample':'none','dpo_dataGaps':0
|
dataProductCode | A web service filter or output value that represents an abbreviation of a data product name, which acts as a unique identifier for a data product. Example: dataProductCode=TSSD or "dataProductCode":"TSSD"
|
dataProductName | A web service filter or output value that represents the full name of a specific data product, which can be used by a user to identify a specific data product and may be used as a label. Example: &dataProductName=Scalar or "dataProductName":"Time Series Scalar Data" |
dataSearchURL | A locations web service output value that contains a link url to the Oceans 2.0 - Data Search page for a specific location. Example: "dataSearchURL":"http://data.oceannetworks.uvic.ca/DataSearch?location=BACAX" |
Deployment | A specific date range and location that an instrument is connected to ONC network. A deployment is uniquely identified by a deviceCode, a locationCode, begin & end dates and a geographic location (lat, lon, depth). A deployment does not guarantee data availability. An instrument may be connected to the network, but not actively collecting data during portions of a deployment. An instrument my be deployed at multiple locations over its lifespan. |
depth | The distance below the water surface. For a location, depth represents the average depth or centroid of a 3D bounding box encompassing all of the site devices represented in the collection. For a device, depth represents the depth of a specific instrument deployment. Example: "depth":984.3076 |
Device | An instrument that has one or more sensors that observe a property or phenomenon with a goal of producing an estimate of the value of the property. A specific sensor on a device is identified by a property (variable). A Device can have data at the device level or at the property (variable) level. For example A camera's image data is at the device level. A device can be deployed at multiple locations over its lifespan. |
Device Category | A grouping of like devices, such as CTD - Conductivity Temperature (and Depth) sensor. A device category can contain devices from multiple manufactures, for example CTD may contain devices from Sea-Bird, RBR, Alec Electronics, AML, Falmouth. |
deviceCategoryCode | A web service filter or output value that represents an abbreviation of a device category name, which acts as a unique identifier for a device category. Example: &deviceCategoryCode=CTD or "deviceCategoryCode":"CTD"
|
deviceCategoryName | A web service filter or output value that represents the full name of a specific device category, which could be used by a user to identify a specific device category and may be used as a label. Example: &deviceCategoryName=Conductivity or "deviceCategoryName":"Conductivity Temperature (and Depth Sensor)" |
deviceId | A numeric unique identifier for a specific device. Used by DMAS and by some legacy web services and user workflows. Included in the results of a devices web service payload. Example: "deviceId":23599 |
deviceLink | A devices web service output value that contains a link url to the Oceans 2.0 - Device Details page for a specific device. Example: "deviceLink":"http://data.oceannetworks.ca/DeviceListing?DeviceId=11302" |
deviceName | A web service filter or output value that represents the full name of a specific device, which can be used by a user to identify a specific device and may be used as a label. Example: &deviceName=Sea-Bird or "deviceName":"Sea-Bird SeaCAT SBE16plus 4686" |
end | A dataProductDelivery service filter that represents the ending datetime of a time interval for a data product request. Example: &end=2015-04-24T00:05:29.000Z |
endDeployment | A web service filter that represents the ending datetime of a time interval for a deployment. Example: &endDeployment=2015-04-24T00:05:29.000Z |
extension | A web service filter or output value that represents a data product file format. Example: &extension=mat or "extension":"mat"
|
filter | A web service input parameter that is used to define an ONC element (location, device, deviceCategory, property or data product), data or data product. Reductive Filtering is used by all ONC API Discovery web services. Filters are compound and imply AND, therefore an element must match all filter criteria in order to be included in a result set. Data product requests use filters to uniquely define the data representation (ie, data product, format, instrument, date range and data product options). |
filters | A collection of one or more filter items. |
heading | The direction in which the ‘front’ of the platform is facing. It is not necessarily the same as the direction in which it is travelling. |
hasDeviceData | A web service output value boolean (true/false) that indicates if a data product delivery request can be made using a device (by Device or by Device & Property). Example: "hasDeviceData":"true" |
hasPropertyData | A web service output value boolean (true/false) that indicates if a data product delivery request can be made using a primary sensor request (by Location & Property). Example: "hasPropertyData":"false" |
helpDocument | A dataProducts service output value that contains a link url to the Data Product documentation for a specific data product. See Data Products Home for more information. Example: "helpDocument":"https://wiki.oceannetworks.ca/display/DP/1" is the help document url for the "Time Series Scalar Data" data product |
lat | Degrees latitude of a geographic location. Latitude is the angular displacement of a place north or south of the equator. For a location, lat represents the average latitude or centroid of bounding box encompassing all site devices represented in the collection. For a device, lat represents the latitude of a specific instrument deployment. Example:"lat":48.31668927333395 |
Location | The parent of an Ocean's 2.0 Tree Node that you can get data from. More specifically, in the Oceans 2.0 Data Search GUI, a location is a Tree Node that contains device categories (Instruments by Location) or properties (Variables by Location) that can be selected to download data. From the Ocean's 2.0 perspective, a location is a Search Tree Node that has one or more site devices and/or has one or more primary sensors. If there are multiple instruments of the same device category at a location, child-locations or pseudo-nodes will exist and data can be pulled from any one of them. Device Categories can be either at the location or at the child-location level, whereas Properties (variables) can only be at the location level, due to the 'Primary Sensor' concept, which stitches together data from multiple sensors over time at a location. A location represents a feature of interest that can be either at a fixed position, such as a named cluster of instruments on the sea floor, like Axis (POD #1) or above the water, like 'Mill Bay Shore Station' or on a mobile platform, such as the BC Ferries vessel on the 'Tsawwassen - Duke Point' route, a research vessel such as 'R/V Sikuliaq', an ROV such as 'Jason 2' or a Glider. |
locationCode | A web service filter or output value that represents a short abbreviation of a location name, which acts as a unique identifier for a specific location. Example: &locationCode=CQSBG or "locationCode":"CQSBG"
|
locationName | A web service filter or output value that represents the full name of a specific location, which could be used by a user to identify a specific location and may be used as a label. Example: &locationName=Bubbly Gulch or "locationName":"Bubbly Gulch" |
lon | Degree longitude of a geographic location. Longitude is the angular displacement of a place east or west of the meridian at Greenwich, England, or west of the standard meridian of a celestial object. For a location, lon represents the average longitude or centroid of bounding box encompassing all site devices represented in the collection. For a device, lon represents the longitude of a specific instrument deployment. Example: "lon":-126.05033437333402 |
includeChildren | A locations service boolean filter to include all children of a location in the results, in a non-hierarchical representation. Example: &includeChildren=true |
pitch | The side-to-side motion around the transverse axis of the platform. |
Property | The common name given to a sensor type. A property is an observable phenomenon that can be measured to produce an estimated value. A property is also known as a variable. |
propertyCode | A web service filter or output which acts as a unique identifier for a specific property (variable). Example: &property=oxygen or "property":"oxygen" |
propertyName | A web service filter or output value that represents the full name of a specific property, which could be used by a user to identify a specific property and may be used as a label. Example: &propertyName=Pressure or "propertyName":"Pressure" |
roll | The up/down motion around the longitudinal axis of the platform. |
uom | Unit of Measure Example: "uom":"psi" represents "Pounds per sq inch" |