Skip to main content

DICOM metadata audit

Policy-driven QC for research-ready DICOM releases

dicomqc validates pseudonymized DICOM datasets before release, producing redaction-safe evidence for de-identification review, private-tag handling, and MultiQC project reports.

Quick start Overview

Release audit

dicomqc scan work/candidate_release_mri/
  --json reports/dicomqc/report.json
  --csv reports/dicomqc/findings.csv
  --multiqc reports/dicomqc/dicomqc_mqc

InputDICOM

Moderead-only

Evidenceredacted

Raw DICOM files are pseudonymized externally, audited by dicomqc, and reported as release evidence

RawPreserve source DICOM

AnonRun external pseudonymization

QCAudit metadata with dicomqc

ReportArchive JSON, CSV, and MultiQC evidence

dicomqc audits the candidate release; it does not modify the original imaging data.

Inspect

Read metadata only

Scan DICOM files without loading pixel data and normalize release-relevant tags.

Audit

Apply explicit policies

Flag direct PHI fields, risky pseudonym fields, and private tags as structured findings.

Report

Keep evidence reproducible

Write JSON, CSV, and MultiQC-compatible outputs that avoid raw DICOM values.

Improve

Feed the remediation loop

Use findings to update an external pseudonymization workflow, then rerun the audit.

Start here

Quickstart

Install dicomqc, scan a study directory, and read the exit codes.

MS MRI workflow

Place dicomqc after pseudonymization and before research release.

Reports

Use redaction-safe JSON, CSV, and MultiQC companion evidence.

Architecture

Review the scanner, rules, report writers, and extension roadmap.