Skip to main content

Loss function inspired by the PESQ score

Testing badge Linting badge Docs badge

Implementation of the widely used Perceptual Evaluation of Speech Quality (PESQ) score as a torch loss function. The PESQ loss alone performs not good for noise suppression, instead combine with scale invariant SDR. For more information see 1,2.

Installation

To install the package just run:

$ pip install torch-pesq

Usage

import torch
from torch_pesq import PesqLoss

pesq = PesqLoss(0.5,
    sample_rate=44100, 
)

mos = pesq.mos(reference, degraded)
loss = pesq(reference, degraded)

print(mos, loss)
loss.backward()

Comparison to reference implementation

The following figures uses samples from the VCTK 1 speech and DEMAND 2 noise dataset with varying mixing factors. They illustrate correlation and maximum error between the reference and torch implementation:

Correlation

The difference is a result from missing time alignment implementation and a level alignment done with IIR filtering instead of a frequency weighting. They are minor and should not be significant when used as a loss function. There are two outliers which may degrade results and further investigation is needed to find the source of difference.

Validation improvements when used as loss function

Validation results for fullband noise suppression:

  • Noise estimator: Recurrent SRU with soft masking. 8 layers, width of 512 result in ~1586k parameters of the unpruned model.
  • STFT for signal coding: 512 window length, 50% overlap, hamming window
  • Mel filterbank with 32 Mel features

The baseline system uses L1 time domain loss. Combining the PESQ loss function together with scale invariant SDR gives improvement of ~0.1MOS for PESQ and slight improvements in speech distortions, as well as a more stable training progression. Horizontal lines indicate the score of noisy speech.

Validation comparison

Relevant references

  1. End-to-End Multi-Task Denoising for joint SDR and PESQ Optimization
  2. A Deep Learning Loss Function Based on the Perceptual Evaluation of the Speech Quality
  3. P.862 : Perceptual evaluation of speech quality (PESQ)
  4. Perceptual evaluation of speech quality (PESQ)-a new method for speech quality assessment of telephone networks and codecs
  5. CSTR VCTK Corpus: English Multi-speaker Corpus for CSTR Voice Cloning Toolkit
  6. The Diverse Environments Multi-channel Acoustic Noise Database (DEMAND): A database of multichannel environmental noise recordings

Metadata

Release files for torch-pesq 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for torch-pesq 0.1.2
File Size Uploaded
torch-pesq-0.1.2.tar.gz 44.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for torch-pesq 0.1.2
File Interpreter ABI Platform
torch_pesq-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 58.7 kB

Release files / torch-pesq-0.1.2.tar.gz

Download URL torch-pesq-0.1.2.tar.gz
Size 44.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4c5ecc0660eaa8bee3840efa1adcc84d7b53fdc51554c9b1affae4903218acbb
BLAKE2b-256 checksum
How to use checksums
7bc29bb24c373f5468c1c433e5703b7857af85a341cbe69e558ef858aa57ea0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.8.10

Release files / torch_pesq-0.1.2-py3-none-any.whl

Download URL torch_pesq-0.1.2-py3-none-any.whl
Size 14.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6f3fa836f6517f86652332c67b653164c16a95867beb3095dd0392b814efda45
BLAKE2b-256 checksum
How to use checksums
5099c07d07829b7f6e934c4d00d77c2bdc8e5f012cb0037a09c75aa1c78a55f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.8.10

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page