select op• 데이터 종류: labels → labels
• 호출: import volcolor; volcolor.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria)(또는 opsvolcolor.get("vol_select_labels"))
3-D 특징으로 성분을 거릅니다(2-D 블롭 선별의 3-D 판).
> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.
`(labels_out, kept_ids)` を返す。落ちた成分のボクセルは 0(背景)になる。
*props* は :func:vol_label_shape_stats か :func:volops.vol_region_props の
返り値。`None なら :func:vol_label_shape_stats` をその場で呼ぶ。
条件(すべて省略可・与えたものは AND):`min_volume max_volume`
`min_voxels max_voxels min_sphericity max_sphericity`
`min_elongation max_elongation min_isotropy max_isotropy`
`min_equivalent_diameter max_equivalent_diameter`。加えて
`exclude_border=True` でボリューム端に接する成分を落とす(CT の視野で
切れている粒子を計測から外す標準手順)、`keep=[...]` で残す id を直接指定。
必要なキーが props に無ければ ValueError。たとえば `min_sphericity` を
:func:vol_label_shape_stats の結果に対して指定すると、`sphericity` は
そちらが出さない量なので拒否する ―― 欠けたキーを既定値で埋めると「条件を
書いたのに一件も落ちない」フィルタが黙って出来上がる。
`relabel`:
• `False`(既定)―― 元の id をそのまま残す。ゆえに
:func:vol_colorize_labels を前後で呼んでも残った成分の色は変わらない。
「ふるいにかけて色が残っていく」図が成立するのはこの既定のおかげである。
• `True ―― 残った成分を 1..k` へ振り直す。色は総取り替えになる
(ラベル番号がパレットの行番号だから)。下流が連番を要求する場合だけ使う。
この 1 引数がこの族の売りを壊せる唯一の場所なので、明示的にした。
Returns `(labels_out int32 (D, H, W), kept_ids np.ndarray int64)`.
Raises `ValueError` for an unknown criterion, a criterion whose key is absent
from *props*, a *props* that does not cover the labels present, or a *keep*
containing a label that is not in the volume.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• voxel_labels_color — py -3.11 examples/voxel_labels_color.py
labels 를 입력으로 받는 것)vol_colorize_labels · vol_label_overlay · vol_label_shape_stats · vol_label_legend · vol_labels_to_meshes · vol_label_volume_render
select)—
*Provenance: volcolor.py — VOLCOLOR 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.