fractalwright は何をしますか?
成果物: すべての画像はPNGと、それをピクセル単位で再描画するレシピJSONがペアになります。数値(次元、面積、対称性)は測定され、推測ではありません。
FW はリポジトリルートからの python scripts/fw.py を意味します(実行するものであり、読むものではありません)。
ステップ 0: ツール
タスクはすぐに実行してください。ツールが見つからずコマンドが失敗した場合にのみ FW doctor を実行してください(NumPy がコアです; moderngl、Playwright、ffmpeg はオプションで、プローブされるだけです)。フレッシュネス(evergreen.json)は 'refresh fractalwright' で読み取られ、毎回ではありません。与えられたプリセットをそのままレンダリングし、ルックの調整(反復回数、密度、スーパーサンプル)は要求された場合のみ行ってください。
ステップ 1: ファミリーの選択
FW explain <family> で、数式、作成方法、プリセットを確認できます。ファミリー: mandelbrot, julia, burning-ship, tricorn, multibrot, kronecker(正確なグリッドフラクタル: FW render kronecker-carpet、または --mask 111,101,111 --power 6)。カオス理論の初心者向け: FW explain logistic で学習順序を表示、--plot cobweb|bifurcation -o out.png で描画します; FW explain coastline でリチャードソンの定規によるDを説明します。詳細やスムースカラーリング以外の色付け方法については、ユーザーが尋ねた場合のみ references/02-escape-time.md を参照してください。
ステップ 2: レンダリング
FW render <preset or recipe.json> -o out.png [--size WxH] [--iter N] [--palette NAME] [--supersample 2]。out.png と out.json の両方を出力します。報告する前に両方のファイルが存在することを確認してください。ビューを変更するには、レシピの view.centre と view.width を編集し(10進文字列、すべての桁を保持)、レシピを再度レンダリングします。FW palette でパレット一覧、FW palette NAME -o swatch.png で特定のパレットを表示します。幅が約1e-13を超えるとfloat64は失敗します; ノイズをレンダリングする代わりにその旨を伝えてください(references/03-deep-zoom.md)。
ステップ 2a: 探査
FW serve [--port 8765] [--out-dir DIR] [--open] は、127.0.0.1 のみでWebGL2エクスプローラーを実行します(他のホストは拒否されます)。ドラッグでパン、ホイールまたはピンチでズーム、Shift+クリックでジュリアのcを選択; 数式、反復回数、回転([ と ] で15度ずつ回転)、パレットはサイドパネルに表示; ストップパレット(最大8ストップ)付きのレシピは ps=pos:rrggbb,... としてハッシュに格納されます。URLハッシュがビュー全体を表すため、アドレスが共有リンクになります。float32の限界に近づくと精度ボックスが警告を表示; それを超えると、マンデルブロとジュリア(指数2、幅 >= 1e-60)はGPU深層に切り替わります: ページがビューを /orbit にポストし、サーバーがDecimal参照軌道を計算、ページが倍精度摂動シェーダーで描画します(センタリング文字列はズーム中すべての桁を保持; 新しい軌道が処理中の間、ページは最後の軌道からの粗いプレビューを表示し、古いリクエストをキャンセルします); Render exact はサーバーにNumPy(または摂動)PNGを要求し、Export はレシピJSONを出力ディレクトリに書き出します。FW export "<share url or #hash>" -o recipe.json はコマンドラインから同じことを行います。--route browser はヘッドレスEdgeとページシェーダーでレンダリング; --deep --route browser(または幅1e-12未満)は、幅1e-60までGPU上で倍精度摂動を実行します(カウント差0.1-1%)。そのため、正確なカウントが必要な場合はCPUルートを使用してください。詳細(フォールバック、--gpu-precision float32、バーニングシップ)は references/13-route-details.md を参照してください。
ステップ 2b: シートとビデオ
FW audio <song.wav> [--preset julia-pulse|mandel-dive] [--recipe R] [--size 640x360] [--fps 30] [--duration S] [--intensity 0.6] [--route auto|browser|numpy] でミュージックビデオを作成: 曲のエンベロープがフラクタルを駆動し(ベース、ビート、ミッド、クロマ、トレブル、ラウドネス; 無音時は何も動かない)、フレームはフラッシュリミッターを通過し、flashcheckが結果をゲートします(失敗時に終了コード4)、そして曲が多重化されます。MP3は --allow-mp3 がない限り拒否されます。FW serve はライブページ /audio も提供します。マッピングの詳細: references/13-route-details.md。
FW sheet <recipe> --palettes A,B,C または --vary params.max_iter --values 100,300,1000(複素数値は re:im)は、ラベル付きコンタクトシートPNGと各タイルのレシピを含むJSONを書き出します。ビデオ: FW zoom <recipe> --to-width W [--from-width W0] [--to-centre re,im](指数幅、イーズセンター)、FW morph <recipe> --path "re,im;re,im"(デフォルトでジュリアc、--vary で他のパラメータ)、FW loop <recipe> --circle re,im,r [--phase](閉じたパス、最終フレームが最初にラップ)。すべて --size WxH --fps N --duration S を受け付け、正確なフレームを <out>_frames/ に、H.264 mp4(yuv420p、CRF 18)と animation を含む <out>.json(キーフレーム、fps、duration_s)を書き出します。AIスタイリングはデフォルトでオフ; --ai はComfyUI Z-Image img2imgコピー(<out>_ai.*、interpreted とマーク)を追加し、常に正確なビデオを保持します(references/13-route-details.md)。すべてのビデオはフラッシュチェックを受けます; FW flashcheck <video or frame dir> は単独で実行し、10%の輝度(または飽和赤)のフラッシュが1秒間に3回以上、10度視野の25%以上で発生した場合に終了コード4で終了します; 判定行は失敗したルールとその面積を指定します(フレーム全体のswings/sは参考用のため、「1 swings/s」は合格または不合格を意味しません)。失敗を報告し、絶対に出荷しないでください(references/09)。
ステップ 2c: IFS、アトラクター、地形、補間
FW ifs sierpinski|fern|unequal-tiles -o out.png(カオスゲーム、p は |det| による、最初の20点は破棄、アトラクターを確実に保持するボールで枠付け)。FW attractor-search --hits 5 -o best.png(D2 1.1-1.5かつ小さいLでランク付けされたSprott二次写像、ブックルール; リアプノフ指数はビット単位)。FW terrain -o t.png [--method midpoint] [--H 0.8](デフォルトはスペクトル法; 中点法は折り目を測定)はPNGと.npyを書き出します。FW fif --points "0,0;1,1;2,0" --d 0.5,-0.5 -o f.png [--numbers y.txt] は点を通るフラクタル補間曲線を描画します。
ステップ 2d: フレーム、L-system、アトラクター
FW flame [sierpinski|swirl-sierpinski|recipe.json] -o f.png [--seed N --tries 24](xform上のカオスゲーム、12のDraves-Reckaseバリエーション、最終xform、カラーブレンディング、log-density with gamma and vibrancy、スーパーサンプル2、密度推定; プリセットなし = カバレッジでスコアリングされたシードランダムフレーム、最高が保持)。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] はPNG、SVG、レシピを書き出します。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](iconsは Symmetry in Chaos 表A.1 より; multiscrollパラメータはYalcinのa、Mx、Nx)(密度シェーディング; searchはランダムなCliffordまたはde JongセットをSprottのルールでランク付け)。すべてのコマンドは再描画可能なレシピJSONを書き出します。
ステップ 2f: 隣接分野(すべてフラクタルではありません)
FW rd coral|mitosis|default [--f F --k K --steps N --seed N](Gray-Scott)。FW ca 90|30|B3/S23 [--steps N](基本ルールまたはライフライク)。FW tiling square|triangle|hex|penrose [--n N]。FW kleinian apollonian|grandma [--ta T --tb T](アポロニウスのガスケット、または Grandma のレシピからの2生成元極限集合、本の深さ優先単語検索で描画; --method random は逆反復法)。それぞれPNGとレシピを書き出します。反応拡散系とタイリングはフラクタルではないことを明確に述べてください; FW measure box をタイリングに使用すると「not fractal」と表示されます(references/12-neighbours.md)。
ステップ 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(ヘッドレスEdgeでの球追跡距離推定; カメラを明示したレシピを書き出します)。バージョン0.8.0以降のデフォルトラック: 256サンプルでのパストレーシング(空 + 太陽、約0.5〜2秒)、合成カメラ(40mm、低アングル、被写体は左3分の1); --pt 0 は高速なシャドウ + アンビエントオクルージョンルックを提供し、箱状のメンゲル形状に適しています; レシピファイルは独自の設定を保持します。--remedy はシャドウ/aoルックに追加し、--remedy none は最初にクリアします。フォグと被写界深度は、要求がない限りオフのままにしてください: フォグはルックゲートで被写体を洗い流し、被写界深度は近接ビューをぼかします。FW 3d recipe ... はレシピを表示; FW 3d gate -o DIR はレメディマトリックスとシートをレンダリングします。ブラウザルートのみ、NumPyフォールバックはありません。3Dルックゲート(2026-11-14)以降の通常ルート。--pt N [--bounces 2] [--seed 1] はサンプル数を設定します(同じシード、同じピクセル; 512px、256sppで0.5〜1.8秒); 詳細は references/07-3d.md を参照。印刷可能なメッシュ: FW 3d mesh <formula|recipe> [--size-mm 60] [--res 200] [--engine auto|skimage|numpy] [--wall-mm 0.9] -o x.stl はNumPyで同じ距離推定をサンプリングし、mm単位の水密ソリッド(バイナリSTL)を1つ書き出します(サイドカーJSON: 三角形、シェル、体積、時間; 水密でない場合は終了コード3)。メンゲルは印刷用にデフォルトレベル3。--wall-mm X はオフセット表面 DE = t(t = X/2、印刷スケール)のメッシュを作成し、薄い部分をX mmに向けて厚くします; 0.9はマンデルバルブFDM薄壁警告を解消しました(2.7% -> 0.1%、0.9 mm未満)。マルチカラー: -o x.3mf(または --colors N、デフォルト4、最大8; --palette "#hex,...")は、軌道トラップで色付けされた3MFも書き出します(等表面ビン、各フィラメント1つ; Bambu StudioとPrusaSlicerは三角形ごとのフィラメントタグを読み取ります)。次に pw.py check x.stl --target print-fdm(polywright-print; 3MFも読み取ります)。
ステップ 3: 測定
FW measure box image.png [--invert] [--threshold T]: 15以上のボックスサイズとシード付きランダムオフセットにおける暗い(または明るい)ピクセルのボックスカウント次元。適合範囲は桁数、局所勾配曲線、および判定結果付き。判定結果はそのまま伝えてください: 2桁未満の場合は「descriptor only」; 局所勾配が変動する場合は「not fractal」。Dは references/08-measuring.md に従って誤差範囲付きで提示し、決して正確な値として提示せず、Dから形状を命名しないでください。FW measure lacunarity image.png: ボックスサイズごとのギャップ度。Dの横に表示される2番目の数値(同じDでも見た目が異なる場合があります)。FW measure ifs --ratios 0.5,0.5,0.5: 相似次元。ピースが重ならない場合のみ正確な値、それ以外は上限。- 高さプロファイルとハイトマップは自己アフィン:
FW measure profile numbers.txt(スペクトル傾き、セミバリオグラム、Katz)およびFW measure heightmap map.png|.npy(動径スペクトル、表面D = 3 - H)。measure boxは数値ファイルを拒否します。 FW measure katz curve.txt(x,y または1列): 粗さの数値、Dではありません。FW measure area --size 1024: ピクセルカウントによるマンデルブロ面積(1024pxで1.50659の0.0002以内であることが証明されています)。
ステップ 4: 識別
FW identify <preset | recipe.json | image.png> [--c re,im]: 手作りの特徴(ピクセルの鏡面対称性、0の軌道からのジュリア連結またはダスト、cに対する主カージオイドまたは周期2バルブ、ファミリーの既知の対称性)に基づきます。画像のボックスDは記述子としてのみ報告されます。フラクタルをその次元で識別しないでください。
メンテナンス
リポジトリルートのユニットファイル: evergreen.json、RESEARCH.md、CHANGELOG.md、LEARNINGS.md、TESTS.md。fractal-art フィードがリフレッシュを促します; harvest.json は収穫ターゲットをリストします。