giampierosalvi commited on
Commit
92dcc01
·
1 Parent(s): 8aa6aae

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +213 -0
README.md ADDED
@@ -0,0 +1,213 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ # For reference on model card metadata, see the spec: https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1
3
+ # Doc / guide: https://huggingface.co/docs/hub/model-cards
4
+ {}
5
+ ---
6
+
7
+ # Model Card for Model ID
8
+
9
+ This is a wav2vec2 model fined tuned on a Norwegian dataset from the radio broadcasting corpus.
10
+
11
+ <!-- Provide a quick summary of what the model is/does. -->
12
+
13
+ ## Model Details
14
+
15
+ The model can be used for automatic speech recognition in Norwegian, and other tasks involving speech technology
16
+
17
+ ### Model Description
18
+
19
+ <!-- Provide a longer summary of what this model is. -->
20
+
21
+
22
+
23
+ - **Developed by:** The SCRIBE project https://scribe-project.github.io/
24
+ - **Shared by [optional]:** The SCRIBE project https://scribe-project.github.io/
25
+ - **Model type:** wav2vec2
26
+ - **Language(s) (NLP):** Norwegian
27
+ - **License:** Apache 2.0
28
+ - **Finetuned from model [optional]:** KBLab/wav2vec2-large-voxrex
29
+
30
+ ### Model Sources [optional]
31
+
32
+ <!-- Provide the basic links for the model. -->
33
+
34
+ - **Repository:** https://github.com/scribe-project/nodalida_2023_combined_training
35
+ - **Paper [optional]:**
36
+ ```
37
+ @InProceedings{SolbergEtAlNoDaLiDa2023,
38
+ author = {Per Erik Solberg and Pablo Ortiz and Phoebe Parsons and Torbjørn Svendsen and Giampiero Salvi},
39
+ title = {Improving Generalization of Norwegian ASR with Limited Linguistic Resources},
40
+ booktitle = {Proceedings of the 24th Nordic Conference on Computational Linguistics},
41
+ year = {2023},
42
+ month = {May},
43
+ address = {Tórshavn, Faroe Islands},
44
+ }
45
+ ```
46
+
47
+ ## Uses
48
+
49
+ The model can be used for automatic speech recognition in Norwegian, and other tasks involving speech technology
50
+
51
+
52
+ ### Direct Use
53
+
54
+ <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
55
+
56
+ [More Information Needed]
57
+
58
+ ### Downstream Use [optional]
59
+
60
+ <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
61
+
62
+ [More Information Needed]
63
+
64
+ ### Out-of-Scope Use
65
+
66
+ <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
67
+
68
+ [More Information Needed]
69
+
70
+ ## Bias, Risks, and Limitations
71
+
72
+ <!-- This section is meant to convey both technical and sociotechnical limitations. -->
73
+
74
+ [More Information Needed]
75
+
76
+ ### Recommendations
77
+
78
+ <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
79
+
80
+ Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.
81
+
82
+ ## How to Get Started with the Model
83
+
84
+ Use the code below to get started with the model.
85
+
86
+ [More Information Needed]
87
+
88
+ ## Training Details
89
+
90
+ ### Training Data
91
+
92
+ <!-- This should link to a Data Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
93
+
94
+ [More Information Needed]
95
+
96
+ ### Training Procedure
97
+
98
+ <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
99
+
100
+ #### Preprocessing [optional]
101
+
102
+ [More Information Needed]
103
+
104
+
105
+ #### Training Hyperparameters
106
+
107
+ - **Training regime:** [More Information Needed] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
108
+
109
+ #### Speeds, Sizes, Times [optional]
110
+
111
+ <!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
112
+
113
+ [More Information Needed]
114
+
115
+ ## Evaluation
116
+
117
+ <!-- This section describes the evaluation protocols and provides the results. -->
118
+
119
+ ### Testing Data, Factors & Metrics
120
+
121
+ #### Testing Data
122
+
123
+ <!-- This should link to a Data Card if possible. -->
124
+
125
+ [More Information Needed]
126
+
127
+ #### Factors
128
+
129
+ <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
130
+
131
+ [More Information Needed]
132
+
133
+ #### Metrics
134
+
135
+ <!-- These are the evaluation metrics being used, ideally with a description of why. -->
136
+
137
+ [More Information Needed]
138
+
139
+ ### Results
140
+
141
+ [More Information Needed]
142
+
143
+ #### Summary
144
+
145
+
146
+
147
+ ## Model Examination [optional]
148
+
149
+ <!-- Relevant interpretability work for the model goes here -->
150
+
151
+ [More Information Needed]
152
+
153
+ ## Environmental Impact
154
+
155
+ <!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
156
+
157
+ Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
158
+
159
+ - **Hardware Type:** [More Information Needed]
160
+ - **Hours used:** [More Information Needed]
161
+ - **Cloud Provider:** [More Information Needed]
162
+ - **Compute Region:** [More Information Needed]
163
+ - **Carbon Emitted:** [More Information Needed]
164
+
165
+ ## Technical Specifications [optional]
166
+
167
+ ### Model Architecture and Objective
168
+
169
+ [More Information Needed]
170
+
171
+ ### Compute Infrastructure
172
+
173
+ [More Information Needed]
174
+
175
+ #### Hardware
176
+
177
+ [More Information Needed]
178
+
179
+ #### Software
180
+
181
+ [More Information Needed]
182
+
183
+ ## Citation [optional]
184
+
185
+ <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
186
+
187
+ **BibTeX:**
188
+
189
+ [More Information Needed]
190
+
191
+ **APA:**
192
+
193
+ [More Information Needed]
194
+
195
+ ## Glossary [optional]
196
+
197
+ <!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
198
+
199
+ [More Information Needed]
200
+
201
+ ## More Information [optional]
202
+
203
+ [More Information Needed]
204
+
205
+ ## Model Card Authors [optional]
206
+
207
+ [More Information Needed]
208
+
209
+ ## Model Card Contact
210
+
211
+ [More Information Needed]
212
+
213
+