read_audio — ONED io op

• データ種: file → signal

• 呼び出し: import fullseye as fs; fs.ledger.read_audio(path) (実装を直接呼ぶなら import dsp; dsp.read_audio(path)、台帳から引くなら ops1d.get("read_audio"))

• 台帳経由の戻り値: fullseye.ledger.read_audio(...) は宣言 out 型 signal の値だけを返す(本体は補助情報も返す)。捨てられた側が要るときは fullseye.ledger.read_audio.raw(...)、または dsp.read_audio を直接呼ぶ。

• 本体の返り: (x, rate)

使い方

Read any audio format -> (x, rate). Uses soundfile if available (mp3/flac/ogg/…), else falls back to the stdlib WAV reader.

Empty input (path an empty string) raises ValueError.

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• gallery_oned_audio_funct — py -3.11 examples/gallery_oned_audio_funct.py

型が繋がる次の op(signal を入力に取れる)

create_funct_1d_array · create_funct_1d_pairs · smooth_funct_1d_gauss · smooth_funct_1d_mean · derivate_funct_1d · integrate_funct_1d · zero_crossings_funct_1d · local_min_max_funct_1d

同カテゴリ(io)

read_wav · write_wav

*Provenance: dsp.py — ONED operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.