critical-es-value 0.2.0

Calculate critical effect size values.

critical_es_value

Calculate critical effect size values for t-Tests, correlation tests and linear regression coefficients.

Installation

pip install critical-es-value

Usage

import numpy as np
import pingouin as pg

from critical_es_value import (
    critical_for_one_sample_ttest,
    critical_for_two_sample_ttest,
    critical_for_correlation_test,
    critical_for_linear_regression,
)

np.random.seed(123)
mean, cov, n = [4, 5], [(1, .6), (.6, 1)], 30
x, y = np.random.multivariate_normal(mean, cov, n).T

t-Test

pg.ttest(x, 0)
critical_for_one_sample_ttest(x)

	T	dof	alternative	p-val	CI95%	cohen-d	BF10	power
T-test	16.0765	29	two-sided	5.54732e-16	[3.37 4.35]	2.93515	1.031e+13	nan

	T	dof	T_critical	d	d_critical	b_critical	g	g_critical
critical	16.0765	29	2.04523	2.93515	0.373406	0.491162	2.85847	0.363651

pg.ttest(x, y)
critical_for_two_sample_ttest(x, y)

	T	dof	alternative	p-val	CI95%	cohen-d	BF10	power
T-test	-3.40071	58	two-sided	0.0012224	[-1.68 -0.43]	0.878059	26.155	0.916807

	T	dof	T_critical	d	d_critical	b_critical	g	g_critical
critical	-3.40071	58	2.00172	-0.878059	0.516841	0.62077	-0.866647	0.510124

Correlation Test

pg.corr(x, y)
critical_for_correlation_test(x, y)

	n	r	CI95%	p-val	BF10	power
pearson	30	0.594785	[0.3 0.79]	0.00052736	69.723	0.950373

	n	r	dof	r_critical	se_r	se_r_critical
critical	30	0.594785	28	0.361007	0.15192	0.176238

Linear Regression

import pandas as pd

np.random.seed(123)
data = pd.DataFrame({"X": x, "Y": y, "Z": np.random.normal(5, 1, 30)})

pg.linear_regression(data[["X", "Z"]], data["Y"])
critical_for_linear_regression(data[["X", "Z"]], data["Y"])

	names	coef	se	T	pval	r2	adj_r2	CI[2.5%]	CI[97.5%]
0	Intercept	3.15799	0.844129	3.74112	0.000874245	0.354522	0.306709	1.42598	4.88999
1	X	0.487772	0.126736	3.84871	0.000659501	0.354522	0.306709	0.22773	0.747814
2	Z	-0.0249309	0.140417	-0.177548	0.860403	0.354522	0.306709	-0.313044	0.263182

	names	coef	coef_critical
0	Intercept	3.15799	1.73201
1	X	0.487772	0.260042
2	Z	-0.0249309	0.288113

Resources

• R package
• Original paper

Perugini, A., Gambarota, F., Toffalini, E., Lakens, D., Pastore, M., Finos, L., ... & Altoè, G. (2025). The Benefits of Reporting Critical-Effect-Size Values. Advances in Methods and Practices in Psychological Science, 8(2), 25152459251335298.