# Ango Export Converter Plugins

## Overview

The Ango Export Converter plugins are made, published, and officially supported by Ango AI, allowing you to download your annotations in COCO, YOLO and, KITTI formats.

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td align="center">Ango to COCO Converter</td><td data-object-fit="contain"><a href="https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/plugin-icons-banners/ANGO-COCO.png">https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/plugin-icons-banners/ANGO-COCO.png</a></td></tr><tr><td align="center">Ango to YOLO Converter</td><td data-object-fit="contain"><a href="https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/plugin-icons-banners/ANGO-YOLO.png">https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/plugin-icons-banners/ANGO-YOLO.png</a></td></tr><tr><td align="center">Ango to KITTI Converter</td><td data-object-fit="contain"><a href="https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/plugin-icons-banners/ANGO-KITTI.png">https://angohub-docs-assets.s3.eu-central-1.amazonaws.com/plugin-icons-banners/ANGO-KITTI.png</a></td></tr></tbody></table>

## Plugin Functionality

Adding the plugin to your organization will allow you to download your annotations in a format other than the [Ango Export Format](https://docs.imerit.net/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format).

Currently, we offer the following additional export formats through plugins:

* \[Ango] to \[COCO] Converter
* \[Ango] to \[YOLO] Converter
* \[Ango] to \[KITTI] Converter

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2F1i2x8FmhI7CZqg6BBgS6%2Fimage.png?alt=media&#x26;token=f2f4c2cc-7526-41ab-922d-23423527b4e1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
The only way to ensure you get all of the data created with Ango Hub is to download your export in the original [Ango Export Format](https://docs.imerit.net/data/importing-and-exporting-annotations/exporting-annotations/ango-export-format) (JSON).

As other export formats were created by third parties and with different use cases in mind, they may not contain all data created within Ango Hub.

For example, the COCO and YOLO formats only support certain labeling tools, and only on images. Thus, non-image assets will not be exported, and data points created with labeling tools unsupported by YOLO/COCO will also not be exported.
{% endhint %}

### Supported Data Types

{% tabs %}
{% tab title="\[Ango] to \[COCO] Converter" %}

* Image
* Video
* Multi-Image Assets
  {% endtab %}

{% tab title="\[Ango] to \[YOLO] Converter" %}

* Image
* Video
* Multi-Image Assets
  {% endtab %}

{% tab title="\[Ango] to \[KITTI] Converter" %}

* Image
  {% endtab %}
  {% endtabs %}

### Supported Annotation Tools

{% tabs %}
{% tab title="\[Ango] to \[COCO] Converter" %}

* Bounding Box
* Rotated Bounding Box
* Polygon
* Segmentation
* Polyline
* Point
  {% endtab %}

{% tab title="\[Ango] to \[YOLO] Converter" %}

* Bounding Box
* Polygon
* Segmentation
  {% endtab %}

{% tab title="\[Ango] to \[KITTI] Converter" %}

* Bounding Box
  {% endtab %}
  {% endtabs %}

## Plugin Configuration

From the **Stage Filter** field, pick the stages containing the tasks you'd like to get the export of. Similarly, from the **Batch Filter** field, you may select one or more batches the tasks of which will be exported. By default, all tasks are exported from all batches.

If you wish to receive an email when the export is complete, toggle **Send Email** on.

You may vary a number of settings related to your export from the **Config JSON** field. Each option is detailed below:

#### \[Ango] to \[COCO] Converter

```json
{
  "mode": "default",
  "export_to_single_file": true,
  "rle_encoding": true,
  "logging_frequency": 0
}
```

* **"mode":** Defines the conversion mode. The default mode exports annotations in standard COCO format
  * Example:
    * <kbd>"mode": "default"</kbd>

* **"export\_to\_single\_file":** When <kbd>true</kbd>, the export will be a single file. When false, the export will return a compressed archive containing one export file per asset.
  * Example:
    * <kbd>"export\_to\_single\_file": true</kbd>
    * <kbd>"export\_to\_single\_file": false</kbd>&#x20;

* **"rle\_encoding":** Controls how segmentation annotations are exported. When set to <kbd>true</kbd>, each segmentation is first converted into a binary mask and then encoded using COCO’s Run-Length Encoding (RLE) format. When set to <kbd>false</kbd>, the plugin instead returns the original polygon coordinates following the standard COCO polygon segmentation format.
  * Example:
    * <kbd>"rle\_encoding": true</kbd>&#x20;
    * <kbd>"rle\_ecoding": false</kbd>

* **"logging\_frequency":** Defines how frequently progress logs are displayed; setting this value to 0 disables logging entirely, while any positive integer enables logging at the specified interval. For more information on how to view plugin logs, [see here](https://docs.imerit.net/plugins/introduction-to-plugins/monitoring-plugin-progress).
  * Example:
    * <kbd>"logging\_frequency": 0</kbd>&#x20;
    * <kbd>"logging\_frequency": 100</kbd>

#### \[Ango] to \[YOLO] Converter

```json
{
  "extract_attributes": false,
  "include_key_frames_only": true,
  "logging_frequency": 0
}
```

**"extract\_attributes":** When <kbd>true</kbd>,  includes attributes of the bounding boxes, if available.&#x20;

* Example:
  * <kbd>"extract\_attributes": true</kbd>
  * <kbd>"extract\_attributes": false</kbd>&#x20;

* **"include\_key\_frames\_only":** Specifies whether only key frames should be included in the metrics calculation. (For video assets only)
  * Example:
    * <kbd>"include\_key\_frames\_only": true</kbd>
    * <kbd>"include\_key\_frames\_only": false</kbd>&#x20;

* **"logging\_frequency":** Defines how frequently progress logs are displayed; setting this value to 0 disables logging entirely, while any positive integer enables logging at the specified interval. For more information on how to view plugin logs, [see here](https://docs.imerit.net/plugins/introduction-to-plugins/monitoring-plugin-progress).
  * Example:
    * <kbd>"logging\_frequency": 0</kbd>&#x20;
    * <kbd>"logging\_frequency": 100</kbd>

#### \[Ango] to \[KITTI] Converter

```json
{
  "logging_frequency": 0
}
```

**"logging\_frequency":** Defines how frequently progress logs are displayed; setting this value to 0 disables logging entirely, while any positive integer enables logging at the specified interval. For more information on how to view plugin logs, [see here](https://docs.imerit.net/plugins/introduction-to-plugins/monitoring-plugin-progress).

* Example:
  * <kbd>"logging\_frequency": 0</kbd>&#x20;
  * <kbd>"logging\_frequency": 100</kbd>&#x20;
