Python音频低通滤波器报错求助：IndexError元组索引超出范围

错误原因 #

出现IndexError: tuple index out of range的核心原因：

• 直接将stream.read()返回的原始字节串传入scipy.signal.filtfilt()，字节串并非numpy数组，无法被正确识别为可处理的多维数据，导致axis参数访问维度时出错。
• 同时存在两个关键错误：Butterworth滤波器系数顺序写反，以及滤波结果未转换回音频设备所需的格式。

修复步骤 #

1. 将字节数据转换为数值数组 #

stream.read()返回的是符合paInt16格式的字节串，需先解析为numpy整数数组才能进行滤波计算：

# 把读取到的字节数据解析为int16类型的numpy数组
data_np = np.frombuffer(data, dtype=np.int16)

2. 修正滤波器系数顺序 #

scipy.signal.butter()的返回值是(b, a)（分子系数b在前，分母系数a在后），代码里的顺序完全写反，修正为：

# 正确获取低通滤波器系数
b, a = scipy.signal.butter(2, 0.1, 'lowpass', analog=False)

3. 执行滤波并处理结果 #

对数值数组滤波后，需将浮点数结果转换回paInt16格式的字节串，同时裁剪超出范围的数值避免溢出：

# 执行双向滤波
fdata_np = scipy.signal.filtfilt(b, a, data_np)
# 裁剪数值到int16的合法范围，再转换为int16类型
fdata_np = np.clip(fdata_np, np.iinfo(np.int16).min, np.iinfo(np.int16).max)
# 转换回字节串供音频输出设备使用
fdata = fdata_np.astype(np.int16).tobytes()

完整修正后的滤波代码块 #

替换原代码中的滤波部分：

##################### Lowpass Filter ###########################################
# 1. 字节转数值数组
data_np = np.frombuffer(data, dtype=np.int16)
# 2. 获取正确的滤波器系数
b, a = scipy.signal.butter(2, 0.1, 'lowpass', analog=False)
# 3. 滤波并转换回字节格式
fdata_np = scipy.signal.filtfilt(b, a, data_np)
fdata_np = np.clip(fdata_np, np.iinfo(np.int16).min, np.iinfo(np.int16).max)
fdata = fdata_np.astype(np.int16).tobytes()
player.write(fdata)

额外注意事项 #

• 确保started、button、led变量已在代码其他位置正确初始化（比如started = False，button = Button(引脚编号)，led = LED(引脚编号)）。
• 当前截止频率为归一化值0.1，对应实际频率为0.1 * RATE/2 = 2205Hz，如需调整截止频率，直接修改该数值即可。

内容的提问来源于stack exchange，提问作者user3064089