How to read & label dicom medical images on Kili

How to read & label dicom medical images on Kili

In this tutorial, we will show you how to upload medical images to Kili Technology. We will use pydicom, a python package, to read medical data in a Dicom format.

Data used in this tutorial comes from the RSNA Pneumonia Detection Challenge hosted on Kaggle in 2018.

First of all, let us import the packages, and install pydicom in case you did not install it. It’s a Dicom reader and writer for python.

!pip install pydicom
import os
import glob
from collections import defaultdict
import pickle
import pydicom
import matplotlib.pyplot as plt
import matplotlib.patches
from PIL import Image
import numpy as np
import pandas as pd

We upload the images on Python, extract DICOM metadata and generate jpeg from the dicom image field.
you should then upload your generated jpegs.

data_folder = "./datasets"
files = glob.glob(f'{data_folder}/*.dcm')
def dcm2metadata(sample):
metadata = {}
for key in sample.keys():
if < 50:
item = sample.get(key)
if hasattr(item, 'description') and hasattr(item, 'value'):
metadata[item.description()] = str(item.value)
return metadata

processed_imgs = []
metadata_array = []
for file in files:
fname = file.split('/')[-1].split('.')[0]
sample = pydicom.dcmread(file)
im = Image.fromarray(sample.pixel_array)
fpath = f'{data_folder}/{fname}.jpeg'

Next, we just need to connect to Kili , and create and define the annotation interface. You can also refine it in the app.

# !pip install kili # uncomment if you don't have kili installed already
from kili.authentication import KiliAuth
from kili.playground import Playground

email = os.getenv('KILI_USER_EMAIL')
password = os.getenv('KILI_USER_PASSWORD')
api_endpoint = os.getenv('KILI_API_ENDPOINT') # If you use Kili SaaS, use ''

kauth = KiliAuth(email=email, password=password, api_endpoint=api_endpoint)
playground = Playground(kauth)

Below is the jsonInterface, i.e. the parameters of a Kili project in the app

job_id = 'JOB_0'
json_interface = {
"filetype": "IMAGE",
"content": {
"categories": {
"YES": {"name": "Yes"},
"NO": {"name": "No"}
"input": "radio"
"required": 1,
"isChild": False,
"instruction": "Healthy ?"
"JOB_0": {
"content": {
"categories": {
"BONE": {"name": "bone"},
"TISSUE": {"name": "tissue"},
"LUNG": {"name": "lung"},
"RIB": {"name": "rib"}
"input": "radio"
"required": True,
"tools": ["semantic"],
"instruction": "Segmentation"

We can then use the API to create our project, and upload our images on the project, with the jpeg. Here we previously uploaded those on Google drive, feel free to test out with those.

title = 'Medical Imaging with Kili Technology'
description = 'This is a test project'
input_type = 'IMAGE'

project = playground.create_empty_project(user_id=playground.auth.user_id)
project_id = project['id']
content_array = ['',
external_id_array = ['01',

Done ! Your data is on the project, all that remains is to start labeling !
Below, we’ll show you how you can visualize it on Python after downloading, here with pre-saved labels but it could be done with your own using this recipe

alt text

# if 'labels' in labeled_assets[0].keys():
if False:
labeled_assets = playground.assets(project_id=project_id, external_id_contains=['01'], fields=['labels.jsonResponse'])
labels = labeled_assets[0]['labels'][0]['jsonResponse']
with open('./conf/medical-labels.pkl', 'rb') as f:
labels = pickle.load(f)
with open('./conf/medical-labels.pkl', 'wb') as f:
pickle.dump(labels, f)
healthy = labels['CLASSIFICATION_JOB']['categories'][0]['name']
semantic = labels['JOB_0']['annotations']

We’ll convert those labels to a python format, and plot them using matplotlib :

points = pd.DataFrame(semantic[0]['boundingPoly'][0]['normalizedVertices']).values
def transform2image(points, shape):
newpoints = np.zeros(points.shape)
newpoints[:, 0] = points[:, 0] * shape[0]
newpoints[:, 1] = points[:, 1] * shape[1]
return newpoints

category2points = defaultdict(list)
for annotation in semantic:
category = annotation['categories'][0]['name']
points = pd.DataFrame(annotation['boundingPoly'][0]['normalizedVertices']).values

fname = files[0].split('/')[-1].split('.')[0]
im ='{data_folder}/{fname}.jpeg')
fig, ax = plt.subplots(figsize=(10, 10))
colors = plt.rcParams['axes.prop_cycle'].by_key()['color']
for i, (category, shapes) in enumerate(category2points.items()):
for j, shape in enumerate(shapes):
if j == 0:
poly = matplotlib.patches.Polygon(transform2image(shape, im.size),
color=colors[i], alpha=0.5, label=category)
poly = matplotlib.patches.Polygon(transform2image(shape, im.size),
color=colors[i], alpha=0.5)
ax.set_title(f'Healthy : {healthy}')


Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.