Follow the end to end walkthrough below to learn how to set up a custom Label Editor configuration based on DICOM tags. This End-to-end example assumes you configure the Label Editor so that two files are displayed at a given time.

This end-to-end example assumes that your files are stored in cloud storage.

STEP 1: Create JSON File for Data Registration

Before registering your cloud data to Encord you must first create a JSON file specifying the files you want to register. The following JSON file registers 3 DICOM series consisting of 4 files each.

DICOM
{
  "dicom_series": [
    {
      "title": "Patient-1",
      "objectUrl_0": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file0.dcm",
      "objectUrl_1": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file1.dcm",
      "objectUrl_2": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file2.dcm",
      "objectUrl_3": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file3.dcm",
    },
    {
      "title": "Patient-2",
      "objectUrl_0": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file4.dcm",
      "objectUrl_1": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file5.dcm",
      "objectUrl_2": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file6.dcm",
      "objectUrl_3": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file7.dcm",
    },
      {
      "title": "Patient-3",
      "objectUrl_0": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file8.dcm",
      "objectUrl_1": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file9.dcm",
      "objectUrl_2": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file10.dcm",
      "objectUrl_3": "https://encord-integration.s3.eu-west-2.amazonaws.com/dicom/mammo-file11.dcm",
    }
  ]
}

STEP 2: Register files with Encord

Create a Folder to Store Your Files

All files in Encord must be stored within folders. Therefore, you need to create a folder before registering any data with Encord. To create a folder:

  1. Navigate to Files under the Index heading in the Encord platform.
  2. Click the + New folder button to create a new folder. A dialog to create a new folder appears.
  1. Give the folder a meaningful name and description.

  2. Click Create to create the folder. The folder is listed in Files.


Register Your Files

You can register your DICOM data using the JSON file you created, using the UI or the SDK.


STEP 3: Set up Your Project

1

Create a Dataset

2

Create an Ontology

3

Create a Project


STEP 4: Create Custom Editor Layout

After creating your Project, import a custom layout for the Label Editor. Start by creating a JSON file that determines the layout.

Create a JSON for the Layout

Common layouts mammography files are a 2x2 grid, and 4x1 showing all files in a horizontal row.

A complete list of DICOM tags can be found here.

Import the custom layout

  1. Navigate to the Project settings.
  2. Click on Layouts.
  3. Click Upload JSON.
  4. Select the JSON file containing the layout you want the Label Editor to have.

What do the Layouts Look Like?

2x2 Mammography Layout:

4x1 Mammography Layout: