points_to_position — REPRCONV keypoint op

Data kinds: pointsposition

Call: import reprconv; reprconv.points_to_position(points) (or opsreprconv.get("points_to_position"))

Usage

A point set `(N,3) → its centroid (z, y, x)`. Not invertible (the distribution is thrown away).

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

捨てた量は測れる: 重心まわりの RMS 距離が「1 点に潰したときに失った広がり」

そのもので、`selftest` はこれを数字で出す。N = 1 のときだけ

:func:position_to_points との往復が bit 一致する。

Args:

points: (N, 3) の (z, y, x)。

Returns:

3-tuple の float (z, y, x)。

Raises:

ValueError: 形状不正 / 非有限。

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

representation_roundtrippy -3.11 examples/representation_roundtrip.py

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

position_to_points

Same category (keypoint)

keypoints_uv_to_points · points_zyx_to_keypoints_uv · keypoints_to_image2d · keypoints_from_image2d · position_to_points


*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.