Hierarchy Structure Metrics API

compute_hierarchy_retrieval_metrics(distance_matrix, codes, hierarchy, *, parent_top_k=1, child_top_k=5)

Evaluate how well embeddings recover hierarchical neighbors (parents/children/siblings).

compute_radius_structure_metrics(embeddings, codes, hierarchy=None)

Compute per-level radius statistics and hierarchy-aware diagnostics.