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.

Structure Overview

{
   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.	"asset": "https://angohub-private-assets.s3.eu-central-1.amazonaws.com/e32d6ab2-d6f7-4e77-b671-88f16ec1f1e8.webm?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20230825%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20230825T070837Z&X-Amz-Expires=120000&X-Amz-Signature=509890db535e004df9286186dcffb680f63af7526956e6dc4f683c3295a0b6e3&X-Amz-SignedHeaders=host&x-id=GetObject"
assetId	ID of the asset. Only in multi-image assets.	"taskId": "64e5e5b985eb730015b4ebd9"
dataset	URLs of all images in the assets, starting from page 0 onwards. Only in multi-image assets.	"dataset": [ "https://angohub-public-assets.s3.eu-central-1.amazonaws.com/3e6e15b9-c32c-4b73-97f9-dbda784926ab.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20231009%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20231009T134740Z&X-Amz-Expires=120000&X-Amz-Signature=70790d6813a471f78f51261006f45971af8c0bb73c5266ed90225da2a7e7d5f6&X-Amz-SignedHeaders=host&x-id=GetObject", "https://angohub-public-assets.s3.eu-central-1.amazonaws.com/8b363eb9-5b7f-414c-89b8-b6907f29447b.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20231009%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20231009T134740Z&X-Amz-Expires=120000&X-Amz-Signature=fab97fcb3a6e457e4acf0525651047942e7349973758b0a533ea03e453bad039&X-Amz-SignedHeaders=host&x-id=GetObject" ]
externalId	The external ID assigned to the asset at import time.	"externalId": "video-webm.webm"
metadata	Asset metadata is automatically fetched by Hub when the asset is first opened in the labeling editor. If the asset is an image, the width and height of the image in pixels. 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) of the video specified during upload. (default 30fps if nothing was specified) If the asset is a PDF, the total number of pages. If the asset is a DICOM, the total number of frames.	// image "metadata": { "width": 1200, "height": 800 } // video "metadata": { "width": 1200, "height": 1200, "frameTotal": 507, "frameRate": 30 } // PDF "metadata": { "width": 1200, "height": 1200, "frameTotal": 507, "frameRate": 30 } // DICOM "metadata": { "width": 512, "height": 512, "frameTotal": 96 }
batches	Batches to which the asset belongs.	"batches": ["batch_1", "batch_2"]
task	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.	"task": { "taskId": "64e5e5b985eb730015b4ebd9", "stage": "Complete", "stageId": "Complete", "updatedAt": "2023-08-23T11:36:38.027Z", "updatedBy": "[e-mail]", "totalDuration": 49596, "tools": [ { "bounding-box": { "x": 301.6699801192843, "y": 429.05027932960894, "height": 173.76536312849163, "width": 118.09145129224652 }, "objectId": "765742a3b676d3f26898792", "classifications": [], "metadata": { "createdAt": "2023-08-23T11:20:32.792Z", "createdBy": "[e-mail]", "createdIn": "Label" }, "schemaId": "b1c6805d054f0e44ae11500", "page": 504, "title": "bb" } ], "classifications": [ { "objectId": "3d5cd10ba190b29d2850724", "schemaId": "6421df1fa34ac13204ea157", "tool": "radio", "title": "rdo", "answer": "1", "metadata": { "createdAt": "2023-08-23T11:20:51.725Z", "createdBy": "[e-mail]", "createdIn": "Label" }, "classifications": [] } ], "relations": [ { "from": "9f4487231d385821865b486", "to": "9a1311e463600e8eb98f342", "objectId": "73b8926ffd17e3b000e4752", "schemaId": "8f8e617174718e80bbea268", "direction": "straight", "metadata": { "createdAt": "2023-08-23T11:32:33.752Z", "createdBy": "[e-mail]", "createdIn": "Label" }, "page": 0, "title": "sng" } ], "stageHistory": [ { "stage": "Start", "stageId": "Start", "duration": 0, "completedAt": "2023-08-23T10:55:53.495Z", "tools": [], "classifications": [], "relations": [] }, { ... } ] }

Sample Asset

{
  "asset": "https://angohub-private-assets.s3.eu-central-1.amazonaws.com/e32d6ab2-d6f7-4e77-b671-88f16ec1f1e8.webm?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20230825%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20230825T070837Z&X-Amz-Expires=120000&X-Amz-Signature=509890db535e004df9286186dcffb680f63af7526956e6dc4f683c3295a0b6e3&X-Amz-SignedHeaders=host&x-id=GetObject",
  "externalId": "video-webm.webm",
  "metadata": {
    "frameTotal": 507,
    "frameRate": 30
  },
  "batches": [],
  "task": {
    "taskId": "64e5e5b985eb730015b4ebd9",
    "stage": "Complete",
    "stageId": "Complete",
    "updatedAt": "2023-08-23T11:36:38.027Z",
    "updatedBy": "[e-mail]",
    "totalDuration": 49596,
    "tools": [
      {
        "bounding-box": {
          "x": 301.6699801192843,
          "y": 429.05027932960894,
          "height": 173.76536312849163,
          "width": 118.09145129224652
        },
        "objectId": "765742a3b676d3f26898792",
        "classifications": [],
        "metadata": {
          "createdAt": "2023-08-23T11:20:32.792Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "schemaId": "b1c6805d054f0e44ae11500",
        "page": 504,
        "title": "bb"
      },
      {
        "polygon": [
          [
            593.6779324055666,
            1121.9664804469273
          ],
          [
            443.3797216699801,
            1349.36312849162
          ],
          [
            576.5009940357853,
            1375.1061452513966
          ]
        ],
        "objectId": "408deff4664cc342d236127",
        "classifications": [],
        "metadata": {
          "createdAt": "2023-08-23T11:20:37.127Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "schemaId": "a966c7799383465850cd803",
        "page": 504,
        "title": "gon"
      },
      {
        "objectId": "765742a3b676d3f26898792",
        "schemaId": "b1c6805d054f0e44ae11500",
        "classifications": [],
        "bounding-box": {
          "x": 801.948310139165,
          "y": 1428.7374301675977,
          "height": 173.76536312849163,
          "width": 118.09145129224652
        },
        "metadata": {
          "createdAt": "2023-08-23T11:20:40.952Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "page": 506,
        "title": "bb"
      },
      {
        "objectId": "408deff4664cc342d236127",
        "schemaId": "a966c7799383465850cd803",
        "classifications": [],
        "polygon": [
          [
            217.93240556660038,
            229.54189944134077
          ],
          [
            67.63419483101391,
            456.9385474860335
          ],
          [
            200.75546719681907,
            482.68156424581
          ]
        ],
        "metadata": {
          "createdAt": "2023-08-23T11:20:42.215Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "page": 506,
        "title": "gon"
      }
    ],
    "classifications": [
      {
        "objectId": "3d5cd10ba190b29d2850724",
        "schemaId": "6421df1fa34ac13204ea157",
        "tool": "radio",
        "title": "rdo",
        "answer": "1",
        "metadata": {
          "createdAt": "2023-08-23T11:20:51.725Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "classifications": []
      },
      {
        "objectId": "f4e53917c222c8e62dbb715",
        "schemaId": "1ea7a275ce5c9cf30a6f148",
        "tool": "checkbox",
        "title": "chk",
        "answer": [
          "1"
        ],
        "metadata": {
          "createdAt": "2023-08-23T11:20:52.716Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "classifications": []
      },
      {
        "objectId": "0b057a52a2bb648b197f180",
        "schemaId": "a2b4a50bb90eb6523b88376",
        "tool": "single-dropdown",
        "title": "sdr",
        "answer": "1",
        "metadata": {
          "createdAt": "2023-08-23T11:20:54.180Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "classifications": []
      },
      {
        "objectId": "19ae5491832a3bd42704684",
        "schemaId": "11f6ed8e4ac4852d3422341",
        "tool": "multi-dropdown",
        "title": "mdr",
        "answer": [
          "1"
        ],
        "metadata": {
          "createdAt": "2023-08-23T11:20:55.684Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "classifications": []
      },
      {
        "objectId": "7ed41243066d9b09e652723",
        "schemaId": "c2b5eb27e55b186f84f3898",
        "tool": "tree-dropdown",
        "title": "tre",
        "answer": [
          "1",
          "1 / 2"
        ],
        "metadata": {
          "createdAt": "2023-08-23T11:20:59.723Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label",
          "updatedAt": "2023-08-23T11:21:01.940Z",
          "updatedBy": "[e-mail]",
          "updatedIn": "Label"
        },
        "classifications": []
      },
      {
        "objectId": "bde3bab1fbdbcecdc891100",
        "schemaId": "6590a72d09f1760a4578032",
        "tool": "text",
        "title": "txt",
        "answer": "2",
        "metadata": {
          "createdAt": "2023-08-23T11:21:01.100Z",
          "createdBy": "[e-mail]",
          "createdIn": "Label"
        },
        "classifications": []
      }
    ],
    "relations": [],
    "stageHistory": [
      {
        "stage": "Start",
        "stageId": "Start",
        "duration": 0,
        "completedAt": "2023-08-23T10:55:53.495Z",
        "tools": [],
        "classifications": [],
        "relations": []
      },
      {
        "stage": "Label",
        "stageId": "Label",
        "duration": 46753,
        "completedAt": "2023-08-23T11:21:04.393Z",
        "completedBy": "[e-mail]",
        "tools": [
          {
            "bounding-box": {
              "x": 301.6699801192843,
              "y": 429.05027932960894,
              "height": 173.76536312849163,
              "width": 118.09145129224652
            },
            "objectId": "765742a3b676d3f26898792",
            "classifications": [],
            "schemaId": "b1c6805d054f0e44ae11500",
            "page": 504,
            "title": "bb"
          },
          {
            "polygon": [
              [
                593.6779324055666,
                1121.9664804469273
              ],
              [
                443.3797216699801,
                1349.36312849162
              ],
              [
                576.5009940357853,
                1375.1061452513966
              ]
            ],
            "objectId": "408deff4664cc342d236127",
            "classifications": [],
            "schemaId": "a966c7799383465850cd803",
            "page": 504,
            "title": "gon"
          },
          {
            "objectId": "765742a3b676d3f26898792",
            "schemaId": "b1c6805d054f0e44ae11500",
            "classifications": [],
            "bounding-box": {
              "x": 801.948310139165,
              "y": 1428.7374301675977,
              "height": 173.76536312849163,
              "width": 118.09145129224652
            },
            "page": 506,
            "title": "bb"
          },
          {
            "objectId": "408deff4664cc342d236127",
            "schemaId": "a966c7799383465850cd803",
            "classifications": [],
            "polygon": [
              [
                217.93240556660038,
                229.54189944134077
              ],
              [
                67.63419483101391,
                456.9385474860335
              ],
              [
                200.75546719681907,
                482.68156424581
              ]
            ],
            "page": 506,
            "title": "gon"
          }
        ],
        "classifications": [
          {
            "objectId": "3d5cd10ba190b29d2850724",
            "schemaId": "6421df1fa34ac13204ea157",
            "tool": "radio",
            "title": "rdo",
            "answer": "1",
            "classifications": []
          },
          {
            "objectId": "f4e53917c222c8e62dbb715",
            "schemaId": "1ea7a275ce5c9cf30a6f148",
            "tool": "checkbox",
            "title": "chk",
            "answer": [
              "1"
            ],
            "classifications": []
          },
          {
            "objectId": "0b057a52a2bb648b197f180",
            "schemaId": "a2b4a50bb90eb6523b88376",
            "tool": "single-dropdown",
            "title": "sdr",
            "answer": "1",
            "classifications": []
          },
          {
            "objectId": "19ae5491832a3bd42704684",
            "schemaId": "11f6ed8e4ac4852d3422341",
            "tool": "multi-dropdown",
            "title": "mdr",
            "answer": [
              "1"
            ],
            "classifications": []
          },
          {
            "objectId": "7ed41243066d9b09e652723",
            "schemaId": "c2b5eb27e55b186f84f3898",
            "tool": "tree-dropdown",
            "title": "tre",
            "answer": [
              "1",
              "1 / 2"
            ],
            "classifications": []
          },
          {
            "objectId": "bde3bab1fbdbcecdc891100",
            "schemaId": "6590a72d09f1760a4578032",
            "tool": "text",
            "title": "txt",
            "answer": "2",
            "classifications": []
          }
        ],
        "relations": []
      },
      {
        "stage": "Review",
        "stageId": "5e8f78a7-ef6a-473d-b02f-f4024c9ee486",
        "duration": 2843,
        "reviewStatus": "Accepted",
        "completedAt": "2023-08-23T11:36:38.074Z",
        "completedBy": "[e-mail]",
        "tools": [
          {
            "bounding-box": {
              "x": 301.6699801192843,
              "y": 429.05027932960894,
              "height": 173.76536312849163,
              "width": 118.09145129224652
            },
            "objectId": "765742a3b676d3f26898792",
            "classifications": [],
            "schemaId": "b1c6805d054f0e44ae11500",
            "page": 504,
            "title": "bb"
          },
          {
            "polygon": [
              [
                593.6779324055666,
                1121.9664804469273
              ],
              [
                443.3797216699801,
                1349.36312849162
              ],
              [
                576.5009940357853,
                1375.1061452513966
              ]
            ],
            "objectId": "408deff4664cc342d236127",
            "classifications": [],
            "schemaId": "a966c7799383465850cd803",
            "page": 504,
            "title": "gon"
          },
          {
            "objectId": "765742a3b676d3f26898792",
            "schemaId": "b1c6805d054f0e44ae11500",
            "classifications": [],
            "bounding-box": {
              "x": 801.948310139165,
              "y": 1428.7374301675977,
              "height": 173.76536312849163,
              "width": 118.09145129224652
            },
            "page": 506,
            "title": "bb"
          },
          {
            "objectId": "408deff4664cc342d236127",
            "schemaId": "a966c7799383465850cd803",
            "classifications": [],
            "polygon": [
              [
                217.93240556660038,
                229.54189944134077
              ],
              [
                67.63419483101391,
                456.9385474860335
              ],
              [
                200.75546719681907,
                482.68156424581
              ]
            ],
            "page": 506,
            "title": "gon"
          }
        ],
        "classifications": [
          {
            "objectId": "3d5cd10ba190b29d2850724",
            "schemaId": "6421df1fa34ac13204ea157",
            "tool": "radio",
            "title": "rdo",
            "answer": "1",
            "classifications": []
          },
          {
            "objectId": "f4e53917c222c8e62dbb715",
            "schemaId": "1ea7a275ce5c9cf30a6f148",
            "tool": "checkbox",
            "title": "chk",
            "answer": [
              "1"
            ],
            "classifications": []
          },
          {
            "objectId": "0b057a52a2bb648b197f180",
            "schemaId": "a2b4a50bb90eb6523b88376",
            "tool": "single-dropdown",
            "title": "sdr",
            "answer": "1",
            "classifications": []
          },
          {
            "objectId": "19ae5491832a3bd42704684",
            "schemaId": "11f6ed8e4ac4852d3422341",
            "tool": "multi-dropdown",
            "title": "mdr",
            "answer": [
              "1"
            ],
            "classifications": []
          },
          {
            "objectId": "7ed41243066d9b09e652723",
            "schemaId": "c2b5eb27e55b186f84f3898",
            "tool": "tree-dropdown",
            "title": "tre",
            "answer": [
              "1",
              "1 / 2"
            ],
            "classifications": []
          },
          {
            "objectId": "bde3bab1fbdbcecdc891100",
            "schemaId": "6590a72d09f1760a4578032",
            "tool": "text",
            "title": "txt",
            "answer": "2",
            "classifications": []
          }
        ],
        "relations": []
      }
    ]
  }
}