link_edges — 3D edges op

• 데이터 종류: voxel → voxel

• 호출: import fullseye as fs; fs.ledger.link_edges(edge_mask)(구현을 직접 호출하려면 import edges3d; edges3d.link_edges(edge_mask), 원장에서 가져오려면 ops3d.get("link_edges"))

• 원장 경유의 반환값: fullseye.ledger.link_edges(...) 는 **선언된 out 형 voxel 의 값만** 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.link_edges.raw(...) 를 쓰거나 edges3d.link_edges 를 직접 호출하세요.

• 실제 반환: (linked, n)

사용법

에지 mask 를 26 이웃으로 연결 성분 라벨링합니다.

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

Parameters

----------

edge_mask : (D,H,W) bool

Returns

-------

labels : (D,H,W) int

各 voxel の成分ラベル(背景 = 0、成分 = 1..n)。

n : int

連結成分数。

Notes

-----

26 連結(3x3x3 の全近傍)。断片化したエッジ片を 1 本の曲線 / 閉曲面としてまとめ、

下流の Hough / chamfer で成分単位に扱えるようにする。

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

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

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

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

• sensor_seg — py -3.11 examples_3d/sensor_seg.py

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

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

같은 카테고리(edges)

gradient3d · canny3d · log_zero_crossings · edge_points

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

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