metadata: a structure array (one structure per device) containing the following metadata fields:
- creationDate:Date and time (using ISO8601 format) that the data product was produced. This is a valuable indicator for comparing to other revisions of the same data product.
- deviceDetails: a structure array with a structure for each deployment, with the following fields:
- deviceDeploymentDateFrom
- deviceDeploymentDateTo
- deviceID: A unique identifier to represent the instrument within the ONC observatory.
- deviceName: A name given to the instrument.
- deviceCategory: A unique name given to the category of devices, such as 'CTD'
- deviceCategoryCode: Code representing the device category. Used for accessing webservices, as described here: API / webservice documentation (log in to see this link).
- deviceCode: A unique string for the instrument which is used to generate instrument search data product file names.
- location: a structure array with a structure for each deployment location, with the following fields:
- stationName: Secondary location name.
- stationCode: Code representing the station. Used for accessing webservices, as described here: API / webservice documentation (log in to see this link).
- depth_metres: Obtained at time of deployment. If NaN, the device is mobile and this position is a variable, the data for which is supplied by a sensor in the data struct.
- lat_degrees: Obtained at time of deployment. If NaN, the device is mobile and this position is a variable, the data for which is supplied by a sensor in the data struct.
- lon_degrees: Obtained at time of deployment. If NaN, the device is mobile and this position is a variable, the data for which is supplied by a sensor in the data struct.
- heading_degrees: Obtained at time of deployment. If NaN, the device is mobile and this position is a variable, the data for which is supplied by a sensor in the data struct.
- pitch_degrees: Obtained at time of deployment. If NaN, the device is mobile and this position is a variable, the data for which is supplied by a sensor in the data struct.
- roll_degrees: Obtained at time of deployment. If NaN, the device is mobile and this position is a variable, the data for which is supplied by a sensor in the data struct.
- dataQualityComments: In some cases, there are particular quality-related issues that are mentioned here. This is distinct from QAQC information contained in the data structure.
- totalScalarSamplesReceived: The number of time stamps that have any valid data on any sensor (at each time stamp). Only defined for metaData(1).totalScalarSamplesReceived, as this total is a summary of all device deployments in the data product.
- Citation: A structure array with citation information, ordered by importance and date. For internal users, go to the Network Console to configure the citations. If a company has more that one role it will be collated. If there are gaps in the date ranges, they are filled in with the default Ocean Networks Canada citation. If the "Citation Required?" field is set to "No" on the Network Console then the citation will not appear. For data products with a citation (except MAT files) and for users making products from a MAT file, if the special citation is blank/null, then the company default citation will be used and if it is also blank/null, then the final citation will consist of the company name and role: "Ocean Networks Canada (Owner, Collaborator)". Here are the fields:
- citation: the citation text, note that if the special citation is blank/null, the default citation is used.
- startDate: datenum format
- endDate: datenum format
- companyName
- companyRole