sample_surface — 3D superquadric op

• Data kinds: vector → points

• Call: import fullseye as fs; fs.ledger.sample_surface(a, eps, n_u: 'int' = 40, n_v: 'int' = 40, R=None, t=None) -> 'np.ndarray' (implementation को सीधे call करना हो तो import superquadric; superquadric.sample_surface(a, eps, n_u: 'int' = 40, n_v: 'int' = 40, R=None, t=None) -> 'np.ndarray', registry से लेना हो तो ops3d.get("sample_surface"))

उपयोग

superquadric surface के surface points को (eta, omega) parametric रूप से sample करता है।

x = a1 * sgn|cos eta|^eps1 * sgn|cos omega|^eps2 जैसी signed powers से सभी 8 octant ढके जाते हैं (eta in [-pi/2, pi/2], omega in [-pi, pi])। बनाए गए point ठीक-ठीक F = 1 को संतुष्ट करते हैं (क्योंकि cos^2+sin^2=1 exponent को रद्द कर देता है)।

Parameters

a, eps : inside_outside के समान

n_u : omega (देशांतर) दिशा में samples की संख्या

n_v : eta (अक्षांश) दिशा में samples की संख्या

R, t : pose (body→world: X_world = R @ X_body + t)

Returns

np.ndarray, shape (n_u*n_v, 3)

संदर्भ (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 करते हैं)

• mesh_lod_download — py -3.11 examples_3d/mesh_lod_download.py

• superquadric_fit — py -3.11 examples_3d/superquadric_fit.py

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

points_to_voxel · gaussians_to_voxel · estimate_point_normals · to_points · match_points_ncc · match_pca · moment_axes · icp_point2point_3d

इसी category के (superquadric)

fit_superquadric · inside_outside · superquadric_residual


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

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