Skip to main content

How to create video annotation jobs

This page will cover how to create jobs to annotate data using timestamps.

Updated over a month ago

In SAVANT, we call “video annotation jobs” any job that requires labelling events in time. If you need to label structures within a frame, consult our guide on creating frame annotation jobs. Bear in mind that for some frame annotation jobs, you will need to have done video annotations, so you may want to read this guide anyway. Before proceeding, make sure that you have already created a project, uploaded data and create an annotation profile, you can consult the guides that we have to complete each of these steps.

Within SAVANT, annotation jobs are always created in batches. So even if you want to annotate a single video, you will still have to create a batch for annotation. You can create video annotation batches from two points in the app: the video registry and the project management page.

Create a video batch from the video registry

Go to the “Videos” tab on the left-hand navigation menu, apply any filters you need, select the videos that you wish to annotate and click on the “Actions” button at the bottom of the screen. There, you will see the option to “Create Video Batches” as shown in the image below.

You will then have to specify:

  1. The project where this batch should be created.

  2. The annotation profile that should be used to annotate this batch.

  3. Batch-specific settings for the labels:

    1. Whether to specify the labels only with the start time. If the toggle is off then the annotator must specify the start and end time for every label.

    2. If only specifying the start time, you are allowed to also specify a default time length for all annotations. If this toggle is off, then annotations will be a single point in time (start time) with no duration (end time not set).

    3. Whether labels will be allowed to overlap in time.

When you are done, click on "create" and you will see a waiting screen while the batch is being created. This usually takes less than a minute. Once the batch is ready it will appear in the list of batches for the project that you selected. You can now navigate to the project and assign users to the annotation jobs within the batch (see guide on managing annotation projects) and they are now able to start annotating (see guide on how to use the video annotation interface).

Create a video annotation batch from the project management page

To do this you will need a list of the video IDs that you want to annotate. You can get this list by copying the video IDs from the video registry or you can copy and paste it from a spreadsheet (where each ID should be in one cell of the workbook).

To create the batch you should navigate to the project page where you want to create it. Click on the “Create batches” button and then “Video batches”. You will be presented with the same options as above, with the difference that you should now paste the list of video IDs in the corresponding box.

When you are done, click on "create" and you will see a waiting screen while the batch is being created. This usually takes less than a minute. Once the batch is ready it will appear in the list of batches for the project that you selected. You can now navigate to the project and assign users to the annotation jobs within the batch (see guide on managing annotation projects) and they are now able to start annotating (see guide on how to use the video annotation interface).

What next

The next step is to annotate the videos using the annotation jobs that you just created.

Did this answer your question?