`scipy.stats._bws_test:bws_test`

source: build-install/usr/lib/python3.14/site-packages/scipy/stats/_bws_test.py:86

Signature

def bws_test(x, y, *, alternative = two-sided, axis = 0, method = None)

Summary

Perform the Baumgartner-Weiss-Schindler test on two independent samples.

Extended Summary

The Baumgartner-Weiss-Schindler (BWS) test is a nonparametric test of the null hypothesis that the distribution underlying sample x is the same as the distribution underlying sample y. Unlike the Kolmogorov-Smirnov, Wilcoxon, and Cramer-Von Mises tests, the BWS test weights the integral by the variance of the difference in cumulative distribution functions (CDFs), emphasizing the tails of the distributions, which increases the power of the test in many applications.

Parameters

x, y : array-like

Arrays of samples. Shapes must be broadcastable except along axis.

alternative : {'two-sided', 'less', 'greater'}, optional

Defines the alternative hypothesis. Default is 'two-sided'. Let F(u) and G(u) be the cumulative distribution functions of the distributions underlying x and y, respectively. Then the following alternative hypotheses are available:

'two-sided': the distributions are not equal, i.e. F(u) ≠ G(u) for at least one u.
'less': the distribution underlying x is stochastically less than the distribution underlying y, i.e. F(u) >= G(u) for all u.
'greater': the distribution underlying x is stochastically greater than the distribution underlying y, i.e. F(u) <= G(u) for all u.

Under a more restrictive set of assumptions, the alternative hypotheses can be expressed in terms of the locations of the distributions; see [2] section 5.1.

axis : int or None, default: 0

Axis along which the quantiles are computed. None ravels both x and y before performing the calculation.

method : PermutationMethod, optional

Configures the method used to compute the p-value. The default is the default PermutationMethod object.

Returns

res : PermutationTestResult

An object with attributes:

statistic: The observed test statistic of the data.
pvalue: The p-value for the given alternative.
null_distribution: The values of the test statistic generated under the null hypothesis.

Notes

When alternative=='two-sided', the statistic is defined by the equations given in ^[1] Section 2. This statistic is not appropriate for one-sided alternatives; in that case, the statistic is the negative of that given by the equations in ^[1] Section 2. Consequently, when the distribution of the first sample is stochastically greater than that of the second sample, the statistic will tend to be positive.

Examples

We follow the example of table 3 in [1]_: Fourteen children were divided randomly into two groups. Their ranks at performing a specific tests are as follows.

import numpy as np
x = [1, 2, 3, 4, 6, 7, 8]
y = [5, 9, 10, 11, 12, 13, 14]

✓

We use the BWS test to assess whether there is a statistically significant difference between the two groups. The null hypothesis is that there is no difference in the distributions of performance between the two groups. We decide that a significance level of 1% is required to reject the null hypothesis in favor of the alternative that the distributions are different. Since the number of samples is very small, we can compare the observed test statistic against the *exact* distribution of the test statistic under the null hypothesis.

from scipy.stats import bws_test
res = bws_test(x, y)
print(res.statistic)

✓

5.132167152575315

This agrees with :math:`B = 5.132` reported in [1]_. The *p*-value produced by `bws_test` also agrees with :math:`p = 0.0029` reported in [1]_.

print(res.pvalue)

✓

0.002913752913752914

Because the p-value is below our threshold of 1%, we take this as evidence against the null hypothesis in favor of the alternative that there is a difference in performance between the two groups.

Aliases

scipy.stats.bws_test