No description

Find a file

copilot 564636a74e Tune RST profiles for high-res dense mosaics with full coverage. Raise master_max and piece counts, cache tile prep, and scale mittel/dicht from the validated wenig density ladder so each profile can fill the canvas. Co-authored-by: Cursor <cursoragent@cursor.com>		2026-09-29 00:38:02 +02:00
code	re-adding code	2013-07-05 12:55:12 -07:00
fonts	Create gh-pages branch via GitHub	2013-04-25 14:11:01 -07:00
images	Delete DISQUS_blog.md	2013-07-09 10:55:22 -07:00
javascripts	Create gh-pages branch via GitHub	2013-04-27 13:00:33 -07:00
reference/upstream-matlab	Add Python fractal-mosaic CLI and unpack MATLAB reference	2026-09-24 17:03:12 +02:00
src/fractal_mosaic	Tune RST profiles for high-res dense mosaics with full coverage.	2026-09-29 00:38:02 +02:00
stylesheets	uploading tweaked stylesheet	2013-04-29 15:38:44 -07:00
.gitignore	Add Python fractal-mosaic CLI and unpack MATLAB reference	2026-09-24 17:03:12 +02:00
DESIGN.md	Tune RST profiles for high-res dense mosaics with full coverage.	2026-09-29 00:38:02 +02:00
index.html	re-added paper	2013-05-06 20:27:30 -07:00
LICENSE	Add Python fractal-mosaic CLI and unpack MATLAB reference	2026-09-24 17:03:12 +02:00
log_polar_registration_framework.html	re-added paper	2013-05-06 20:27:30 -07:00
params.json	Create gh-pages branch via GitHub	2013-04-27 13:30:38 -07:00
pyproject.toml	Add Python fractal-mosaic CLI and unpack MATLAB reference	2026-09-24 17:03:12 +02:00
README.md	Add Python fractal-mosaic CLI and unpack MATLAB reference	2026-09-24 17:03:12 +02:00
Sample_Markdown.md	hahaha	2014-01-14 17:27:53 -08:00

README.md

Fractal Mosaics (Tower fork)

Fork of s-ben/Fractal-Mosaics adapted for the Tower mosaik drop-inbox.

Upstream implements a rotation / scale / translation invariant photomosaic algorithm (log-polar registration + CBIR prefilter + large-first placement). Original code is MATLAB (GPL-3.0). This repository keeps the unpacked MATLAB sources under reference/upstream-matlab/ and ships a Python CLI for headless use on Arch/Linux.

Credit

Original author: Seth Benton — https://github.com/s-ben/Fractal-Mosaics
Algorithm write-up: https://s-ben.github.io/Fractal-Mosaics/
License: GNU GPL v3 (see LICENSE and reference/upstream-matlab/gpl_license.txt)

Python CLI (Tower)

python3 -m venv .venv && source .venv/bin/activate
pip install -e '.[cli]'

fractal-mosaic \
  --master path/to/target.jpg \
  --tiles path/to/tile_pool/ \
  --output out.png \
  --profile mittel

Profiles: wenig (fast, larger tiles), mittel, dicht (more placements, slower).

Constraints for Tower v1: geometric transforms + edge alpha only — no tile recoloring.

Layout

Path	Role
`reference/upstream-matlab/`	Unpacked `.m` files from upstream package
`reference/package/`	Original `FractalMosaics_package.tar.gz`
`src/fractal_mosaic/`	Python engine + CLI
docs site (`index.html`, …)	Upstream gh-pages documentation (preserved)