researchpy
ResearchPy is a Python package that is designed to be easy to use and deliver univariate, bivariate, and multivariate models and statistical tests with clear and informative outputs ready for interpretation, further analysis, and downstream export without additional formatting. Open-source, clear function names, intuitive parameters, and robust documentation.
Built for researchers, analysts transitioning from SPSS/Stata/R, and students learning statistics.
Features
- Descriptive statistics —
summarize(),summary_cont(),summary_cat(),codebook() - Difference tests — Independent t-test, paired t-test, Welch's t-test, Wilcoxon signed-rank via
difference_test() - ANOVA — Type I, II, and III sum of squares with
Anova() - Correlation — Correlation matrices and testing
- Crosstabs — Cross-tabulation with chi-square testing
- OLS regression — Ordinary least squares modeling
- Effect sizes — Cohen's d, Hedge's g, Glass's delta, eta/epsilon/omega squared, and more
- Confidence intervals — Included by default in descriptive and inferential output
- Structured output — Results returned as pandas DataFrames, ready for reporting
Installation
pip install researchpy
Quick Start
import pandas as pd
import researchpy as rp
# Load example data
df = pd.DataFrame({
"score": [88, 92, 75, 85, 90, 78, 95, 70, 82, 87,
72, 68, 80, 76, 74, 69, 71, 77, 73, 79],
"group": ["treatment"]*10 + ["control"]*10
})
ANOVA
model = rp.Anova("score ~ C(group)", data=df) # Type III sum of squares by default
descriptives, results = model.results()
print(descriptives, results, sep = "\n"*2)
Codebook
rp.codebook(df)
Difference Test
desc, results = rp.difference_test("score ~ C(group)", data=df).conduct(effect_size="all")
print(desc, results, sep = "\n"*2)
Summarize
# Continuous summary statistics
rp.summarize(df["score"], stats=["N", "Mean", "SD", "SE", "CI"])
# Categorical frequency table
rp.summary_cat(df["group"])
Requirements
- Python ≥ 3.12
- pandas ≥ 3.0.1
- numpy ≥ 2.5.0
- scipy ≥ 1.17.1
- statsmodels ≥ 0.14.0
- patsy ≥ 1.0.2 (for legacy formula parsing, will be removed in future versions)
- requests ≥ 2.34.2
- formulaic ≥ 1.2.2 (for new formula parsing)
Documentation
Full documentation is available at researchpy.readthedocs.io.
License
ResearchPy is released under the MIT License.
Citation
If you use ResearchPy in your research, please cite:
Bryant, C. (2018–2026). researchpy (Version X.Y.Z) [Python package]. https://github.com/Corey-Bryant/researchpy
To find your installed version for citation:
import researchpy
print(researchpy.__version__)
Current citation with version number:
Bryant, C. (2018–2026). researchpy (Version 0.3.7.3) [Python package]. https://github.com/Corey-Bryant/researchpy
Metadata
Release files for researchpy 0.3.7.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| researchpy-0.3.7.3.tar.gz | 151.8 kB | Without provenance | Details for researchpy-0.3.7.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| researchpy-0.3.7.3-py3-none-any.whl | Python 3 | none | any | Details for researchpy-0.3.7.3-py3-none-any.whl |
Total release size: 299.8 kB
Release files / researchpy-0.3.7.3.tar.gz
| Download URL | researchpy-0.3.7.3.tar.gz |
|---|---|
| Size | 151.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a0c69d726a4167271c2a964be0520635e10c0e922eeb8d81d37af161ea3b1fde
|
|
BLAKE2b-256 checksum How to use checksums |
41f36ba3ac595ab57b4915b477dee0a00befffd7b63da5025ba751aea6d8b848
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.0
|
Release files / researchpy-0.3.7.3-py3-none-any.whl
| Download URL | researchpy-0.3.7.3-py3-none-any.whl |
|---|---|
| Size | 148.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
62a43880a00a248ac221128af14b3b676fd3d03ee79354ed93d894f21a0e435e
|
|
BLAKE2b-256 checksum How to use checksums |
0c027b2f78292014e0b1e13e27b25450ac5f74e91f521e7427a878c9984ca16f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.0
|
Security for researchpy 0.3.7.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.