This is the official implementation of our binaural neural audio codec architecture configured for single-speaker speech signals and two-speaker overlapped speech signals. Our BANC architecture is developed based on AUDIODEC repository. Therefore our work is licensed under Creative Commons Attribution-NonCommercial 4.0 International License. When you use this repository, please consider citing our work BANC and AUDIODEC.
The audio demos of BANC are available here.
Python 3.8+
Cuda 11.0+
PyTorch 1.10+
numpy
pygsound
wavefile
tqdm
scipy
soundfile
librosa
cupy-cuda11x
torch_stoi
tensorboardX
pyyaml
sudo apt-get install p7zip-full
To train and test single-speaker binaural speech go inside "Single_Multi_AudioDec/" folder.
To generate 50,000 BIRs run the following code. To generate different numbers of BIRs, change the variable num_irs (Line 47) in sim_binaural_ir.py. You can see generated Binaural RIRs under binaural/ folder.
python3 sim_binaural_ir.py
Download VCTK or any clean speech dataset and divide into train,test and valid e.g., corpus/train, corpus/test, corpus/valid. To make clean speech of 2 seconds durations run the following command
python3 process_speech.py
Then make folder output_speech and run the following command to augment the binaural speech dataset
mkdir output_speech
python3 augment_binaural_speech.py --speech corpus/train/ --ir binaural/ --out output_speech/train --nthreads 16
python3 augment_binaural_speech.py --speech corpus/valid/ --ir binaural/ --out output_speech/valid --nthreads 16
python3 augment_binaural_speech.py --speech corpus/test/ --ir binaural/ --out output_speech/test --nthreads 16
To download our trained with encoder checkpoint at 200,000 and decoder checkpoint at 500,000 (We tested on this model). Run the following command
source download_model.sh
change the respective check point numbers to the variable encoder_checkpoint, decoder_checkpoint in submit_codec_vctk.sh.
To download our trained with encoder checkpoint at 500,000 and decoder checkpoint at 380,000. Run the following command
source download_model_500.sh
change the respective check point numbers to the variable encoder_checkpoint, decoder_checkpoint in submit_codec_vctk.sh.
To download our test data, run the following command
source download_test_data.sh
We train our end-to-end network with only metric loss for 200,000 epochs. To train our network, run the following command
bash submit_autoencoder.sh --start 0 --stop 0 --tag_name "autoencoder/symAD_vctk_48000_hop300"
We have configured it to run on 4 GPUs. To run on different numbers of GPUs change the gpus: parameter (Line-14) in config/autoencoder/symAD_vctk_48000_hop300.yaml To run on different batch size, change batch_size: parameter (Line-193) in config/autoencoder/symAD_vctk_48000_hop300.yaml
To resume training on a saved model at a particular step (e.g., 200,000 steps) run the following command
bash submit_autoencoder.sh --start 1 --stop 1 --resumepoint 200000 --tag_name "autoencoder/symAD_vctk_48000_hop300"
After training for 200,000 steps, we freeze the encode, projector, and quantizer and we only train the decoder with adversarial loss. To replace the simple decoder with the HiFi-GAN vocoder, run the following command
bash submit_codec_vctk.sh --start 1 --stop 2
If you want to resume training on the saved HiFi-GAN vocoder at a particular step (e.g., 460,000) run the following command
bash submit_codec_vctk.sh --start 3 --resumepoint 460000
To test the trained model run the following command
bash submit_autoencoder.sh --start 2
To train and test two-speaker binaural speech go inside "Two_Multi_AudioDec/" folder.
To generate 50,000 BIRs run the following code. To generate different numbers of BIRs, change the variable num_irs (Line 47) in sim_binaural_ir.py. You can see generated Binaural RIRs under binaural/ folder.
python3 sim_binaural_ir.py
Download VCTK or any clean speech dataset and divide it into the train, test and valid e.g., corpus/train, corpus/test, corpus/valid. To make a clean speech of 2 seconds duration run the following command
python3 process_speech.py
Then make folder output_speech and run the following command to augment the binaural speech dataset
mkdir output_speech
python3 augment_overlap_binaural_speech.py --speech corpus/train/ --ir binaural/ --out output_speech/train --nthreads 16
python3 augment_overlap_binaural_speech.py --speech corpus/valid/ --ir binaural/ --out output_speech/valid --nthreads 16
python3 augment_overlap_binaural_speech.py --speech corpus/test/ --ir binaural/ --out output_speech/test --nthreads 16
To download our trained with encoder checkpoint at 200,000 and decoder checkpoint at 358,651. Run the following command
source download_model.sh
change the respective check point numbers to the variable encoder_checkpoint, decoder_checkpoint in submit_codec_vctk.sh.
To download our test data, run the following command
source download_test_data.sh
We train our end-to-end network with only metric loss for 200,000 epochs. To train our network, run the following command
bash submit_autoencoder.sh --start 0 --stop 0 --tag_name "autoencoder/symAD_vctk_48000_hop300"
We have configured it to run on 4 GPUs. To run on different numbers of GPUs change the gpus: parameter (Line-14) in config/autoencoder/symAD_vctk_48000_hop300.yaml To run on different batch size, change batch_size: parameter (Line-193) in config/autoencoder/symAD_vctk_48000_hop300.yaml
To resume training on the saved model at a particular step (e.g., 200,000 steps) run the following command
bash submit_autoencoder.sh --start 1 --stop 1 --resumepoint 200000 --tag_name "autoencoder/symAD_vctk_48000_hop300"
To test the trained model run the following command
bash submit_autoencoder.sh --start 2
If you use our BANC for your research, please consider citing
@article{ratnarajah2023m3,
title={M3-AUDIODEC: Multi-channel multi-speaker multi-spatial audio codec},
author={Ratnarajah, Anton and Zhang, Shi-Xiong and Yu, Dong},
journal={arXiv preprint arXiv:2309.07416},
year={2023}
}