hopkins-statistic 0.1.0

Compute the Hopkins statistic to assess clustering tendency.

hopkins-statistic

A Python package for computing the Hopkins statistic to test for departure from complete spatial randomness (CSR), often used to assess clustering tendency.

Installation

pip install hopkins-statistic

Usage

import numpy as np
from hopkins_statistic import hopkins

rng = np.random.default_rng(42)

# Clustered test data
centers = np.array([[0, 0], [0, 1]])
labels = rng.integers(len(centers), size=100)
X = centers[labels] + rng.normal(scale=0.1, size=(100, 2))

# For strongly clustered data, the statistic is often > 0.7
H = hopkins(X, rng=rng)
print(f"{H:.2f}")
#> 0.77

License

MIT. See LICENSE.