mosaic_tiles_sites — PRINTPATH `npr` op

• Datenarten: image2d → pairs

• Aufruf: import fullseye as fs; fs.ledger.mosaic_tiles_sites(image, n_tiles=400, iterations=12, seed=0, weighted=True) (die Implementierung direkt: import printpath; printpath.mosaic_tiles_sites(image, n_tiles=400, iterations=12, seed=0, weighted=True); aus dem Register: opsprintpath.get("mosaic_tiles_sites"))

Verwendung

Lloyds Iteration auf einem Bild — die Kachelzentren eines Mosaiks.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie printpath

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_beats_fringes_and_screens — py -3.11 examples/poc_beats_fringes_and_screens.py

Typkompatible Folge-Operatoren (nehmen `pairs` als Eingabe)

stipple_energy · stroke_tour_closed · mst_length · stroke_resample_closed · stroke_tone_error · mosaic_tiles_render

Gleiche Kategorie (`npr`)

halftone_screen · halftone_moire_period · engrave_lines · hatch_field · mosaic_tiles_render

*Provenance: printpath.py — PRINTPATH Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

mosaic_tiles_sites — PRINTPATH npr op