using System;
using System.ComponentModel;
using System.IO;
using System.Linq;
using NewLife.XCoder.Tools.Mel;
using Xunit;
namespace XCoder.App.Tests;
/// <summary>梅尔频谱计算</summary>
public class MelSpectrumTests
{
[Fact]
[DisplayName("写出的 16 位 WAV 能原样读回")]
public void WriteAndRead_RoundTrip()
{
Int16[] samples = [0, 1000, -1000, Int16.MaxValue, Int16.MinValue];
var bytes = MelSpectrum.WriteWav(samples, 16000);
using var ms = new MemoryStream(bytes);
var wav = MelSpectrum.ReadWav(ms);
Assert.Equal(16000, wav.SampleRate);
Assert.Equal(1, wav.Channels);
Assert.Equal(16, wav.BitsPerSample);
Assert.Equal(samples.Length, wav.Frames);
Assert.Equal(0, wav.Samples[0][0], 6);
Assert.Equal(1000 / 32768d, wav.Samples[0][1], 6);
Assert.Equal(Int16.MaxValue / 32768d, wav.Samples[0][3], 6);
}
[Fact]
[DisplayName("非 RIFF 文件抛出无效数据异常")]
public void ReadWav_NotRiff_Throws()
{
using var ms = new MemoryStream("NOTAWAVEFILE"u8.ToArray());
Assert.Throws<InvalidDataException>(() => MelSpectrum.ReadWav(ms));
}
[Fact]
[DisplayName("文件不存在时抛文件异常")]
public void ReadWav_MissingFile_Throws()
{
Assert.Throws<FileNotFoundException>(() => MelSpectrum.ReadWav(Path.Combine(Path.GetTempPath(), "no-such-audio-" + Guid.NewGuid().ToString("N") + ".wav")));
}
[Fact]
[DisplayName("FFT 长度不是 2 的幂时报参数错误")]
public void Fft_InvalidLength_Throws()
{
Assert.Throws<ArgumentException>(() => MelSpectrum.Fft(new Double[100], new Double[100]));
Assert.Throws<ArgumentException>(() => MelSpectrum.Fft(new Double[8], new Double[4]));
}
[Fact]
[DisplayName("直流信号只在 0 号频点有能量")]
public void Fft_DcSignal_PeaksAtZero()
{
var real = Enumerable.Repeat(1d, 8).ToArray();
var imag = new Double[8];
MelSpectrum.Fft(real, imag);
Assert.Equal(8, real[0], 6);
for (var i = 1; i < 8; i++)
Assert.Equal(0, real[i], 6);
}
[Fact]
[DisplayName("440Hz 正弦波的幅度谱峰值落在对应频点")]
public void Magnitude_PeakBinMatchesFrequency()
{
const Int32 rate = 44100;
const Int32 size = 1024;
const Double freq = 440;
var frame = new Double[size];
for (var i = 0; i < size; i++)
frame[i] = Math.Sin(2 * Math.PI * freq * i / rate);
var mag = MelSpectrum.Magnitude(frame);
Assert.Equal(size / 2, mag.Length);
var peak = 0;
for (var i = 1; i < mag.Length; i++)
if (mag[i] > mag[peak]) peak = i;
var expected = freq * size / rate;
Assert.InRange(peak, expected - 2, expected + 2);
}
[Fact]
[DisplayName("梅尔刻度与频率可互相换算")]
public void MelAndHz_RoundTrip()
{
Assert.Equal(0, MelSpectrum.HzToMel(0), 6);
var mel = MelSpectrum.HzToMel(1000);
Assert.Equal(1000, MelSpectrum.MelToHz(mel), 6);
// 梅尔刻度下 1kHz 约 1000 左右,低频段分辨率更高
Assert.InRange(mel, 900, 1100);
}
[Fact]
[DisplayName("滤波器组形状正确且每个滤波器都有非零权重")]
public void MelFilterBank_Shape()
{
var bank = MelSpectrum.MelFilterBank(16000, 512, 26);
Assert.Equal(26, bank.Length);
Assert.All(bank, row => Assert.Equal(256, row.Length));
Assert.All(bank, row => Assert.Contains(row, w => w > 0));
}
[Fact]
[DisplayName("滤波器组参数非法时报错")]
public void MelFilterBank_InvalidArguments_Throws()
{
Assert.Throws<ArgumentOutOfRangeException>(() => MelSpectrum.MelFilterBank(0, 512, 40));
Assert.Throws<ArgumentOutOfRangeException>(() => MelSpectrum.MelFilterBank(16000, 512, 0));
Assert.Throws<ArgumentOutOfRangeException>(() => MelSpectrum.MelFilterBank(16000, 512, 40, 8000, 4000));
}
[Fact]
[DisplayName("频谱计算按帧移切分并输出指定频带数")]
public void Compute_FrameCountAndBins()
{
var samples = MelSpectrum.Sine(440, 16000, 1);
var mel = MelSpectrum.Compute(samples, 16000, 512, 256, 20);
// 1 + (16000 - 512) / 256 = 61
Assert.Equal(61, mel.Length);
Assert.All(mel, row => Assert.Equal(20, row.Length));
Assert.All(mel, row => Assert.All(row, v => Assert.True(Double.IsFinite(v))));
}
[Fact]
[DisplayName("帧长不是 2 的幂时报参数错误")]
public void Compute_InvalidFrameSize_Throws()
{
Assert.Throws<ArgumentException>(() => MelSpectrum.Compute(new Double[1000], 16000, 300));
}
[Fact]
[DisplayName("短于帧长的样本也能得到一帧结果")]
public void Compute_ShortSignal_ReturnsSingleFrame()
{
var mel = MelSpectrum.Compute(new Double[10], 16000, 512, 256, 8);
Assert.Single(mel);
Assert.Equal(8, mel[0].Length);
}
[Fact]
[DisplayName("音量曲线对静音给出很低的分贝值")]
public void VolumeCurve_Silence_IsQuiet()
{
var curve = MelSpectrum.VolumeCurve(new Double[16000], 16000, 20);
Assert.Equal(20, curve.Length);
Assert.All(curve, v => Assert.True(v < -100));
}
[Fact]
[DisplayName("音量曲线对满幅正弦约为 -6 分贝附近")]
public void VolumeCurve_FullSine_IsLoud()
{
var samples = MelSpectrum.Sine(1000, 16000, 1, 1.0);
var curve = MelSpectrum.VolumeCurve(samples, 16000, 20);
Assert.All(curve, v => Assert.InRange(v, -12, -2));
}
[Fact]
[DisplayName("空样本的音量曲线返回空数组")]
public void VolumeCurve_Empty_ReturnsEmpty()
{
Assert.Empty(MelSpectrum.VolumeCurve([], 16000));
Assert.Throws<ArgumentOutOfRangeException>(() => MelSpectrum.VolumeCurve(new Double[10], 16000, 0));
}
[Fact]
[DisplayName("CSV 首行为表头,行数等于帧数加一")]
public void ToCsv_Format()
{
var mel = MelSpectrum.Compute(MelSpectrum.Sine(440, 16000, 0.2), 16000, 512, 256, 10);
var csv = MelSpectrum.ToCsv(mel);
var lines = csv.Split('\n', StringSplitOptions.RemoveEmptyEntries);
Assert.Equal(mel.Length + 1, lines.Length);
Assert.StartsWith("frame,mel0", lines[0]);
Assert.StartsWith("0,", lines[1]);
Assert.Equal("", MelSpectrum.ToCsv([]));
}
[Fact]
[DisplayName("多声道数据可混成单声道")]
public void WavData_Mixdown()
{
var wav = new WavData(16000, 2, 16, [[0.5, 1.0], [0.1, 0.0]], 2);
var mixed = wav.Mixdown();
Assert.Equal(2, mixed.Length);
Assert.Equal(0.3, mixed[0], 6);
Assert.Equal(0.5, mixed[1], 6);
Assert.Equal(0.5, wav.GetChannel(5)[0], 6); // 越界回落到 0 声道
}
}
|