fscore — 3D `metrics` op

• Datenarten: points × points → measurement

• Aufruf: import fullseye as fs; fs.ledger.fscore(a, b, tau) (die Implementierung direkt: import metrics3d; metrics3d.fscore(a, b, tau); aus dem Register: ops3d.get("fscore"))

• Rückgabewert über das Register: fullseye.ledger.fscore(...) liefert **nur den Wert des deklarierten Out-Typs measurement** (die zugrunde liegende Funktion gibt zusätzlich Hilfsinformationen zurück). Wird das Verworfene gebraucht, nutze fullseye.ledger.fscore.raw(...) oder rufe metrics3d.fscore direkt auf.

• Rückgabe der Funktion: (f, precision, recall) → F 値

Verwendung

F-Score @ tau = das harmonische Mittel aus Precision und Recall. → (f, precision, recall). Die Standardmetrik der Rekonstruktion.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

Raises ValueError: どちらかが空 or (N,3) でない場合(accuracy/completeness 経由)。

計算(`a = 再構成/推定、b` = 参照/GT の慣習):

• `precision = a の点のうち、b への最近傍距離が tau` 未満

(`< tau`、等号は含まない)の割合。

• `recall = b の点のうち、a への最近傍距離が tau` 未満の割合。

• `f = 2 p r / (p + r)、p + r == 0 なら 0.0`(0 除算にしない)。

引数: `a, b は (N, 3) / (M, 3)` 点群(対応不要、点数は異なってよい)。

`tau は距離閾値(座標と同じ単位、正の値を想定。tau <= 0` だと距離 0 の点も

`< tau` にならず precision = recall = 0 になる。検査はしない)。

返り値: `(f, precision, recall) の 3 つの float、それぞれ [0, 1]`。

1 が完全一致。

注意: `tau` の選び方が結果を決める(voxel サイズ・スキャン分解能の 1〜2 倍が

目安)。片方の雲だけ密だと precision と recall が乖離する — その非対称性を見る

のがこの指標の価値で、1 数字で良ければ `chamfer_distance`。

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• blender_interop — Blender との併用 — 形を作って fullseye で測る(軸・単位・正解データの罠)

• measurement_uncertainty — 計測の不確かさと校正の知識 — 「測れている」を主張するために

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• metrics_eval — py -3.11 examples_3d/metrics_eval.py

Typkompatible Folge-Operatoren (nehmen `measurement` als Eingabe)

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

Gleiche Kategorie (`metrics`)

chamfer_distance · hausdorff_distance · m3c2_distance · rmse_correspondence · normal_consistency · voxel_iou · pose_error

*Provenance: metrics3d.py — 3D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

fscore — 3D metrics op