shape_distance — 3D shape_descriptor op

• Data kinds: descriptor × descriptor → measurement

• Call: import fullseye as fs; fs.ledger.shape_distance(desc_a, desc_b, metric: 'str' = 'l1') -> 'float' (implementation को सीधे call करना हो तो import descriptors3d; descriptors3d.shape_distance(desc_a, desc_b, metric: 'str' = 'l1') -> 'float', registry से लेना हो तो ops3d.get("shape_distance"))

उपयोग

2 descriptors के बीच दूरी। जितनी छोटी, shape उतना समान।

Parameters

desc_a, desc_b : array_like

describe() आदि से लौटे समान लंबाई के vectors।

metric : {"l1", "jsd"}

• "l1" : L1 (Manhattan) distance। concatenated descriptor (partial distributions की कतार) के लिए सीधा, default।

• "jsd": Jensen-Shannon distance (पूरे को 1 distribution मानकर योग 1 पर normalise करने के बाद JS divergence का square root)। 0 से 1 के भीतर रहने वाला bounded सूचकांक।

Returns

float

non-negative distance।

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• moment_invariants — py -3.11 examples_3d/moment_invariants.py

• shape_desc_pose — py -3.11 examples_3d/shape_desc_pose.py

• shape_retrieval — py -3.11 examples_3d/shape_retrieval.py

वे अगले ops जिनसे type जुड़ता है (measurement को input के रूप में लेते हैं)

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

इसी category के (shape_descriptor)

d2_distribution · a3_distribution · extent_signature · describe


*Provenance: descriptors3d.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.