# EQ / Phaser 実験の再現 Rust 1.99.1、Python 3.11.2、NumPy 2.4.6、SciPy 1.17.1、Matplotlib 3.11.2で実施した。Rust試作の依存は標準ライブラリのみ。アーカイブは`eq_phaser/`と共通runnerの`common/`を同じ親へ展開する。 ## ビルドと音響 ```sh cd eq_phaser bash code/build.sh local-sources/tests local-sources/test-second local-sources/test-fir local-sources/test-eq-control eq_control local-sources/test-reuse-f64 output_reuse local-sources/test-reuse-f32 output_reuse local-sources/test-bench symmetric_fir_matches_direct_convolution python code/analyze.py eq-static python code/analyze.py eq-transient python code/analyze.py phaser-static python code/analyze_phaser_ltv.py python code/analyze_precision.py python code/analyze_control.py python code/analyze_nyquist.py python code/analyze_feedback_second.py python code/analyze_ftz.py python code/analyze_eq_stability.py python code/analyze_dry_tap.py python code/analyze_minimum_phase.py python code/analyze_eq_interpolation.py python code/analyze_mixed.py python code/analyze_stereo.py local-sources/check-feedback-energy > data/phaser-feedback-energy.jsonl python code/summarize_benchmark.py python code/summarize_benchmark_v2.py python code/summarize_benchmark_fir.py python code/summarize_benchmark_eq_control.py python code/summarize_benchmark_reuse.py python code/inspect_svf_assembly.py ``` Pythonには上記のNumPy/SciPy/Matplotlibが必要。`MPLCONFIGDIR`はスクリプトが作業ディレクトリ内へ設定する。個人の絶対パスや製品リポジトリへの参照は不要。入力・出力の一時rawファイルは各レンダリング完了時に削除する。恒久保存するデータは`data/`、図は`figures/`。 `eq-static.npz`内のFIR係数と、性能用の`data/tone-fir{257,1025,4097}.f64`は同じ配列である。後者はlittle-endian f64。性能測定の初回ソースと係数は`snapshots/eqph01/`へ固定し、`manifest.json`でhashを照合できる。 ## 性能 共通規約は`common/PROTOCOL.md`。録音時間4秒は、4秒間のwall-clockを測るという意味ではなく、192000 stereo frameの処理時間を測る。係数設計の単発コストは除外し、連続更新の係数設計は含む。 ```sh cd .. python eq_phaser/code/capture_environment.py python common/run_blocks.py eq_phaser/EQPH01-plan.json eq_phaser/data/EQPH01-reproduction.json ``` runnerの引数に`eq_phaser/EQPH01-plan.json`と別の結果ファイルを指定する。測定CPUを独占し、その兄弟CPUを空け、コンパイルや音響分析と同時実行しない。planには10ブロック・5秒cooldown・固定seed・36ジョブ・35比較を事前登録済み。過去の結果ファイルへ上書きしない。 `data/EQPH01-performance.json`に全観測値・実行順・環境・binary/runner/統計コードのhashがある。`data/bench-functional-smoke.json`はCPU18での機能確認であり、性能結果として使用しない。 独立試作コードのライセンスはAGPL-3.0-only、著作権者はYusuke Oda。許諾文は`LICENSE`に収録する。一次文献の本文は各出典から参照する。 EQPH02は33条件・23比較・seed511052、EQPH03は15条件・14比較・seed511053。同じrunnerへ対応するplanと別の結果ファイルを渡す。性能用ソースは各`snapshots/eqph02/`・`snapshots/eqph03/`へ固定しており、後から追加した試作と混同しない。 再現アーカイブには試作ソース、入力IR、固定した性能JSON、条件とhashを収録する。再生成可能な図・音声応答NPZは重複して格納せず、上の解析コマンドで作成する。公開済みの図とNPZは各実験ページから個別に取得できる。 EQPH04は19条件・18比較・seed511054、EQPH05は26条件・26比較・seed511055。後者はFTZ/DAZを有効化し、f32/f64のサンプル型を別binaryで生成する。再利用条件のchecksum/peak/RMSは最後の出力blockの診断値であり、`diagnostic_scope`と`diagnostic_frames`に範囲を記録する。全4秒の指標として扱わない。 アーカイブを独立ディレクトリへ展開し、全manifestのhash、5族の固定ソースのビルド、各コンポーネントのテストと各族の機能用1ケースを確認するには、`python code/audit_reproduction.py`を実行する。この機能確認の時間値は性能比較に使用しない。監査結果のJSONとログはアーカイブ自身のhashを記録するためアーカイブの外に保存する。アセンブリ監査にはGNU objdumpが必要。 EQPH06はEQPH05の固定ソースに`-C no-vectorize-slp`だけを加えた対照。`python code/prepare_slp.py`で2精度のbinary、全出力・最終状態の照合、12条件・6比較・seed511056のplanを生成する。照合は3rate×3入力×2形式×6秒、各精度の全サンプルと最終係数・状態のbyte一致を確認する。 EQPH06の図・統計は`python code/summarize_benchmark_slp.py`、命令列の対照は`python code/inspect_slp_assembly.py`で再生成する。 入力依存性EQ12/PH11の192条件・図2枚は`python code/analyze_control_inputs.py`で再生成する。6秒の本体に64sampleの未来端点用ガードを付け、2〜6秒を評価する。係数保持と線形補間の全指標をJSONへ保存し、雑音の短い波形窓も保存する。 聴取WAVは`python code/create_listening_examples.py`で`audio/`へ生成する。先にEQ01/EQ09で`eq-static.npz`と`eq-minimum-phase.npz`を生成しておく。全25ファイルを共通gainで処理し、各ファイル6秒・48kHz stereo/24-bit PCMとする。再現可能なWAVはソースアーカイブへ重複格納せず、EQ13/PH12から個別取得できる。 WAVのヘッダー、全hash、24-bit復号後のpeak/RMSは`python code/audit_listening_examples.py`で照合する。高域Bellの数値範囲EQ14は`python code/audit_nyquist_domain.py`で再生成する。係数評価器のassert拒否も結果として保存し、core dumpは作成しない。 実時間burn-inを3000ms以上にした独立確認のEQPH01〜06-C3Sは、初回と同じbinary・条件・比較族を使い、各planの別seedで10ブロック実施した。`python code/summarize_confirmation.py EQPH01`(族IDを02〜06にも変更)で全統計と初回/確認の比較図を再生成する。スクリプトはbinary hash、burn-in以外の引数、比較組とplanのSHA256を照合する。再測定する場合は共通runnerへ`eq_phaser/data/EQPH01-C3S-plan.json`と新しい出力ファイルを渡す。初回・確認の既存生値は上書きしない。