An ecosystem of library and tools for DICOM compliant systems.
This collection provides a pure Rust implementation of the DICOM standard, allowing users to work with DICOM objects and interact with DICOM applications, while aiming to be fast, safe, and intuitive to use.
The following library packages are designed to be used in other Rust libraries and applications.
object
provides a high-level abstraction of DICOM objects and functions for reading and writing DICOM files.pixeldata
enables the decoding and conversion of DICOM objects into usable imaging data structures, such as images and multidimensional arrays.dump
provides helpful routines for dumping the contents of DICOM objects.ul
implements the DICOM upper layer protocol.dictionary-std
contains a Rust definition of the standard data dictionary.transfer-syntax-registry
contains a registry of transfer syntax specifications.parser
provides a middle-level abstraction for the parsing and printing of DICOM data sets.encoding
contains DICOM data encoding and decoding primitives.core
represents all of the base traits, data structures and functions related to DICOM content.
The parent crate dicom
aggregates the key components of the full library,
so it can be added to a project as an alternative to
selectively grabbing the components that you need.
Generally, most projects would add dicom_object
,
which is the most usable crate for reading DICOM objects from a file or a similar source.
This crate is available in dicom::object
.
For working with the imaging data of a DICOM object,
add pixeldata
.
Network capabilities may be constructed on top of ul
.
A simple example of use follows.
For more details,
please visit the dicom
documentation.
use dicom::object::open_file;
use dicom::dictionary_std::tags;
let obj = open_file("0001.dcm")?;
let patient_name = obj.element(tags::PATIENT_NAME)?.to_str()?;
let modality = obj.element(tags::MODALITY)?.to_str()?;
The project also comprises an assortment of command line tools.
dump
, aside from being a library, is also a command-line application for inspecting DICOM files.scpproxy
implements a Proxy service class provider.echoscu
implements a Verification service class user.storescu
implements a Storage service class user.storescp
implements a Storage service class provider.toimage
lets you convert a DICOM file into an image file.fromimage
lets you replace the imaging data of a DICOM file with one from an image file.findscu
implements a Find service class user.
dictionary-builder
is an independent application that generates code and other data structures for a DICOM standard dictionary.
You can use Cargo to build all crates in the repository.
cargo build
This project is under active development.
Your feedback during the development of these solutions is welcome. Please see the wiki for additional guidelines related to the project's roadmap. See also the contributor guidelines and the project's Code of Conduct.
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.