# Dettagli sul formato dei dati

## Il formato dati interno

Nel formato dati interno di gretl, un dataset è rappresentato da due file: uno contiene i dati veri e propri, l'altro contiene una descrizione su come i dati vanno interpretati. Nello specifico:

1. Dati veri e propri: una matrice rettangolare di numeri separati da spazi o tab. Ogni colonna rappresenta una variabile, ogni riga un'osservazione relativa ad ognuna delle variabili (come in un foglio elettronico); le colonne di dati possono essere separate da spazi o tab. Il file di solito ha un nome con l'estensione `.gdt` ed è in formato ASCII (testo semplice), ma può essere anche compresso con gzip per risparmiare spazio su disco. È possibile inserire dei commenti nel file: se una riga inizia con il carattere cancelletto (`#`) viene ignorata (caratteristica comune anche ai file di dati di gnuplot e octave).

2. Descrizione: il file di dati deve essere accompagnato da un file di descrizione che ha la prima parte del nome in comune, ma l'estensione `.hdr` (file header). Questo file contiene, nell'ordine:

   - (opzionale) Commenti sul dataset, che si aprono con la stringa `(*` e si chiudono con `*)`; ognuna di queste due stringhe deve comparire da sola su una riga.

   - (richiesto) Una lista di nomi delle variabili separati da spazi o tab. I nomi sono limitati in lunghezza a 8 caratteri, devono iniziare per una lettera e possono contenere solo caratteri alfanumerici o il trattino basso. La lista può continuare su più di una riga e si chiude con un punto e virgola: `;`.

   - (richiesto) Una riga che descrive le osservazioni, nella forma `1 1 85`. Il primo valore indica la frequenza dei dati (1 per dati annuali o non datati, 4 per trimestrali, 12 per mensili). Gli altri due valori indicano le osservazioni iniziali e finali. Se i dati non sono datati, questi valori saranno rispettivamente 1 e il numero totale di osservazioni; per i dati che rappresentano serie storiche, è possibile usare delle date nel formato `1959.1` (trimestre indicato con una cifra dopo il punto) o `1967.03` (mese indicato con due cifre dopo il punto). Si veda per l'uso di questa riga con dati panel.

   - La parola chiave `BYOBS`.

Ecco un esempio di file di descrizione dei dati.

    	  (*
    	  DATA9-6:
    	  Data on log(money), log(income) and interest rate from US.
    	  Source: Stock and Watson (1993) Econometrica
    	  (unsmoothed data) Period is 1900-1989 (annual data).
    	  Data compiled by Graham Elliott.
    	  *)
    	  lmoney lincome intrate ;
    	  1 1900 1989 BYOBS

Il file di dati corrispondente contiene tre colonne di dati, ognuna contenente 90 osservazioni.

## Estensioni al formato dati base

gretl supporta anche altre opzioni nei propri file di dati:

1. Sostituendo la parola chiave `BYOBS` con `BYVAR` e aggiungendo la parola chiave `BINARY`, si indica che il file di dati corrispondente è in formato binario. È possibile creare questo tipo di file di dati con gretlcli usando il comando `store` con le opzioni `-s` (precisione singola) o `-o` (precisione doppia).

2. Se `BYOBS` è seguito dalla parola chiave `MARKERS`, gretl si aspetta un file di dati in cui la prima colonna contiene dei marcatori, ossia delle stringhe (lunghe al massimo 8 caratteri) usate per identificare le osservazioni. I marcatori possono essere utili nel caso di dati cross-section, in cui le osservazioni rappresentano unità identificabili, ad esempio paesi, città o simili. Un altro caso è quello delle serie storiche irregolari, come ad esempio dati giornalieri di quotazioni finanziarie: è possibile marcare i giorni in cui non avvengono contrattazioni (ad esempio con una stringa che rappresenta la data, come `10/01/98`; si tenga presente il limite di 8 caratteri per la stringa). Si noti che le parole chiave `BINARY` e `MARKERS` sono mutualmente esclusive e che i marcatori non vengono considerati come una variabile: questa colonna non ha una voce corrispondente nell'elenco delle variabili contenuto nel file di descrizione dei dati.

3. Se esiste un file con la prima parte del nome uguale a quella del file di dati e del file della descrizione, ma con l'estensione `.lbl`, viene letto come file che contiene le etichette descrittive per le serie dei dati. Il file delle etichette contiene testo semplice, nel seguente formato: ogni riga contiene il nome di una variabile (che deve corrispondere a quello contenuto nel file di descrizione dei dati), seguito da uno o più spazi e dall'etichetta descrittiva. Ecco un esempio:

   `price New car price index, 1982 base year`

   Un file di etichette viene creato automaticamente quando si salvano dati da gretl dopo aver aggiunto delle etichette descrittive per le serie, con il comando Modifica attributi del menù Variabile.