elliptic_fourier — SHAPE2D descriptor op

• Data kinds: pairs → efdmodel

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

उपयोग

बंद contour के elliptic Fourier गुणांक Kuhl–Giardina closed form से निकालता है।

arguments:

points: (N,2) के closed contour के शीर्ष। बंद न हो तो अंदर पहला point अंत में जोड़ दिया जाता है।

n_harmonics: harmonics की संख्या N (जितनी ज़्यादा, उतना बारीक विवरण)।

return value: dict

"coeffs": (N,4) array। row n [a_n, b_n, c_n, d_n] है। "a0", "c0": DC components (contour के केंद्र का offset)।

"n_harmonics": N।

reconstruction reconstruct है x(t)=a0+Σ a_n cos(2πnt)+b_n sin(2πnt), y(t)=c0+Σ c_n cos+d_n sin (t∈[0,1))।

उपयोग की विस्तृत 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

• shape2d_morph_descriptor_tour — py -3.11 examples/shape2d_morph_descriptor_tour.py

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

reconstruct · invariants · normalize · descriptor_distance

इसी category के (descriptor)

reconstruct · 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.