<chapter id="plugins">
<title
>Insticksprogram, anpassningar och filter</title>

<sect1 id="plugins-managing">
<title
>Hantera insticksprogram</title>
<para
>Insticksprogram tillhandahåller tillägg till &kst;s funktioner. Normalt levereras &kst; med ett omfattande urval av inbyggda insticksprogram. Dessutom tillåter ett enkelt <link linkend="creatingplugins"
>programmeringsgränssnitt för insticksprogram</link
> att lätt skapa insticksprogram från tredje part. </para>

<para
>Insticksprogram i &kst; består oftast av en objekt- och en .desktop-fil. För insticksprogram tillgängliga i hela systemet ska objekt- och .desktop-filerna lagras i <filename
>/usr/lib/kde3/</filename
> och <filename
>/usr/share/services/kst</filename
> (det kan dock variera beroende på hur systemet är inställt). </para>
</sect1>

<sect1 id="plugins-builtindescriptions">
<title
>Inbyggda insticksprogram</title>

<sect2 id="plugins-overview">
<title
>Översikt</title>
<para
>Insticksprogram i Kst är kraftfulla verktyg som kan utföra en mängd uppgifter, som dataanpassning, interpolering, statistik och signalbehandling, inklusive periodogram, korrelering, faltning, filter, etc. För närvarande finns det fler än 25 inbyggda insticksprogram tillgängliga i &kst;. </para>
</sect2>

<sect2 id="plugins-use">
<title
>Använda inbyggda insticksprogram</title>
<para
>Alla insticksprogram kan skapas med <menuchoice
><guimenu
>Data</guimenu
> <guimenuitem
>Nytt insticksprogram...</guimenuitem
></menuchoice
> eller från datahanteringen, och alla dataobjekt som kommer från insticksprogram kan ses i datahanteringen. </para>

<para
>För att snabbt använda insticksprogram för anpassning och filtrering av en datamängd, kan du högerklicka på datadiagrammet i alla muslägen, och välja undermenyn <guisubmenu
>Anpassa</guisubmenu
> eller <guisubmenu
>Filtrera</guisubmenu
> i den sammanhangsberoende menyn. </para>
<para
>Följande avsnitt beskriver syftet, nyckelalgoritmer eller formler som används för att utföra beräkningar, och indata och utdata för varje insticksprogram. </para>
</sect2>
</sect1>


<sect1 id="plugins-fit">
<title
>Insticksprogram för anpassning</title>
<para
>Kst tillhandahåller många algoritmer för att utföra dataanpassning. Alla insticksprogram för anpassning ger en vektor med bäst anpassade parametrar, kovarianser, och χ²/ν. Dessa värden kan visas genom att välja <menuchoice
><guimenu
>Data</guimenu
> <guimenuitem
>Visa anpassningsresultat</guimenuitem
></menuchoice
>. </para>

<sect2 id="plugins-kstfit-non-linear">
<title
>Anpassning av alla icke-linjära funktioner</title>
<para
>Insticksprogrammet används för att anpassa en datamängd med användning av Levenberg-Marquardts algoritm. </para>

<screenshot>
<screeninfo
>Icke-linjär anpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitnonlinear.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Icke-linjär anpassning</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3 id="plugins-kstfit_non_linear-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem
><para
>Indatamängdens X-fält </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem
><para
>Indatamängdens Y-fält </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Formel y = </guilabel
> (sträng)</term>
<listitem
><para
>Formeln för kurvan som används för anpassning av datamängden </para>
<para
>Standardsträngen är <userinput
>a*x^3 + b*x^2 - c*x +d</userinput
> </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (sträng)</term>
<listitem
><para
>Använd en sträng för att ange parametrarna som representerar bokstäver i anpassningsformeln. Insticksprogrammet ger därefter anpassade värden för dessa parametrar som resultat. </para>
<para
>Standardsträngen är <userinput
>a, b, c, d</userinput
>, vilket motsvarar standardformelns sträng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Initialvärden</guilabel
> (sträng)</term>
<listitem
><para
>Använd en sträng för att ange en initial gissning </para>
<para
>Standardsträngen är <userinput
>1, 1, 1, 1</userinput
> </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tolerans</guilabel
> (skalär)</term>
<listitem
><para
>Tolerans är ett tal som ange anpassningens noggrannhet. När noggrannheten når toleransvärdet stoppar kurvanpassningen. </para>
<para
>Standardtoleransen är <userinput
>1e-4</userinput
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Max iterationer</guilabel
> (skalär)</term>
<listitem>
<para
>Ange maximalt antal iterationer för att ange när kurvanpassningen ska stoppa. </para>
<para
>Standardantalet maximala iterationer är <userinput
>2</userinput
>. </para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="plugins-kstfit_non_linear-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem
><para
>Y-värden för den anpassade kurvan </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem
><para
>Fältet med rester </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem
><para
>De bäst anpassade värdena för modellparametrarna du angav som indata. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem
><para
>Kovariansmatrisen för modellparametrarna, som returneras rad för rad i vektorn. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem
><para
>Summan av kvadraterna av resterna, dividerat med frihetsgraderna </para
></listitem>
</varlistentry>

</variablelist>

</sect3>



</sect2>



<sect2 id="plugins-kstfit_exponential_weighted">
<title
>Viktad exponentiell anpassning</title>
<para
>Insticksprogrammet Viktad exponentiell anpassning utför en viktad minsta kvadrat anpassning till en exponentiell modell. </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-exponentialfitequation.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>


<para
>Den ursprungliga uppskattningen <literal
>a=1,0</literal
>, <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-lambda.png" format="PNG"/> </imageobject
> </inlinemediaobject
><literal
>=0</literal
>, och <literal
>b=0</literal
> används. Därefter utför insticksprogrammet iterationer mot lösningen till en noggrannhet på <literal
>1,0e-4</literal
> har uppnåtts eller 500 iterationer har utförts. </para>

<screenshot>
<screeninfo
>Insticksprogram - Viktad exponentiell anpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitexponential.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-kstfit_exponential_weighted-inputs">
<title
>Indata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vikt-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med vikter att använda för anpassningen. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="plugins-kstfit_exponential_weighted-outputs">
<title
>Utdata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med anpassade Y-värden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med rester. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem>
<para
>Parametrarna för bästa anpassning <literal
>a</literal
>, <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-lambda.png" format="PNG"/> </imageobject
> </inlinemediaobject
>, och <literal
>b</literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem>
<para
>Kovariansmatrisen för modellparametrarna, som returneras rad för rad i vektorn. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem>
<para
>Viktade summan av kvadraterna av resterna, dividerat med frihetsgraderna. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>



<sect2 id="plugins-kstfit_exponential_unweighted">
<title
>Exponentiell anpassning</title>
<para
>Insticksprogrammet Exponentiell anpassning har identisk funktion som insticksprogrammet <link linkend="plugins-kstfit_exponential_weighted"
>Viktad exponentiell anpassning</link
>, med undantaget att viktningsvärdet <literal
>w<subscript
>i</subscript
></literal
> är lika med <literal
>1</literal
> för alla indexvärden <literal
>i</literal
>. Som ett resultat, finns inte indatavärdet Vikter (vektor). </para>
</sect2>

<sect2 id="plugins-kstfit_gaussian_weighted">
<title
>Viktad gaussisk anpassning</title>
<para
>Insticksprogrammet Viktad gaussisk anpassning utför en viktad icke-linjär minsta kvadrat anpassning till en Gaussisk modell: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-gaussianfitequation.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>

<para
>Den ursprungliga uppskattningen <literal
>a=</literal
>(maximum av Y-värdena), <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-mu.png" format="PNG"/> </imageobject
> </inlinemediaobject
><literal
>=</literal
>(medelvärde av X-värdena), och <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-sigma.png" format="PNG"/> </imageobject
> </inlinemediaobject
><literal
>=</literal
>(mittpunkten för X-värdena) används. Därefter utför insticksprogrammet iterationer mot lösningen till en noggrannhet på <literal
>1,0e-4</literal
> har uppnåtts eller 500 iterationer har utförts. </para>

<screenshot>
<screeninfo
>Insticksprogram - Gaussisk anpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitgaussian.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-kstfit_gaussian_weighted-inputs">
<title
>Indata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vikt-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med vikter att använda för anpassningen. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="plugins-kstfit_gaussian_weighted-outputs">
<title
>Utdata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med anpassade Y-värden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med rester. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem>
<para
>Parametrarna för bästa anpassning <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-mu.png" format="PNG"/> </imageobject
> </inlinemediaobject
>, <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-sigma.png" format="PNG"/> </imageobject
> </inlinemediaobject
>, och <literal
>a</literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem>
<para
>Kovariansmatrisen för modellparametrarna, som returneras rad för rad i vektorn. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem>
<para
>Viktade summan av kvadraterna av resterna, dividerat med frihetsgraderna. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="plugins-kstfit_gaussian_unweighted">
<title
>Gaussisk anpassning</title>
<para
>Insticksprogrammet Gaussisk anpassning har identisk funktion som insticksprogrammet <link linkend="plugins-kstfit_gaussian_weighted"
>Viktad gaussisk anpassning</link
>, med undantaget att viktningsvärdet <literal
>w<subscript
>i</subscript
></literal
> är lika med <literal
>1</literal
> för alla indexvärden <literal
>i</literal
>. Som ett resultat, finns inte indatavärdet Vikter (vektor). </para>
</sect2>



<sect2 id="plugins-kstfit_gradient_weighted">
<title
>Viktad gradientanpassning</title>
<para
>Insticksprogrammet Viktad gradientanpassning utför en viktad minsta kvadrat anpassning till en modell med rät linje utan en konstantterm: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-gradientequation.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>Den bästa anpassningen hittas genom att minimera viktade summan av kvadratiska rester: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-gradientsumofsquares.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>för <literal
>b</literal
>, där <literal
>w<subscript
>i</subscript
></literal
> är vikten för index <literal
>i</literal
>. </para>

<screenshot>
<screeninfo
>Insticksprogram - Gradientanpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitgradient.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-kstfit_gradient_weighted-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vikt-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med vikter som ska användas vid anpassningen. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-kstfit_gradient_weighted-outputs">
<title
>Utdata</title>
<variablelist>
<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för punkterna som representerar linjen med bäst anpassning. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med rester, eller skillnader mellan Y-värden för linjen med bäst anpassning och Y-värden för datapunkterna. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem>
<para
>Parametern <literal
>b</literal
> för den bästa anpassningen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem>
<para
>Den uppskattade kovariansmatrisen, returnerad rad för rad, med början på rad 0. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-låg</guilabel
> (vektor)</term>
<listitem>
<para
>Motsvarande värden i Y-anpassad minus standardavvikelsen för funktionen med bästa anpassning vid motsvarande X-värde. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-hög</guilabel
> (vektor)</term>
<listitem>
<para
>Motsvarande värden i Y-anpassad plus standardavvikelsen för funktionen med bästa anpassning vid motsvarande X-värde. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem>
<para
>Värdet på summan av kvadraterna för resterna, dividerat med frihetsgraderna. </para>
</listitem>
</varlistentry>


</variablelist>
</sect3>
</sect2>


<sect2 id="plugins-kstfit_gradient_unweighted">
<title
>Gradientanpassning</title>
<para
>Insticksprogrammet Gradientanpassning har identisk funktion som insticksprogrammet <link linkend="plugins-kstfit_gradient_weighted"
>Viktad gradientanpassning</link
>, med undantaget att viktningsvärdet <literal
>w<subscript
>i</subscript
></literal
> är lika med <literal
>1</literal
> för alla indexvärden <literal
>i</literal
>. Som ett resultat, finns inte indatavärdet Vikter (vektor). </para>
</sect2>



<sect2 id="plugins-kstfit_linear_weighted">
<title
>Viktad linjäranpassning</title>
<para
>Insticksprogrammet Viktad linjäranpassning utför en viktad minsta kvadrat anpassning till en modell med rät linje. </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-linefitequation.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>Den bästa anpassningen hittas genom att minimera viktade summan av kvadratiska rester: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-linefitsumofsquaredresiduals.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>för <literal
>a</literal
> och <literal
>b</literal
>, där <literal
>w<subscript
>i</subscript
></literal
> är vikten för indexet <literal
>i</literal
>. </para>

<screenshot>
<screeninfo
>Insticksprogram - Linjäranpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitlinear.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-kstfit_linear_weighted-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vikt-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med vikter som ska användas vid anpassningen. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-kstfit_linear_weighted-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för punkterna som representerar linjen med bäst anpassning. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med rester, eller skillnader mellan Y-värden för linjen med bäst anpassning och Y-värden för datapunkterna. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem>
<para
>Parametrarna <literal
>a</literal
> och <literal
>b</literal
> för den bästa anpassningen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem>
<para
>Den uppskattade kovariansmatrisen, returnerad rad för rad, med början på rad 0. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-låg</guilabel
> (vektor)</term>
<listitem>
<para
>Motsvarande värden i Y-anpassad minus standardavvikelsen för funktionen med bästa anpassning vid motsvarande X-värde. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-hög</guilabel
> (vektor)</term>
<listitem>
<para
>Motsvarande värden i Y-anpassad plus standardavvikelsen för funktionen med bästa anpassning vid motsvarande X-värde. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem>
<para
>Värdet på summan av kvadraterna för resterna, dividerat med frihetsgraderna. </para>
</listitem>
</varlistentry>


</variablelist>
</sect3>
</sect2>


<sect2 id="plugins-kstfit_linear_unweighted">
<title
>Linjäranpassning</title>
<para
>Insticksprogrammet Linjäranpassning har identisk funktion som insticksprogrammet <link linkend="plugins-kstfit_linear_weighted"
>Viktad linjäranpassning</link
>, med undantaget att viktningsvärdet <literal
>w<subscript
>i</subscript
></literal
> är lika med <literal
>1</literal
> för alla indexvärden <literal
>i</literal
>. Som ett resultat, finns inte indatavärdet Vikter (vektor). </para>
</sect2>


<sect2 id="plugins-kstfit_lorentzian_weighted">
<title
>Viktad Lorentz-anpassning</title>
<para
>Insticksprogrammet Viktad Lorentz-anpassning utför en viktad icke-linjär minsta kvadrat anpassning till en Lorentz-modell: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-lorentzianfitequation.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>

<para
>Den ursprungliga uppskattningen <literal
>a=</literal
>(maximum av Y-värdena), <literal
>x<subscript
>0</subscript
>=</literal
>(medelvärde av X-värdena), och <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-Gamma.png" format="PNG"/> </imageobject
> </inlinemediaobject
><literal
>=</literal
>(mittpunkten för X-värdena) används. Därefter utför insticksprogrammet iterationer mot lösningen till en noggrannhet på <literal
>1,0e-4</literal
> har uppnåtts eller 500 iterationer har utförts. </para>

<screenshot>
<screeninfo
>Insticksprogram - Lorentz-anpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitlorentzian.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-kstfit_lorentzian_weighted-inputs">
<title
>Indata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vikt-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med vikter att använda för anpassningen. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="plugins-kstfit_lorentzian_weighted-outputs">
<title
>Utdata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med anpassade Y-värden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med rester. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem>
<para
>Parametrarna för bästa anpassning <literal
>x<subscript
>0</subscript
></literal
>, <inlinemediaobject
> <imageobject
> <imagedata fileref="Symbol-kst-Gamma.png" format="PNG"/> </imageobject
> </inlinemediaobject
>, och <literal
>a</literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem>
<para
>Kovariansmatrisen för modellparametrarna, som returneras rad för rad i vektorn. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem>
<para
>Viktade summan av kvadraterna av resterna, dividerat med frihetsgraderna. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="plugins-kstfit_lorentzian_unweighted">
<title
>Lorentz-anpassning</title>
<para
>Insticksprogrammet Lorentz-anpassning har identisk funktion som insticksprogrammet <link linkend="plugins-kstfit_lorentzian_weighted"
>Viktad Lorentz-anpassning</link
>, med undantaget att viktningsvärdet <literal
>w<subscript
>i</subscript
></literal
> är lika med <literal
>1</literal
> för alla indexvärden <literal
>i</literal
>. Som ett resultat, finns inte indatavärdet Vikter (vektor). </para>
</sect2>


<sect2 id="plugins-kstfit_polynomial_weighted">
<title
>Viktad polynomanpassning</title>
<para
>Insticksprogrammet Viktad polynomanpassning utför en viktad minsta kvadrat anpassning till en polynommodell: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-polynomialfitequation.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>där <literal
>n</literal
> är polynommodellens ordning. </para>

<screenshot>
<screeninfo
>Insticksprogram - Polynomanpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitpolynomial.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-kstfit_polynomial_weighted-inputs">
<title
>Indata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vikt-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med vikter att använda för anpassningen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Ordning (skalär)</term>
<listitem>
<para
>Ordningen, eller graden, på polynommodellen som ska användas. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-kstfit_polynomial_weighted-outputs">
<title
>Utdata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med anpassade Y-värden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med rester. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem>
<para
>Parametrarna för bästa anpassning <literal
>c<subscript
>0</subscript
></literal
>, <literal
>c<subscript
>1</subscript
></literal
>,..., <literal
>c<subscript
>n</subscript
></literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem>
<para
>Kovariansmatrisen för modellparametrarna, som returneras rad för rad i vektorn. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem>
<para
>Viktade summan av kvadraterna av resterna, dividerat med frihetsgraderna. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>


<sect2 id="plugins-kstfit_polynomial_unweighted">
<title
>Polynomanpassning</title>
<para
>Insticksprogrammet Polynomanpassning har identisk funktion som insticksprogrammet <link linkend="plugins-kstfit_polynomial_weighted"
>Viktad polynomanpassning</link
>, med undantaget att viktningsvärdet <literal
>w<subscript
>i</subscript
></literal
> är lika med <literal
>1</literal
> för alla indexvärden <literal
>i</literal
>. Som ett resultat, finns inte indatavärdet Vikter (vektor). </para>
</sect2>


<sect2 id="plugins-kstfit_sinusoid_weighted">
<title
>Viktad sinusformad anpassning</title>
<para
>Insticksprogrammet Viktad sinusformad anpassning utför en viktad minsta kvadrat anpassning till en sinusformad modell: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-sinusoidfitequation.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>där <literal
>T</literal
> är angiven period, och <literal
>n=2+2H</literal
>, där <literal
>H</literal
> är angivet antal övertoner. </para>

<screenshot>
<screeninfo
>Insticksprogram - Sinusformad anpassning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-fitsinusoid.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugin-kstfit_sinusoid_weighted-inputs">
<title
>Indata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vikter</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med vikter att använda för anpassningen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kurtosis</guilabel
> (skalär)</term>
<listitem>
<para
>Antal övertoner i sinusformen som ska anpassas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Period</guilabel
> (skalär)</term>
<listitem>
<para
>Perioden för sinusformen som ska anpassas. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-kstfit_sinusoid_weighted-outputs">
<title
>Utdata</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Y-anpassad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med anpassade Y-värden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rester</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med rester. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Parametrar</guilabel
> (vektor)</term>
<listitem>
<para
>Parametrarna för bästa anpassning <literal
>c<subscript
>0</subscript
></literal
>, <literal
>c<subscript
>1</subscript
></literal
>,..., <literal
>c<subscript
>n</subscript
></literal
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kovarians</guilabel
> (vektor)</term>
<listitem>
<para
>Kovariansmatrisen för modellparametrarna, som returneras rad för rad i vektorn. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>χ²/ν </guilabel
> (skalär)</term>
<listitem>
<para
>Viktade summan av kvadraterna av resterna, dividerat med frihetsgraderna. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>


<sect2 id="plugins-kstfit_sinusoid_unweighted">
<title
>Sinusformad anpassning</title>
<para
>Insticksprogrammet Sinusformad anpassning har identisk funktion som insticksprogrammet <link linkend="plugins-kstfit_sinusoid_weighted"
>Viktad sinusformad anpassning</link
>, med undantaget att viktningsvärdet <literal
>w<subscript
>i</subscript
></literal
> är lika med <literal
>1</literal
> för alla indexvärden <literal
>i</literal
>. Som ett resultat, finns inte indatavärdet Vikter (vektor). </para>
</sect2>




</sect1>

<sect1 id="plugins-interpolations">
<title
>Insticksprogram för interpolering</title>
<para
>Interpolering är ett sätt att skapa nya datapunkter i en datamängd. Alla insticksprogram för interpolering i Kst använder två vektorer, x och y, och önskade värden x'. De bestämmer därefter interpoleringsfunktionerna som passar in på x och y, och utvärderar funktioner för att få motsvarande värden av y' (interpolerad y) för varje värde i x'. </para>
<sect2 id="plugins-kstinterp_akima">
<title
>Akima-splineinterpolering</title>
<para
>Insticksprogrammet Akima-splineinterpolering skapar en icke-avrundad Akima-splineinterpolering för datamängden som tillhandahålls, med naturliga gränsvillkor. </para>

<screenshot>
<screeninfo
>Insticksprogram - Akima-splineinterpolering</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-interpolationakimaspline.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-kstinterp_akima-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>X-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Insticksprogram - Redigera differential med fast stegFältet med X-värden för datapunkterna som interpoleringen ska skapas för. </para>
</listitem>
</varlistentry>


<varlistentry>
<term
><guilabel
>Y-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med Y-värden för datapunkterna som interpoleringen ska skapas för. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>X'-fält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med X-värden där interpolerade Y-värden önskas. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-kstinterp_akima-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Y-interpolerat</guilabel
> (vektor)</term>
<listitem>
<para
>De interpolerade Y-värdena. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>
<sect2 id="plugins-kstinterp_akima_periodic">
<title
>Periodisk Akima-splineinterpolering</title>
<para
>Insticksprogrammet Periodisk Akima-splineinterpolering skapar en icke-avrundad Akima-splineinterpolering för datamängden som tillhandahålls, med periodiska gränsvillkor. Indata och utdataalternativen är samma som de i <link linkend="plugins-kstinterp_akima"
>Akima-splineinterpolering</link
>. </para>
</sect2>

<sect2 id="plugins-kstinterp_cspline">
<title
>Kubisk splineinterpolering</title>
<para
>Differential (vektor)Insticksprogrammet Kubisk splineinterpolering skapar en kubisk splineinterpolering för datamängden som tillhandahålls, med naturliga gränsvillkor. Indata och utdataalternativen är samma som de i <link linkend="plugins-kstinterp_akima"
>Akima-splineinterpolering</link
>. </para>
</sect2>

<sect2 id="plugins-kstinterp_cspline_periodic">
<title
>Periodisk kubisk splineinterpolering</title>
<para
>Insticksprogrammet ger differentialvärden för varje tidssteg som resultat.Insticksprogrammet Periodisk kubisk splineinterpolering skapar en kubisk splineinterpolering för datamängden som tillhandahålls, med periodiska gränsvillkor. Indata och utdataalternativen är samma som de i <link linkend="plugins-kstinterp_akima"
>Akima-splineinterpolering</link
>. </para>
</sect2>

<sect2 id="plugins-kstinterp_linear">
<title
>Linjärinterpolering</title>
<para
>Insticksprogrammet Polynominterpolering skapar en polynominterpolering för datamängden som tillhandahålls. Antal termer i polynomet som används är lika med antal punkter i datamängden som tillhandahålls. Indata och utdataalternativen är samma som de i <link linkend="plugins-kstinterp_akima"
>Akima-splineinterpolering</link
>. </para>
</sect2>


<sect2 id="plugins-kstinterp_polynomial">
<title
>Polynominterpolering</title>
<para
>Insticksprogrammet Polynominterpolering skapar en polynominterpolering för datamängden som tillhandahålls. Antal termer i polynomet som används är lika med antal punkter i datamängden som tillhandahålls. Indata och utdataalternativen är samma som de i <link linkend="plugins-kstinterp_akima"
>Akima-splineinterpolering</link
>. </para>
</sect2>

</sect1>


<sect1 id="plugins-filters">
<title
>Insticksprogram för filtrering</title>
<para
>Kst har ett antal inbyggda filter.</para>
<sect2 id="plugins-genericfilter">
	<title
>Generellt filter </title>
	<para
>Insticksprogrammet filtrerar en datamängd genom att använda en <ulink url="http://en.wikipedia.org/wiki/Bilinear_transform"
>bilinjär transformeringsformel</ulink
>. </para>


	<screenshot>
		 
			<mediaobject>
					<imageobject>
					<imagedata fileref="Screenshot-kst-plugins-genericfilter.png" format="PNG"/>
					</imageobject>
			</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-genericfilter-inputs">
		<title
>Indata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Y</guilabel
> (vektor) </term>
						<listitem>
							<para
>Fältet med värden att filtrera </para>
						</listitem>
					</varlistentry>
					<varlistentry>
						<term
><guilabel
>Samplingsintervall</guilabel
> (skalär) </term>
						<listitem>
							<para
>Tidsperioder för sampling av indatavektorn, invers av samplingsfrekvens </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>Täljare och Nämnare (ökande ordning)</guilabel
> (sträng) </term>
						<listitem>
							<para
>En sträng av tal åtskilda med kommatecken för att ange polynomkoefficienter som täljare och nämnare i transformeringsformeln. Om du till exempel har polynomet 2*z^2 + 3*z + 5, ska du ange strängen 2,3,5. Klicka på ikonen <inlinemediaobject
> <imageobject
> <imagedata fileref="Icon-kst-string.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Skapa sträng</phrase
> </textobject
> </inlinemediaobject
> för att skapa en sträng med värdet 2,3,5. </para>
						</listitem>
					</varlistentry>

			</variablelist>
	
	</sect3>

	<sect3 id="plugins-genericfilter-outputs">
		<title
>Utdata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Filtrerad</guilabel
> (vektor) </term>
						<listitem>
							<para
>Ett fält med filtrerad data </para>
						</listitem>
					</varlistentry>

			</variablelist>
	
	</sect3>

</sect2>


<sect2 id="plugins-butterworth_bandpass">
<title
>Bandpassfilter</title>
<para
>Insticksprogrammet Butterworth bandpassfilter filtrerar en datamängd genom att beräkna Fouriertransformen av data och skala spektralamplituderna genom att använda följande funktion, G(f): </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-bandpass.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Bandpassformel</phrase>
</textobject>
</inlinemediaobject>
</para>
<para
>där <literal
>f</literal
> är frekvensen, <literal
>f<subscript
>c</subscript
></literal
> är centrumfrekvensen att filtrera omkring, <literal
>b</literal
> är bandbredden för passbandet, och <literal
>n</literal
> är Butterworthfiltrets ordning. Den inversa Fouriertransformen beräknas därefter med de skalade spektralamplituderna för att skapa en filtrerad datamängd. </para>

<screenshot>
<screeninfo
>Insticksprogram - Bandpassfilter</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-bandpassfilter.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-butterworth_bandpass-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Y</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med värden att filtrera. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ordning</guilabel
> (skalär)</term>
<listitem>
<para
>Ordningen för Butterworth filtret som ska användas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Central frekvens, Samplingsfrekvens</guilabel
> (skalär)</term>
<listitem>
<para
>Frekvensen att filtrera omkring. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Bandbredd</guilabel
> (skalär)</term>
<listitem>
<para
>Bredden på bandpassområdet. Det ska vara skillnaden mellan önskad hög skärningsfrekvens och låg skärningsfrekvens. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-butterworth_bandpass-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Filtrerad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med filtrerade datavärden. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>


<sect2 id="plugins-butterworth_bandstop">
<title
>Bandstoppfilter</title>
<para
>Insticksprogrammet Butterworth bandstoppfilter tar bort signaler i ett givet frekvensområde från en datavektor. Alternativen är samma som de i <link linkend="plugins-butterworth_bandpass"
>bandpassfiltret</link
>, utom att skalningsfunktionen G(f) som används nu anges av: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-bandstop.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Bandstoppformel</phrase>
</textobject>
</inlinemediaobject>
</para>
</sect2>

<sect2 id="plugins-butterworth_highpass">
<title
>Högpassfilter</title>
<para
>Insticksprogrammet Butterworth högpassfilter tar bort signaler under en given skärningsfrekvens från en datavektor. Det gör det genom att beräkna Fouriertransformen av data och skala om spektralamplituderna med följande funktione, G(f): </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-highpass.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Högpassformel</phrase>
</textobject>
</inlinemediaobject>
</para>
<para
>där <literal
>f</literal
> är frekvensen, <literal
>f<subscript
>c</subscript
></literal
> är högfrekventa skärningspunkten, och <literal
>n</literal
> är Butterworthfiltrets ordning. Den inversa Fouriertransformen beräknas därefter med de nya filtrerade frekvenssvaren. </para>

<screenshot>
<screeninfo
>Insticksprogram - Högpass</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-commontasks-plugins2.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-butterworth_highpass-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Y</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med värden att filtrera. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ordning</guilabel
> (skalär)</term>
<listitem>
<para
>Ordningen för Butterworth filtret som ska användas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Skärningsfrekvens, samplingsfrekvens</guilabel
> (skalär)</term>
<listitem>
<para
>Skärningsfrekvensen (<literal
>f<subscript
>c</subscript
></literal
>). </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="plugins-butterworth_highpass-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Filtrerad</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med filtrerade datavärden. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>


<sect2 id="plugins-butterworth_lowpass">
<title
>Lågpassfilter</title>
<para
>Insticksprogrammet Butterworth lågpassfilter tar bort signaler ovanför en given skärningsfrekvens från en datavektor. Alternativen är samma som de i <link linkend="plugins-butterworth_highpass"
>högpassfiltret</link
>, utom att skalningsfunktionen G(f) som används nu anges av: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-lowpass.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Formel för automatisk korrelering</phrase>
</textobject>
</inlinemediaobject>
</para>
</sect2>

<sect2 id="plugins-despikefilter">
	<title
>Toppborttagningsfilter </title>
	<para
>Insticksprogrammet används för att hitta och ta bort toppar i en datamängd. </para>


	<screenshot>
		<screeninfo
>Insticksprogram - Redigera toppborttagningsfilter </screeninfo>
			<mediaobject>
					<imageobject>
					<imagedata fileref="Screenshot-kst-plugins-despikefilter.png" format="PNG"/>
					</imageobject>
			</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-despike-filter">
		<title
>Indata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Y</guilabel
> (vektor) </term>
						<listitem>
							<para
>Välj datavektorn som behöver utjämnas. </para>
						</listitem>
					</varlistentry>
					<varlistentry>
						<term
><guilabel
>Mellanrum</guilabel
> (skalär) </term>
						<listitem>
							<para
>Anger topparnas bredd. </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>NSigma</guilabel
> (skalär) </term>
						<listitem>
							<para
>Om värdet hos en datapunkt varierar från angränsande datapunkter med mer än <replaceable
>NSigma</replaceable
> gånger, räknas den som en topp. </para>
						</listitem>
					</varlistentry>


			</variablelist>
	
	</sect3>
	<sect3 id="plugins-despikefilter-outputs">
		<title
>Utdata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Toppborttagen</guilabel
> (vektor) </term>
						<listitem>
							<para
>Insticksprogrammet ger som utdata en utjämnad datamängd med alla angivna toppar borttagna, </para>
						</listitem>
					</varlistentry>

			</variablelist>
	
	</sect3>


</sect2>




</sect1>


<sect1 id="plugins-vector-processing">
<title
>Insticksprogram för signalbehandling</title>
<para
>Kst tillhandahåller diverse insticksprogram för att hjälpa dig att enkelt behandla signaler.</para>
<sect2 id="plugins-autocorrelation">
<title
>Automatisk korrelering</title>
<para
>Insticksprogrammet Automatisk korrelering beräknar korrelationsvärden mellan en serie (vektor), och en fördröjd version av sig själv, med användning av fördröjningsvärden från <literal
>floor(-(N-1)/2)</literal
> till <literal
>floor((N-1)/2)</literal
>, där <literal
>N</literal
> är antal punkter i datamängden. Tidsvektorn är inte indata eftersom det antas att data samplas med lika tidsintervall. Korrelationsvärdet <literal
>r</literal
> vid fördröjningen <literal
>k</literal
> är: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-autocorrelation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Formel för automatisk korrelering</phrase>
</textobject>
</inlinemediaobject>
</para>

<screenshot>
<screeninfo
>Insticksprogram - Automatisk korrelering</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-autocorrelation.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-autocorrelation-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Array</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet <literal
>x</literal
> med värden som korrelationsvärden ska beräknas för. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-autocorrelation-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Step Value</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med steg, eller fördröjningsvärden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Auto-correlated</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med korrelationsvärden beräknade med motsvarande stegnummer i stegnummervektorn. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>

<sect2 id="plugins-crosscorrelation">
<title
>Korskorrelering</title>
<para
>Insticksprogrammet Korskorrelering beräknar korrelationsvärden mellan två serier (vektorer) <literal
>x</literal
> och <literal
>y</literal
>, med användning av fördröjningsvärden från <literal
>floor(-(N-1)/2)</literal
> till <literal
>floor((N-1)/2)</literal
>, där <literal
>N</literal
> är antal element i den längsta vektorn. Den kortare vektorn fylls ut med <literal
>0</literal
> till den längre vektorns längd. Tidsvektorn är inte indata eftersom det antas att data samplas med lika tidsintervall. Korrelationsvärdet <literal
>r</literal
> vid fördröjningen <literal
>k</literal
> är: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-crosscorrelation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Formel för korskorrelering</phrase>
</textobject>
</inlinemediaobject>
</para>

<screenshot>
<screeninfo
>Insticksprogram - Korskorrelering</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-crosscorrelation.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-crosscorrelation-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Array One</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet <literal
>x</literal
> som används i formeln för korskorrelering. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Array Two</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet <literal
>y</literal
> som används i formeln för korskorrelering. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-crosscorrelation-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Step value</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med steg, eller fördröjningsvärden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Correlation</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med korrelationsvärden beräknade med motsvarande stegnummer i stegvärdesvektorn. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

</sect2>


<sect2 id="plugins-crosspowerspectrum">
	<title
>Korseffektspektrum </title>
	<para
>Insticksprogrammet Korseffektspektrum använder två vektorer och beräknar <link linkend="data-types-spectrum"
>FFT</link
> av deras <link linkend="plugins-crosscorrelation"
>korskorrelation</link
>. </para>


	<screenshot>
		<screeninfo
>Insticksprogram - Korseffektspektrum </screeninfo>
			<mediaobject>
					<imageobject>
					<imagedata fileref="Screenshot-kst-plugins-crosspowerspectrum.png" format="PNG"/>
					</imageobject>
			</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-crosspowerspectrum-Inputs">
		<title
>Indata </title>
			<variablelist>
					<varlistentry>
						<term>
						<guilabel
>Vektor ett och två</guilabel>
						</term>
						<listitem>
							<para
>De två vektorerna som används för att beräkna korseffektspektrum </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>FFT-längd=2^</guilabel
> (skalär) </term>
						<listitem>
							<para
>Se FFT-alternativ för <link linkend="data-types-spectrum"
>Spektrum</link
> </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>Samplingsfrekvens</guilabel
> (skalär) </term>
						<listitem>
							<para
>Se FFT-alternativ för <link linkend="data-types-spectrum"
>Spektrum</link
> </para>
						</listitem>
					</varlistentry>

			</variablelist>
	</sect3>

	<sect3 id="plugins-crosspowerspectrum-outputs">
		<title
>Utdata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Korsspektrum: Reell:</guilabel
> (vektor) </term>
						<listitem>
							<para
>Realdelen av det beräknade korseffektspektrat. </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>Korsspektrum: Imaginär</guilabel
> (vektor) </term>
						<listitem>
							<para
>Imaginärdelen av det beräknade korseffektspektrat. </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>Frekvens</guilabel
> (vektor) </term>
						<listitem>
							<para
>Frekvensvektorn för korseffektspektrats utdata. </para>
						</listitem>
					</varlistentry>

			</variablelist>

	</sect3>

</sect2>



<sect2 id="plugins-convolution">
<title
>Faltning</title>
<para
>Insticksprogrammet Faltning skapar faltningen av en vektor med en annan. Faltningen av två funktioner <literal
>f</literal
> och <literal
>g</literal
> ges av: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-convolution.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>Vektorernas ordning spelar ingen roll, eftersom <literal
>f*g=g*f</literal
>. Dessutom behöver inte vektorerna vara av samma storlek, eftersom insticksprogrammet automatiskt interpolerar den kortaste vektorn till den större längden. </para>

<screenshot>
<screeninfo
>Insticksprogram - Faltning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-convolution.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-convolution-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Array One</guilabel
> (vektor)</term>
<listitem>
<para
>Ett av paret med fält som ska användas för faltningen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Array Two</guilabel
> (vektor)</term>
<listitem>
<para
>Ett av paret med fält som ska användas för faltningen. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-convolution-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Convolved</guilabel
> (vektor)</term>
<listitem>
<para
>Faltningen av de två indatavektorerna. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>


<sect2 id="plugins-deconvolution">
<title
>Avfaltning</title>
<para
>Insticksprogrammet Avfaltning skapar avfaltningen av en vektor med en annan. Avfaltning är inversen av faltning. Givet den faltade vektorn <literal
>h</literal
> och en annan vektor <literal
>g</literal
>, ges avfaltningen <literal
>f</literal
> av: </para>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="Formula-kst-deconvolution.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</para>
<para
>Vektorerna behöver inte vara av samma storlek, eftersom insticksprogrammet automatiskt extrapolerar den kortare vektorn. Den kortare vektorn antas vara svarsfunktionen <literal
>g</literal
>. </para>

<screenshot>
<screeninfo
>Insticksprogram - Avfaltning</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-deconvolution.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugin-deconvolution-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Array One</guilabel
> (vektor)</term>
<listitem>
<para
>Ett av paret med fält som ska användas för avfaltningen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Array Two</guilabel
> (vektor)</term>
<listitem>
<para
>Ett av paret med fält som ska användas för avfaltningen. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-deconvolution-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Avfaltad</guilabel
> (vektor)</term>
<listitem>
<para
>Avfaltningen av de två indatavektorerna. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

</sect2>

<sect2 id="plugins-periodogram">
<!-- FIXME: this description makes any sense. -->
<title
>Periodogram</title>
<para
>Insticksprogrammet Periodogram skapar ett periodogram av en given datamängd. Ett periodogram är en uppskattning av en signals spektraltäthet. </para>

<screenshot>
<screeninfo
>Insticksprogram - Periodogram</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-periodogram.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-periodogram-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Tidfält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med tidsvärden för datapunkterna som interpoleringen ska skapas för. </para>
</listitem>
</varlistentry>


<varlistentry>
<term
><guilabel
>Datafält</guilabel
> (vektor)</term>
<listitem>
<para
>Fältet med datavärden, beroende på tidsvärdena, för datapunkterna som interpoleringen ska skapas för. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Översamplingsfaktor</guilabel
> (skalär)</term>
<listitem>
<para
>Faktorn att översampla med. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Medelvärde av Nyquist frekvensfaktor:</guilabel
> (skalär)</term>
<listitem>
<para
>Medelfaktor för Nyquist-frekvens. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
<sect3 id="plugins-periodogram-outputs">
<title
>Utdata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Frekvens</guilabel
> (vektor)</term>
<listitem>
<para
>Frekvensvektorn. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Periodogram</guilabel
> (vektor)</term>
<listitem>
<para
>Vektorn med frekvenssvar för periodogrammet. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>



</sect1>

<sect1 id="plugins-calculus">
<title
>Insticksprogram för matematisk kalkyl</title>
<para
>Förskjuten vektor</para>
<sect2 id="plugins-cumulativesum-integral">
	<title
>Kumulativ summa (integral) </title>
	<para
>Insticksprogrammet summerar indatavektorn kumulativt över ett valt tidssteg, som är tidsintervallet mellan två intilliggande datapunkter i indatavektorn. Allt eftersom tidssteget blir mindre, närmar sig den beräknade summan följande integral: <inlinemediaobject
> <imageobject
> <imagedata fileref="Formula-kst-cumulativesum.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>kumulativ summaformel</phrase
> </textobject
> </inlinemediaobject
>, där X är indatavektorn. </para>


	<screenshot>
		 
			<mediaobject>
					<imageobject>
					<imagedata fileref="Screenshot-kst-plugins-cumulativesum.png" format="PNG"/>
					</imageobject>
			</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-cumulativesum-Inputs">
		<title
>Indata </title>
			<variablelist>
					<varlistentry>
						<term>
						<guilabel
>Indatavektor</guilabel>
						</term>
						<listitem>
							<para
>Vektorn som används för att beräkna den kumulativa summan. </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>Skalfaktor (tidsteg)</guilabel
> (skalär) </term>
						<listitem>
							<para
>Intervallstorleken för varje steg av den kumulativa summans beräkning </para>
						</listitem>
					</varlistentry>
			</variablelist>
	
	</sect3>
	<sect3 id="plugins-cumulativesum-outputs">
		<title
>Utdata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Kumulativ summa</guilabel
> (vektor) </term>
						<listitem>
							<para
>Fältet lagrar värden av den kumulativa summan för varje steg. </para>
						</listitem>
					</varlistentry>

			</variablelist>
	
	</sect3>

</sect2>

<sect2 id="plugins-fixedstepdifferentiation">
	<title
>Differential med fast steg </title>
	<para
>Insticksprogrammet beräknar differentialvärden med avseende på tid för en indatavektor. När tidssteget blir mindre, når utdatavektorn värdet av dx/dt, där x är indatavektorn. </para>


	<screenshot>
		<screeninfo
>Insticksprogram - Redigera differential med fast steg </screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="Screenshot-kst-plugins-fixedstepdifferentiation.png" format="PNG"/>
			</imageobject>
		</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-fixedstepdifferentiation-inputs">
		<title
>Indata</title>
		<variablelist>
			<varlistentry>
				<term>
				<guilabel
>indatavektor</guilabel>
				</term>
				<listitem>
					<para
>Datavektorn vars differential ska räknas ut </para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term
><guilabel
>Tidsteg</guilabel
> (skalär) </term>
				<listitem>
					<para
>Ange tidsstegets storlek mellan två angränsande värden i indatavektorn. </para>
				</listitem>
			</varlistentry>

		</variablelist>
	
	</sect3>

	<sect3 id="plugins-fixedstepdifferentiation-outputs">
		<title
>Utdata</title>
		<variablelist>
			<varlistentry>
				<term
><guilabel
>Differential</guilabel
> (vektor) </term>
				<listitem>
					<para
>Insticksprogrammet ger differentialvärden för varje tidsteg som resultat. </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</sect3>
</sect2>
</sect1>

<sect1 id="plugins-misc">
<title
>Diverse insticksprogram</title>

<sect2 id="plugins-bin">
	<title
>Område</title>
	<para
>Insticksprogrammet Område delar upp element i en enstaka datavektor i områden av angiven storlek. Värdet för varje område är medelvärdet för elementen som tillhör området. Om områdesstorleken till exempel är <literal
>3</literal
>, och indatavektorn är <literal
>[9,2,7,3,4,74,5,322,444,2,1]</literal
>, blir områden i utdata <literal
>[6,27,257]</literal
>. Observera att eventuella element som finns kvar i slutet på indatavektorn som inte skapar ett fullständigt område (i det här fallet elementen <literal
>2</literal
> och <literal
>1</literal
>), bortses helt enkelt ifrån. </para>

	<screenshot>
		<screeninfo
>Insticksprogram - Område</screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="Screenshot-kst-plugins-bin.png" format="PNG"/>
			</imageobject>
		</mediaobject>
	</screenshot>

	<sect3 id="plugins-bin-inputs">
		<title
>Indata</title>
		<variablelist>
	
			<varlistentry>
				<term
><guilabel
>Infält</guilabel
> (vektor)</term>
				<listitem>
					<para
>Vektorn att dela upp i områden. </para>
				</listitem>
			</varlistentry>
	
			<varlistentry>
				<term
><guilabel
>Områdesstorlek</guilabel
> (skalär)</term>
				<listitem>
					<para
>Storleken (antal element) att använda för varje område. </para>
				</listitem>
			</varlistentry>
	
		</variablelist>
	</sect3>

	<sect3 id="plugins-bin-outputs">
		<title
>Utdata</title>
		<variablelist>
			<varlistentry>
				<term
><guilabel
>Områden</guilabel
> (vektor)</term>
				<listitem>
					<para
>Fältet med medelvärden för varje område. </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</sect3>
</sect2>


<sect2 id="plugins-binnnedmap">
	<title
>Områdesavbildning </title>
	<para
>Områdesavbildning kan skapa ytkonturdiagram av en funktion med två variabler. </para>

	<screenshot>
		<screeninfo
>Insticksprogram - Områdesavbildning </screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="Screenshot-kst-plugins-binnedmap.png" format="PNG"/>
			</imageobject>
		</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-binnedmap-settings">
		<title
>Inställningar </title>
		<variablelist>
			<varlistentry>
				<term
><guilabel
>X,Y,Z</guilabel
> (vektor) </term>
				<listitem>
					<para
>X- och Y-vektor används för att ange värden för de två oberoende variablerna i funktionen, och Z-vektorn anger värden för den beroende variabeln. </para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
><guilabel
>X/Y-områden: Från/Till</guilabel
> (skalär) </term>
				<listitem>
					<para
>Ange intervall av X- och Y-värden. </para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term
><guilabel
>Antal X/Y-områden</guilabel
> (skalär) </term>
				<listitem>
					<para
>Ange upplösning i antal rutor för områdesavbildningens resultat. </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</sect3>


	<sect3 id="plugins-binnedmaps-outputs">
		<title
>Utdata </title>
		<variablelist>
			<varlistentry>
				<term
><guilabel
>Områdesavbildning</guilabel
> (matris) </term>
				<listitem>
					<para
>Områdesavbildning är en matris vars värden kan användas för att skapa ytkonturdiagrammet av en Z-vektor. </para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term
><guilabel
>Träffavbildning</guilabel
> (matris) </term>
				<listitem>
					<para
>Träffavbildning är en matris vars värden bestäms av antal punkter i varje X/Y-område, och dess avbildning anger positioner där Z-värden har placerats i X/Y-planet. </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</sect3>
</sect2>


<sect2 id="plugins-chop">
	<title
>Dela</title>
	<para
>FörskjutInsticksprogrammet Dela tar en indatavektor och delar upp den i två vektorer. Vartannat element i indatavektorn placeras i en utdatavektor, medan alla andra element i indatavektorn placeras i en annan utdatavektor. </para>

	<screenshot>
		<screeninfo
>Insticksprogram - Dela</screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="Screenshot-kst-plugins-chop.png" format="PNG"/>
			</imageobject>
		</mediaobject>
	</screenshot
> 

	<sect3 id="plugins-chop-inputs">
		<title
>Indata</title>
		<variablelist>
		
			<varlistentry>
			<term
><guilabel
>Array</guilabel
> (vektor)</term>
			<listitem>
			<para
>Fältet med värden som ska delas. </para>
			</listitem>
			</varlistentry>
			
		</variablelist>
	</sect3>
			
	<sect3 id="plugins-chop-outputs">
		<title
>Utdata</title>
		<variablelist>
			
			<varlistentry>
				<term
><guilabel
>Udda_fält</guilabel
> (vektor)</term>
				<listitem>
					<para
>Fältet som innehåller den udda delen av indatafältet (dvs. det innehåller det första elementet i indatafältet). </para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
><guilabel
>Jämnt_fält</guilabel
> (vektor)</term>
				<listitem>
					<para
>Vektorn vars diagram behöver förskjutasFältet som innehåller den jämna delen av indatafältet (dvs. det innehåller inte det första elementet i indatafältet). </para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
><guilabel
>Skillnadsfält</guilabel
> (vektor)</term>
				<listitem>
					<para
>Förskjutningsvärde (antal punkter, negativt tillåts)Fältet som innehåller elementen från det udda fältet minus respektive element i det jämna fältet. </para>
				</listitem>
			</varlistentry>
			
			<varlistentry>
				<term
><guilabel
>Indexfält</guilabel
> (vektor)</term>
				<listitem>
					<para
>Ett <link linkend="data-sources-concepts-index"
>indexfält</link
> med samma längd som de tre övriga utdatafälten. </para>
				</listitem>
			</varlistentry>
		
		</variablelist>
	</sect3>
</sect2>


<sect2 id="plugins-convert-time">
	<title
>Konvertera tid</title>
	<para
>Insticksprogrammet konvertera tid, konverterar en vektor från ett tidformat till ett annat: </para>
	
	<screenshot>
		<screeninfo
>Insticksprogram - Konvertera tid</screeninfo>
		<mediaobject>
			<imageobject>
				<imagedata fileref="Screenshot-kst-plugins-converttime.png" format="PNG"/>
			</imageobject>
		</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-convert-time-inputs">
		<title
>Indata</title>
		<variablelist>
	
			<varlistentry>
				<term
><guilabel
>Indatavektor</guilabel
></term>
				<listitem>
					<para
>Vektorn som innehåller tidvärdena att konvertera. </para>
				</listitem>
			</varlistentry>
			
			
			<varlistentry>
				<term
><guilabel
>Indata tidformat</guilabel
> (skalär)</term>
				<listitem>
					<para
>Tidformatet för värden i indatavektorn. Formaten är: <variablelist
> <varlistentry>
<term> </term>
								<listitem
><para
>0: vanlig C-tid</para
></listitem> </varlistentry> <varlistentry> <term></term>
								<listitem
><para
>1: TAI</para
></listitem> </varlistentry> <varlistentry> <term></term>
								<listitem
><para
>2: JD</para
></listitem> </varlistentry> <varlistentry> <term></term>
								<listitem
><para
>3: MJD</para
></listitem> </varlistentry> <varlistentry> <term></term>
								<listitem
><para
>4: RJD</para
></listitem> </varlistentry> <varlistentry> <term></term>
								<listitem
><para
>5: JÅ</para
></listitem> </varlistentry> <varlistentry> <term></term>
								<listitem
><para
>6: TAI (ns)</para
></listitem> </varlistentry> <varlistentry> <term></term>
								<listitem
><para
>7: TAI (2^-16 sek)</para
></listitem> 
							</varlistentry>
						</variablelist>
					</para>
				</listitem>
			</varlistentry>
				
			<varlistentry>
				<term
><guilabel
>Utdata tidformat</guilabel
> (skalär)</term>
				<listitem>
					<para
>Tidformatet för värdena i utdatavektorn. Formaten är samma som för tidformatet hos indata. </para>
				</listitem>
			</varlistentry>

		</variablelist>
	</sect3>
	
	<sect3 id="plugins-noiseaddition-outputs">
		<title
>Utdata</title>
		<variablelist>
		
			<varlistentry>
				<term
><guilabel
>Utdatavektor</guilabel
></term>
				<listitem>
					<para
>Vektorn som innehåller de konverterade tidvärdena, vilken kommer att ha samma storlek som indatavektorn. </para>
				</listitem>
			</varlistentry>
		
		</variablelist>
	</sect3>
</sect2>

<sect2 id="plugins-noise-addition">
	<title
>Tillägg av brus</title>
	<para
>Insticksprogrammet Tillägg av brus lägger till en Gaussisk slumpvariabel till varje element i indatavektorn. Gauss-distributionen som används har medelvärdet <literal
>0</literal
> och angiven standardavvikelse. Frekvensfunktionen för en Gaussisk slumpvariabel är: </para>
	<para>
		<inlinemediaobject>
			<imageobject>
				<imagedata fileref="Formula-kst-gaussianprobability.png" format="PNG"/>
			</imageobject>
		</inlinemediaobject>
	</para>
	
	<screenshot>
	<screeninfo
>Insticksprogram - Tillägg av brus</screeninfo>
	<mediaobject>
	<imageobject>
	<imagedata fileref="Screenshot-kst-plugins-noiseaddition.png" format="PNG"/>
	</imageobject>
	</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-noise-addition-inputs">
	<title
>Indata</title>
	<variablelist>
	
	<varlistentry>
	<term
><guilabel
>Array</guilabel
> (vektor)</term>
	<listitem>
	<para
>Fältet med element där slumpmässigt brus ska läggas till. </para>
	</listitem>
	</varlistentry>
	
	
	<varlistentry>
	<term
><guilabel
>Sigma</guilabel
> (skalär)</term>
	<listitem>
	<para
>Standardavvikelsen som ska användas för Gauss-fördelningen. </para>
	</listitem>
	</varlistentry>
	
	
	</variablelist>
	</sect3>
	
	<sect3 id="plugins-noiseaddition-outputs-2">
	<title
>Utdata</title>
	<variablelist>
	
	<varlistentry>
	<term
><guilabel
>Utfält</guilabel
> (vektor)</term>
	<listitem>
	<para
>Fältet med element där Gaussiskt brus har lagts till. </para>
	</listitem>
	</varlistentry>
	
	</variablelist>
	</sect3>
</sect2>


<sect2 id="plugins-normalization">
  <title
>Normalisering (standardpoäng) </title>
  <para
>Det här insticksprogrammet subtraherar medelvärdet från indatavektorn och dividerar med standardavvikelsen. </para>
  <para>
    <inlinemediaobject>
      <imageobject>
        <imagedata fileref="Formula-kst-normalization.png" format="PNG"/>
      </imageobject>
    </inlinemediaobject>
  </para>

  <screenshot>
    <screeninfo
>Insticksprogram - Redigera normalisering </screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="Screenshot-kst-plugins-normalization.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>

  <sect3 id="plugins-normalization-inputs">
    <title
>Indata </title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel
>Vektor in</guilabel>
        </term>
        <listitem>
          <para
>Vektorn att normalisera </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect3>

  <sect3 id="plugins-normalization-outputs">
    <title
>Utdata </title>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel
>Vektor ut</guilabel>
        </term>
        <listitem>
          <para
>Utmatning av den ursprungliga vektorn efter normalisering. </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect3>
</sect2>


<sect2 id="plugins-phase">
	<title
>Fas </title>
	<para
>Insticksprogrammet beräknar fasvärdet för varje datapunkt i en tidserie med indata. </para>


	<screenshot>
		<screeninfo
>Insticksprogram - Redigera fas </screeninfo>
			<mediaobject>
					<imageobject>
					<imagedata fileref="Screenshot-kst-plugins-phase.png" format="PNG"/>
					</imageobject>
			</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-phase-inputs">
		<title
>Indata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Tidfält</guilabel
> (vektor) </term>
						<listitem>
							<para
>Ett fält med tidvärden </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>Indatafält</guilabel
> (vektor) </term>
						<listitem>
							<para
>Indatamängd som motsvarar tidfältet </para>
						</listitem>
					</varlistentry>

					<varlistentry>
						<term
><guilabel
>Period</guilabel
> (skalär) </term>
						<listitem>
							<para
>Ställer in tidseriens period. </para>
						</listitem>
					</varlistentry>
					<varlistentry>
						<term
><guilabel
>Nollfas</guilabel
> (skalär) </term>
						<listitem>
							<para
>Ställer in tiden för nollfasen. </para>
						</listitem>
					</varlistentry>
			</variablelist>
	</sect3>
	<sect3 id="plugins-phase-outputs">
		<title
>Utdata </title>
			<variablelist>
					<varlistentry>
						<term
><guilabel
>Fasfält</guilabel
> (vektor) </term>
						<listitem>
							<para
>Ett fält med fasvärden som motsvarar indatavärden. </para>
						</listitem>
					</varlistentry>
					<varlistentry>
						<term
><guilabel
>Utdatafält</guilabel
> (vektor) </term>
						<listitem>
							<para
>Utmatning av ursprunglig datamängd med värden sorterade enligt fasfältet. </para>
						</listitem>
					</varlistentry>
			</variablelist>
	</sect3>
</sect2>


<sect2 id="plugins-shift">
	<title
>Fas </title>
	<para
>Insticksprogrammet beräknar fasvärdet för varje datapunkt i en tidserie med indata. </para>


	<screenshot>
		<screeninfo
>Insticksprogram - Redigera fas </screeninfo>
			<mediaobject>
					<imageobject>
					<imagedata fileref="Screenshot-kst-plugins-shift.png" format="PNG"/>
					</imageobject>
			</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-shift-inputs">
		<title
>Indata </title>
			<variablelist>

					<varlistentry>
						<term>
						<guilabel
>Indatavektor</guilabel>
						</term>
						<listitem>
							<para
>Vektorn att skifta </para>
						</listitem>
					</varlistentry>
					<varlistentry>
						<term
><guilabel
>Skiftvärde (antal enheter, negativt tillåtet)</guilabel
> (skalär) </term>
						<listitem>
							<para
>Ange enheter att förskjuta. Positiva förskjutningsvärden ger förskjutning åt höger eller framåt. Negativa förskjutningsvärden ger förskjutning åt vänster eller bakåt. </para>
						</listitem>
					</varlistentry>
			</variablelist>
	</sect3>
	<sect3 id="plugins-shift-outputs">
		<title
>Utdata </title>
			<variablelist>
					<varlistentry>
						<term>
						<guilabel
>Skiftad_vektor</guilabel>
						</term>
						<listitem>
							<para
>Utmatning av den ursprungliga vektorn efter förskjutning med enheterna som anges ovan. </para>
						</listitem>
					</varlistentry>
			</variablelist>
	</sect3>
</sect2>


<sect2 id="plugins-statistics">
<title
>Statistik</title>
<para
>Insticksprogrammet Statistik beräknar statistik för en given datamängd förutom de som automatiskt beräknas av &kst;. De flesta utdataskalärerna är namngivna på så sätt att värdena de representerar bör vara uppenbara. Standardformler används för att beräkna de statistiska värdena. </para>

<screenshot>
<screeninfo
>Insticksprogram - Statistik</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-statistics.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot
> 

<sect3 id="plugins-statistics-inputs">
<title
>Indata</title>
<variablelist>

<varlistentry>
<term
><guilabel
>Datafält</guilabel
> (vektor)</term>
<listitem>
<para
>Datafältet vars statistiska värden ska beräknas. </para>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="plugins-statistics-outputs">
<title
>Utdata</title>
<variablelist>
<varlistentry>
<term
><guilabel
>Medelvärde</guilabel
> (skalär)</term>
<listitem>
<para
>Medelvärdet av datavärdena. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Minimum</guilabel
> (skalär)</term>
<listitem>
<para
>Minimala värdet som hittades i datafältet. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Maximum</guilabel
> (skalär)</term>
<listitem>
<para
>Maximala värdet som hittades i datafältet. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Varians</guilabel
> (skalär)</term>
<listitem>
<para
>Datamängdens varians. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Standardavvikelse</guilabel
> (skalär)</term>
<listitem>
<para
>Datamängdens standardavvikelse. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Median</guilabel
> (skalär)</term>
<listitem>
<para
>Datamängdens median. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Absolutavvikelse</guilabel
> (skalär)</term>
<listitem>
<para
>Datamängdens absolutavvikelse. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Skevhet</guilabel
> (skalär)</term>
<listitem>
<para
>Datamängdens skevhet. </para>
</listitem>
</varlistentry>


<varlistentry>
<term
><guilabel
>Excess</guilabel
> (skalär)</term>
<listitem>
<para
>Datamängdens excess. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>


<sect2 id="plugins-syncbin">
	<title
>Synkrona områden </title>
	<para
>Insticksprogrammet grupperar datapunkter i en angiven del av ett X-Y diagram i ett angivet antal områden. </para>


	<screenshot>
		<screeninfo
>Insticksprogram - Redigera synkrona områden </screeninfo>
			<mediaobject>
					<imageobject>
					<imagedata fileref="Screenshot-kst-plugins-syncbin.png" format="PNG"/>
					</imageobject>
			</mediaobject>
	</screenshot
> 
	
	<sect3 id="plugins-syncbin-inputs">
		<title
>Indata </title>
		<variablelist>
			<varlistentry>
				<term
><guilabel
>X-in</guilabel
> (vektor) </term>
				<listitem>
					<para
>X-värden för en mängd datapunkter </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
><guilabel
>Y-in</guilabel
> (vektor) </term>
				<listitem>
					<para
>Y-värden för en mängd datapunkter </para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term
><guilabel
>Antal områden</guilabel
> (skalär) </term>
				<listitem>
					<para
>Anger antalet områden som används för att gruppera datapunkterna </para>
				</listitem>
			</varlistentry>



			<varlistentry>
				<term
><guilabel
>X-min/X-max</guilabel
> (skalär) </term>
				<listitem>
					<para
>Anger minimala och maximala X-värden för en mängd datapunkter för att ange intervallet av datapunkter som ska indelas i områden. </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</sect3>
	<sect3 id="plugins-syncbin-outputs">
		<title
>Utdata </title>
			<variablelist>
			<varlistentry>
				<term
><guilabel
>X-ut</guilabel
> (vektor) </term>
				<listitem>
					<para
>X-värden efter indelning i områden. Vektorn X-ut består av medianvärdet av X-element i varje område. </para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term
><guilabel
>Y-ut</guilabel
> (vektor) </term>
				<listitem>
					<para
>Y-värden efter indelning i områden. Vektorn Y-ut består av medelvärdet av Y-element i varje område. </para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term
><guilabel
>Y-fel</guilabel
> (vektor) </term>
				<listitem>
					<para
>Vektorn består av Y-värdenas standardavvikelse i varje område. </para>
				</listitem>
			</varlistentry>

			<varlistentry>
				<term
><guilabel
>N</guilabel
> (vektor) </term>
				<listitem>
					<para
>N-vektorn består av antalet datapunkter i varje område. </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</sect3>
</sect2>

</sect1>

<sect1 id="plugins-kstscript">
<title
>Använda insticksprogram via Kst-skript</title>

<sect2>
<title
>Översikt</title>
<para
>Insticksprogram kan också skapas och redigeras via Kst-skript. Se information i klassen <link linkend="class_Plugin"
>Plugin</link
> i kapitlet Arbeta med Kst-skript.</para>
<para
>Använd följande syntax för att skapa ett nytt insticksprogram:</para>
<programlisting
>plugin = new Plugin(Kst.pluginManager.modules["Plugin Name"])
// "Plugin Name" måste skrivas in på exakt samma sätt som visas under Skapa insticksprogram i <link linkend="data-overview-datamanager"
>Datahantering</link
>.
</programlisting>
<para
>För att ange indatavärden till insticksprogrammet</para>
<programlisting
>plugin.setInput(<replaceable
>indataindex</replaceable
>, <replaceable
>indatavärden</replaceable
>);</programlisting>
<para
>Du måste validera insticksprogrammet innan du kan få utdata från det. Använd följande metod för att validera insticksprogrammet: </para>
<programlisting
>plugin.validate();</programlisting>
<para
>Utdatavärden lagras i Kst som en objektsamling. För att hämta utdata från insticksprogrammet måste du ange dess index: </para>
<programlisting
>v = plugin.outputs[<replaceable
>utdataindex</replaceable
>];</programlisting>
<para
>För att veta index för indata och utdata, titta i ordningen som indata och utdata visas i dialogrutorna i insticksprogrammets användargränssnitt.</para>

<para
>Nedan visas två exempel på användning av insticksprogram via Kst-skript</para>
</sect2>

<sect2>
<title
>Exempel</title>
<example id="kstscript-stat-plugin-eg">
<title
>Kst-skript för statistikinsticksprogram</title>
<programlisting
>p = new Plugin(Kst.pluginManager.modules["Statistics"]); // skapa ett nytt statistikinsticksprogram
p.tagNmae = "Stat";                         // detta är insticksprogrammets namn i datahanteringen
p.setInput(0, "x");                        // x är namnet på vektorn vars olika
                                           // statistikvärden behövs
p.validate();                                 // validera insticksprogrammet
s = new Scalar();
s = p.outputs[0];                        // hämta första utdata från insticksprogrammet, dvs. medelvärdet av x
s.value                                        // värdet av s skrivs ut på skärmen, t.ex. -4,12232621329268
</programlisting
>  
</example>

<example id="kstscript-interpolation-plugin-eg">
<title
>Funktion i Kst-skript för att använda insticksprogram för interpolering</title>
<para
>Alla insticksprogram för interpolering i Kst har samma indata och utdata. Därför, istället för att skiva en stor mängd liknande kod för att ange indata och hämta utdata för olika interpoleringsmetoder, kan vi skriva en funktion i Kst-skript som gör det. </para>
<para
>Följande är en funktion i Kst-skript som behöver tre vektorer: x, y, ix, och en sträng som indata. Funktionen använder strängen för att ange ett insticksprogram för interpolering, och utför den angivna interpoleringsmetoden för x- och y-vektorerna för att få interpolerade y-värden för ix-vektorn. Därefter ritar funktionen upp y mot x, och interpolerad y mot ix. </para>

<programlisting
>// intplFuction.js
function intpl(x,y,ix,intpl) {
// x är en vektor använd som X-fält i insticksprogram för interpolering
// y är en vektor använd som Y-fält
// ix är en vektor använd som X'-fält
// intpl är en sträng använd för att ange namnet
// på ett specifikt insticksprogram för interpolering, såsom "Interpolation akima spline".
// skapa ett nytt insticksprogram för interpolering
 pl = new Plugin(Kst.pluginManager.modules[intpl]);
 pl.tagName = intpl+"plugin";

// ange insticksprogrammets indata
 pl.setInput(0,x);
 pl.setInput(1,y);
 pl.setInput(2,ix);
 pl.validate(); // validera insticksprogrammet 

iy=pl.outputs[0]; // hämtar utdata från insticksprogrammet
iy.tagName = "interpolerad_y"; // kalla det interpolerad_y i datahanteringen
// öppna ett nytt fönster för att rita upp x mot y och ix mot interpolerad_y;
w=new Window();
p=new Plot(w);
c1 = new Curve(x,y);
c1.tagName = "y";
c2 = new Curve(ix,iy);
c2.tagName = "interpolated_y";
p.curves.append(c1);
p.curves.append(c2);
p.xAxis.label = "X";
p.yAxis.label = "Y";
// redigera kurvornas inställningar, som linjestil, punktstil, etc.
// för att göra det lättare att skilja de båda kurvorna åt
c1.hasPoints = true;
c1.pointStyle = 3;
c1.lineStyle =1;
c1.lineWidth = 2;
c2.hasPoints = true;
c2.pointStyle = 0;
c2.lineWidth = 1;
// lägg till en förklaring
l = new Legend(w);
l.fontSize=5;
l.addCurve(c1);
l.addCurve(c2);
   }
</programlisting>
</example>
<para
>Låt oss titta på ett exempel av hur funktionen ovan används. Spara först skriptet ovan i en fil som heter <filename
>intplFunction.js</filename
> i din hemkatalog. Öppna därefter en ny textfil, och kopiera de följande raderna till den. Spara därefter filen som <filename
>intplTest.js</filename
> i din hemkatalog. <programlisting
>// intplTest.js
// skapa två vektorer, x och y, med y = sin(x) and x = {-10,-9,-8...0...8,9,10}
x = new Vector();
x.tagName = "x";
y = new Vector();
y.tagName = "y";
x.resize(21);
y.resize(21);
var k=-10;
for(var i=0; i&#060;21;i++) {
x[i]=k;
y[i]=Math.sin(x[i]);
k++; } 
// skapa vektorn ix: ix={-10,-9.75,-9.25,-9,...0...9,9.25,9,75,10}
// y-värden av ix erhålls via interpolering.
ix=new Vector();
ix.tagName = "ix";
ix.resize(81);
var k=-10;
for(var i=0; i&#060;81 i++) {
ix[i]=k;
k = k+0.25; }
// ladda skriptet med funktionen intpl
loadScript('/home/vyiwen/intplFunction.js');
// anropa funktionen intpl
intpl(x,y,ix,"Interpolation cubic spline")
</programlisting>

</para>

<para
>Öppna Kst och ladda <filename
>intplTest.js</filename
> in java-terminalen så här: <command
>loadScript('/home/vyiwen/intplTest.js');</command
> </para>

<para
>Efter att ha laddad skriptet, bör du se diagrammen nedan: </para>

<screenshot>
<screeninfo
>Exempel på interpolering</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-plugins-interpolation-eg.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Exempel på interpolering</phrase>
</textobject>
</mediaobject>
</screenshot
></sect2>


</sect1>

</chapter>


<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-omittag:nil
sgml-shorttag:nil
sgml-namecase-general:nil
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:true
sgml-parent-document:("index.docbook" "book" "chapter")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
