Upload EBENGenerator after 0 epochs
Browse files- README.md +73 -0
- config.json +5 -0
- model.safetensors +3 -0
README.md
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
language: fr
|
| 3 |
+
license: mit
|
| 4 |
+
library_name: transformers
|
| 5 |
+
tags:
|
| 6 |
+
- audio
|
| 7 |
+
- audio-to-audio
|
| 8 |
+
- speech
|
| 9 |
+
datasets:
|
| 10 |
+
- Cnam-LMSSC/vibravox
|
| 11 |
+
model-index:
|
| 12 |
+
- name: EBEN(M=?,P=?,Q=?)
|
| 13 |
+
results:
|
| 14 |
+
- task:
|
| 15 |
+
type: speech-enhancement
|
| 16 |
+
name: Bandwidth Extension
|
| 17 |
+
dataset:
|
| 18 |
+
name: Vibravox["YOUR_MIC"]
|
| 19 |
+
type: Cnam-LMSSC/vibravox
|
| 20 |
+
args: fr
|
| 21 |
+
metrics:
|
| 22 |
+
- type: stoi
|
| 23 |
+
value: ???
|
| 24 |
+
name: Test STOI, in-domain training
|
| 25 |
+
- type: n-mos
|
| 26 |
+
value: ???
|
| 27 |
+
name: Test Noresqa-MOS, in-domain training
|
| 28 |
+
---
|
| 29 |
+
|
| 30 |
+
<p align="center">
|
| 31 |
+
<img src="https://cdn-uploads.huggingface.co/production/uploads/65302a613ecbe51d6a6ddcec/zhB1fh-c0pjlj-Tr4Vpmr.png" style="object-fit:contain; width:280px; height:280px;" >
|
| 32 |
+
</p>
|
| 33 |
+
|
| 34 |
+
# Model Card
|
| 35 |
+
|
| 36 |
+
- **Developed by:** [Cnam-LMSSC](https://huggingface.co/Cnam-LMSSC)
|
| 37 |
+
- **Model:** [EBEN(M=?,P=?,Q=?)](https://github.com/jhauret/vibravox/blob/main/vibravox/torch_modules/dnn/eben_generator.py) (see [publication in IEEE TASLP](https://ieeexplore.ieee.org/document/10244161) - [arXiv link](https://arxiv.org/abs/2303.10008))
|
| 38 |
+
- **Language:** French
|
| 39 |
+
- **License:** MIT
|
| 40 |
+
- **Training dataset:** `speech_clean` subset of [Cnam-LMSSC/vibravox](https://huggingface.co/datasets/Cnam-LMSSC/vibravox)
|
| 41 |
+
- **Samplerate for usage:** 16kHz
|
| 42 |
+
|
| 43 |
+
## Overview
|
| 44 |
+
|
| 45 |
+
This bandwidth extension model, trained on [Vibravox](https://huggingface.co/datasets/Cnam-LMSSC/vibravox) body conduction sensor data, enhances body-conducted speech audio by denoising and regenerating mid and high frequencies from low-frequency content.
|
| 46 |
+
|
| 47 |
+
## Disclaimer
|
| 48 |
+
This model, trained for **a specific non-conventional speech sensor**, is intended to be used with **in-domain data**. Using it with other sensor data may lead to suboptimal performance.
|
| 49 |
+
|
| 50 |
+
## Link to BWE models trained on other body conducted sensors :
|
| 51 |
+
|
| 52 |
+
The entry point to all EBEN models for Bandwidth Extension (BWE) is available at [https://huggingface.co/Cnam-LMSSC/vibravox_EBEN_models](https://huggingface.co/Cnam-LMSSC/vibravox_EBEN_models).
|
| 53 |
+
|
| 54 |
+
## Training procedure
|
| 55 |
+
|
| 56 |
+
Detailed instructions for reproducing the experiments are available on the [jhauret/vibravox](https://github.com/jhauret/vibravox) Github repository.
|
| 57 |
+
|
| 58 |
+
## Inference script :
|
| 59 |
+
|
| 60 |
+
```python
|
| 61 |
+
import torch, torchaudio
|
| 62 |
+
from vibravox.torch_modules.dnn.eben_generator import EBENGenerator
|
| 63 |
+
from datasets import load_dataset
|
| 64 |
+
|
| 65 |
+
model = EBENGenerator.from_pretrained("Cnam-LMSSC/EBEN_YOUR_MIC")
|
| 66 |
+
test_dataset = load_dataset("Cnam-LMSSC/vibravox", "speech_clean", split="test", streaming=True)
|
| 67 |
+
|
| 68 |
+
audio_48kHz = torch.Tensor(next(iter(test_dataset))["audio.YOUR_MIC"]["array"])
|
| 69 |
+
audio_16kHz = torchaudio.functional.resample(audio_48kHz, orig_freq=48_000, new_freq=16_000)
|
| 70 |
+
|
| 71 |
+
cut_audio_16kHz = model.cut_to_valid_length(audio_16kHz[None, None, :])
|
| 72 |
+
enhanced_audio_16kHz, enhanced_audio_decomposed_4kHz = model(cut_audio_16kHz)
|
| 73 |
+
```
|
config.json
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"m": 4,
|
| 3 |
+
"n": 32,
|
| 4 |
+
"p": 2
|
| 5 |
+
}
|
model.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:dc2ee0e2519d02f2d0975fa266c93ee8184b755c23601017ff5a24f1c4a6a3a0
|
| 3 |
+
size 7797832
|