I-WINDOWING Module

The I-WINDOWING module allows users to perform image windowing by setting a window level (WL) and width (WW), or by using predefined windows for common clinical imaging protocols. This module includes several predefined windows sourced from Radiopaedia and Mayo Clinic for specific anatomical regions.

Predefined Windows

RADIOPAEDIA
https://radiopaedia.org/
    head and neck
        'CT_brain' WW:80 WL:40
        'CT_subdural_1' WW:130 WL:50
        'CT_subdural_2' WW:300 WL:100
        'CT_subdural_3' WW:215 WL:75
        'CT_stroke_1' WW:8 WL:32
        'CT_stroke_2' WW:40 WL:40
        'CT_temporal_bones_1' WW:2800 WL:600
        'CT_temporal_bones_2' WW:4000 WL:700
        'CT_HN_soft_tissues_1' WW:350 WL:20
        'CT_HN_soft_tissues_2' WW:400 WL:60
        'CT_HN_soft_tissues_3' WW:375 WL:45

    chest
        'CT_lungs' WW:1500 WL:-600
        'CT_mediastinum' WW:350 WL:50

    abdomen
        'CT_AB_soft_tissues' WW:400 WL:50
        'CT_liver' WW:150 WL:30

    spine
        'CT_SP_soft_tissues' WW:250 WL:50
        'CT_bone' WW:1800 WL:400

MAYO CLINIC
https://doi.org/10.1053/j.gastro.2022.06.066
    'CT_pancreas' WW:500 WL:50

Options

The I-WINDOWING module supports the following options:

  • verbose: Enable verbose output for detailed process information (default: False).

  • timer: Enable a timer to record execution time (default: False).

  • inputFolder: Path to the folder containing the input images.

  • outputFolder: Path to save the windowed images.

  • outputFolderSuffix: Adds a suffix to the inputFolder name to create the output folder.

  • log: Path to a log file for saving detailed output information.

  • new_log_file: Create a new log file, overwriting any existing file with the same name.

  • skip: Path to a file listing subfolders in inputFolder to exclude from processing.

  • multiprocessing: Specify the number of CPU cores to use for parallel processing.

  • image_filename: Name of the image file to apply windowing.

  • windowed_image_filename: Name for the output windowed image.

  • suffix_name: Suffix to add to the output image name. Overrides windowed_image_filename if specified.

  • window_width: Range of intensity values within the image.

  • window_level: Midpoint intensity value for the range.

  • window_name: Name of the predefined window to apply.

Example Usage

The following example demonstrates how to use the I-WINDOWING module:

I-WINDOWING:
{
    inputFolder: /path/to/NIFTI_folder
    image_filename: img.nii.gz
    windowed_image_filename: img_w.nii.gz
    window_name: CT_pancreas
    log: /path/to/logs/windowing.log
}

In this example:

  • inputFolder: Specifies the folder containing the images to window.

  • image_filename and windowed_image_filename: Define the input and output filenames for the windowed image.

  • window_name: Uses the predefined CT_pancreas windowing values.

  • log: Specifies the log file path to record processing details.

NiftiWindowing_multiprocessing.main(argv)[source]
NiftiWindowing_multiprocessing.windowing(patient, inpath, outpath, w_level, w_width, img_name, w_img_name, dif_path, skip_files, include_files, verbose, log)[source]
NiftiWindowing_multiprocessing.windows_preset(preset)[source]