Vuresoft.Dicom.Sqlite 0.2.5

Vuresoft.Dicom.Sqlite

** BETA VERSION **

A .NET library for storing DICOM medical images in SQLite databases. Each DICOM study is stored in its own SQLite database file, containing all instances with their complete image data.

Features

• Store complete DICOM studies in single SQLite database files
• One database per study for easy management and portability
• Retrieve DICOM data by Study, Series, and Instance UIDs
• Memory-efficient streaming APIs for large datasets
• Bulk import from directories or file lists

Installation

Add reference to Vuresoft.Dicom.Sqlite project or NuGet package (when available).

Basic Usage

Create a database from a directory of DICOM files

using Vuresoft.Dicom.Sqlite;

// Create a new database from a folder containing DICOM files
var db = await SqliteDicomStudyDb.CreateFromDirectoryAsync(
    sourceDirectory: @"C:\DicomFiles\Study123",
    databasePath: @"C:\Studies\study123.db"
);

Add DICOM files to an existing database

using var db = new SqliteDicomStudyDb(@"C:\Studies\study123.db");

// Add a single file
await db.AddInstanceFromFileAsync(@"C:\DicomFiles\image.dcm");

// Import multiple files
var files = new[] { "file1.dcm", "file2.dcm", "file3.dcm" };
await db.ImportFilesAsync(files);

// Import entire directory
await db.ImportDirectoryAsync(@"C:\DicomFiles\Study123");

Retrieve DICOM data

using var db = new SqliteDicomStudyDb(@"C:\Studies\study123.db");

// Get a single instance as DicomDataset
var dataset = await db.GetInstanceAsync(studyUid, seriesUid, sopUid);

// Get raw DICOM bytes
var bytes = await db.GetInstanceBytesAsync(studyUid, seriesUid, sopUid);

// Get all instances in a series
var seriesDatasets = await db.GetSeriesAsync(studyUid, seriesUid);

Stream large datasets efficiently

using var db = new SqliteDicomStudyDb(@"C:\Studies\study123.db");

// Stream all DICOM datasets without loading into memory
await foreach (var dataset in db.GetAllInstancesDataSetsStreamAsync())
{
    // Process each dataset as it streams from the database
    var patientName = dataset.GetSingleValue<string>(DicomTag.PatientName);
    Console.WriteLine($"Processing: {patientName}");
}

// Stream raw DICOM bytes for an entire study
await foreach (var imageBytes in db.GetStudyBytesStreamAsync(studyUid))
{
    // Process each DICOM file's raw bytes
    await ProcessDicomBytesAsync(imageBytes);
}

Database Structure

Each SQLite database contains:

• Study table - Study Instance UID
• Series table - Series Instance UIDs linked to studies
• Instance table - SOP Instance UIDs with complete DICOM file data stored as BLOB

Dependencies

• fo-dicom - DICOM file parsing
• Microsoft.EntityFrameworkCore.Sqlite - Database access
• .NET 10.0 or later