README.md 7.98 KB
Newer Older
1 2
# COVID-Net Open Source Initiative

Linda Wang's avatar
Linda Wang committed
3
**Note: The COVID-Net models provided here are intended to be used as reference models that can be built upon and enhanced as new data becomes available. They are currently at a research stage and not yet intended as production-ready models (not meant for direct clinical diagnosis), and we are working continuously to improve them as new data becomes available. Please do not use COVID-Net for self-diagnosis and seek help from your local health authorities.**
4

Linda Wang's avatar
Linda Wang committed
5
**Recording to webinar on [How we built COVID-Net in 7 days with Gensynth](https://darwinai.news/fny)**
lindawangg's avatar
lindawangg committed
6

7
**Update 04/16/2020:** If you have questions, please check the new [FAQ](docs/FAQ.md) page first.\
lindawangg's avatar
FAQ  
lindawangg committed
8 9
**Update 04/15/2020:** We released two new models, COVIDNet-CXR Small and COVIDNet-CXR Large, which were trained on a new COVIDx Dataset with both PA and AP X-Rays from Cohen et al, as well as additional COVID-19 X-Ray images from Figure1.

lindawangg's avatar
lindawangg committed
10
<p align="center">
lindawangg's avatar
lindawangg committed
11
	<img src="assets/covidnet-cxr-small-exp.png" alt="photo not available" width="70%" height="70%">
lindawangg's avatar
lindawangg committed
12 13 14
	<br>
	<em>Example chest radiography images of COVID-19 cases from 2 different patients and their associated critical factors (highlighted in red) as identified by GSInquire.</em>
</p>
lindawangg's avatar
test  
lindawangg committed
15

lindawangg's avatar
lindawangg committed
16
The COVID-19 pandemic continues to have a devastating effect on the health and well-being of the global population.  A critical step in the fight against COVID-19 is effective screening of infected patients, with one of the key screening approaches being radiological imaging using chest radiography.  It was found in early studies that patients present abnormalities in chest radiography images that are characteristic of those infected with COVID-19.  Motivated by this, a number of artificial intelligence (AI) systems based on deep learning have been proposed and results have been shown to be quite promising in terms of accuracy in detecting patients infected with COVID-19 using chest radiography images.  However, to the best of the authors' knowledge, these developed AI systems have been closed source and unavailable to the research community for deeper understanding and extension, and unavailable for public access and use.  Therefore, in this study we introduce COVID-Net, a deep convolutional neural network design tailored for the detection of COVID-19 cases from chest radiography images that is open source and available to the general public.  We also describe the chest radiography dataset leveraged to train COVID-Net, which we will refer to as COVIDx and is comprised of 13,800 chest radiography images across 13,725 patient patient cases from three open access data repositories.  Furthermore, we investigate how COVID-Net makes predictions using an explainability method in an attempt to gain deeper insights into critical factors associated with COVID cases, which can aid clinicians in improved screening.  **By no means a production-ready solution**, the hope is that the open access COVID-Net, along with the description on constructing the open source COVIDx dataset, will be leveraged and build upon by both researchers and citizen data scientists alike to accelerate the development of highly accurate yet practical deep learning solutions for detecting COVID-19 cases and accelerate treatment of those who need it the most.
lindawangg's avatar
lindawangg committed
17

lindawangg's avatar
lindawangg committed
18
For a detailed description of the methodology behind COVID-Net and a full description of the COVIDx dataset, please click [here](https://arxiv.org/abs/2003.09871v3).
19

20
Currently, the COVID-Net team is working on **COVID-RiskNet**, a deep neural network tailored for COVID-19 risk stratification.  Currently this is available as a work-in-progress via included `train_risknet.py` script, help to contribute data and we can improve this tool.
lindawangg's avatar
lindawangg committed
21

22
If you would like to **contribute COVID-19 x-ray images**, please submit to https://figure1.typeform.com/to/lLrHwv. Lets all work together to stop the spread of COVID-19!
lindawangg's avatar
lindawangg committed
23

lindawangg's avatar
lindawangg committed
24
If you are a researcher or healthcare worker and you would like access to the **GSInquire tool to use to interpret COVID-Net results** on your data or existing data, please reach out to a28wong@uwaterloo.ca or alex@darwinai.ca
lindawangg's avatar
lindawangg committed
25

lindawangg's avatar
lindawangg committed
26
Our desire is to encourage broad adoption and contribution to this project. Accordingly this project has been licensed under the GNU Affero General Public License 3.0. Please see [license file](LICENSE.md) for terms. If you would like to discuss alternative licensing models, please reach out to us at linda.wang513@gmail.com and a28wong@uwaterloo.ca or alex@darwinai.ca
lindawangg's avatar
lindawangg committed
27

lindawangg's avatar
FAQ  
lindawangg committed
28
If there are any technical questions after the README, FAQ, and past/current issues have been read, please post an issue or contact:
Desmond Lin's avatar
Desmond Lin committed
29 30 31
* desmond.zq.lin@gmail.com
* paul@darwinai.ca
* jamesrenhoulee@gmail.com
lindawangg's avatar
lindawangg committed
32
* linda.wang513@gmail.com
lindawangg's avatar
lindawangg committed
33
* ashkan.ebadi@nrc-cnrc.gc.ca
lindawangg's avatar
lindawangg committed
34

lindawangg's avatar
lindawangg committed
35 36 37 38 39
If you find our work useful, can cite our paper using:

```
@misc{wang2020covidnet,
    title={COVID-Net: A Tailored Deep Convolutional Neural Network Design for Detection of COVID-19 Cases from Chest Radiography Images},
lindawangg's avatar
lindawangg committed
40
    author={Linda Wang, Zhong Qiu Lin and Alexander Wong},
lindawangg's avatar
lindawangg committed
41 42 43 44 45 46 47
    year={2020},
    eprint={2003.09871},
    archivePrefix={arXiv},
    primaryClass={cs.CV}
}
```

lindawangg's avatar
lindawangg committed
48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
## Core COVID-Net Team
* DarwinAI Corp., Canada and Vision and Image Processing Research Group, University of Waterloo, Canada
	* Linda Wang
	* Alexander Wong
	* Zhong Qiu Lin
	* James Lee
	* Paul McInnis
	* Audrey Chung
	* Hayden Gunraj
* Matt Ross and Blake VanBerlo (City of London), COVID-19 Chest X-Ray Model: https://github.com/aildnont/covid-cxr
* Ashkan Ebadi (National Research Council Canada)
* Kim-Ann Git (Selayang Hospital)
* Abdul Al-Haimi

## Table of Contents
1. [Requirements](#requirements) to install on your system
2. How to [generate COVIDx dataset](docs/COVIDx.md)
3. Steps for [training, evaluation and inference](docs/train_eval_inference.md)
4. [Results](#results)
5. [Links to pretrained models](docs/models.md)

lindawangg's avatar
lindawangg committed
69
## Requirements
70 71 72

The main requirements are listed below:

lindawangg's avatar
lindawangg committed
73 74
* Tested with Tensorflow 1.13 and 1.15
* OpenCV 4.2.0
lindawangg's avatar
lindawangg committed
75
* Python 3.6
76 77 78 79 80 81
* Numpy
* Scikit-Learn
* Matplotlib

Additional requirements to generate dataset:

82
* PyDicom
83 84
* Pandas
* Jupyter
lindawangg's avatar
lindawangg committed
85

86
## Results
lindawangg's avatar
lindawangg committed
87
These are the final results for COVIDNet-CXR Small and COVIDNet-CXR Large.
lindawangg's avatar
lindawangg committed
88

lindawangg's avatar
lindawangg committed
89
### COVIDNet-CXR Small
Linda Wang's avatar
Linda Wang committed
90
<p>
lindawangg's avatar
lindawangg committed
91
	<img src="assets/cm-covidnetcxr-small.png" alt="photo not available" width="50%" height="50%">
92
	<br>
lindawangg's avatar
lindawangg committed
93
	<em>Confusion matrix for COVIDNet-CXR Small on the COVIDx test dataset.</em>
94
</p>
lindawangg's avatar
lindawangg committed
95

Linda Wang's avatar
Linda Wang committed
96
<div class="tg-wrap"><table class="tg">
97 98 99 100 101 102 103 104 105
  <tr>
    <th class="tg-7btt" colspan="3">Sensitivity (%)</th>
  </tr>
  <tr>
    <td class="tg-7btt">Normal</td>
    <td class="tg-7btt">Pneumonia</td>
    <td class="tg-7btt">COVID-19</td>
  </tr>
  <tr>
lindawangg's avatar
lindawangg committed
106 107 108
    <td class="tg-c3ow">97.0</td>
    <td class="tg-c3ow">90.0</td>
    <td class="tg-c3ow">87.1</td>
109 110
  </tr>
</table></div>
lindawangg's avatar
lindawangg committed
111

Linda Wang's avatar
Linda Wang committed
112
<div class="tg-wrap"><table class="tg">
113 114 115 116 117 118 119 120 121
  <tr>
    <th class="tg-7btt" colspan="3">Positive Predictive Value (%)</th>
  </tr>
  <tr>
    <td class="tg-7btt">Normal</td>
    <td class="tg-7btt">Pneumonia</td>
    <td class="tg-7btt">COVID-19</td>
  </tr>
  <tr>
lindawangg's avatar
lindawangg committed
122 123 124
    <td class="tg-c3ow">89.8</td>
    <td class="tg-c3ow">94.7</td>
    <td class="tg-c3ow">96.4</td>
125 126 127
  </tr>
</table></div>

lindawangg's avatar
lindawangg committed
128 129

### COVIDNet-CXR Large
Linda Wang's avatar
Linda Wang committed
130
<p>
lindawangg's avatar
lindawangg committed
131
	<img src="assets/cm-covidnetcxr-large.png" alt="photo not available" width="50%" height="50%">
lindawangg's avatar
lindawangg committed
132
	<br>
lindawangg's avatar
lindawangg committed
133
	<em>Confusion matrix for COVIDNet-CXR Large on the COVIDx test dataset.</em>
lindawangg's avatar
lindawangg committed
134 135
</p>

Linda Wang's avatar
Linda Wang committed
136
<div class="tg-wrap"><table class="tg">
lindawangg's avatar
lindawangg committed
137
  <tr>
138
    <th class="tg-7btt" colspan="3">Sensitivity (%)</th>
lindawangg's avatar
lindawangg committed
139 140 141
  </tr>
  <tr>
    <td class="tg-7btt">Normal</td>
142 143
    <td class="tg-7btt">Pneumonia</td>
    <td class="tg-7btt">COVID-19</td>
lindawangg's avatar
lindawangg committed
144 145
  </tr>
  <tr>
lindawangg's avatar
lindawangg committed
146 147 148
    <td class="tg-c3ow">99.0</td>
    <td class="tg-c3ow">89.0</td>
    <td class="tg-c3ow">96.8</td>
lindawangg's avatar
lindawangg committed
149 150 151
  </tr>
</table></div>

Linda Wang's avatar
Linda Wang committed
152
<div class="tg-wrap"><table class="tg">
lindawangg's avatar
lindawangg committed
153
  <tr>
154
    <th class="tg-7btt" colspan="3">Positive Predictive Value (%)</th>
lindawangg's avatar
lindawangg committed
155 156 157
  </tr>
  <tr>
    <td class="tg-7btt">Normal</td>
158 159
    <td class="tg-7btt">Pneumonia</td>
    <td class="tg-7btt">COVID-19</td>
lindawangg's avatar
lindawangg committed
160 161
  </tr>
  <tr>
lindawangg's avatar
lindawangg committed
162 163 164
    <td class="tg-c3ow">91.7</td>
    <td class="tg-c3ow">98.9</td>
    <td class="tg-c3ow">90.9</td>
lindawangg's avatar
lindawangg committed
165 166
  </tr>
</table></div>