Download media and annotations
Tator provides the ability to download media and annotations for use on a local machine. Downloads can be done for a single media or in bulk on many media. When multiple files are being downloaded, Tator streams the files into a zip file on the client side, avoiding the need to package the files into an archive on the backend first. This tutorial will walk you through downloading individual media, multiple media, and annotations using the web interface, then show you how media can be downloaded in python using tator-py.
Download single media
Single media files can be downloaded by clicking the Download file
button under the media card context menu. For videos, the highest resolution archival file will be downloaded if available, otherwise the highest quality streaming file will be downloaded. For images, the highest resolution image will be downloaded.
Download single media annotations
Media attribute values, localizations, and states for a single media can be downloaded using the Download metadata
button under the media card context menu. This will download media types, localization types, and state types in JSON format, and media metadata, localizations, and states in both JSON and CSV format. All of these files are streamed into a zip file.
Download multiple media
All the media in the selected section can be downloaded by clicking the Download media
button under the section context menu. Downloaded media may also be scoped by a search. All media files are streamed into a zip file.
Download multiple media annotations
Annotations for all media in a section can be downloaded by clicking the Download metadata
button under the section context menu. Like media downloads, the downloaded metadata can be scoped by a media search. Media, localizations, states, and corresponding type information is all downloaded and streamed into a zip file.
Large downloads (>5,000 files or 60GB) will result in a warning in the web interface, which can be bypassed by the user. However, it is recommended that large downloads be done using the download_media
utility as described in our developer guide.