DICOM-rs

dicom is a library for the [DICOM] standard. It is part of the [DICOM-rs] project, an ecosystem of modules and tools for DICOM compliant systems.

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

Using as a library

This crate exposes the [dicom-object] crate directly via the object module, which has a high-level API for reading, writing, and manipulating DICOM objects. Other key components of the full library are available in this one as well, albeit representing different levels of abstraction.

An example of use follows. For more details, please visit the [dicom-object documentation] or the [full library documentation].

```rust use dicom::core::Tag; use dicom::object::{open_file, Result};

let obj = openfile("0001.dcm")?; let patientname = obj.elementbyname("PatientName")?.tostr()?; let modality = obj.elementbyname("Modality")?.tostr()?; let pixeldatabytes = obj.element(Tag(0x7FE0, 0x0010))?.to_bytes()?; ```

Cargo features

This crate enables the inventory-based transfer syntax registry by default, which allows for a seamless integration of additional transfer syntaxes without changing the application. In environments which do not support this, the feature can be disabled. Please see the documentation of [dicom-transfer-syntax-registry] for more information.