Extension eVis¶

Afficher le navigateur d’évènement¶

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

La fenêtre de navigateur affiche 3 onglets dans sa partie supérieure. L’onglet Affichage est utilisé pour voir la photographie et les données attributaires correspondantes. L’onglet des options fournit une série de paramètres qui peuvent être ajustés pour contrôler le comportement de l’extension eVis. Enfin, l’onglet de configurer les applications externes contient une table des extensions de fichiers et des applications qui leur sont associées pour permettre à eVis d’afficher des documents autre qu’une image.

La fenêtre Affichage¶

Pour voir la fenêtre Affichage, cliquez sur l’onglet Affichage du navigateur d’évènement. Cette fenêtre est utilisée pour visualiser les photographies et leurs données attributaires.

La fenêtre Affichage d’eVIS

1. Zone d’affichage : emplacement où s’affichera l’image.

2. Bouton Zoom + : Zoomez pour voir plus de détails. Si l’image ne peut être affichée entièrement dans la fenêtre, des barres de défilement apparaîtront sur les bords gauches et inférieures pour que vous puissiez bouger l’image.

3. Bouton Zoom - : Zoomez en arrière pour avoir une vue d’ensemble.

4. Bouton Zoomer sur l’emprise : Affiche l’emprise maximale de la photographie.

5. Zone d’informations : Toutes les informations attributaires pour le point associé à la photographie sélectionnée sont affichées ici. Si le type de fichier référencé n’est pas une image, mais d’un type renseigné dans l’onglet configurer les applications externes (il sera alors affiché en vert), un double clic lancera l’application désignée.

6. Boutons de navigation : Utilisez les boutons [Suivant] et [Précédent] pour charger une autre entité lorsque plusieurs sont sélectionnées.

La fenêtre Options¶

La fenêtre Options d’eVis

1. Chemin du fichier : Une liste déroulante permet de spécifier quel est l’attribut contenant le chemin d’accès vers le document devant être affiché. Si l’emplacement est un chemin relatif alors la case située juste en dessous doit être cochée. Le chemin de base peut être saisi dans la zone de texte. Les informations à propos des différentes options pour indiquer le chemin sont expliquées dans la section Spécifier un emplacement et le nom d’une photographie, ci-dessous.

2. Orientation de la boussole : Une liste déroulante pour définir le champ d’attribut qui contient l’orientation de la boussole associé à la photo affichée. Si des informations d’orientation de la boussole est disponible, il est nécessaire de cocher la case dessous le titre de menu déroulant.

3. Décalage de la boussole : les décalages de la boussole peuvent être utilisés afin de compenser la déclinaison (afin d’ajuster l’orientation collectée par orientation magnétique vers le vrai nord). Cliquez le bouton radio Manuel pour entrer le décalage dans le champ texte ou cliquez le bouton radio À partir d’un attribut afin de sélectionner le champ contenant les décalages. Pour ces deux options, les déclinations est doivent entrées en utilisant des valeurs positives et les déclinaisons ouest des valeurs négatives.

4. Directory base path : C’est le chemin à partir duquel le chemin relatif (A) définit dans la figure Figure_eVis_2 sera établi.

5. Remplacer le chemin : Si cette case est cochée alors seul le nom du fichier sera ajouté au chemin de base.

6. Appliquer la règle à tous les documents : Si cochée, la règle définie pour les photographies sera utilisée pour les autres documents tels que les fichiers textes, les vidéos et les fichiers audio. Dans le cas contraire, les règles s’appliqueront seulement aux photographies.

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. Réinitialiser : Remet les valeurs par défaut pour ce paramètre.

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. Enregistrer : Ceci enregistrera les valeurs sans fermer l’onglet des options.

La fenêtre Configurer les applications externes¶

La fenêtre Configuration des applications externes d’eVis

1. Tableau des références : Une table contient tous les types de fichiers qui peuvent être ouverts par eVis. Chaque type de fichier doit avoir une extension qui lui est propre et un chemin vers une application pour l’ouvrir. Ce la permet d’utiliser un large éventail de documents autre que des images.

2. Ajouter un nouveau type de fichier : Ajoute un nouveau type de fichier avec son extension et une application dédiée.

3. Effacer la cellule courante : Effacer le type de fichier sélectionné dans la table.

Lancement du module ID évènement¶

Pour lancer l’ ‘outil eVis Id Evenement’, cliquez soit sur ^{outil eVis Id Evenement} soit sur Base de données ‣ eVis ‣ Outil eVis Id Evenement. Votre curseur se transformera en une flèche avec un ‘i’ au-dessus signifiant par là que l’outil d’identification est actif.

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 Navigateur d’évènement section of this guide.

L’outil de connexion à une base de données¶

Pour lancer le module de ‘Connexion à la base de données’,cliquez soit sur l’icône correspondant ^{Connexion eVis à une base de données} soit sur Base de données ‣ eVis ‣ Connexion eVis à une base de données. Cette action ouvre la fenêtre Connexion à une base de données. Trois onglets sont disponibles : Requêtes prédéfinies, Connexion à une base de données, et Requête SQL. La fenêtre Console de sortie en bas de la fenêtre affiche le statut des actions initiées dans chacun des onglets de ce module.

Se connecter à une base¶

Cliquez sur l’onglet Connexion à une base puis sur le menu déroulant Type de la base de données pour sélectionner le type de base à laquelle vous voulez vous connecter. Vous pouvez saisir un nom d’utilisateur et un mot de passe si nécessaire.

Entrez le nom de l’hôte de la base de données dans la zone de texte Hôte de la base de données. Cette option n’est pas disponible si vous avez sélectionné ‘MS Access’ comme type de base de données. Si la base de données est localisée sur votre ordinateur, vous pouvez entrer “localhost”.

Renseignez le nom de la base de données dans la zone de texte Nom de la base de données. Si vous avez sélectionné ‘ODBC’ comme type de base de données, il vous faudra entrer le nom de la source de données.

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 fenêtre Connexion à une base de données d’ eVIS

1. Type de base de données : Une liste déroulante pour spécifier le type de base de données qui sera utilisée.

2. Hôte de la base de données : le nom de l’hôte de la base.

3. Port : Le numéro du port dans le cas d’une base de données MySQL ou PostGreSQL.

4. Nom de la base de données : Le nom de la base de données.

5. Connecter : Ce bouton établit la connexion avec les paramètres définis ci-dessus.

6. Console de sortie : Console où sont affichés les messages relatifs au déroulement des processus.

7. Nom d’utilisateur : Nécessaire quand la base est protégée en accès.

8. Mot de passe : Nécessaire quand la base est protégée en accès.

9. Requêtes Prédéfinies : Onglet ouvrant la fenêtre de Requêtes Prédéfinies.

10. Connexion à une base de données : Onglet ouvrant la fenêtre de Connexion à une base de données.

11. Requête SQL : Onglet ouvrant la fenêtre de Requête SQL.

12. Aide : Affiche l’aide en ligne.

13. OK : Ferme la fenêtre principale.

Faire une requête 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.

Dans cette nouvelle fenêtre, entrez le nom de la couche qui sera créée à partir des résultats dans la zone de texte Nom de la Nouvelle Couche.

L’onglet Requête SQL d’eVis

1. Zone de texte de requête SQL : Une zone poursaisir vos requêtes.

2. Exécuter la requête : Ce bouton exécute la requête écrite.

3. Console : Console où sont affichés les messages relatifs au déroulement de la connexion.

4. Aide : Affiche l’aide en ligne.

5. OK : Ferme la fenêtre Connexion à une base de données.

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.

Pour enregistrer ce fichier pour une utilisation ultérieure, vous pouvez utiliser la fonction de QGIS ‘Sauvegarder sous’ accessible via un clic droit sur la couche listée dans la zone de légende

Exécuter des requête prédéfinies¶

Avec les requêtes prédéfinies, vous pouvez sélectionner des requêtes déjà écrites et stockées au format XML. Cela peut être utile si vous n’êtes pas familier avec les commandes SQL. Cliquez sur l’onglet Requêtes prédéfinies pour afficher l’interface.

Pour charger un jeu de requêtes prédéfinies, cliquez sur le bouton ^Ouvrir. Une fenêtre s’ouvre pour sélectionner le fichier. Lorsque les requêtes sont chargées, leurs titres définis au format XML apparaîtront dans le menu déroulant situé en dessous du bouton ^Ouvrir. La description complète de la requête est affichée dans la zone en dessous de la liste.

Sélectionnez la requête que vous voulez exécuter depuis la liste déroulante et ensuite cliquez sur l’onglet de requête SQL pour observer la requête qui vient d’être chargée. Si c’est la première fois que vous exécutez une requête prédéfinie ou que vous changez de base de travail, vous devrez vous connecter à la base de données.

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.

L’onglet Requêtes prédéfinies d’eVis

1. Ouvrir le fichier: lance l’explorateur de fichier “ouvrir le fichier” afin de charger le fichier XML contenant les requêtes prédéfinies.

2. Requêtes prédéfinies : Une liste déroulante affichant toutes les requêtes prédéfinies dans le fichier XML.

3. Description de la requête : Une courte description de la requête.

4. Console : Console où sont affichés les messages relatifs au déroulement de la connexion.

5. Aide : Affiche l’aide en ligne.

6. OK : Ferme la fenêtre principale.

Le format XML pour les requêtes d’eVis¶

Les balises XML reconnues par eVis

Voici un exemple complet avec 3 requêtes:

<?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>