mosaic_tiles_sites — PRINTPATH npr op

• 데이터 종류: image2d → pairs

• 호출: import fullseye as fs; fs.ledger.mosaic_tiles_sites(image, n_tiles=400, iterations=12, seed=0, weighted=True)(구현을 직접 호출하려면 import printpath; printpath.mosaic_tiles_sites(image, n_tiles=400, iterations=12, seed=0, weighted=True), 원장에서 가져오려면 opsprintpath.get("mosaic_tiles_sites"))

사용법

영상 위에서 도는 Lloyd 반복 —— 모자이크 타일의 중심。

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

Places *n_tiles* sites and moves each to the centroid of the pixels it owns, weighted by local contrast when *weighted* (so detail gets smaller tiles).

★Why this earns its place: Lloyd's iteration is a descent — the quantisation energy cannot increase — and that is a property of the algorithm, not of the picture. The energy is *not* reported here on purpose: the existing stipple_energy measures it from the sites, so the monotonicity can be checked by an op that did not produce them. Measuring your own descent with your own number proves nothing.

Returns pairs: the site coordinates (row, col).

Raises ValueError: fewer than 4 tiles or more tiles than pixels; negative iterations; a non-finite or oversized image.

자세한 사용 가이드

• printpath 패밀리 가이드

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

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

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

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

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

• poc_beats_fringes_and_screens — py -3.11 examples/poc_beats_fringes_and_screens.py

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

stipple_energy · stroke_tour_closed · mst_length · stroke_resample_closed · stroke_tone_error · mosaic_tiles_render

같은 카테고리(npr)

halftone_screen · halftone_moire_period · engrave_lines · hatch_field · mosaic_tiles_render


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

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