<chapter id="tutorial">

<chapterinfo>
<authorgroup>
<author
><firstname
>Barth</firstname
> <othername
></othername
> <surname
>Netterfield</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
<author
><firstname
>Rick</firstname
> <othername
></othername
> <surname
>Chern</surname
> <affiliation
><address
><email
>kst@kde.org</email
></address
></affiliation>
</author>
</authorgroup>



<copyright>
<year
>2004</year>
<holder
>Università della Columbia Britannica</holder>
</copyright>



</chapterinfo>
<title
>Esercitazione di &kst;</title>



<sect1 id="Welcome">
<title
>Benvenuto</title>
<para
>Benvenuto in &kst;! Tra qualche minuto, esplorerai le potenti funzionalità di questo pacchetto di tracciamento e manipolazione dei dati. Questi sono solo alcuni dei compiti che puoi effettuare usando &kst;: </para>

<itemizedlist>
<listitem>
<para
>Tracciare rapidamente più grafici usando solo la riga di comando. </para>
</listitem>
<listitem>
<para
>Analizzare dati usando un ampio insieme di strumenti, inclusi istogrammi, spettri di potenza, ed equazioni personalizzate. </para>
</listitem>
<listitem>
<para
>Ingrandire e rimpicciolire senza sforzo aree interessanti dei grafici usando il mouse o la tastiera </para>
</listitem>
<listitem>
<para
>Sorvegliare dati dal vivo usando le capacità di tracciamento di grafici in tempo reale di &kst;. </para>
</listitem>
</itemizedlist>
<para
>Questa esercitazione copre i fondamentali dell'installazione, esecuzione e lavoro con &kst;. È basata sul Giro rapido di &kst; di Barth Netterfield. Sei invitato a investigare ulteriormente tutte le funzionalità quando vuoi. Tutte le funzionalità sono documentate nel resto di questo manuale.</para>

</sect1>

<sect1 id="commandline">
<title
>Avviare &kst; dalla riga di comando</title>
<para
>Un uso comune di &kst; è produrre rapidamente grafici da dati dalla riga di comando. Questo metodo di produrre grafici richiede quasi nessuna conoscenza dell'interfaccia grafica di &kst;, eppure produce risultati immediati e utili. </para>

<para
>Questa esercitazione usa un pacchetto dimostrativo di file di dati installato con &kst; in <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/apps/kst/tutorial</filename
>, dove <filename class="directory"
>$<envar
>KDEDIR</envar
></filename
> è la posizione dove &kde; è installato sul tuo sistema (puoi trovarla usando il comando <command
>kde-config --prefix</command
>).</para>

<note
><para
>Se hai una versione di &kst; precedente a 1.1.0, puoi trovare i dati dell'esercitazione in rete a <ulink url="http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz"
>http://omega.astro.utoronto.ca/kst/tutorial/kst_tutorialdata.tgz</ulink
>. Scarica e scompatta il pacchetto, e passa alla cartella risultante: <screen
><userinput
><command
>tar -zxvf kst_tutorialdata.tgz</command>
<command
>cd kst_tutorialdata</command
></userinput
></screen>

</para>
</note>

<para
>Per ottenere una panoramica di tutte le opzioni da riga di comando disponibili di &kst;, scrivi: <screen
><userinput
><command
>kst --help</command
></userinput
></screen>
</para>
<para
>Saranno visualizzati una descrizione della sintassi e un elenco di comandi simili ai seguenti: <screen
>Uso: kst [opzioni Qt] [opzioni KDE] [opzioni] [Files]

Kst: un programma per la visualizzazione di dati.

Opzioni generiche:
  --help                    Mostra la guida sulle opzioni
  --help-qt                 Mostra le opzioni specifiche per Qt
  --help-kde                Mostra le opzioni specifiche per KDE
  --help-all                Mostra tutte le opzioni
  --author                  Mostra le informazioni sull'autore
  -v, --version             Mostra le informazioni sulla versione
  --license                 Mostra le informazioni sulla licenza
  --                        Fine delle opzioni

Opzioni:
  -F &lt;dataFile
>             Specifica il file dati: usato per superare il file predefinito di kst [|]
  -y &lt;Y&gt;                    Campo per l'asse Y (permessi più di uno)
  --ye &lt;equation&gt;           Equazione per l'asse Y (permesse più di una)
  -e &lt;E&gt;                    Campo per gli errori di Y (permessi più di uno)
  -x &lt;X&gt;                    Campo o intervallo per l'asse X [INDEX]
  --xe &lt;X&gt;                  Vettore X per le equazioni x0:x1:n [INDEX]
  -p &lt;Y&gt;                    Campo per lo spettro di potenza (permessi più di uno)
  -h &lt;Y&gt;                    Campo per l'istogramma (permessi più di uno)
  -r &lt;f&gt;                   Velocità di campionamento per lo spettro di potenza [60.0]
  --ru &lt;U&gt;                  Unità per la velocità di campionamento psd [Hz]
  --yu &lt;U&gt;                  Unità per i vettori y [V]
  -l &lt;P&gt;                    La lunghezza della FFT è 2^P [10]
  -f &lt;F0&gt;                   Primo frame da leggere [-2]
  -n &lt;NS&gt;                   Numero di frame da leggere [-2]
  -s &lt;NS&gt;                   Numero di frame da saltare a ogni lettura [-1]
  -a                        Applica il filtro boxcar prima saltare i frame
  -m &lt;NC&gt;                   Grafici separati e ordinati in &lt;NC&gt; colonne
  -d                        Visualizza come punti anziché curve
  -g                        Fornisci un riquadro legenda
  --print &lt;file&gt;            Stampa su file ed esci [&lt;none&gt;]
  --png &lt;file&gt;              Salva come file png ed esci [&lt;none&gt;]

Argomenti:
  Files                     File dati (se -y è dato) o file *.kst
</screen>
</para>

<para
>Le opzioni specifiche di &kst; sono elencate sotto la sezione <literal
>Opzioni:</literal
>. Dove opportuno, sono indicati i valori predefiniti con parentesi quadre alla fine delle descrizioni delle opzioni; questi valori saranno usati per le opzioni non specificate. </para>

<para
>Per prima cosa daremo un'occhiata al file ASCII <filename
>gyrodata.dat</filename
>, incluso nel pacchetto dimostrativo. I file ASCII sono uno dei molti tipi di file che &kst; è capace di leggere. Nei file ASCII, i dati sono ordinati in colonne; ogni colonna corrisponde a un campo, e i numeri delle colonne (cominciando con 1 da sinistra a destra) corrispondono ai nomi dei campi. Questo file ASCII, in particolare, contiene tre colonne, e ha quindi i nomi di campo 1, 2 e 3. Per produrre un grafico della prima colonna, scrivi semplicemente: <screen
><userinput
><command
>kst -y 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>Tutti i dati nella prima colonna saranno tracciati: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro1.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
<para
>Nota che nessun campo è stato specificato per l'asse X del grafico, quindi &kst; ha usato il vettore predefinito INDEX, come previsto. Il vettore INDEX è un vettore speciale di &kst; che contiene gli interi da 0 a N-1, dove N è il numero di valori di dati nel vettore Y corrispondente. Chiudi &kst; selezionando <guimenuitem
>Esci</guimenuitem
> dal menu <guimenu
>File</guimenu
>, o scrivendo <keycombo action="simul"
><keycap
>Ctrl</keycap
><keycap
>Q</keycap
></keycombo
>. </para>

<para
><filename
>gyrodata.dat</filename
> contiene 20000 fotogrammi, quindi potresti voler guardare solo una parte dei dati. Per tracciare 10000 fotogrammi partendo dal fotogramma 7000, scrivi: <screen
><userinput
><command
>kst -y 1 -f 7000 -n 10000 gyrodata.dat</command
></userinput
></screen>

</para>

<para
>Una delle forze di &kst; è la sua capacità di tracciare grafici di dati in tempo reale. Immagina che dei nuovi dati siano aggiunti in continuazione alla fine di <filename
>gyrodata.dat</filename
>. In un simile scenario, sarebbe utile tracciare solo la parte più recente dei dati. Per tracciare solo gli ultimi 10000 fotogrammi di <filename
>gyrodata.dat</filename
>, inserisci ciò che segue: <screen
><userinput
><command
>kst -y 1 -n 10000 gyrodata.dat</command
></userinput
></screen>
</para>
<para
>Se <filename
>gyrodata.dat</filename
> fosse aggiornato, il grafico scorrerebbe continuamente per visualizzare solo gli ultimi 10000 fotogrammi. </para>

<para
>Invece di leggere direttamente un file di input, &kst; può usare i dati ASCII da stdin come sorgente di dati. Per specificare stdin come input, inserisci semplicemente <filename
>stdin</filename
> come uno dei nomi file. Ci sono molti usi di questa possibilità, come usare &kst; come parte di una sequenza di comandi concatenati: <screen
><userinput
><command
>cat gyrodata.dat | awk '{print $1 + 2}' | kst -y 1 stdin</command
></userinput
></screen>
</para>
<para
>Il comando sopra usa <command
>awk</command
> per aggiungere 2 alla colonna 1 di <filename
>gyrodata.dat</filename
> prima di passarlo a &kst;. </para>

<para
>Nota che la descrizione dell'opzione <option
>y</option
> indica che sono permesse istanze multiple dell'opzione. Ciò permette un tracciamento rapido di più di una curva, o anche più di un grafico. Per tracciare tutti i tre campi di <filename
>gyrodata.dat</filename
> in grafici separati, inserisci ciò che segue: <screen
><userinput
><command
>kst -y 1 -y 2 -y 3 -m 1 gyrodata.dat</command
></userinput
></screen>

</para>
<para
>L'opzione <option
>m</option
> specifica che dovrebbero essere usati grafici separati invece di uno singolo, come mostrato sotto: </para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-gyro-multiple.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="datawizard-tour">
<title
>Un rapido giro dell'Assistente dei dati</title>
<para
>Sebbene usare &kst; dalla riga di comando sia facile e comodo, ci potrebbero essere situazioni nelle quali sarebbe più facile importare dati dall'interfaccia utente grafica; per esempio, se hai già aperto &kst; con altri dati caricati. Oppure, potresti semplicemente preferire l'uso dell'interfaccia grafica. Abituarti a entrambi i metodi di importazione dei dati ti permetterà di usare &kst; più efficientemente. </para>

<para
>L'assistente dei dati fornisce un modo semplice e veloce per creare vettori, curve, e grafici in &kst; dai file di dati. Per avviare l'assistente, seleziona <guimenuitem
>Assistente dei dati...</guimenuitem
> dal menu <guimenu
>Dati</guimenu
> o fai clic sul pulsante <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-datawizard.png" format="PNG"/></imageobject
></inlinemediaobject
> sulla barra degli strumenti. Sfoglia al file <filename
>gyrodata.dat</filename
> usato negli esempi della riga di comando e fai clic su <guibutton
>Avanti</guibutton
>. Sarà visualizzata la finestra seguente: </para>

<screenshot>
<screeninfo
>Schermata dell'assistente di dati 2</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Schermata dell'assistente di dati 2</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>I campi disponibili in <filename
>gyrodata.dat</filename
> sono elencati a sinistra. Puoi filtrare l'elenco dei campi evidenziati inserendo una stringa da far corrispondere (sono supportati i caratteri jolly come <literal
>*</literal
>) nella casella di testo sopra l'elenco. Segna le caselle per i campi <guilabel
>1</guilabel
>, <guilabel
>2</guilabel
> e <guilabel
>3</guilabel
>. </para>

<para
>La sezione <guilabel
>Intervallo dei dati</guilabel
> è usata per specificare l'intervallo di dati da leggere dai vettori selezionati nel file di input. La discussione che segue presume la conoscenza dei <quote
>fotogrammi</quote
>. In breve, un fotogramma è semplicemente un numero di campioni di dati, e ogni file di dati è composto da un numero di fotogrammi. Per una descrizione dettagliata di questo concetto, vedi <xref linkend="supportingadditionalfileformatsdatasourceconceptsframes"/>. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Inizio</guilabel
>, <guilabel
>Conta dalla fine</guilabel
>, <guilabel
>Intervallo</guilabel
>, e <guilabel
>Leggi fino alla fine</guilabel
> </term>
<listitem>
<para
>Usando queste quattro impostazioni, si possono impostare i limiti superiore e inferiore dell'intervallo di dati. Per esempio, seleziona <guilabel
>Conta dalla fine</guilabel
> e inserisci 10000 come <guilabel
>Intervallo</guilabel
> per leggere solo gli ultimi 10000 fotogrammi. Se <filename
>gyrodata.dat</filename
> fosse in aggiornamento in tempo reale, sarebbero lette le aggiunte successive alla fine del file. </para>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Leggi un campione ogni N fotogrammi</guilabel
> e <guilabel
>Filtro Boxcar per primo</guilabel
> </term>
<listitem>
<para
>Inoltre ai limiti inferiore e superiore, si possono impostare i campioni da leggere dall'intervallo selezionato. Se <guilabel
>Leggi un campione ogni N fotogrammi</guilabel
> (dove N è il valore inserito) non è selezionato, saranno letti tutti i campioni nell'intervallo selezionato. In alternativa, i fotogrammi nel file di dati possono essere saltati selezionando <guilabel
>Leggi un campione ogni N fotogrammi</guilabel
>. Per adesso, deseleziona <guilabel
>Leggi un campione ogni N fotogrammi</guilabel
>. </para>
</listitem>
</varlistentry>
</variablelist>

<para
>Le impostazioni degli spettri di potenza e dell'asse X possono essere specificate nella sezione <guilabel
>Tipi di grafico</guilabel
>. </para>

<variablelist>

<varlistentry>
<term
><guilabel
>XY</guilabel
>, <guilabel
>Spettro di potenza</guilabel
>, e <guilabel
>Spettro di potenza e XY</guilabel
> </term>
<listitem>
<para
>Seleziona <guilabel
>Spettro di potenza e XY</guilabel
> per produrre grafici dei dati stessi e del loro spettro di potenza. Per maggiori informazioni sulle opzioni disponibili per gli spettri di potenza, vedi <xref linkend="power-spectra"/>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guilabel
>Vettore dell'asse X</guilabel>
</term>
<listitem>
<para
>Il vettore da usare come vettore indipendente per i grafici. Puoi selezionare un campo dal tuo file di dati, o il vettore INDEX. Siccome <filename
>gyrodata.dat</filename
> non contiene un vettore X, lascia la selezione come INDEX. </para>
</listitem>
</varlistentry>

</variablelist>

<para
>La sottosezione <guilabel
>Opzioni FFT</guilabel
> nella sezione <guilabel
>Tipi di grafico</guilabel
> è disponibile solo se deve essere tracciato uno spettro di potenza. Questa esercitazione non tratterà i dettagli degli spettri di potenza, quindi per questa sottosezione usa le impostazioni predefinite. </para>

<para
>Una volta che sei soddisfatto di tutte le impostazioni, fai clic su <guibutton
>Avanti</guibutton
> per avanzare alla prossima finestra. </para>

<screenshot>
<screeninfo
>Schermata dell'assistente di dati 3</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datawizard3.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Schermata dell'assistente di dati 3</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Da qui puoi cambiare le impostazioni generali di tracciamento. La maggior parte delle impostazioni si spiegano da sé. Seleziona <guilabel
>1 nuovo grafico per curva</guilabel
> per <guilabel
>Posizionamento delle curve</guilabel
> e <guilabel
>In una finestra nuova</guilabel
> per <guilabel
>Posizionamento dei grafici</guilabel
>. Ciò posizionerà tutti e sei i grafici (tre curve e tre spettri di potenza) nella stessa finestra. </para>


<para
>Una volta che sei soddisfatto di tutte le impostazioni, fai clic su <guibutton
>Fine</guibutton
> e i grafici saranno generati: </para>
<screenshot>
<screeninfo
>I grafici generati</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tutorial-datawizard-done.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>I grafici generati</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Per generare questi grafici ci è voluto un po' di sforzo, quindi dovremmo salvare la sessione corrente di &kst; (sarà usata nella prossima sessione di questa esercitazione). Seleziona <guimenuitem
>Salva con nome...</guimenuitem
> dal menu <guimenu
>File</guimenu
>, e salva la sessione come <filename
>miasessionedikst.kst</filename
>: </para>

<screenshot>
<screeninfo
>Salvare una sessione di Kst</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-filesave.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Salvare una sessione di Kst</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Il salvataggio di una sessione di &kst; salva tutti i grafici, gli oggetti di dati (ne saprai di più dopo), e gli schemi che esistono al momento del salvataggio. </para>
<para
>Una volta che il file è stato salvato, puoi uscire da &kst;. </para>
</sect1>

<sect1 id="mousezooming">
<title
>I fondamentali della manipolazione dei grafici</title>
<para
>Ora che hai confidenza col creare grafici in &kst;, possiamo esplorare alcune delle funzionalità di manipolazione dei grafici disponibili dall'interfaccia utente grafica di &kst;. Avvia &kst; dalla riga di comando con il file <filename
>miasessionedikst.kst</filename
> che hai salvato prima: </para>
<screen
><userinput
><command
>kst miasessionedikst.kst</command
></userinput
></screen>
<para
>Tutti i grafici che hai creato prima dovrebbero essere ora caricati in &kst;. Esamina il grafico con l'etichetta dell'asse Y <literal
>PSD [V/Hz^{1/2}]</literal
>. Per dare un'occhiata più da vicino al grafico, facci clic destro e seleziona <guimenuitem
>Massimizza</guimenuitem
>, come mostrato sotto: </para>
<screenshot>
<screeninfo
>Massimizzare un grafico</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-zoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Massimizzare un grafico</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Ora il grafico è massimizzato nella finestra attuale. Nota che a valori alti di x questo grafico è quasi del tutto piatto, quindi sarebbe utile vedere solo la parte interessante del grafico. Per farlo, assicurati di essere nella modalità di ingrandimento XY con il mouse (seleziona <guimenuitem
>Ingrandimento XY con il mouse</guimenuitem
> dal menu <guimenu
>Grafici</guimenu
>, o fai clic sul pulsante della barra degli strumenti <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xymousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
>). Poi, semplicemente, trascina un rettangolo attorno all'area interessante. Nota che le coordinate del cursore del mouse sono visualizzate nell'angolo in basso a destra della finestra di &kst; (se non lo sono, assicurati che <guimenuitem
>Mostra la barra degli strumenti</guimenuitem
> sia segnato nel menu <guimenu
>Impostazioni</guimenu
>). </para>

<para
>Gli assi del grafico cambieranno per <quote
>ingrandire</quote
> l'area selezionata del grafico. Potresti notare che c'è un picco sul bordo sinistro dello spettro di potenza che si estende oltre il nuovo limite dell'asse Y. Supponiamo che tu voglia vedere la cima di questo picco. Fai clic destro sul grafico e seleziona <guimenuitem
>Su</guimenuitem
> dal sottomenu <guimenu
>Scorrimento</guimenu
>. Il grafico dovrebbe scorrere in alto. Ovviamente, è molto probabilmente più semplice usare il tasto scorciatoia associato all'elemento del menu; ciò è vero per la maggior parte delle funzioni di ingrandimento e scorrimento. In questo caso, il tasto scorciatoia è <keysym
>freccia in alto</keysym
>, quindi il modo più veloce di scorrere in alto sarebbe tenere premuto il tasto <keysym
>freccia in alto</keysym
>. Per tornare all'ingrandimento massimo, fai clic destro in qualsiasi momento sul grafico e seleziona <guimenuitem
>Ingrandimento massimo</guimenuitem
> dal menu <guisubmenu
>Ingrandimento</guisubmenu
> (o premi <keycap
>M</keycap
>, il tasto scorciatoia assegnato a <guimenuitem
>Ingrandimento massimo</guimenuitem
>). </para>

<para
>Ripristina le dimensioni del grafico dello spettro di potenza facendo clic destro sul grafico e deselezionando <guimenuitem
>Massimizza</guimenuitem
>. </para>

<para
>Ora dai un'occhiata ai grafici con gli assi Y etichettati <literal
>Colonna 2</literal
> e <literal
>Colonna 3</literal
>. Questi sono rispettivamente i grafici del giroscopio di elevazione e di quello di rotazione del volo BOOMERANG del 1998. Siccome questi due grafici sono apparentati, può essere utile scorrerli e ingrandirli simultaneamente. Fai clic sui quadrati situati negli angoli in alto a destra dei due grafici. Dovrebbero scurirsi per indicare che i due grafici sono ora vincolati uno all'altro: </para>

<screenshot>
<screeninfo
>Ingrandimento vincolato</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-tiedzoom.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ingrandimento vincolato</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Prima di provare a ingrandire, dovremmo eliminare tutti i grafici tranne quelli con cui stiamo lavorando. Seleziona <guimenuitem
>Modalità schema</guimenuitem
> dal menu <guimenu
>Grafici</guimenu
> o fai clic sul pulsante <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-layoutmode.png" format="PNG"/></imageobject
></inlinemediaobject
> della barra degli strumenti. Fai clic destro su ogni grafico diverso dai due che vogliamo tenere, e seleziona <guimenuitem
>Elimina</guimenuitem
>. Quindi, fai clic destro da qualsiasi parte nella finestra attuale e seleziona <guimenuitem
>Pulisci schema</guimenuitem
>. Adesso i due grafici dovrebbero condividere il massimo spazio dentro la finestra. Ritorna alla modalità di ingrandimento XY con il mouse quando hai finito. </para>

<para
>Adesso prova a ingrandire qualsiasi porzione del grafico superiore. Noterai che il grafico inferiore si svuoterà. Ciò accade perché gli assi del grafico inferiore sono cambiati per adattarsi agli assi del grafico superiore, e in quella regione particolare del grafico inferiore non ci sono dati. Premi <keycap
>M</keycap
> mentre il cursore del mouse è su uno dei grafici per tornare all'ingrandimento massimo su entrambi i grafici. Adesso tieni premuto <keycap
>Ctrl</keycap
> (ciò equivale a selezionare la modalità <guimenu
>Ingrandimento X con il mouse</guimenu
> dal menu <guimenu
>Grafici</guimenu
> o facendo clic sul pulsante <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-xmousezoom.png" format="PNG"/></imageobject
></inlinemediaobject
> della barra degli strumenti). Il cursore del mouse cambierà forma per indicare il cambiamento. Tenendo premuto <keycap
>Ctrl</keycap
>, disegna un rettangolo nel grafico superiore. Nota che l'altezza del rettangolo tratteggiato è limitata in modo che solo l'asse X sarà ingrandito. Adesso entrambi i grafici visualizzeranno i dati quando saranno ingranditi, perché l'asse Y non è stato cambiato. </para>
<tip>
<para
>Puoi vincolare o svincolare rapidamente tutti i grafici nella finestra selezionando <guimenuitem
>Ingrandimento vincolato</guimenuitem
> dal menu <guimenu
>Grafici</guimenu
> o facendo clic sul pulsante <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-tiedzoom.png" format="PNG"/></imageobject
></inlinemediaobject
> della barra degli strumenti. </para>
</tip>
<para
>Quando hai finito di sperimentare con le funzionalità di ingrandimento, puoi chiudere &kst;. Non c'è bisogno di salvare i grafici stavolta (a meno che tu lo voglia). </para>

</sect1>



<sect1 id="overviewdataobjects">
<title
>Una breve panoramica degli oggetti di dati</title>
<para
>&kst; è più che il semplice tracciamento e la visualizzazione dei dati. Dall'assistente dei dati, hai già visto che &kst; ha la capacità di creare spettri di potenza dei dati. In realtà, &kst; è anche in grado di creare altri oggetti di dati come istogrammi, equazioni, e plugin. Un programma chiamato Gestore dei dati può aiutarti a tenere traccia di tutti gli oggetti di dati che crei. </para>

<para
>Avvia &kst; con il file <filename
>demo.kst</filename
>, incluso nel pacchetto dimostrativo: </para>
<screen
><userinput
><command
>kst demo.kst</command
></userinput
></screen>
<screenshot>
<screeninfo
>Kst con demo.kst</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-demo.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Kst con demo.kst</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Questa sessione di &kst; contiene vettori e altri oggetti di dati creati da dati in <filename
>gyrodata.dat</filename
>. Il grafico superiore contiene i dati azimutali, il grafico centrale contiene i dati di beccheggio, e il grafico inferiore mostra lo spettro di potenza dei dati di beccheggio in blu. Per prima cosa esaminiamo più attentamente i grafici. Vincola i due grafici superiori usando la tecnica che hai imparato nella sezione precedente. Quindi tieni premuto <keycap
>Ctrl</keycap
> per entrare nella modalità di ingrandimento X con il mouse. Adesso ingrandisci in una piccola regione del grafico superiore (diciamo da 50000 a 53000), per far ingrandire entrambi i grafici. Noterai che la curva blu del beccheggio è correlata negativamente con la curva rossa dell'azimut. Questo succede perché il giroscopio del beccheggio era leggermente ruotato relativamente all'asse azimutale (di -0,69 gradi). Il beccheggio vero <literal
>p'</literal
> è: <informalequation
> <mediaobject
> <imageobject
> <imagedata fileref="Equation-kst-correctedpitch.png" format="PNG"/> </imageobject
> </mediaobject
> </informalequation
> dove <literal
>p</literal
> è il beccheggio originale, <inlinemediaobject
><imageobject
><imagedata fileref="Symbol-kst-theta.png" format="PNG"/></imageobject
></inlinemediaobject
> è la rotazione del giroscopio di beccheggio relativa all'asse azimutale, e <literal
>a</literal
> è il giroscopio azimutale. <literal
>p'</literal
> è tracciato come una curva nera nel grafico centrale. Lo spettro di potenza di <literal
>p'</literal
> è la curva nera nel grafico in fondo. </para>

<para
>Adesso diamo un'occhiata a come sono stati creati i tre grafici. Per visualizzare il Gestore dei dati, seleziona <guimenuitem
>Gestore dei dati...</guimenuitem
> dal menu <guimenu
>Dati</guimenu
>, o fai clic sul pulsante <inlinemediaobject
><imageobject
><imagedata fileref="Icon-kst-datamanager.png" format="PNG"/></imageobject
></inlinemediaobject
> della barra degli strumenti: </para>
<screenshot>
<screeninfo
>Il Gestore dei dati</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-datamanager.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Il Gestore dei dati</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Il Gestore di dati contiene l'elenco completo degli oggetti di dati nella sessione attuale di &kst;. Ti permette anche di modificare o creare nuovi oggetti di dati. Come puoi vedere, ci sono sei curve (ognuna creata da un paio di vettori), un'equazione, due spettri di potenza, e quattro vettori di dati. Fai clic destro su C2-GY_PITCH e seleziona <guimenuitem
>W1-P1</guimenuitem
> dal sottomenu <guisubmenu
>Rimuovi dal grafico</guisubmenu
>. Ciò rimuove la curva dal grafico P1 nella finestra W1. Rimuovi anche PSD2-V3-GY_PITCH dal grafico P3 nella finestra W1 usando lo stesso procedimento. Adesso dovrebbero essere visibili nel grafico solo le curve corrette: </para>

<screenshot>
<screeninfo
>Solo le curve corrette</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-democorrected.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Solo le curve corrette</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Per vedere come è stato creato il giroscopio del beccheggio corretto, evidenzia C4-cleaned_pitch e fai clic sul pulsante <guibutton
>Modifica</guibutton
>. Dovrebbe essere visualizzata la finestra di modifica delle equazioni: </para>
<screenshot>
<screeninfo
>Modifica equazione</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-editequation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Modifica equazione</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Nota che l'equazione usata per calcolare <literal
>p'</literal
> è stata inserita nella casella di testo <guilabel
>Equazione</guilabel
> (è stata usata un'approssimazione di 1 per <literal
>cos(-0.69)</literal
>). Sperimenta pure con le impostazioni di questa finestra. Fai clic su <guilabel
>OK</guilabel
> (per salvare tutti i cambiamenti effettuati) o <guibutton
>Annulla</guibutton
> quando hai finito. </para>

<para
>Nota che tutti gli oggetti di dati hanno un numero elencato sotto la colonna <guilabel
># usato</guilabel
>. Questo numero indica il numero di volte che l'oggetto di dati è usato da altri oggetti o dai grafici. Siccome abbiamo rimosso una curva e uno spettro di potenza, almeno due oggetti di dati dovrebbero avere un 0 elencato sotto questa colonna. Fai clic su <guibutton
>Pulisci</guibutton
> per rimuovere permanentemente tutti gli oggetti di dati non usati. </para>

<para
>Fai clic su <guibutton
>Chiudi</guibutton
> per chiudere il Gestore di dati. Adesso puoi uscire da &kst; se vuoi. </para>
</sect1>

<sect1 id="pluginsandevents">
<title
>Uno sguardo ai plugin e agli eventi</title>
<para
>Concludiamo il nostro viaggio attraverso &kst; dando un'occhiata a due tipi specifici di dati: i plugin e i controlli degli eventi. </para>

<para
>Un plugin è un oggetto di dati flessibile il cui comportamento dipende interamente dallo specifico file del plugin selezionato. Il file del plugin può essere uno incluso nella distribuzione standard di &kst;, o può essere un plugin di una parte terza. Puoi trovare istruzioni su come scrivere e compilare dei file di plugin personalizzati in <xref linkend="creatingplugins"/>. I plugin permettono a &kst; di effettuare operazioni arbitrarie su un insieme di dati, perché gli unici requisiti di il file di un plugin sono ricevere un insieme di vettori e scalari di input, e restituire un insieme di vettori e scalari. </para>

<para
>Per esempio, proveremo a regredire a una semplice linea un piccolo insieme di punti di dati. Avvia &kst; con un grafico del primo campo del file di dati <filename
>maxima.dat</filename
> incluso nel pacchetto dimostrativo: </para>

<screen
><userinput
><command
>kst -y 1 -d maxima.dat</command
></userinput
></screen>

<para
>L'opzione <option
>d</option
> specifica che dovrebbero essere tracciati solo i punti, non le linee. Dovrebbe essere ora visualizzato il grafico dei punti di dati: </para>
<screenshot>
<screeninfo
>Grafico dei punti di dati</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-maxima-datapoints.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Grafico dei punti di dati</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Adesso, apri il Gestore dei dati. Fai clic su <guibutton
>Plugin...</guibutton
> nella sezione <guilabel
>Nuovo</guilabel
> per creare un nuovo oggetto plugin. Sotto <guilabel
>Selezione plugin</guilabel
>, seleziona il plugin <guimenuitem
>Regressione lineare</guimenuitem
>. Questo particolare plugin richiede due vettori di input: uno contenente i valori X e uno contenente i valori Y dei punti di dati da cui regredire. Seleziona <guimenuitem
>INDEX</guimenuitem
> per <guilabel
>Vettore di input - array X</guilabel
>, e <guimenuitem
>1</guimenuitem
> per <guilabel
>Vettore di input - Array Y</guilabel
>. Quindi, fai clic su <guibutton
>OK</guibutton
>. Noterai che il nuovo oggetto plugin ha creato dei vettori subordinati per conservare i suoi output. Noterai che il nuovo oggetto plugin ha creato dei vettori per salvare i suoi risultati. Fai clic su <guibutton
>Curva...</guibutton
> per creare una nuova curva dai vettori di output. Seleziona <guimenuitem
>V1-INDEX</guimenuitem
> per <guilabel
>Vettore dell'asse X</guilabel
> e <guimenuitem
>P1-kstfit_linear_unweighted-Y regredito</guimenuitem
> per <guilabel
>vettore dell'asse Y</guilabel
>. Vogliamo inoltre posizionare la curva sui punti dei dati nel grafico esistente, quindi sotto <guilabel
>Posizionamento della curva</guilabel
> seleziona <guilabel
>Posiziona in un grafico esistente</guilabel
> e deseleziona <guilabel
>Posiziona in un nuovo grafico</guilabel
>. Infine, fai clic su <guibutton
>OK</guibutton
> per creare la curva. Chiudi il Gestore dei dati per vedere la linea regredita: </para>

<screenshot>
<screeninfo
>Linea regredita</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-fittedline.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Linea regredita</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Una procedura simile a quella che hai appena seguito ti permetterà di creare e tracciare gli output di qualsiasi tipo di oggetto plugin. Però, c'è una scorciatoia per creare i plugin di regressione. Fare clic destro su un grafico visualizzerà il menu contestuale, che contiene un sottomenu <guisubmenu
>Regressione...</guisubmenu
>. Selezionare una curva dal sottomenu farà apparire la finestra della Funzione di regressione con i vettori X e Y preselezionati. Dopo che il plugin di regressione è stato selezionato, un clic sul pulsante <guibutton
>OK</guibutton
> creerà l'oggetto plugin, creerà la curva dagli output del plugin, e posizionerà la curva sul grafico esistente. </para>

<para
>Diamo ora un'occhiata agli eventi. Normalmente gli oggetti evento controllano altri vettori o scalari ed effettuano delle azioni specifiche quando certe condizioni riguardanti quei vettori o scalari sono vere. Fai clic su <guibutton
>Controllo degli eventi...</guibutton
> nella sezione <guilabel
>Nuovo</guilabel
> del Gestore dei dati per creare un nuovo evento: </para>
<screenshot>
<screeninfo
>Controllo degli eventi</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-eventmonitor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Controllo degli eventi</phrase>
</textobject>
</mediaobject>
</screenshot>

<!-- FIXME: This seems to be incorrect: the equation given doesn't work -->
<para
>Supponiamo che i dati giroscopici siano aggiornati in tempo reale, e che vogliamo essere avvertiti ogni volta che il giroscopio di beccheggio corretto esce dall'intervallo <literal
>[-0.60, -0.40]</literal
>. Per impostare l'evento in questo modo, inserisci ciò che segue nella casella di testo <guilabel
>Espressione</guilabel
>: </para>

<para>
<literal
>[C4-cleaned_pitch-sv]&gt;(-0.40) | [C4-cleaned_pitch-sv]&lt;(-0.60)</literal>
</para>

<para
>Nota che qualsiasi cosa inserita come espressione deve essere un'espressione booleana. Questa espressione particolare sarà valutata vera ogni volta che una delle disuguaglianze è vera. Seleziona sia <guilabel
>Registra come</guilabel
> e <guilabel
>Notifica</guilabel
>, e inserisci il tuo indirizzo di posta elettronica a destra della casella <guilabel
>Notifica</guilabel
>. Fai clic su <guibutton
>OK</guibutton
>, e l'evento sarà creato. </para>

<para
>Adesso seleziona <guimenuitem
>Debug di Kst...</guimenuitem
> dal menu <guimenu
>Aiuto</guimenu
>. Fai clic sulla scheda <guilabel
>Log</guilabel
> per vedere il log di debug. Se l'evento è stato impostato correttamente, dovresti vedere degli avvertimenti che indicano i valori X per cui l'evento è stato attivato. Controlla che i valori corrispondano approssimativamente a quelli che ti aspetteresti guardando il grafico: </para>

<screenshot>
<screeninfo
>Log di debug</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="Screenshot-kst-debuglog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Log di debug</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Se i dati giroscopici del beccheggio fossero stati aggiornati in tempo reale, il controllo degli eventi sarebbe stato attivato anche da qualsiasi nuovo dato quando opportuno. </para>

<para
>Una volta che hai finito, puoi chiudere &kst;. </para>
</sect1>


<sect1 id="conclusion">
<title
>Conclusione</title>

<para
>Ciò conclude l'esercitazione di &kst;. Speriamo che tu abbia guadagnato abbastanza capacità per essere a tuo agio con &kst;. Tieni a mente che questa esercitazione non copre tutte le funzionalità di &kst;; c'è ancora molto da esplorare e da sperimentare. Il resto di questo manuale è una guida dettagliata a concetti che spaziano dai fondamentali degli schemi delle finestre alla creazione di plugin personalizzati e lettori di sorgenti di dati. Sei incoraggiato a usare &kst; in modi interessanti e innovativi; molto probabilmente ti accorgerai che non solo soddisfa, ma supera le tue necessità e aspettative. </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:
-->

