We are organising a series of machine learning challenges to enhance hearing-aid signal processing and to better predict how people perceive speech-in-noise. For further details of the Clarity Project visit the Clarity project website, and for details of our latest challenge visit our challenge documentation site. You can contact the Clarity Team by email at [email protected].
In this repository, you will find code to support all Clarity Challenges, including baselines, toolkits, and systems from participants. We encourage you to make your system/model open source and contribute to this repository.
The 2nd Clarity Enhancement Challenge (CEC2) has launched! Take part🔥🔥🔥
Clarity is available on the Python Package Index (PyPI) to install create and/or
activate a virtual environment and then use pip
to install.
conda create --name clarity python=3.8
conda activate clarity
pip install pyclarity
# First clone the repo
git clone https://github.com/claritychallenge/clarity.git
cd clarity
# Second create & activate environment with conda, see https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html
conda create --name clarity python=3.8
conda activate clarity
# Last install with pip
pip install -e .
Alternatively pip
allows you to install packages from GitHub sources directly. The following will install the current
main
branch.
pip install -e git+https://github.com/claritychallenge/clarity.git@main
Current challenge
Previous challenges
We provide also a number of tools in this repository:
- Hearing loss simulation
- Cambridge MSBG hearing loss simulator: descriptions can be found in the CEC1 description; an usage example can be found in the CEC1 baseline evaluation script
evaluate.py
.
- Cambridge MSBG hearing loss simulator: descriptions can be found in the CEC1 description; an usage example can be found in the CEC1 baseline evaluation script
- Objective intelligibility measurement
- Modified binaural STOI (MBSTOI): a python implementation of MBSTOI. It is jointly used with the MSBG hearing loss model in the CEC1 baseline. The official matlab implementation can be found here: http://ah-andersen.net/code/
- Hearing-aid speech perception index (HASPI): a python implementation of HASPI Version 2, and the better-ear HASPI for binaural speech signals. For official matlab implementation, request here: https://www.colorado.edu/lab/hearlab/resources
- Hearing aid enhancement
- Cambridge hearing aid fitting (CAMFIT): a python implementation of CAMFIT, translated from the HörTech Open Master Hearing Aid (OpenMHA); the CAMFIT is used together with OpenMHA enhancement as the CEC1 baseline, see
enhance.py
. - NAL-R hearing aid fitting: a python implementation of NAL-R prescription fitting. It is used as the CEC2 baseline, see
enhance.py
.
- Cambridge hearing aid fitting (CAMFIT): a python implementation of CAMFIT, translated from the HörTech Open Master Hearing Aid (OpenMHA); the CAMFIT is used together with OpenMHA enhancement as the CEC1 baseline, see
In addition, differentiable approximation to some tools are provided:
- Differentiable MSBG hearing loss model. See also the BUT implementation: https://github.com/BUTSpeechFIT/torch_msbg_mbstoi
- Differentiable HASPI (coming)
- CPC1:
- CEC1: