Capitolo 5. Generare il codice di R dalle impostazioni della GUI

function preprocess () {
}
                

Il file JS è organizzato in tre funzioni separate: preprocess(), calculate() e printout(). Questo perché non tutto il codice è necessario in tutte le fasi. Attualmente la funzione di pre-elaborazione non è realmente utilizzata in molti punti (in genere sarà omessa del tutto).

function calculate () {
        echo ('res <- t.test (x=' + getString ("x") + ', y=' + getString ("y") + ', hypothesis="' + getString ("ipotesi") + '"' + getString ("varequal"));
        var conflevel = getString ("conflevel");
        if (conflevel != "0.95") echo (', conf.level=' + conflevel);
        echo (')\n');
}
                

Questa funzione genera l'attuale sintassi di R da eseguire dalle impostazioni della GUI. Vediamo questo in dettaglio: il codice da utilizzare è generato utilizzando l'istruzione echo(). Osservando l'istruzione echo() passo dopo passo, la prima parte è

res <- t.test (
                

come testo semplice. Successivamente dobbiamo inserire il valore selezionato dall'utente come prima variabile. Lo recuperiamo utilizzando getString ("x") e lo aggiungiamo alla stringa da «echo». Questo stampa il valore dell'elemento della GUI con id=""x": il nostro primo <checkbox>. Successivamente, aggiungiamo un ', ' e facciamo lo stesso per recuperare il valore dell'elemento "y" - il secondo <checkbox>. Per l'ipotesi (il gruppo <radio>) e le varianze uguali <checkbox>, la procedura è molto simile.

echo(`res <- t.test (x=${ getString("x") }, y=${ getString("y") }, hypothesis="${ getString("hypothesis") }"`); // ecc.
                        

Tenere presente che invece di concatenare gli snippet di uscita con «+», è possibile anche utilizzare diverse istruzioni echo(). Tutto è stampato su una sola riga. Per produrre un'interruzione di riga nel codice generato, inserire un "\n" nella stringa stampata. In teoria, è possibile persino produrre molte righe con una singola istruzione echo, ma consigliamo limitarsi a una riga (o meno) di codice generato per echo().

Diventa un po 'più complicato per il livello di confidenza. Per ragioni estetiche, non vogliamo specificare esplicitamente il livello di confidenza da utilizzare, se corrisponde al valore predefinito. Quindi, invece di stampare il valore incondizionatamente, recuperiamo prima una variabile. Quindi controlliamo se quella variabile differisce da "0.95" e in tal caso stampiamo un argomento aggiuntivo. Infine, aggiungiamo una parentesi di chiusura e un'interruzione di riga: ")\n". Questo è tutto per la funzione di calcolo.

function printout () {
        echo ('rk.header (' + i18n ("Test t a due variabili") + ')\n');
        echo ('rk.print (res)\n');
}
                

E questo era tutto ciò che c'era nella funzione di stampa nella maggior parte dei casi. rk.header() stampa un'intestazione standard per i risultati. Tenere presente che nei file .js bisogna contrassegnare tutte le stringhe traducibili, usando i18n(), o alcuni comandi alternativi. Maggiori informazioni a riguardo sono disponibili nel capitolo sull'internazionalizzazione. È possibile anche aggiungere altre informazioni a questo, se lo si desidera, ad es.:

function printout () {
        new Header (i18n ("Test t a due variabili"))
                  .addFromUI ("varequal")
                  .add (i18n ("Livello di confidenza"), getString ("conflevel"))  // Nota: scritto in questo modo a scopo illustrativo. Più automatico:
        //        .addFromUI ("conflevel")
                  .print ();
echo ('rk.print (res)\n');
}
                

rk.print() utilizza il pacchetto R2HTML per fornire output HTML formattato. Un'altra funzione utile è rk.results(), che può anche generare diversi tipi di tabelle dei risultati. In caso di dubbio, tuttavia, usare semplicemente rk.print() e il gioco è fatto. La classe JS Header è un helper di livello JS per generare una chiamata a rk.header() (basta dare un'occhiata al codice R generato). In alcuni casi potreste voler chiamare echo ('rk.header (...)') direttamente per stampare un'intestazione per il vostro output.

Nota che internamente, l'output è un semplice documento HTML in questo momento. Pertanto potreste essere tentati di aggiungere HTML personalizzato. utilizzando rk.cat.output(). Anche se funzionerà, non fatelo. Il formato di output potrebbe cambiare (ad es. in ODF) in futuro, quindi è meglio non introdurre HTML codice specifico. Piuttosto mantenete le cose semplici con rk.header(), rk.print(), rk.results() e, se necessario, rk.print.literal(). Se questi non sembrano soddisfare le vostre esigenze di formattazione, contattateci sulla mailing list per ricevere assistenza.

Congratulazioni! Avete creato la vostra prima estensione. Continuare a leggere nei prossimi capitoli per concetti più avanzati.