# Lavorare coi dati

## Formati di file supportati

Attualmente, Kst supporta i file di testo ASCII, file di fotogrammi BOOMERANG, e file dirfile BLAST come sorgenti di dati, oltre ai file PIOLib e FITS con le librerie appropriate. Questa sezione descrive i concetti fondamentali delle sorgenti di dati comuni a tutti i tipi di file, e illustra i dettagli dei tipi di file ASCII e dirfile BLAST.

### Concetti delle sorgenti di dati

Una sorgente di dati in &kst; è semplicemente un file di dati supportato. I seguenti concetti sono importanti per capire come funziona &kst; con diverse sorgenti di dati. In questa sezione viene introdotta anche un po' di terminologia.

#### Campioni

Un campione è considerato essere l'unità fondamentale dei file di dati. Ogni campione corrisponde a un valore di dati nel file. Nota, comunque, che un campione potrebbe non corrispondere a un valore in un vettore di &kst;, a causa del concetto di fotogramma.

#### Campi

Normalmente un campo corrisponde a un vettore in &kst;. Per esempio, una colonna in un file di dati ASCII è considerata essere un campo. Ogni campo può avere un nome esplicito o implicito. I lettori di sorgenti di dati forniscono funzioni per leggere e ottenere i campi e i nomi dei campi.

#### Fotogrammi

Un fotogramma corrisponde a un certo numero di campioni, e ogni campo in un file di dati ha il suo rapporto di campioni per fotogramma. La dimensione di un file di dati è misurata dal numero di fotogrammi che contiene. Per i file di dati ASCII, il numero di campioni per fotogramma è 1, ma per alcuni file di dati ci potrebbero essere più campioni per fotogramma. Nell'illustrazione sotto, sono mostrati i primi tre fotogrammi di un file di dati immaginario. In questo file di dati, il campo 1 ha un rapporto di 5 campioni per fotogramma, il campo 2 ha un rapporto di due campioni per fotogramma, il campo 3 ha un rapporto di tre campioni per fotogramma, e il campo 4 ha un rapporto di un campione per fotogramma.

A seconda delle impostazioni specifiche dei vettori di dati in &kst;, i dati dei file potrebbero essere letti come fotogrammi piuttosto che campioni, con il primo campione in un fotogramma o la media di tutti i campioni in un fotogramma a rappresentare il valore del fotogramma.

#### Campo INDEX

Alcuni file di dati potrebbero non avere un campo rappresentante l'asse X di un grafico. Tuttavia, &kst; crea implicitamente un campo INDEX per tutte le sorgenti di dati. Il campo INDEX contiene semplicemente gli interi da 0 a N-1, dove N è il numero di fotogrammi nel file di dati.

### File di input ASCII

Il formato di inserimento di dati più semplice è il file di testo ASCII. Questi file sono normalmente leggibili da una persona e, volendo, possono essere creati facilmente a mano o con semplici script. Quello che segue è un esempio di un file di input ASCII.

    112.5 3776 428
    187.5 5380 429
    262.5 5245 345
    337.5 2942 184
    412.5 1861 119
    487.5 2424 138
    567.5 2520 162
    637.5 1868 144
    712.5 1736 211
    787.5 1736 211
    862.5 2172 292
    937.5 1174 377
    1000.5 499 623

Ogni colonna di questo file rappresenta un campo, mentre ogni riga rappresenta un fotogramma. Le colonne sono separate da tabulatori o spazi, e le righe sono separate da ritorni a capo. Nota che a causa della loro struttura, i file ASCII non possono avere più campioni per fotogramma. Inoltre, siccome le colonne non hanno etichette, i nomi dei campi sono assegnati da &kst; in base all'ordine delle colonne (la prima colonna a sinistra ha il nome di campo `1`).

Le righe commentate nei file ASCII cominciano con uno dei caratteri dell'insieme `{#, !, /, ;, c}`. Tutte le righe commentate e vuote sono ignorate da &kst;. I numeri validi includono quelli con decimali, segni negativi, o `e`, per indicare la notazione scientifica. I numeri non validi (come le parole in italiano) vengono sostituiti con 0 da &kst;.

### Dirfile BLAST

Le sorgenti di dati dirfile BLAST sono in realtà cartelle di file. Ogni cartella rappresenta una sorgente di dati, e ogni file nella cartella, eccetto il file chiamato `format`, rappresenta un solo campo. Il file chiamato `format` elenca ogni campo e le sue proprietà. Qui sotto c'è un esempio di un file di questo tipo:

    scount RAW f 1
    fcount RAW f 20
    sine RAW f 20
    ssine RAW f 1
    cos RAW f 20

In questo esempio, `scount`, `fcount`, `sine`, `ssine` e `cos` sono nomi di campi. `RAW` indica che il file è scritto in formato RAW (grezzo), e l'ultimo numero di ogni riga è il numero di campioni per fotogramma.

Quando si seleziona un dirfile BLAST per usarlo in &kst;, dovrebbe essere selezionata la cartella contenente i nomi dei campi. &kst; cercherà automaticamente un file `format`, se esiste, per determinare i campi e le loro proprietà.

## L'assistente dati

L'assistente dati fornisce un modo semplice e veloce di creare vettori, curve, spettri di potenza e grafici in &kst; dai file di dati. Per avviare l'assistente, seleziona Assistente dati... dal menu Dati. Ti sarà chiesto di indicare una sorgente di dati. Sfoglia e seleziona un file di dati valido (o inseriscine il percorso) e fai clic su Prossimo. Sarà visualizzata la finestra seguente.

Schermata 2 dell'assistente dati Schermata 2 dell'assistente dati

Seleziona i campi che vuoi importare in &kst;. Puoi filtrare l'elenco di campi inserendo una stringa da far corrispondere (sono supportati i caratteri jolly come `*`) nella casella di testo in cima all'elenco.

La sezione Intervallo dei dati è usata per specificare l'intervallo dei dati da leggere dai vettori selezionati nel file di input. La discussione seguente presume la conoscenza dei fotogrammi. Per una descrizione dettagliata di questo concetto, vedi i formati di file.

Fotogramma di partenza, Conta dalla fine, Numero di fotogrammi, e Leggi fino alla fine

- Usando queste quattro impostazioni, si possono impostare i limiti inferiore e superiore dell'intervallo di dati. Per esempio, per leggere dal fotogramma 10 al fotogramma 900, inserisci `10` come Fotogramma di partenza e `890` come Numero di fotogrammi. Per leggere dal fotogramma 500 fino alla fine del file, inserisci `500` come Fotogramma di partenza e seleziona l'opzione Leggi fino alla fine. Per leggere solo gli ultimi 450 fotogrammi del file, seleziona l'opzione Conta dalla fine e inserisci `450` come Numero di fotogrammi. Le combinazioni usate nei due esempi precedenti sono spesso utili per leggere dati da un file che viene aggiornato in tempo reale. Le aggiunte successive al file vengono lette, facendo aggiornare anche i vettori associati.

Leggi un campione ogni N fotogrammi e Filtro Boxcar per primo

- Oltre ai limiti inferiore e superiore, possono essere impostati i campioni da leggere nell'intervallo selezionato. Se Leggi un campione ogni N fotogrammi (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 Leggi un campione ogni N fotogrammi. Il valore del campione usato per rappresentare un fotogramma dipende dallo stato di selezione di Filtro Boxcar per primo. Se Filtro Boxcar per primo è selezionato, il valore è la media di tutti i campioni in quel fotogramma.

Le impostazioni degli spettri di potenza e dell'asse X possono essere specificate nella sezione Tipi di grafico. Queste impostazioni sono come descritto sotto.

XY, Spettro di potenza, e XY e spettro di potenza

- Seleziona se tracciare solo lo spettro di potenza, solo i dati (XY), o entrambi. Se lo spettro di potenza è selezionato per il tracciamento, in questa sezione diverranno disponibili delle impostazioni aggiuntive.

Vettore dell'asse X

- Il vettore da usare come vettore indipendente per i grafici. Puoi selezionare un campo dal tuo file di dati, o il vettore INDEX. Il vettore INDICE è semplicemente un vettore contenente elementi da 0 a N-1, dove N è il numero di fotogrammi nel file di dati.

La sottosezione Opzioni FFT nella sezione Tipi di grafico è disponibile solo se c'è uno spettro di potenza da tracciare. Le definizioni sotto presuppongono delle conoscenze di base sugli spettri di potenza; per maggiori dettagli, riferisciti a Numerical Recipes in C: The Art of Scientific Computing, pubblicato da Cambridge University Press.

Media interlacciata e Lunghezza FFT

- Lo spettro di potenza è definito come la radice quadrata del valore assoluto della media della trasformata veloce di Fourier interlacciata di lunghezza `2^x`, dove x è il valore inserito nella casella di selezione Lunghezza FFT. Selezionare Media interlacciata permette di specificare la lunghezza della trasformata veloce di Fourier interlacciata. Se Media interlacciata è deselezionato, &kst; determinerà la lunghezza in base alla lunghezza del vettore.

Unità dei dati e Unità della frequenza

- Le unità specificate in queste caselle di testo sono usate per poter autogenerare le etichette degli assi per i grafici.

Frequenza di campionamento

- La frequenza di campionamento è usata per generare l'asse X dei grafici di spettro di potenza.

Pulisci

- Se questa opzione è selezionata, i dati sono puliti usando una finestra Hanning, per ridurre la perdita tra dati.

Rimuovi media

- Seleziona questa opzione per rimuovere la media dai dati selezionati (cioè traduci i dati in modo che la media sia zero).

Una volta che sei soddisfatto di tutte le impostazioni, fai clic su Avanti per avanzare alla prossima finestra. Seleziona ogni filtro che vuoi applicare ai dati, e fai clic su Avanti per avanzare alla finestra finale.

Schermata 3 dell'assistente dati Schermata 3 dell'assistente dati

Da qui puoi cambiare le impostazioni generali di tracciamento. La maggior parte delle impostazioni si spiegano da sé. Sotto è data una breve panoramica di ogni sezione.

Stile delle curve

- Scegli se tracciare solo i punti dei dati, solo le linee che li connettono, o entrambi. Come valore predefinito, le linee sono continue con peso 0, e i punti dei dati sono segnati con delle croci. I colori delle linee e dei punti dei dati sono scelti in modo che siano minimizzate le curve con colori uguali. Nota che le impostazioni dello stile delle curve si applicano sia agli spettri di potenza che ai grafici XY.

Posizionamento delle curve

- Scegli il grafico su cui mettere le nuove curve. Ruota distribuisce le curve sui grafici ruotando tra i grafici. Nota che le impostazioni di posizionamento delle curve si applicano sia agli spettri di potenza che ai grafici XY.

Generazione delle etichette

- Seleziona le etichette e le legende che vuoi mettere sui grafici.

Posizionamento dei grafici

- Seleziona le finestre in cui vuoi posizionare i nuovi grafici. Si possono creare finestre nuove per i grafici selezionando In una finestra nuova.

Una volta che sei soddisfatto delle impostazioni, fai clic su Fine e i grafici saranno generati.

## Il gestore dei dati

Il gestore dei dati fornisce un posto centrale per aggiungere, eliminare, e modificare tutti gli oggetti di dati usati in &kst;. Ci si può accedere selezionando Gestore dei dati dal menu Dati.

### Creare nuovi oggetti di dati

Per creare un nuovo oggetto di dati dal Gestore dei dati, fai clic su uno dei pulsanti elencati sotto Nuovo:. Sarà visualizzata una nuova finestra, che permetterà di impostare le opzioni e le impostazioni dell'oggetto di dati.

Puoi anche creare nuove curve facendo clic destro su un vettore e scegliendo Crea curva...

Siccome stai creando un nuovo oggetto di dati, puoi inserire un nome univoco per identificare l'oggetto. Può anche essere usato il nome predefinito (se è univoco).

Le impostazioni per tutti gli oggetti di dati tracciabili, eccetto le immagini, hanno due sezioni in comune: Aspetto e Posizionamento (le immagini hanno solo la sezione di Posizionamento). Queste sezioni sono descritte sotto. Per le impostazioni specifiche dei dati, vedi Tipi di dati.

#### Aspetto

La sezione Aspetto ti permette di cambiare l'aspetto dell'oggetto di dati quando è tracciato.

- Fare clic su questo pulsante visualizza una finestra di scelta di colore, che può essere usata per cambiare il colore di linee e punti.

Mostra punti

- Selezionare questa casella mostra i punti dei dati usati per tracciare l'oggetto di dati. L'elenco a cascata a destra permette di cambiare la forma dei punti.

Mostra linee

- Selezionare questa casella mostra le linee che uniscono i punti dei dati per l'oggetto di dati. Lo spessore e lo stile della linea possono essere cambiati.

#### Posizionamento

La sezione Posizionamento specifica la posizione di tracciamento dei nuovi oggetti di dati tracciabili.

Finestra del grafico

- Specifica la finestra in cui tracciare l'oggetto di dati. Puoi creare una nuova finestra facendo clic sul pulsante Nuovo....

Posiziona in un grafico esistente, Posiziona in un grafico nuovo e Non posizionare in nessun grafico

- Puoi scegliere se tracciare immediatamente l'oggetto di dati o meno su un nuovo grafico. Se è selezionato Posiziona in un nuovo grafico, puoi anche scegliere di riordinare lo schema dei grafici selezionando Ridefinisci la griglia e inserendo il numero di colonne da usare per la nuova griglia dello schema.

Una volta che le impostazioni desiderate sono state impostate, fai clic sul pulsante OK per creare il nuovo oggetto di dati.

### Modificare ed eliminare oggetti di dati esistenti

Per modificare un oggetto di dati esistente, evidenzialo nella finestra del Gestore di dati e fai clic sul pulsante Modifica. Sarà visualizzata la finestra delle impostazioni dell'oggetto selezionato. Questa finestra è identica a quella visualizzata quando si creano dei nuovi oggetti (con l'eccezione che la sezione Posizionamento potrebbe essere assente), quindi riferisciti a Creare nuovi oggetti di dati per maggiori informazioni su impostazioni e opzioni.

Per eliminare un oggetto di dati, evidenzialo nella finestra del Gestore di dati e fai clic sul pulsante Elimina. Nota che la voce nella colonna # usati per un oggetto deve essere 0 prima che l'oggetto possa essere eliminato. La colonna # usati indica il numero di volte che un certo oggetto di dati e i suoi figli (se ce ne sono) sono usati o da altri oggetti di dati o dai grafici. Qui sotto sono elencate alcune delle conseguenze di questa restrizione da tenere a mente quando provi a eliminare oggetti di dati.

- Tutti gli oggetti tracciabili (curve, equazioni, istogrammi, spettri di potenza e immagini) devono essere rimossi dai grafici prima che questi ultimi possano essere eliminati. Un oggetto può essere rimosso da un grafico facendoci clic destro nella finestra del Gestore dei dati e selezionando il grafico desiderato dal sottomenu Rimuovi dal grafico.

- Devono essere eliminati tutti gli oggetti di dati che usano un certo vettore di dati prima che possa essere eliminato il vettore di dati.

- Tutti i figli di un oggetto dati madre devono non essere in uso prima che l'oggetto di dati madre possa essere eliminato.

Dopo una serie di eliminazioni e rimozioni di oggetti di dati tracciabili dai grafici, potresti accorgerti che ci sono molti oggetti di dati inutilizzati visualizzati nel Gestore dei dati. Per rimuovere rapidamente questi oggetti, puoi fare clic sul pulsante Pulisci.

## Tipi di dati

Ci sono nove tipi principali di oggetti di dati in &kst;. Gli oggetti di dati possono contenere altri oggetti di dati, come rappresentato dalla vista ad albero nel Gestore dei dati. Il diagramma seguente illustra le relazioni tra i diversi tipi di dati.

Tipi di dati di &kst;

Come si può vedere dal diagramma sopra, gli oggetti di dati curva, equazione, istogramma, spettro di potenza e immagine sono i soli oggetti di dati tracciabili. Tutti gli oggetti di dati (oltre ai vettori) sono in grado di usare i vettori, mentre le equazioni, gli spettri di potenza, gli eventi e i plugin contengono vettori subordinati.

Le descrizioni di ogni tipo di dati sono fornite sotto, insieme con delle panoramiche delle impostazioni e delle opzioni disponibili quando si crea o si modifica ciascun tipo di oggetto di dati. Le impostazioni comuni a quasi tutti i tipi di dati sono state omesse; vedi Creare nuovi oggetti di dati per maggiori informazioni.

### Vettori

I vettori sono uno degli oggetti di dati usati più spesso in &kst;. Come dice il nome, i vettori sono dei semplici elenchi di numeri. La maggior parte delle volte contengono le coordinate X e Y di un insieme di punti di dati.

Siccome i vettori possono essere piuttosto grandi, è una buona idea sapere quanta memoria &kst; ha allocato per il loro uso. La memoria attualmente disponibile è visualizzata nell'angolo in basso a destra della barra di stato della finestra principale di &kst;.

Se la barra di stato non è disponibile, assicurati che Mostra la barra di stato sia segnato nel menu Impostazioni.

Quello che segue è un'istantanea della finestra visualizzata quando si creano o si modificano i vettori. Le spiegazioni delle impostazioni sono elencate sotto.

Modifica dei vettori Modifica dei vettori

#### Parametri del vettore dati

Il file e il campo sorgenti da leggere possono essere impostati usando le seguenti opzioni.

Nome file

- Il percorso al file di dati desiderato. Fare clic sul pulsante a destra visualizza una finestra di scelta dei file che può essere usata per navigare graficamente fino al file.

Campo o colonna

- Il campo o la colonna da cui creare un vettore.

#### Intervallo dei dati

Questa sezione specifica l'intervallo di dati da usare dal campo selezionato per il vettore di dati.

Fotogramma di partenza, Conta dalla fine, Numero di fotogrammi, e Leggi fino alla fine

- Usando queste quattro impostazioni, si possono impostare i limiti inferiore e superiore dell'intervallo di dati. Per esempio, per leggere dal fotogramma 10 al fotogramma 900, inserisci `10` come Fotogramma di partenza e `890` come Numero di fotogrammi. Per leggere dal fotogramma 500 fino alla fine del file, inserisci `500` come Fotogramma di partenza e seleziona l'opzione Leggi fino alla fine. Per leggere solo gli ultimi 450 fotogrammi del file, seleziona l'opzione Conta dalla fine e inserisci `450` come Numero di fotogrammi. Le combinazioni usate nei due esempi precedenti sono spesso utili per leggere dati da un file che viene aggiornato in tempo reale. Le aggiunte successive al file vengono lette, facendo aggiornare anche i vettori associati.

Leggi un campione ogni e Filtro Boxcar per primo

- In aggiunta ai limiti inferiore e superiore dell'intervallo, possono essere impostati i campioni da leggere nell'intervallo selezionato. Se Leggi un campione ogni non è selezionato, saranno letti tutti i campioni nell'intervallo selezionato. Se Leggi un campione ogni è selezionato, sarà letto solo un campione ogni `N` fotogrammi, dove `N` è il numero inserito nella casella di selezione a destra. Il valore di un campione usato per rappresentare un fotogramma dipende dallo stato di selezione di Filtro Boxcar per primo. Se Filtro Boxcar per primo non è selezionato, il valore è lo stesso del valore del primo campione del fotogramma. Se Filtro Boxcar per primo è selezionato, il valore è la media di tutti i campioni in quel fotogramma.

### Curve

Le curve sono usate essenzialmente per creare oggetti tracciabili dai vettori. Le curve sono create da due vettori: il vettore dell'asse X e il vettore dell'asse Y, che si suppone forniscano una serie di punti di dati. Perciò, una curva può essere immaginata come un insieme di punti di dati delle linee che li connettono (anche se i punti e le linee possono non essere visibili sui grafici).

Quella che segue è un'istantanea della finestra visualizzata quando si creano o modificano le curve. Le spiegazioni delle impostazioni sono elencate sotto.

Modifica delle curve Modifica delle curve

#### Contenuti delle curve

Da questa sezione si possono impostare i contenuti della curva.

Vettore dell'asse X

- Il vettore da usare per l'asse indipendente (orizzontale).

Vettore dell'asse Y

- Il vettore da usare per l'asse dipendente (verticale).

Barra d'errore +X e Barra d'errore +Y

- I vettori contenenti i valori degli errori corrispondenti rispettivamente al vettore dell'asse X e al vettore dell'asse Y. I vettori dovrebbero contenere le dimensioni delle barre d'errore nello stesso ordine dei punti di dati.

Usa la barra d'errore +`X/Y` per -`X/Y`

- Se questo elemento è segnato, le barre d'errore sono disegnate simmetricamente rispetto al punto di dati. Per disegnare delle barre d'errore asimmetriche nelle direzioni X o Y, deseleziona la casella e scegli un vettore per la lunghezza della barra d'errore sotto il punto di dati nella casella combinata Barra d'errore -`X/Y`.

Barra d'errore -`X/Y`

- Il vettore da usare per la barra d'errore sotto il punto di dati. Vedi la voce precedente per maggiori dettagli sull'uso di barre d'errore asimmetriche.

### Equazioni

Un oggetto di dati equazione consiste di un'espressione matematica e di una variabile indipendente. L'espressione è costruita usando una combinazione di scalari, vettori e operatori, e normalmente rappresenta i valori della variabile dipendente. La variabile indipendente può essere un vettore esistente o può essere generata quando l'oggetto equazione viene creato o modificato. Siccome in ultima analisi un'equazione è fatta di un insieme di punti di dati, un oggetto equazione è tracciabile.

Quella che segue è un'istantanea della finestra visualizzata quando si creano o modificano equazioni. Le spiegazioni delle impostazioni sono elencate sotto.

Modifica delle equazioni Modifica delle equazioni

#### Equazione

L'espressione matematica che rappresenta la variabile dipendente può essere modificata da questa sezione.

Operatori

- Un elenco di operatori disponibili. Scegliere un operatore dall'elenco lo inserisce nel punto di inserimento corrente nella casella di testo Equazione.

Vettori

- Un elenco degli oggetti vettori correnti in &kst;. Scegliere un vettore dall'elenco lo inserisce nel punto di inserimento corrente nella casella di testo Equazione.

Scalari

- Un elenco dei valori scalari disponibili. Questo elenco è composto sia dai valori scalari nella sessione corrente di &kst;, sia da alcune costanti incorporate. Scegliere uno scalare dall'elenco lo inserisce nel punto di inserimento corrente nella casella di testo Equazione.

Equazione

- L'espressione matematica che rappresenta la variabile indipendente. Puoi scrivere a mano in questa casella di testo o puoi selezionare gli elementi da inserire usando gli elenchi a cascata sopra.

#### Variabile indipendente

Questa sezione è usata per specificare la sorgente dei valori della variabile indipendente.

Usa

- Seleziona questa opzione per usare un vettore esistente come variabile indipendente. Seleziona un vettore dall'elenco a cascata, o creane rapidamente uno nuovo facendo clic sul pulsante a destra.

Interpola al vettore a massima risoluzione

- Selezionare questa opzione interpola il vettore selezionato al massimo numero di campioni possibile.

Genera

- Seleziona questo per generare un insieme di valori da usare come variabile indipendente. Specifica il valore minimo da generare nel campo Da, e il valore massimo nel campo A. Imposta il valore di Numero di campioni al numero di valori equispaziati da generare tra i valori minimo e massimo (inclusi).

### Istogrammi

Un oggetto di dati istogramma rappresenta semplicemente un istogramma di un vettore particolare. Gli oggetti istogramma sono tracciabili.

Quella che segue è un'istantanea della finestra visualizzata quando si creano o modificano gli istogrammi. Le spiegazioni delle impostazioni sono elencate sotto.

Modifica delle equazioni Modifica delle equazioni

#### Proprietà dell'istogramma

Il vettore sorgente, così come le proprietà di base dell'istogramma, può essere modificato da questa sezione. Puoi specificare le impostazioni manualmente o usare il pulsante Autobarre.

Vettore dei dati

- Il vettore dei dati da cui creare l'istogramma. Sebbene un vettore sia necessario per creare un istogramma, il vettore è trattato come un insieme non ordinato per quanto riguarda la creazione dell'istogramma.

Da e A

- Il campo Da contiene il limite sinistro per la barra più a sinistra dell'istogramma. Il campo A contiene il limite destro per la barra più a destra dell'istogramma.

Numero di barre

- Inserisci il numero totale di barre da usare nel campo Numero di barre.

Autobarre

- Invece di specificare il valori di Da, A, e Numero di barre, puoi fare clic su Autobarre per generare automaticamente i valori per tutti e tre i campi in base ai valori massimo e minimo, oltre al numero di elementi trovati nel vettore sorgente.

#### Normalizzazione asse Y

Questa sezione è usata per specificare il tipo di normalizzazione usata per l'asse Y dell'istogramma.

Numero nella barra

- Selezionare questa opzione fa rappresentare all'asse Y il numero di elementi in ogni barra.

Frazione nella barra

- Selezionare questa opzione fa rappresentare all'asse Y la frazione di elementi in ogni barra sul totale degli elementi.

Percentuale nella barra

- Selezionare questa opzione fa rappresentare all'asse Y la percentuale di elementi (sul totale degli elementi) in ogni barra.

Barra massima = 1.0

- Selezionare questa opzione fa rappresentare all'asse Y il numero di elementi in ogni barra diviso dal numero di elementi nella barra più grande (la barra con il massimo numero di elementi). In parole povere, l'asse Y è normalizzato a 1.0.

### Spettri di potenza

Un oggetto di dati spettro di potenza rappresenta lo spettro di potenza di un vettore, definito come la radice quadrata del valore assoluto della media della trasformata veloce di Fourier interlacciata di lunghezza `2^x` del vettore, dove x è il valore inserito nella casella di selezione Lunghezza FFT. Le definizioni sotto presuppongono delle conoscenze di base sugli spettri di potenza; per maggiori dettagli, riferisciti a Numerical Recipes in C: The Art of Scientific Computing, pubblicato da Cambridge University Press.

Finestra degli spettri di potenza Finestra degli spettri di potenza

#### Contenuti delle curve

Il vettore sorgente, così come le proprietà fondamentali degli spettri di potenza, può essere modificato da questa sezione.

Vettore dei dati

- Il vettore di dati da cui creare uno spettro di potenza.

Media interlacciata e Lunghezza FFT

- Selezionare Media interlacciata permette di specificare la lunghezza della trasformata veloce di Fourier interlacciata. La lunghezza è specificata come una potenza di 2. Se Media interlacciata non è segnata, &kst; determinerà la lunghezza in base alla lunghezza del vettore.

Unità dei dati e Unità della frequenza

- Le unità specificate in queste caselle di testo sono usate per poter autogenerare le etichette degli assi per i grafici.

Frequenza di campionamento

- La frequenza di campionamento è usata per generare l'asse X dei grafici di spettro di potenza.

Pulisci

- Se questa opzione è selezionata, i dati sono puliti usando una finestra Hanning, per ridurre la perdita tra dati.

Rimuovi media

- Seleziona questa opzione per rimuovere la media dai dati selezionati (cioè traduci i dati in modo che la media sia zero).

### Plugin

Un oggetto di dati plugin rappresenta un plugin di &kst;. Tutti i plugin hanno un formato comune, e appaiono quando si scrive Plugin nel Gestore dei dati. Per maggiori informazioni sui plugin, vedi Plugin e filtri

### Controlli degli eventi

Un oggetto di dati controllo degli eventi rappresenta un'istanza di controllo degli eventi. Per maggiori informazioni sul controllo degli eventi, vedi Controllo degli eventi.

### Matrici

Una matrice rappresenta un insieme di punti di dati tridimensionali (X, Y, Z) ordinati in una griglia bidimensionale. I valori Z della matrice si ottengono da un vettore, e la struttura della griglia è specificata a mano usando la finestra Modifica o Nuova matrice. Le descrizioni sotto si riferiscono al diagramma seguente, che descrive la struttura di una matrice di &kst;.

Seguono un'istantanea e una spiegazione della finestra delle matrici.

Finestra delle matrici Finestra delle matrici

#### Selezione dei vettori

Vettore Z

- Il vettore di dati da cui ottenere i valori Z.

#### Parametri della griglia

X minimo e Y minimo

- L'origine della matrice è specificata dalle coordinate (X minimo, Y minimo). La posizione dell'origine è rappresentata da un cerchio rosso nel diagramma sopra.

Passo X e Passo Y

- Questi due valori specificano le dimensioni di ogni cella rettangolare nella griglia della matrice. Tutte le celle nella matrice hanno le stesse dimensioni.

Dimensioni e Usa lunghezza X massima

- Inserisci il numero di passi per la dimensione X della matrice, seguito dal numero di passi per la dimensione Y della matrice. Se Usa lunghezza X massima è segnato, la dimensione X della matrice sarà determinata in base alla lunghezza del vettore e alla dimensione Y inserita. Se questa opzione è segnata e la lunghezza del vettore in seguito cambiasse, la dimensione X della matrice verrà aggiornata conseguentemente.

  Nota che la minima dimensione di Y permessa è 1, mentre la minima dimensione di X permessa è 0.

### Immagini

Le immagini sono rappresentazioni grafiche di Matrici. Le immagini possono essere tracciate come mappe di colori, di contorni, o entrambe.

Finestra dell'immagine Finestra dell'immagine

#### Selezione della matrice

Matrice

- Seleziona la matrice da usare per questa immagine. Si possono creare nuove matrici facendo clic sul pulsante a destra.

#### Tipo di immagine

Mappa di colori, Mappa di contorni, e Mappa di colori e di contorni

- Scegli il tipo di immagine da tracciare. Cambiare questa selezione attiva o disattiva delle sezioni della finestra dell'immagine come opportuno.

#### Parametri della mappa di colori

Una mappa di colori rappresenta il valore Z di ogni cella nella matrice usando un colore. Questa sezione è disponibile solo se Mappa di colori o Mappa di colori e di contorni è selezionato sotto Tipo di immagine.

Tavolozza dei colori

- Scegli la tavolozza dei colori da usare per la mappa dei colori. Come impostazione predefinita, &kst; installa due tavolozze di colori adatte per le mappe di colori: Kst Grayscale 256 (una tavolozza a 256 sfumature di grigio) e Kst Spectrum 1021 (uno spettro ad arcobaleno di 1021 colori che va dal blu al rosso). Si possono installare tavolozze aggiuntive semplicemente copiando file di tavolozze compatibili con GIMP nella sottocartella `colors` della cartella di configurazione dell'utente (per esempio, `/usr/share/config/colors/`). Nota che le immagini salvate usando una tavolozza non predefinita potrebbero non essere visualizzabili da altri utenti di &kst; se non hanno la tavolozza richiesta. In questi casi, viene usata una tavolozza predefinita a sfumature di grigio.

Soglia Z inferiore, Soglia Z superiore e Soglia automatica

- Inserisci le soglie inferiore e superiore da usare per la mappatura dei colori. I colori della tavolozza sono equamente ripartiti tra Soglia Z inferiore e Soglia Z superiore. Ogni cella nella matrice selezionata con valore di Z inferiori a Soglia Z inferiore viene fatta corrispondere al primo colore della tavolozza. Ogni cella nella matrice selezionata con valore di Z superiore a Soglia Z superiore viene fatta corrispondere all'ultimo colore della tavolozza. Fare clic su Soglia automatica inserirà dei valori di soglia inferiore e superiore usando i valori di Z massimo e minimo trovati nella matrice selezionata.

#### Parametri della mappa di contorni

Una mappa di contorni disegna un insieme di linee, dove ciascuna linea rappresenta un certo valore di Z. Questa sezione è disponibile solo se è selezionato Mappa di contorni o Mappa di colori e di contorni sotto Tipo di immagine.

Numero dei livelli di contorno

- Seleziona il numero dei livelli di contorno da usare. I livelli di contorno saranno distribuiti equamente tra il minimo e il massimo valore di Z trovati nella matrice.

Colore

- Seleziona il colore da usare per le linee di contorno. Fare clic su questo pulsante mostra una normale finestra di scelta del colore di &kde;.

Peso e Usa peso variabile delle linee

- Seleziona il peso, o spessore delle linee di contorno. Se è selezionato Usa peso variabile delle linee, le linee di contorno che rappresentano le elevazioni più alte saranno disegnate più spesse che quelle che rappresentano le elevazioni più basse. Fai attenzione quando usi questa opzione, perché le immagini con alte densità di linee di contorno potrebbero divenire illeggibili.

## Il menu Dati

Il menu Dati fornisce un accesso rapido a molte funzionalità relative agli oggetti di dati in &kst;. La maggior parte delle funzioni del menu replicano delle funzioni che si trovano altrove, quindi qui sotto verrano date solo delle brevi descrizioni.

Ricarica

- Ricarica tutti i vettori di dati dai loro file sorgente.

Assistente dati...

- Visualizza l'Assistente dati.

Gestore dei dati

- Visualizza il Gestore dei dati.

Nuovo [oggetto di dati]

- Visualizza la finestra corrispondente per creare l'oggetto di dati. Riferisciti a Tipi di dati per le descrizioni di ogni finestra.

Visualizza scalari

- Visualizza una finestra da cui possono essere visualizzati i valori di tutti gli scalari nella sessione corrente di &kst;. La finestra viene aggiornata dinamicamente se i valori cambiano.

Visualizza vettori

- Visualizza una finestra da cui possono essere visualizzati tutti i vettori attuali. Seleziona un vettore da visualizzare usando l'elenco a cascata. La finestra viene aggiornata dinamicamente se i valori cambiano.

Visualizza i risultati delle regressioni

- Visualizza una finestra che mostra tutti i valori risultanti dalle regressioni effettuate. Seleziona un risultato di regressione da visualizzare usando l'elenco a cascata. La finestra viene aggiornata dinamicamente se i valori cambiano.

Cambia file dei dati

- Visualizza una finestra per cambiare rapidamente i file di dati a cui i vettori sono associati. Seleziona i vettori da cambiare, e quindi naviga a un altro file di dati. Fai clic su Applica per salvare i cambiamenti.