Plugin eVis¶

Aprire il modulo Browser evento¶

Per aprire la finestra di dialogo del modulo, cliccare sul pulsante ^{Sfoglia evento eVis} oppure Database ‣ eVis ‣ Sfoglia evento eVis. Si aprirà una finestra generica Browser evento.

Sono presenti tre schede nella parte alta della finestra Browser evento. La scheda Visualizza serve a visualizzare le foto ed i relativi attributi. La scheda Opzioni contiene una serie di impostazioni del plugin. La scheda Configura applicazioni esterne serve a gestire una tabella di estensioni di file ed applicazioni associate per permettere ad eVis di visualizzare documenti ed altre immagini.

Scheda Visualizza¶

La scheda Visualizza è usata per visualizzare le foto ed i relativi attributi.

Figure eVis 1:

The eVis display window

1. Area di visualizzazione dell’immagine: è il riquadro inferiore della scheda.

2. Ingrandisci: ingrandisce l’immagine per avere più dettagli. Se l’immagine è troppo grande per l’area di visualizzazione, compaiono delle barre di scorrimento.

3. Rimpicciolisci: rimpicciolisce l’immagine.

4. Zoom completo: visualizza tutta l’immagine.

5. Finestra degli attributi: è il riquadro superiore della finestra. Qui sono mostrate le informazioni del punto associato alla foto che si sta visualizzando. Se il file associato al punto non è un’immagine ed il tipo di file è definito nella scheda Configura applicazioni esterne, facendo doppio-click sul suo percorso viene avviata l’applicazione adatta a gestire quel tipo di file. Se l’estensione del file è riconosciuta, l’attributo sarà mostrato in verde.

6. Pulsanti per la navigazione: usare i pulsanti Precedente all’altro.

7. Indicatore elemento: l’intestazione indica quale elemento è visualizzato ed il numero di elementi disponibili.

Scheda Opzioni¶

Figure eVis 2:

The eVis Options window

1. Percorso file: menu a tendina che permette di selezionare l’attributo contenente il percorso o l’URL della foto o altro documento da visualizzare. In caso di percorso relativo, attivare la casella di controllo Il percorso è relativo: il percorso di base del percorso relativo può essere indicato nella casella di testo ’Percorso base’. Informazioni di dettaglio sulle diverse opzioni per specificare la localizzazione di un file sono disponibili nella sezione Specificare la localizzazione ed il nome di una foto.

2. Informazioni bussola: menu a tendina che permette di selezionare l’attributo contenente l’orientamento della macchina fotografica.

3. Offset bussola: può essere usato per compensare la declinazione. Attivare Manuale per inserire i valori di offset nella casella di testo oppure attivare Da Attributo per selezionare l’attributo contenente i valori di offset. La declinazione est deve essere inserita usando valori positivi: in valori negativi, invece, la declinazione ovest.

4. Percorso base: il percorso di base utilizzato dal percorso relativo definito in Figura Figure_eVis_2 (A).

5. Sostituisci percorso: se attivo, soltanto il nome del file in A sarà aggiunto al percorso di base.

6. Applica il percorso dell’immagine se attivo, le stesse regole di percorso definito per le foto saranno applicate a documenti tipo video, testo, audio.

7. Ricorda questa impostazione: se attivo, i valori associati saranno salvati per la sessione successiva quando la finestra verrà chiusa o quando verrà premuto il pulsante [Salva].

8. Ripristina: reimposta il campo al valore predefinito.

9. Restore defaults: riporta tutti i campi alle impostazioni predefinite.

10. Salva: salva le impostazioni senza chiudere la scheda Opzioni.

Configura applicazioni esterne¶

Figure eVis 3:

The eVis External Applications window

1. Tabella riferimento file: una tabella contenente i vari tipi di file utilizzati da eVis. Ogni tipo file necessita di un’estensione e di un percorso all’applicazione in grado di gestirlo. Ciò permette di aprire diversi tipi di file come filmati, suoni e documenti testuali, oltre che solo immagini.

2. Aggiungi nuovo tipo file: aggiunge un nuovo tipo di file (estensione ed applicazione).

3. Elimina riga corrente: elimina il tipo di file selezionato in tabella.

Aprire ID Evento¶

Per aprire il modulo cliccare su ^{Strumento ID evento} oppure Plugins ‣ eVis ‣ Strumneto ID evento: sul cursore del mouse apparirà una ‘i’, ad indicare che lo strumento è attivo.

Per visualizzare le foto associate agli elementi vettoriali presenti nella vista mappa di QGIS, cliccare su un elemento di interesse; la foto verrà mostrata nel ’Browser evento’. Nel caso fossero disponibili più foto per lo stesso punto, è comunque possibile scorrerle tutte tramite i pulsanti [Precedente] e [Avanti]. Altre opzioni di controllo sono presenti nella sezione ref:evis_browser.

Aprire Connessione Database¶

Per aprire il modulo cliccare su ^{Connessione database eVis} oppure Plugins ‣ eVis ‣ Connessione database eVis. La finestra di dialogo Connessione Database presenta tre schede: Query predefinite, Connessione Database e Query SQL. La Console di Output mostra lo stato di un’azione avviata da altra sezioni del modulo.

Connessione Database¶

Aprire la scheda Connessione Database, cliccare su Tipo Database e selezionare il tipo di database al quale ci si vuole collegare. Se necessario, si possono inserire Username e Password.

Inserire il server del database in Host Database: l’opzione non è disponibile per i database “MSAccess”. Se il database si trova sul desktop, allora inserire “localhost”.

Inserire il nome del database in Nome Database. In caso di connessione “ODBC” è necessario inserire il nome della fonte dati.

Una volta configurati tutti i parametri cliccare su [Connetti]: la Console di Output informa dell’esito dell’operazione, sia positivo che negativo.

Figure eVis 4:

The eVis Database connection window

1. Tipo di Database: per specificare il tipo di database cui connettersi.

2. Host Database: nome host del database.

3. Porta: numero della porta di connessione in caso di database MYSQL o PostgreSQL.

4. Nome Database: nome del database.

5. Connetti: pulsante di connessione.

6. Console di Output: finestra dei messaggi sullo stato della connessione.

7. Nome utente: nome utente in caso di database protetto.

8. Password: password in caso di database protetto.

9. Query Predefinite: scheda “Query Predefinite”.

10. Connessione Database: scheda “Connessione Database”.

11. Query SQL: scheda “Query SQL”.

12. Help: mostra la guida in linea.

13. OK: chiude Connessione Database .

Eseguire query SQL¶

Le query SQL permettono di estrarre informazioni da un database o da una risorsa ODBC. In eVis il risultato di una query è una layer vettoriale aggiunto alla vista mappa di QGIS. Cliccare su Query SQL`per visualizzare l’interfaccia per le query. Un utile tutorial sulla sintassi SQL è disponibile alla pagina web http://www.w3schools.com/sql. Ad esempio, per estrarre tutti i dati da una tabella Excel: ``select * from [sheet1$]` dove sheet1 è il nome del foglio di lavoro.

Per eseguire una query cliccare su [Esegui Query] : in caso di esito positivo si aprirà la finestra di dialogo Scegli file Database altrimenti la Console di Output mostrerà un messaggio di errore.

Nella finestra Scegli file Database assegnare un nome al nuovo layer che sarà creato dai risultati della query.

Figure eVis 5:

The eVis SQL query tab

1. Query SQL: è il riquadro per inserire le query SQL.

2. Esegui Query: pulsante per mandare in esecuzione una query.

3. Console di Output: mostra i messaggi relativi all’esecuzione delle query.

4. Help: mostra la guida in linea.

5. OK: chiude Connessione Database.

Usare Coordinata X e Coordinata Y per selezionare i campi del database che contengono le coordinate X (o longitudine) e Y (or latitudine). Cliccare su [OK] per visualizzare il nuovo layer nella vista mappa di QGIS.

Per salvare il nuovo layer è possibile usare il comando QGIS ‘Salva come...’ (click tasto-destro sul nome del layer in legenda)

Eseguire query predefinite¶

Nella scheda Query Predefinite è possibile caricare query da file esterni in XML. Questa possibilità è molto utile se non si ha molta dimestichezza con il linguaggio SQL.

Per caricare query predefinite, cliccare su ^{Apri File}: quando una query è caricata, il titolo della stessa appare nel menu a tendina sotto Apri File e una breve descrizione è visualizzata nella casella di testo sottostante.

Selezionare la query che si intende usare e aprire la scheda Query SQL per vedere che la query è stata caricata nella finestra. Se è la prima volta che si sta lanciando una query, assicurarsi di essere connessi al database.

Cliccare su [Esegui Query] nella scheda Query SQL per eseguire il comando. Se la query ha avuto successo si aprirà la finestra Seleziona file Database. Al contrario, se la query non ha avuto successo, apparirà un messaggio di errore nella Console di Output.

Figure eVis 6:

The eVis Predefined queries tab

1. Apri File: permette di selezionare il file XML contenente le query predefinite.

2. Query predefinite: elenco delle query disponibili nel file XML.

3. Descrizione query: breve descrizione della query derivata dal file XML.

4. Console di Output: mostra i messaggi relativi all’esecuzione delle query.

5. Help: mostra la guida in linea.

6. OK: chiude Connessione Database .

Formato XML per le query predefinite di eVis¶

Tag XML letti da eVis

Segue un esempio completo di file XML contenente tre query:

<?xml version="1.0"?>
<doc>
 <query>
   <shortdescription>Import all photograph points</shortdescription>
   <description>This command will import all of the data in the SQLite database to QGIS
      </description>
   <databasetype>SQLITE</databasetype>
   <databasehost />
   <databaseport />
   <databasename>C:\textbackslash Workshop/textbackslash
eVis\_Data\textbackslash PhotoPoints.db</databasename>
   <databaseusername />
   <databasepassword />
   <sqlstatement>SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec_id=Attributes.point_ID</sqlstatement>
   <autoconnect>false</autoconnect>
 </query>
  <query>
   <shortdescription>Import photograph points "looking across Valley"</shortdescription>
   <description>This command will import only points that have photographs "looking across
      a valley" to QGIS</description>
   <databasetype>SQLITE</databasetype>
   <databasehost />
   <databaseport />
   <databasename>C:\Workshop\eVis_Data\PhotoPoints.db</databasename>
   <databaseusername />
   <databasepassword />
   <sqlstatement>SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec_id=Attributes.point_ID where COMMENTS='Looking across
      valley'</sqlstatement>
   <autoconnect>false</autoconnect>
 </query>
 <query>
   <shortdescription>Import photograph points that mention "limestone"</shortdescription>
   <description>This command will import only points that have photographs that mention
      "limestone" to QGIS</description>
   <databasetype>SQLITE</databasetype>
   <databasehost />
   <databaseport />
   <databasename>C:\Workshop\eVis_Data\PhotoPoints.db</databasename>
   <databaseusername />
   <databasepassword />
   <sqlstatement>SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec_id=Attributes.point_ID where COMMENTS like '%limestone%'
      </sqlstatement>
   <autoconnect>false</autoconnect>
 </query>
</doc>