¿Qué hace fractalwright?
Resultado: cada imagen es un PNG con un archivo JSON de receta a su lado que la redibuja píxel a píxel. Los números (dimensión, área, simetría) se miden, nunca se adivinan.
FW significa python scripts/fw.py desde la raíz del repositorio (ejecútalo, no lo leas).
Paso 0: herramientas
Ejecuta la tarea de inmediato. Ejecuta FW doctor solo cuando un comando falle por falta de una herramienta (NumPy es el núcleo; moderngl, Playwright y ffmpeg son opcionales y solo se sondean). La actualización (evergreen.json) se lee al usar 'refresca fractalwright', no en cada uso. Renderiza el preset tal como se da; ajusta el aspecto (iteraciones, densidad, supermuestreo) solo cuando se pida.
Paso 1: elige la familia
FW explain <family> da la fórmula, cómo se construye y los presets. Familias: mandelbrot, julia, burning-ship, tricorn, multibrot, kronecker (fractales de rejilla exactos: FW render kronecker-carpet, o --mask 111,101,111 --power 6). Nuevo en caos: FW explain logistic da el orden didáctico, --plot cobweb|bifurcation -o out.png lo dibuja; FW explain coastline explica D mediante las reglas de Richardson. Lee references/02-escape-time.md solo cuando el usuario pida profundidad o un método de coloreado más allá del suave.
Paso 2: renderizar
FW render <preset o recipe.json> -o out.png [--size WxH] [--iter N] [--palette NAME] [--supersample 2]. Escribe out.png y out.json. Confirma que ambos archivos existen antes de informar. Para cambiar una vista, edita view.centre y view.width de la receta (cadenas decimales, conserva todos los dígitos) y renderiza la receta de nuevo. FW palette lista las paletas; FW palette NAME -o swatch.png muestra una. Más allá de un ancho de aproximadamente 1e-13, float64 falla; dilo en lugar de renderizar ruido (references/03-deep-zoom.md).
Paso 2a: explorar
FW serve [--port 8765] [--out-dir DIR] [--open] ejecuta el explorador WebGL2 solo en 127.0.0.1 (cualquier otro host es rechazado). Arrastrar para mover la vista, rueda o pellizco para hacer zoom, clic con mayúsculas para elegir Julia c; fórmula, iteraciones, rotación ([ y ] giran 15 grados) y paleta se encuentran en el panel lateral; las recetas con paletas de parada (hasta 8 paradas) viajan en el hash como ps=pos:rrggbb,.... El hash de la URL es la vista completa, por lo que la dirección es un enlace para compartir. Un cuadro de precisión advierte cuando float32 se acerca a su límite; más allá de eso, Mandelbrot y Julia (potencia 2, ancho >= 1e-60) cambian a GPU profunda: la página publica la vista en /orbit, el servidor calcula la órbita de referencia Decimal, y la página la dibuja con el sombreador de perturbación de doble precisión (las cadenas del centro conservan cada dígito durante el zoom; mientras una nueva órbita está pendiente, la página muestra una previsualización aproximada de la última órbita y cancela las solicitudes obsoletas); Render exacto solicita al servidor un PNG NumPy (o de perturbación) de la misma vista, Exportar escribe un JSON de receta en el directorio de salida. FW export "<share url o #hash>" -o recipe.json hace lo mismo desde la línea de comandos. --route browser renderiza con Edge sin cabeza y el sombreador de la página; --deep --route browser (o cualquier ancho inferior a 1e-12) ejecuta perturbación de doble precisión en la GPU hasta un ancho de 1e-60 (diferencias de recuento del 0.1-1%), por lo que usa la ruta de la CPU cuando los recuentos exactos importan. Detalles (alternativas, --gpu-precision float32, burning ship): references/13-route-details.md.
Paso 2b: láminas y video
FW audio <song.wav> [--preset julia-pulse|mandel-dive] [--recipe R] [--size 640x360] [--fps 30] [--duration S] [--intensity 0.6] [--route auto|browser|numpy] crea un video musical: las envolventes de la canción impulsan el fractal (bajo, golpes, medios, croma, agudos, volumen; nada se mueve en silencio), los fotogramas pasan por un limitador de destellos, flashcheck filtra el resultado (código de salida 4 en caso de fallo) y la canción se multiplexa. Se rechaza MP3 a menos que se use --allow-mp3. FW serve también sirve /audio, una página en vivo. Detalles del mapeo: references/13-route-details.md.
FW sheet <recipe> --palettes A,B,C o --vary params.max_iter --values 100,300,1000 (valores complejos como re:im) escribe un PNG de lámina de contactos etiquetado y un JSON con la receta de cada mosaico. Video: FW zoom <recipe> --to-width W [--from-width W0] [--to-centre re,im] (ancho exponencial, centro suavizado), FW morph <recipe> --path "re,im;re,im" (julia c por defecto, --vary para otro parámetro), FW loop <recipe> --circle re,im,r [--phase] (trayectoria cerrada, el último fotograma envuelve al primero). Todos aceptan --size WxH --fps N --duration S, escriben los fotogramas exactos en <out>_frames/, un mp4 H.264 (yuv420p, CRF 18) y <out>.json con animation (fotogramas clave, fps, duración_s). El estilo AI está desactivado por defecto; --ai añade una copia img2img de ComfyUI Z-Image (<out>_ai.*, marcada como interpreted) y siempre conserva el video exacto (references/13-route-details.md). Cada video recibe una verificación de destellos; FW flashcheck <video or frame dir> lo ejecuta solo y sale con código 4 cuando ocurren destellos de luminancia del 10% (o rojo saturado) más de 3 veces por segundo juntos en más del 25% de un campo de 10 grados; la línea de veredicto nombra la regla fallida y su área (los swings/s de todo el fotograma son solo de referencia, por lo que "1 swings/s" no significa aprobado o reprobado). Informa de un fallo, nunca lo envíes (references/09).
Paso 2c: IFS, atractores, terreno, interpolación
FW ifs sierpinski|fern|unequal-tiles -o out.png (juego del caos, p por |det|, primeros 20 puntos descartados, enmarcado por una bola que garantiza que contiene el atractor). FW attractor-search --hits 5 -o best.png (mapeos cuadráticos de Sprott clasificados por D2 1.1-1.5 y L pequeño, una regla de libro; Lyapunov en bits). FW terrain -o t.png [--method midpoint] [--H 0.8] (espectral por defecto; las arrugas del punto medio se miden) escribe un PNG y un .npy. FW fif --points "0,0;1,1;2,0" --d 0.5,-0.5 -o f.png [--numbers y.txt] dibuja una curva de interpolación fractal a través de los puntos.
Paso 2d: llamas, L-sistemas, atractores
FW flame [sierpinski|swirl-sierpinski|recipe.json] -o f.png [--seed N --tries 24] (juego del caos sobre transformaciones, 12 variaciones de Draves-Reckase, transformación final, mezcla de colores, densidad logarítmica con gamma y vitalidad, supermuestreo 2, estimación de densidad; sin preset = llamas aleatorias con semilla puntuadas por cobertura, se conserva la mejor). FW lsystem koch|koch-snowflake|dragon|hilbert|sierpinski-arrowhead|plant-a|plant-b|plant-d|plant-e|plant-f|plant-stochastic -o p.png [--n N --seed N] escribe PNG, SVG y receta. FW attractor clifford|dejong|icon|icon-3|icon-halloween|icon-clam|icon-streamers|icon-flower|lorenz|chen|lu|multiscroll -o a.png [--params a,b,c,d] [--search] (iconos de Symmetry in Chaos Tabla A.1; los parámetros multiscroll son a, Mx, Nx de Yalcin) (sombreado de densidad; la búsqueda clasifica conjuntos aleatorios de Clifford o de Jong por la regla de Sprott). Cada comando escribe un JSON de receta que lo redibuja.
Paso 2f: vecinos (no todos fractales)
FW rd coral|mitosis|default [--f F --k K --steps N --seed N] (Gray-Scott). FW ca 90|30|B3/S23 [--steps N] (regla elemental o similar a Life). FW tiling square|triangle|hex|penrose [--n N]. FW kleinian apollonian|grandma [--ta T --tb T] (Junta Apolonia, o un conjunto límite de dos generadores a partir de la receta de Grandma dibujado mediante la búsqueda de palabras en profundidad del libro; --method random para iteración inversa). Cada uno escribe un PNG y una receta. Di claramente que la reacción-difusión y los teselados no son fractales; FW measure box sobre un teselado dice "no es fractal" (references/12-neighbours.md).
Paso 2e: 3D
FW 3d render mandelbulb|mandelbox|quatjulia|menger|hybrid [--view whole|close] [--remedy ao|shadow|fog|trap|dof|aa|camera|all|none] -o x.png (DE trazado por esferas en Edge sin cabeza; escribe la receta con la cámara explícita). Aspecto predeterminado desde 0.8.0: trazado de trayectorias con 256 muestras (cielo + sol, aproximadamente 0.5-2 s) con una cámara compuesta (40 mm, ángulo bajo, sujeto en el tercio izquierdo); --pt 0 da el aspecto rápido de sombra + oclusión ambiental, que se adapta mejor a formas cúbicas tipo Menger; un archivo de receta conserva su propia configuración. --remedy añade al aspecto de sombra/ao, --remedy none lo limpia primero. Deja la niebla y la profundidad de campo desactivadas a menos que se pida: la niebla desvaneció al sujeto en la prueba de aspecto y la profundidad de campo desenfoca las vistas cercanas. FW 3d recipe ... imprime la receta; FW 3d gate -o DIR renderiza la matriz de remedios y las láminas. Solo ruta de navegador, sin respaldo de NumPy. Una ruta normal desde la prueba de aspecto 3D (2026-11-14). --pt N [--bounces 2] [--seed 1] establece las muestras (misma semilla, mismos píxeles; 512 px a 256 spp en 0.5-1.8 s); consulta references/07-3d.md. Malla imprimible: FW 3d mesh <formula|recipe> [--size-mm 60] [--res 200] [--engine auto|skimage|numpy] [--wall-mm 0.9] -o x.stl muestrea el mismo DE en NumPy y escribe un sólido hermético como STL binario en mm (JSON adjunto: triángulos, cáscaras, volumen, tiempo; sale con código 3 si no es hermético). Menger por defecto al nivel 3 para impresión. --wall-mm X genera la malla de la superficie desplazada DE = t (t = X/2 a escala de impresión) para que las partes delgadas se engrosen hacia X mm; 0.9 resolvió la advertencia de pared delgada de Mandelbulb FDM (2.7% -> 0.1% por debajo de 0.9 mm). Multicolor: -o x.3mf (o --colors N, valor predeterminado 4, máximo 8; --palette "#hex,...") también escribe un 3MF coloreado por la trampa de órbita (contenedores de superficie igual, un filamento cada uno; Bambu Studio y PrusaSlicer leen las etiquetas de filamento por triángulo). Luego pw.py check x.stl --target print-fdm (polywright-print; también lee el 3MF).
Paso 3: medir
FW measure box image.png [--invert] [--threshold T]: dimensión de conteo de cajas de los píxeles oscuros (o claros) en más de 15 tamaños de caja y desplazamientos aleatorios con semilla, con el rango de ajuste en décadas, la curva de pendiente local y un veredicto. Transmite el veredicto tal como está escrito: por debajo de dos décadas es "solo descriptor"; una pendiente local que se desvía es "no fractal". Da D con su barra de error de references/08-measuring.md, nunca como exacto, y nunca nombres una forma a partir de D.FW measure lacunarity image.png: huequera por tamaño de caja, el segundo número junto a D (el mismo D puede verse diferente).FW measure ifs --ratios 0.5,0.5,0.5: dimensión de similitud; exacta solo cuando las piezas no se superponen, de lo contrario un límite superior.- Los perfiles de altura y mapas de altura son autoafines:
FW measure profile numbers.txt(pendiente espectral, semivariograma, Katz) yFW measure heightmap map.png|.npy(espectro radial, D superficial = 3 - H).measure boxrechaza un archivo de números. FW measure katz curve.txt(x,y o una columna): un número de rugosidad barato, no D.FW measure area --size 1024: área de Mandelbrot por recuento de píxeles (demostrado dentro de 0.0002 de 1.50659 a 1024 px).
Paso 4: identificar
FW identify <preset | recipe.json | image.png> [--c re,im]: características hechas a mano (simetría de espejo de los píxeles, Julia conectada o polvo a partir de la órbita de 0, cardioide principal o bulbo de período 2 para c, la simetría conocida de la familia). La D de caja de una imagen se informa solo como descriptor. Nunca identifiques un fractal por su dimensión.
Mantenimiento
Archivos unitarios en la raíz del repositorio: evergreen.json, RESEARCH.md, CHANGELOG.md, LEARNINGS.md, TESTS.md. Las fuentes de fractal-art actualizan las recetas; harvest.json lista los objetivos de cosecha.