# Opzioni, argomenti e percorsi

## gretl

`gretl` (in MS Windows, `gretlw32.exe`) In Linux viene installato uno script wrapper chiamato `gretl`. Questo script controlla se sia impostata la variabile di ambiente `DISPLAY` e in caso positivo lancia la versione grafica del programma, altrimenti lancia la versione a riga di comando, `gretlcli`..

— Apre il programma e aspetta l'input dall'utente.

`gretl` filedati

— Avvia il programma caricando nello spazio di lavoro il file di dati indicato. Il file può essere nel formato interno di gretl, in formato CSV, o BOX1 (si veda il ). Il programma cercherà di riconoscere il formato del file e di trattarlo in modo appropriato. Si veda anche per quanto riguarda la ricerca dei percorsi.

`gretl --help` (o `gretl -h`)

— Mostra un breve riepilogo delle modalità di uso ed esce.

`gretl --version` (o `gretl -v`)

— Mostra informazioni sulla versione del programma ed esce.

`gretl --english` (o `gretl -e`)

— Forza l'utilizzo della versione inglese invece di quella italiana.

`gretl --run` file (o `gretl -r` file)

— Avvia il programma e apre una finestra che mostra il file di comandi indicato, pronto per essere eseguito. Si veda per quanto riguarda la ricerca dei percorsi.

`gretl --db` database (o `gretl -d` database)

— Avvia il programma e apre una finestra che mostra il database indicato. Se i file del database (il file `.bin` e il relativo file `.idx`, si veda ) non sono nella directory predefinita dei database, occorre specificare il percorso completo dei file.

`gretl --dump` (o `gretl -c`)

— Scrive le informazioni di configurazione del programma in un file di testo (il nome del file è mostrato nello standard output). Può essere utile nella risoluzione di problemi di funzionamento.

Varie funzionalità di gretl sono configurabili nel menù File, Preferenze menu.

- La directory base per i file condivisi di gretl.

- La directory base dell'utente per i file relativi a gretl.

- Il comando per eseguire gnuplot.

- Il comando per eseguire GNU R (si veda ).

- Il comando per visualizzare i file DVI di &tex;.

- La directory in cui iniziare a cercare i database in formato interno di gretl.

- La directory in cui iniziare a cercare i database in formato RATS 4.

- Il nome host del server dei database di gretl a cui connettersi.

- L'indirizzo IP e il numero di porta del proxy HTTP da usare per contattare il server dei database, se necessario (se si è dietro a un firewall).

- La calcolatrice e l'editor di testi da eseguire dalla barra dei comandi.

- Il tipo di carattere a spazio fisso da usare nelle finestre dei risultati di gretl.

- Il tipo di carattere da usare nei menù e negli altri messaggi (nota: questo elemento non è presente se gretl è compilato per il desktop gnome, visto che la scelta dei caratteri è gestita in modo centralizzato da gnome.)

Ci sono anche alcune caselle di testo: selezionando la casella esperto, vengono disabilitati alcuni messaggi di avvertimento che altrimenti verrebbero mostrati; selezionando la casella Avvisa in caso di aggiornamenti di gretl, gretl cercherà di connettersi al server dei database appena avviato; de-selezionando Mostra la barra degli strumenti di gretl, la barra degli strumenti sarà disabilitata. Se l'impostazione locale del proprio sistema non usa il punto (`.`) come separatore delle cifre decimali, de-selezionando Usa le impostazioni locali per il punto decimale, gretl userà comunque il carattere punto.

Infine, ci sono due scelte binarie: nella sezione Percorso per Apri/Salva è possibile impostare il percorso usato in modo predefinito da gretl quando si chiede di aprire o salvare un file: o la directory gretl dell'utente o la directory di lavoro attuale. Nella sezione File di dati, è possibile impostare l'estensione predefinita da aggiungere ai nomi dei file di dati. L'estensione standard è `.gdt`, ma è possibile impostarla a `.dat`, che era lo standard nelle versioni precedenti del programma. Se si imposta l'estensione predefinita a `.dat`, i file di dati saranno salvati nel formato tradizionale (si veda il ). Inoltre, nella sezione File di dati è possibile scegliere l'azione da associare alla piccola icona a forma di cartella presente sulla barra degli strumenti: se deve mostrare un elenco dei file di dati associati al libro di Ramanathan, o di quelli associati al libro di Wooldridge.

Nella sezione Generali è possibile scegliere l'algoritmo usato da gretl per calcolare le stime dei minimi quadrati. La scelta predefinita è la decomposizione di Cholesky, che è veloce, relativamente economica in termini di requisiti di memoria, e accurata per la maggior parte delle applicazioni. L'alternativa è la decomposizione QR, che è computazionalmente più impegnativa e richiede una maggiore quantità di memoria, ma è più accurata. È poco probabile dover avere bisogno dell'accuratezza ulteriore fornita dalla decomposizione QR, a meno che non si abbia a che fare con dati molto mal-condizionati e si sia interessati a valori dei coefficienti e degli errori standard precisi per più di 7 cifre decimali L'uso della decomposizione QR è attivabile anche impostando la variabile di ambiente `GRETL_USE_QR` a un qualsiasi valore non nullo. .

Le impostazioni scelte in questo modo sono salvate in modo diverso a seconda del sistema. In MS Windows sono scritte nel registro di Windows. Nel desktop di gnome sono scritte nel file `.gnome/gretl` nella home directory dell'utente. Altrimenti vengono scritte in un file chiamato `.gretlrc` nella home directory dell'utente.

## gretlcli

`gretlcli`

— Apre il programma e attende l'input dall'utente.

`gretlcli` filedati

— Avvia il programma caricando nello spazio di lavoro il file di dati indicato. Il file può essere nel formato interno di gretl, in formato CSV, o BOX1 (si veda il ). Il programma cercherà di riconoscere il formato del file e di trattarlo in modo appropriato. Si veda anche per quanto riguarda la ricerca dei percorsi.

`gretlcli --help` (o `gretlcli -h`)

— Mostra un breve riepilogo delle modalità di uso ed esce.

`gretlcli --version` (o `gretlcli -v`)

— Mostra informazioni sulla versione del programma ed esce.

`gretlcli --pvalue` (o `gretlcli -p`)

— Avvia il programma in una modalità in cui è possibile determinare interattivamente i p-value per alcune statistiche comuni.

`gretlcli --english` (o `gretlcli -e`)

— Forza l'utilizzo della versione inglese invece di quella italiana.

`gretlcli --run` file (o `gretlcli -r` file)

— Esegue i comandi contenuti nel file e aspetta ulteriore input dalla riga di comando. Si veda per quanto riguarda la ricerca dei percorsi.

`gretlcli --batch` file (o `gretlcli -b` file)

— Esegue i comandi contenuti nel file ed esce; tipicamente questa opzione viene usata redirigendo i risultati del comando a un file. Si veda per quanto riguarda la ricerca dei percorsi.

Se si usano le opzioni `--run` e `--batch`, il file richiamato deve indicare un file di dati da aprire. Ciò può essere fatto usando il comando `open` nel file, ma per compatibilità con il programma originario ESL di Ramanathan è disponibile anche un altro metodo (ESL non ha il comando `open`). Una riga del tipo:

    	(* ! miofile.gdt *)

farà aprire a gretlcli il file `miofile.gdt`, ma sarà ignorata come commento dal programma originario ESL. Si noti la sintassi: c'è esattamente uno spazio tra il marcatore di inizio commento `(*` e il carattere `!`; c'è esattamente uno spazio tra il carattere `!` e il nome del file di dati.

Un'altra funzionalità permette a gretl e a gretlcli di recuperare informazioni sui file di dati a partire dai file di esempio di ESL inclusi nel pacchetto gretl. Un file di esempio inizia tipicamente così:

`(* PS4.1, using data file DATA4-1, for reproducing Table 4.2 *)`

Viene usata questa regola: se un file di input inizia con il marcatore di commento, viene cercata una stringa che inizia per `DATA` (maiuscola); se viene trovata, viene estratta la parte della stringa compresa tra la `D` fino allo spazio o alla virgola successivi, viene convertita in caratteri minuscoli e la si usa come nome del file di dati da aprire.

## Ricerca dei percorsi

Quando si indica il nome di un file di dati o di comandi a gretl o gretlcli sulla riga di comando (si veda e ), il file viene cercato nel modo seguente:

1. Esattamente come viene specificato. Ossia, nella directory di lavoro attuale, o, se viene indicato un percorso completo, nella posizione indicata.

2. Nella directory gretl dell'utente (si veda la per i valori predefiniti).

3. In qualsiasi directory immediatamente contenuta nella directory gretl dell'utente.

4. Nel caso di un file di dati, la ricerca continua nella directory principale dei dati di gretl. Nel caso di un file di comandi, la ricerca continua nella directory principale dei file di comandi. Si veda la per i valori predefiniti.

5. Nel caso dei file di dati, la ricerca continua in tutte le directory immediatamente contenute nella directory principale dei dati.

### Impostazioni predefinite dei percorsi

| Linux | MS Windows
--- | --- | ---
Directory gretl dell'utente | `$HOME/gretl` | `PREFISSO\gretl\user`
Directory di sistema dei dati | `PREFISSO/share/gretl/data` | `PREFISSO\gretl\data`
Directory di sistema dei file di comandi | `PREFISSO/share/gretl/scripts` | `PREFISSO\gretl\scripts`
Nota: `PREFISSO` indica la directory base scelta al momento dell'installazione di gretl.

Non è quindi necessario specificare il percorso completo per un file di dati o di comandi, a meno che non si voglia fare a meno del meccanismo di ricerca automatico (ciò è valido anche per gretlcli quando si indica un nome di file come argomento per il comando `open` o il comando `run`)

Quando un file di comandi contiene l'istruzione di aprire un file di dati, l'ordine di ricerca per il file è quello descritto sopra, con l'eccezione che il file viene cercato anche nella directory che contiene lo script, immediatamente dopo aver tentato di cercare il file di dati esattamente come viene specificato.

### MS Windows

In MS Windows le informazioni di configurazione per gretl e gretlcli sono scritte nel registro di Windows. Quando gretl è installato per la prima volta, viene creata un'appropriata serie di voci di registro; successivamente le impostazioni possono essere modificate attraverso il menù File, Preferenze di gretl. Se occorre eseguire delle modifiche manuali dei valori, le voci di registro possono essere trovate (usando il programma standard di Windows regedit.exe) sotto `Software\gretl` in `HKEY_CLASSES_ROOT` (la directory principale di gretl e il comando per invocare gnuplot) e in `HKEY_CURRENT_USER` (tutte le altre variabili configurabili).