.. _xdef:

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]