Open-Set Distance Cutoff
SkillDev toolsAssign an unknown/novel class when all nearest-neighbor distances exceed a tuned cutoff threshold for open-set recognition
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Open-Set Distance Cutoff skill
What this skill tells your AI
The instructions your AI receives, as published by wenmin-wu/ds-skills in skills/cv/open-set-distance-cutoff/SKILL.md and read by ahel’s review.
Overview
In open-set recognition, test images may belong to classes not seen during training (e.g., "new_whale"). After retrieving k nearest neighbors by embedding distance, if all distances exceed a learned cutoff, insert the unknown class into the prediction list. The cutoff is tuned on a validation set to maximize the ranking metric (e.g., MAP@5).
Quick Start
import numpy as np
def predict_with_unknown(query_dists, query_nbs, train_labels,
unknown_label='new_whale', dcut=3.8, top_k=5):
predictions = []
for i in range(len(query_dists)):
seen = {}
for j in range(query_nbs.shape[1]):
label = train_labels[query_nbs[i, j]]
dist = query_dists[i, j]
if dist > dcut and unknown_label not in seen:
seen[unknown_label] = dcut
if label not in seen:
seen[label] = dist
if len(seen) >= top_k:
break
preds = sorted(seen.items(), key=lambda x: x[1])[:top_k]
predictions.append([p[0] for p in preds])
return predictions
Workflow
- Compute embeddings for train and test sets
- Find k nearest neighbors for each test sample
- For each test query, iterate neighbors by distance
- Insert unknown class when distance exceeds cutoff
dcut - Tune
dcuton validation set to maximize MAP@k or accuracy
Key Decisions
- Cutoff tuning: sweep
dcutvalues on validation set; optimal value depends on embedding space scale - Insertion point: unknown class enters at the position where distance first exceeds cutoff
- Distance metric: Euclidean on L2-normalized embeddings ≈ cosine distance
- When to use: any retrieval task where query may not match any gallery class
References
Signals
- GitHub stars
- 60
- Forks
- 4
- Last commit
- Apr 2026
Advanced
- Catalog kind
- skill
- Gateway key
cv-open-set-distance-cutoff- Source
- github.com/wenmin-wu/ds-skills