QUANTUM - The Health Data Quality Label

Cite the code:

Introduction

The QUANTUM Data Quality Labelling Tool is a key component of the European Health Data Space (EHDS) initiative, designed to address the challenge of ensuring that health datasets are of high quality, accessible, and interoperable across EU member states. As healthcare data plays an increasingly vital role in research, policy, and innovation, this tool provides a standardized mechanism to evaluate and label the quality, utility, and maturity of datasets, supporting stakeholders such as healthcare institutions, research organizations, and policymakers.

Features

This tool empowers data holders by offering functionalities to:

• Feature 1: Catalogue and Dataset metadata creation
• Feature 2: Assess datasets quality based on a guided evaluation of the QUANTUM key dimensions (such as accuracy, accessibility, and compliance) using your own practices.
• Feature 3: Generate and visualise data quality certificates (labels) and download them in the HealthData@EU standardized RDF format.
• Feature 4: Facilitate compliance with EU-wide quality standards such as HealthDCAT-AP, DCAT, DQV.
• Feature 5: Provide a transparent and accessible method for assessing data holders maturity.

Ultimately, the QUANTUM tool aims to foster trust in health data across Europe by promoting reliable, reusable datasets that can be confidently shared within the European Health Data Space.

System Requirements

Minimum Hardware Requirements

• CPU: 1 core
• RAM: 1 GB
• Storage: 5 GB

Recommended Hardware Requirements

• CPU: 2 to 4 cores
• RAM: 2 to 4 GB
• Storage: 10 to 20 GB

Software Requirements

• Ubuntu 20.04.6 LTS or similar
• Python 3.11
• Docker 24.0.2 (if used)

Installation steps

git clone [repository_url]
cd [repository_directory]
pip install -r requirements.txt
python manage.py migrate # if database is not generated previously 
python manage.py createsuperuser # for creating root user if desired (current root user is root for username and password)

Execution

python manage.py runserver 0.0.0.0:8000

• Access localhost:8000 through web browser
• Access localhost:8000/admin to visit the Admin dashboard (login is root for user and password by default)
• To register a user it is needed to 1) create the user, 2) create an organization, 3) relate a user with an organization (userorganization)

Dockerizing

Quick Start (Recommended)

The easiest way to run QUANTUM with Docker is using our automated setup:

Prerequisites:

• Docker and Docker Compose installed

One-command setup:

git clone https://github.com/quantum-label/quantum_labelling_tool.git
cd quantum_labelling_tool
docker-compose up --build

Fill the initial database information:

docker exec -it quantumtooldatabase bash
mysql -u root -p
use quantum;
source /docker-entrypoint-initdb.d/init.sql;

Access the application:

• Web App: http://localhost:8000
• Admin Panel: http://localhost:8000/admin
• Default admin credentials: admin / admin123

What Happens Automatically

Our automated Docker setup handles everything:

1. Database Initialization: MariaDB starts with initial schema and sample data
2. Django Migrations: Applied automatically to update database schema
3. Superuser Creation: Admin user created with credentials above
4. Static Files: CSS/JS files collected automatically
5. Application Startup: Web server starts and becomes ready

Environment Configuration

The setup uses environment variables from .env file:

QUANTUM_DATABASE_LOCATION=./database
QUANTUM_DATABASE=quantum
QUANTUM_ROOT_PASSWORD=root
DJANGO_WEB_URL=http://localhost

Useful Commands

# Start in background
docker-compose up -d --build

# View logs
docker-compose logs -f

# Stop services
docker-compose down

# Reset everything (removes all data)
docker-compose down -v

# Access containers
docker exec -it quantumtoolwebapp bash
docker exec -it quantumdatabase bash

Technology Stack

Backend

• Python 3
• Django

Frontend

• HTML
• CSS*
• JavaScript*

*It is used Bootstrap 5.3

Database

Development

• SQLite3

Production (Docker)

• MariaDB

Licence

This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/4.0/.

Credits

Version: 0.1

Authors: QUANTUM WP2: Claudio Proietti Mercuri (Sciensano), Ángel Sánchez-García (UPV), Nienke Schutte (Sciensano), Carlos Sáez (UPV); on behalf of QUANTUM.

Maintainers: Claudio Proietti Mercuri (Sciensano), Ángel Sánchez-García (UPV), Francisco Estupiñan Romero (IACS).

Acknowledgements: QUANTUM WP1, WP2, WP3 partners and all participants in the tool piloting for their feedback.

Funded by EU QUANTUM project.