Overview FileIO Package#
The fileio
package provides functionality for loading, converting, and writing medical images in
discrete medical image formats and in the clinical DICOM format. In contrast to other medical image libraries such as
for example SimpleITK, the fileio
package can process DICOM-RT
Structure Sets (DICOM-RTSS) which contain contours of delineated anatomical structures. Furthermore, the
fileio
package is able to load, assign and apply DICOM registrations such that the associated DICOM
images and DICOM-RTSS are registered to each other. In summary, this package provides the often missing piece of
functionality to work easily with clinical DICOM data in radiotherapy.
Due to the complex relations and dependencies between DICOM images, DICOM-RTSS, and DICOM registrations, the loading
process is not as straightforward as loading a single DICOM image. However, the fileio
package tries
to reduce the complexity of the loading process by providing simple and intuitive interfaces and mechanisms, automation,
and neat examples. To understand the loading process, it is recommended to follow the provided examples.
If the data successfully loaded and processed, the fileio
package provides functionality to write the
resulting data in a structured way to disk. This includes the writing of the data in various formats such as for example
NIFTI. In addition, the resulting data can also be converted into a DICOM-RTSS before writing it to disk.
To understand the functionality of the fileio
package, we recommend to read the following sections for
in the following orders:
- Data Loading
Modality Configuration Module (only for DICOM data)
- Data Writing
DICOM Conversion Module (only for writing DICOM-RTSS)