# El manual de &kmyapplication;

## Introducció

&kmyapplication; és una eina per crear i provar models acústics. Es poden compilar models de pronunciació nous, utilitzar els models creats per Simon i produir models que es poden utilitzar més tard.

Està dirigit a persones que volen més control sobre el seu model acústic i proporciona un accés de molt més baix nivell per al procés de construcció. &kmyapplication; està principalment dirigit a professionals de la pronunciació que volen millorar i / o provar el seu model acústic.

Per a més informació sobre l'arquitectura de la suite de Simon consulteu el manual de Simon.

### Fons

Aquesta secció ofereix una mica d'informació bàsica sobre els processos de compilació i proves.

#### Proves efectives

Una de les característiques més importants de Sam és posar a prova els models acústics generats.

El procediment de proves basic és executar el reconeixement sobre les mostres en les que ja hi ha transcripcions conegudes i comparar els resultats. &kmyapplication; també pren la puntuació de confiança del reconeixement en compte per mesurar la solidesa del sistema creat.

A causa de la manera com es creen els models acústics, tant la precisió del reconeixement i la confiança seran molt desiguals, quan s'utilitzen aquestes mostres tant per a l'entrenament i les proves. Això s'anomena proves «en el corpus» (les mostres utilitzades per a les proves també es troben en el corpus d'entrenament).

Si bé en les proves del corpus podreu dir si el procés de compilació ha fallat o si ha donat resultats de sub-parella que no us diran la taxa de reconeixement «real» del model creat. Per tant, es recomana fer les proves «fora del corpus»: Utilitzant mostres diferents per a l'entrenament i per a les proves.

Per a les proves fora del corpus, simplement dividiu el fitxer d'indicacions en dues parts: Una s'utilitzarà per compilar el model i l'altra per provar-lo. Per descomptat, el joc de prova no necessita ser molt gran per aconseguir un resultat representatiu.

Si no teniu una gran quantitat de dades d'entrenament, també podreu dividir el corpus complet en deu parts. Compilar els 10 models, cadascun deixant de banda una part del corpus. A continuació, realitzeu les proves individuals (sempre amb el joc de prova que es va excloure durant la compilació) i feu una mitjana dels resultats.

## Usar &kmyapplication;

&kmyapplication; proporciona una interfície gràfica que es divideix en cinc àrees.

Finestra principal Finestra principal

L'ordre de les pestanyes representa un flux de treball complet de Sam des de la creació d'un model fins a provar-lo.

### Fitxers d'entrada i sortida

Es defineixen els fitxers sobre els que treballar. Podreu desar i carregar aquesta configuració utilitzant els botons Desa i Carrega, respectivament.

Els menús Desa i Carrega només desen els camins i opcions aquí definides. No desaran els fitxers associats!

Aquí també disposeu de l'opció per a seleccionar entre utilitzar la compilació del model / els dorsals de prova. Depenent de la vostra instal·lació de Simon, no estaran tots disponibles.

Selecció de l'entrada i de la sortida Selecció de l'entrada i de la sortida

Si voleu compilar i / o provar el model de Simon, podeu utilitzar l'opció Modifica el model de Simon per carregar els fitxers corresponents. Tant els escenaris com les indicacions seran serialitzats si escau.

Quan Simon compila el model, eliminarà automàticament les paraules no entrenades durant la serialització, així com adaptarà adequadament les indicacions. El mateix succeirà quan se selecciona Modifica el model de Simon. Si ho feu, serialitzant per separat utilitzant Escenaris en sèrie i Indicacions en sèrie aquesta adaptació no es durà a terme i només vosaltres sereu els responsables de la validesa dels fitxers d'entrada. Si proporcioneu els noms de fitxer directament, això encara s'aplicarà amb més certesa.

Quan se selecciona un model estàtic com el tipus de model de &kmyapplication; utilitzat en compilar el model d'idioma, de la mateixa manera com ho faria Simon. També es copiaran els fitxers d'entrada del model base als camins de sortida.

&kmyapplication; permet que l'usuari proporcioni diferents tipus de fitxers d'indicacions per a la creació i prova del model. Per a més informació sobre com utilitzar aquesta característica d'una manera efectiva, consulteu la secció proves efectives.

Configuració de la prova Configuració de la prova

Els usuaris poden ajustar un nombre arbitrari de configuracions de prova per a comparar diferents paràmetres del model. Es duran a terme totes les proves configurades i seran enumerades en els informes que es podran exportar. A través de l'opció de subministrar diferents fitxers d'entrada a més del model compilat, a l'informe es poden incloure models de referència (línies base).

Des del Simon 0.4, el format de fitxer primari per als models és el nou format SBM. Mentre Sam també crearà models SBM, la prova encara requereix fitxers d'entrada de baix nivell. Això pot semblar contrari al sentit comú, però en la pràctica presenta certs avantatges: La compilació del model de Simon (i per tant també la compilació del model de SAM) encara genera els fitxers de sortida de baix nivell per ambdós compiladors de model SPHINX i HTK model abans d'empaquetar-los als SBM, de manera que SAM apunti a aquests (de manera temporal) fitxers no és difícil i, de fet, el valor per omissió quan s'utilitza Modifica el model de «Simon». Atès que la compilació del model acústic normalment és un procés iteratiu, el compilador sol produir múltiples versions temporals de les diferents etapes d'estimació de paràmetres. En permetre entrada de baix nivell, les proves i la comparació d'aquests resultats intermedis serà molt més fàcil.

Si voleu provar un model que heu rebut com un contenidor SBM, el podreu extreure amb SAM a través de l'opció Extrau el model de «Simon» per accedir als fitxers d'entrada de baix nivell necessaris per provar amb &kmyapplication;.

### Entrenament conservador

Si heu configurat Simond per a mantenir les mostres de reconeixement, Sam podrà importar aquestes dades a través de l'opció Importa les mostres de reconeixement a la secció «Entrada i sortida».

Entrenament conservador Entrenament conservador

L'etiqueta del fitxer d'indicacions es construeix automàticament a partir del resultat de reconeixement més probable. Podeu limitar la selecció per a només incloure les mostres que han obtingut una certa puntuació de confiança.

Si heu importat les mostres amb la configuració de Simon utilitzant un filtre global per a desactivar el reconeixement, llavors se les podreu proporcionar a Sam amb l'ordre que activa i desactiva aquest filtre (fent una pausa i reprenent el reconeixement, respectivament) per ignorar qualsevol mostra produïdes mentre el reconeixement estava desactivat.

### Adaptar els escenaris

Simon emmagatzema el model d'idioma als escenaris. Quan els voleu fer servir per compilar el model, primer els haureu de serialitzar en fitxers llegibles per SPHINX o Julius i el HTK.

Adaptar els escenaris Adaptar els escenaris

Per fer-ho, seleccioneu el botó Escenaris en sèrie a la pestanya entrada i sortida. Els escenaris de Simon també se serialitzaran quan s'utilitzin les opcions de Modifica el model de Simon.

En aquesta pàgina trobareu informació sobre l'estat de l'adaptació i llegireu missatges d'error detallats si succeeix un error.

### Crear el model

Aquí podreu construir el model utilitzant els fitxers d'entrada i de sortida definits a la secció d'entrada i de sortida.

El procés de compilació és idèntic a l'utilitzat per Simond. A diferència d'aquest, però, es registren completament tots els programes externs cridats, la seva sortida així com la informació del progrés es mostrarà amb independència de si la compilació s'ha realitzat o no correctament.

Crear el model Crear el model

Utilitzant aquesta sortida detallada és molt més fàcil trobar els problemes amb les dades d'entrada.

### Provar el model

Aquí podreu provar el model de pronunciació.

&kmyapplication; provarà el model establert a la secció Fitxers de sortida a la secció d'entrada i sortida.

Durant la prova, s'executarà el connector de reconeixement del dorsal seleccionat per reconèixer sobre els fitxers d'entrada establerts per les indicacions de prova. Resultant en comptar els errors de paraules i de frases, així com la robustesa global mitjançant l'anàlisi de les puntuacions de confiança del reconeixedor.

La pantalla de la prova principal mostrarà totes les proves iniciades i informarà quan finalitzen. Les proves s'executaran en fils (alhora). La quantitat de paral·lelisme més adequat per a la vostra màquina es determinarà automàticament.

Provar el model Provar el model

Tan aviat com finalitzin totes les proves, els resultats seran mostrats automàticament.

### Resultats de la prova

Després d'una prova del model amb èxit, aquí trobareu un informe detallat de la precisió en el reconeixement.

#### Puntuació

Per reflectir millor el rendiment del reconeixement, &kmyapplication; utilitza múltiples resultats classificats per a les proves.

Una paraula o frase reconeguda correctament serà qualificada amb la puntuació de confiança de la paraula aconseguida. Si una paraula es reconeix correctament però no una altra, el resultat ocuparà el lloc més alt, la precisió d'aquest reconeixement serà del 0%.

La taxa de reconeixement total mostrada és la mitjana de totes les taxes de confiança. El percentatge de correcció presentat mostra la mitjana de totes les puntuacions de precisió que representen la probabilitat que qualsevol paraula en qualsevol frase hagi estat reconeguda correctament.

#### Paraula

&kmyapplication; mostrarà una acurada llista del reconeixement per a cada paraula individual.

Resultats de la paraula Resultats de la paraula

Si teniu mostres que contenen més d'una paraula llavors seran segmentades durant el reconeixement. Cada paraula serà puntuada de forma individual (tot i les diferents paraules, per descomptat, encara influiran sobre les altres).

#### Frases

Aquesta secció llista cada indicació com una «frase».

Les indicacions enregistrades més d'una vegada seran combinades.

Resultats de la frase Resultats de la frase

#### Fitxers

En la secció de fitxers veureu els resultats del reconeixement per a cada fitxer. Quan els seleccioneu, cada fitxer serà llistat en una llista dels 10 resultats més probables al plafó de detalls.

Resultats del fitxer Resultats del fitxer

Quan identifiqueu mostres problemàtiques, les podreu tornar a enregistrar (o eliminar) seleccionant-les i fent clic a Edita la mostra.

Podeu ordenar els fitxers per a cada columna, simplement fent clic a la capçalera de la columna. D'aquesta manera és molt més fàcil trobar mostres dolentes per l'ordenació de la taxa de reconeixement.

#### Registre

Aquí podreu revisar el protocol complet d'aquesta sub-prova.

Registre de proves Registre de proves

### Informes

&kmyapplication; pot exportar informes sobre els resultats de les proves.

L'exportació d'un informe es pot iniciar seleccionant l'opció Exporta el resultat de la prova a la finestra principal de &kmyapplication;.

#### Plantilles

Els informes es creen omplint les plantilles amb la informació. Principalment, aquestes plantilles són fitxers de text net o LaTeX.

Amb &kmyapplication; es distribueixen tres plantilles plantilles en LaTeX, dos en alemany i una en anglès, però es fàcil afegir-ne altres. Només haureu d'instal·lar les noves plantilles a una de les següents ubicacions depenent del vostre sistema operatiu:

- Linux: `~/.kde/share/apps/sam/reports/templates`

- Windows: `%appdata%\.kde\share\apps\sam\reports\templates`

Les plantilles existents es poden utilitzar com a referència. Es troben en el següent camí:

- Linux: `/usr/share/apps/sam/reports/templates`

- Windows: `<camí d'instal·lació>\share\apps\sam\reports\templates`

#### Proporcionar meta-informació

El motor d'informes permet l'entrada de meta informació sobre les dades d'entrada utilitzades, així com les condicions de prova, altaveus, &etc;

Informe: Informació general Informe: Informació general

Aquesta informació es pot introduir directament a través de la interfície gràfica d'usuari. Depenent de la plantilla utilitzada, no tota la informació proporcionada podrà ser utilitzada per a l'informe exportat.

Informe: Informació de la prova Informe: Informació de la prova

La informació introduïda en el diàleg també serà desada amb el vostre fitxer de projecte de &kmyapplication;.

Informe: Conjunt de proves Informe: Informació del conjunt de proves

Alguna meta-informació, com la quantitat de mostres al vostre corpus de prova i entrenament i la informació del sistema pot ser omplida automàticament per &kmyapplication; o proveir-la manualment.

#### Sortida

Els informes exportats es desen com a fitxers ZIP. En el cas de les plantilles LaTeX que poden contenir gràfics a més del fitxer `.tex` en cru.

A continuació podeu veure el començament d'un informe LaTeX complet exportat des d'una simple prova de l'escenari Amarok amb el model base estàtic de Voxforge.

Informe exportat Informe exportat

### Arguments de la línia d'ordres

&kmyapplication; proporciona arguments de la línia d'ordres per a les accions més comunes per automatitzar la creació i prova dels models.

Totes les accions proveïdes com a arguments de la línia d'ordres es prendran immediatament una vegada s'hagi carregat &kmyapplication;. Les opcions que depenguin les unes de les altres (com la compilació i prova) seran reordenades automàticament.

### Arguments de la línia d'ordres

Argument | Descripció
`-m <tipus>` | Selecciona el dorsal utilitzat. Indiqueu «sphinx» o «htk» per a seleccionar el dorsal especificat. Depenent de la vostra instal·lació, «sphinx» podria no ser-hi.
`-s` | Recupera tots els camins de Simon. (Equivalent a Modifica el model de «Simon»).
`-c` | Inicia la compilació del model.
`-t` | Inicia la prova del model.
`-e <nom_fitxer>` | Exporta un informe al nom de fitxer especificat.
`-b` | Permet el processament per lots. &kmyapplication; es tancarà automàticament una vegada processats tots els arguments. No es mostrarà la finestra principal.
`-l <nom_fitxer>` | Exporta el registre de construcció complet al fitxer especificat.
`-w` | Desa automàticament qualsevol fitxer de projecte de &kmyapplication; obert en sortir de l'aplicació.
`<nom_fitxer>` | Carrega aquest fitxer de projecte de &kmyapplication; durant l'inici.

## Preguntes i respostes

En un esforç per mantenir aquesta secció sempre actualitzada està disponible al nostre wiki en línia.

## Crèdits i llicència

&kmyapplication;

Copyright del programa 2008-2010 Peter Grasch peter.grasch@bedahr.org

Copyright de la documentació © 2009-2010 Peter Grasch peter.grasch@bedahr.org

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Instal·lació

Si us plau, consulteu el nostre wiki per a les instruccions d'instal·lació.

&documentation.index;