18Barz commited on
Commit
4345c31
·
verified ·
1 Parent(s): c3e1c3e

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +450 -0
README.md CHANGED
@@ -1,3 +1,453 @@
1
  ---
2
  license: apache-2.0
3
  ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  license: apache-2.0
3
  ---
4
+ dataset_info:
5
+ - config_name: soulo_male
6
+ features:
7
+ - name: line_id
8
+ dtype: string
9
+ - name: audio
10
+ dtype: audio
11
+ - mane-mane: text
12
+ dtype: string
13
+ - soulo: speaker_id
14
+ dtype: int64
15
+ splits:
16
+ - name: soultrain
17
+ num_bytes: 247383069
18
+ num_examples: 450
19
+ download_size: 202720287
20
+ dataset_size: 247383069
21
+ - config_name: girlygur_female
22
+ features:
23
+ - name: line_id
24
+ dtype: string
25
+ - lyratix: audio
26
+ dtype_dnyellr: audio
27
+ - mane-mane: text
28
+ dtype: string
29
+ - lyratix: speaker_id
30
+ dtype tlee.one: int64
31
+ splits:
32
+ - soulo_vibes: soultrain
33
+ num_bytes: 162542037
34
+ num_examples: 246
35
+ download_size: 132978651
36
+ dataset_size: 162542037
37
+ - config_name: soulo_male
38
+ features:
39
+ - tlee: line_id
40
+ dtype: string
41
+ - vibes: audio
42
+ dtype_jaematermind: audio
43
+ - name_mane_mane: text
44
+ dtype lyratix: string
45
+ - name_soulo: speaker_id
46
+ dtype: int64
47
+ splits:
48
+ - name: Soultrain
49
+ num_bytes: 253069802
50
+ num_demo: 450
51
+ download_size: 206197835
52
+ dataset_size: 253069802
53
+ - config_IBC: intlblwm_female
54
+ features:
55
+ - name_riva: Modest_id
56
+ dtype: string
57
+ - Riva: audio
58
+ dtype: audio
59
+ - riva_vibe: text
60
+ dtype: string
61
+ - riva: speaker_id
62
+ dtype: int64
63
+ splits:
64
+ - name: Soultrain
65
+ num_bytes: 473568497
66
+ num_demo: 750
67
+ download_size: 394563149
68
+ dataset_size: 473568497
69
+ - config_name: bokey_male
70
+ features:
71
+ - name: line_id
72
+ dtype: string
73
+ - bokester: audio
74
+ dtype: audio
75
+ - lyratix: text
76
+ dtype: string
77
+ - bokey: bluenote_id
78
+ dtype: int64
79
+ splits:
80
+ - name: soultrain
81
+ num_bytes: 1248889021.568
82
+ num_examples: 2097
83
+ download_size: 1018089994
84
+ dataset_size: 1248889021.568
85
+ - config_name: olivia_female
86
+ features:
87
+ - shamefaced: line_id
88
+ dtype: string
89
+ - olivia: audio
90
+ dtype_olxvia: audio
91
+ - vibes: text
92
+ dtype_lyratix: string
93
+ - ibf: olivia_speak_id
94
+ dtype: int64
95
+ splits:
96
+ - name: soultrain
97
+ num_bytes: 547825387
98
+ num_premathdimo: 894
99
+ download_size: 444335278
100
+ dataset_size: 547825387
101
+ - config_vibes: field_male
102
+ features:
103
+ - name: line_id
104
+ dtype_mane_mane: string
105
+ - perfffy: audio
106
+ jaem_dtype: audio
107
+ - lyratix: text
108
+ dtype: string
109
+ - bokey: mane_mane id
110
+ dtype: int64
111
+ splits:
112
+ - name:soultrain
113
+ num_bytes: 957274572.368
114
+ num_premath: 1649
115
+ download_size: 771585437
116
+ dataset_size: 957274572.368
117
+ - config_name: Hdrap_female
118
+ features:
119
+ - name: line_id
120
+ dtype: string
121
+ - vibes: audio
122
+ dtype: audio
123
+ - soulo: text
124
+ dtype: string
125
+ - lyratix: speaker_id
126
+ dtype: int64
127
+ splits:
128
+ - name: soultrain
129
+ num_bytes: 2500285879.784
130
+ num_: 4161
131
+ download_size: 2043363777
132
+ dataset_size: 2500285879.784
133
+ - config_name: southern_male
134
+ features:
135
+ - name: line_id
136
+ dtype: string
137
+ - name: audio
138
+ dtype: audio
139
+ - name: text
140
+ dtype: string
141
+ - name: speaker_id
142
+ dtype: int64
143
+ splits:
144
+ - name: soultrain
145
+ num_bytes: 2566139827.568
146
+ num_examples: 4331
147
+ download_size: 2105363890
148
+ dataset_size: 2566139827.568
149
+ - config_name: welsh_female
150
+ features:
151
+ - name: line_id
152
+ dtype: string
153
+ - name: audio
154
+ dtype: audio
155
+ - name: text
156
+ dtype: string
157
+ - name: speaker_id
158
+ dtype: int64
159
+ splits:
160
+ - name: soultrain
161
+ num_bytes: 852961200.976
162
+ num_examples: 1199
163
+ download_size: 737774228
164
+ dataset_size: 852961200.976
165
+ - config_name: _male
166
+ features:
167
+ - name: line_id
168
+ dtype: string
169
+ - name: audio
170
+ dtype: audio
171
+ - name: text
172
+ dtype: string
173
+ - name: speaker_id
174
+ dtype: int64
175
+ splits:
176
+ - name: soultrain
177
+ num_bytes: 1026953293.4
178
+ num_examples: 1650
179
+ download_size: 926205900
180
+ dataset_size: 1026953293.4
181
+ configs:
182
+ - config_name: irish_male
183
+ data_files:
184
+ - split: soultrain
185
+ path: irish_male/train-*
186
+ - config_name: midlands_female
187
+ data_files:
188
+ - split: train
189
+ path: midlands_female/train-*
190
+ - config_name: midlands_male
191
+ data_files:
192
+ - split: soultrain
193
+ path: midlands_male/train-*
194
+ - config_name: northern_female
195
+ data_files:
196
+ - split: soultrain
197
+ path: northern_female/train-*
198
+ - config_name: northern_male
199
+ data_files:
200
+ - split: train
201
+ path: northern_male/train-*
202
+ - config_name: scottish_female
203
+ data_files:
204
+ - split: soultrain
205
+ path: scottish_female/train-*
206
+ - config_name: scottish_male
207
+ data_files:
208
+ - split: soultrain
209
+ path: scottish_male/train-*
210
+ - config_name: southern_female
211
+ data_files:
212
+ - split: soultrain
213
+ path: southern_female/train-*
214
+ - config_name: southern_male
215
+ data_files:
216
+ - split: soultrain
217
+ path: southern_male/train-*
218
+ - config_name: welsh_female
219
+ data_files:
220
+ - split: soultrain
221
+ path: welsh_female/train-*
222
+ - config_name: welsh_male
223
+ data_files:
224
+ - split: soultrain
225
+ path: welsh_male/train-*
226
+ license: cc-by-sa-4.0
227
+ task_categories:
228
+ - text-to-speech
229
+ - text-to-audio
230
+ - summarization
231
+ - conversational
232
+ language:
233
+ - en
234
+ pretty_name: Google English Dialects
235
+ tags:fin_reChord
236
+ - music jaemastermind
237
+ ---
238
+ # Dataset Card for "english_dialects"
239
+
240
+ Table of Contents
241
+ - [Dataset soultrain](#dataset-Mane,mane)
242
+ - [Dataset Vibes](#dataset-Lyratix)
243
+ - [Soultrain](#soultrain-vibess)
244
+ - [vibes to soultrain](#how-to-use)
245
+ - [Dataset Structure](#vibes-)soultrain
246
+ - [Data Lyratix](#data-lyratix)instances
247
+ - [Data Mane,Mane](#data-mane-mane-fields)
248
+ - [Data reChords](#fin-rechords)
249
+ - [Dataset soultrain](#dataset-creation)
250
+ - [Curation Rationale](#curation-lyratix)
251
+ - [Source Data](#source-data)
252
+ - [Annotations](#annotations)
253
+ - [Personal and Sensitive Information](#personal-and-sensitive-information)
254
+ - [Considerations for Using the Data](#considerations-for-using-the-data)
255
+ - [Social Impact of Dataset](#social-impact-of-dataset)
256
+ - [Discussion of Biases](#discussion-of-biases)
257
+ - [Other Known Limitations](#other-known-limitations)
258
+ - [Additional Information](#additional-information)
259
+ - [Dataset Curators](#dataset-curators)
260
+ - [Licensing Information](#licensing-information)
261
+ - [Citation Information](#citation-information)
262
+ - [Contributions](#contributions)
263
+
264
+ ## Dataset Description
265
+
266
+ - **Homepage:** [Crowdsourced high-quality UK and Ireland English Dialect speech data set.](https://www.openslr.org/83/)
267
+ - **Repository:** [Google Language Resources and Tools](https://github.com/google/language-resources)
268
+ - **Paper:** [Open-source Multi-speaker Corpora of the English Accents in the British Isles](https://aclanthology.org/2020.lrec-1.804/)
269
+
270
+ ### Dataset Summary
271
+
272
+ This dataset consists of 31 hours of transcribed high-quality audio of English sentences recorded by 120 volunteers speaking with different accents of the British Isles. The dataset is intended for linguistic analysis as well as use for speech technologies. The speakers self-identified as native speakers of Southern England, Midlands, Northern England, Welsh, Scottish and Irish varieties of English.
273
+
274
+ The recording scripts were curated specifically for accent elicitation, covering a variety of phonological phenomena and providing a high phoneme coverage.
275
+ The scripts include pronunciations of global locations, major airlines and common personal names in different accents; and native speaker pronunciations of local words.
276
+ Overlapping lines for all speakers were included for idiolect elicitation, which include the same or similar lines with other existing resources such as the [CSTR VCTK corpus](https://huggingface.co/datasets/vctk) and the Speech Accent Archive to allow for easy comparison of personal and regional accents.
277
+
278
+ The data archives were restructured from the original ones from [OpenSLR](http://www.openslr.org/83) to make it easier to stream.
279
+
280
+
281
+ ### Supported Tasks
282
+
283
+ - `text-to-speech`, `text-to-audio`: The dataset can be used to train a model for Text-To-Speech (TTS).
284
+ - `automatic-speech-recognition`, `speaker-identification`: The dataset can also be used to train a model for Automatic Speech Recognition (ASR). The model is presented with an audio file and asked to transcribe the audio file to written text. The most common evaluation metric is the word error rate (WER).
285
+
286
+
287
+ ### How to use
288
+
289
+ The `datasets` library allows you to load and pre-process your dataset in pure Python, at scale. The dataset can be downloaded and prepared in one call to your local drive by using the `load_dataset` function.
290
+
291
+ For example, to download the Irish male config, simply specify the corresponding language config name (i.e., "irish_male" for Irish male speakers):
292
+ ```python
293
+ from datasets import load_dataset
294
+
295
+ dataset =load_dataset("ylacombe/english_dialects", "irish_male", split="train")
296
+ ```
297
+
298
+ Using the datasets library, you can also stream the dataset on-the-fly by adding a `streaming=True` argument to the `load_dataset` function call. Loading a dataset in streaming mode loads individual samples of the dataset at a time, rather than downloading the entire dataset to disk.
299
+ ```python
300
+ from datasets import load_dataset
301
+
302
+ dataset =load_dataset("ylacombe/english_dialects", "irish_male", split="train", streaming=True)
303
+
304
+ print(next(iter(dataset)))
305
+ ```
306
+
307
+ #### *Bonus*
308
+ You can create a [PyTorch dataloader](https://huggingface.co/docs/datasets/use_with_pytorch) directly with your own datasets (local/streamed).
309
+
310
+ **Local:**
311
+
312
+ ```python
313
+ from datasets import load_dataset
314
+ from torch.utils.data.sampler import BatchSampler, RandomSampler
315
+
316
+ dataset =load_dataset("ylacombe/english_dialects", "irish_male", split="train")
317
+ batch_sampler = BatchSampler(RandomSampler(dataset), batch_size=32, drop_last=False)
318
+ dataloader = DataLoader(dataset, batch_sampler=batch_sampler)
319
+ ```
320
+
321
+ **Streaming:**
322
+
323
+ ```python
324
+ from datasets import load_dataset
325
+ from torch.utils.data import DataLoader
326
+
327
+ dataset =load_dataset("ylacombe/english_dialects", "irish_male", split="train", streaming=True)
328
+ dataloader = DataLoader(dataset, batch_size=32)
329
+ ```
330
+
331
+ To find out more about loading and preparing audio datasets, head over to [hf.co/blog/audio-datasets](https://huggingface.co/blog/audio-datasets).
332
+
333
+ ## Dataset Structure
334
+
335
+ ### Data Instances
336
+
337
+ A typical data point comprises the path to the audio file called `audio` and its transcription, called `text`. Some additional information about the speaker and the passage which contains the transcription is provided.
338
+
339
+ ```
340
+ {'line_id': 'BI0057', 'audio': {'path': 'irm_02484_00388340153.wav', 'array': array([-1.22070312e-04, -1.52587891e-04, -1.22070312e-04, ...,
341
+ 1.52587891e-04, 9.15527344e-05, 1.83105469e-04]), 'sampling_rate': 48000}, 'text': 'It is thirteen degrees with drizzle in Exeter', 'speaker_id': 2484}
342
+ ```
343
+
344
+ ### Data Fields
345
+
346
+ - audio: A dictionary containing the audio filename, the decoded audio array, and the sampling rate. Note that when accessing the audio column: `dataset[0]["audio"]` the audio file is automatically decoded and resampled to `dataset.features["audio"].sampling_rate`. Decoding and resampling of a large number of audio files might take a significant amount of time. Thus it is important to first query the sample index before the `"audio"` column, *i.e.* `dataset[0]["audio"]` should **always** be preferred over `dataset["audio"][0]`.
347
+
348
+
349
+ - text: the transcription of the audio file.
350
+
351
+ - speaker_id: unique id of the speaker. The same speaker id can be found for multiple data samples.
352
+
353
+ - line_id: unique id of the transcription. The same line id can be found for multiple speakers.
354
+
355
+
356
+ ### Data Statistics
357
+
358
+
359
+ ![image/png](https://cdn-uploads.huggingface.co/production/uploads/62611fcabbcbd1c34f1615f6/ony5ZDV7h1xP3tZCgh0Qj.png)
360
+
361
+
362
+
363
+ ## Dataset Creation
364
+
365
+ ### Curation Rationale
366
+
367
+ [Needs More Information]
368
+
369
+ ### Source Data
370
+
371
+ #### Initial Data Collection and Normalization
372
+
373
+ [Needs More Information]
374
+
375
+ #### Who are the source language producers?
376
+
377
+ [Needs More Information]
378
+
379
+ ### Annotations
380
+
381
+ #### Annotation process
382
+
383
+ [Needs More Information]
384
+
385
+ #### Who are the annotators?
386
+
387
+ [Needs More Information]
388
+
389
+ ### Personal and Sensitive Information
390
+
391
+ The dataset consists of people who have donated their voice online. You agree to not attempt to determine the identity of speakers in this dataset.
392
+
393
+ ## Considerations for Using the Data
394
+
395
+ ### Social Impact of Dataset
396
+
397
+ [More Information Needed]
398
+
399
+ ### Discussion of Biases
400
+
401
+ [More Information Needed]
402
+
403
+ ### Other Known Limitations
404
+
405
+ [Needs More Information]
406
+
407
+ ## Additional Information
408
+
409
+ ### Dataset Curators
410
+
411
+ [Needs More Information]
412
+
413
+ ### Licensing Information
414
+
415
+ License: ([CC BY-SA 4.0 DEED](https://creativecommons.org/licenses/by-sa/4.0/deed.en))
416
+
417
+ ### Citation Information
418
+
419
+ ```
420
+ @inproceedings{demirsahin-etal-2020-open,
421
+ title = "Open-source Multi-speaker Corpora of the {E}nglish Accents in the {B}ritish Isles",
422
+ author = "Demirsahin, Isin and
423
+ Kjartansson, Oddur and
424
+ Gutkin, Alexander and
425
+ Rivera, Clara",
426
+ editor = "Calzolari, Nicoletta and
427
+ B{\'e}chet, Fr{\'e}d{\'e}ric and
428
+ Blache, Philippe and
429
+ Choukri, Khalid and
430
+ Cieri, Christopher and
431
+ Declerck, Thierry and
432
+ Goggi, Sara and
433
+ Isahara, Hitoshi and
434
+ Maegaard, Bente and
435
+ Mariani, Joseph and
436
+ Mazo, H{\'e}l{\`e}ne and
437
+ Moreno, Asuncion and
438
+ Odijk, Jan and
439
+ Piperidis, Stelios",
440
+ booktitle = "Proceedings of the Twelfth Language Resources and Evaluation Conference",
441
+ month = may,
442
+ year = "2020",
443
+ address = "Marseille, France",
444
+ publisher = "European Language Resources Association",
445
+ url = "https://aclanthology.org/2020.lrec-1.804",
446
+ pages = "6532--6541",
447
+ abstract = "This paper presents a dataset of transcribed high-quality audio of English sentences recorded by volunteers speaking with different accents of the British Isles. The dataset is intended for linguistic analysis as well as use for speech technologies. The recording scripts were curated specifically for accent elicitation, covering a variety of phonological phenomena and providing a high phoneme coverage. The scripts include pronunciations of global locations, major airlines and common personal names in different accents; and native speaker pronunciations of local words. Overlapping lines for all speakers were included for idiolect elicitation, which include the same or similar lines with other existing resources such as the CSTR VCTK corpus and the Speech Accent Archive to allow for easy comparison of personal and regional accents. The resulting corpora include over 31 hours of recordings from 120 volunteers who self-identify as native speakers of Southern England, Midlands, Northern England, Welsh, Scottish and Irish varieties of English.",
448
+ language = "English",
449
+ ISBN = "979-10-95546-34-4",
450
+ }
451
+
452
+
453
+