matrix_to_descriptor — REPRCONV descriptor op

• Data kinds: matrix → descriptor

• Call: import fullseye as fs; fs.ledger.matrix_to_descriptor(matrix) (implementation को सीधे call करना हो तो import reprconv; reprconv.matrix_to_descriptor(matrix), registry से लेना हो तो opsreprconv.get("matrix_to_descriptor"))

उपयोग

matrix → descriptor। descriptor_to_matrix का उल्टा।

1 row वाली matrix (1, n) को (n,) में वापस किया जाता है (क्योंकि वही मूल 1-D descriptor है)। 2 या अधिक row जस की तस रहती हैं। यह असममिति जान-बूझकर है: इसके बिना descriptor -> matrix -> descriptor का round trip shape को (n,) से (1,n) में चुपचाप बदल देता = type का शुद्ध झूठ।

★ मापकर रखा गया irreversible बिंदु: बदले में, जो descriptor मूल रूप से (1, n) का 2-D था, वह round trip के बाद (n,) का 1-D बन जाता है -- (1,n) matrix "1-D descriptor को लपेटा हुआ" और "केवल 1 row वाला descriptor bundle" में अंतर नहीं रखती, इसलिए केवल यह 1 स्थिति सिद्धांततः वापस नहीं लाई जा सकती। सभी मान सुरक्षित रहते हैं, इसलिए loss केवल "1 row थी" की meta-जानकारी है। कौन-सा पक्ष irreversible हो, यह चुनने को मजबूर होने पर, descriptor के भारी बहुमत (measured: 14 producer में से 12 1-D) को सटीक पक्ष में रखा गया। tests/test_reprconv.py::test_one_row_descriptor_ambiguity_is_documented इस छेद को बंद किए बिना पक्का करता है (छिपाने पर किसी दिन shape चुपचाप बदल जाएगा)।

Args:

matrix: (m, n) real array।

Returns:

m == 1 हो तो (n,), वरना (m, n)।

Raises:

ValueError: 2-D नहीं है / non-finite।

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

• representation_conversion — py -3.11 examples/representation_conversion.py

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

descriptor_to_matrix · descriptor_to_table

इसी category के (descriptor)

descriptor_to_matrix · descriptor_to_table


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

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