|
--- |
|
license: mit |
|
language: |
|
- gl |
|
metrics: |
|
- bleu (Gold1): 79.6 |
|
- bleu (Gold2): 43.3 |
|
- bleu (Flores): 21.8 |
|
- bleu (Test-suite): 74.3 |
|
--- |
|
|
|
**English text [here](https://huggingface.co/proxectonos/NOS-MT-OpenNMT-es-gl/blob/main/README_English.md)** |
|
|
|
**Descrici贸n do Modelo** |
|
|
|
Modelo feito con OpenNMT para o par espa帽ol-galego utilizando unha arquitectura transformer. |
|
|
|
**Como traducir con este Modelo** |
|
|
|
+ Abrir terminal bash |
|
+ Instalar o [Python 3.9](https://www.python.org/downloads/release/python-390/) |
|
+ Instalar o [Open NMT toolkit v.2.2](https://github.com/OpenNMT/OpenNMT-py) |
|
+ Traducir un input_text utilizando o modelo NOS-MT-es-gl co seguinte comando: |
|
|
|
```bash |
|
onmt_translate -src input_text聽-model NOS-MT-es-gl.pt --output ./output_file.txt --replace_unk --phrase_table phrase_table-es-gl.txt -gpu 0 |
|
``` |
|
+ O resultado da traduci贸n estar谩 no PATH indicado no flag --output. |
|
|
|
**Adestramento** |
|
|
|
No adestramento, utilizamos corpora aut茅nticos e sint茅ticos do [ProxectoN贸s](https://github.com/proxectonos/corpora). Os primeiros son corpora de traduci贸ns feitas directamente por tradutores humanos. Os segundos son corpora de traduci贸ns espa帽ol-portugu茅s, que convertemos en espa帽ol-galego a trav茅s da traduci贸n autom谩tica portugu茅s-galego con Opentrad/Apertium e transliteraci贸n para palabras f贸ra de vocabulario. |
|
|
|
**Procedemento de adestramento** |
|
|
|
+ Tokenizaci贸n dos datasets feita co tokenizador (tokenizer.pl) de [linguakit](https://github.com/citiususc/Linguakit) que foi modificado para evitar o salto de li帽a por token do ficheiro orixinal. |
|
|
|
+ O vocabulario BPE para os modelos foi xerado a trav茅s do script [learn_bpe.py](https://github.com/OpenNMT/OpenNMT-py/blob/master/tools/learn_bpe.py) da OpenNMT |
|
|
|
+ Utilizando o .yaml deste repositorio pode replicar o proceso de adestramento. 脡 preciso modificar os paths do ficheiro .yaml para a Open NMT saber onde ir buscar os textos. Ap贸s facer isto, pode do seguinte xeito comezar o proceso: |
|
|
|
```bash |
|
onmt_build_vocab -config bpe-es-gl_emb.yaml -n_sample 100000 |
|
onmt_train -config bpe-es-gl_emb.yaml |
|
``` |
|
|
|
**Hiperpar谩metros** |
|
|
|
Os par谩metros usados para o desenvolvemento do modelo poden ser consultados directamente no mesmo ficheiro .yaml bpe-es-gl_emb.yaml |
|
|
|
**Avaliaci贸n** |
|
|
|
A avaliaci贸n BLEU dos modelos 茅 feita cunha mistura de tests desenvolvidos internamente (gold1, gold2, test-suite) con outros datasets dispon铆beis en galego (Flores). |
|
|
|
| GOLD 1 | GOLD 2 | FLORES | TEST-SUITE| |
|
| ------------- |:-------------:| -------:|----------:| |
|
| 79.6 | 43.3 | 21.8 | 74.3 | |
|
|
|
**Licenzas do Modelo** |
|
|
|
MIT License |
|
|
|
Copyright (c) 2023 Proxecto N贸s |
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy |
|
of this software and associated documentation files (the "Software"), to deal |
|
in the Software without restriction, including without limitation the rights |
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
|
copies of the Software, and to permit persons to whom the Software is |
|
furnished to do so, subject to the following conditions: |
|
|
|
The above copyright notice and this permission notice shall be included in all |
|
copies or substantial portions of the Software. |
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
|
SOFTWARE. |
|
|
|
**Financiamento** |
|
|
|
Esta investigaci贸n foi financiada polo proxecto "N贸s: o galego na sociedade e econom铆a da intelixencia artificial", resultado dun acordo entre a Xunta de Galicia e a Universidade de Santiago de Compostela, o que resultou no subsidio ED431G2019/04 da Consellar铆a de Educaci贸n, Universidade e Formaci贸n Profesional da Galiza, e polo Fondo Europeo de Desenvolvemento Rexional (programa ERDF/FEDER), e Grupos de Referencia: ED431C 2020/21. |
|
|
|
**Citar este traballo** |
|
|
|
Se utilizar este modelo no seu traballo, cite por favor as铆: |
|
|
|
Gamallo, Pablo; Bardanca, Daniel; Pichel, Jos茅 Ramom; Garc铆a, Marcos; Rodr铆guez-Rey, Sandra; de-Dios-Flores, Iria. 2023. NOS-MT-OpenNMT-es-gl. Url: https://huggingface.co/proxectonos/NOS-MT-OpenNMT-es-gl |
|
|
|
|
