Complemento eVis¶

Iniciando o módulo Navegador de Evento¶

Para iniciar o módulo Navegador de Eventos, clique em Banco de Dados‣ eVis ‣ eVis Navegador de Evento. Isto abrirá o Navegador genérico de Evento janela.

A janela Navegador de Evento tem três guias exibidas no topo da janela. A aba Exibir é usado para ver a fotografia e é associado aos dados atribuídos. A aba Opções fornece um número de ajustes que pode ser ajustado para controlar o comportamento to plug-in eVis. Por fim a aba Configurar Aplicações Externas é usado para permitir que o eVis exiba imagens de outros documentos.

Entendendo a Janela de Exibição¶

Para ver a janela Exibir , clique na aba Exibir na janela Navegado de Evento . A janela Exibir é usado para ver fotografias georreferenciadas e suas informações atribuídas associadas.

Figure eVis 1:

A janela de exibição do “eVis”

1. Display window: A window where the photograph will appear.

2. Botão mais Zoom: Dê Zoom para ver mais detalhes. Se a imagem inteira não pode ser exibida na janela de exibição, barras de rolagem aparecerão no lado esquerdo e inferior da janela para permitir que você se movimente pela imagem

3. Botão menos Zoom: Diminua o Zoom para ver mais área

4. Botão Zoom para extensão total: Mostra toda a extensão da fotografia.

5. Janela de informações de atributo: Toda as informações de atributo para o ponto associado com a fotografia que está sendo visualizada é apresentada aqui. Se o tipo do arquivo que está sendo referenciado no registro exibido não é uma imagem mas é um tipo de arquivo definido na aba Configurar Aplicações Externas , então quando você clica duas vezes sobre o campo de valor contendo o caminho para o arquivo, o aplicativo para abrir o arquivo será iniciado para ver ou ouvir o conteúdo do arquivo. Se as extensões do arquivo são reconhecidas, os dados do atributo serão exibidos em verde.

6. Navigation buttons: Use the Previous and Next buttons to load the previous or next feature when more than one feature is selected.

Entendendo a janela Opções¶

Figure eVis 2:

A janela de Opções do “eVis”

1. Caminho de arquivo: Uma lista suspensa para especificar o campo de atributo que contém o caminho do diretório ou URL para as fotografias ou outros documentos que estão sendo exibidos. Se a localização é um caminho relativo, então a caixa de seleção deve ser clicada. O caminho de base para um caminho relativo pode ser inserido na caixa de texto abaixo Caminho Base . Informação sobre diferentes opiniões para especificar a localização são anotadas na seção abaixo Especificando o local e o nome de uma fotografia .

2. Bússola: Uma lista suspensa para especificar o campo de atributo que contém a bússola associada com a fotografia que está sendo exibida. Se a informação da bússola estiver disponível, é necessário clicar na caixa de seleção abaixo do titulo do menu suspenso

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. Caminho Diretório base: O caminho de base para que o caminho relativo definido no Figure_eVis_2 (A) será anexado.

5. Substituir caminho: Se esta caixa de seleção está selecionada, apenas o nome do arquivo a partir de A será anexado ao caminho de base.

6. Aplicar regra a todos os documentos: Se marcado, as mesmas regras de caminho que são definidas para as fotografias serão usadas para os documentos não-imagem, como filmes, documentos de texto e arquivos de som. Se não marcado as regras de caminho só se aplica a fotografias e os outros documentos irão ignorar o parâmetro do caminho base.

7. Salve as configurações: Se esta opção estiver marcada, os valores dos parâmetros associados serão salvos para a próxima sessão, quando a janela é fechada ou quando o botão [Salvar] abaixo é pressionado.

8. Redefinir valores: Redefine os valores nesta linha para a configuração padrão.

9. Restaurar padrões Isto redefinirá todos os campos para suas configurações originais. Tem o mesmo efeito que clicar no botão [Redefinir]

10. Salvar: Isto salvará as configurações sem fechar o painel Opções

Entendendo a janela Configurar Aplicações Externas¶

Figure eVis 3:

A janela de Aplicações Externas do “eVis”

1. **Arquivo tabela de referência **: Uma tabela contendo os tipos de arquivos que podem ser abertos usando eVis. Cada tipo de arquivo tem uma extensão de arquivo e o caminho para um aplicativo poder abrí-lo. Isso fornece a capacidade de abrir uma ampla gama de arquivos como filmes, gravações sonoras, e documentos de texto em vez de apenas imagens.

2. Adicionar novo tipo de arquivo: Adiciona um novo tipo de arquivo com uma extensão única e o caminho para o aplicativo poder abrí-lo.

3. ** Excluir linha atual **: Exclui o tipo de arquivo em destaque na tabela e definido por uma extensão de arquivo e um caminho para um aplicativo associado.

Iniciando o módulo Identificação de Evento¶

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.

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 Navegador de Evento section of this guide.

Inicia o módulo Conexão com a Base de Dados¶

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.

Conectar a um banco de dados¶

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.

Digite o local hospedado do banco de dados na caixa de texto :guilabel: ‘Local do Banco de Dados`. Esta opção não estará disponível se você tiver selecionado ‘MS Access’ como o tipo de banco de dados. Se o banco de dados reside em seu desktop, você deve digitar “localhost”.

Entre o nome do banco de dados na caixa de texto Nome Banco de Dados . Se você selecionou ODBC como tipo de banco de dados, você precisa introduzir o nome da fonte de dados.

Quando todos os parâmetros são preenchidos, clique no botão ** [Connect] **. Se a conexão for bem sucedida, uma mensagem será gravada na janela :guilabel: Console de saída informando que a conexão foi estabelecida. Se uma conexão não foi estabelecida, você precisará checar os parâmetros que foram inseridos anteriormente.

Figure eVis 4:

A janela de conexão do banco de dados do “eVis”

1. Tipo de Base de dados: Uma lista suspensa para especificar o tipo de base de dados que será usado.

2. Banco de dados hospedeiro: O nome do banco de dados hospedeiro.

3. Porta: O numero da porta se uma base de dados MySQL ou PostgreSQL for selecionada.

4. Nome do banco de dados: O nome do banco de dados.

5. Conectar Um botão para conectar-se a banco de dados usando os parâmetros definidos acima.

6. Console de Saída A janela do console onde as mensagens relacionadas ao processamento são exibidos.

7. Nome de Usuário: Nome de usuário para uso quando uma base de dados é protegida por senha.

8. Senha: Senha para uso quando um banco de dados é protegida por senha.

9. Consultas pré-definidas: Guia para abrir a janela “Consultas pré-definidas”.

10. **Conexão com o banco de dados **: Guia para abrir a janela “Conexão com o Banco de dados”.

11. Consulta SQL: Guia para abrir a janela “Consulta SQL”.

12. Ajuda: Mostra a ajuda online.

13. OK: Fecha a janela principal do “Conexão com o Banco de Dados”.

Execução de consultas 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.

Clique no botão ** [Executar Consulta] ** para executar o comando. Se a consulta for bem sucedida, a janela Seleção de Arquivo de Banco de Dados será exibida. Se a consulta não for bem sucedida, uma mensagem de erro aparecerá na janela Console de Saída.

No Seleção de arquivo do banco de dados`janela, insira o nome da camada que será criada a partir dos resultados da consulta na caixa de texto :guilabel:`Nome da Nova Camada .

Figure eVis 5:

A tabela de consulta SQL do eVis

1. Janela de Texto de Consulta SQL: Uma tela para escrever consultas SQL.

2. Executar consulta: Botão que executa a consulta no SQL Janela de Consulta.

3. Janela Console: A janela console onde as mensagens relacionadas ao processamento são exibidas.

4. Ajuda: Mostra a ajuda online.

5. OK: Fecha o principal Conexão banco de dados janela.

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...’

Executando consultas pré-definidas¶

Com consultas predefinidas você pode selecionar consultas previamente escritas e armazenadas no formato XML em um arquivo. Isto é particularmente útil se você não estiver familiarizado com os comandos SQL. Clique na guia :guilabel:`Consultas Predefinidas’ para exibir a interface de consulta pré definida.

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.

Selecione a consulta que você deseja executar no menu suspenso e, então clique em aba Consulta SQL para ver se a consulta foi carregada na janela Consulta. Se for a primeira vez que você estiver executando uma consulta predefinida ou estiver migrando bancos de dados, você precisa ter certeza de estar conectado ao banco de dados.

Clique no botão [Executar Consulta] na aba SQL Consulta para executar o comando. Se a consulta é bem sucedida, a janela Seleção do Banco de Dados do Arquivo será exibida. Se a consulta não for bem sucedida, uma mensagem de erro aparecerá na janela Console de Saída

Figure eVis 6:

A guia de Consultas Pré-definidas do “eVis”

1. Abrir Arquivo: Inicia o navegador de arquivos “Abrir Arquivo” para procurar pelo arquivo XML mantendo as consultas pré-definidas.

2. Consultas Pré-definidas: Uma lista suspensa com todas as consultas definidas pelo arquivo XML de consultas pré-definidas

3. Consulta descrição: Uma breve descrição da consulta. Esta descrição é do arquivo consultas prédefinida XML.

4. Janela Console: A janela console onde as mensagens relacionadas ao processamento são exibidas.

5. Ajuda: Mostra a ajuda online.

6. OK: Fecha a janela principal do “Conexão com o Banco de Dados”.

Formato XML para consultas predefinidas eVis¶

As marcas XML lidas por eVis

Um exemplo de arquivo XML completo com três consultas é exibido abaixo:

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