Giter Club home page Giter Club logo

covidify's Introduction

covidify PyPi Version PyPI - Downloads PyPI - License Python Versions Buy Me a Coffee at ko-fi.com

Features โ€ข How To Use โ€ข Install โ€ข Visualizations โ€ข Data Source โ€ข Credits โ€ข To-Do List


Features

Covidify downloads the latest covid-19 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


Install

  • pip install covidify

How to use

$ 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.
$ 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:

# List all countries affected 
covidify list --countries
# Will default to desktop folder for output and github for datasource
covidify run 
# Specify output folder and source
covidify run --output=<PATH TO DESIRED OUTPUT FOLDER>
# Filter reports by country
covidify run --country="South Korea"
# Show top 20 infected countries on a logarithmic scale
covidify run --top=20
# 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

Logarithmic Plot

This plot shows the top N infected countries on a logarithmic scale. alt text

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

Accumulative Trend

This is an accumulative sum trendline for all the confirmed cases, deaths and recoveries. alt text

Daily Trendline

This is a daily sum trendline for all the confirmed cases, deaths and recoveries. alt text

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

Daily Confirmed Cases

A count for new cases on a given date, does not take past confirmations into account. alt text

Daily Deaths

A count for deaths on a given date, does not take past deaths into account. alt text

Daily Recoveries

A count for new recoveries on a given date, does not take past recoveries into account. alt text

Currently Infected

A count for all the people who are currently infected for a given date. alt text


Credits

covidify's People

Contributors

aaronward avatar barberw-osu avatar creeble avatar kant avatar pnuw avatar weisisheng avatar ajaymaity avatar barneshere avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.