Diff of /README.md [000000] .. [249e74]

Switch to unified view

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!