find_checkerboard_corners — CALIB checkerboard op

• Datenarten: image2d → keypoints

• Aufruf: import fullseye as fs; fs.ledger.find_checkerboard_corners(image, pattern_size, sigma=1.5, refine_window=None) (die Implementierung direkt: import calib_lm; calib_lm.find_checkerboard_corners(image, pattern_size, sigma=1.5, refine_window=None); aus dem Register: opscalib.get("find_checkerboard_corners"))

• GPU: nein (nur CPU-Referenzimplementierung)

Verwendung

Erkennt die inneren Ecken eines Schachbrettbilds subpixelgenau und gibt sie in der zeilenweisen Reihenfolge des Bretts zurück (keypoints).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

Detect the inner corners of a checkerboard with pattern_size = (cols, rows) inner corners, refine them to sub-pixel accuracy and return them as (row, col) in the board's row-major order (pairs with checkerboard_points).

手順: (1) ガウスの 2 階微分(尺度 sigma)で鞍点の強さ −det(Hessian) を出し、局所最大を候補に

(2) 各候補を Förstner の勾配直交の式(OpenCV の cornerSubPix と同じ原理: 窓の中の勾配 g が角へ向かう

ベクトルと直交 → Σ g gᵀ (p − q) = 0)で反復して詰める(Förstner & Gülch 1987)

(3) 最寄りの近傍から格子の 2 方向を決め、局所の平行四辺形で予測しながら格子を伸ばす

(4) 埋まった格子が cols x rows(または転置)でなければ拒否。

順の約束: 列の方向 = 長さ cols の軸。2 つの軸の向きは「画像で右手系(板を表から見る)」と「最初の角が画像の左上に最も近い」で決める。★対称な板の 180 度の回転は区別しない —— 校正には効かない(板の点の集合がその回転で自分に写るので、姿勢が 180 度回るだけ)。cols = rows の板では 90 度も区別しない。

返す (N, 2): (row, col)、N = cols·rows。

Raises ValueError: 画像が 2 次元でない・非有限、角の数が合わない・格子が組めない(板が見えない・ぼけすぎ・一部が画像の外)、引数の範囲外。

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie camera_calibration

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_calibration_truth_map — py -3.11 examples/poc_calibration_truth_map.py

Typkompatible Folge-Operatoren (nehmen keypoints als Eingabe)

image_to_world_plane · camera_calibration · camera_calibration_lm · stereo_calibration_lm · vector_to_rigid · vector_to_similarity · hom_vector_to_proj_hom_mat2d

Gleiche Kategorie (checkerboard)

checkerboard_points · sim_checkerboard


*Provenance: calib_lm.py — CALIB Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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