Visual Intelligence Summit: Oct 22 in San Francisco Get your ticket

Convert annotation formats

How To Convert Scale AI JSON to YOLOv5 Oriented Bounding Boxes

In this guide, we show you how to convert data between the Scale and YOLOv5 OBB formats for free. You can use your converted data to train YOLOv5 Oriented Bounding Boxes models and other models that support the YOLOv5 OBB format.

Scale AI JSON

Scale AI is a popular outsourced labeling platform; their API returns object detection annotations in this JSON format.

Below, learn the structure of Scale AI JSON.

scale.ai.jsonJSON
[
  {
    "task_id": "a9b7c5d3e1f",
    "created_at": "2000-01-01T00:00:00.000Z",
    "completed_at": "2000-01-01T00:00:00.000Z",
    "callback_url": "example@example.com",
    "type": "annotation",
    "status": "completed",
    "instruction": "\n# Instructions\n\nLabel the helmets on the workers.",
    "params": {
      "attachment": "https://storage.googleapis.com/roboflow/0001.jpg",
      "attachment_type": "image",
      "objects_to_annotate": [
        "helmet",
        "head",
        "person"
      ],
      "with_labels": true,
      "min_width": 0,
      "min_height": 0,
      "examples": []
    },
    "is_test": false,
    "urgency": "standard",
    "metadata": {},
    "callback_succeeded": true,
    "processed_attachments": [],
    "project": "Hard Hat Workers",
    "response": {
      "annotations": [
        {
          "width": 189,
          "height": 144,
          "label": "helmet",
          "left": 1374,
          "top": 2128
        },
        {
          "width": 157,
          "height": 122,
          "label": "person",
          "left": 1427,
          "top": 2409
        }
      ]
    },
    "project_param_version": 0,
    "scale_internal_attachment": "https://d2qt2k6tuv6mdh.cloudfront.net/a9b7c5d3e1f/001.jpg",
    "workStarted": true
  }
]

YOLOv5 Oriented Bounding Boxes

A modified version of YOLO Darknet annotations that allows for rotated bounding boxes.

Below, learn the structure of YOLOv5 Oriented Bounding Boxes.

Each image has one txt file with a single line for each bounding box. The format of each row is

x1 y1 x2 y2 x3 y3 x4 y4 label

where fields are space delimited, and the coordinates are measured in pixels.

001.txt
236 267 271 267 271 306 236 306 helmet 0
188 230 216 230 216 257 188 257 helmet 0
169 146 200 146 200 174 169 174 helmet 0
201 114 230 114 230 140 201 140 helmet 0
247 245 272 245 272 268 247 268 helmet 0
261 231 285 231 285 257 261 257 helmet 0
146 150 172 150 172 179 146 179 head 0

The `data.yaml` file contains configuration values used by the model to locate images and map class names to class_id's.

data.yaml
path: ../datasets/roboflow

train: train/images
val: valid/images
test: test/images

nc: 3
names: ['head', 'helmet', 'person']

Step 1: Create a free Roboflow public workspace

Roboflow is a universal conversion tool for computer vision annotation formats. The Public plan is the best way for those exploring personal projects, class assignments, and other experiments to try Roboflow. To convert your dataset, start by creating a free workspace on the Public plan.

Create Roboflow Workspace

Step 2: Upload your data into Roboflow

Once your account has been created, click Create New Project.

Roboflow's create project form, with Object Detection selected as the project type

Upload your data to Roboflow by dragging and dropping your Scale AI JSON images and annotations into the upload space.

Roboflow's upload page, with a drag-and-drop area for images, annotations, videos and PDFs

Step 3: Generate Dataset Version

Next, click "Generate New Version" to generate a new version of your dataset:

Roboflow's Generate a Dataset Version page, showing the source images and train/test split for a new version

You can then apply any preprocessing or augmentation steps to your dataset:

The augmentation step of a new dataset version, with 90° Rotate and Brightness added

Step 4: Export Dataset Version

After generating, you will be prompted to Export your dataset. You can choose to receive your dataset as a .zip file or a curl download link. Choose YOLOv5 Oriented Bounding Boxes when asked in what format you want to export your data. You will see a dropdown with various options like this:

Roboflow's Download dialog, with the export format list open and COCO highlighted

Congratulations, you have successfully converted your dataset from Scale AI JSON format to YOLOv5 Oriented Bounding Boxes format!

Video Tutorial

Convert Computer Vision Annotation Formats Tutorial

Want to dive deeper into converting annotation formats with Roboflow? In the tutorial below, we explore how to convert your data in the Roboflow dashboard. We also discuss rejecting annotations and train-test-validation splits.

Frequently Asked Questions

Yes! It is free to convert Scale AI JSON data into the YOLOv5 Oriented Bounding Boxes format on the Roboflow platform.

If you have between a few and a few thousand images, converting data between these formats will be quick. But, the time it takes to convert between data formats increases with the more images you have.

Show guide

Convert Scale AI JSON to other formats

Convert other formats to YOLOv5 Oriented Bounding Boxes

Related

Start where you are

Speak with an AI expert

Our team will help you start solving business problems on the first call.

  • Solution architecting
  • Live demonstration
  • Pricing and specifications
  • Feasibility assessment

Over 16,000 organizations build with Roboflow.

Rivian
Pella
Chobani
USG Corporation
BNSF Railway
American Woodmark
Outcomes
Patrick Industries
Peer Robotics
Create Roboflow Workspace