An open API service indexing awesome lists of open source software.

https://github.com/rishi-kulkarni/hierarch

Resampling-Based Hypothesis Testing for Python
https://github.com/rishi-kulkarni/hierarch

bootstrapping-statistics hypothesis-tests permutation-statistics resampling-strategies

Last synced: 4 months ago
JSON representation

Resampling-Based Hypothesis Testing for Python

Awesome Lists containing this project

README

          

# hierarch

## A Hierarchical Resampling Package for Python

Version 1.2.0

hierarch is a package for hierarchical resampling (bootstrapping, permutation) of datasets in Python. Because for loops are ultimately intrinsic to cluster-aware resampling, hierarch uses Numba to accelerate many of its key functions.

hierarch has several functions to assist in performing resampling-based (and therefore distribution-free) hypothesis tests, confidence interval calculations, and power analyses on hierarchical data.

## Table of Contents

1. [Introduction](#introduction)
2. [Setup](#setup)
3. [Documentation](#documentation)
4. [Citation](#citation)

## Introduction

Design-based randomization tests represents the platinum standard for significance analyses [[1, 2, 3]](#1) - that is, they produce probability statements that depend only on the experimental design, not at all on less-than-verifiable assumptions about the probability distributions of the data-generating process. Researchers can use hierarch to quickly perform automated design-based randomization tests for experiments with arbitrary levels of hierarchy.

[1] Tukey, J.W. (1993). Tightening the Clinical Trial. Controlled Clinical Trials, 14(4), 266-285.

[2] Millard, S.P., Krause, A. (2001). Applied Statistics in the Pharmaceutical Industry. Springer.

[3] Berger, V.W. (2000). Pros and cons of permutation tests in clinical trials. Statistics in Medicine, 19(10), 1319-1328.

## Setup

### Dependencies

- numpy
- pandas (for importing data)
- numba
- scipy (for power analysis)

### Installation

The easiest way to install hierarch is via PyPi.

`pip install hierarch`

Alternatively, you can install from Anaconda.

`conda install -c rkulk111 hierarch`

## Documentation

Check out our user guide at [readthedocs](https://hierarch.readthedocs.io/).

## Citation

If hierarch helps you analyze your data, please consider citing it. The manuscript also
contains a set of simulations validating hierarchical randomization tests in a variety of
conditions.

Kulkarni RU, Wang CL, Bertozzi CR (2022) Analyzing nested experimental designs—A user-friendly resampling method to determine experimental significance. PLoS Comput Biol 18(5): e1010061. https://doi.org/10.1371/journal.pcbi.1010061