Diff of /README.md [000000] .. [f757a9]

Switch to unified view

a b/README.md
1
#  Acute Myeloid & Lymphoblastic Leukemia Detection Model
2
## Acute Lymphoblastic Leukemia PyTorch Classifier 
3
4
 
5
6
# Table Of Contents
7
8
- [Introduction](#introduction)
9
- [DISCLAIMER](#disclaimer)
10
- [Getting Started](#getting-started)
11
- [ALL-IDB](#all-idb])
12
  - [ALL_IDB1](#all_idb1])
13
- [Contributing](#contributing)
14
  - [Contributors](#contributors)
15
- [Versioning](#versioning)
16
- [License](#license)
17
- [Bugs/Issues](#bugs-issues)
18
19
 
20
21
# Introduction
22
 PyTorch Acute Lymphoblastic Leukemia Detection using convolutional neural networks model.
23
24
 
25
26
# DISCLAIMER
27
28
This project should be used for research purposes only. Please don't use in hospital on real patiences
29
30
 
31
32
# Getting Started
33
34
To get started follow the [installation guide](Documentation/Installation.md) to find out how to clone the repository.
35
36
 
37
38
# ALL-IDB
39
40
You need to be granted access to use the Acute Lymphoblastic Leukemia Image Database for Image Processing dataset. You can find the application form and information about getting access to the dataset on [this page](https://homes.di.unimi.it/scotti/all/#download) as well as information on how to contribute back to the project [here](https://homes.di.unimi.it/scotti/all/results.php). If you are not able to obtain a copy of the dataset please feel free to try this tutorial on your own dataset, we would be very happy to find additional AML & ALL datasets.
41
42
## ALL_IDB1 
43
44
In this project, [ALL-IDB1](https://homes.di.unimi.it/scotti/all/#datasets) is used, one of the datsets from the Acute Lymphoblastic Leukemia Image Database for Image Processing dataset. We will use data augmentation to increase the amount of training and testing data we have.
45
46
"The ALL_IDB1 version 1.0 can be used both for testing segmentation capability of algorithms, as well as the classification systems and image preprocessing methods. This dataset is composed of 108 images collected during September, 2005. It contains about 39000 blood elements, where the lymphocytes has been labeled by expert oncologists. The images are taken with different magnifications of the microscope ranging from 300 to 500."
47
48
 
49
50
# Classifier
51
52
Model Results
53
54
| OS | Hardware | Training | Validation | Test | Accuracy | Recall | Precision | AUC/ROC |
55
| -------------------- | -------------------- | -------------------- | ----- | ---------- | ---------- | ---------- | ---------- | ---------- |
56
| Google Colab | Tesla K80 GPU | 1180 |  404 | 20 |  1.0 | 1.0 | 1.0 | 0.9948964 |
57
| Windows 10 | NVIDIA GeForce 940MX | 1180 |  404 | 20 |  1.0 | 1.0 | 1.0 | 0.9908836 |
58
59
 
60
61
# Contributing
62
63
Code contributions are welcome, bug fixes and enhancements from the Github.
64
65
Please read the [CONTRIBUTING](CONTRIBUTING.md "CONTRIBUTING") document for a full guide to forking our repositories and submitting your pull requests. You will also find information about our code of conduct on this page.
66
67
## Contributors
68
69
- Allen Akhaumere  - [Mascot Defense](https://mascotit.com.ng/ "Mascot Defense") Co-founder and CTO at Mascot Defense
70
71
 
72
73
# Versioning
74
75
 
76
77
# License
78
79
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE.md "LICENSE") file for details.
80
81
 
82
83
# Bugs/Issues
84
85
I use the [repo issues](issues "repo issues") to track bugs and general requests related to using this project. See [CONTRIBUTING](CONTRIBUTING.md "CONTRIBUTING") for more info on how to submit bugs, feature requests and proposals.