<appendix id="command-lineoptions"> <appendixinfo> <author ><firstname >Barth</firstname > <surname >Netterfield</surname > <affiliation > <address ><email >kst@omega.astro.utoronto.ca</email ></address> </affiliation> </author> </appendixinfo> <title >Uso da riga di comando ed esempi</title> <para >Un uso tipico di Kst è dalla riga di comando per fare grafici X-Y di file di dati. Kst può leggere dati ASCII, o file binari compatibili con readdata. </para> <sect1 id="command-linesynopsis"> <title >Sintassi della riga di comando</title> <para >Le opzioni sono: <cmdsynopsis ><command >kst</command > <arg >opzioni-Qt</arg > <arg >opzioni-KDE</arg > <arg >opzioni</arg > <arg rep="repeat" ><replaceable >file</replaceable ></arg > </cmdsynopsis> </para> <variablelist> <varlistentry> <term ><option >[file...]</option ></term> <listitem> <para >Un file .kst, o uno o più file di dati. I formati supportati sono ASCII in colonne, file di fotogrammi BOOMERANG, o file dirfile BLAST. Un file .kst raccoglie tutte le opzioni che possono essere impostate da altri flag. I flag seguenti possono essere usati per sostituire le opzioni impostate nel file .kst: <option >-F file_di_dati</option >, <option >-n NS</option >, <option >-s NS</option >, <option >-f F0</option >, <option >-a</option >. Il resto non può essere sostituito. Se viene dato un flag di sostituzione, è applicato a tutti i vettori nel grafico. </para> <para >I dati ASCII da stdin possono essere tracciati includendo "stdin" nell'elenco <option >[file...]</option >. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-y Y</option ></term> <listitem> <para >La sorgente dei dati per l'asse Y. Per i file ASCII, questa è la colonna. Per i file binari, questo è il nome del campo. Per tracciare più curve, può essere specificata più volte. Sono assunti lo stesso file sorgente, intervalli di campionamento, e dati dell'asse X. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-e E</option ></term> <listitem> <para >Barre di errore per i dati sull'asse Y. Per i file ASCII, riferisciti alla colonna contenente i dati. Per i file binari usa il nome del campo. Se sono date più opzioni <option >-y Y</option >, anche questa può essere usata più volte. Le singole voci Y sono associate in ordine con le varie voci E. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-x X</option ></term> <listitem> <para >La sorgente per i dati dell'asse X. Per i file ASCII, è la colonna. Per i file readdata, è il nome del campo. Se questa opzione non è specificata, sarà usato il numero della riga. Questa opzione può essere data una sola volta. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-p P</option ></term> <listitem> <para >La sorgente per gli spettri di potenza. Per i file ASCII, è la colonna. Per i file binari, è il nome del campo. Per tracciare spettri di potenza di più curve, può essere specificata più volte. Sono usati lo stesso file sorgente, intervalli di campionamento e lunghezze FFT per tutti gli spettri di potenza richiesti dalla riga di comando. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-l P</option ></term> <listitem> <para >La lunghezza della FFT usata nella stima degli spettri di potenza è 2^P. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-h H</option ></term> <listitem> <para >La sorgente degli istogrammi. Per i file ASCII, è la colonna. Per i file binari, è il nome del campo. Più istogrammi possono essere definiti dalla riga di comando. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-m NC</option ></term> <listitem> <para >Usata quando sono state definite più curve. Piuttosto che tracciare tutte le curve nello stesso grafico, traccia ciascuna nel suo grafico. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-f F0</option ></term> <listitem> <para >Il numero del fotogramma (per i file readdata) o della riga (per i file ASCII) iniziale. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-n</option ></term> <listitem> <para >Il numero di fotogrammi (per i file readdata) o righe (per file ASCII) da leggere. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-s NS</option ></term> <listitem> <para >Il numero di fotogrammi o righe da saltare a ogni lettura. È utile quando si lavora con file di dati molto grandi, per accelerare la risposta e risparmiare memoria, nel caso che i dati cambino lentamente. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-a</option ></term> <listitem> <para >Usata insieme a <option > -s NS</option >: piuttosto che saltare ogni NS fotogrammi, fanne una media. Ciò produce una combinazione di filtraggio passa-alto, e risparmio di memoria. </para> </listitem> </varlistentry> <varlistentry> <term ><option >-F Filedati</option ></term> <listitem> <para >Sostituisci il file da cui leggere i dati per tutti i vettori elencati nel file .kst. Può essere usata solo insieme a un file kst. </para> </listitem> </varlistentry> <varlistentry> <term ><option >--print fileps</option ></term> <listitem> <para >Invece che visualizzare il grafico, esporta l'immagine a un file postscript ed esci. *Nota di errore: anche se non vengono aperte finestre sullo schermo, è comunque necessario l'accesso al server X.* </para> </listitem> </varlistentry> <varlistentry> <term ><option >--png filepng</option ></term> <listitem> <para >Invece che visualizzare il grafico, esporta l'immagine a un file png di dimensioni 640×480 ed esci. *Nota di errore: anche se non vengono aperte finestre sullo schermo, è comunque necessario l'accesso al server X.* </para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="command-lineexamples"> <title >Esempi della riga di comando</title> <para >Seguono diversi esempi di uso comune. </para> <para >Per tracciare la colonna 1 di un file (tmp.dat) di dati ASCII: <informalexample > <screen ><userinput ><command >kst -y 1 tmp.dat</command ></userinput ></screen> </informalexample> </para> <para >Per tracciare le colonne 2, 3 e 4 sulla colonna 1 di un file ASCII, in un grafico: <informalexample > <screen ><userinput ><command >kst -x 1 -y 2 -y 3 -y 4 tmp.dat</command ></userinput ></screen> </informalexample> </para> <para >Per tracciare le colonne 2, 3 e 4 sulla colonna 1 di un file ASCII, in tre grafici, allineati in una colonna: <informalexample > <screen ><userinput ><command >kst -x 1 -y 2 -y 3 -y 4 -m 1 tmp.dat</command ></userinput ></screen> </informalexample> </para> <para >Per tracciare 500 righe della colonna 2 di un file ASCII, partendo dalla riga 100: <informalexample > <screen ><userinput ><command >kst -y 2 -f 100 -n 500 tmp.dat</command ></userinput ></screen> </informalexample> </para> <para >Per tracciare le prima 100˙000 righe della colonna 2 di un file ASCII, facendo la media ogni 100 righe: <informalexample > <screen ><userinput ><command >kst -y 2 -f 0 -n 100000 -s 100 -a tmp.dat</command ></userinput ></screen> </informalexample> </para> </sect1> </appendix>