matrix_to_descriptor — REPRCONV descriptor op

Data kinds: matrixdescriptor

Call: import reprconv; reprconv.matrix_to_descriptor(matrix) (or opsreprconv.get("matrix_to_descriptor"))

Usage

`matrix → descriptor. The inverse of :func:descriptor_to_matrix`.

> The detailed description below is the original text — the summary and the headings are translated.

1 行の行列 (1, n) は (n,) へ戻す(それが元の 1-D 記述子だから)。

2 行以上はそのまま。この非対称は意図的で、これが無いと

`descriptor -> matrix -> descriptor` の往復が (n,) から (1,n) へ

静かに形を変える = 型の嘘そのものになる。

測って残す非可逆点: そのぶん、元から (1, n) の 2-D だった記述子

往復で (n,) の 1-D になる —— (1,n) の行列は「1-D 記述子を包んだもの」と

「行が 1 本しかない記述子束」の区別を持たないので、**この 1 ケースだけは

原理的に戻せない**。値は全て保存されるので損失は「行が 1 本だった」という

メタ情報のみ。どちらを非可逆にするか選ばされる状況で、

`descriptor` の圧倒的多数(実測 14 producers 中 12 が 1-D)を厳密側に

倒した。`tests/test_reprconv.py::test_one_row_descriptor_ambiguity_is_documented`

がこの穴を塞がずに固定している(隠すと、いつか黙って形が変わる)。

Args:

matrix: (m, n) の実配列。

Returns:

m == 1 なら (n,)、それ以外は (m, n)。

Raises:

ValueError: 2-D でない / 非有限。

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

representation_conversionpy -3.11 examples/representation_conversion.py

Ops the type connects to (they accept descriptor as input)

descriptor_to_matrix · descriptor_to_table

Same category (descriptor)

descriptor_to_matrix · descriptor_to_table


*Provenance: reprconv.py — REPRCONV operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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