|
a |
|
b/README.md |
|
|
1 |
Robust blood Detection Model through weakly supervised localization, self-supervised pretraining, adversarial training, 3D convolutions, and video frame modeling. |
|
|
2 |
Overview |
|
|
3 |
This repository provides a PyTorch deep neural network for classifying microscope images of blood cells as benign or malignant. The model achieves high accuracy and generalizability by leveraging: |
|
|
4 |
Weakly supervised localization to identify explanatory regions used by the classifier via class activation mappings |
|
|
5 |
Self-supervised pretraining on unlabeled blood cell video data to prime feature extraction layers |
|
|
6 |
Test-time adversarial training to improve model robustnes to small input perturbations |
|
|
7 |
3D convolutions to analyze volumetric shape cues rather than flattened 2D images |
|
|
8 |
Video frame order modeling for additional temporal self-supervision |
|
|
9 |
Combined, these techniques improve predictive performance while providing intepretability. |
|
|
10 |
|
|
|
11 |
-Installation |
|
|
12 |
This code requires Python 3.8+ and Poetry for dependency management. Install dependencies with: |
|
|
13 |
|
|
|
14 |
poetry install |
|
|
15 |
|
|
|
16 |
-Activate the Poetry environment for usage: |
|
|
17 |
|
|
|
18 |
poetry shell |
|
|
19 |
|
|
|
20 |
-Usage |
|
|
21 |
To train the model on the blood_cell_videos dataset: |
|
|
22 |
|
|
|
23 |
python training/trainer.py --data-dir /path/to/blood_cells --epochs 100 --lr 0.001 |
|
|
24 |
|
|
|
25 |
This will configure the neural architecture, leverage unlabeled videos for self-supervision, and fit the model parameters on the labeled dataset. |
|
|
26 |
|
|
|
27 |
-Contributing |
|
|
28 |
Contributions to improving the weakly supervised and self-supervised components are greatly welcome! Please open issues for any bugs or desired functionality. |
|
|
29 |
|
|
|
30 |
-License |
|
|
31 |
This project is licensed under the MIT license. See LICENSE.md for details. |
|
|
32 |
Let me know if you would like any additional sections or more information added! |