Package: covid19dh
Python Interface to COVID-19 Data HubDownload COVID-19 data across governmental sources at national, regional, and city level, as described inGuidotti and Ardia (2020). Includes the time series of vaccines, tests, cases, deaths, recovered, hospitalizations, intensive therapy, and policy measures byOxford COVID-19 Government Response Tracker. Please agree to theTerms of Useand cite the following reference when using it:ReferenceGuidotti, E., Ardia, D., (2020).COVID-19 Data HubJournal of Open Source Software,5(51):2376https://doi.org/10.21105/joss.02376Setup and usageInstall frompipwithpipinstallcovid19dhImporting the main functioncovid19()fromcovid19dhimportcovid19x,src=covid19()Package is regularly updated. Update withpipinstall--upgradecovid19dhReturn valuesThe functioncovid19()returns 2 pandas dataframes:the data andreferences to the data sources.ParametrizationCountryList of country names (case-insensitive) or ISO codes (alpha-2, alpha-3 or numeric). The list of ISO codes can be foundhere.Fetching data from a particular country:x,src=covid19("USA")# Unites StatesSpecify multiple countries at the same time:x,src=covid19(["ESP","PT","andorra",250])Ifcountryis omitted, the whole dataset is returned:x,src=covid19()Raw dataLogical. Skip data cleaning? DefaultTrue. Ifraw=False, the raw data are cleaned by filling missing dates withNaNvalues. This ensures that all locations share the same grid of dates and no single day is skipped. Then,NaNvalues are replaced with the previous non-NaNvalue or0.x,src=covid19(raw=False)Date filterDate can be specified withdatetime.datetime,datetime.dateor as astrin formatYYYY-mm-dd.fromdatetimeimportdatetimex,src=covid19("SWE",start=datetime(2020,4,1),end="2020-05-01")LevelInteger. Granularity level of the data:Country levelState, region or canton levelCity or municipality levelfromdatetimeimportdatex,src=covid19("USA",level=2,start=date(2020,5,1))CacheLogical. Memory caching? Significantly improves performance on successive calls. By default, using the cached data is enabled.Caching can be disabled (e.g. for long running programs) by:x,src=covid19("FRA",cache=False)VintageLogical. Retrieve the snapshot of the dataset that was generated at theenddate instead of using the latest version. DefaultFalse.To fetch e.g. US data that were accessible on22th April 2020typex,src=covid19("USA",end="2020-04-22",vintage=True)The vintage data are collected at the end of the day, but published with approximately 48 hour delay,
once the day is completed in all the timezones.Hence ifvintage = True, butendis not set, warning is raised andNoneis returned.x,src=covid19("USA",vintage=True)# too early to get today's vintageUserWarning: vintage data not available yetData SourcesThe data sources are returned as second value.fromcovid19dhimportcovid19x,src=covid19("USA")print(src)Additional informationFind out more athttps://covid19datahub.ioAcknowledgementsDeveloped and maintained byMartin Benes.Cite asGuidotti, E., Ardia, D., (2020), "COVID-19 Data Hub", Journal of Open Source Software 5(51):2376, doi: 10.21105/joss.02376.A BibTeX entry for LaTeX users is@Article{,
    title ={COVID-19 Data Hub},
    year ={2020},
    doi ={10.21105/joss.02376},
    author ={Emanuele Guidotti and David Ardia},
    journal ={Journal of Open Source Software},
    volume ={5},
    number ={51},
    pages ={2376}}