add statistical annotations on an existing boxplot/barplot generated by seaborn.
Project description
What is it
Python package to optionnally compute statistical test and add statistical annotations on an existing boxplot/barplot generated by seaborn.
Features
- Single function to add statistical annotations on an existing boxplot/barplot generated by seaborn boxplot.
- Integrated statistical tests (binding to
scipy.stats
methods):- Mann-Whitney
- t-test (independent and paired)
- Welch's t-test
- Levene test
- Wilcoxon test
- Kruskal-Wallis test
- Smart layout of multiple annotations with correct y offsets.
- Annotations can be located inside or outside the plot.
- Format of the statistical test annotation can be customized: star annotation, simplified p-value, or explicit p-value.
- Optionally, custom p-values can be given as input. In this case, no statistical test is performed.
Installation
The latest stable release can be installed from PyPI:
pip install statannot
You may instead want to use the development version from Github:
pip install git+https://github.com/webermarcolivier/statannot.git
Documentation
See example jupyter notebook example/example.ipynb
.
Usage
Here is a minimal example:
import seaborn as sns
from statannot import add_stat_annotation
df = sns.load_dataset("tips")
x = "day"
y = "total_bill"
order = ['Sun', 'Thur', 'Fri', 'Sat']
ax = sns.boxplot(data=df, x=x, y=y, order=order)
test_results = add_stat_annotation(ax, data=df, x=x, y=y, order=order,
box_pairs=[("Thur", "Fri"), ("Thur", "Sat"), ("Fri", "Sun")],
test='Mann-Whitney', text_format='star',
loc='outside', verbose=2)
test_results
More examples are available in the jupyter notebook example/example.ipynb
.
Examples
Requirements
- Python >= 3.5
- numpy >= 1.12.1
- seaborn >= 0.8.1
- matplotlib >= 2.2.2
- pandas >= 0.23.0
- scipy >= 1.1.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
statannot-0.2.3.tar.gz
(705.7 kB
view details)
Built Distribution
statannot-0.2.3-py3-none-any.whl
(11.0 kB
view details)
File details
Details for the file statannot-0.2.3.tar.gz
.
File metadata
- Download URL: statannot-0.2.3.tar.gz
- Upload date:
- Size: 705.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
4600c2fa1f682d493a4ad0c1c4501b32a3d8d3a55877ec97bcf4e44fbd160cb9
|
|
MD5 |
8de8747876d60d2e21f95d4296bae324
|
|
BLAKE2b-256 |
2aaf318b1b75808bdeb0aab1d3fc17d4d8242bad712d20e59a6f5ee228495b8f
|
File details
Details for the file statannot-0.2.3-py3-none-any.whl
.
File metadata
- Download URL: statannot-0.2.3-py3-none-any.whl
- Upload date:
- Size: 11.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
17745a40542e157e3f147147425c5da441f62bb698b3644154cedf088d4d0b08
|
|
MD5 |
f2fb2430d4bac6ed942f5d547e454256
|
|
BLAKE2b-256 |
0f3ae579d7e3b855586e468375251ec093142d67c5f8ccd76482492f2a474862
|