canadacovidmetrics

This is a Python package that provides key metrics regarding COVID-19 situation in Canada across provinces using the OpenCovid API.

Summary

This package allows users to obtain key metrics on COVID-19 situation in Canada at national or provincial level for a specific time period. The 4 functions will return key metrics, including total cumulative cases, total cumulative deaths, total cumulative recovered cases and total cumulative vaccine completion, using data from OpenCovid API. The users may use the key metrics to conduct further analyses on COVID-19 situation in Canada.

Functions

There are 4 functions in this package:

get_cases Query total cumulative cases with ability to specify province and date range of returned data.
get_deaths Query total cumulative deaths with ability to specify province and date range of returned data.
get_recoveries Query total cumulative recovered cases with ability to specify province and date range of returned data.
get_vaccinations Query total cumulative vaccine completion with ability to specify province and date range of returned data.

Installation

$ pip install canadacovidmetrics

Usage & Examples

Total number of deaths over past week by province

from canadacovidmetrics import canadacovidmetrics as ccm
import datetime as dt
deaths_last_week = ccm.get_deaths(after=str(dt.date.today() - dt.timedelta(days=7)))
deaths_last_week.groupby('province').sum('deaths').plot.barh(y='deaths', title='Deaths by province in past week');

National vaccination completion in 2021

from canadacovidmetrics import canadacovidmetrics as ccm
vaccines_2021 = ccm.get_vaccinations(loc='canada', after='2021-01-01', before='2021-12-31')
vaccines_2021.plot('date_vaccine_completed', 'cumulative_cvaccine', title='Cumulative national vaccinations');

Daily new case count by province

from canadacovidmetrics import canadacovidmetrics as ccm
cases_data = ccm.get_cases().set_index('date_report')
cases_data.groupby('province')['cases'].plot(legend=True, figsize=(10,6), title='Number of reported cases by day by province');

Python ecosystem

There are several packages for easy access to COVID-19 key metrics or data using different APIs, examples include

To our knowledge, there is no similar package using OpenCovid API in the Python ecosystem.

Documentation

Documentation canadacovidmetrics can be found at Read the Docs

Contributors

Adam Morphy (@adammorphy)
Brandon Lam (@ming0701)
Lakshmi Santosha Valli Akella (@valli180)
Luke Collins (@LukeAC)

We welcome and recognize all contributions. Please find the guide for contribution in Contributing Document.

License

canadacovidmetrics was created by the Contributors. The dependant API from the COVID-19 Canada Open Data Working Group dataset project has adopted the Creative Commons Attribution 4.0 International license, which allows freedom of two primary contributions:

Sharing — copy and redistribute the material in any medium or format Adapting — remix, transform, and build upon the material for any purpose, even commercially.

As contributors to this community, our package has adopted the same creative commons license, in order to enable anyone to share or adapt the Canada Covid Metrics package in R or Python subject to the license.

Credits

canadacovidmetrics was created with cookiecutter and the py-pkgs-cookiecutter template.