select op• 데이터 종류: labels → labels
• 호출: import fullseye as fs; fs.ledger.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria)(구현을 직접 호출하려면 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"))
• 원장 경유의 반환값: fullseye.ledger.vol_select_labels(...) 는 선언된 out 형 labels 의 값만 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.vol_select_labels.raw(...) 를 쓰거나 volcolor.vol_select_labels 를 직접 호출하세요.
3-D 특징으로 성분을 거릅니다(2-D 블롭 선별의 3-D 판).
(labels_out, kept_ids) 를 반환한다. 떨어진 성분의 복셀은 0(배경)이 된다.
*props* 는 vol_label_shape_stats 나 volops.vol_region_props 의반환값. None 이면 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 를 vol_label_shape_stats 의 결과에 대해 지정하면, sphericity 는그쪽이 내지 않는 양이므로 거부한다 ―― 빠진 키를 기본값으로 메우면 "조건을썼는데 한 건도 떨어지지 않는" 필터가 조용히 만들어진다.
relabel:
• False(기본값) ―― 원래의 id 를 그대로 남긴다. 따라서 vol_colorize_labels 를 전후로 호출해도 남은 성분의 색은 바뀌지 않는다. "체로 걸러도 색이 남아 가는" 그림이 성립하는 것은 이 기본값 덕분이다.
• True ―― 남은 성분을 1..k 로 다시 매긴다. 색은 전부 바뀐다 (라벨 번호가 팔레트의 행 번호이므로). 하류가 연번을 요구하는 경우에만 쓴다. 이 1 인수가 이 족의 장점을 깨뜨릴 수 있는 유일한 곳이므로 명시적으로 했다.
(labels_out int32 (D, H, W), kept_ids np.ndarray int64) 를 반환한다. 알 수 없는 조건, 키가 *props* 에 없는 조건, 실재하는 라벨을 다 포함하지 않는 *props*, 또는 볼륨에 없는 라벨을포함한 *keep* 에 대해 ValueError 를 낸다.
• 샘플 데이터 카탈로그(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.