xDef

Utility che permette di generare una bozza di istruzioni per xTabs partendo da un questionario Odin o da un file di dati SPSS.

Questionario Odin

Partendo da un questionario Odin, genera le istruzioni di tabelle per tutte le domande che contengono un testo. Si assume che i nomi delle variabili siano costituiti da variable_prefix più il numero della question. Nelle ripetizioni si aggiunge il progressivo della ripetizione preceduto da number_separator. E’ supportato qualsiasi livello di ripetizone.

File di dati SPSS

Partendo da un file di dati SPSS genera le istruzioni di tabelle per tutte le variabili che iniziano con variable_prefix. Se in variable_prefix è specificata una stringa vuota, genera le tabelle per tutte le variabili. Gruppi di variabili multiple sono riconosciuti se la parte numerica progressiva è separata dal resto del nome della variabile da number_separator.

Per questa funzionalità, è necessario che sia installato Python, SPSS, SPSS-Python Integration Plug-in e i moduli python yaml, spss e spssaux.

Configurazione

Un file di configurazione xdef.yml generale va posto nella stessa cartella dell’eseguibile. Nella cartela in cui si esegue il programma può essere messo un altro file xdef.yml per sovrascrivere le impostazioni generali.

Parametri del file xdef.yml:

  • template: il nome del file .tlo; è la definizione del layout delle tavole utilizzato da SPSS
  • template_path: il percorso completo del file``.tlo``
  • variable_prefix: il prefisso utilizzato per generare i nomi di variabili da un questionario Odin e per genererare le tabelle da un file SPSS
  • number_separator: il carattere utilizzato per searare
  • report_prefix: prefisso per il titolo del report
  • title_prefix: prefisso per il titolo della tabella
  • placeholder: simbolo per sostituire *?
  • output_format: genera un file python o spss
  • function_wrap: se true include il programma in una funzione; è utile per esequire più volte le tavole con vari filtri, pannelli diversi o altri parametri differenti
  • exclude_questions: elenco dei numeri di question odin da escludere

Esempio di file xdef.yml:

template: look.tlo
template_path: x:/ricerche/std/
variable_prefix: v
number_separator: .
report_prefix: 'RICERCA'
title_prefix: 'Tabella '
placeholder: '<?>'
output_format: python
function_wrap: true
exclude_questions:
 - 9100
 - 9117
 - 9118
 - 9116

Utilizzo

Eseguire il programma da linea di comando con:

xdef nome_questionario [-py|-sp]

o:

xdef nome_file_spss [-py|-sp]