README.md

Implementation of Camelyon'16 grand challenge (Not maintaining anymore!)

This repository contains the source code for deep learning based cancer detection system, developed to identify metastatic breast cancer from digital Whole Slide Images (WSI). Using dataset of the Camelyon’16 grand challenge, developed system obtained an area under the receiver operating curve (ROC) of 92.57%, which is superior than results obtained by the winning method of Camelyon’16 grand challenge, developed by Harvard & MIT research laboratories.

See presentation and report for detailed information about developed system, various implementations and environmental setup.

Requirements

• python 3.5.x or above
• Tensorflow 0.12.1 or above (GPU version)
• OpenSlide
• sk-learn
• sk-image
• open-cv v3.0
• numPy, sciPy

Modules

• ops
  • contains sub-modules for performing common operations
    • reading WSIs (wsi_ops.py)
    • extracting patches from WSIs (wsi_ops.py)
    • file ops (copy, move, delete, rename, and search patches) (file_ops.py)
• preprocess
  • contains sub-modules for data pre-processing
    • find Region of Interest (ROI) for WSIs (wsi_ops.py)
    • extract training patches from WSIs (extract_patches.py)
    • build TF-Records for training patches (build_tf_records.py)
• postprocess
  • contains sub-modules related to post-processing
    • extract patches for heatmaps (extract_patches_heatmap.py)
    • building TF-Records for heatmaps (build_tf_records_heatmap.py)
    • building heatmaps (build_heatmap.py)
    • extract features from heatmaps (extract_feature_heatmap.py)
    • feature classifiers (SVM, Random Forest) (wsi_classification_modular.py)
• inception
  • contains implementation of inception-v3 deep network.
    • defining inception-v3 architecture (inception_model.py)
    • training inception-v3 (inception_train.py)
    • evaluating inception-v3 (inception_eval.py)
    • implementation of TF-Slim (slim)