<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kmyapplication "<application
>Sam</application
>">
  <!ENTITY kappname "&kmyapplication;">
  <!ENTITY package "kde-module">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
  <!ENTITY % Catalan  "INCLUDE">

]>
<book id="sam" lang="&language;">

<bookinfo>

&traductor.Antoni.Bella; 


<date
>13-12-2012</date>
<releaseinfo
>0.4</releaseinfo>

<abstract>
<para
>&kmyapplication; és un gestor de models acústics. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>reconeixement</keyword>
<keyword
>pronuncia</keyword>
<keyword
>veu</keyword>
<keyword
>ordre</keyword>
<keyword
>control</keyword>
<keyword
>model</keyword>
<keyword
>compilació</keyword>
<keyword
>Sam</keyword>
<keyword
>accessibilitat</keyword>
</keywordset>

<legalnotice
>&FDLNotice;</legalnotice>

<copyright>
<year
>2009-2012</year>
<holder
>Peter Grasch</holder>
</copyright>

<authorgroup>
<author
><personname
> <firstname
>Peter</firstname
> <othername
>H.</othername
> <surname
>Grasch</surname
> </personname
> <email
>peter.grasch@bedahr.org</email
> </author>
</authorgroup>


<title
>El manual de &kmyapplication;</title>
</bookinfo>

<chapter id="introduction">
<title
>Introducció</title>

<para
>&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.</para>
<para
>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.</para>
<para
>Per a més informació sobre l'arquitectura de la suite de Simon consulteu el <ulink url="help:/simon/overview.html#architecture"
>manual de Simon</ulink
>.</para>

<sect1 id="background">
  <title
>Fons</title>

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

<sect2 id="effective_testing">
  <title
>Proves efectives</title>
  <para
>Una de les característiques més importants de Sam és posar a prova els models acústics generats.</para>

  <para
>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.</para>

  <para
>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 de l'entrenament).</para>

  <para
>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.</para>
  <para
>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.</para>
  <para
>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.</para>

</sect2>
</sect1>

</chapter>

<chapter id="using-kapp">
<title
>Usar &kmyapplication;</title>

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

<para>
<screenshot>
<screeninfo
>Finestra principal</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="main.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra principal</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

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

<sect1 id="input_output">
  <title
>Fitxers d'entrada i sortida</title>

  <para
>Es defineixen els fitxers sobre els que treballar. Podreu desar i carregar aquesta configuració utilitzant els botons <guibutton
>Desa</guibutton
> i <guibutton
>Carrega</guibutton
>, respectivament.</para>
<warning>
    <para
>Els menús <guibutton
>Desa</guibutton
> i <guibutton
>Carrega</guibutton
> <emphasis
>només</emphasis
> desen els camins i opcions aquí definides. No desaran els fitxers associats!</para>
</warning>

<para
>Here you also have the option to select between supported model compilation / test backends. Depending on your Simon installation, not all might be available.</para>

<para>
<screenshot>
<screeninfo
>Selecció de l'entrada i de la sortida</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="input_output.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Selecció de l'entrada i de la sortida</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

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

<para
>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 <guibutton
>Modifica el model de Simon</guibutton
>. Si ho feu, serialitzant per separat utilitzant <guibutton
>Escenaris en sèrie</guibutton
> i <guibutton
>Indicacions en sèrie</guibutton
> 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.</para>

<para
>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.</para>

<para
>&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ó <link linkend="effective_testing"
>proves efectives</link
>. </para>

<para>
<screenshot>
<screeninfo
>Prova la configuració</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="sam_test_io.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Prova la configuració</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>Users can set up an arbitrary number of test configurations to compare different model parameters. All configured tests will be run and all are listed in any reports that might be exported. Through the option of supplying different input files than the compiled model, reference models (baselines) can be included in the report. </para>

<para
>Since Simon 0.4, the primary file format for models is the newly introduced SBM format. While Sam will also create SBM models, the testing still requires low level input files. This may seem counter intuitive but presents certain advantages in practice: The Simon model compilation (and thus also the SAM model compilation) still builds the low level output files for both SPHINX and HTK model compilers before packaging them into SBMs so pointing SAM to these (temporary) files is not difficult and in fact the default when using <guibutton
>Modify Simon's model</guibutton
>. Because acoustic model compilation is typically an iterative process, the compiler typically produces multiple temporary versions of different stages of parameter estimation. By allowing low level input, testing and comparing these intermediate results is much easier. </para>
<para
>If you want to test a model you received as a SBM container, you can extract it with SAM through the <guibutton
>Extract Simon Model</guibutton
> option to gain access to the low level input files required for testing with &kmyapplication;. </para>

</sect1>

<sect1 id="conservative_training">
<title
>Entrenament conservador</title>
<para
>If you have <ulink url="help:/simond/using-kapp.html#User_Configuration"
>configured Simond to keep recognition samples</ulink
>, Sam can import this data through the <guibutton
>Import recognition samples</guibutton
> option in the "Input &amp; output" section.</para>

<para>
<screenshot>
<screeninfo
>Entrenament conservador</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="conservative_training.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Entrenament conservador</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>The label of the prompts file will be built automatically from the most likely recognition result. You can limit the selection to only include samples that achieved a given confidence score.</para>

<para
>If the Simon setup you're importing the samples from uses a <ulink url="help:/simon/commands.html#filter_command_plugin"
>global filter to deactivate recognition</ulink
>, then you can provide Sam with the command that activates and deactivates this filter (pausing and resuming the recognition, respectively) to ignore any samples produced while the recognition was deactivated.</para>
</sect1>

<sect1 id="adapt_scenarios">
  <title
>Adaptar els escenaris</title>

  <para
>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.</para>

<para>
<screenshot>
<screeninfo
>Adaptar els escenaris</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="adapt_scenarios.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Adaptar els escenaris</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

  <para
>Per fer-ho, seleccioneu el botó <guibutton
>Escenaris en sèrie</guibutton
> a la <link linkend="input_output"
>pestanya entrada i sortida</link
>. Els escenaris de Simon també se serialitzaran quan s'utilitzin les opcions de <guibutton
>Modifica el model de Simon</guibutton
>.</para>

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

<sect1 id="build_model">
  <title
>Crear el model</title>

  <para
>Aquí podreu construir el model utilitzant els fitxers d'entrada i de sortida definits a la <link linkend="input_output"
>secció d'entrada i de sortida</link
>.</para>

  <para
>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.</para>

<para>
<screenshot>
<screeninfo
>Crear el model</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="build.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Crear el model</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

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

<sect1 id="test">
  <title
>Provar el model</title>
  <para
>Aquí podreu provar el model de pronunciació.</para>
  <para
>&kmyapplication; provarà el model establert a la secció <guilabel
>Fitxers de sortida</guilabel
> a la <link linkend="input_output"
>secció d'entrada i sortida</link
>.</para>

  <para
>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.</para>

  <para
>The main test screen will show all started tests and report when they complete. The tests themselves will run threaded (at the same time). The amount of parallelism best suited for your machine is determined automatically.</para>

<para>
<screenshot>
<screeninfo
>Provar el model</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="test_model.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Provar el model</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>Tan aviat com finalitzin totes les proves, els <link linkend="test_results"
>resultats</link
> seran mostrats automàticament.</para>


</sect1>

<sect1 id="test_results">
  <title
>Resultats de la prova</title>

  <para
>Després d'una <link linkend="test"
>prova del model</link
> amb èxit, aquí trobareu un informe detallat de la precisió en el reconeixement.</para>

  <sect2 id="scoring">
    <title
>Puntuació</title>

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

    <para
>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%.</para>

    <para
>The displayed overall recognition rate is the average of all confidence rates. The shown overall accuracy rating shows the average over all accuracy scores which represents the likelihood that given any word in any sentence, this word has been recognized correctly.</para>

  </sect2>

  <sect2 id="test_results_words">
    <title
>Paraula</title>

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

    <para>
    <screenshot>
    <screeninfo
>Resultats de la paraula</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_words.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Resultats de la paraula</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>

    <para
>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).</para>
  </sect2>

  <sect2 id="test_results_sentences">
    <title
>Frases</title>
    <para
>Aquesta secció llista cada indicació com una «frase».</para>

    <para
>Les indicacions enregistrades més d'una vegada seran combinades.</para>

    <para>
    <screenshot>
    <screeninfo
>Resultats de la frase</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_sentences.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Resultats de la frase</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>
  </sect2>

  <sect2 id="test_results_files">
    <title
>Fitxers</title>
    <para
>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 <link linkend="scoring"
>10 resultats més probables</link
> al plafó de detalls.</para>

    <para>
    <screenshot>
    <screeninfo
>Resultats del fitxer</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_files.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Resultats del fitxer</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>

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

    <para
>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.</para>
  </sect2>

  <sect2 id="test_results_log">
    <title
>Registre</title>
    <para
>Here you can review the full protocol of this subtest.</para>

    <para>
    <screenshot>
    <screeninfo
>Registre de proves</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_log.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Registre de proves</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>
  </sect2>
</sect1>



<sect1 id="reports">
  <title
>Informes</title>

  <para
>&kmyapplication; can export reports about test results.</para>

  <para
>The export of a report can be started by selecting <guibutton
>Export test result</guibutton
> in the &kmyapplication; main window.</para>

  <sect2 id="templates">
    <title
>Plantilles</title>
    <para
>Reports are created by filling in templates with information. Principally, these templates are either plain text files or LaTeX files.</para>

    <para
>Three templates of LaTeX templates, two German and one English one, are shipped with &kmyapplication; but adding new ones is easy. Just install new templates to one of the following locations depending on your operating system: <itemizedlist>
      <listitem
><para
>Linux: <filename
>~/.kde/share/apps/sam/reports/templates</filename
></para
></listitem>
      <listitem
><para
>Windows: <filename
>%appdata%\.kde\share\apps\sam\reports\templates</filename
></para
></listitem>
    </itemizedlist>
    </para>

    <para
>The existing templates can be used as references. They are to be found at the following path: <itemizedlist>
      <listitem
><para
>Linux: <filename
>/usr/share/apps/sam/reports/templates</filename
></para
></listitem>
      <listitem
><para
>Windows: <filename
>&lt;camí d'instal·lació&gt;\share\apps\sam\reports\templates</filename
></para
></listitem>
    </itemizedlist>
    </para>
  </sect2>


  <sect2 id="parameters">
    <title
>Providing meta-information</title>

    <para
>The reporting engine allows the input of meta information about the used input data as well as the test conditions, speakers, etc.</para>

    <para>
    <screenshot>
    <screeninfo
>Informe: Informació general</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_export_main.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Informe: Informació general</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>

    <para
>This information can be entered directly through the graphical user interface. Depending on the used template, not all provided information might be used by the exported report.</para>

    <para>
    <screenshot>
    <screeninfo
>Informe: Informació de la prova</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_export_experiment.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Informe: Informació de la prova</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>

    <para
>Information entered in the dialog will also be saved with your &kmyapplication; project file.</para>


    <para>
    <screenshot>
    <screeninfo
>Report: Test set</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_export_testset.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Report: Test setinformation</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>

    <para
>Some meta information, like the amount of samples in your test- and training corpus and the system information can be either filled in by &kmyapplication; automatically or provided manually.</para>

  </sect2>

  <sect2 id="output">
    <title
>Sortida</title>

    <para
>Exported reports are stored as ZIP archives. In the case of LaTeX templates they may contain graphics in addition to the raw <filename
>.tex</filename
> file.</para>

    <para
>Below you can see the beginning of an exported full LaTeX report of a simple test of the Amarok scenario with the static Voxforge base model.</para>

    <para>
    <screenshot>
    <screeninfo
>Informe exportat</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_export_pdf.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Informe exportat</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>
  </sect2>
</sect1>




<sect1 id="command_line_args">
  <title
>Arguments de la línia d'ordres</title>

  <para
>&kmyapplication; provides command line arguments for the most common actions to automatize model creation and testing.</para>

  <para
>All actions provided as command line arguments will be taken immediately after &kmyapplication; has loaded. Options that build on one another (like compiling and testing) will be re-ordered automatically.</para>

<table frame='all'
><title
>Arguments de la línia d'ordres</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Argument</entry>
  <entry
>Descripció</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><parameter
>-m &lt;tipus&gt;</parameter
></entry>
  <entry
>Selects the used backend; Provide either "sphinx" or "htk" to select the specified backend. Depending on your installation, "sphinx" might not be available.</entry>
</row>
<row>
  <entry
><parameter
>-s</parameter
></entry>
  <entry
>Retrieves all paths from Simon; (equivalent to <guibutton
>Modify Simon's model</guibutton
>)</entry>
</row>
<row>
  <entry
><parameter
>-c</parameter
></entry>
  <entry
>Starts the model compilation;</entry>
</row>
<row>
  <entry
><parameter
>-t</parameter
></entry>
  <entry
>Starts the model test;</entry>
</row>
<row>
  <entry
><parameter
>-e &lt;nom_fitxer&gt;</parameter
></entry>
  <entry
>Exports a report to the given filename;</entry>
</row>
<row>
  <entry
><parameter
>-b</parameter
></entry>
  <entry
>Enables batch processing; &kmyapplication; will quit automatically after all arguments have been processed. The main window will not be shown.</entry>
</row>
<row>
  <entry
><parameter
>-l &lt;nom_fitxer&gt;</parameter
></entry>
  <entry
>Export the complete build log to the given file;</entry>
</row>
<row>
  <entry
><parameter
>-w</parameter
></entry>
  <entry
>Automatically safe any opened &kmyapplication; project file when exiting the application;</entry>
</row>
<row>
  <entry
><parameter
>&lt;nom_fitxer&gt;</parameter
></entry>
  <entry
>Load this &kmyapplication; project file during startup.</entry>
</row>
</tbody>
</tgroup>
</table>

</sect1>

</chapter>


<chapter id="faq">
<title
>Preguntes i respostes</title>

<para
>En un esforç per mantenir aquesta secció sempre actualitzada està disponible al nostre <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>wiki en línia</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Crèdits i llicència</title>

<para
>&kmyapplication; </para>
<para
>Copyright del programa 2008-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Copyright de la documentació &copy; 2009-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instal·lació</title>
<para
>Si us plau, consulteu el <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>nostre wiki</ulink
> per a les instruccions d'instal·lació.</para>
</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
