iowatest

Implementazione dello Iowa Gambling Task

Implementazione dello Iowa Gambling Task ABCD e della variante EFGH come descritto in: 
Bechara A, Damasio AR, Damasio H, Anderson SW: "Insensitivity to future consequences following damage to human prefrontal cortex." Cognition 1994; 50: 7 - 15
Bechara A., Tranel D., Damasio H.: "Characterization of decision-making deficit of patients with ventromedial prefrontal cortex lesions", Brain 2000: 123: 2189 - 2202

Versione = 1.0 (01/02/2007)

  1. Caratteristiche Generali
  2. Requisiti di sistema
  3. Configurazione
  4. Utilizzo del programma
  5. Struttura del file di output
  6. Credits

Download (file compresso autoestraente, 942 KB)

 

Caratteristiche generali

IGT è una implementazione completa in XHTML e JavaScript dello Iowa Gambling Task di Bechara e Damasio. Consente un'ampia personalizzazione delle modalità di presentazione e dei parametri di test, e la possibilità di riprodurre IGT nella versione originale (mazzi ABCD), in quella modificata (mazzi EFGH) e in altre varianti ad hoc.
Fornisce in output un file in formato CSV (Comma Separated Values), un formato standard che può essere facilmente importato in altri programmi (comeEXCEL® o SPSS®) per successive elaborazioni.

Il programma consente la registrazione nel file di output, per ogni prova, delle variabili che definiscono le scelte del soggetto (numero di scelte vantaggiose e svantaggiose e mazzo valutato come migliore), dei tempi di esecuzione del test, e della configurazione di test utilizzata per la prova (guadagno e perdite per ogni carta, numero di turni di gioco, scelte di visualizzazione).

[indice]

Requisiti di sistema

Il programma richiede Microsoft Windows XP® o superiori e Internet Explorer® v. 6.0 o superiori, assicurandosi che siano abilitate sia l'esecuzione di contenuto attivo JavaScript che di ActiveX®. 
Per quanto l'esecuzione del test sia possibile anche in ambienti software differenti, il salvataggio e la visualizzazione dei dati raccolti richiedono componenti ActiveX disponibili solo nell'ambiente Microsoft.

La risoluzione minima dello schema per una corretta visualizzazione è 1280x800 pixel

Per evitare la visualizzazione, all'inizio del test, della barra di sicurezza di Internet Explorer, é opportuno spuntare le caselle "consenti l'esecuzione di contenuto attivo in file nel computer" e "consenti l'esecuzione di contenuto attivo da CD nel computer" nella sezione AVANZATE delle OPZIONI INTERNETdel browser.

[indice]

Configurazione

La configurazione dei parametri di test avviene attraverso il file igtset.js, che si trova nella cartella code. Il file contiene una serie di righe nella forma variabile = valore, e la configurazione avviene assegnando un valore opportuno ad ogni riga.

I parametri configurabili sono:

 outFile   Nome del file di output dei risultati
 restoreDelay  Ritardo nella ricopertura nella carta (in millisecondi)
 strial  Numero di giocate raggruppate ai fini del calcolo dei punteggi.
 Deve essere multiplo di 10, altrimenti viene adeguato
 ntrial  Numero di giocate
 Deve essere multiplo di strial, altrimenti viene adeguato
 budget  Budget iniziale
 nstart  Numero di giocate consecutivamente esatte
 gc1[0] - gc1[9]  Guadagno per singola carta del Mazzo 1, per ogni gruppo di 10 carte
 lc1[0] - lc1[9]  Perdita per singola carta del Mazzo 1, per ogni gruppo di 10 carte
 gc2[0] - gc2[9]  Guadagno per singola carta del Mazzo 2, per ogni gruppo di 10 carte
 lc2[0] - lc2[9]  Perdita per singola carta del Mazzo 2, per ogni gruppo di 10 carte
 gc3[0] - gc3[9]  Guadagno per singola carta del Mazzo 3, per ogni gruppo di 10 carte
 lc3[0] - lc4[9]  Perdita per singola carta del Mazzo 3, per ogni gruppo di 10 carte
 gc4[0] - gc4[9]  Guadagno per singola carta del Mazzo 4, per ogni gruppo di 10 carte
 lc4[0] - lc4[9]  Perdita per singola carta del Mazzo 4, per ogni gruppo di 10 carte
 cards  Se true utilizza una simulazione di un mazzo reale di carte
 Se false mostra solo un simbolo per le giocate vincenti e perdenti.
 showGL  Se true mostra, per ogni giocata, la vincita e la penalità.
 Se false mostra solo la vincita/perdita netta.
 showN  Se true mostra il contatore delle giocate.
 Se false non offre indicazioni sul procedere del gioco.
 showStop  Se true mostra un pulsante per interrompere prematuramente il gioco.
 Se false il gioco si può interrompere con la combinazione alt+z.
 showQuest  Se true mostra, ogni strial giocate, la richiesta di indicare il mazzo ritenuto più 
 vantaggioso. 
 Se false la richiesta viene posta solo al termine.

[indice]

Utilizzo del programma

Avvio del programma e schermata iniziale

Il programma si avvia caricando nel browser il file igt.htm. La schermata iniziale ? la seguente:

I pulsanti hanno la seguente funzione

Mostra la pagina che riguarda l'autore e i diritti di licenza

Apre il file di help
Mostra la configurazione attuale. 
I valori sono di sola lettura: le modifiche richiedono l'intervento sul file igtset.js (vedi configurazione).
 Recupera e visualizza i singoli record nel file di output corrente.
Avvia la sessione di test.

[indice]

Svolgimento del test

Dopo aver premuto il pulsante di start al soggetto viene presentata la seguente schermata, con la richiesta di inserimento di un codice di identificazione:

Il codice, che deve essere fornito dallo sperimentatore, ha una lunghezza minima di 6 caratteri, e rappresenta l'elemento di identificazione del soggetto nel file di output. 
E' cura dello sperimentatore verificare sul corretto inserimento del codice.

All'inserimento del codice corretto, al soggetto viene presentata una pagina che contiene una breve spiegazione del compito:

Al premere del pulsante INIZIA A GIOCARE, inizia la fase di test vera e propria. Al soggetto vengono presentati 4 mazzi di carte A , B , C o D (che sonoassociati casualmente ai mazzi 1, 2, 3 e 4 definiti dallo sperimentatore) ed è chiesto di scegliere un mazzo (selezionandolo con il mouse).

Dopo ogni scelta il programma evidenzia la vincita o la perdita ed eventuali altri elementi a seconda dei valori delle variabili di configurazione. I valori mostrati sono distribuiti casualmente secondo quanto stabilito dai parametri di configurazione per ogni mazzo: l'estrazione casuale avviene in modo che, per ogni gruppo di 10 carte estratte da un mazzo, vengano rispettate le vincite e le perdite nette stabilite.

Se la variabile showQuest é settata a true, ogni ntrial giocate viene mostrata la schermata seguente, con l'invito a individuare il mazzo ritenuto più vantaggioso:

Al termine della scelta il gioco riprende.

Quando si raggiunge il numero di giocate stabilite dalla variabile ntrial il gioco si interrompe. Il gioco può anche essere interrotto prematuramente premendo il pulsante STOP che compare nella pagina se la variabile showStop é settata a true, oppure premendo la combinazione di tasti ALT+Z.

Al soggetto viene presentata una pagina finale dove si chiede di inserire la propria età , il sesso , e il nome del mazzo (A , B , C o D ) che ritiene sia stato il più vantaggioso.

Il pulsante OK termina il test e il programma procede alla scrittura del file di output. Se il file non esiste viene creato, altrimenti i risultati della prova vengono accodati la file gi? esistente.

Per una impostazione di sicurezza di Internet Explorer, il browser, prima di procedere alla scrittura dei dati, chiede conferma, con la presentazione della finestra di dialogo seguente, cui bisogna rispondere affermativamente.

[indice]

Visualizzazione del file di output

Il programma prevede un semplice sistema di visualizzazione per i valori principali dei singoli record del file di output (il cui nome è quello ricavato dalla configurazione corrente).

La visualizzazione può essere attivata premendo il pulsante VISUALIZZA DATI nella pagina principale, che apre la pagina seguente:

L'inserimento di un codice di identificazione valido provoca la visualizzazione dei dati corrispondenti (dopo la risposta affermativa all'utilizzo di ActiveX, come per la procedura di salvataggio dati). Il pulsante VISUALIZZA CONFIGURAZIONE consente di esaminare i parametri di test associati al record visualizzato.

Il pulsante STAMPA consente di inviare alla stampante la tabella.

Visualizzazione dei parametri correnti

Il pulsante CONFIGURAZIONE attiva la visualizzazione (in sola lettura) dei parametri di configurazione attuali:

Il pulsante STAMPA consente di inviare alla stampante la tabella. Il pulsante STRUTTURA FILE consente di visualizzare o stampare una legenda, relativa alla configurazione corrente, per la lettura del file di output.

[indice]

Struttura del file di output

Il file di output é costituito da un file ASCII. Ciascuna riga rappresenta un record, che elenca i valori delle variabili separati da virgole. 
La struttura di ciascun record é riportata nella tabella seguente (dove ntrial = numero di giocate e strial = numero di giocate per blocco):

<

 Posizione   Descrizione
 1  Codice di identificazione del soggetto (ID)
 2  Età
 3  Sesso
 4  Numero di giocate (ntrial)
 5  Numero di giocate per blocco (strial)
 6  Budget iniziale
 7  Data e ora di inizio del test
 8  Data e ora di fine del test
 9  Durata Totale del test (secondi)
 da 10 a 9+ntrial/strial  Tempi di esecuzione del singolo blocco di giocate (esclusi i tempi per l'indicazione del mazzo
 vantaggioso).
 10+ntrial/strial  Mazzo ritenuto più vantaggioso
 11+ntrial/strial  Numero totale di carte effettivamente selezionate
 12+ntrial/strial  Budget al termine del test
 13+ntrial/strial  Numero di scelte Mazzo 1
 14+ntrial/strial  Numero di scelte Mazzo 2
 15+ntrial/strial  Numero di scelte Mazzo 3
 16+ntrial/strial  Numero di scelte Mazzo 4
 da
 17+ntrial/strial 
 a 
 16+2*ntrial/strial
 Numero di scelte Mazzo 1 per blocco
 da
 17+2*ntrial/strial 
 a 
 16+3*ntrial/strial
 Numero di scelte Mazzo 2 per blocco
 da
 17+3*ntrial/strial 
 a 
 16+4*ntrial/strial
 Numero di scelte Mazzo 3 per blocco
 da
 17+4*ntrial/strial 
 a 
 16+5*ntrial/strial
 Numero di scelte Mazzo 4 per blocco
 da
 17+5*ntrial/strial 
 a 
 16+6*ntrial/strial
 Guadagno per blocco
 da
 17+6*ntrial/strial 
 a 
 16+7*ntrial/strial
 Perdita per blocco
 da
 17+7*ntrial/strial 
 a 
 16+8*ntrial/strial
 Mazzi indicati come vantaggiosi per blocco. 
 Se showQuest = false i valori sono tutti 0.
 17+8*ntrial/strial  Tempo (secondi) in cui si raggiungono per la prima volta nstart 
 giocate consecutive su mazzi vantaggiosi .
 da
 18+8*ntrial/strial 
 a 
 17+9*ntrial/strial
 Tempi (secondi) impiegati per rispondere alle domande sul mazzo vantaggioso).
 Se showQuest = false i valori sono tutti 0.
 18+9*ntrial/strial  cards
 19+9*ntrial/strial  showGL
 20+9*ntrial/strial  showN
 21+9*ntrial/strial  showStop
 22+9*ntrial/strial  showQuest
 23+9*ntrial/strial  nstart
 da
 24+9*ntrial/strial 
 a 
 43+9*ntrial/strial
 Valori dei guadagni e delle perdite per singola carta (ogni 10 carte) 
 (Mazzo 1)
 da
 44+9*ntrial/strial 
 a 
 63+9*ntrial/strial
 Valori dei guadagni e delle perdite per singola carta (ogni 10 carte) 
 (Mazzo 2)
 da
 64+9*ntrial/strial 
 a 
 83+9*ntrial/strial
 Valori dei guadagni e delle perdite per singola carta (ogni 10 carte) 
 (Mazzo 3)
 da
 84+9*ntrial/strial 
 a 
 103+9*ntrial/strial
 Valori dei guadagni e delle perdite per singola carta (ogni 10 carte) 
 (Mazzo 4)
 104+9*ntrial/strial  carattere "@"

Il pulsante STRUTTURA FILE presente nella schermata di visualizzazione della configurazione, consente di visualizzare o stampare una legenda, relativa alla configurazione del record corrente, per la lettura del file di output.

[indice]

Credits

L'autore di questo software è Annibale Cois. Questo software è distribuito sotto la GNU General Public License.  Annibale Cois (2007), Questo indirizzo e-mail è protetto dallo spam bot. Abilita Javascript per vederlo. .Questo programma è un software libero; può essere ridistribuito e/o modificato sotto i termini della GNU General Public License come pubblicata dalla Free Software Foundation (versione 2). E concesso il permesso di usare, copiare, modificare e distribuire questo software per qualunque scopo senza alcun costo, purchè questa nota completa sia inclusa in ogni copia di ciascun software che includa anche solo parte di questo, e in tutte le copie della eventuale documentazione di supporto.

QUESTO SOFTWARE E FORNITO "COSI' COME E'", SENZA ALCUNA GARANZIA ESPLICITA O IMPLICITA. IN PARTICOLARE L'AUTORE NON OFFRE NESSUNA GARANZIA RISPETTO ALL'UTILIZZO DI QUESTO SOFTWARE PER NESSUNO SCOPO.

Se pubblicate lavori scientifici usando questo software, siete pregati di ricompensare il lavoro speso per realizzare questo programma includendo il riferimento a questo articolo: Annibale Cois (2007), Implementazione dello Iowa Gamblig Taskhttp://www.mondoxsardegna.it/igt.php. E' gradita anche una email di notifica.

Versione = 1.0 (01/02/2007)

[indice]