Metadata-Version: 2.1
Name: covid-sicr
Version: 1.0.2
Summary: Global estimation of unobserved COVID-19 infection
Home-page: UNKNOWN
Author: NIDDK
License: MIT
Description: # NIDDK SICR Model for estimating SARS-CoV-2 infection in a population
        
        Code and data used for Chow et al, ["TITLE"](http://some_url), to model the progression of the COVID-19 epidemic and estimate the unobserved SARS-CoV-2 infected population from reported cases, case recoveries, and case deaths globablly.  Models are implemented in Stan and fit using PyStan.  
        
        [![PyPI version](https://badge.fury.io/py/covid_sicr.svg)](https://badge.fury.io/py/covid_sicr)
        [![Build Status](https://travis-ci.org/nih-niddk-mbs/covid-sicr.svg?branch=refactor)](https://travis-ci.org/nih-niddk-mbs/covid-sicr)
        
        The core model is a variation of the SIR model with a latent variable `I` for the number of *unobserved* infected which is distinguished from `C` the *observed* cases.  This model follows:
        
        ![formula](https://render.githubusercontent.com/render/math?math=%24%5Cfrac%7BdS%7D%7Bdt%7D%20%3D%20-%20%5Cfrac%7B%5Cbeta%7D%7BN%7D%20S%28I%20%2BqC%29%5Clabel%7BS%7D%24)
        
        ![formula](https://render.githubusercontent.com/render/math?math=%24%5Cfrac%7BdI%7D%7Bdt%7D%20%3D%20%5Cfrac%7B%5Cbeta%7D%7BN%7DS%28I%2BqC%29%20-%20%5Csigma_C%20I%20-%20%5Csigma_U%20I%20%20%5Clabel%7BI%7D%24)
        
        ![formula](https://render.githubusercontent.com/render/math?math=%24%5Cfrac%7BdC%7D%7Bdt%7D%20%3D%20%5Csigma_C%20I%20-%20%5Csigma_R%20C%20-%20%5Csigma_D%20%20C%20%5Clabel%7BC%7D%24)
        
        Several variants of this model are discussed in the Supplemental Material of the preprint.  The code required to fit these models to data is provided in the `models` directory. Data sources include The Johns Hopkins University Center for Systems Science and Engineering (JHU CSSE) and The COVID Tracking Project.
        
        ### Requirements to run code here:
        - python 3.5+
        - Install the Python package:
          - From pypi: `pip install niddk-sicr-covid19` *TODO: Add to PyPI*
          - Or from source:
            - `git clone http://github.com/ccc1685/covid-19`
            - `cd covid-19`
            - `pip install -e .  # This installs the niddk-sicr-covid19 package from source`
          - Or place this directory in your `PYTHONPATH` and install the contents of `requirements.txt`. 
        - `pystan` may not be easily pip installable on some systems, so consider conda:
          - `conda install -c conda-forge pystan`
        
        ### Important scripts:
        - New data can be downloaded from data sources with `scripts/get-data.py`:
          - For all data sources: `python scripts/get-data.py`.
          - This will use Johns Hopkins and COVID Tracking by default.  
          - Other options can be seen with the `--help` flag.
          - Data sources follow a functional pattern and are extensible.
        
        - Stan models can be run with Python file `scripts/run.py`:
          - Run a single region with:
            - `python scripts/run.py MODEL_NAME --roi=REGION_NAME`
            - e.g. `python scripts/run.py nonlinearmodel --roi=US_MI`
          - Other optional arguments for specifying paths and some fitting parameters can be examined with `python scripts/run.py --help`.
          - A pickle file containing the resultant fit will be produced in your `fits_path` (see help).
          - A `scripts/run_all.py` file is provided for reference but much better performance will be obtained by running `scripts/run.py` on a cluster.
        
        - Analyze finished fits for all regions with `scripts/visualize.py`:
          - For all regions (with fits) with `python scripts/visualize.py MODEL_NAME`
          - e.g. `python visualize_master.py --nonlinearmodel`
          - As above, help is available with the `--help` flag.
          - Jupyter notebooks containining all analyzed regions will be created in your `--fits_path`.
        
        - Tables summarizing fit parameters can be generated with `scripts/make-tables.py`:
          - `python scripts/make-tables.py`
          - e.g. `python scripts/make-tables.py --model-names nonlinearmodel fulllinearmodel`
          - As above, help is available with the `--help` flag.
          - `.csv` files of the resulting dataframes will be created in the `--fit-path` directory in the `tables` subdirectory.
        
        This code is open source under the MIT License.
        Correspondence on modeling should be directed to carsonc at nih dot gov or vattikutis at mail dot nih dot gov.
        Correspondence on the python code should be directed to rgerkin at asu dot edu.
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
