reconstruct — SHAPE2D descriptor op

• Data kinds: efdmodel → pairs

• Call: import fullseye as fs; fs.ledger.reconstruct(model, n_points=300, n_harmonics=None) (implementation को सीधे call करना हो तो import fourierdesc; fourierdesc.reconstruct(model, n_points=300, n_harmonics=None), registry से लेना हो तो opsshape2d.get("reconstruct"))

उपयोग

EFD गुणांकों से contour फिर से बनाता है ((M,2))।

n_harmonics को coefficients की संख्या से छोटा करने पर harmonics काटकर smoothing होती है (जितने केवल निचले order बचें, उतना गोल)।

सूत्र: t = linspace(0, 1, n_points, endpoint=False) के लिए x(t) = a0 + Σ a_n cos(2πnt) + b_n sin(2πnt), y(t) = c0 + Σ c_n cos(2πnt) + d_n sin(2πnt) (n = 1..N)।

• model: elliptic_fourier की return value (coeffs (N, 4), a0, c0)। normalize से गुज़रे coefficients देने पर canonical pose (1 ले harmonic से aligned) का contour मिलता है। dict validate नहीं होती (key न हो तो KeyError)।

• n_points: output points की संख्या M (int में काटी जाती है)। बराबर parameter अंतराल पर, बराबर arc length अंतराल पर नहीं। endpoint=False होने से अंतिम point पहले point से मेल नहीं खाता (बंद polygon बनाना हो तो पहला point अंत में जोड़ें)। 0 हो तो खाली (0, 2)।

• n_harmonics: इस्तेमाल होने वाले harmonics की संख्या। None पर सभी, N से बड़े मान N पर काटे जाते हैं, 0 या कम हो तो केवल DC (सभी points केंद्र (a0, c0) पर)।

• return value: (M, 2) float64। coordinates का क्रम ((x, y) या (row, col)) elliptic_fourier को दिए गए क्रम जैसा ही रहता है। t = 0 मूल contour के शुरुआती point से मेल खाता है।

contour को coefficients में बदले बिना केवल smooth करना हो तो fourier_smooth। coefficients की आपस में तुलना के लिए invariants / descriptor_distance।

उपयोग की विस्तृत guide

• shape_description_2d family guide

संदर्भ (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 के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

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

• contour_fourier — py -3.11 examples/contour_fourier.py

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

elliptic_fourier · fourier_smooth · contour_fourier_complex · add_frame_corners · warp_tps_image · warp_piecewise_affine · morph · morph_sequence

इसी category के (descriptor)

elliptic_fourier · invariants · normalize · descriptor_distance · fourier_smooth · from_xld · contour_fourier_complex · contour_epicycle_chain


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

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