morph_geodesic_ac — SEGMENTATION contour op

• Data kinds: image2d × mask → table

• Call: import fullseye as fs; fs.ledger.morph_geodesic_ac(gimage, init, *, n_iter: 'int' = 100, smoothing: 'int' = 1, threshold='auto', balloon: 'float' = 0.0, phase: 'int' = 0, record_every: 'int' = 0) -> 'Dict[str, object]' (to call the implementation directly, import segcontour; segcontour.morph_geodesic_ac(gimage, init, *, n_iter: 'int' = 100, smoothing: 'int' = 1, threshold='auto', balloon: 'float' = 0.0, phase: 'int' = 0, record_every: 'int' = 0) -> 'Dict[str, object]'; from the registry, opssegmentation.get("morph_geodesic_ac"))

Usage

Morphological geodesic active contour (MorphGAC of Márquez-Neila et al. 2014). gimage = an image that is small on edges (the g of edge_stop_g) (morph_geodesic_ac).

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

1 反復 = 風船段(balloon > 0 で 3×3 の膨張、< 0 で収縮を g > threshold/|balloon| の画素にだけ)+ 引力段

(∇g · ∇u > 0 の画素を内側、< 0 を外側 = g の谷へ輪郭を引く)+ 平滑段(曲率の作用素を `smoothing` 回、交互)。

`threshold="auto"` は g の 40 % 点(skimage と同じ)。落とし穴(実測): 背景が厳密に平坦だと g ≡ 1 の画素が 40 % を

超え、閾値 = 1 で「g > 1/|balloon|」の画素が無くなり風船が一度も働かない(輪郭は初期のまま止まる)。ぼかしの裾で g が

1 − 10⁻¹³ になる画像では偶然働く。平坦な合成画像では閾値を数で与えること。`phase は morph_chan_vese` と同じ。

返り値: `mask、threshold、history、n_iter、n_changed`(反復ごと)。

Detailed usage guide

• halcon_segmentation family guide

Background guides (the physics and conventions behind this op)

• active_contours_and_level_sets — 変分・動的輪郭とレベルセット — どの輪郭がどこで止まり、何を保証するか

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)

• poc_active_contours — py -3.11 examples/poc_active_contours.py

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

class_ndim_norm

Same category (contour)

snake_evolve · gvf_field · chan_vese_energy · chan_vese_evolve · morph_chan_vese · edge_stop_g · level_set_reinit · drle_evolve


*Provenance: segcontour.py — SEGMENTATION 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.