This repository hosts the implementation and resources for the automated Mean Linear Intercept (MLI) measurement system. The related paper has been accepted in the 47th Canadian Medical and Biological Engineering Society (CMBEC47) Conference.
The system is designed to calculate the MLI from histopathological images of lung tissue using a deep learning-based approach for semantic segmentation.
-
Automated MLI Measurement:
- Supports both direct and indirect methods.
- Accurately segments lung structures such as alveoli, alveolar septa, blood vessels, and bronchi using a multiresolution convolutional neural network (CNN).
- Evaluates thousands of field-of-view (FOV) images for robust MLI scoring.
-
Graphical User Interface (GUI):
- Intuitive and user-friendly interface for parameter adjustment and batch processing.
- Real-time feedback on progress and results.
-
Customizable Parameters:
- FOV size and stride.
- Guideline length in µm.
- Save FOVs and MLI method options.
- Image Preprocessing: Normalizes color variations to ensure consistent segmentation.
- Semantic Segmentation: Identifies lung structures using a trained CNN model.
- Field-of-View Extraction: Generates FOV images from WSIs using a sliding window approach.
- Field-of-View Screening: Accepts or rejects FOVs based on specified criteria.
- MLI Measurement: Calculates MLI using direct and/or indirect method.
The system uses avalible GPU for the semantic segmentation and CPU to compute the MLI score.
- Anaconda Framework: To manage the Python environment and dependencies.
- Python: Version 3.9.0
- CUDA: Version 11.2
- cuDNN: Version 8.1
- TensorFlow: Version 2.10
- Required Python Packages: Listed in
requirements.txt
-
Clone the repository:
git clone https://github.com/atallahmadi/e2emli.git cd e2emli -
Download the pre-trained models from:
-
Set up the Python 3.9 environment:
conda create --name MLI Python==3.9 conda activate MLI
-
Install CUDA Toolkit and cuDNN:
conda install -c conda-forge cudatoolkit=11.2 cudnn=8.1.0
-
Install required dependencies:
pip install -r requirements.txt
-
Launch the GUI:
python app.py
If you use this system, please cite the following paper:
Atallah Madi, Adrian D.C. Chan. "End-To-End Automated Mean Linear Intercept Measurement System." 47th Canadian Medical and Biological Engineering Society Conference. 2025.
This project was supported by the Natural Sciences and Engineering Research Council of Canada (NSERC) and clinical collaborators at the University of Ottawa and the Ottawa Hospital Research Institute.
For questions or collaboration inquiries, please contact:
- Atallah Madi - [email protected]
- Dr. Adrian D.C. Chan - [email protected]
