SeaTube Annotation Export

Oceans 3.0 API filterdataProductCode=STEXPORT

Formats

The format for this data product is a comma separated values/variables (CSV) file containing annotations. This format is generated on-the-fly, on request in a special search that does not appear in one's Data Search cart. Future improvements may have these requests appear in the Data Search cart under a separate section and/or in a special SeaTube annotation export listing.

The format of these files includes a header, with the name of each value. Each line of the CSV, except the header lines, is an annotation. The header can change, depending on the dive configuration, sensors, etc. If multiple dives are exported there will be multiple headers, with a new header occurring in the middle of the file, ordered by time, increasing downward. Here's an example:

Please note, we can't post the full file here as there are names and email addresses within it (the annotation contributors). The screenshot above only shows a tiny fraction of the file. Here is an example of a file with multiple headers, where a header appears in the middle of the file:

The field names in the header for the values/variables are mostly self-explanatory. If there are questions, please contact us.

Oceans 3.0 API filter: extension=csv

Export Options

For select ROV Camera devices only.

Video snapshots

SeaTube V3's ROV Camera devices can have annotations included in their dives. Users can specify whether they would like to have snapshots at the times corresponding to these video annotations included in their download.

Include

If the user selects to include the video snapshots, a folder of SeaTube images will also be included in the user's download. The number of snapshots corresponds to the number of annotations found within the specified time range.

Oceans 3.0 API filter: dpo_includeVideoSnapshots = 1

Do not include

If the user selects to not include the video snapshots, the download will just include the file with the list of annotations as well as the metadata.

Oceans 3.0 API filter: dpo_includeVideoSnapshots = 0

Discussion

To comment on this product, click Write a comment below.

  • No labels