Importing Cloud (Remote) Assets
Overview of importing publicly available assets into Ango Hub
Last updated
Overview of importing publicly available assets into Ango Hub
Last updated
Administrators and project managers can import files (i.e. assets) to Ango Hub without them ever leaving their current storage location.
You may import both publicly available assets this way (e.g. public, open links to files, like, for example, ) or assets located in private buckets in AWS S3, Google Cloud Platform, or Microsoft Azure.
The main difference between importing data from cloud storage services and using drag-and-drop is the file location. When , the assets are uploaded to iMerit's private AWS S3 storage in Germany. When importing assets from your own cloud storage, however, your assets are left in your own storage and are never copied anywhere else.
If you are importing public assets, you may start at the .
If you are importing private assets, (i.e. located in private storage buckets in AWS S3, GCP, or Azure), please start at .
Please create a between Ango Hub and your bucket. Instructions on how to do so can be found here:
After having created the storage integration and having saved it in Ango Hub, as per the instructions linked, before moving on to the next steps, please ensure that the bucket you are trying to connect has a CORS policy which allows Ango Hub to display the files. More information on how to set up CORS for your bucket can be found here: .
Ensure your URLs are percent-encoded in the UTF-8 format.
If your filenames contain spaces, for example, ensure they are encoded as %20
, and not as pluses (+
).
For private files in AWS S3 buckets, ensure the region information is present in the URLs you provide in the JSON.
The URL must be in the format
https://<bucket-name>.s3.
<region>
.amazonaws.com/<path-to-file>
If you do not provide region information, Hub will assume the region is us-east-1
.
This is what the minimal working JSON looks like:
If you already have each video's metadata at hand, however, you may choose to provide this metadata in the import JSON such that Ango Hub can skip the metadata check and use the metadata you provided.
The JSON with the optional metadata is as follows:
Videos provided with all of the above metadata will not be processed for metadata and will therefore be available earlier for annotation.
If, however, you'd like to specify batch(es) for individual assets as you import them, you may do so by adding a batches
array property to the JSON like so:
In the case above, the first asset will be added to the batch called batchId1
and the second asset to two batches: batchId1
and batchId2
.
You may include pre-labels as you prepare the JSON for importing assets.
You may add video, image, or text attachments to the assets you are uploading as you prepare the JSON. Attachments will be displayed next to the main asset.
You may make it so that multiple images appear as a carousel to annotators. Images uploaded this way will form 'pages' of a larger asset.
This is useful if you wish for the same annotator to annotate a series of images in a row. It also brings additional benefits such as being able to quickly clone annotations from one image to another, and more.
You may make it so that multiple markdown files appear in a bundle to annotators. Files uploaded this way will form 'pages' of a larger asset.
This is useful if you wish for the same annotator to annotate a series of files in a row.
You may add reference images in such a way that the annotator, while they are annotating the main image, are able to overlay additional reference images on top.
From your project’s dashboard, enter the Assets tab and click on Add Data.
A dialog will pop up. Click on “Cloud Storage” at the top.
Drag the JSON file you would like to upload to the box in the center. Alternatively, click on the box to open your system’s file explorer and select it from there.
Click on the Upload button. Your assets will appear in the Assets tab.
Before importing the assets to Ango Hub, you will need to prepare a JSON file containing each asset’s as well as the asset's full absolute path.
When importing video files, in one of the , Ango Hub performs a metadata check to extract various metadata (e.g. width, height, frame rate, frame total). For large video files, this check can last a few seconds per file – thus if you are importing a very large number of large video files, the metadata check can take a significant amount of time.
You may add custom key-value pairs when uploading each asset. This data, while not displayed in the UI in Ango Hub, will be stored and returned when obtaining the final export. We call this .
Please refer to the for more details about this feature.
are a way Ango Hub allows project managers to logically bundle assets. Batches are like tags you may apply to assets to group them together. You may assign any asset to any number of batches.
If you wish to add all assets you are uploading with the JSON to the same batch, you may do so in from the UI.
See the for more information.
See this docs page on how to accomplish this: .
See this docs page on how to accomplish this: and read more about attachments .
Please see this docs page on how to accomplish this and on more details about multi-page assets:
Please see this docs page on how to accomplish this and on more details about this feature:
Please see this docs page on how to accomplish this and on more details about this feature:
If you are uploading a JSON containing links to private assets, you must also pick the storage integration you created in from the Storage Method dropdown on the left.
It is also possible to upload assets through our .