Attachments

Attachments are media files like text, images, and videos that can be shown to labelers while annotating certain assets.

On Ango Hub, you can upload text, images, or videos to be shown to labelers next to specific assets during labeling.

An attachment (right) shown next to an asset being labeled.

Properties of Attachments

• Text, image, or video files shown next to specific assets

• Viewable by labelers during labeling

• Unique to each asset, that is, you can show data that belongs to the asset being labeled right next to the asset itself

• Uploadable in bulk with a simple JSON structure

• An asset can have an unlimited number of attachments

How to View an Attachment

From the labeling editor, navigate to an asset with an attachment.

Click on the "Attachment" tab on the right side of the screen. (1)

The attachment drawer will open. If more than one attachment was uploaded for the asset in question, each attachment is shown in its own tab. (2)

How to Upload Attachments

From the Assets tab in your project, click on Import. A dialogue will pop up.

Enter the Import Attachment tab.

From here, you'll upload a JSON containing your attachments. Here's what a sample JSON looks like:

[
  {
    "externalId": "image-sample.jpg",
    "attachments": [
      {
        "type": "IMAGE",
        "value": "https://sample-image.jpg"
      },
      {
        "type": "TEXT",
        "value": "Some sample text."
      }
    ]
  },
  {
    "externalId": "image-sample.jpg",
    "attachments": [
      {
        "type": "VIDEO",
        "value": "http://sample-video.mp4"
      }
    ]
  }
]

Only text, images, and videos are supported.

If attachment upload is successful, a notification will pop up on the screen notifying you of how many assets were given an attachment.

Uploading Attachments from Private Buckets

If you have created an integration between Ango Hub and your private bucket, either on AWS S3 or on GCP, you can upload attachments that link to files in your private bucket. The file will never be copied or moved anywhere, and will only be shown to labelers when they open the Attachments drawer.

First, create an integration from the Integration tab of your Organization page. You can read how to do so here.

Then, from the same page, copy the integration ID of your newly created integration, by clicking on the "Copy" button next to the ID:

Prepare a JSON in the same format as the one prepared in the previous section, but with the addition of integration IDs in the URLs. For example:

[
  {
    "externalId": "image-sample.jpg",
    "attachments": [
      {
        "type": "IMAGE",
        "value": "https://sample-image.jpg?integrationId=1234567890"
      },
      {
        "type": "TEXT",
        "value": "Some sample text."
      }
    ]
  },
  {
    "externalId": "image-sample.jpg",
    "attachments": [
      {
        "type": "VIDEO",
        "value": "http://sample-video.mp4?integrationId=1234567890"
      }
    ]
  }
]

Importing Attachments during Asset Import

Hub allows you to import attachments together with assets, at the same time.

To do so, you will have to use the Cloud Import JSON method for importing assets, as explained below:

1. In your project, go to the Assets tab and click on the Add Data button.

2. From the dialog that appears, enter the Upload Data URL tab.

3. Prepare a JSON formatted like the following. It is an array of objects, with each object representing an asset. Each object, then, in its attachments property, will have a list of attachments, like so:

[
    {
        "externalId":"my_external_id",
        "data":"https://url-to.asset/video.mp4",
        "attachments":[
            {"type":"IMAGE","value":"https://angohub-public-assets.s3.amazonaws.com/uploaded-data-6cbc3c56-58f9-4430-990d-863bd5a1a755.jpg"},
            {"type":"TEXT","value":"This is a text attachment."}
        ]
    }
]

4. Drag and drop the JSON you've just created on the Upload Data URL file box:

5. Your assets with attachments will appear in the Assets tab.