Skip to main content

Tool package for epidemiologic analyses

Project description

![zepid](docs/images/zepid_logo.png) # zEpid

[![PyPI version](https://badge.fury.io/py/zepid.svg)](https://badge.fury.io/py/zepid) [![Build Status](https://travis-ci.com/pzivich/zEpid.svg?branch=master)](https://travis-ci.com/pzivich/zEpid) [![Documentation Status](https://readthedocs.org/projects/zepid/badge/?version=latest)](https://zepid.readthedocs.io/en/latest/?badge=latest) [![Join the chat at https://gitter.im/zEpid/community](https://badges.gitter.im/zEpid/community.svg)](https://gitter.im/zEpid/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

zEpid is an epidemiology analysis package, providing easy to use tools for epidemiologists coding in Python 3.5+. The purpose of this library is to provide a toolset to make epidemiology e-z. A variety of calculations and plots can be generated through various functions. For a sample walkthrough of what this library is capable of, please look at the tutorials available at https://github.com/pzivich/Python-for-Epidemiologists

A few highlights: basic epidemiology calculations, easily create functional form assessment plots, easily create effect measure plots, and causal inference tools. Implemented estimators include; inverse probability of treatment weights, inverse probability of censoring weights, inverse probabilitiy of missing weights, augmented inverse probability of treatment weights, time-fixed g-formula, Monte Carlo g-formula, Iterative conditional g-formula, and targeted maximum likelihood (TMLE). Additionally, generalizability/transportability tools are available including; inverse probability of sampling weights, g-transport formula, and doubly robust generalizability/transportability formulas.

If you have any requests for items to be included, please contact me and I will work on adding any requested features. You can contact me either through GitHub (https://github.com/pzivich), email (gmail: zepidpy), or twitter (@zepidpy).

# Installation

## Installing: You can install zEpid using pip install zepid

## Dependencies: pandas >= 0.18.0, numpy, statsmodels >= 0.7.0, matplotlib >= 2.0, scipy, tabulate

# Module Features

## Measures Calculate measures directly from a pandas dataframe object. Implemented measures include; risk ratio, risk difference, odds ratio, incidence rate ratio, incidence rate difference, number needed to treat, sensitivity, specificity, population attributable fraction, attributable community risk

Measures can be directly calculated from a pandas DataFrame object or using summary data.

Other handy features include; splines, Table 1 generator, interaction contrast, interaction contrast ratio, positive predictive value, negative predictive value, screening cost analyzer, counternull p-values, convert odds to proportions, convert proportions to odds

For guided tutorials with Jupyter Notebooks: https://github.com/pzivich/Python-for-Epidemiologists/blob/master/3_Epidemiology_Analysis/a_basics/1_basic_measures.ipynb

## Graphics Uses matplotlib in the background to generate some useful plots. Implemented plots include; functional form assessment (with statsmodels output), p-value function plots, spaghetti plot, effect measure plot (forest plot), receiver-operator curve, dynamic risk plots, and L’Abbe plots

For examples see: http://zepid.readthedocs.io/en/latest/Graphics.html

## Causal The causal branch includes various estimators for causal inference with observational data. Details on currently implemented estimators are below:

### G-Computation Algorithm Current implementation includes; time-fixed exposure g-formula, Monte Carlo g-formula, and iterative conditional g-formula

### Inverse Probability Weights Current implementation includes; IP Treatment W, IP Censoring W, IP Missing W. Diagnostics are also available for IPTW. IPMW supports monotone missing data

### Augmented Inverse Probability Weights Current implementation includes the augmented-IPTW estimator described by Funk et al 2011 AJE

### Targeted Maximum Likelihood Estimator TMLE can be estimated through standard logistic regression model, or through user-input functions. Alternatively, users can input machine learning algorithms to estimate probabilities. Supported machine learning algorithms include sklearn

### Generalizability / Transportability For generalizing results or transporting to a different target population, several estimators are available. These include inverse probability of sampling weights, g-transport formula, and doubly robust formulas

Tutorials for the usage of these estimators are available at: https://github.com/pzivich/Python-for-Epidemiologists/tree/master/3_Epidemiology_Analysis/c_causal_inference

#### G-estimation of Structural Nested Mean Models Single time-point g-estimation of structural nested mean models are supported.

## Sensitivity Analyses Includes trapezoidal distribution generator, corrected Risk Ratio

Tutorials are available at: https://github.com/pzivich/Python-for-Epidemiologists/tree/master/3_Epidemiology_Analysis/d_sensitivity_analyses

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

zepid-0.7.1.tar.gz (440.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zepid-0.7.1-py2.py3-none-any.whl (459.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file zepid-0.7.1.tar.gz.

File metadata

  • Download URL: zepid-0.7.1.tar.gz
  • Upload date:
  • Size: 440.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.9.1 pkginfo/1.4.1 requests/2.11.1 setuptools/30.2.0 requests-toolbelt/0.8.0 tqdm/4.19.5 CPython/3.5.2

File hashes

Hashes for zepid-0.7.1.tar.gz
Algorithm Hash digest
SHA256 38cb2c9e079fdca1ddaed6e03ca01e7d94831f553f5f5e0b8a6c298e21738847
MD5 68f3753097aba44d9300d48d42f2caff
BLAKE2b-256 efc4353214b17a68f73e1655551e3af6af3358769215071b099aea3c8d02d245

See more details on using hashes here.

File details

Details for the file zepid-0.7.1-py2.py3-none-any.whl.

File metadata

  • Download URL: zepid-0.7.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 459.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.9.1 pkginfo/1.4.1 requests/2.11.1 setuptools/30.2.0 requests-toolbelt/0.8.0 tqdm/4.19.5 CPython/3.5.2

File hashes

Hashes for zepid-0.7.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 59966af0f43daf7370d9dfbc5213f95f73a6823daf30d000ecfc42f62b074ad1
MD5 9327ca285917df807ef55d2411a70ae2
BLAKE2b-256 ecd44586b4a4b12232dc09c193f8584605c5a76714ed6abc265b2986839534a1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page