Plugin eVis¶

Aprire il modulo Browser evento¶

To launch the Event Browser module, click on Database ‣ eVis ‣ eVis Event Browser. This will open the Generic Event Browser window.

La finestra Browser evento ha tre schede visualizzate nella parte superiore della finestra. La scheda Visualizza è usata per visualizzare la fotografia e i suoi dati di attributo associati. La scheda Opzioni fornisce un numero di impostazioni che possono essere regolate per controllare il comportamento del plugin eVis. Infine, la scheda Configura Applicazioni Esterne serve per mantenere una tabella delle estensioni dei file e le loro associate applicazioni per consentire a eVis di visualizzare documenti diversi dalle immagini.

Scheda Visualizza¶

Per visualizzare la finestra Visualizza, fai click sulla scheda Visualizza nella finestra Browser Evento. La finestra Visualizza è usata per visualizzare le fotografie geocodificate e i relativi dati attributo.

Visualizzare finestra di dialogo eVis

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 per vedere più parti dell’immagine.

4. Zoom completo: visualizza tutta l’immagine.

5. Finestra degli attributi: qui vengono visualizzate tutte le informazioni sugli attributi per il punto associato alla fotografia visualizzata. Se il tipo di file a cui si fa riferimento nel record visualizzato non è un’immagine ma è di un tipo di file definito in Configura applicazioni esterne, facendo doppio clic sul valore del campo contenente il percorso del file, verrà avviata l’applicazione per aprire il file da visualizzare o ascoltare il contenuto del file. Se l’estensione del file viene riconosciuta, i dati dell’attributo verranno visualizzati in verde.

6. Pulsanti per la navigazione: utilizzare i pulsanti Precedente e Successivo per caricare l’oggetto precedente o successivo quando è selezionato più di un oggetto.

Scheda Opzioni¶

Opzioni finestra di dialogo eVis

1. Percorso file: elenco a discesa per specificare l’attributo campo contenente il percorso o l’URL della directory per le fotografie o altri documenti visualizzati. Se la posizione è un percorso relativo, la casella di controllo deve essere attivata. Il percorso di base per un percorso relativo può essere immesso nella casella di testo Percorso base sottostante. Informazioni sulle diverse opzioni per specificare la posizione del file sono indicate in basso nella sezione Specificare la localizzazione ed il nome di una foto

2. Orientamento bussola: un elenco a discesa per specificare il campo dell’attributo che contiene l’orientamento della bussola associato alla fotografia visualizzata. Se sono disponibili informazioni sulla bussola, è necessario fare clic sulla casella di controllo sotto il titolo del menu a discesa.

3. Offset bussola: gi offset della bussola possono essere utilizzati per compensare la declinazione (per regolare l’orientamento magnetico all’orientamento del nord effettivo). Fai click sul pulsante radio Manuale per immettere l’offset nella casella di testo o fai click sul pulsante radio Da Attributo per selezionare il campo attributo contenente gli offset. Per entrambe queste opzioni, le declinazioni est devono essere immesse usando valori positivi e le declinazioni ovest dovrebbero utilizzare valori negativi.

4. Percorso base della cartella: il percorso base su cui verrà associato il percorso relativo definito inFigure_eVis_options (A).

5. Sostituisci percorso: se è selezionata questa casella di controllo, solo il nome di file in A verrà aggiunto al percorso base.

6. Applica regola a tutti i documenti: se selezionato, le stesse regole di percorso definite per le fotografie verranno utilizzate per documenti non di immagine, ad esempio filmati, documenti di testo e file audio. Se non è selezionato, le regole del percorso si applicano solo alle fotografie e gli altri documenti ignoreranno il parametro del percorso base.

7. Remember settings: If the checkbox is checked, the values for the associated parameters will be saved for the next session when the window is closed or when the [Save] button below is pressed.

8. Ripristina: reimposta il campo al valore predefinito.

9. Restore defaults: This will reset all of the fields to their default settings. It has the same effect as clicking all of the [Reset] buttons.

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

Configura applicazioni esterne¶

La finestra Applicazioni Esterne di eVis

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 avviare il modulo ‘ID evento’, fai click sull’icona ^{ID evento} o fai click su Database -> eVis -> Strumento ID evento. Ciò farà sì che il cursore si trasformi in una freccia con una ‘i’ sopra di esso a significare che lo strumento ID è attivo.

To view the photographs linked to vector features in the active vector layer displayed in the QGIS map window, move the Event ID cursor over the feature and then click the mouse. After clicking on the feature, the Event Browser window is opened and the photographs on or near the clicked locality are available for display in the browser. If more than one photograph is available, you can cycle through the different features using the [Previous] and [Next] buttons. The other controls are described in the Browser evento section of this guide.

Aprire Connessione Database¶

Per avviare il modulo ‘Connessione Database’, fai click sull’apposita icona ^{Connessione a database eVis} o fai clic su Database -> eVis -> Connessione database. Questo lancerà la finestra Connessione Database. La finestra ha tre schede: Query predefinite, Connessione Database e SQL Query. La finestra Console di output nella parte inferiore della finestra mostra lo stato delle azioni avviate dalle diverse sezioni di questo modulo.

Connessione Database¶

Fai click sulla scheda Connessione Database per aprire l’interfaccia di connessione al database. Quindi, utilizza Tipo database casella combinata per selezionare il tipo di database a cui ti vuoi connettere. Se è richiesta una password o un nome utente, tali informazioni possono essere inserite nelle caselle di testo Nome utente e Password.

Inserire il server del database in Host Database. Questa opzione non è disponibile se hai scelto ‘MSAccess’ come tipo di database. Se il database si trova sul tuo desktop, allora dovrai inserire “localhost”.

Immetti il nome del database nella casella di testo Nome database. Se hai selezionato ‘ODBC’ come tipo di database, devi specificare il nome dell’origine dati.

When all of the parameters are filled in, click on the [Connect] button. If the connection is successful, a message will be written in the Output Console window stating that the connection was established. If a connection was not established, you will need to check that the correct parameters were entered above.

La finestra connessione Database di eVis

1. Tipo di Database: una lista a discesa per specificare il tipo di database che sarà utilizzato.

2. Host Database: nome host del database.

3. Porta: il numero di porta se il tipo di database selezionato è MYSQL o PostgreSQL.

4. Nome Database: nome del database.

5. Connetti: un pulsante per connettersi al database utilizzando i parametri sopra definiti.

6. Console di Output: la finestra console dove vengono visualizzati i messaggi relativi alla 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¶

SQL queries are used to extract information from a database or ODBC resource. In eVis, the output from these queries is a vector layer added to the QGIS map window. Click on the SQL Query tab to display the SQL query interface. SQL commands can be entered in this text window. A helpful tutorial on SQL commands is available at http://www.w3schools.com/sql. For example, to extract all of the data from a worksheet in an Excel file, select * from [sheet1$] where sheet1 is the name of the worksheet.

Click on the [Run Query] button to execute the command. If the query is successful, a Database File Selection window will be displayed. If the query is not successful, an error message will appear in the Output Console window.

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

La scheda interrogazione SQL di eVis

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.

Use the X Coordinate and Y Coordinate combo boxes to select the fields from the database that stores the X (or longitude) and Y (or latitude) coordinates. Clicking on the [OK] button causes the vector layer created from the SQL query to be displayed in the QGIS map window.

Per salvare questo file vettoriale per uso futuro, puoi utilizzare il comando ‘Salva come ...’ di QGIS a cui si accede facendo click con il tasto destro del mouse sul nome del layer nella legenda della mappa QGIS e quindi selezionando ‘Salva come ...’

Eseguire query predefinite¶

Con le query predefinite, puoi selezionare query scritte in precedenza memorizzate in formato XML in un file. Ciò è particolarmente utile se non hai familiarità con i comandi SQL. Fai clic sulla scheda Query predefinite per visualizzare l’interfaccia di query predefinita.

Per caricare una serie di query predefinite, fai click sull’icona ^{Apri file}. Si apre la finestra Apri file, che viene utilizzata per individuare il file contenente le query SQL. Quando le query vengono caricate, i loro nomi come definiti nel file XML appariranno nel menu a discesa situato proprio sotto l’icona ^{Apri file}. La descrizione completa della query viene visualizzata nella finestra di testo sotto il menu a discesa.

Seleziona la query che vuoi eseguire dal menu a discesa e quindi fai click sulla scheda Query SQL per verificare che la query sia stata caricata nella finestra della query. Se è la prima volta che sta eseguendo una query predefinita o sta cambiando database, devi assicurarti di essere connesso al database.

Click on the [Run Query] button in the SQL Query tab to execute the command. If the query is successful, a Database File Selection window will be displayed. If the query is not successful, an error message will appear in the Output Console window.

Scheda Query predefinite eVis

1. Apri file: avvia il browser file “Apri file” per cercare il file XML che contiene le query predefinite.

2. Query predefinite: un elenco a discesa con tutte le query definite dal file XML delle query predefinite.

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>