import

Description of the "darwin dataset import" option from the CLI

This command allows you to import Annotations into an existing RemoteDataset. These Annotations can be in one of the following supported formats:

  • coco
  • dataloop
  • csv_tags
  • csv_tags_video
  • darwin
  • labelbox
  • pascal_voc
  • superannotate
$ darwin dataset import cars darwin /home/annotations/nice_cars_v3/
Fetching remote class list...
Retrieving local annotations ...
Fetching remote file list...
2 annotation file(s) found.
0 classes needs to be created.
0 classes needs to be added to andreas-team/cars
Working... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
Working... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00

If you are importing Annotations that have new AnnotationClasses, a prompt will be displayed to the user, to confirm whether or not the user wants to create the new AnnotationClasses:

2 classes are missing remotely
About to add the following classes
    Class 1, Type: Class type
    Class 2, Type: Class type
Do you want to continue [Y/N]

Note: The target item for the uploaded annotations is determined by the filename field in the annotation file.

❗️

Overwritten annotations

By default, the import command will overwrite any existing annotations with the imported ones. Please use the --append optional argument if you do not want this to happen.

🚧

Ensure your images and videos have been successfully uploaded and processed

Before you import annotations, make sure your target images and videos are marked as New, or have been previously annotated already.

🚧

Import formats

Also make sure to import VideoAnnotation's for video files (and DICOM files) and Annotation's for normal images. If you swap them, the operation will fail.

Positional arguments:

  • dataset: The RemoteDataset we want to import annotation to.
  • format: The format of the annotations to import.
  • files: The location of the annotation files, or the folder where the annotation files are.

Optional arguments:

  • --append: Append annotations instead of overwriting.
  • --yes: Skips prompts for creating and adding classes to dataset.

For example, before the command an empty dataset would look like:

15911591

After running the CLI command, we can now see that the bottom left image and the top right image now have a blue symbol in their bottom left corners, indicating they are being annotated:

15661566

After this step, you can use other CLI commands to move the images into the next stages, or a human can come in and review the annotations manually.


Next up

Having trouble understanding the docs? Have a refresh on V7 Concepts!