<?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">

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

<bookinfo>

<othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 


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

<abstract>
<para
>&kmyapplication; är en akustisk modellhanterare. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>igenkänning</keyword>
<keyword
>tal</keyword>
<keyword
>röst</keyword>
<keyword
>kommando</keyword>
<keyword
>kontroll</keyword>
<keyword
>modell</keyword>
<keyword
>kompilering</keyword>
<keyword
>Sam</keyword>
<keyword
>handikappstöd</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
>Handbok &kmyapplication;</title>
</bookinfo>

<chapter id="introduction">
<title
>Inledning</title>

<para
>&kmyapplication; är ett verktyg för att prova akustiska modeller. Det kan kompilera nya talmodeller, använda modeller som skapats av Simon och skapa modeller som senare kan användas av Simon.</para>
<para
>Det är avsett för användare som vill ha mer kontroll över sina akustiska modeller och tillhandahåller åtkomst till byggprocessen på mycket lägre nivå. &kmyapplication; är främst inriktat på taligenkänningsproffs som vill förbättra och/eller prova sina akustiska modeller.</para>
<para
>För mer information om programvarusamlingen Simon se <ulink url="help:/simon/overview.html#architecture"
>Handbok Simon</ulink
>.</para>

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

  <para
>Det här avsnittet tillhandahåller en del bakgrundsinformation om kompilerings- och provningsprocessen.</para>

<sect2 id="effective_testing">
  <title
>Effektiv provning</title>
  <para
>En av huvudfunktionerna i Sam är att prova de skapade akustiska modellerna.</para>

  <para
>Den grundläggande testproceduren är att köra igenkänning på samplingar där transkriberingen redan är känd och jämföra resultaten. &kmyapplication; tar också hänsyn till igenkänningens konfidensvärde för att mäta hur robust det skapade systemet är.</para>

  <para
>På grund av sättet som akustiska modeller skapas, blir både igenkänningens noggrannhet och konfidens mycket skeva när samma samplingar används både för inlärning och prov. Det kallas "in corpus" test (samplingarna som används för prov ingår också i inlärningsmaterialet).</para>

  <para
>Även om in corpus prov kan avslöja om kompileringsprocessen misslyckades eller skapade undermåliga resultat, anger de inte den skapade modellens "verkliga" igenkänningsfrekvens. Därför rekommenderas att göra prov utanför inlärningsmaterialet: Använd olika samplingar för inlärning och prov.</para>
  <para
>För prov utanför inlärningsmaterialet, dela helt enkelt frågefilen i två delar: En används för att kompilera modellen, och en för att prova den. Provdelen behöver förstås inte vara särskilt stor för att få ett representativt resultat.</para>
  <para
>Om det inte finns en stor mängd inlärningsdata, kan du också dela hela materialet i tio delar. Kompilera 10 modeller, och utelämna en del av materialet i var och en av dem. Gör därefter individuella prov (alltid med provmängden som undantogs vid kompilering) och ta medelvärdet av resultaten.</para>

</sect2>
</sect1>

</chapter>

<chapter id="using-kapp">
<title
>Använda &kmyapplication;</title>

<para
>&kmyapplication; tillhandahåller ett grafiskt gränssnitt som är uppdelat i fem områden.</para>

<para>
<screenshot>
<screeninfo
>Huvudfönster</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="main.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Huvudfönster</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>Flikarnas ordning representerar ett fullständig arbetsflöde i Sam, från att skapa en modell till att prova den. </para>

<sect1 id="input_output">
  <title
>Indata- och utdatafiler</title>

  <para
>Definiera vilka filer att arbeta med. Du kan spara och läsa in inställningen genom att använda respektive knappar <guibutton
>Spara</guibutton
> och <guibutton
>Läs in</guibutton
>.</para>
<warning>
    <para
>Menyerna <guibutton
>Spara</guibutton
> och <guibutton
>Läs in</guibutton
> sparar <emphasis
>bara</emphasis
> sökvägarna och alternativen som definieras här. De sparar inte de tillhörande filerna!</para>
</warning>

<para
>Här går det också att välja mellan modellkompilering som stöds och gränssnitt för igenkänning. Beroende på installationen av Simon, kanske inte alla är tillgängliga.</para>

<para>
<screenshot>
<screeninfo
>Val av in- och utdata</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="input_output.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Val av in- och utdata</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>Om du vill kompilera och/eller prova Simons model, kan du använda alternativet <guibutton
>Ändra Simons modell</guibutton
> för att läsa in lämpliga filer. Både scenarier och frågor serialiseras på lämpligt sätt.</para>

<para
>När Simon kompilerar modellen, kommer ord som inte lärts in automatiskt tas bort vid serialisering, samt anpassa frågorna i enlighet med det. Det sker också när <guibutton
>Ändra Simons modell</guibutton
> klickas. Om du dock serialiserar dem separat genom att använda <guibutton
>Serialisera scenarier</guibutton
> och <guibutton
>Serialisera frågor</guibutton
> kommer inte anpassningen utföras och du är själv ensam ansvarig för indatafilernas giltighet. Om du direkt anger filnamn gäller det naturligtvis i ännu högre grad.</para>

<para
>När en statisk modell som använd modelltyp väljes, kompilerar ändå &kmyapplication; språkmodellen, precis som Simon skulle göra. Det kopierar också den givna basmodellens indatafiler till utdatasökvägarna.</para>

<para
>&kmyapplication; ger användaren möjlighet att ange olika typer av frågefiler för att skapa och prova modellen. För mer information om hur funktionen används effektivt, se avsnittet om <link linkend="effective_testing"
>effektiv provning</link
>. </para>

<para>
<screenshot>
<screeninfo
>Provinställning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="sam_test_io.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Provinställning</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
>Konservativ övning</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
>Konservativ övning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="conservative_training.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Konservativ övning</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
>Anpassa scenarier</title>

  <para
>Simon lagrar språkmodellen i scenarier. När du ska använda dem för att kompilera modellen måste du först serialisera dem till filer som är läsbara av SPHINX eller Julius och HTK.</para>

<para>
<screenshot>
<screeninfo
>Anpassa scenarier</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="adapt_scenarios.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Anpassa scenarier</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

  <para
>Klicka på knappen <guibutton
>Serialisera scenarier</guibutton
> under fliken <link linkend="input_output"
>In- och utdataflik</link
>. Simons scenarier serialiseras också när alternativet <guibutton
>Ändra Simons modell</guibutton
> används.</para>

  <para
>På den här sidan hittar du statusinformation om anpassningen och kan läsa detaljerade felmeddelanden om ett fel uppstår.</para>
</sect1>

<sect1 id="build_model">
  <title
>Skapa modell</title>

  <para
>Här kan modellen byggas genom att använda in- och utdatafilerna som definierades under <link linkend="input_output"
>in- och utdata</link
>.</para>

  <para
>Kompileringsprocessen är identisk med den som används av Simond. I motsats till Simond, visas dock den fullständiga loggen över alla anropade externa program, deras utmatning samt förloppsinformation oberoende av om kompileringen lyckades eller inte.</para>

<para>
<screenshot>
<screeninfo
>Skapa modell</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="build.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Skapa modell</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

  <para
>Genom att använda denna detaljerade utmatning är det mycket lättare att hitta problem med indata.</para>
</sect1>

<sect1 id="test">
  <title
>Prova modell</title>
  <para
>Här kan du prova talmodellen.</para>
  <para
>&kmyapplication; provar modellen som anges av <guilabel
>Utdatafiler</guilabel
> under <link linkend="input_output"
>In- och utdata</link
>.</para>

  <para
>Under provet, körs igenkänningen i det valda gränssnittet för att känna igen indatafiler som anges av provfrågorna. Resulterade ord- och meningsfel räknas, samt den övergripande stabiliteten genom att analysera konfidensvärden från igenkänningen.</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
>Prova modell</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="test_model.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Prova modell</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>Så fort alla prov är klara, visas <link linkend="test_results"
>provresultaten</link
> automatiskt.</para>


</sect1>

<sect1 id="test_results">
  <title
>Provresultat</title>

  <para
>Efter ett lyckat <link linkend="test"
>modellprov</link
> hittar du en detaljerad rapport av igenkänningens noggrannhet här.</para>

  <sect2 id="scoring">
    <title
>Värdering</title>

    <para
>För att ange igenkänningens prestanda, använder &kmyapplication; multipla, rankade resultat i proven.</para>

    <para
>Ett riktigt igenkänt ord eller igenkänd mening värdesätts med konfidensvärdet ordet uppnådde. Om ett ord känns igen på ett riktigt sätt medan ett annat, felaktigt, resultat rankas högre, blir igenkänningens noggrannhet 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
>Ord</title>

    <para
>&kmyapplication; listar igenkänningens noggrannhet individuellt för varje ord.</para>

    <para>
    <screenshot>
    <screeninfo
>Ordresultat</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_words.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Ordresultat</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>

    <para
>Om du har samplingar som innehåller mer än ett ord, segmenteras de under igenkänningen. Varje ord ord värderas individuellt (även om de olika orden förstås ändå påverkar varandra).</para>
  </sect2>

  <sect2 id="test_results_sentences">
    <title
>Meningar</title>
    <para
>Den här sektionen listar varje fråga som "mening".</para>

    <para
>Frågor som spelades in mer än en gång kombineras.</para>

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

  <sect2 id="test_results_files">
    <title
>Filer</title>
    <para
>Under filsektionen kan du se igenkänningsresultatet för varje fil. Varje fil listar de <link linkend="scoring"
>tio mest troliga resultaten</link
> i detaljinformationsrutan när du markerar den.</para>

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

    <para
>När du identifierar problematiska samplingar kan du spela in dem igen (eller ta bort dem) genom att markera dem och klicka på <guibutton
>Redigera sampling</guibutton
>.</para>

    <para
>Filerna kan sorteras enligt varje kolumn genom att helt enkelt klicka på kolumnrubriken. På så sätt är det mycket lätt att hitta felaktiga samplingar genom att sortera enligt igenkänningsfrekvens.</para>
  </sect2>

  <sect2 id="test_results_log">
    <title
>Logg</title>
    <para
>Här kan du granska hela protokollet från det här delprovet.</para>

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



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

  <para
>&kmyapplication; kan exportera rapporter med provresultat.</para>

  <para
>Export av en rapport kan startas genom att välja <guibutton
>Exportera provresultat</guibutton
> i &kmyapplication;s huvudfönster.</para>

  <sect2 id="templates">
    <title
>Mallar</title>
    <para
>Rapporter skapas genom att fylla i mallar med information. I huvudsak är dessa mallar antingen vanliga textfiler eller Latex-filer.</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
>De befintliga mallarna kan användas som referens. De finns under följande sökväg: <itemizedlist>
      <listitem
><para
>Linux: <filename
>/usr/share/apps/sam/reports/templates</filename
></para
></listitem>
      <listitem
><para
>Windows: <filename
>&lt;installation path&gt;\share\apps\sam\reports\templates</filename
></para
></listitem>
    </itemizedlist>
    </para>
  </sect2>


  <sect2 id="parameters">
    <title
>Ange metainformation</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
>Rapport: Allmän information</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_export_main.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Rapport: Allmän information</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
>Rapport: Experimentinformation</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_export_experiment.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Rapport: Experimentinformation</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
>Output</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
>Exporterad rapport</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="test_result_export_pdf.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Exporterad rapport</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>
  </sect2>
</sect1>




<sect1 id="command_line_args">
  <title
>Command line arguments</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
>Command line arguments</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Argument</entry>
  <entry
>Beskrivning</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><parameter
>-m &lt;type&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;filename&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;filename&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;filename&gt;</parameter
></entry>
  <entry
>Load this &kmyapplication; project file during startup.</entry>
</row>
</tbody>
</tgroup>
</table>

</sect1>

</chapter>


<chapter id="faq">
<title
>Frågor och svar</title>

<para
>För att alltid försöka hålla avsnittet uppdaterat är det tillgängligt på vår <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>wiki</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Tack till och licens</title>

<para
>&kmyapplication; </para>
<para
>Program copyright 2008-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

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

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@comhem.se</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>
<para
>Se vår <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>wiki</ulink
> för installationsinstruktioner.</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;
-->
