bayartsogt
commited on
Commit
•
23378e6
1
Parent(s):
5d9cfd7
Create readme
Browse files
README.md
ADDED
@@ -0,0 +1,126 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
---
|
2 |
+
language: mn
|
3 |
+
datasets:
|
4 |
+
- common_voice
|
5 |
+
metrics:
|
6 |
+
- wer
|
7 |
+
tags:
|
8 |
+
- audio
|
9 |
+
- automatic-speech-recognition
|
10 |
+
- speech
|
11 |
+
- xlsr-fine-tuning-week
|
12 |
+
license: apache-2.0
|
13 |
+
model-index:
|
14 |
+
- name: bayartsogt/wav2vec2-large-xlsr-mongolian
|
15 |
+
results:
|
16 |
+
- task:
|
17 |
+
name: Speech Recognition
|
18 |
+
type: automatic-speech-recognition
|
19 |
+
dataset:
|
20 |
+
name: Common Voice mn
|
21 |
+
type: common_voice
|
22 |
+
args: mn
|
23 |
+
metrics:
|
24 |
+
- name: Test WER
|
25 |
+
type: wer
|
26 |
+
value: 0.45
|
27 |
+
---
|
28 |
+
|
29 |
+
# Wav2Vec2-Large-XLSR-53-Mongolian
|
30 |
+
|
31 |
+
Fine-tuned [facebook/wav2vec2-large-xlsr-53](https://huggingface.co/facebook/wav2vec2-large-xlsr-53) on Mongolian using the [Common Voice](https://huggingface.co/datasets/common_voice)
|
32 |
+
When using this model, make sure that your speech input is sampled at 16kHz.
|
33 |
+
|
34 |
+
## Usage
|
35 |
+
|
36 |
+
The model can be used directly (without a language model) as follows:
|
37 |
+
|
38 |
+
```python
|
39 |
+
import torch
|
40 |
+
import torchaudio
|
41 |
+
from datasets import load_dataset
|
42 |
+
from transformers import Wav2Vec2ForCTC, Wav2Vec2Processor
|
43 |
+
|
44 |
+
test_dataset = load_dataset("common_voice", "mn", split="test[:2%]")
|
45 |
+
|
46 |
+
processor = Wav2Vec2Processor.from_pretrained("bayartsogt/wav2vec2-large-xlsr-mongolian")
|
47 |
+
model = Wav2Vec2ForCTC.from_pretrained("bayartsogt/wav2vec2-large-xlsr-mongolian")
|
48 |
+
|
49 |
+
resampler = torchaudio.transforms.Resample(48_000, 16_000)
|
50 |
+
|
51 |
+
# Preprocessing the datasets.
|
52 |
+
# We need to read the aduio files as arrays
|
53 |
+
def speech_file_to_array_fn(batch):
|
54 |
+
speech_array, sampling_rate = torchaudio.load(batch["path"])
|
55 |
+
batch["speech"] = resampler(speech_array).squeeze().numpy()
|
56 |
+
return batch
|
57 |
+
|
58 |
+
test_dataset = test_dataset.map(speech_file_to_array_fn)
|
59 |
+
inputs = processor(test_dataset["speech"][:2], sampling_rate=16_000, return_tensors="pt", padding=True)
|
60 |
+
|
61 |
+
with torch.no_grad():
|
62 |
+
logits = model(inputs.input_values, attention_mask=inputs.attention_mask).logits
|
63 |
+
|
64 |
+
predicted_ids = torch.argmax(logits, dim=-1)
|
65 |
+
|
66 |
+
print("Prediction:", processor.batch_decode(predicted_ids))
|
67 |
+
print("Reference:", test_dataset["sentence"][:2])
|
68 |
+
```
|
69 |
+
|
70 |
+
|
71 |
+
## Evaluation
|
72 |
+
|
73 |
+
The model can be evaluated as follows on the Mongolian test data of Common Voice.
|
74 |
+
|
75 |
+
```python
|
76 |
+
import torch
|
77 |
+
import torchaudio
|
78 |
+
from datasets import load_dataset, load_metric
|
79 |
+
from transformers import Wav2Vec2ForCTC, Wav2Vec2Processor
|
80 |
+
import re
|
81 |
+
|
82 |
+
test_dataset = load_dataset("common_voice", "mn", split="test")
|
83 |
+
wer = load_metric("wer")
|
84 |
+
|
85 |
+
processor = Wav2Vec2Processor.from_pretrained("bayartsogt/wav2vec2-large-xlsr-mongolian")
|
86 |
+
model = Wav2Vec2ForCTC.from_pretrained("bayartsogt/wav2vec2-large-xlsr-mongolian")
|
87 |
+
model.to("cuda")
|
88 |
+
|
89 |
+
chars_to_ignore_regex = '[\,\?\.\!\-\;\:\"\“]' # TODO: adapt this list to include all special characters you removed from the data
|
90 |
+
resampler = torchaudio.transforms.Resample(48_000, 16_000)
|
91 |
+
|
92 |
+
# Preprocessing the datasets.
|
93 |
+
# We need to read the aduio files as arrays
|
94 |
+
def speech_file_to_array_fn(batch):
|
95 |
+
batch["sentence"] = re.sub(chars_to_ignore_regex, '', batch["sentence"]).lower()
|
96 |
+
speech_array, sampling_rate = torchaudio.load(batch["path"])
|
97 |
+
batch["speech"] = resampler(speech_array).squeeze().numpy()
|
98 |
+
return batch
|
99 |
+
|
100 |
+
test_dataset = test_dataset.map(speech_file_to_array_fn)
|
101 |
+
|
102 |
+
# Preprocessing the datasets.
|
103 |
+
# We need to read the aduio files as arrays
|
104 |
+
def evaluate(batch):
|
105 |
+
inputs = processor(batch["speech"], sampling_rate=16_000, return_tensors="pt", padding=True)
|
106 |
+
|
107 |
+
with torch.no_grad():
|
108 |
+
logits = model(inputs.input_values.to("cuda"), attention_mask=inputs.attention_mask.to("cuda")).logits
|
109 |
+
|
110 |
+
pred_ids = torch.argmax(logits, dim=-1)
|
111 |
+
batch["pred_strings"] = processor.batch_decode(pred_ids)
|
112 |
+
return batch
|
113 |
+
|
114 |
+
result = test_dataset.map(evaluate, batched=True, batch_size=8)
|
115 |
+
|
116 |
+
print("WER: {:2f}".format(100 * wer.compute(predictions=result["pred_strings"], references=result["sentence"])))
|
117 |
+
```
|
118 |
+
|
119 |
+
**Test Result**: 45.82%
|
120 |
+
|
121 |
+
|
122 |
+
## Training
|
123 |
+
|
124 |
+
❌ The Common Voice `train`, `validation`, and ... datasets were used for training as well as ... and ... # TODO: adapt to state all the datasets that were used for training.
|
125 |
+
|
126 |
+
❌ The script used for training can be found [here](...) # TODO: fill in a link to your training script here. If you trained your model in a colab, simply fill in the link here. If you trained the model locally, it would be great if you could upload the training script on github and paste the link here.
|