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