Meta: a structure array containing the following metadata fields:
- deviceID: A unique identifier to represent the instrument within the Ocean Networks Canada data management and archiving system.
- 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.
- deviceName: A name given to the instrument.
- deviceCode: A unique string for the instrument which is used to generate data product filenames.
- deviceCategory: Device category to list under data search ('Echosounder').
- deviceCategoryCode: Code representing the device category. Used for accessing webservices, as described here: API / webservice documentation (log in to see this link).
- lat: Fixed value obtained at time of deployment. Will be NaN if mobile or if both site latitude and device offset are null. If mobile, sensor information will be available in mobilePositionSensor structure..
- lon: Fixed value obtained at time of deployment. Will be NaN if mobile or if both site longitude and device offset are null. If mobile, sensor information will be available in mobilePositionSensor structure.
- depth: Fixed value obtained at time of deployment. Will be NaN if mobile or if both site depth and device offset are null. If mobile, sensor information will be available in mobilePositionSensor structure.
- deviceHeading: Fixed value obtained at time of deployment. Will be NaN if mobile or if both site heading and device offset are null. If mobile, sensor information will be available in mobilePositionSensor structure.
- devicePitch: Fixed value obtained at time of deployment. Will be NaN if mobile or if both site pitch and device offset are null. If mobile, sensor information will be available in mobilePositionSensor structure.
- deviceRoll: Fixed value obtained at time of deployment. Will be NaN if mobile or if both site roll and device offset are null. If mobile, sensor information will be available in mobilePositionSensor structure.
- siteName: Name corresponding to its latitude, longitude, depth position.
- locationName: The node of the Ocean Networks Canada observatory. Each location contains many sites.
- stationCode: Code representing the station or site. Used for accessing webservices, as described here: API / webservice documentation (log in to see this link).
- 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.
- deploymentDateFrom: The date of the deployment on which the data was acquired.
- deploymentDateTo: The date of the end of the deployment on which the data was acquired (may be omitted if still deployed).
- samplingPeriod: Sampling rate of the instrument in seconds (maybe omitted on some devices that have no scalar sensors). Not included on most instances.
- samplingPeriodDateFrom: matlab datenum of the start of the corresponding sample period (maybe omitted on some devices that have no scalar sensors). Not included on most instances.
- samplingPeriodDateTo: matlab datenum of the end of the corresponding sample period (maybe omitted on some devices that have no scalar sensors). Not included on most instances.
- Attribution: A structure array with Attribution information, ordered by importance and date. For internal users, go to the Network Console to configure the attributions. If an organization has more than 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 "Attribution Required?" field is set to "No" on the Network Console then the citation will not appear. The acknowledgement text for each Attribution will consist of the organization name and role, for example: "Ocean Networks Canada (Owner, Collaborator)". For plots, multiple Attributions are combined using semi-colons and included in the below-plot comment, while in other file-based data products, a comment text is created in the same way but with device type and date ranges added (except for MAT files). Here are the fields:
- acknowledgement: the acknowledgement text, simply <organizationName> (<organizationRole>) .
- startDate: datenum format
- endDate: datenum format
- organizationName
- organizationRole: comma separated list of roles
- roleComment: primarily for internal use, usually used to reference relevant parts of the data agreement (may not appear)
- MobilePositionSensor: A structure with information about sensors that provide additional scalar data on positioning and attitude (latitude, longitidue, depth below sea surface, heading, pitch, yaw, etc).
- name: A cell array of sensor names for mobile position sensors. If not a mobile device, this will be an empty cell string.
- sensorID: An array of unique identifiers of sensors that provide position data for mobile devices - this data may be used in this data product.
- deviceID: An array of unique identifiers of devices that provide position data for mobile devices - this data may be used in this data product.
- dateFrom: An array of datenums denoting the range of applicability of each mobile position sensor - this data may be used in this data product.
- dateTo: An array of datenums denoting the range of applicability of each mobile position sensor - this data may be used in this data product.
- typeName: A cell array of sensor names for mobile position sensors. If not a mobile device, this will be an empty cell string. One of: Latitude, Longitude, Depth, COMPASS_SENSOR, Pitch, Roll.
- offset: An array of offsets between the mobile position sensors' values and the position of the device (for instance, if cabled profiler has a depth sensor that is 1.2 m above the device, the offset will be -1.2m).
- sensorTypeID: An array of unique identifiers for the sensor type.
- correctedSensorID: An array of unique identifiers of sensors that provide corrected mobile positioning data. This is generally used for profiling deployments where the latency is corrected for: CTD casts primarily.
- SamplePeriodSensor: A structure array with an entry for each scalar sensor on the device (even those this metadata is for complex data products that don't use scalar sensors).
- sp: sample period in seconds (array).
- dateFrom: array of date from / start date (inclusive) for each sample period in MATLAB datenum format.
- dateTo: array of date to / end date (exclusive) for each sample period in MATLAB datenum format.
- sampleSize: the number of readings per sample period (array).
- deviceID: array of unique identifiers of devices (should all be the same).
- sensorID: array of unique identifiers of sensors on this device.
- isDeviceLevel: flag (logical) that indicates, when true or 1, if the corresponding sample period/size is from the device-level information (i.e. applies to all sensors and the device driver's poll rate).
- sensorName: the name of the sensor for which the sample period/size applies (much more user friendly than a sensorID).