Image2Radiomics documentation!

This open-source Python package facilitates radiomics feature extraction from medical imaging, focusing on reproducibility across all processing steps before and after radiomics feature extraction. Rather than emphasizing feature extraction alone, this package ensures that every stage of the workflow is consistent and repeatable.

Using a straightforward instruction file, the package allows users to perform a series of operations, including:

  • Image conversion (DICOM to NIfTI)

  • Image resampling (using c3d or SimpleITK)

  • Image segmentation (using TotalSegmentator)

  • Segmentation selection (by merging or excluding masks from a list)

  • Mask thresholding

  • Image windowing

  • Image harmonization

  • Feature normalization

  • Feature harmonization (with ComBAT)

  • Radiomics feature extraction (using pyradiomics)

  • Model evaluation

Citation

If you use this framework in your research or publications, please cite the following paper:

Tixier, Florent, et al. “Ensuring Reproducibility and Deploying Models with the Image2Radiomics Framework: An Evaluation of Image Processing on PanNET Model Performance.” Cancers, vol. 17, no. 15, 2025: https://doi.org/10.3390/cancers17152552

BibTeX entry:

@article{tixier2025,
    author  = {Tixier, Florent and Lopez-Ramirez, Felipe and Syailendra, Emir and Blanco, Alejandra and Javed, Ammar A. and Chu, Linda C. and Kawamoto, Satomi and Fishman, Elliot K.},
    title   = {Ensuring Reproducibility and Deploying Models with the Image2Radiomics Framework: An Evaluation of Image Processing on PanNET Model Performance},
    journal = {Cancers},
    year    = {2025},
    volume  = {17},
    number  = {15},
    doi     = {10.3390/cancers17152552}
}

Coming Soon

A new version of the framework is currently in development and will include:

  • A graphical user interface (GUI) for easier use

  • Support for saving and reloading processing pipelines in JSON format

  • Direct model saving and reuse through the GUI

  • And more to come

GUI preview

If you’d like to be notified when the new version is released, please fill out this short form:

Stay updated on new releases

Main Tools

This package includes three primary tools:

  1. `img2radiomics.py`: Applies a radiomics pipeline to all images in a folder, following specified steps before and after feature extraction. The resulting features are ready for radiomics model building.

  2. `init_auto_folder.py`: Creates a folder where new data are automatically processed upon file copy, allowing deployment of a model. This tool extracts radiomics features, applies a pre-built model, and generates predictions for new data.

  3. `gen_testing_pipeline_file.py`: Generates a pipeline file for the testing set or model deployment based on the training set’s pipeline instructions.

Compatibility and Processing

This package is designed for High-Performance Computing (HPC) clusters using SGE or SLURM job schedulers and enables parallel processing of multiple image datasets through a multiprocessing option. Since version 0.8.2, img2radiomics can also operate on a Linux computer without a job scheduler. Compatibility with Windows and macOS computers will be available in future versions.

Note

This work was supported by the Lustgarten Foundation

Warning

Not intended for clinical use.

Introduction

I2R.jpg

Illustration of the Img2Radiomics framework

Img2Radiomics enables radiomics feature extraction through a standardized, robust pipeline. Patient data in this framework is organized by a unique patient ID (patientID) and a sub-analysis identifier (sub_Analysis), which allows for separate analyses within a single patient’s data, such as images from different dates, segmentations, or reconstructions.

Data Organization

In Img2Radiomics, data must be organized by patientID and sub_Analysis. (Refer to the CHECK FOLDER module for additional details.)

Warning

If only one set of features per patient is needed (i.e., no sub-analysis), a sub-analysis folder is still required. In this case, create a folder named default within each patient folder.

Harmonization Requirement

If radiomics features require harmonization, the Excel file containing batch information must include columns named patientID and sub_Analysis. (See the FEATURE HARMONIZATION module for further information.)

Indices and tables