covxnet


Namecovxnet JSON
Version 1.0.0 PyPI version JSON
download
home_pagehttps://github.com/awsaf49/CovXNet
SummaryOfficial Implementation of CovXNet using Tensorflow 2.0
upload_time2023-07-23 16:42:53
maintainer
docs_urlNone
authorAwsaf
requires_python>=3.6
licenseApache License 2.0
keywords cnn computer_vision covid19 medical_imaging
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # [CovXNet: A Multi-Dilation Convolutional Neural Network for Automatic COVID-19 and Other Pneumonia Detection from Chest X-ray Images with Transferable Multi-Receptive Feature Optimization](https://www.sciencedirect.com/science/article/pii/S0010482520302250)

**Abstract:**

With the recent outbreak of COVID-19, fast diagnostic testing has become one of the major challenges due to the critical shortage of test kit. Pneumonia, a major effect of COVID-19, needs to be urgently diagnosed along with its underlying reasons. In this paper, deep learning aided automated COVID-19 and other pneumonia detection scheme is proposed utilizing a small amount of COVID-19 chest X-rays. A deep convolutional neural network (CNN) based architecture, named as CovXNet, is proposed that utilizes depthwise convolution with varying dilation rates for efficiently extracting diversified features from chest X-rays. Since the chest X-ray images corresponding to COVID-19 caused pneumonia and other traditional pneumonia have significant similarities, at first, a large number of chest X-rays corresponding to normal and (viral/bacterial) pneumonia patients are used to train the proposed CovXNet. Learning of this initial training phase is transferred with some additional fine-tuning layers that are further trained with a smaller number of chest X-rays corresponding to COVID-19 and other pneumonia patients. In the proposed method, different forms of CovXNets are designed and trained with X-ray images of various resolutions and for further optimization of their predictions, a stacking algorithm is employed. Finally, a gradient-based discriminative localization is integrated to distinguish the abnormal regions of X-ray images referring to different types of pneumonia. Extensive experimentations on two different datasets provide very satisfactory detection performance and thus the new scheme can serve as an efficient tool in the current state of COVID-19 pandemic.

**Paper link:** [here](https://www.sciencedirect.com/science/article/pii/S0010482520302250)

## Installation

Stable:
```bash
pip install covxnet
```

or

Latest:
```bash
pip install git+https://github.com/awsaf49/covxnet
```

## Usage

```python
from covxnet import CovXNet128
model = CovXNet128(input_shape=(128, 128, 3), num_classes=3)
```

## Example

**Notebook:** [Pneumonia Detection with CovXNet](https://www.kaggle.com/awsaf49/pneumonia-detection-with-covxnet)


## Method
**Visual Abstract:**

<img src="images/sketch.png" width="600">

**Ensemble Network:**

<img src="images/f4.jpg" width="600">

**Architecture:**

<img src="images/f5.jpg" width="600">

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/awsaf49/CovXNet",
    "name": "covxnet",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "cnn computer_vision covid19 medical_imaging",
    "author": "Awsaf",
    "author_email": "awsaf49@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/cd/7e/4f5db8c2c7e184e93177c3f200010d361aad3eac9cd13f0a86404d9ffc86/covxnet-1.0.0.tar.gz",
    "platform": null,
    "description": "# [CovXNet: A Multi-Dilation Convolutional Neural Network for Automatic COVID-19 and Other Pneumonia Detection from Chest X-ray Images with Transferable Multi-Receptive Feature Optimization](https://www.sciencedirect.com/science/article/pii/S0010482520302250)\n\n**Abstract:**\n\nWith the recent outbreak of COVID-19, fast diagnostic testing has become one of the major challenges due to the critical shortage of test kit. Pneumonia, a major effect of COVID-19, needs to be urgently diagnosed along with its underlying reasons. In this paper, deep learning aided automated COVID-19 and other pneumonia detection scheme is proposed utilizing a small amount of COVID-19 chest X-rays. A deep convolutional neural network (CNN) based architecture, named as CovXNet, is proposed that utilizes depthwise convolution with varying dilation rates for efficiently extracting diversified features from chest X-rays. Since the chest X-ray images corresponding to COVID-19 caused pneumonia and other traditional pneumonia have significant similarities, at first, a large number of chest X-rays corresponding to normal and (viral/bacterial) pneumonia patients are used to train the proposed CovXNet. Learning of this initial training phase is transferred with some additional fine-tuning layers that are further trained with a smaller number of chest X-rays corresponding to COVID-19 and other pneumonia patients. In the proposed method, different forms of CovXNets are designed and trained with X-ray images of various resolutions and for further optimization of their predictions, a stacking algorithm is employed. Finally, a gradient-based discriminative localization is integrated to distinguish the abnormal regions of X-ray images referring to different types of pneumonia. Extensive experimentations on two different datasets provide very satisfactory detection performance and thus the new scheme can serve as an efficient tool in the current state of COVID-19 pandemic.\n\n**Paper link:** [here](https://www.sciencedirect.com/science/article/pii/S0010482520302250)\n\n## Installation\n\nStable:\n```bash\npip install covxnet\n```\n\nor\n\nLatest:\n```bash\npip install git+https://github.com/awsaf49/covxnet\n```\n\n## Usage\n\n```python\nfrom covxnet import CovXNet128\nmodel = CovXNet128(input_shape=(128, 128, 3), num_classes=3)\n```\n\n## Example\n\n**Notebook:** [Pneumonia Detection with CovXNet](https://www.kaggle.com/awsaf49/pneumonia-detection-with-covxnet)\n\n\n## Method\n**Visual Abstract:**\n\n<img src=\"images/sketch.png\" width=\"600\">\n\n**Ensemble Network:**\n\n<img src=\"images/f4.jpg\" width=\"600\">\n\n**Architecture:**\n\n<img src=\"images/f5.jpg\" width=\"600\">\n",
    "bugtrack_url": null,
    "license": "Apache License 2.0",
    "summary": "Official Implementation of CovXNet using Tensorflow 2.0",
    "version": "1.0.0",
    "project_urls": {
        "Homepage": "https://github.com/awsaf49/CovXNet"
    },
    "split_keywords": [
        "cnn",
        "computer_vision",
        "covid19",
        "medical_imaging"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cc0f5ea1908898828ecf12423a5e533a7e6f2cb2a02eddedcb2fd8091809e13b",
                "md5": "8ed17638ed3b4c2d4972e4d45e1c35e0",
                "sha256": "bfe9030cd3e3d9cf7cbd7ae0e888086259ace0a33c0313fab9afbddabe3803f3"
            },
            "downloads": -1,
            "filename": "covxnet-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8ed17638ed3b4c2d4972e4d45e1c35e0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 9524,
            "upload_time": "2023-07-23T16:42:52",
            "upload_time_iso_8601": "2023-07-23T16:42:52.113879Z",
            "url": "https://files.pythonhosted.org/packages/cc/0f/5ea1908898828ecf12423a5e533a7e6f2cb2a02eddedcb2fd8091809e13b/covxnet-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cd7e4f5db8c2c7e184e93177c3f200010d361aad3eac9cd13f0a86404d9ffc86",
                "md5": "41a2b5ae40ec12be77d3acc0aee2d8f6",
                "sha256": "bbd77113da36f549aeb92246a8371e353f29d96ad97a0551a1065d91a9296532"
            },
            "downloads": -1,
            "filename": "covxnet-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "41a2b5ae40ec12be77d3acc0aee2d8f6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 8580,
            "upload_time": "2023-07-23T16:42:53",
            "upload_time_iso_8601": "2023-07-23T16:42:53.699752Z",
            "url": "https://files.pythonhosted.org/packages/cd/7e/4f5db8c2c7e184e93177c3f200010d361aad3eac9cd13f0a86404d9ffc86/covxnet-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-07-23 16:42:53",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "awsaf49",
    "github_project": "CovXNet",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "covxnet"
}
        
Elapsed time: 0.10343s