# DICOM Labeling Editor

Ango Hub provides a labeling editor with which single- and multi-page DICOM files can be annotated.

{% hint style="info" %}
This article will exclusively go over Ango Hub’s DICOM labeling interface. Features common to all labeling editors are instead [explained here](https://docs.imerit.net/labeling/labeling-editor-interface).
{% endhint %}

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FjHJ5pz57Lgd6vzLUvwaS%2Fimage.png?alt=media\&token=78666fd9-569a-4a3b-a733-d78ce1131985)

## Overview <a href="#image-interface-elements" id="image-interface-elements"></a>

### Supported File Types

The DICOM labeling editor supports DICOM assets with the following file extensions:&#x20;

* .dcm

### Supported Labeling Tools

The DICOM labeling editor supports following labeling tools:&#x20;

**Tools**

* Bounding Box
* Rotated Bounding Box
* Polygon
* Polyline
* Segmentation
* Point
* Circle

**Classifications**

* Radio
* Checkbox
* Single-Select Dropdown
* Multi-Select Dropdown
* Single-Select Tree
* Multi-Select Tree
* Text

**Relations**

* Single Relation
* Group Relation

{% hint style="warning" %}
This section of this page is temporarily out of date. We have recently merged our multi-page DICOM and video editors, so that they share the same interface. Thank you for your patience as we rewrite this section.

In the meantime, you can refer to [the page on the video editor](https://docs.imerit.net/labeling/labeling-editor-interface/video-labeling-editor), which is nearly identical to the DICOM editor.
{% endhint %}

### DICOM Interface Elements <a href="#image-interface-elements" id="image-interface-elements"></a>

#### Pages Bar <a href="#zoom-buttons" id="zoom-buttons"></a>

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FGYTV5jPZwzkq0gEMFKEt%2FScreen%20Shot%202022-05-10%20at%2015.13.55.png?alt=media\&token=6459663f-54b7-4cfc-af5c-4aa3796de936)

The back and forward arrows allow you to move backwards and forwards one page at a time. The slider allows you to move quickly between pages by clicking on it dragging it to find the frame you need. If you already know the number of the page you'd like to visualize, enter it in the text box on the right and press Enter to immediately jump to it.

#### Patient and File Information

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FaAiacjUDlPPe9ZWsxG15%2FScreen%20Shot%202022-05-10%20at%2015.21.40.png?alt=media\&token=bc5549ad-2fec-417e-9079-76dcdfec6944)

If embedded in the DICOM file, patient data such as Patient ID and Patient Name will be shown. If present, the thickness of the slices in the DICOM file is shown.

### How to Annotate DICOM Files <a href="#how-to-annotate-images" id="how-to-annotate-images"></a>

Annotating DICOMs is similar to annotating images and videos since a single-page DICOM is, in essence, an image, and a multi-page DICOM a video. There is, however, additional functionality to consider.

The following are the labeling tools supported on DICOMs:

* [Bounding Box](https://docs.imerit.net/labeling/labeling-tools/tools/bounding-box)
* [Rotated Bounding Box](https://docs.imerit.net/labeling/labeling-tools/tools/rotated-bounding-box)
* [Polygon](https://docs.imerit.net/labeling/labeling-tools/tools/polygon)
* [Polyline](https://docs.imerit.net/labeling/labeling-tools/tools/polyline)
* [Segmentation](https://docs.imerit.net/labeling/labeling-tools/tools/segmentation)
* [Point](https://docs.imerit.net/labeling/labeling-tools/tools/point)
* [Brush](https://docs.imerit.net/labeling/labeling-tools/tools/brush-bucket)

From the *Tools* panel on the left sidebar, select a supported labeling tool. Then, follow the instructions found on each tool's docs page, linked to above.

If no tools are present in the project, only answer the questions in the *Classifications* panel.

When done, move forward to the next page and repeat the process until all pages are labeled.

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2F4ne4EwQrVjvXZJq3pIMy%2FScreen%20Shot%202022-05-10%20at%2015.19.08.png?alt=media\&token=823c56b3-6c12-4a64-9813-fe1202fa4076)

#### Nested Questions and Classifications <a href="#nested-questions-and-classifications" id="nested-questions-and-classifications"></a>

If the labels have nested questions, right-click on each label and click on the menu item that appears to see and answer the nested questions.

If classification questions are present, you may answer them from the *Questions* panel on the left sidebar.

## Annotating Multiple DICOM Files at Once

{% hint style="info" %}
For information on how to import multi-DICOM assets, please consult [this docs page](https://docs.imerit.net/data/importing-assets/bundled-assets/importing-multiple-dicom-files-to-be-annotated-and-displayed-at-once).
{% endhint %}

### Entering Focus Mode

When multiple DICOM files are displayed on screen, you may choose to focus the layout on a smaller number of them.

For example, in this asset, we have eight DICOM files displaying at once:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FTHUOIWeGhsxNJUcBFAIh%2Fimage.png?alt=media&#x26;token=21d6a476-7a94-413e-aac8-592fcd0da4c3" alt=""><figcaption></figcaption></figure>

By default, the filename of each DICOM is displayed on the bottom-left of each view. You can turn this off by clicking on the red settings button at the bottom-right and toggling off the *Show DICOM Filename* option.

While holding Alt (Option) on your keyboard, click on the DICOMs you would like to focus on. A button will appear:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FDGVugSq0l4cCaBNVh39C%2Fimage.png?alt=media&#x26;token=307c63d4-c4ab-4e6c-bdee-742290045a7b" alt=""><figcaption></figcaption></figure>

Clicking on it will enter "Focus Mode" with the selected DICOMs, where they will be displayed in their own, larger, layout (DICOMs blurred for privacy):

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FXPEtL7Noa9DnrIqjx2Hv%2Fimage.png?alt=media&#x26;token=3ef7335e-dee4-4ad1-8636-dfb64d54052d" alt=""><figcaption></figcaption></figure>

To exit Focus Mode, click on "Default" again.

### Copying and pasting annotations from one DICOM to another

You may select a single annotation, or multiple by holding Shift, then use Control + C (⌘ + C on macOS) to copy the objects to the clipboard, even if the objects are on different slices in the same DICOM. You may then paste the new objects to the other DICOM by clicking on the target DICOM and pressing Control + V (⌘ + V on macOS).

Due to a current limitation, all objects in the clipboard will be pasted on the slice (frame) you are currently viewing, regardless of whether they came from different frames.

## Changing Window Levels

By clicking on the "Window Level" icon, windowing level options will appear.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FESZKcxhfsZZuChYhK3zq%2Fimage.png?alt=media&#x26;token=b80fd414-7cbf-4ef0-93d3-0496e548582b" alt="" width="563"><figcaption></figcaption></figure>

Alternatively, you may click the right mouse button and drag your mouse cursor.

### Keyboard Shortcuts <a href="#keyboard-shortcuts" id="keyboard-shortcuts"></a>

A full list of keyboard shortcuts is available by clicking on the *Keyboard* button on the right side of the top bar:

![](https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mj9Q2CMggO8ujraHZeP%2F-Mk6CxZh5z2xVvRhJYrU%2F-Mk6F7P7tRIy5pUzA3oA%2Fimage.png?alt=media\&token=9c2301b3-695a-4816-bddb-65d4c43f37c5)

### Further reading

{% content-ref url="audio-labeling-editor" %}
[audio-labeling-editor](https://docs.imerit.net/labeling/labeling-editor-interface/audio-labeling-editor)
{% endcontent-ref %}

{% content-ref url="" %}
[](https://docs.imerit.net/labeling/labeling-editor-interface)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.imerit.net/labeling/labeling-editor-interface/dicom-labeling-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
