This package enables obtain key metrics regarding covid situation in Canada
Project description
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 "git+https://github.com/UBC-MDS/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
- covid using John Hopkins University API
- COVID19Py using Coronavirus Tracker API
- covid19pyclient using RKI API
To our knowledge, there is no similar package using OpenCovid API in the Python ecosystem.
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. It is licensed under the terms of the MIT license.
Credits
canadacovidmetrics
was created with cookiecutter
and the py-pkgs-cookiecutter
template.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for canadacovidmetrics-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 547d97108fb9148c55acef0cef7663ab8828aba15d78cc843a0cfaf8591cb958 |
|
MD5 | 4d029fc3804ea5e0a6b62bcf62af7146 |
|
BLAKE2b-256 | ce8522b20ca9b397c83dd58bd08d94abd8a2ada8c11efc1c16aa3a14829f635a |