AlexN commited on
Commit
ee05d5c
1 Parent(s): 5a8703c

reset files

Browse files
.ipynb_checkpoints/run-checkpoint.sh ADDED
@@ -0,0 +1,40 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ WANDB_PROJECT=auto-speech-recognition-french
2
+ python run_speech_recognition_ctc.py \
3
+ --dataset_name="mozilla-foundation/common_voice_8_0" \
4
+ --model_name_or_path="facebook/wav2vec2-xls-r-300m" \
5
+ --dataset_config_name="fr" \
6
+ --output_dir="./" \
7
+ --overwrite_output_dir \
8
+ --num_train_epochs="5" \
9
+ --per_device_train_batch_size="64" \
10
+ --per_device_eval_batch_size="64" \
11
+ --gradient_accumulation_steps="1" \
12
+ --learning_rate="7e-5" \
13
+ --warmup_steps="1500" \
14
+ --length_column_name="input_length" \
15
+ --evaluation_strategy="steps" \
16
+ --text_column_name="sentence" \
17
+ --save_steps="500" \
18
+ --eval_steps="500" \
19
+ --logging_steps="100" \
20
+ --layerdrop="0.0" \
21
+ --activation_dropout="0.1" \
22
+ --save_total_limit="3" \
23
+ --freeze_feature_encoder \
24
+ --feat_proj_dropout="0.0" \
25
+ --mask_time_prob="0.75" \
26
+ --mask_time_length="10" \
27
+ --mask_feature_prob="0.33" \
28
+ --mask_feature_length="10" \
29
+ --gradient_checkpointing \
30
+ --report_to="wandb" \
31
+ --run_name="xls-r-300m-fr" \
32
+ --max_eval_samples="4000" \
33
+ --max_duration_in_seconds="5" \
34
+ --use_auth_token \
35
+ --fp16 \
36
+ --group_by_length \
37
+ --preprocessing_num_workers="64" \
38
+ --do_train --do_eval \
39
+ --load_best_model_at_end \
40
+ --push_to_hub
.ipynb_checkpoints/run_speech_recognition_ctc-checkpoint.py ADDED
@@ -0,0 +1,747 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #!/usr/bin/env python
2
+ # coding=utf-8
3
+ # Copyright 2021 The HuggingFace Inc. team. All rights reserved.
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # http://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+
16
+ """ Fine-tuning a 🤗 Transformers CTC model for automatic speech recognition"""
17
+
18
+ import functools
19
+ import json
20
+ import logging
21
+ import os
22
+ import re
23
+ import sys
24
+ import warnings
25
+ from dataclasses import dataclass, field
26
+ from typing import Dict, List, Optional, Union
27
+ import unicodedata
28
+
29
+ import datasets
30
+ import numpy as np
31
+ import torch
32
+ from datasets import DatasetDict, load_dataset, load_metric
33
+
34
+ import transformers
35
+ from transformers import (
36
+ AutoConfig,
37
+ AutoFeatureExtractor,
38
+ AutoModelForCTC,
39
+ AutoProcessor,
40
+ AutoTokenizer,
41
+ HfArgumentParser,
42
+ Trainer,
43
+ TrainingArguments,
44
+ Wav2Vec2Processor,
45
+ Wav2Vec2CTCTokenizer,
46
+ set_seed,
47
+ )
48
+ from transformers.trainer_utils import get_last_checkpoint, is_main_process
49
+ from transformers.utils import check_min_version
50
+ from transformers.utils.versions import require_version
51
+
52
+
53
+ # Will error if the minimal version of Transformers is not installed. Remove at your own risks.
54
+ check_min_version("4.16.0.dev0")
55
+
56
+ require_version("datasets>=1.13.3", "To fix: pip install -r examples/pytorch/text-classification/requirements.txt")
57
+
58
+
59
+ logger = logging.getLogger(__name__)
60
+
61
+
62
+ def list_field(default=None, metadata=None):
63
+ return field(default_factory=lambda: default, metadata=metadata)
64
+
65
+
66
+ @dataclass
67
+ class ModelArguments:
68
+ """
69
+ Arguments pertaining to which model/config/tokenizer we are going to fine-tune from.
70
+ """
71
+
72
+ model_name_or_path: str = field(
73
+ metadata={"help": "Path to pretrained model or model identifier from huggingface.co/models"}
74
+ )
75
+ tokenizer_name_or_path: Optional[str] = field(
76
+ default=None,
77
+ metadata={"help": "Path to pretrained tokenizer or tokenizer identifier from huggingface.co/models"},
78
+ )
79
+ cache_dir: Optional[str] = field(
80
+ default=None,
81
+ metadata={"help": "Where do you want to store the pretrained models downloaded from huggingface.co"},
82
+ )
83
+ freeze_feature_encoder: bool = field(
84
+ default=True, metadata={"help": "Whether to freeze the feature encoder layers of the model."}
85
+ )
86
+ attention_dropout: float = field(
87
+ default=0.0, metadata={"help": "The dropout ratio for the attention probabilities."}
88
+ )
89
+ activation_dropout: float = field(
90
+ default=0.0, metadata={"help": "The dropout ratio for activations inside the fully connected layer."}
91
+ )
92
+ feat_proj_dropout: float = field(default=0.0, metadata={"help": "The dropout ratio for the projected features."})
93
+ hidden_dropout: float = field(
94
+ default=0.0,
95
+ metadata={
96
+ "help": "The dropout probability for all fully connected layers in the embeddings, encoder, and pooler."
97
+ },
98
+ )
99
+ final_dropout: float = field(
100
+ default=0.0,
101
+ metadata={"help": "The dropout probability for the final projection layer."},
102
+ )
103
+ mask_time_prob: float = field(
104
+ default=0.05,
105
+ metadata={
106
+ "help": "Probability of each feature vector along the time axis to be chosen as the start of the vector"
107
+ "span to be masked. Approximately ``mask_time_prob * sequence_length // mask_time_length`` feature"
108
+ "vectors will be masked along the time axis."
109
+ },
110
+ )
111
+ mask_time_length: int = field(
112
+ default=10,
113
+ metadata={"help": "Length of vector span to mask along the time axis."},
114
+ )
115
+ mask_feature_prob: float = field(
116
+ default=0.0,
117
+ metadata={
118
+ "help": "Probability of each feature vector along the feature axis to be chosen as the start of the vector"
119
+ "span to be masked. Approximately ``mask_feature_prob * sequence_length // mask_feature_length`` feature bins will be masked along the time axis."
120
+ },
121
+ )
122
+ mask_feature_length: int = field(
123
+ default=10,
124
+ metadata={"help": "Length of vector span to mask along the feature axis."},
125
+ )
126
+ layerdrop: float = field(default=0.0, metadata={"help": "The LayerDrop probability."})
127
+ ctc_loss_reduction: Optional[str] = field(
128
+ default="mean", metadata={"help": "The way the ctc loss should be reduced. Should be one of 'mean' or 'sum'."}
129
+ )
130
+
131
+
132
+ @dataclass
133
+ class DataTrainingArguments:
134
+ """
135
+ Arguments pertaining to what data we are going to input our model for training and eval.
136
+
137
+ Using `HfArgumentParser` we can turn this class
138
+ into argparse arguments to be able to specify them on
139
+ the command line.
140
+ """
141
+
142
+ dataset_name: str = field(
143
+ metadata={"help": "The configuration name of the dataset to use (via the datasets library)."}
144
+ )
145
+ dataset_config_name: str = field(
146
+ default=None, metadata={"help": "The configuration name of the dataset to use (via the datasets library)."}
147
+ )
148
+ train_split_name: str = field(
149
+ default="train+validation",
150
+ metadata={
151
+ "help": "The name of the training data set split to use (via the datasets library). Defaults to 'train'"
152
+ },
153
+ )
154
+ eval_split_name: str = field(
155
+ default="test",
156
+ metadata={
157
+ "help": "The name of the training data set split to use (via the datasets library). Defaults to 'test'"
158
+ },
159
+ )
160
+ audio_column_name: str = field(
161
+ default="audio",
162
+ metadata={"help": "The name of the dataset column containing the audio data. Defaults to 'audio'"},
163
+ )
164
+ text_column_name: str = field(
165
+ default="text",
166
+ metadata={"help": "The name of the dataset column containing the text data. Defaults to 'text'"},
167
+ )
168
+ overwrite_cache: bool = field(
169
+ default=False, metadata={"help": "Overwrite the cached preprocessed datasets or not."}
170
+ )
171
+ preprocessing_num_workers: Optional[int] = field(
172
+ default=None,
173
+ metadata={"help": "The number of processes to use for the preprocessing."},
174
+ )
175
+ max_train_samples: Optional[int] = field(
176
+ default=None,
177
+ metadata={
178
+ "help": "For debugging purposes or quicker training, truncate the number of training examples to this "
179
+ "value if set."
180
+ },
181
+ )
182
+ max_eval_samples: Optional[int] = field(
183
+ default=None,
184
+ metadata={
185
+ "help": "For debugging purposes or quicker training, truncate the number of validation examples to this "
186
+ "value if set."
187
+ },
188
+ )
189
+ chars_to_ignore: Optional[List[str]] = list_field(
190
+ default=None,
191
+ metadata={"help": "A list of characters to remove from the transcripts."},
192
+ )
193
+ eval_metrics: List[str] = list_field(
194
+ default=["wer"],
195
+ metadata={"help": "A list of metrics the model should be evaluated on. E.g. `'wer cer'`"},
196
+ )
197
+ max_duration_in_seconds: float = field(
198
+ default=20.0,
199
+ metadata={
200
+ "help": "Filter audio files that are longer than `max_duration_in_seconds` seconds to 'max_duration_in_seconds`"
201
+ },
202
+ )
203
+ min_duration_in_seconds: float = field(
204
+ default=0.0, metadata={"help": "Filter audio files that are shorter than `min_duration_in_seconds` seconds"}
205
+ )
206
+ preprocessing_only: bool = field(
207
+ default=False,
208
+ metadata={
209
+ "help": "Whether to only do data preprocessing and skip training. "
210
+ "This is especially useful when data preprocessing errors out in distributed training due to timeout. "
211
+ "In this case, one should run the preprocessing in a non-distributed setup with `preprocessing_only=True` "
212
+ "so that the cached datasets can consequently be loaded in distributed training"
213
+ },
214
+ )
215
+ use_auth_token: bool = field(
216
+ default=False,
217
+ metadata={
218
+ "help": "If :obj:`True`, will use the token generated when running"
219
+ ":obj:`transformers-cli login` as HTTP bearer authorization for remote files."
220
+ },
221
+ )
222
+ unk_token: str = field(
223
+ default="[UNK]",
224
+ metadata={"help": "The unk token for the tokenizer"},
225
+ )
226
+ pad_token: str = field(
227
+ default="[PAD]",
228
+ metadata={"help": "The padding token for the tokenizer"},
229
+ )
230
+ word_delimiter_token: str = field(
231
+ default="|",
232
+ metadata={"help": "The word delimiter token for the tokenizer"},
233
+ )
234
+ phoneme_language: Optional[str] = field(
235
+ default=None,
236
+ metadata={
237
+ "help": "The target language that should be used be"
238
+ " passed to the tokenizer for tokenization. Note that"
239
+ " this is only relevant if the model classifies the"
240
+ " input audio to a sequence of phoneme sequences."
241
+ },
242
+ )
243
+
244
+
245
+ @dataclass
246
+ class DataCollatorCTCWithPadding:
247
+ """
248
+ Data collator that will dynamically pad the inputs received.
249
+ Args:
250
+ processor (:class:`~transformers.AutoProcessor`)
251
+ The processor used for proccessing the data.
252
+ padding (:obj:`bool`, :obj:`str` or :class:`~transformers.tokenization_utils_base.PaddingStrategy`, `optional`, defaults to :obj:`True`):
253
+ Select a strategy to pad the returned sequences (according to the model's padding side and padding index)
254
+ among:
255
+ * :obj:`True` or :obj:`'longest'`: Pad to the longest sequence in the batch (or no padding if only a single
256
+ sequence if provided).
257
+ * :obj:`'max_length'`: Pad to a maximum length specified with the argument :obj:`max_length` or to the
258
+ maximum acceptable input length for the model if that argument is not provided.
259
+ * :obj:`False` or :obj:`'do_not_pad'` (default): No padding (i.e., can output a batch with sequences of
260
+ different lengths).
261
+ max_length (:obj:`int`, `optional`):
262
+ Maximum length of the ``input_values`` of the returned list and optionally padding length (see above).
263
+ max_length_labels (:obj:`int`, `optional`):
264
+ Maximum length of the ``labels`` returned list and optionally padding length (see above).
265
+ pad_to_multiple_of (:obj:`int`, `optional`):
266
+ If set will pad the sequence to a multiple of the provided value.
267
+ This is especially useful to enable the use of Tensor Cores on NVIDIA hardware with compute capability >=
268
+ 7.5 (Volta).
269
+ """
270
+
271
+ processor: AutoProcessor
272
+ padding: Union[bool, str] = "longest"
273
+ pad_to_multiple_of: Optional[int] = None
274
+ pad_to_multiple_of_labels: Optional[int] = None
275
+
276
+ def __call__(self, features: List[Dict[str, Union[List[int], torch.Tensor]]]) -> Dict[str, torch.Tensor]:
277
+ # split inputs and labels since they have to be of different lenghts and need
278
+ # different padding methods
279
+ input_features = [{"input_values": feature["input_values"]} for feature in features]
280
+ label_features = [{"input_ids": feature["labels"]} for feature in features]
281
+
282
+ batch = self.processor.pad(
283
+ input_features,
284
+ padding=self.padding,
285
+ pad_to_multiple_of=self.pad_to_multiple_of,
286
+ return_tensors="pt",
287
+ )
288
+
289
+ with self.processor.as_target_processor():
290
+ labels_batch = self.processor.pad(
291
+ label_features,
292
+ padding=self.padding,
293
+ pad_to_multiple_of=self.pad_to_multiple_of_labels,
294
+ return_tensors="pt",
295
+ )
296
+
297
+ # replace padding with -100 to ignore loss correctly
298
+ labels = labels_batch["input_ids"].masked_fill(labels_batch.attention_mask.ne(1), -100)
299
+
300
+ batch["labels"] = labels
301
+
302
+ return batch
303
+
304
+
305
+ def create_vocabulary_from_data(
306
+ datasets: DatasetDict,
307
+ word_delimiter_token: Optional[str] = None,
308
+ unk_token: Optional[str] = None,
309
+ pad_token: Optional[str] = None,
310
+ ):
311
+ # Given training and test labels create vocabulary
312
+ def extract_all_chars(batch):
313
+ all_text = " ".join(batch["target_text"])
314
+ vocab = list(set(all_text))
315
+ return {"vocab": [vocab], "all_text": [all_text]}
316
+
317
+ vocabs = datasets.map(
318
+ extract_all_chars,
319
+ batched=True,
320
+ batch_size=-1,
321
+ keep_in_memory=True,
322
+ remove_columns=datasets["train"].column_names,
323
+ )
324
+
325
+ # take union of all unique characters in each dataset
326
+ vocab_set = functools.reduce(
327
+ lambda vocab_1, vocab_2: set(vocab_1["vocab"][0]) | set(vocab_2["vocab"][0]), vocabs.values()
328
+ )
329
+
330
+ vocab_dict = {v: k for k, v in enumerate(sorted(list(vocab_set)))}
331
+
332
+ # replace white space with delimiter token
333
+ if word_delimiter_token is not None:
334
+ vocab_dict[word_delimiter_token] = vocab_dict[" "]
335
+ del vocab_dict[" "]
336
+
337
+ # add unk and pad token
338
+ if unk_token is not None:
339
+ vocab_dict[unk_token] = len(vocab_dict)
340
+
341
+ if pad_token is not None:
342
+ vocab_dict[pad_token] = len(vocab_dict)
343
+
344
+ return vocab_dict
345
+
346
+
347
+ def main():
348
+ # See all possible arguments in src/transformers/training_args.py
349
+ # or by passing the --help flag to this script.
350
+ # We now keep distinct sets of args, for a cleaner separation of concerns.
351
+
352
+ parser = HfArgumentParser((ModelArguments, DataTrainingArguments, TrainingArguments))
353
+ if len(sys.argv) == 2 and sys.argv[1].endswith(".json"):
354
+ # If we pass only one argument to the script and it's the path to a json file,
355
+ # let's parse it to get our arguments.
356
+ model_args, data_args, training_args = parser.parse_json_file(json_file=os.path.abspath(sys.argv[1]))
357
+ else:
358
+ model_args, data_args, training_args = parser.parse_args_into_dataclasses()
359
+
360
+ # Detecting last checkpoint.
361
+ last_checkpoint = None
362
+ if os.path.isdir(training_args.output_dir) and training_args.do_train and not training_args.overwrite_output_dir:
363
+ last_checkpoint = get_last_checkpoint(training_args.output_dir)
364
+ if last_checkpoint is None and len(os.listdir(training_args.output_dir)) > 0:
365
+ raise ValueError(
366
+ f"Output directory ({training_args.output_dir}) already exists and is not empty. "
367
+ "Use --overwrite_output_dir to overcome."
368
+ )
369
+ elif last_checkpoint is not None:
370
+ logger.info(
371
+ f"Checkpoint detected, resuming training at {last_checkpoint}. To avoid this behavior, change "
372
+ "the `--output_dir` or add `--overwrite_output_dir` to train from scratch."
373
+ )
374
+
375
+ # Setup logging
376
+ logging.basicConfig(
377
+ format="%(asctime)s - %(levelname)s - %(name)s - %(message)s",
378
+ datefmt="%m/%d/%Y %H:%M:%S",
379
+ handlers=[logging.StreamHandler(sys.stdout)],
380
+ )
381
+ logger.setLevel(logging.INFO if is_main_process(training_args.local_rank) else logging.WARN)
382
+
383
+ # Log on each process the small summary:
384
+ logger.warning(
385
+ f"Process rank: {training_args.local_rank}, device: {training_args.device}, n_gpu: {training_args.n_gpu}"
386
+ f"distributed training: {bool(training_args.local_rank != -1)}, 16-bits training: {training_args.fp16}"
387
+ )
388
+ # Set the verbosity to info of the Transformers logger (on main process only):
389
+ if is_main_process(training_args.local_rank):
390
+ transformers.utils.logging.set_verbosity_info()
391
+ logger.info("Training/evaluation parameters %s", training_args)
392
+
393
+ # Set seed before initializing model.
394
+ set_seed(training_args.seed)
395
+
396
+ # 1. First, let's load the dataset
397
+ raw_datasets = DatasetDict()
398
+
399
+ if training_args.do_train:
400
+ raw_datasets["train"] = load_dataset(
401
+ data_args.dataset_name,
402
+ data_args.dataset_config_name,
403
+ split=data_args.train_split_name,
404
+ use_auth_token=data_args.use_auth_token,
405
+ )
406
+
407
+ if data_args.audio_column_name not in raw_datasets["train"].column_names:
408
+ raise ValueError(
409
+ f"--audio_column_name '{data_args.audio_column_name}' not found in dataset '{data_args.dataset_name}'. "
410
+ "Make sure to set `--audio_column_name` to the correct audio column - one of "
411
+ f"{', '.join(raw_datasets['train'].column_names)}."
412
+ )
413
+
414
+ if data_args.text_column_name not in raw_datasets["train"].column_names:
415
+ raise ValueError(
416
+ f"--text_column_name {data_args.text_column_name} not found in dataset '{data_args.dataset_name}'. "
417
+ "Make sure to set `--text_column_name` to the correct text column - one of "
418
+ f"{', '.join(raw_datasets['train'].column_names)}."
419
+ )
420
+
421
+ if data_args.max_train_samples is not None:
422
+ raw_datasets["train"] = raw_datasets["train"].select(range(data_args.max_train_samples))
423
+
424
+ if training_args.do_eval:
425
+ raw_datasets["eval"] = load_dataset(
426
+ data_args.dataset_name,
427
+ data_args.dataset_config_name,
428
+ split=data_args.eval_split_name,
429
+ use_auth_token=data_args.use_auth_token,
430
+ )
431
+
432
+ if data_args.max_eval_samples is not None:
433
+ raw_datasets["eval"] = raw_datasets["eval"].shuffle(seed=42).select(range(data_args.max_eval_samples))
434
+
435
+ # 2. We remove some special characters from the datasets
436
+ # that make training complicated and do not help in transcribing the speech
437
+ # E.g. characters, such as `,` and `.` do not really have an acoustic characteristic
438
+ # that could be easily picked up by the model
439
+ text_column_name = data_args.text_column_name
440
+
441
+ chars_to_remove_regex = r'[\,\?\.\!\-\_\;\:\"\“\%\‘\”\�\^]'
442
+
443
+ def remove_accents(input_str):
444
+ nfkd_form = unicodedata.normalize('NFKD', input_str)
445
+ return u"".join([c for c in nfkd_form if not unicodedata.combining(c)])
446
+
447
+ def remove_special_characters(batch):
448
+ batch["target_text"] = re.sub(chars_to_remove_regex, '', batch[text_column_name]).lower()
449
+ batch["target_text"] = re.sub("ç", r'[cedille]', batch["target_text"])
450
+ batch["target_text"] = re.sub("&", r'et', batch["target_text"])
451
+ batch["target_text"] = re.sub("%", r' pourcents', batch["target_text"])
452
+ batch["target_text"] = re.sub("([0-9]+)(,|.)([0-9+])", r'\1 virgule \3', batch["target_text"])
453
+ batch["target_text"] = re.sub("\$", r'dollar', batch["target_text"])
454
+ batch["target_text"] = re.sub("\£", r'livre', batch["target_text"])
455
+ batch["target_text"] = re.sub("\€", r'euro', batch["target_text"])
456
+ batch["target_text"] = remove_accents(batch["target_text"])
457
+ batch["target_text"] = re.sub(r"\[cedille\]", 'ç', batch["target_text"]) + " "
458
+ return batch
459
+
460
+ with training_args.main_process_first(desc="dataset map special characters removal"):
461
+ raw_datasets = raw_datasets.map(
462
+ remove_special_characters,
463
+ remove_columns=[text_column_name],
464
+ desc="remove special characters from datasets"
465
+ )
466
+
467
+ # save special tokens for tokenizer
468
+ word_delimiter_token = data_args.word_delimiter_token
469
+ unk_token = data_args.unk_token
470
+ pad_token = data_args.pad_token
471
+
472
+ # 3. Next, let's load the config as we might need it to create
473
+ # the tokenizer
474
+ # load config
475
+ config = AutoConfig.from_pretrained(
476
+ model_args.model_name_or_path, cache_dir=model_args.cache_dir, use_auth_token=data_args.use_auth_token
477
+ )
478
+
479
+ # 4. Next, if no tokenizer file is defined,
480
+ # we create the vocabulary of the model by extracting all unique characters from
481
+ # the training and evaluation datasets
482
+ # We need to make sure that only first rank saves vocabulary
483
+ # make sure all processes wait until vocab is created
484
+ tokenizer_name_or_path = model_args.tokenizer_name_or_path
485
+ tokenizer_kwargs = {}
486
+ if tokenizer_name_or_path is None:
487
+ # save vocab in training output dir
488
+ tokenizer_name_or_path = training_args.output_dir
489
+
490
+ vocab_file = os.path.join(tokenizer_name_or_path, "vocab.json")
491
+
492
+ with training_args.main_process_first():
493
+ if training_args.overwrite_output_dir and os.path.isfile(vocab_file):
494
+ os.remove(vocab_file)
495
+
496
+ with training_args.main_process_first(desc="dataset map vocabulary creation"):
497
+ if not os.path.isfile(vocab_file):
498
+ os.makedirs(tokenizer_name_or_path, exist_ok=True)
499
+ vocab_dict = create_vocabulary_from_data(
500
+ raw_datasets,
501
+ word_delimiter_token=word_delimiter_token,
502
+ unk_token=unk_token,
503
+ pad_token=pad_token,
504
+ )
505
+
506
+ # save vocab dict to be loaded into tokenizer
507
+ with open(vocab_file, "w") as file:
508
+ json.dump(vocab_dict, file)
509
+
510
+ # if tokenizer has just been created
511
+ # it is defined by `tokenizer_class` if present in config else by `model_type`
512
+ tokenizer_kwargs = {
513
+ "config": config if config.tokenizer_class is not None else None,
514
+ "tokenizer_type": config.model_type if config.tokenizer_class is None else None,
515
+ "unk_token": unk_token,
516
+ "pad_token": pad_token,
517
+ "word_delimiter_token": word_delimiter_token,
518
+ }
519
+
520
+ # 5. Now we can instantiate the feature extractor, tokenizer and model
521
+ # Note for distributed training, the .from_pretrained methods guarantee that only
522
+ # one local process can concurrently download model & vocab.
523
+
524
+ # load feature_extractor and tokenizer
525
+ tokenizer = Wav2Vec2CTCTokenizer(tokenizer_name_or_path,
526
+ use_auth_token=data_args.use_auth_token,
527
+ **tokenizer_kwargs,
528
+ )
529
+ feature_extractor = AutoFeatureExtractor.from_pretrained(
530
+ model_args.model_name_or_path, cache_dir=model_args.cache_dir, use_auth_token=data_args.use_auth_token
531
+ )
532
+
533
+ # adapt config
534
+ config.update(
535
+ {
536
+ "feat_proj_dropout": model_args.feat_proj_dropout,
537
+ "attention_dropout": model_args.attention_dropout,
538
+ "hidden_dropout": model_args.hidden_dropout,
539
+ "final_dropout": model_args.final_dropout,
540
+ "mask_time_prob": model_args.mask_time_prob,
541
+ "mask_time_length": model_args.mask_time_length,
542
+ "mask_feature_prob": model_args.mask_feature_prob,
543
+ "mask_feature_length": model_args.mask_feature_length,
544
+ "gradient_checkpointing": training_args.gradient_checkpointing,
545
+ "layerdrop": model_args.layerdrop,
546
+ "ctc_loss_reduction": model_args.ctc_loss_reduction,
547
+ "pad_token_id": tokenizer.pad_token_id,
548
+ "vocab_size": len(tokenizer),
549
+ "activation_dropout": model_args.activation_dropout,
550
+ }
551
+ )
552
+
553
+ # create model
554
+ model = AutoModelForCTC.from_pretrained(
555
+ model_args.model_name_or_path,
556
+ cache_dir=model_args.cache_dir,
557
+ config=config,
558
+ use_auth_token=data_args.use_auth_token,
559
+ )
560
+
561
+ # freeze encoder
562
+ if model_args.freeze_feature_encoder:
563
+ model.freeze_feature_encoder()
564
+
565
+ # 6. Now we preprocess the datasets including loading the audio, resampling and normalization
566
+ # Thankfully, `datasets` takes care of automatically loading and resampling the audio,
567
+ # so that we just need to set the correct target sampling rate and normalize the input
568
+ # via the `feature_extractor`
569
+
570
+ # make sure that dataset decodes audio with correct sampling rate
571
+ dataset_sampling_rate = next(iter(raw_datasets.values())).features[data_args.audio_column_name].sampling_rate
572
+ if dataset_sampling_rate != feature_extractor.sampling_rate:
573
+ raw_datasets = raw_datasets.cast_column(
574
+ data_args.audio_column_name, datasets.features.Audio(sampling_rate=feature_extractor.sampling_rate)
575
+ )
576
+
577
+ # derive max & min input length for sample rate & max duration
578
+ max_input_length = data_args.max_duration_in_seconds * feature_extractor.sampling_rate
579
+ min_input_length = data_args.min_duration_in_seconds * feature_extractor.sampling_rate
580
+ audio_column_name = data_args.audio_column_name
581
+ num_workers = data_args.preprocessing_num_workers
582
+
583
+ # `phoneme_language` is only relevant if the model is fine-tuned on phoneme classification
584
+ phoneme_language = data_args.phoneme_language
585
+
586
+ # Preprocessing the datasets.
587
+ # We need to read the audio files as arrays and tokenize the targets.
588
+ def prepare_dataset(batch):
589
+ # load audio
590
+ sample = batch[audio_column_name]
591
+
592
+ inputs = feature_extractor(sample["array"], sampling_rate=sample["sampling_rate"])
593
+ batch["input_values"] = inputs.input_values[0]
594
+ batch["input_length"] = len(batch["input_values"])
595
+
596
+ # encode targets
597
+ additional_kwargs = {}
598
+ if phoneme_language is not None:
599
+ additional_kwargs["phonemizer_lang"] = phoneme_language
600
+
601
+ batch["labels"] = tokenizer(batch["target_text"], **additional_kwargs).input_ids
602
+ return batch
603
+
604
+ with training_args.main_process_first(desc="dataset map preprocessing"):
605
+ vectorized_datasets = raw_datasets.map(
606
+ prepare_dataset,
607
+ remove_columns=next(iter(raw_datasets.values())).column_names,
608
+ batch_size=-1,
609
+ desc="preprocess datasets",
610
+ )
611
+
612
+ def is_audio_in_length_range(length):
613
+ return length > min_input_length and length < max_input_length
614
+
615
+ # filter data that is shorter than min_input_length
616
+ vectorized_datasets = vectorized_datasets.filter(
617
+ is_audio_in_length_range,
618
+ num_proc=num_workers,
619
+ input_columns=["input_length"],
620
+ )
621
+
622
+ # 7. Next, we can prepare the training.
623
+ # Let's use word error rate (WER) as our evaluation metric,
624
+ # instantiate a data collator and the trainer
625
+
626
+ # Define evaluation metrics during training, *i.e.* word error rate, character error rate
627
+ eval_metrics = {metric: load_metric(metric) for metric in data_args.eval_metrics}
628
+
629
+ # for large datasets it is advised to run the preprocessing on a
630
+ # single machine first with ``args.preprocessing_only`` since there will mostly likely
631
+ # be a timeout when running the script in distributed mode.
632
+ # In a second step ``args.preprocessing_only`` can then be set to `False` to load the
633
+ # cached dataset
634
+ if data_args.preprocessing_only:
635
+ logger.info(f"Data preprocessing finished. Files cached at {vectorized_datasets.cache_files}")
636
+ return
637
+
638
+ def compute_metrics(pred):
639
+ pred_logits = pred.predictions
640
+ pred_ids = np.argmax(pred_logits, axis=-1)
641
+
642
+ pred.label_ids[pred.label_ids == -100] = tokenizer.pad_token_id
643
+
644
+ pred_str = tokenizer.batch_decode(pred_ids, skip_special_tokens=True)#being sure to remove <s> from the output
645
+ # we do not want to group tokens when computing the metrics
646
+ label_str = tokenizer.batch_decode(pred.label_ids, group_tokens=False)
647
+
648
+ metrics = {k: v.compute(predictions=pred_str, references=label_str) for k, v in eval_metrics.items()}
649
+
650
+ return metrics
651
+
652
+ # Now save everything to be able to create a single processor later
653
+ if is_main_process(training_args.local_rank):
654
+ # save feature extractor, tokenizer and config
655
+ feature_extractor.save_pretrained(training_args.output_dir)
656
+ tokenizer.save_pretrained(training_args.output_dir)
657
+ config.save_pretrained(training_args.output_dir)
658
+
659
+ try:
660
+ processor = AutoProcessor.from_pretrained(training_args.output_dir)
661
+ except (OSError, KeyError):
662
+ warnings.warn(
663
+ "Loading a processor from a feature extractor config that does not"
664
+ " include a `processor_class` attribute is deprecated and will be removed in v5. Please add the following "
665
+ " attribute to your `preprocessor_config.json` file to suppress this warning: "
666
+ " `'processor_class': 'Wav2Vec2Processor'`",
667
+ FutureWarning,
668
+ )
669
+ processor = Wav2Vec2Processor.from_pretrained(training_args.output_dir)
670
+
671
+ # Instantiate custom data collator
672
+ data_collator = DataCollatorCTCWithPadding(processor=processor)
673
+
674
+ # Initialize Trainer
675
+ trainer = Trainer(
676
+ model=model,
677
+ data_collator=data_collator,
678
+ args=training_args,
679
+ compute_metrics=compute_metrics,
680
+ train_dataset=vectorized_datasets["train"] if training_args.do_train else None,
681
+ eval_dataset=vectorized_datasets["eval"] if training_args.do_eval else None,
682
+ tokenizer=feature_extractor,
683
+ )
684
+
685
+ # 8. Finally, we can start training
686
+
687
+ # Training
688
+ if training_args.do_train:
689
+
690
+ # use last checkpoint if exist
691
+ if last_checkpoint is not None:
692
+ checkpoint = last_checkpoint
693
+ elif os.path.isdir(model_args.model_name_or_path):
694
+ checkpoint = model_args.model_name_or_path
695
+ else:
696
+ checkpoint = None
697
+
698
+ train_result = trainer.train(resume_from_checkpoint=checkpoint)
699
+ trainer.save_model()
700
+
701
+ metrics = train_result.metrics
702
+ max_train_samples = (
703
+ data_args.max_train_samples
704
+ if data_args.max_train_samples is not None
705
+ else len(vectorized_datasets["train"])
706
+ )
707
+ metrics["train_samples"] = min(max_train_samples, len(vectorized_datasets["train"]))
708
+
709
+ trainer.log_metrics("train", metrics)
710
+ trainer.save_metrics("train", metrics)
711
+ trainer.save_state()
712
+
713
+ # Evaluation
714
+ results = {}
715
+ if training_args.do_eval:
716
+ logger.info("*** Evaluate ***")
717
+ metrics = trainer.evaluate()
718
+ max_eval_samples = (
719
+ data_args.max_eval_samples if data_args.max_eval_samples is not None else len(vectorized_datasets["eval"])
720
+ )
721
+ metrics["eval_samples"] = min(max_eval_samples, len(vectorized_datasets["eval"]))
722
+
723
+ trainer.log_metrics("eval", metrics)
724
+ trainer.save_metrics("eval", metrics)
725
+
726
+ # Write model card and (optionally) push to hub
727
+ config_name = data_args.dataset_config_name if data_args.dataset_config_name is not None else "na"
728
+ kwargs = {
729
+ "finetuned_from": model_args.model_name_or_path,
730
+ "tasks": "speech-recognition",
731
+ "tags": ["automatic-speech-recognition", data_args.dataset_name],
732
+ "dataset_args": f"Config: {config_name}, Training split: {data_args.train_split_name}, Eval split: {data_args.eval_split_name}",
733
+ "dataset": f"{data_args.dataset_name.upper()} - {config_name.upper()}",
734
+ }
735
+ if "common_voice" in data_args.dataset_name:
736
+ kwargs["language"] = config_name
737
+
738
+ if training_args.push_to_hub:
739
+ trainer.push_to_hub(**kwargs)
740
+ else:
741
+ trainer.create_model_card(**kwargs)
742
+
743
+ return results
744
+
745
+
746
+ if __name__ == "__main__":
747
+ main()
config.json DELETED
@@ -1,107 +0,0 @@
1
- {
2
- "_name_or_path": "facebook/wav2vec2-xls-r-300m",
3
- "activation_dropout": 0.1,
4
- "adapter_kernel_size": 3,
5
- "adapter_stride": 2,
6
- "add_adapter": false,
7
- "apply_spec_augment": true,
8
- "architectures": [
9
- "Wav2Vec2ForPreTraining"
10
- ],
11
- "attention_dropout": 0.0,
12
- "bos_token_id": 1,
13
- "classifier_proj_size": 256,
14
- "codevector_dim": 768,
15
- "contrastive_logits_temperature": 0.1,
16
- "conv_bias": true,
17
- "conv_dim": [
18
- 512,
19
- 512,
20
- 512,
21
- 512,
22
- 512,
23
- 512,
24
- 512
25
- ],
26
- "conv_kernel": [
27
- 10,
28
- 3,
29
- 3,
30
- 3,
31
- 3,
32
- 2,
33
- 2
34
- ],
35
- "conv_stride": [
36
- 5,
37
- 2,
38
- 2,
39
- 2,
40
- 2,
41
- 2,
42
- 2
43
- ],
44
- "ctc_loss_reduction": "mean",
45
- "ctc_zero_infinity": false,
46
- "diversity_loss_weight": 0.1,
47
- "do_stable_layer_norm": true,
48
- "eos_token_id": 2,
49
- "feat_extract_activation": "gelu",
50
- "feat_extract_dropout": 0.0,
51
- "feat_extract_norm": "layer",
52
- "feat_proj_dropout": 0.0,
53
- "feat_quantizer_dropout": 0.0,
54
- "final_dropout": 0.0,
55
- "hidden_act": "gelu",
56
- "hidden_dropout": 0.0,
57
- "hidden_size": 1024,
58
- "initializer_range": 0.02,
59
- "intermediate_size": 4096,
60
- "layer_norm_eps": 1e-05,
61
- "layerdrop": 0.0,
62
- "mask_feature_length": 10,
63
- "mask_feature_min_masks": 0,
64
- "mask_feature_prob": 0.33,
65
- "mask_time_length": 10,
66
- "mask_time_min_masks": 2,
67
- "mask_time_prob": 0.75,
68
- "model_type": "wav2vec2",
69
- "num_adapter_layers": 3,
70
- "num_attention_heads": 16,
71
- "num_codevector_groups": 2,
72
- "num_codevectors_per_group": 320,
73
- "num_conv_pos_embedding_groups": 16,
74
- "num_conv_pos_embeddings": 128,
75
- "num_feat_extract_layers": 7,
76
- "num_hidden_layers": 24,
77
- "num_negatives": 100,
78
- "output_hidden_size": 1024,
79
- "pad_token_id": 216,
80
- "proj_codevector_dim": 768,
81
- "tdnn_dilation": [
82
- 1,
83
- 2,
84
- 3,
85
- 1,
86
- 1
87
- ],
88
- "tdnn_dim": [
89
- 512,
90
- 512,
91
- 512,
92
- 512,
93
- 1500
94
- ],
95
- "tdnn_kernel": [
96
- 5,
97
- 3,
98
- 3,
99
- 1,
100
- 1
101
- ],
102
- "torch_dtype": "float32",
103
- "transformers_version": "4.17.0.dev0",
104
- "use_weighted_layer_sum": false,
105
- "vocab_size": 216,
106
- "xvector_output_dim": 512
107
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
preprocessor_config.json DELETED
@@ -1,9 +0,0 @@
1
- {
2
- "do_normalize": true,
3
- "feature_extractor_type": "Wav2Vec2FeatureExtractor",
4
- "feature_size": 1,
5
- "padding_side": "right",
6
- "padding_value": 0,
7
- "return_attention_mask": true,
8
- "sampling_rate": 16000
9
- }
 
 
 
 
 
 
 
 
 
 
pytorch_model.bin DELETED
@@ -1,3 +0,0 @@
1
- version https://git-lfs.github.com/spec/v1
2
- oid sha256:546a1a0925a18a661921f3011e0a69db3b304f8aefcac8fd376e25b8d1265152
3
- size 1262817457
 
 
 
 
special_tokens_map.json DELETED
@@ -1 +0,0 @@
1
- {"unk_token": "[UNK]", "pad_token": "[PAD]"}
 
 
tokenizer_config.json DELETED
@@ -1 +0,0 @@
1
- {"unk_token": "[UNK]", "bos_token": "<s>", "eos_token": null, "pad_token": "[PAD]", "do_lower_case": false, "word_delimiter_token": "|", "special_tokens_map_file": null, "tokenizer_file": null, "name_or_path": "./", "tokenizer_class": "Wav2Vec2CTCTokenizer"}
 
 
training_args.bin DELETED
@@ -1,3 +0,0 @@
1
- version https://git-lfs.github.com/spec/v1
2
- oid sha256:fb65a6864c6934480b0b74a879e77e35b12180cab3e24b285a5fbfe0e5f117b8
3
- size 3055
 
 
 
 
vocab.json DELETED
@@ -1 +0,0 @@
1
- {"'": 1, "(": 2, ")": 3, "*": 4, ".": 5, "/": 6, "1": 7, "2": 8, "=": 9, "C": 10, "E": 11, "N": 12, "Q": 13, "R": 14, "Z": 15, "`": 16, "a": 17, "b": 18, "c": 19, "d": 20, "e": 21, "f": 22, "g": 23, "h": 24, "i": 25, "j": 26, "k": 27, "l": 28, "m": 29, "n": 30, "o": 31, "p": 32, "q": 33, "r": 34, "s": 35, "t": 36, "u": 37, "v": 38, "w": 39, "x": 40, "y": 41, "z": 42, "{": 43, "|": 0, "}": 45, "~": 46, "§": 47, "«": 48, "®": 49, "°": 50, "±": 51, "·": 52, "»": 53, "×": 54, "ß": 55, "æ": 56, "ç": 57, "ð": 58, "ø": 59, "þ": 60, "đ": 61, "ħ": 62, "ı": 63, "ł": 64, "œ": 65, "ǀ": 66, "ǃ": 67, "ɑ": 68, "ə": 69, "ɨ": 70, "ʉ": 71, "ʔ": 72, "ʻ": 73, "ʼ": 74, "ʽ": 75, "ʾ": 76, "ʿ": 77, "ː": 78, "α": 79, "β": 80, "γ": 81, "δ": 82, "ε": 83, "ζ": 84, "η": 85, "θ": 86, "ι": 87, "κ": 88, "λ": 89, "μ": 90, "ν": 91, "ο": 92, "π": 93, "ρ": 94, "ς": 95, "σ": 96, "τ": 97, "υ": 98, "φ": 99, "χ": 100, "ψ": 101, "ω": 102, "а": 103, "г": 104, "е": 105, "з": 106, "и": 107, "к": 108, "м": 109, "н": 110, "о": 111, "п": 112, "р": 113, "ц": 114, "ч": 115, "э": 116, "я": 117, "є": 118, "і": 119, "ј": 120, "џ": 121, "ҫ": 122, "ӌ": 123, "գ": 124, "զ": 125, "ا": 126, "ب": 127, "ة": 128, "د": 129, "ر": 130, "ل": 131, "م": 132, "ن": 133, "و": 134, "ي": 135, "ᄀ": 136, "ᄆ": 137, "ᄉ": 138, "ᄌ": 139, "ᅡ": 140, "ᅢ": 141, "ᅥ": 142, "ᅩ": 143, "ᅵ": 144, "ᆨ": 145, "ᆷ": 146, "ᆸ": 147, "ᆼ": 148, "ቀ": 149, "ከ": 150, "ወ": 151, "ደ": 152, "ጀ": 153, "‐": 154, "–": 155, "—": 156, "―": 157, "’": 158, "„": 159, "†": 160, "′": 161, "‹": 162, "›": 163, "⁄": 164, "₽": 165, "→": 166, "↔": 167, "∅": 168, "∆": 169, "∈": 170, "−": 171, "∞": 172, "∨": 173, "∼": 174, "≥": 175, "⊨": 176, "⋅": 177, "─": 178, "☉": 179, "ⱅ": 180, "ⱎ": 181, "い": 182, "う": 183, "た": 184, "つ": 185, "の": 186, "ひ": 187, "へ": 188, "ま": 189, "む": 190, "め": 191, "も": 192, "や": 193, "三": 194, "丹": 195, "乃": 196, "京": 197, "保": 198, "北": 199, "厳": 200, "宇": 201, "扬": 202, "文": 203, "星": 204, "术": 205, "杜": 206, "津": 207, "牡": 208, "甌": 209, "美": 210, "西": 211, "貴": 212, "青": 213, "馆": 214, "ꝑ": 215, "[UNK]": 215, "[PAD]": 216}