Outdated version of the documentation. Find the latest one here.

.

A caixa de ferramentas

A Caixa de ferramenta é o elemento principal da GUI de processamento, e o que você mais usará provável em seu trabalho diário. Ele mostra a lista de todos os algoritmos disponíveis agrupados em diferentes blocos, e é o ponto de acesso para executá-los, seja como um processamento único ou em lote que envolve várias execuções do mesmo algoritmo em diferentes conjuntos de entradas.

Figure Processing 5:

../../../_images/toolbox3.png

Caixa de Ferramentas Processamento win

A caixa de ferramentas contém todos os algoritmos disponíveis, divididos em grupos pré-definidos. Todos esses grupos podem ser encontrados numa árvore única com uma entrada que se chama Geoalgoritmos

Além disso, mais duas entradas são encontradas, ou seja, Modelos e Scripts. Estes incluem algoritmos criados pelo usuário, e eles permitem que você definir seus próprios fluxos de trabalho e tarefas de processamento. Vamos dedicar uma seção completa a eles um pouco mais tarde.

Na parte superior da caixa de ferramentas, você vai encontrar uma caixa de texto. Para reduzir o número de algoritmos mostrados na caixa de ferramentas e tornar mais fácil de encontrar o que você precisa, você pode digitar qualquer palavra ou frase na caixa de texto. Observe que, enquanto você digita, o número de algoritmos na caixa de ferramentas é reduzido para apenas aqueles que contêm o texto que introduziu o nome.

Na parte inferior, você encontrará uma caixa que lhe permite alternar entre a lista algoritmo simplificado (aquele explicado acima) e a lista avançada. Se você mudar para o modo avançado, a caixa de ferramentas será parecida com esta:

Figure Processing 6:

../../../_images/toolbox_advanced1.png

Caixa de Ferramentas Processamento (modo avançado) win

Na exibição avançada, cada grupo representa um chamado “provedor algoritmo’, que é um conjunto de algoritmos que vêm da mesma fonte, por exemplo, a partir de um aplicativo de terceiros com recursos de geoprocessamento. Alguns destes grupos representam algoritmos de aplicativos de terceiros, como SAGA, GRASS ou R, enquanto outros contêm algoritmos diretamente codificado como parte do complemento de processamento, não dependendo de nenhum software adicional.

Esta vista é recomendado para aqueles usuários que têm um certo conhecimento das aplicações que estão apoiando os algoritmos, uma vez que eles serão mostrados com seus nomes originais e grupos.

Além disso, alguns algoritmos adicionais estão disponíveis apenas na visualização avançada, tais como ferramentas de LiDAR e scripts com base no software de computação estatística R, entre outros. Independente QGIS complementos que adicionam novos algoritmos para a caixa de ferramentas só serão mostrado na exibição avançada.

Particularmente, a vista simplificada contém algoritmo dos seguintes fornecedores:

  • GRASS
  • SAGA
  • OTB
  • Algoritmos nativos QGIS

No caso de execução QGIS com o Windows, estes algoritmos são totalmente funcionais em uma nova instalação do QGIS, e eles podem ser executados sem a necessidade de nenhuma instalação adicional. Além disso, executá-los não requer nenhum conhecimento prévio dos aplicativos externos que usam, tornando-as mais acessível para usuários de primeira viagem.

Se você quiser usar um algoritmo não fornecido por qualquer dos provedores acima, mude para o modo avançado, selecionando a opção correspondente na parte inferior da caixa de ferramentas.

Para executar um algoritmo, de duplo clique no seu nome na 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:

../../../_images/parameters_dialog.png

Diálogo dos Parâmetros win

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:

../../../_images/vector_iterator.png

Botão de interação vetorial win

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:

../../../_images/number_selector.png

Selecionador de Números win

  • 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

    ../../../_images/extent.png

    Selecionador de Extensão win

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

    Figure Processing 11

    ../../../_images/extent_list.png

    Lista de Extensão win

    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:

    ../../../_images/extent_drag1.png

    Arrastamento para Extensão win

  • 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:

    ../../../_images/multiple_selection.png

    Múltipla Seleção win

  • 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:

    ../../../_images/fixed_table.png

    Tabela Fixa win

    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.

Uma nota nas projeções

Algoritmos executados a partir da estrutura de processamento — isso também é verdade para a maioria das aplicações externas cujos algoritmos são expostos através dele. Não realize nenhuma reprojeção em camadas de entrada e assuma que todos elas já estão em um sistema de coordenadas comum e pronto para serem analisadas. Sempre que você usar mais de uma camada como entrada para um algoritmo, se vetor ou raster, irá perguntar a você para se certificar que elas estão todas no mesmo sistema de coordenadas.

Note-se que, devido a capacidades de reprojeção on-the-fly do QGIS, apesar de duas camadas pode parecer sobrepor e corresponder, que pode não ser verdade, se as suas coordenadas originais são usadas ​​sem reprojeção em um sistema de coordenadas comum. Essa reprojeções deve ser feita manualmente, e, em seguida, os arquivos resultantes devem ser utilizados como entrada para o algoritmo. Também, notar que o processo reprojeções pode ser realizada com os algoritmos que estão disponíveis na própria estrutura de processamento.

Por padrão, a caixa de diálogo parâmetros mostrará uma descrição do SRC de cada camada, juntamente com o seu nome, tornando mais fácil para selecionar as camadas que compartilham o mesmo SRC para ser usado como camadas de entrada. Se você não quer ver essas informações adicionais, você pode desativar essa funcionalidade na janela de configuração de processamento, desmarcando a opção Mostrar SRC.

Se você tentar executar um algoritmo utilizando como entrada duas ou mais camadas com sem correspondência de SRC, um diálogo de aviso será exibido.

Pode continuar a executar o algoritmo, mas tenha atenção que na maioria dos casos irá produzir resultados errados, tais como, camadas vazias devido à falta de sobreposição das camadas usadas como arquivos de entrada.

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:

../../../_images/rendering_styles.png

Estilos de Renderização win

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.