DICOM-rs

An efficient and practical library for DICOM compliant systems.

This collection provides a pure Rust implementation of the DICOM standard, allowing users to read and write DICOM objects over files and other sources, while remaining intrinsically fast and safe to use.

Components

core represents all of the base traits, data structures and functions related to DICOM content.
encoding contains DICOM data encoding and decoding primitives.
parser provides a middle-level abstraction with a parser of DICOM data sets.
object provides a high-level abstraction of DICOM objects and functions for reading and writing DICOM files.
dictionary-std contains a Rust definition of the standard data dictionary.
dictionary-builder is a Rust application that generates code and other data structures for a DICOM standard dictionary using entries from the official website.
dcmdump is a command-line application for inspecting DICOM files.

Using as a library

dicom-object is currently the most usable crate for reading DICOM objects from a file or a similar source. As an alternative, the parent crate dicom can be added instead, which aggregates the key components of the full library, including dicom-object.

An example of use follows. For more, please visit the respective documentation.

use dicom_object::open_file;
use dicom_object::Result;

let obj = open_file("0001.dcm")?;
let patient_name = obj.element_by_name("PatientName")?.to_str()?;
let modality = obj.element_by_name("Modality")?.to_str()?;

Building

You can use Cargo to build all crates in the repository.

cargo build --release

Roadmap & Contributing

This project is a work in progress, but actively developed.

Your feedback during the development of these solutions is welcome. Please see the wiki for additional guidelines related to the project's roadmap.

License

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.