eval_poly_surface — 3D `surface_fit` op

• Data kinds: poly_surface × image2d × image2d → image2d

• Call: import fullseye as fs; fs.ledger.eval_poly_surface(model, x, y) (implementation को सीधे call करना हो तो import match3d; match3d.eval_poly_surface(model, x, y), registry से लेना हो तो ops3d.get("eval_poly_surface"))

उपयोग

model को (x,y) पर evaluate करता है → z (x के shape में लौटाता है)।

*model* fit_poly_surface का return value (dict) है। fail-closed: B-spline surface/curve का tck (FITPACK की list) देने पर पहले model["degree"] पर TypeError: list indices must be integers... के साथ crash होता था (2026-09-01 को 7 बार मापा गया)। polynomial model और B-spline model की सामग्री अलग होती है, इसलिए यहाँ इन्हें स्पष्ट रूप से अस्वीकार किया जाता है (ops3d ledger में भी poly_surface / bspline_surface के type अलग रखे गए हैं)।

Raises ValueError: model polynomial model dict नहीं है / आवश्यक key गायब है।

पृष्ठभूमि guides (इस op के पीछे की physics और conventions)

• blas_threads_and_memory — Matrix decompositions धीमे क्यों हैं — BLAS threads, caches, memory layout

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

• contours_to_terrain — py -3.11 examples_3d/contours_to_terrain.py

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

fuse_to_voxel · fit_poly_surface · surface_form_error · background_flatten · polar_unwrap · fit_zernike · matcap_shade · antialias

इसी category के (`surface_fit`)

fit_poly_surface · surface_form_error · background_flatten

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

eval_poly_surface — 3D surface_fit op