# SoundFile と wave のローカルWAV読み書き実測

依頼: req-20261022-065 / 題材ID: soundfile-wave-local-hikaku
測定日: 2026-11-17（Asia/Tokyo。実行のUTC生値は raw.json の started_at_utc = 2026-11-16T18:31:39Z / finished_at_utc）。

## 判断と範囲

このMacの砂場で両方をCPUだけで実行でき、同じ人工WAVの読み込み・書き出しの処理時間と結果の一致という比較軸が成立した。
python-soundfile 0.14.0（libsndfile 1.2.2）と CPython 標準ライブラリの wave を実際に呼び出した。外部の速度表の転載は使っていない。
鍵、ログイン、有料API、買い物は不要。soundfile は未導入だったため、`pip install --target` で一時ディレクトリに取得して測り、測定後に削除した（PyPIへの通信を使った）。このとき依存の numpy も一時ディレクトリに入り、実測に使われた numpy は 2.5.5 だった（Mac本体側は 2.4.4）。
公開・X投稿・git commitは行っていない。GPU・Metal・音声の入出力・say・Bluetoothは使っていない。

測定環境は macOS 27.2.1 / arm64 / CPython 3.14.10 / Apple M4 Pro / 論理CPU数 12。

## 入力と方法

入力は再実行コードが作る人工WAV（16bit PCM・ステレオ・44100Hz・60秒・2646000フレーム・10584044バイト）。
三角波（440Hz・660Hz）に整数演算のLCGの雑音を足したもので、発話ではない。0フレームでないこと（2646000フレーム・60.000秒）は計時前に確認した。
乱数モジュール・外部ファイル・日付は使わない。PCMのSHA256は raw.json の input.pcm_sha256。
WAVファイルはすべて tempfile.TemporaryDirectory（このMacのローカルディスク）に置き、終了時に削除した。

比較した操作は2つ（1バッチ = 5回の呼び出し）。

| 操作 | wave | soundfile |
|---|---|---|
| read-all | wave.open → readframes（bytes を返す） | sf.read(dtype='int16', always_2d=True)（int16 ndarray を返す） |
| write-all | wave.open('wb') → writeframes(bytes) | sf.write(int16 ndarray, subtype='PCM_16', format='WAV') |

1バッチのウォームアップ後に7バッチを計時した（各操作・各ツール、計28バッチ・ウォームアップ4バッチ）。
試行ごとに wave・soundfile の実行順を交互に切り替えた。perf_counter_ns で整数ナノ秒を取得し、計時中のみ循環GCを止めた。
サンプル生成・import・検証・ハッシュは計時に含まない。呼び出しごとにファイルを開き、読むか書いて閉じるまでを計り、結果は捨てた。
読み込みの戻り値は wave が bytes、soundfile が ndarray で型が違う。書き出しの入力も wave は bytes、soundfile は計時前に作った ndarray を渡した。この変換コストは計時に入っていない。

## 結果の一致確認（計時の外）

- read-all: wave の bytes も soundfile の配列（形状 2646000×2・int16）も、元のPCMとバイト単位で一致した。
- write-all: wave が書いたファイルと soundfile が書いたファイルは、どちらも wave・soundfile の両方で読み戻して元のPCMと一致した。さらに2つのファイルは全体（10584044バイト）がバイト単位で同一で、SHA256も入力ファイルと同じだった（この入力・この設定の場合）。

## 結果

生値は trials[].elapsed_ns と loops（1バッチ5回）。台帳の全28 assertion はこの整数生値を直接指し、identity / rounding=0 / tolerance=0 を使う。
summaries[] の中央値・最小・最大は参考の派生値で、台帳の根拠には使っていない。
read-all のバッチ中央値は wave 約2.32ms、soundfile 約2.73ms で、この環境では wave が短かった（7試行中6試行で wave が短く、1回目だけ soundfile が短かった。生値で確認できる）。
write-all は揺れが非常に大きい。wave は最小約12.4ms〜最大約194.5ms、soundfile は最小約52.1ms〜最大約124.6ms（原因は調べていない。ファイルシステムの書き込み状況によると推測されるが未検証）。中央値は wave 約57.7ms、soundfile 約78.7ms だが、範囲が大きく重なっており、この回数では書き出しの優劣を言えない。
倍率・順位は、このCPU・このディスク・この人工WAV・この版に限る。

## 範囲と限界

- 測ったのは、このMacのCPUで、人工WAV1つ（16bit PCM・ステレオ・44100Hz・60秒）の全フレーム一括読み込み・一括書き出しの処理時間と、サンプル・ファイルの一致だけ。
- 発話音声ではない。音質・文字起こし精度・外部推論は測っていない。
- 他のサンプル形式（24bit・float・モノラル）、他の長さ、ブロック単位の逐次読み書き、FLAC・OGGなどwave非対応の形式、メモリ使用量、import時間、並列・非同期の呼び出しは測っていない。
- ファイルはOSのページキャッシュが温まった状態で読んでおり、冷えた読み込みは測っていない。書き出しはディスクへの実際の書き込み完了（fsync）まで待っていない。
- numpy への変換や bytes → ndarray の変換コストは計時に入れていない。戻り値の型が違うため、公平な同一出力比較ではなく、それぞれの標準的な呼び出し方の比較である。
- APIの使いやすさ・機能の広さ・インストールの手間は測っていない。
- パッケージのバージョンは dependencies.json に保存した。ホイールのハッシュは固定していない。
- 同じ秒数でも別の環境で再現するとは限らない。再実行: soundfile-wave-local-2026-11-17-req065-a1-replay.txt（macOS arm64・CPython 3.14・numpy が入っていること。soundfile が無ければPyPIへ通信して一時取得する）。
- 公式ページの記述は転記していない。公式: https://github.com/bastibe/python-soundfile / https://docs.python.org/3/library/wave.html
