Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/AaronWard/covidify

Covidify - corona virus report and dataset generator for python 📈 [no longer being updated]
https://github.com/AaronWard/covidify

2019-ncov 2019ncov 2020ncov coronavirus coronavirus-analysis coronavirus-real-time covid covid-19 covid-virus covidify jhu-csse ncov pandemic trend virus

Last synced: 3 months ago
JSON representation

Covidify - corona virus report and dataset generator for python 📈 [no longer being updated]

Host: GitHub
URL: https://github.com/AaronWard/covidify
Owner: AaronWard
License: mit
Created: 2020-01-30T00:08:53.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2021-04-22T03:49:58.000Z (almost 4 years ago)
Last Synced: 2024-07-23T22:04:13.827Z (6 months ago)
Topics: 2019-ncov, 2019ncov, 2020ncov, coronavirus, coronavirus-analysis, coronavirus-real-time, covid, covid-19, covid-virus, covidify, jhu-csse, ncov, pandemic, trend, virus
Language: Jupyter Notebook
Homepage:
Size: 90.9 MB
Stars: 447
Watchers: 22
Forks: 114
Open Issues: 54
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

# covidify [![PyPi Version](https://img.shields.io/pypi/v/covidify.svg)](https://pypi.python.org/pypi/covidify/) ![PyPI - Downloads](https://img.shields.io/pypi/dm/covidify) ![PyPI - License](https://img.shields.io/pypi/l/covidify?color=yellow) [![Python Versions](https://img.shields.io/pypi/pyversions/yt2mp3.svg)](https://pypi.python.org/pypi/covidify/)

Features •
How To Use •
Install •
Visualizations •
Data Source •
Credits •
To-Do List

## Features
Covidify downloads the latest [covid-19](https://www.who.int/health-topics/coronavirus) data for confirmed cases, deaths and recoveries.
- Creates a time series dataset
- Creates a daily stats dataset
- Forecast global and country confirmed cases
- Generate visualizations
- Filter by country
- List all countries affected
- Shows number of people currently infected
- Generates an excel report including all of the above

![logo](./resources/run.gif "logo")

## Install

- ```pip install covidify```

## How to use

```powershell
$ covidify
Usage: covidify [OPTIONS] COMMAND [ARGS]...

☣ COVIDIFY ☣

- use the most up-to-date data to generate reports of
confirmed cases, fatalities and recoveries.

Options:
--help Show this message and exit.

Commands:
list List all the countries that have confirmed cases.
run Generate reports for global cases or refine by country.
```

```powershell
$ covidify run --help
Usage: covidify run [OPTIONS]

Options:
--output TEXT Folder to output data and reports [Default:
/Users/award40/Desktop/covidify-output/]
--source TEXT There are two datasources to choose from, Johns Hopkins
github repo or wikipedia -- options are JHU or wiki
respectively [Default: JHU]
--country TEXT Filter reports by a country
--top TEXT Top N infected countries for log plot. [Default: 10]
--forecast TEXT Number of days to forecast cumulative cases in the future.
[Default: 15]
--help Show this message and exit.
```

**Example Commands:**

```powershell
# List all countries affected
covidify list --countries
```

```powershell
# Will default to desktop folder for output and github for datasource
covidify run
```

```powershell
# Specify output folder and source
covidify run --output=
```

```powershell
# Filter reports by country
covidify run --country="South Korea"
```

```powershell
# Show top 20 infected countries on a logarithmic scale
covidify run --top=20
```

```powershell
# Forecast cumulative cases in America for 14 days into the future
covidify run --country=America --forecast=14
```

## Visualizations
An excel spreadsheet is generated with a number of visualizations and statistics.

![logo](./resources/report.gif "logo")

##### Logarithmic Plot

This plot shows the top `N` infected countries on a logarithmic scale.
![alt text](./reports/images/confirmed_log.png)

##### Forecasting

An ARIMA model is trained and used to forecast the cumulative cases for `N` number of days
into the future (DISCLAIMER: the forecast is a ballpark figure, and should not be taken as gospel)
![alt text](./reports/images/cumulative_forecasts.png)

##### Accumulative Trend

This is an accumulative sum trendline for all the confirmed cases, deaths and recoveries.
![alt text](./reports/images/confirmed_trendline.png)

##### Daily Trendline

This is a daily sum trendline for all the confirmed cases, deaths and recoveries.
![alt text](./reports/images/new_confirmed_cases_trendline.png)

##### Stacked Daily Confirmed Cases

This stacked bar chart shows a daily sum of people who are already confirmed (red) and the people who have been confirmed on that date (blue)

![alt text](./reports/images/confirmed_cases_stacked_bar.png "Number of people actually with the virus for each day")

##### Daily Confirmed Cases

A count for new cases on a given date, does not take past confirmations into account.
![alt text](./reports/images/new_confirmed_cases_bar.png)

##### Daily Deaths

A count for deaths on a given date, does not take past deaths into account.
![alt text](./reports/images/new_deaths_bar.png)

##### Daily Recoveries

A count for new recoveries on a given date, does not take past recoveries into account.
![alt text](./reports/images/new_recoveries_bar.png)

##### Currently Infected

A count for all the people who are currently infected for a given date.
![alt text](./reports/images/currently_infected_bar.png)

## Credits
- Written by me (Aaron Ward - https://www.linkedin.com/in/aaronjward/)
- A special thank you to the [JHU CSSE](https://systems.jhu.edu/) team for maintaining the data
- Also a special thank you to @ajaymaity for bug fixes 🎉