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.
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
- CVAT internal job ID for the video data being annotated.
- Date and time that the last change to the annotations was saved.
- 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.
Provenance
Flywheel supports data provenance of the exported annotation file.
- The file metadata field
cvat.task_id
will match between the source video file, and the exported annotation file. - The file origin information for the exported annotation file is set to the user who initiated the export from CVAT