Skip to content

Video Annotation - Persisting Annotations in Flywheel

Introduction

Once video annotations are complete, a user can export the annotation data, which will automatically transfer the annotation data as a file back to the Flywheel Hierarchy, within the same acquisition containing the source video data.

Instructions Steps

Exporting

An export is initiated by selecting "Export job dataset" from the Menu in the top-left of the CVAT Annotation UI. Complete the form according to the options below.

Annotation Export Modal

Export Format

Select the desired file format for the annotations to be written to. The available formats are controlled by the Project Settings in Flywheel.

Save Images

This will export every frame as a PNG file, and include them with the same .zip file as the annotation data file.

The PNG files will be contained in an images folder at the root of the zip file. When the source frames are still image files, they will retain their original sub-folder location and name, but always converted to PNG.

Warning

This can generate extreme amounts of data compared to a source video file. Example: A 5.4 MB mp4 video with 3218 frames can result in a 790 MB zip file.

Custom Name

Provide a file name for the exported annotations. If a custom file name is not provided, a filename will be generated, that will include

  1. CVAT internal job ID for the video data being annotated.
  2. Date and time that the last change to the annotations was saved.
  3. Name of the export data format.

Use Default Settings

Custom export settings are not supported.

Transfer to Flywheel

After initiating the export, the resulting .zip file with the annotations will be automatically transferred back to Flywheel, into the same acquisition that the source video data is located.

cvat_annotation_ui_rectangle_annotations.png

Provenance

Flywheel supports data provenance of the exported annotation file.

  1. The file metadata field cvat.task_id will match between the source video file, and the exported annotation file.
  2. The file origin information for the exported annotation file is set to the user who initiated the export from CVAT

cvat_fw_file_export_file_origin.png

Resources