DICOM Criterion

A Python library for creating and evaluating boolean expressions against DICOM datasets. Build flexible validation rules using intuitive syntax to filter, validate, and process medical imaging data.

Quick Start

from pydicom import Dataset
from dicomcriterion import Criterion

# Create a sample DICOM dataset
dataset = Dataset()
dataset.PatientName = "John Doe"
dataset.StudyDescription = "Brain MRI with contrast"
dataset.Modality = "MR"

# Create validation criteria
criterion = Criterion("PatientName.equals('John Doe') and StudyDescription.contains('MRI')")

# Evaluate against dataset
result = criterion.evaluate(dataset)  # Returns True

Key Features

• Simple syntax: Write validation rules using natural boolean expressions
• Built-in functions: equals(), contains(), exists() for common validations
• Boolean operators: Combine rules with and, or, not, and parentheses
• Extensible: Add custom validation functions for specialized requirements

Installation

pip install dicomcriterion

Credits

This package was created with the kiro editor.