mosaic_tiles_render — PRINTPATH npr op

• データ種: image2d × pairs → image2d

• 呼び出し: import fullseye as fs; fs.ledger.mosaic_tiles_render(image, sites) (実装を直接呼ぶなら import printpath; printpath.mosaic_tiles_render(image, sites)、台帳から引くなら opsprintpath.get("mosaic_tiles_render"))

使い方

Paint each Voronoi cell with the mean of the pixels it owns.

★Why the mean and not something prettier: for a fixed partition the mean

is the `L2`-optimal constant — no other value lowers the squared error

inside the cell. The tile colour is therefore a solution, not a taste, and any

alternative can be *shown* to be worse by evaluating the same sum.

Returns an `image2d`: the mosaic.

Raises `ValueError`: sites not (N, 2) with N >= 1; sites outside the

image; a non-finite or oversized image.

Limits: cells are convex polygons, so this does not imitate the irregular

tesserae of real mosaic and never runs a single tile along an edge the way a

mosaicist would.

詳しい使い方ガイド

• printpath ファミリ ガイド

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• poc_beats_fringes_and_screens — py -3.11 examples/poc_beats_fringes_and_screens.py

型が繋がる次の op(image2d を入力に取れる)

stipple_points_from_image · stipple_energy · stroke_tone_error · halftone_screen · engrave_lines · hatch_field · mosaic_tiles_sites · print_layer_defect_map

同カテゴリ(npr)

halftone_screen · halftone_moire_period · engrave_lines · hatch_field · mosaic_tiles_sites


*Provenance: printpath.py — PRINTPATH operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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