Que fait fractalwright ?
Résultat : chaque image est un PNG accompagné d'un JSON de recette qui permet de la redessiner pixel pour pixel. Les nombres (dimension, aire, symétrie) sont mesurés, jamais devinés.
FW signifie python scripts/fw.py depuis la racine du dépôt (exécutez-le, ne le lisez pas).
Étape 0 : outils
Exécutez la tâche directement. Lancez FW doctor uniquement lorsqu'une commande échoue pour un outil manquant (NumPy est le cœur ; moderngl, Playwright et ffmpeg sont optionnels et seulement sondés). L'actualisation (evergreen.json) est lue sur 'refresh fractalwright', pas à chaque utilisation. Rendez le preset tel quel ; ajustez l'apparence (itérations, densité, suréchantillonnage) uniquement lorsque demandé.
Étape 1 : choisir la famille
FW explain <family> donne la formule, comment elle est fabriquée et les presets. Familles : mandelbrot, julia, burning-ship, tricorn, multibrot, kronecker (fractales de grilles exactes : FW render kronecker-carpet, ou --mask 111,101,111 --power 6). Nouveau dans le chaos : FW explain logistic donne l'ordre pédagogique, --plot cobweb|bifurcation -o out.png le dessine ; FW explain coastline explique D avec les règles de Richardson. Lisez references/02-escape-time.md uniquement lorsque l'utilisateur demande de la profondeur ou une méthode de coloration au-delà du lissé.
Étape 2 : rendu
FW render <preset ou recipe.json> -o out.png [--size LxH] [--iter N] [--palette NOM] [--supersample 2]. Cela écrit out.png et out.json. Confirmez l'existence des deux fichiers avant de faire un rapport. Pour changer une vue, éditez view.centre et view.width de la recette (chaînes décimales, conservez chaque chiffre) et rendez la recette à nouveau. FW palette liste les palettes ; FW palette NOM -o swatch.png en affiche une. Au-delà d'une largeur d'environ 1e-13, float64 échoue ; dites-le plutôt que de rendre du bruit (references/03-deep-zoom.md).
Étape 2a : exploration
FW serve [--port 8765] [--out-dir REP] [--open] lance l'explorateur WebGL2 sur 127.0.0.1 uniquement (tout autre hôte est refusé). Le glissement pan, la molette ou le pincement zooment, shift-clic sélectionne le c de Julia ; la formule, les itérations, la rotation ([ et ] tournent de 15 degrés) et la palette se trouvent dans le panneau latéral ; les recettes avec palettes d'arrêt (jusqu'à 8 arrêts) voyagent dans le hash sous forme ps=pos:rrggbb,.... Le hash d'URL est la vue entière, donc l'adresse est un lien de partage. Une boîte de précision prévient lorsque float32 approche de sa limite ; au-delà, Mandelbrot et Julia (puissance 2, largeur >= 1e-60) basculent sur le deep zoom GPU : la page poste la vue vers /orbit, le serveur calcule l'orbite de référence décimale, et la page la dessine avec le shader de perturbation en double précision (les chaînes du centre conservent chaque chiffre pendant le zoom ; en attendant une nouvelle orbite, la page affiche un aperçu grossier de la dernière orbite et annule les requêtes obsolètes) ; Render exact demande au serveur un PNG NumPy (ou perturbation) de la même vue, Export écrit un JSON de recette dans le répertoire de sortie. FW export "<share url or #hash>" -o recipe.json fait la même chose depuis la ligne de commande. --route browser rend avec Edge sans tête et le shader de la page ; --deep --route browser (ou toute largeur inférieure à 1e-12) exécute une perturbation en double précision sur le GPU jusqu'à une largeur de 1e-60 (différences de comptage de 0.1 à 1 %), utilisez donc la route CPU lorsque les comptages exacts importent. Détails (replis, --gpu-precision float32, burning ship) : references/13-route-details.md.
Étape 2b : feuilles et vidéo
FW audio <morceau.wav> [--preset julia-pulse|mandel-dive] [--recipe R] [--size 640x360] [--fps 30] [--durée S] [--intensité 0.6] [--route auto|browser|numpy] crée un clip musical : les enveloppes du morceau pilotent la fractale (basses, battements, médiums, chroma, aigus, volume ; rien ne bouge dans le silence), les images passent un limiteur de flash, flashcheck valide le résultat (code de sortie 4 en cas d'échec), et le morceau est multiplexé. Le MP3 est refusé sauf si --allow-mp3. FW serve sert également /audio, une page en direct. Détails du mappage : references/13-route-details.md.
FW sheet <recette> --palettes A,B,C ou --vary params.max_iter --values 100,300,1000 (valeurs complexes sous forme re:im) écrit un PNG de planche contact étiquetée et un JSON avec la recette de chaque tuile. Vidéo : FW zoom <recette> --to-width L [--from-width L0] [--to-centre re,im] (largeur exponentielle, centre atténué), FW morph <recette> --path "re,im;re,im" (julia c par défaut, --vary pour un autre paramètre), FW loop <recette> --circle re,im,r [--phase] (chemin fermé, la dernière image boucle sur la première). Toutes prennent --size LxH --fps N --durée S, écrivent les images exactes dans <out>_frames/, un mp4 H.264 (yuv420p, CRF 18) et <out>.json avec animation (images clés, fps, durée_s). Le style IA est désactivé par défaut ; --ai ajoute une copie img2img Z-Image ComfyUI (<out>_ai.*, marquée interpreted) et conserve toujours la vidéo exacte (references/13-route-details.md). Chaque vidéo subit une vérification de flash ; FW flashcheck <video or frame dir> l'exécute seule et se termine avec le code 4 lorsque des flashes de 10 % de luminance (ou rouge saturé) se produisent plus de 3 fois par seconde ensemble sur plus de 25 % d'un champ de 10 degrés ; la ligne de verdict nomme la règle en défaut et sa zone (les variations sur l'image entière en swings/s sont fournies à titre indicatif, donc "1 swings/s" ne signifie ni succès ni échec). Signalez un échec, ne le livrez jamais (references/09).
Étape 2c : IFS, attracteurs, terrain, interpolation
FW ifs sierpinski|fern|unequal-tiles -o out.png (jeu du chaos, p par |det|, 20 premiers points ignorés, encadré par une boule qui contient l'attracteur de manière prouvée). FW attractor-search --hits 5 -o best.png (cartes quadratiques de Sprott classées par D2 1.1-1.5 et petit L, règle de livre ; Lyapunov en bits). FW terrain -o t.png [--method midpoint] [--H 0.8] (spectral par défaut ; plis du point milieu mesurés) écrit un PNG et un .npy. FW fif --points "0,0;1,1;2,0" --d 0.5,-0.5 -o f.png [--numbers y.txt] dessine une courbe d'interpolation fractale à travers les points.
Étape 2d : flammes, L-systèmes, attracteurs
FW flame [sierpinski|swirl-sierpinski|recipe.json] -o f.png [--seed N --tries 24] (jeu du chaos sur les xforms, 12 variations de Draves-Reckase, xform final, mélange de couleurs, log-densité avec gamma et vibrance, suréchantillonnage 2, estimation de densité ; pas de preset = flammes aléatoires ensemencées notées sur la couverture, la meilleure est conservée). 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] écrit PNG, SVG et recette. 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] (icônes du tableau A.1 de Symmetry in Chaos ; les paramètres multiscroll sont a, Mx, Nx de Yalcin) (ombrage par densité ; la recherche classe les ensembles aléatoires de Clifford ou de Jong selon la règle de Sprott). Chaque commande écrit un JSON de recette qui le redessine.
Étape 2f : voisins (pas tous fractals)
FW rd coral|mitosis|default [--f F --k K --steps N --seed N] (Gray-Scott). FW ca 90|30|B3/S23 [--steps N] (règle élémentaire ou semblable à Life). FW tiling carré|triangle|hex|penrose [--n N]. FW kleinian apollonian|grandma [--ta T --tb T] (joint apollonien, ou ensemble limite à deux générateurs de la recette de Grandma dessiné par la recherche en profondeur de mots du livre ; --method random pour l'itération inverse). Chacun écrit un PNG et une recette. Dites clairement que la réaction-diffusion et les pavages ne sont pas des fractales ; FW measure box sur un pavage dit "not fractal" (references/12-neighbours.md).
Étape 2e : 3D
FW 3d render mandelbulb|mandelbox|quatjulia|menger|hybrid [--view entier|proche] [--remedy ao|shadow|fog|trap|dof|aa|camera|all|none] -o x.png (DE en sphère-tracing dans Edge sans tête ; écrit la recette avec la caméra explicite). Aspect par défaut depuis 0.8.0 : chemin tracé à 256 échantillons (ciel + soleil, environ 0.5-2 s) avec une caméra composée (40 mm, angle bas, sujet sur le tiers gauche) ; --pt 0 donne l'aspect rapide ombre + occlusion ambiante, qui convient mieux aux formes cubiques de type Menger ; un fichier de recette conserve son propre réglage. --remedy ajoute à l'aspect ombre/ao, --remedy none l'efface d'abord. Laissez le fog et le dof désactivés sauf demande : le fog lessivait le sujet dans la validation d'aspect et le dof brouille les vues rapprochées. FW 3d recipe ... affiche la recette ; FW 3d gate -o REP rend la matrice de remedies et les feuilles. Route navigateur uniquement, pas de repli NumPy. Une route normale depuis la validation d'aspect 3D (2026-11-14). --pt N [--bounces 2] [--seed 1] définit les échantillons (même seed, mêmes pixels ; 512 px à 256 spp en 0.5-1.8 s) ; voir references/07-3d.md. Maillage imprimable : FW 3d mesh <formula|recipe> [--size-mm 60] [--res 200] [--engine auto|skimage|numpy] [--wall-mm 0.9] -o x.stl échantillonne le même DE dans NumPy et écrit un solide étanche binaire au format STL en mm (fichier latéral JSON : triangles, coquilles, volume, temps ; code de sortie 3 si non étanche). Menger par défaut au niveau 3 pour l'impression. --wall-mm X maille la surface offset DE = t (t = X/2 à l'échelle d'impression) afin que les parties fines s'épaississent vers X mm ; 0.9 a résolu l'avertissement de paroi mince FDM du Mandelbulb (2.7% -> 0.1% sous 0.9 mm). Multi-couleur : -o x.3mf (ou --colors N, défaut 4, max 8 ; --palette "#hex,...") écrit aussi un 3MF coloré par le piège orbital (bins de surface égale, un filament chacun ; Bambu Studio et PrusaSlicer lisent les tags de filament par triangle). Ensuite pw.py check x.stl --target print-fdm (polywright-print ; il lit aussi le 3MF).
Étape 3 : mesurer
FW measure box image.png [--invert] [--threshold S]: dimension par comptage de boîtes des pixels foncés (ou clairs) sur 15+ tailles de boîtes et décalages aléatoires ensemencés, avec la plage d'ajustement en décades, la courbe de pente locale et un verdict. Transmettez le verdict tel quel : en dessous de deux décades, c'est "descriptor only" ; une pente locale dérivante est "not fractal". Donnez D avec sa barre d'erreur depuis references/08-measuring.md, jamais comme exacte, et ne nommez jamais une forme à partir de D.FW measure lacunarity image.png: lacunarité par taille de boîte, le deuxième nombre à côté de D (un même D peut sembler différent).FW measure ifs --ratios 0.5,0.5,0.5: dimension de similarité ; exacte uniquement lorsque les pièces ne se chevauchent pas, sinon une borne supérieure.- Les profils de hauteur et les cartes de hauteur sont auto-affines :
FW measure profile numbers.txt(pente spectrale, semivariogramme, Katz) etFW measure heightmap map.png|.npy(spectre radial, D surfacique = 3 - H).measure boxrefuse un fichier de nombres. FW measure katz curve.txt(x,y ou une colonne) : un nombre de rugosité approximatif, pas D.FW measure area --size 1024: aire de Mandelbrot par comptage de pixels (prouvée à 0.0002 près de 1.50659 à 1024 px).
Étape 4 : identifier
FW identify <preset | recipe.json | image.png> [--c re,im] : caractéristiques construites à la main (symétrie miroir des pixels, Julia connectée ou poussière à partir de l'orbite de 0, cardioïde principal ou bulbe de période 2 pour c, la symétrie connue de la famille). La D d'une image par boîtes est rapportée comme un descripteur uniquement. N'identifiez jamais une fractale par sa dimension.
Maintenance
Fichiers d'unité à la racine du dépôt : evergreen.json, RESEARCH.md, CHANGELOG.md, LEARNINGS.md, TESTS.md. Le fil fractal-art alimente les actualisations ; harvest.json liste les cibles de récolte.