r2_inner_circle — 2D region op

Datenarten: regionregion

Aufruf: fullseye.apply(img, "r2_inner_circle", a=0.5, b=0.5) (das 2-D-Modell ist ein Bild plus zwei skalare Regler a,b∈[0,1])

HALCON-Äquivalent: inner_circle (Bedeutung und Parameter sind in der HALCON-Referenz nachzulesen)

r2_inner_circle: input → output

*Die Abbildung ist die tatsächliche Ausgabe auf einer synthetischen 128×128-Eingabe. Links Eingabe, rechts Ausgabe. Punktwolken als Draufsicht-Streudiagramm (Helligkeit = z), 1-D-Reihen als Linie, Volumen als Maximum-Projektion entlang z, Videos als mittleres Bild, komplexe Bilder als Betrag; Rückgabewerte, die kein Bild ergeben, werden als Werte gezeigt.*

Regler a durchfahren (0,1 / 0,5 / 0,9, der andere Regler auf Standard):

r2_inner_circle: knob a sweep (docs site)

*Regler b ändert die Ausgabe nicht (gemessen: identisch bei 0,1 / 0,5 / 0,9).*

Stufen (die vorangehenden Ops → dieser Op, von links nach rechts):

r2_inner_circle: stages (docs site)

Auf anderen Bildern (synthetische Szene / Foto / Münzen. Obere Reihe: Eingaben, untere Reihe: deren Ausgaben. Regler auf Standard):

r2_inner_circle: other inputs (docs site)

Verwendung

Größter einbeschriebener Kreis als Maske (a skaliert den gezeichneten Radius; a=0,5 = exakt).

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

領域の最大内接円をマスクとして描く。入力を `> 0.5` で前景マスクに直し、

`scipy.ndimage.distance_transform_edt` で各前景画素から最近傍の背景画素

までの距離を取り、その最大値 `r0 を与える画素を中心 (cy, cx)` とする

(最大値が複数あれば行優先で最初の画素)。描く半径は

`r = r0 * (0.6 + 0.8*a) で、a=0 で 0.6 倍、a=0.5r0` そのまま、

`a=1 で 1.4 倍(a は [0,1] に clip、非有限なら 0.5)。b` は未使用。

返り値は入力と同形の float64 0/1 マスク(円板 `(y-cy)^2+(x-cx)^2 <= r^2`)。

前景が無ければ全零。座標は (row, col)。

注意: `r0 は「背景画素の中心までの距離」なので、a=0.5` でも描いた円板は

領域の縁を 1 画素程度はみ出すことがある(10x20 の矩形で 2 画素、半径 7 の

円板で 12 画素の外側画素を実測)。厳密に内側へ収めたいなら `a` を少し

下げる。領域が複数の連結成分からなる場合も内接円は 1 つだけ(最も太い成分の

もの)。3 次元配列 (H,W,C) は (H, W*C) に平坦化されるのでカラー画像は渡さない。

前段に `thresholdselect_largest`、対になる外接円は

`r2_smallest_circle`(両者の半径比が真円度の粗い指標になる)。

Ausführlicher Anwendungsleitfaden

Leitfaden zur Familie gallery2d_region

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.

In Studio ausprobieren

Das Programm unten ist nachweislich lauffähig (gleiche Eingabe wie die Abbildung). In der Studio-Hilfe wird dieser Block zu Schaltflächen, die es sofort laden und ausführen.

threshold 0.50 0.50
r2_inner_circle 0.50 0.50

▸ Load this pipeline  ·  Load & run

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

gallery2d_regionpy -3.11 examples/gallery2d_region.py

Typkompatible Folge-Operatoren (nehmen region als Eingabe)

identity · reg_erode · reg_dilate · reg_open · reg_close · fill_holes · select_largest · remove_small

Gleiche Kategorie (region)

reg_erode · reg_dilate · reg_open · reg_close · fill_holes · select_largest · remove_small · invert_region


*Provenance: ops.py — 2D 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.