A caixa de ferramentas¶

O diálogo do algoritmo¶

Uma vez que você clicar duas vezes sobre o nome do algoritmo que você deseja executar, uma caixa de diálogo semelhante à da figura abaixo é mostrado (neste caso, o diálogo corresponde ao algoritmo ‘índice de Convergência’ do SAGA).

Figure Processing 7:

Diálogo dos Parâmetros

Este diálogo é utilizado para definir os valores de entrada que o algoritmo precisa para ser executado. Ele mostra uma tabela onde os valores de entrada e os parâmetros de configuração serão definidos. É, obviamente, tem um teor diferente, dependendo dos requisitos do algoritmo a ser executado, e é criado automaticamente, com base em tais requisitos. No lado esquerdo, o nome do parâmetro é mostrado. No lado direito, o valor do parâmetro pode ser definido.

Embora o número e tipo de parâmetros dependerem das características do algoritmo, a estrutura é semelhante para todos eles. Os parâmetros encontrados na tabela podem ser de um dos seguintes tipos.

• Uma camada raster, selecione a partir de uma lista de todas as camadas disponíveis (atualmente abertas) no QGIS. O seletor contém também um botão no seu lado direito, para que você escolha nomes que representam as camadas atualmente não carregadas no QGIS.

• Uma camada de vetor, selecione a partir de uma lista de todas as camadas de vetores disponíveis no QGIS. Camadas não carregadas no QGIS podem ser selecionadas, bem como, como no caso de camadas raster, mas somente se o algoritmo não necessita de um campo da tabela selecionada a partir da tabela de atributos da camada. Nesse caso, apenas as camadas abertas podem ser selecionadas, uma vez que precisa ser aberta, de modo a recuperar a lista de nomes de campos disponíveis.

  Irá ver um botão por cada selecionador de camada vetorial, como é exibido na figura em baixo.

Figure Processing 8:

Botão de interação vetorial

Se o algoritmo contém vários deles, você será capaz de alternar apenas um deles. Se o botão que corresponde a um vetor de entrada é alternado, o algoritmo será executado de forma iterativa em cada uma de suas características, em vez de apenas uma vez para toda a camada, produzindo o maior número de saídas em vezes do algoritmo ser executado. Isto permite a automatização do processo quando todas as características de uma camada ter que ser tratada separadamente.

• Uma tabela, selecione a partir de uma lista de todos os disponíveis no QGIS. Tabelas não-espaciais são carregados para QGIS como camadas vetoriais, e na verdade, eles são tratados como tal pelo programa. Atualmente, a lista de tabelas disponíveis que você verá ao executar um algoritmo que precisa de um deles é restrito às tabelas provenientes de arquivos em formatos dBase (:file:. dbf) ou valores separados por vírgula (:file:. `csv `).

• Uma opção, para escolher de uma lista de seleção de uma lista de opções possíveis.

• Um valor numérico, a ser introduzido na caixa de texto. Você vai encontrar um botão ao seu lado. Clicando nele, você verá uma caixa de diálogo que permite que você digite uma expressão matemática, para que você possa usá-lo como uma calculadora de mão. Algumas variáveis ​​úteis relacionados com dados carregados em QGIS pode ser adicionado à sua expressão, de modo que você pode selecionar um valor derivado de qualquer uma dessas variáveis​​, como o tamanho das células de uma camada ou a mais setentrional de coordenadas do outro.

Figure Processing 9:

Selecionador de Números

• Um intervalo, com valores min e máx para serem introduzidos em duas caixas de texto.

• Uma cadeia de texto, para ser introduzida na caixa de texto.

• Um campo, para escolher a partir de uma tabela de atributos de uma camada vetorial ou uma tabela única de outro parâmetro.

• Um sistema de coordenadas de referência. Você pode digitar o código EPSG diretamente na caixa de texto, ou selecione-o na janela de seleção de SRC que aparece quando você clica com o botão do lado direito.

• Uma medida, a ser celebrada por quatro números que representam os seus limites xmin, xmax, ymin, ymax. Clicando no botão no lado direito do seletor de valor, um menu pop-up será exibido, dando-lhe duas opções: para selecionar o valor de uma camada ou a extensão da tela atual, ou defini-la arrastando diretamente na mapa de lona.

  Figure Processing 10

  

  Selecionador de Extensão

  Se selecione a primeira opção, irá ver uma janela igual a próxima.

  Figure Processing 11

  

  Lista de Extensão

  Se selecionar o segundo, os parâmetros da janela irão esconder-se, para que possa clicar e arrastar para o enquadramento. Uma vez definido o retângulo selecionado, o diálogo irá reaparecer, contendo os valores na caixa de texto da extensão.

  Figure Processing 12:

  

  Arrastamento para Extensão

• A lista de elementos (se as camadas raster, camadas de vetor ou tabelas), para selecionar a partir da lista de tais camadas disponíveis no QGIS. Para fazer a seleção, clique no pequeno botão do lado esquerdo da linha correspondente para ver uma janela como a seguinte.

  Figure Processing 13:

  

  Múltipla Seleção

• Uma pequena tabela para ser editada pelo utilizador. Estes são usados para definir os parâmetros como tabelas lookup ou kernels de convolução, entre outros.

  Clique no botão do lado direito para ver a tabela e editar os seus valores.

  Figure Processing 14:

  

  Tabela Fixa

  Dependendo do algoritmo, o número de linhas pode ser modificado ou não, utilizando os botões do lado direito da janela.

Você vai encontrar uma guia [Ajuda] na caixa de diálogo dos parâmetros. Se um arquivo de ajuda estiver disponível, ele será mostrado, dando-lhe mais informações sobre o algoritmo e descrições detalhadas do que cada parâmetro faz. Infelizmente, a maioria dos algoritmos não têm uma boa documentação, mas se você sentir vontade de contribuir com o projeto, este seria um bom lugar para começar.

Objetos de dados gerados por algoritmos¶

Objetos de dados gerado por um algoritmo podem ser dos seguintes tipos:

• Uma camada raster

• Uma camada vetorial

• Uma tabela

• Um arquivo HTML (usado para arquivo de saída de texto e gráficos)

Estes todos são salvos em disco, e a tabela de parâmetros irá conter uma caixa de texto correspondente a cada uma dessas saídas, onde você pode digitar o canal de saída e usar para salvá-la. Um canal de saída contém as informações necessárias para salvar o objeto resultante em algum lugar. No caso mais comum, você vai salvá-lo em um arquivo, mas a arquitetura permite a qualquer outra forma de armazenamento. Por exemplo, uma camada vetorial pode ser armazenada em um banco de dados ou até mesmo enviada para um servidor remoto usando um serviço WFS-T. Embora as soluções como estas ainda não estão implementadas, a estrutura de processamento está preparada para lidar com elas, e esperamos adicionar novos tipos de canais de saída em uma próxima feição.

Para selecionar um canal de saída, basta clicar no botão do lado direito da caixa de texto. Isso vai abrir uma caixa de diálogo salvar arquivo, onde você pode selecionar o caminho desejado para o arquivo. Extensões de arquivos suportadas são mostradas no seletor de formato de arquivo da caixa de diálogo, dependendo do tipo do produto e do algoritmo.

O formato da saída é definido pela extensão do arquivo. Os formatos suportados dependem do que é suportado pelo próprio algoritmo. Para selecionar um formato, basta selecionar a extensão do arquivo correspondente (ou em vez adicioná-la, se você estiver digitando diretamente o caminho do arquivo). Se a extensão do caminho do arquivo que você digitou não corresponde a nenhum dos formatos suportados, uma extensão do padrão (normalmente .dbf para tabelas, .tif para camadas raster e .shp para camadas vetoriais) será anexado ao caminho do arquivo e o formato de arquivo correspondente a essa extensão será usado para salvar a camada ou tabela.

Se você não digitar qualquer nome de arquivo, o resultado será salvo como um arquivo temporário no formato de arquivo padrão correspondente, e ele vai ser excluído depois de sair QGIS (tome cuidado com isso, no caso de você salvar seu projeto e contém camadas temporárias).

Você pode definir uma pasta padrão para objetos de dados de saída. Vá para a janela de configuração (você pode abri-la a partir do Menu :menuselection: Processamento), e no grupo Geral, você vai encontrar um parâmetro chamado pasta de saída. Esta pasta de saída é usada como o caminho padrão no caso de você digitar apenas um nome de arquivo sem caminho (isto é, myfile.shp) durante a execução de um algoritmo.

Ao executar um algoritmo que usa uma camada de vetor no modo interativo, o caminho do arquivo digitado é utilizado como o caminho de base para todos os arquivos gerados, que são nomeados com o nome de base e acrescentando-se um número que representa o índice da iteração. A extensão do arquivo (e formato) é usado para todos esses arquivos gerados.

Além de camadas raster e tabelas, algoritmos também geram gráficos e textos em arquivos HTML. Estes resultados estão apresentados no final da execução do algoritmo em uma nova caixa de diálogo. Este diálogo vai manter os resultados produzidos por qualquer algoritmo durante a seção atual, e pode ser mostrado em qualquer momento selecionando Processamento ‣ visualizador de resultados do menu principal QGIS.

Algumas aplicações externas podem ter arquivos (sem restrições de extensão particulares) como saída, mas elas não pertencem a nenhuma das categorias acima. Os arquivos de saída não serão processados pelo QGIS (aberto ou incluído no atual projeto QGIS), uma vez que a maior parte do tempo, eles correspondem a formatos de arquivo ou elementos não suportados pelo QGIS. Este é, por exemplo, o caso com os arquivos LAS usados ​​para dados LiDAR. Os arquivos são criados, mas você não vai ver nada de novo no sua seção de trabalho QGIS.

Para todos os outros tipos de saída, você encontrará uma caixa de verificação que você pode usar para dizer o algoritmo para saber se carregará o arquivo, uma vez que é gerado pelo algoritmo ou não. Por padrão, todos os arquivos são abertos.

Saídas opcionais não são suportadas. Ou seja, todas as saídas são criadas. No entanto, você pode desmarcar a caixa correspondente, se você não está interessado em um determinado produto, que essencialmente torna comportar-se como uma saída opcional (em outras palavras, a camada é criada de qualquer jeito, mas se você deixar a caixa de texto vazia, será salvo em um arquivo temporário e apagado quando sair QGIS).

Configurando a infraestrutura do processamento¶

Como foi mencionado, o menu de configuração dá acesso a um novo diálogo onde pode configurar a forma como o algoritmo trabalha. Os parâmetros de configuração são estruturados em blocos separados que podem ser seleccionados no lado esquerdo do diálogo.

Juntamente com o que já foi mencionada da entrada Pasta de saída, o bloco Geral contem parâmetros para configuração de estilos de renderização padrão para camadas de saída (ou seja, camadas geradas pela utilização de algoritmo de qualquer componente da infraestrutura do GUI). Basta criar um estilo que quer usar no QGIS, salva-lo num arquivo, e de seguida introduzir um caminho para o arquivo nas configurações para que sejam usado pelos algoritmos. Cada vez que a camada for carregada pelo SEXTANTE e adicionada ao enquadramento do QGIS, esta será renderizada com esse estilo.

Os estilos de renderização podem ser configurados individualmente para cada algoritmo e cada um para os seus arquivos de saída. Apenas clique com o direito do mouse no nome do algoritmo na caixa de ferramentas e selecione Editar estilos de renderização. Irá ver um diálogo como o que é exibido a seguir.

Figure Processing 15:

Estilos de Renderização

Selecione o arquivo de estilo (.qml) que quer para cada arquivo de saída e pressione [OK].

Os outros parâmetros de configuração no grupo Geral estão em baixo referidos:

• Use nome da camada como nome do arquivo. O nome de cada camada resultante criada por um algoritmo é definido pelo próprio algoritmo. Em alguns casos, um nome fixo pode ser utilizado, o que significa que o mesmo nome de saída vai ser usado, não importa qual a camada de entrada é usada. Em outros casos, o nome pode depender do nome da camada de entrada ou de alguns dos parâmetros usados ​​para executar o algoritmo. Se esta opção for assinalada, o nome será retirado o nome do arquivo de saída em seu lugar. Observe que, se a saída é salvo em um arquivo temporário, o nome deste arquivo temporário é geralmente uma longo e sem sentido que se destina a evitar a conflito com outros nomes de arquivos já existentes.

• Use somente recursos selecionados. Se essa opção for selecionada, sempre que uma camada de vetor é usada como entrada para um algoritmo, apenas suas feições selecionadas serão usadas. Se a camada não tiver feições selecionadas, todas as feições serão utilizadas.

• arquivo de pré-execução do script e arquivo de script pós-execução. Estes parâmetros se referem aos scripts escritos usando a funcionalidade de script de processamento e são explicados na seção cobertura scripting e do terminal.

Além de o bloco Geral na caixa de diálogo de configurações, você também vai encontrar um bloco para provedores de algoritmo. Cada entrada neste bloco contém um ítem Ativar que você pode usar para fazer algoritmos aparecer ou não na caixa de ferramentas. Além disso, alguns provedores de algoritmo têm seus próprios itens de configuração, que explicaremos mais tarde, quando cobrindo determinados provedores de algoritmo.