dagshub-docs/docs/feature_guide/annotations.md

DagsHub Annotations

DagsHub Annotations provides a fully configured labeling workspace, with full access to the project files, fired up and ready to go. On top of that, it provides a unique Git-Flow for labeling to ensure full reproducibility, scalability, and efficient version control of the labels and data.

How DagsHub Annotations works?

Every repository on DagsHub is configured with a labeling workspace. The workspace has full access to the project files, making them available to annotate directly from DagsHub's interface. To scale your work, DagsHub Annotations enable you to create multiple labeling projects on the workspace that are isolated from one another.

When creating a new labeling project, you associate it with a tip of an active branch which simulates the branching action. DagsHub loads and associates the annotations held on the branch with their tasks. You can version the annotations using Git, and once the labeling task is complete, create a pull request on DagsHub, where the reviewer can see and comment on every label.

How to annotate files with DagsHub Annotations?

Label Studio

!!! warning "This flow will soon be deprecated. Please read more about new flow under the Data Engine section"

To learn how to use DagsHub Annotation with Label Studio, please read the Label Studio integration on the DagsHub documentation.

Convert YOLO and COCO annotations to DagsHub format

COCO and YOLO are two of the most commonly used Data formats. To visualize them using DagsHub Annotations they must first be converted to the DagsHub annotations format.

We've prepared a notebook to simplify the process of transferring your YOLO and COCO formatted annotations to DagsHub format. You don't need to write a single line of code - we've got you covered!

YOLO

COCO

Behind the scene, the notebooks creates a JSON file for every data point that holds the annotation coordinates with a corresponding xml file using the classes.txt. The JSON files, along with the label_config.xml file, are held under the ``.labelstudio/` directory and then pushed to the DagsHub repo