Asset

This page is about the asset object in Ango Hub's export file. For more information on assets as they are used in Ango Hub, check out the page named Assets.

The asset is the main unit in the Ango Annotation Format. When obtaining an export from Ango Hub, you are essentially getting a list of assets.

This page details assets and their available metadata in the export format.

General Structure

{
   asset, // string, URL to the asset. May be signed.
   assetId, // string, unique ID of the asset (only in multi-page assets)
   dataset, // list, URLs of all the images in the asset (only multi-page assets)
   externalId, // string, externalId of the asset
   metadata, // object, metadata of the asset. See below for more.
   batches, // list, batches to which the asset belongs.
   task // object, information pertaining to labeling task, including annotations and more. See below for more.
}

Asset Object Properties

Property
Description
Example

asset

the URL to the asset. If you have imported the asset as an URL, this will be the same URL. If you have imported it through drag and drop, this will be a signed URL allowing you to, for a period of 120000 seconds from export generation, download it from the Ango Private Bucket where it resides. WARNING: For multi-image assets, the asset URL will point to the first image (page 0) of the multi-image asset. To get the URLs of all images in the asset, parse the dataset list below.

assetId

ID of the asset. Only in multi-image assets.

dataset

URLs of all images in the assets, starting from page 0 onwards. Only in multi-image assets.

externalId

The external ID assigned to the asset at import time.

metadata

Asset metadata is populated at different times depending on the asset type.

If the asset is an image, the width and height of the image in pixels, typically populated when the image is first fully loaded in the labeling editor unless they were provided during import. If the asset is a video, the width/height in pixels of the video, the total number of frames (frameTotal) and the frame rate (frameRate) extracted during asset processing. If the asset is a PDF, the total number of pages, typically populated when the asset is first opened in the labeling editor if it was not already known. If the asset is a DICOM, the total number of frames.

batches

Batches to which the asset belongs.

The information related to the labeling task that was exported attached to this asset. This includes the annotations themselves as well as metadata related to the task (e.g. annotator identity, annotation time/date, etc.) Documentation for the task property can be found here.

Sample Asset

Last updated