.. _odinmap:

*******
OdinMAP
*******

Programma [#]_ per generare un **data map** di un questionario **ODIN** partendo da un file ``.VAR`` di **DIANA** [#]_.

.. image:: _static/odinmap.png


Utilizzo
========

* Generare il file ``.VAR`` con il programma *NIPO ODIN Developer*: :menuselection:`Actions --> Export to --> DIANA...`.
* In *OdinMAP* selezionare il file ``.VAR``.
* Scegliere se stampare nell'output anche:

  * il nome/id delle domande;
  * il testo delle domande;
  * il numero progressivo delle domande;
  * la data e ora di produzione del data map;
  * le variabili senza testo né codici.

* Premere il pulsante ``Genera data map``.


Installazione
=============

Decomprimere il file zip nella cartella desiderata. 
Inserendo il percorso nella variabile d'ambiente ``Path`` il programma sarà avviabile in qualsiasi finestra della console di Windows. 


Configurazione
--------------

Se si vuole fare in modo che il programma si avvii sempre con le stesse opzioni selezionate, premere il pulsante ``Salva configurazione``.   


TextPad
-------

Il programma può essere aggiunto al menu :menuselection:`Tools --> External Tools` di `TextPad <http://textpad.com/>`_.

Nel menu :menuselection:`Configure --> Preferences...` configurare un nuovo *Tools* e inserire i seguenti parametri::

  Command:                   "P:\ath\to\program\OdinMAP.exe"
  Parameters:                
  Initial folder:            $FileDir
  Close DOS window on exit:  x

Inserendo ``$FileDir`` come cartella iniziale, se si sta lavorando sul questionario, 
la finestra di apertura dei file di *OdinMAP* si avvierà direttamente nella cartella in cui risiede il questionario
e quindi il file .VAR.


PSPad
-----

Per integrare *OdinMAP* in `PSPad <http://www.pspad.com/>`_, inserirlo nella lista delle applicazioni associate alla sintassi *ODIN*
senza alcun parametro particolare a parte il percorso e il nome dell'eseguibile::

  "P:\ath\to\program\OdinMAP.exe"

Anche in questo caso, *OdinMAP* verrà avviato nella cartella del documento attivo.


Total Commander, Unreal Commander
---------------------------------

Si può inserire un collegamento a *OdinMAP* nella barra degli strumenti di 
`Total Commander <http://www.ghisler.com/>`_ o di `Unreal Commander <http://x-diesel.com/>`_.
Dopo aver inserito il pulsante è necessario eliminare qualsiasi percorso dal *percorso di avvio* del pulsante.
In questo modo *OdinMAP* si avvierà nella cartella del pannello attivo.

.. image:: _static/toolbar.png


Download
========

**Versione 1.8**: :download:`OdinMAP.zip <d:/projects/ruby/odinmap/build/OdinMAP.zip>`

.. **Versioni precedenti**
.. * Versione 1.7 :download:`OdinMAP_v17.zip <d:/projects/ruby/odinmap_old/OdinMAP_v17.zip>`
.. * Versione 1.6 :download:`OdinMAP_v16.zip <d:/projects/ruby/odinmap_old/OdinMAP_v16.zip>`
.. * versione 1.4 :download:`OdinMAP_v14.zip <d:/projects/ruby/odinmap_old/OdinMAP_v14.zip>`
.. * versione 1.3 :download:`OdinMAP_v13.zip <d:/projects/ruby/odinmap_old/OdinMAP_v13.zip>`
.. * versione 1.2 :download:`OdinMAP_v12.zip <d:/projects/ruby/odinmap_old/OdinMAP_v12.zip>`

---

.. [#] Il programa è scritto in *Ruby*.
.. [#] *DIANA* è il software di elaborazione e tabulazione dati della *NIPO*.