@audio/denoise 0.3.3 → 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +6 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -110,7 +110,8 @@ dewind(data, { cutoffMin: 60, cutoffMax: 250 })
110
110
  | `Q` | `0.707` | Butterworth-ish |
111
111
  | `blockSize` | `1024` | Coefficient update interval (samples) |
112
112
 
113
- **Use when:** wind buffeting, handheld-mic rumble, low-frequency room modes.
113
+ **Use when:** intermittent wind buffeting, handling thumps, low-frequency room modes — the adaptive cutoff opens on gusts and closes between them (measured: beats `wiener` on gusty wind at ~1/10 the CPU).<br>
114
+ **Not for:** continuous rumble under speech — a time-domain cutoff can't separate overlapping spectra; use `wiener`/`omlsa` there (measured ~9 dB vs ~1 dB SNR gain). An LPC-null post-filter was evaluated and rejected: voiced speech is as AR-predictable as wind, so nulling wind poles whitens vowels too (LSD improves, SNR and speech level degrade).
114
115
 
115
116
 
116
117
  ### `deplosive`
@@ -269,8 +270,7 @@ declip(data) // auto-detects c
269
270
 
270
271
  ### `dereverb`
271
272
 
272
- Late-reverb spectral subtraction (Lebart, Boucher & Denbigh 2001). Models the late tail as exponentially decaying noise:
273
- `|R̂(k)|² ≈ exp(-2·δ·t·hop) · |Y_prev(k)|²` and subtracts à la Berouti.
273
+ Late-reverb suppression (Lebart, Boucher & Denbigh 2001 estimate, Habets-class gain). Models the late tail as a decaying sum of past frames' power, then applies a decision-directed Wiener gain on the signal-to-reverb ratio — the cross-frame smoothing suppresses the musical noise hard subtraction produces.
274
274
 
275
275
  ```js
276
276
  dereverb(data, { t60: 0.6, predelay: 0.04 })
@@ -280,8 +280,9 @@ dereverb(data, { t60: 0.6, predelay: 0.04 })
280
280
  |---|---|---|
281
281
  | `t60` | `0.5` | Assumed reverberation time (s) |
282
282
  | `predelay` | `0.04` | Direct-sound passthrough (s) |
283
- | `alpha` | `1.5` | Over-subtraction factor |
284
- | `beta` | `0.05` | Spectral floor |
283
+ | `alpha` | `1.5` | Reverb-PSD over-estimation factor |
284
+ | `alphaDD` | `0.98` | Decision-directed SIR smoothing |
285
+ | `gMin` | `0.05` | Gain floor for reverb-dominated bins |
285
286
 
286
287
  **Use when:** moderate room reverb (RT60 ≤ 1 s) on a single channel.<br>
287
288
  **Not for:** heavy reverb or convolutive distortion — use multi-channel WPE (out of scope).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@audio/denoise",
3
- "version": "0.3.3",
3
+ "version": "0.3.4",
4
4
  "type": "module",
5
5
  "description": "Noise reduction — gate, spectral subtraction, Wiener, OM-LSA, dehum, declick, decrackle, declip, deesser, dereverb",
6
6
  "sideEffects": false,