<chapter id="common-tasks">
<title
>Compiti comuni</title>

<para
>Questo capitolo contiene istruzioni per effettuare compiti di base con &kst;. Indica il metodo per effettuare ogni compito nel modo più semplice. Ci sono anche dei collegamenti a sezioni del manuale dove vengono date informazioni più dettagliate.</para>

<sect1 id="plotting-simple-graphs">
<title
>Tracciare dei grafici semplici</title>

<para
>Come tracciare un semplice grafico a punti su una griglia</para>

<para
>La prima cosa che vorrai fare con &kst; è probabilmente tracciare un semplice grafico. Ecco la procedura:</para>

<orderedlist>

<listitem
><para
>Scegli il tuo file di dati. &kst; leggerà molti tipi di file, quello più semplice è il file di testo semplice (<acronym
>ASCII</acronym
>) con i dati in colonne. Per coerenza useremo il file di dati nel<xref linkend="gettingstarted"/>, con il nome file <filename
>datisemplici.dat</filename
>.</para>
</listitem>

<listitem
><para
>Apri &kst;. Ti viene presentata la finestra <guilabel
>Avvio rapido</guilabel
>: <screenshot>
<screeninfo
>La finestra Avvio rapido</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-quickstart.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>La finestra Avvio rapido</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Fai clic sull'<guibutton
>Assistente dei dati</guibutton
>, e, nell'assistente che appare, seleziona il tuo file di dati usando il pulsante <guibutton
>Apri file</guibutton
>: <inlinemediaobject
><imageobject
><imagedata fileref="Screenshot-kst-open-file-button.png" format="PNG"/></imageobject
></inlinemediaobject
>. </para>
</listitem>

<listitem>
<para
>La pagina successiva è dove selezioni quali dati usare. La colonna 2 del file di dati contiene i valori dell'asse Y, quindi segna la casella di fianco a 2 nell'elenco <guilabel
>Campo/colonna</guilabel
> sul lato sinistro. Il campo INDEX è un campo speciale creato da &kst;, ma non lo useremo in questo esempio.</para>
</listitem>

<listitem>
<para
>Sotto <guilabel
>Tipi di grafico</guilabel
>, lascia il valore predefinito <guilabel
>XY</guilabel
> così com'è, ma cambia il <guilabel
>Vettore dell'asse X</guilabel
> a 1.</para>
</listitem>

<listitem>
<para
>Nella pagina successiva, cambieremo solo una cosa: sotto <guilabel
>Stile delle curve</guilabel
>, seleziona <guilabel
>Solo punti</guilabel
> per disegnare solo i punti dei dati, e non le linee che li uniscono.</para>
</listitem>

<listitem>
<para
>Fai clic su <guibutton
>Fine</guibutton
> e sei a posto! Il nuovo grafico appare nella finestra principale di &kst;.</para>
</listitem>

</orderedlist>

<!-- TODO: Link to other places in the handbook, perhaps with a little -->
<!-- more description -->

</sect1>

<sect1 id="curve-fitting">
<title
>Regressione delle curve</title>

<para
>&kst; fornisce anche funzioni per molti diversi tipi di regressione delle curve: lineare, quadratica, sinusoidale, e altre. Come esempio, faremo una semplice regressione polinomiale per la curva che abbiamo tracciato prima, nel<xref linkend="plotting-simple-graphs"/>.</para>

<orderedlist>

<listitem
><para
>Una volta fatto il grafico, apri la finestra dei plugin da <menuchoice
><guimenu
>Dati</guimenu
><guimenuitem
>Nuovo plugin</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem
><para
>La casella combinata <guilabel
>Selezione plugin</guilabel
> contiene tutti i plugin di regressione di &kst;, e altri. Siccome i dati dell'esempio sono quadratici, useremo il plugin <guilabel
>Regressione polinomiale</guilabel
>. Seleziona i vettori <guilabel
>Array X</guilabel
> e <guilabel
>Array Y</guilabel
> per la regressione; se hai usato i nomi predefiniti quando hai fatto il grafico, seleziona <guilabel
>V0-1</guilabel
> per l'<guilabel
>Array X</guilabel
> e <guilabel
>V1-2</guilabel
> per l'<guilabel
>Array Y</guilabel
>. </para>
</listitem>

<listitem
><para
>Mentre lo facciamo, l'<guilabel
>Ordine</guilabel
> del polinomio è impostato come valore predefinito a 2, che è quello che vogliamo. Puoi impostare l'<guilabel
>Ordine</guilabel
> a qualsiasi intero, una delle quantità scalari predefinite, o qualche valore statistico basato su uno dei vettori disponibili (per esempio, <guilabel
>V1-2-Media</guilabel
>).</para>
</listitem>

<listitem
><para
>Premi <guibutton
>OK</guibutton
> per generare i valori.</para>
</listitem>

</orderedlist>

<para
>Questo è tutto ciò di cui abbiamo bisogno per generare i valori, quindi ora dobbiamo dare un'occhiata all'output del processo di regressione. Seleziona <menuchoice
><guimenu
>Dati</guimenu
><guimenuitem
>Visualizza i risultati delle regressioni</guimenuitem
></menuchoice
> dai menu, e i valori della regressione saranno visualizzati nella finestra che appare: i coefficienti per x^2, x^1 e x^0 (la costante), insieme al valore chi-quadrato e le covarianze tra i coefficienti.</para
> 

<para
>La curva generata dalla regressione non è automaticamente sovrapposta ai punti dei dati. Per farlo, usa la finestra <guilabel
>Nuova curva</guilabel
> selezionando <menuchoice
><guimenu
>Dati</guimenu
><guimenuitem
>Nuova curva...</guimenuitem
></menuchoice
>. Per il <guilabel
>Vettore asse X</guilabel
>, seleziona V0-1 (se hai usato i nomi generati automaticamente), e per il <guilabel
>Vettore asse Y</guilabel
>, scegli <quote
>P1-kstfit_polynomial_unweighted-Y Fitted</quote
>. Fai clic su <guibutton
>OK</guibutton
> una volta che hai impostato qualsiasi altra opzione che vuoi. La curva è tracciata in una sua finestra: in questo esempio non lo vogliamo, quindi elimina il nuovo grafico facendoci clic destro e scegliendo <guimenuitem
>Elimina</guimenuitem
> nel menu a comparsa che appare.</para>

<para
>Adesso, per aggiungere la regressione della curva al grafico dei dati, apri la finestra Grafico da <menuchoice
><guimenu
>Grafici</guimenu
><guimenuitem
>Modifica grafico...</guimenuitem
></menuchoice
>. Nella scheda <guilabel
>Contenuto</guilabel
> che appare, il vettore contenente i dati della regressione è mostrato sotto gli <guilabel
>Oggetti disponibili</guilabel
>. Seleziona questo vettore, e aggiungilo all'elenco di <guilabel
>Oggetti visualizzati</guilabel
> facendo clic sul pulsante con la freccia a sinistra. Fai clic su <guibutton
>Applica modifiche</guibutton
>, e poi su <guibutton
>Chiudi</guibutton
>, e hai finito.</para>

</sect1>

<sect1 id="plotting-a-power-spectrum">
<title
>Tracciare uno spettro di potenza</title>

<para
>&kst; rende estremamente facile tracciare degli spettri di potenza. Ci sono due modi di farlo: con l'assistente dei dati, o creando uno spettro di potenza da un vettore esistente.</para>

<sect2 id="power-spectra-data-wizard">
<title
>Spettri di potenza con l'assistente dei dati</title>

<para
>Questo è quasi lo stesso che tracciare un grafico. Ecco le istruzioni complete:</para>

<para
>Apri l'<guibutton
>Assistente dei dati</guibutton
> e seleziona il tuo file dei dati usando il pulsante <guibutton
>Apri file</guibutton
>: <inlinemediaobject
><imageobject
><imagedata fileref="Screenshot-kst-open-file-button.png" format="PNG"/></imageobject
></inlinemediaobject
>. </para>

<orderedlist>
<listitem>
<para
>La pagina successiva è dove selezioni quali dati di cui tracciare uno spettro di potenza. La colonna 2 nel file di dati contiene i valori dell'asse Y, quindi segna la casella di fianco a 2 nell'elenco <guibutton
>Campo/colonna</guibutton
> sul lato sinistro.</para>
</listitem>

<listitem>
<para
>Sotto <guilabel
>Tipi di grafico</guilabel
>, seleziona <guilabel
>Spettro di potenza</guilabel
>. Ci sono anche altre opzioni che specificano come calcolare lo spettro, che in questo esempio lasceremo ai valori predefiniti.</para>
</listitem>

<listitem>
<para
>Nella pagina successiva, le opzioni specifiche di uno spettro di potenza si trovano sotto <guilabel
>Modalità degli assi degli spettri di potenza</guilabel
>. Gli assi X e Y possono entrambi essere resi logaritmici.</para>
</listitem>

<listitem>
<para
>Fai clic su <guibutton
>Fine</guibutton
> e sei a posto! Il nuovo grafico appare nella finestra principale di &kst;.</para>
</listitem>

</orderedlist>


</sect2>

<sect2 id="power-spectra-existing-plot">
<title
>Spettri di potenza da un grafico esistente</title>
<para
>Usando l'esempio <filename
>datisemplici.dat</filename
> dal<xref linkend="plotting-simple-graphs"/>, possiamo fare ciò che segue per produrne lo spettro di potenza:</para>

<orderedlist>

<listitem
><para
>Apri la <guilabel
>Finestra degli spettri di potenza</guilabel
> da <menuchoice
><guimenu
>Dati</guimenu
><guimenuitem
>Nuovo spettro di potenza...</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem
><para
>Dalla casella combinata <guilabel
>Vettore dei dati</guilabel
>, scegli il vettore che rappresenta i tuoi dati. Nel nostro esempio <filename
>datisemplici.dat</filename
>, il vettore richiesto è V1-2.</para>
</listitem>

<listitem
><para
>Fai clic su <guibutton
>OK</guibutton
> e lo spettro di potenza è visualizzato in un nuovo grafico.</para>
</listitem>

</orderedlist>

</sect2>

</sect1>

<sect1 id="using-kst-from-the-command-line">
<title
>Usare &kst; dalla riga di comando</title>

<para
>Le istruzioni da riga di comando per effettuare le istruzioni sopra</para>

</sect1>

<!--
The interface for this is not finalized, so it's commented out for -->
<!--now, but definitely something useful to have in the future -->

<!--
<sect1 id="making-a-color-map">
<title
>Making a Color Map</title>
<para
>How to make a color map, since the interface isn't very intuitive</para>
</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:
-->
