Модуль eVis¶

Запуск модуля «Обозреватель событи黶

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

Окно Обозреватель событий состоит из трёх вкладок, расположенных сверху. Вкладка Вывод используется для просмотра фотографий и связанной с ними атрибутивной информации. Вкладка Параметры содержит набор настроек, позволяющих управлять поведением расширения eVis. И, наконец, вкладка Внешние приложения используется для сопоставления расширений файлов, отличных от изображений, и приложений, используемых в eVis для их отображения.

Назначение окна «Выво件

To see the Display window, click on the Display tab in the Event Browser window. The Display window is used to view geocoded photographs and their associated attribute data.

Figure eVis 1:

Окно «Вывод» расширения eVis

1. Область вывода изображения: Область отображения фотографий.

2. Кнопка «Увеличить»: Увеличьте фотографию для просмотра мелких деталей. Если изображение полностью не помещается в окно просмотра, воспользуйтесь полосами прокрутки, расположенными с левой и с нижней стороны окна и позволяющими перемещаться по изображению.

3. Кнопка «Уменьшить»: Уменьшите фотографию для просмотра больших территорий.

4. Увеличить до полного охвата: Отобразить полный охват фотографии.

5. Attribute information window: All of the attribute information for the point associated with the photograph being viewed is displayed here. If the file type being referenced in the displayed record is not an image but is of a file type defined in the Configure External Applications tab, then when you double-click on the value of the field containing the path to the file, the application to open the file will be launched to view or hear the contents of the file. If the file extension is recognized, the attribute data will be displayed in green.

6. Навигационные кнопки: Если выделено более одного объекта, то используйте кнопки [Предыдущее] и [Следующее] для перехода между ними.

Назначение окна «Параметры»¶

Figure eVis 2:

Окно «Параметры» расширения eVis

1. File path: A drop-down list to specify the attribute field that contains the directory path or URL for the photographs or other documents being displayed. If the location is a relative path, then the checkbox must be clicked. The base path for a relative path can be entered in the Base Path text box below. Information about the different options for specifying the file location are noted in the section Определение местоположения и названия фотографий below.
2. Compass bearing: A drop-down list to specify the attribute field that contains the compass bearing associated with the photograph being displayed. If compass bearing information is available, it is necessary to click the checkbox below the drop-down menu title.
3. Compass offset: Compass offsets can be used to compensate for declination (to adjust bearings collected using magnetic bearings to true north bearings). Click the Manual radio button to enter the offset in the text box or click the From Attribute radio button to select the attribute field containing the offsets. For both of these options, east declinations should be entered using positive values, and west declinations should use negative values.

4. Базовый путь: Базовый путь, относительно которого определяются относительные пути, определённые, как показано на рисунке Figure_eVis_2 (A).

5. Replace path: If this checkbox is checked, only the file name from A will be appended to the base path.
6. Apply rule to all documents: If checked, the same path rules that are defined for photographs will be used for non-image documents such as movies, text documents, and sound files. If not checked, the path rules will only apply to photographs, and other documents will ignore the base path parameter.
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. Восстановить: Сбросить и установить параметр в значение по умолчанию.

9. Восстановить по умолчанию: Сбросить значения всех полей и установить в значения по умолчанию. Данная операция эквивалентна последовательному нажатию кнопок [Восстановить] возле каждого параметра.

10. Сохранить: Сохранить настройки, не закрывая вкладку Параметры.

Назначение окна «Внешние приложения»¶

Figure eVis 3:

Окно «Внешние приложения» расширения eVis

1. Таблица сопоставления: Таблица содержит типы файлов, которые можно открыть, используя eVis. Для каждого типа представляется расширение и путь к приложению, позволяющему открыть файл данного типа. Таким образом, появляется возможность открыть практически любой файл, например, видео, звуковую запись или текстовый документ, а не только изображение.

2. Добавить новый тип файлов: Добавить новый тип файлов с уникальным расширением и путь до приложения, которое его откроет.

3. Удалить текущую строку: Удалить из таблицы выбранный тип файлов.

Запуск модуля «Определить события»¶

To launch the ‘Event ID’ module, either click on the ^{Event ID} icon or click on Database ‣ eVis ‣ Event ID Tool. This will cause the cursor to change to an arrow with an ‘i’ on top of it signifying that the ID tool is active.

Для просмотра фотографий, связанных с объектами активного векторного слоя, открытого в QGIS, поместите курсор на объект и щёлкните мышкой. После щелчка на объекте откроется окно Обозреватель событий и фотография, доступная для отображения в обозревателе, на месте щелчка или около него. Если доступно несколько фотографий, то для перемещения между различными объектами используйте кнопки [Предыдущее] и [Следующее]. Остальные управляющие элементы описаны в разделе Обозреватель событий данного руководства.

Загрузка модуля «Соединение с БД»¶

To launch the ‘Database Connection’ module, either click on the appropriate icon ^{eVis Database Connection} or click on Database ‣ eVis ‣ Database Connection. This will launch the Database Connection window. The window has three tabs: Predefined Queries, Database Connection, and SQL Query. The Output Console window at the bottom of the window displays the status of actions initiated by the different sections of this module.

Соединение с БД¶

Click on the Database Connection tab to open the database connection interface. Next, use the Database Type combo box to select the type of database that you want to connect to. If a password or username is required, that information can be entered in the Username and Password textboxes.

Enter the database host in the Database Host textbox. This option is not available if you selected ‘MS Access’ as the database type. If the database resides on your desktop, you should enter “localhost”.

В поле База данных укажите имя базы данных. Если выбран тип «ODBC», то укажите здесь имя источника данных.

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.

Figure eVis 4:

Окно «Соединение с БД» расширения eVis

1. Database Type: A drop-down list to specify the type of database that will be used.

2. Сервер БД: Адрес сервера баз данных.

3. Port: The port number if a MySQL or PostgreSQL database type is selected.
4. Database Name: The name of the database.
5. Connect: A button to connect to the database using the parameters defined above.
6. Output Console: The console window where messages related to processing are displayed.

7. Пользователь: Имя пользователя, указываемое в случае защиты доступа к базе данных паролем.

8. Пароль: Пароль, соответствующий имени пользователя.

9. Предопределённые запросы: Вкладка Предопределённые запросы.

10. Соединение с БД: Вкладка Соединение с БД.

11. SQL-запрос: Вкладка SQL-запрос.

12. Help: Displays the online help.

13. OK: Закрыть главное окно Соединение с БД.

Выполнение 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.

В окне Выбор файла БД в поле Имя нового слоя введите имя слоя, который будет создан на основе результатов выборки.

Figure eVis 5:

Вкладка «SQL-запрос» расширения eVis

1. Текстовое поле «SQL-запрос»: Место ввода SQL-запросов.

2. Выполнить: Кнопка выполнения SQL-запросов.

3. Консоль вывода: Консольное окно, в котором отображаются сообщения, связанные с работой модуля.

4. Help: Displays the online help.

5. OK: Закрыть главное окно Соединение с БД.

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.

To save this vector file for future use, you can use the QGIS ‘Save as...’ command that is accessed by right-clicking on the layer name in the QGIS map legend and then selecting ‘Save as...’

Запуск предопределённых запросов¶

With predefined queries, you can select previously written queries stored in XML format in a file. This is particularly helpful if you are not familiar with SQL commands. Click on the Predefined Queries tab to display the predefined query interface.

To load a set of predefined queries, click on the ^{Open File} icon. This opens the Open File window, which is used to locate the file containing the SQL queries. When the queries are loaded, their titles as defined in the XML file will appear in the drop-down menu located just below the ^{Open File} icon. The full description of the query is displayed in the text window under the drop-down menu.

Select the query you want to run from the drop-down menu and then click on the SQL Query tab to see that the query has been loaded into the query window. If it is the first time you are running a predefined query or are switching databases, you need to be sure to connect to the 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.

Figure eVis 6:

The eVis Predefined Queries tab

1. Открыть файл: Вызов окна Открыть файл для поиска XML-файла, содержащего предопределённые запросы.

2. Predefined Queries: A drop-down list with all of the queries defined by the predefined queries XML file.

3. Описание запроса: Короткое описание запроса, берётся из XML-файла.

4. Консоль вывода: Консольное окно, в котором отображаются сообщения, связанные с работой модуля.

5. Help: Displays the online help.

6. OK: Закрыть главное окно Соединение с БД.

XML-формат предопределённых запросов eVis¶

XML-теги eVis

Пример XML-файла, содержащего три запроса:

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