Skip to main content

Z-Rad is a radiomic feature extraction software with GUI and API.

Project description

Z-RAD

Z-Rad logo

Radiomics is the high-throughput extraction of quantitative features from medical images, revolutionizing personalized medicine and enhancing clinical decision-making. Despite its potential, radiomics faces several challenges, including the need for programming skills and lack of standardization.

Z-Rad (Zurich Radiomics), developed by the Radiation Oncology Department at the University Hospital Zurich, addresses these issues by offering a user-friendly, IBSI-compliant, and open-source solution for radiomics analysis.

Z-Rad Features

Z-Rad screenshot

User-Friendly Interface

  • Graphical User Interface (GUI): Designed for medical professionals with no programming skills.
  • Application Programming Interface (API): Allows researchers to customize, automate, and extend Z-Rad functionalities using Python.

Compatibility

  • Medical Data Formats: Supports CT, PET, and MR imaging modalities in both DICOM and NIfTI formats.
  • Operating Systems: Windows, macOS, and Linux.

Standard Compliance

  • IBSI Compliance: Adheres to IBSI I and IBSI II standards for reproducible and comparable radiomics features.

Software Architecture and Design

Backend

  • Programming Language: Python.
  • Dependencies:
    • Joblib
    • NumPy
    • OpenCV
    • Pandas
    • PyDicom
    • PyQt5
    • PyWavelets
    • Scikit-image
    • SciPy
    • SimpleITK

Radiomics Extraction Pathways

Z-Rad Pathways

Graphical User Interface (GUI) and Application Programming Interface (API)

Both GUI and API are structured into three primary classes: Resampling, Filtering, and Radiomics:

Resampling

Z-Rad supports image resampling alone, alongside regions of interest (ROI) masks, or converting DICOM files to NIfTI images and masks without resampling. Resampling can be performed in 3D or 2D (axial slice-wise), with nearest neighbors, linear, B-spline, and Gaussian strategies.

Filtering

This tab requires users to define the desired filter settings. The current version of Z-Rad supports mean, Laplace of Gaussian, Laws kernels, and wavelet (Daubechies 2, Daubechies 3, first-order Coiflet, and Haar) filters.

Radiomics Feature Extraction

Parameters for radiomics feature extraction include the intensity re-segmentation (e.g., HU for CT or SUV for PET within ROIs) and intensity outlier filtering, discretisation strategies, and a variety of radiomics feature aggregation methods covering 2D, 2.5D, and 3D options. Radiomic features include shape, intensity, grey level co-occurrence matrix (GLCM), grey level run length matrix (GLRLM), grey level distance zone matrix (GLDZM), neighbouring gray tone difference matrix (NGTDM), and neighbouring gray level dependance matrix (NGLDM) features families.

Error and Warning Handling

  • GUI: Uses warning pop-up messages for immediate feedback.
  • API: Records processes in log files for comprehensive documentation.

Installation and Get Started

Windows executable file:

The simplest way to run Z-Rad on Windows is to start the z-rad.exe attached to every Z-Rad release.

Windows, Linux, and macOS

For users familiar with Python programming langauage, we recommend:

  1. Download the Z-Rad repository
  2. Open the terminal and navigate to the project directory
  3. Install requirements by typing in the terminal:
pip install -r requirements.txt
  1. Run the main.py file:
python main.py

API

pip install z-rad

License

Z-Rad is an open-source project licensed under the MIT License.

Contact

For any questions or feedback, please contact us at zrad@usz.ch.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

z_rad-25.12.1.tar.gz (57.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

z_rad-25.12.1-py3-none-any.whl (52.6 kB view details)

Uploaded Python 3

File details

Details for the file z_rad-25.12.1.tar.gz.

File metadata

  • Download URL: z_rad-25.12.1.tar.gz
  • Upload date:
  • Size: 57.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for z_rad-25.12.1.tar.gz
Algorithm Hash digest
SHA256 79f62e36d66f89fea3caee1a0ced8a9bdcf4643a9336d5201daf0ee953f04e41
MD5 24e2cb392c2d5beb932c715744f52994
BLAKE2b-256 ed166143cc03b86869ede4a0dcef743c2bf7eb77bd4ac94b3a0610bdd56fbf25

See more details on using hashes here.

File details

Details for the file z_rad-25.12.1-py3-none-any.whl.

File metadata

  • Download URL: z_rad-25.12.1-py3-none-any.whl
  • Upload date:
  • Size: 52.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for z_rad-25.12.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8f4ef619b3a7f9f268ba6fb4ca28f95fe0f7bbd58d8c70a62ea48d2f983a876a
MD5 fa4229644d434fac619e59b06d046b34
BLAKE2b-256 7357bdedca28b934e7a68332ffaf248bab62c88831004eb233a13f5583a97a9e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page