Items and Annotations CLI
  • Dark
    Light
  • PDF

Items and Annotations CLI

  • Dark
    Light
  • PDF

For a full command list go here

Prep

dlp shell #open the dtlpy shell
projects checkout --project-name "my project" #check out to a specific project
datasets checkout --dataset-name "my dataset"  #check out to a specific dataset

Upload Items and Annotations

In this example, all Items are uploading from the folder "5_dogs" located on the local disk (C:), and annotations from the folder "\5_dogs\json" located on the local disk (C:).

Items upload --local-path "C:\5_dogs" --local-annotations-path "C:\5_dogs\json"

Tip

By using the --remote-path flag in the command, you may upload to a specific folder in your dataset.
For example, "dogs folder" will be created and items will be located in the dataset:
/dogs folder/5_dogs

items upload --local-path "C:\5_dogs" --remote-path "/dogs folder"


Download Items and Annotations

With this command, you can download Items and Annotations from the platform to your computer.

In the following example, you will download all of the items and item's annotations in a JSON  option to your local folder "C:\5_dogs" in two separate folders.

items download --local-path "C:\5_dogs" --annotation-options json

dataloop ci 4.gif

Tip

  • You can download the annotations using the --without-binaries flag in the command:
items download --local-path "C:\5_dogs" --annotation-options json --without-binaries
  • You can download annotations of a specific type or label

Learn more on Download Annotations of Internal Source page.

items download --local-path "C:\5_dogs" --annotation-filter-label "dog , cat" --annotation-filter-type "box, point"  --annotation-options "mask"

What's Next