labelfree
Label-free metrics for comparing unsupervised anomaly detectors and hyperparameters when labeled anomalies are unavailable.
Install
pip install labelfree
Quick start
from labelfree.metrics import score_cluster_metrics
scores = [0.1, 0.2, 0.3, 3.8, 4.1]
metrics = score_cluster_metrics(scores, n_outliers=2)
print(metrics["silhouette"]) # higher is better
The package includes score-cluster, ASI/ASOI, AutoUAD, Laplacian, consensus, ranking-stability, IREOS, SIREOS, and Excess-Mass/Mass-Volume metrics. Every raw-score API requires an explicit score polarity when larger values mean more normal.
Label-free metrics are model-selection signals, not substitutes for labeled evaluation. Check each metric's assumptions and direction before comparing results.
See the documentation for metric selection, API details, and examples.
Development
python -m pip install -e ".[dev]"
pytest
Contributions are welcome; see CONTRIBUTING.md. Released under the MIT License.
1 maintainer
Release files for labelfree 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| labelfree-1.0.0.tar.gz | 36.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| labelfree-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.2 kB
Release files / labelfree-1.0.0.tar.gz
| Download URL | labelfree-1.0.0.tar.gz |
|---|---|
| Size | 36.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
31df35db17d49664fbc698124b6ca6bce1ae52049623fb364c3702670ed57036
|
|
BLAKE2b-256 checksum How to use checksums |
bb5fafa472027c4981f5ff225cdfd0b322f92a012d3b443d1d83055a6140d409
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.5
|
Release files / labelfree-1.0.0-py3-none-any.whl
| Download URL | labelfree-1.0.0-py3-none-any.whl |
|---|---|
| Size | 17.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ba7d75149ddbe2b20697239db75b68dec47a1a2a003a3338a7540f9b81e310e9
|
|
BLAKE2b-256 checksum How to use checksums |
c10d8f6768e373490c5d8f94c0a77257a5741e6505db7d938ed5bab983259722
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.5
|
