vol_label_color_flicker — VOLCOLOR diagnose op

데이터 종류: voxeltable

호출: import volcolor; volcolor.vol_label_color_flicker(vol_binary, axis='z', seed: 'int' = 0, connectivity: 'int' = 26, connectivity_2d: 'int' = 8)(또는 opsvolcolor.get("vol_label_color_flicker"))

사용법

「자르고 나서 색을 입힌다」와 「색을 입히고 나서 자른다」의 차이를 셉니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

同じ 2 値ボリュームに対して 2 通りの手順を踏む:

A. スライスごと ―― 各断面を 2-D で連結成分ラベリングし、

:func:imgio.colorize_labels と同じパレットで色を付ける。

断面ごとに番号が振り直されるので、同じ部品でも層が変われば色が変わりうる。

B. ボリュームで ―― :func:volops.vol_label でラベリングしてから

:func:vol_colorize_labels で色を付け、あとで切る。

返りは dict:

`n_components 3-D 成分数 · n_slices` 断面の数 ·

`slices_with_change` A で 1 つ以上の成分の色が変わった断面の本数 ·

`changed_pairs` A で色が変わった (成分, 断面) の組の数 ·

`changed_components` A で一度でも色が変わった成分の数 ·

`volume_slices_with_change / volume_changed_pairs` /

`volume_changed_components` B の同じ量(構造上 0) ·

`pairs_checked` 比較した (成分, 断面) の総数 ·

`flicker_rate changed_pairs / pairs_checked`。

比較の定義:各 3-D 成分 `c について、c` が現れる最初の断面での色を

基準とし、以降の断面で `c` の画素の最頻色が基準と違えば 1 件と数える

(1 つの 3-D 成分が 1 断面で複数の 2-D 片に割れることがあるため、代表は

最頻色。同数の場合は RGB の辞書順で小さい方 = 決定的)。

実測(`(24, 48, 48)`・16 球の参照ファントム、seed=0、axis="z"、

`connectivity=26 / connectivity_2d=8):pairs_checked=108`、

`slices_with_change=20 / 24changed_pairs=62`(57.4 %)、

`changed_components=16 / 16`。B 側は 3 つとも 0 ―― **構造上 0 であって、

たまたま 0 なのではない**(ラベル番号がボリューム全体で一意だから)。

Raises `ValueError` for a bad volume, an unknown *axis*, or a *connectivity*

that is not 6 / 18 / 26 (2-D: 4 / 8).

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

voxel_labels_colorpy -3.11 examples/voxel_labels_color.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

같은 카테고리(diagnose)


*Provenance: volcolor.py — VOLCOLOR 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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