Metadata-Version: 2.1
Name: covid19dh
Version: 0.1.3
Summary: Unified data hub for a better understanding of COVID-19 https://covid19datahub.io
Home-page: https://www.covid19datahub.io/
Author: Covid-19 Data Hub
Author-email: martinbenes1996@gmail.com
License: GPL
Download-URL: https://github.com/covid19datahub/Python/archive/0.1.3.tar.gz
Description: <a href="https://covid19datahub.io"><img src="https://storage.covid19datahub.io/logo.svg" align="right" height="128"/></a>
        
        # Python Interface to COVID-19 Data Hub
        
        Python package [covid19dh](https://pypi.org/project/covid19dh/) simplifies fetching *COVID-19 Data Hub* data into Python.
        
        ## Setup and usage
        
        Install with
        
        ```python
        pip install covid19dh
        ```
        
        Importing main `covid19()` function with 
        
        ```python
        from covid19dh import covid19
        
        x = covid19("ITA") # load data
        ```
        
        Package is regularly updated. Update with
        
        ```bash
        pip install --upgrade covid19dh
        ```
        
        ## Parametrization
        
        ### Country
        
        Country specifies an administrative region, that the data are fetched from.
        This is connected with source data comes from.
        
        Fetching data from a particular country is done with
        
        ```python
        x = covid19("ESP")
        ```
        
        Filter can also specify multiple countries at the same time
        
        ```python
        x = covid19(["ESP","PRT","AND"])
        ```
        
        Country can be omitted, then whole world data is used.
        
        ```python
        x = covid19()
        ```
        
        ### Date filter
        
        Date can be specified with `datetime.datetime`, `datetime.date`
        or as a `str` in format `YYYY-mm-dd`.
        
        ```python
        from datetime import datetime
        
        x = covid19("SWE", start = datetime(2020,4,1), end = "2020-05-01")
        ```
        
        ### Level
        
        Levels work the same way as in all the other our data fetchers.
        
        1. Country level
        2. State, region or canton level
        3. City or municipality level
        
        ```python
        from datetime import date
        
        x = covid19("USA", level = 2, start = date(2020,5,1))
        ```
        
        ### Cache
        
        Library keeps downloaded data in simple way during runtime. By default, using the cached data is enabled.
        
        Caching can be disabled (e.g. for long running programs) by
        
        ```python
        x = covid19("FRA", cache=False)
        ```
        
        ## Contribution
        
        Developed by [Martin Benes](https://github.com/martinbenes1996).
        
        The goal of [COVID-19 Data Hub](https://covid19datahub.io/) is to provide the research community with a unified data hub by collecting worldwide fine-grained case data, merged with exogenous variables helpful for a better understanding of COVID-19.
        
        Join us on [GitHub](https://github.com/covid19datahub/Python).
        
        
        
        
Keywords: 2019-nCov,coronavirus,covid-19,covid-data,covid19-data
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Other Audience
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
