Home

Manual do DSGTools em PDF (v3.0.8)

Manual do DSGTools em PDF (v3.1)

Manual do DSGTools em PDF (v3.2)

Versão em PDF do manual da versão em desenvolvimento (v4.0dev)

API do DSGTools (para desenvolvedores)

Alterações da versão 4.0

O lançamento da nova versão LTR do QGIS (QGIS Madeira '3.4') vem acompanhada de diversas alterações de API e tecnologias utilizadas (como PyQt5 e Python3).

Estas alterações instigaram o DSGTools realizar, também, uma grande modificação em sua API, com refatorações de código, resenho de interfaces e, claro, correções de bugs e melhorias de performance e UX. A seguir, é apresentado as principais alterações do DSGTools.

Ferramentas de Servidor

A ferramenta de configuração de servidores, agora, conta com um campo Padrão, que define qual a conexão PostgreSQL globalmente para o DSGTools, de modo que ferramentas tenham acesso agilizado aos bancos de dados da conexão escolhida.

Ferramentas de Bancos de Dados

1. Criação de bancos de dados

A criação de bancos PostgreSQL e SpatiaLite, agora dividem uma mesma interface, definindo-se qual o formato de banco a ser criado por meio de uma guia na sua janela.

2. Conversão de bancos de dados

O conversor de dados foi completamente redesenhado. A interface foi refeita a fim de comportar uma nova proposta de conversão, que permite ao usuário a conversão M -> N (de mais de um banco para mais de uma fonte), sendo possível a conversão entre Geopackages, SpatiaLite, PostgreSQL e Shapefiles (?), sem restrições de qual o formato dos bancos de entrada ou dos de saída.

Mais informações em: seção de conversão de dados do manual.

Ferramentas de Camadas

Foi adicionado o suporte ao carregamento de bancos Geopackage por meio do Layer Loader.

Ferramentas de Produção

As ferramentas de produção tiveram mudanças pontuais, desde a apresentação das ferramentas no QGIS, conforme imagem abaixo, ao código core de algumas de suas funcionalidades.

divisórias entre toolboxes, map tools e toolbars.

1. Caixa de Ferramentas de Validação

(Ainda não está disponível)

A interface está sendo reprojetada de modo a propiciar ao usuário um ambiente de validação em que sejam bem definidos os fluxos de trabalho a serem executados, mantendo-se, assim, o passo com a gestão de projeto.

Além disso, os algoritmos de validação do DSGTools foram todos migrados para implementação em Python, adptou-se à caixa de algoritmos do Processing, criando o provedor de algoritmos do DSGTools. Esta alteração, além de permitir a integração com outros algoritmos disponibilizados no QGIS, permitiu a inclusão de rotinas do FME no fluxo de trabalho de validação pelo QGIS. Mais sobre os algoritmos do DSGTools na seção de algoritmos de validação.

2. A Ferramenta de (Re)Classificação de Feições foi renomeada para Ferramenta de Classificação de Feição

3. Ferramenta de Círculo foi removida do plugin, uma vez que há a disponibilização de uma, nativa do QGIS, que cumpre o que a ferramenta se propunha a realizar.

4. Adicionada a DSGTools: Ferramenta de Reshape à Mão Livre, que ofere a opção de reshape tal qual a DSGTools: Ferramenta de Aquisição à Mão Livre.

5. Adicionada a DSGTools: Toggle Labels Visibility, que permite alternar de maneira eficiente a visibilidade de labels.

BDGEx

Foi atualizado o catálogo de serviços disponibilizados pelo Banco de Dados Geográficos do Exército.

---

ALTERAÇÕES ANTIGAS

Novas funcionalidades

1. Ferramenta de Informação de Raster

Ferramentas que interage com layers Raster carregadas em canvas.

1.1 DSGTools: Informação das Bandas no Cursor do Mouse

Ferramenta que, quando ativada, expõe o(s) valor(es) de banda(s) do raster escolhido. Para ativá-la, basta acessá-la na barra de ferramentas por meio da Informação das Bandas no Cursor do Mouse, clicando no ícone .

1.2 DSGTools: Visualizador Dinâmico de Histograma

Ferramenta que, quando ativada, ajusta o histograma de acordo com os pixels presentes no presente quadro de visualização. Para ativá-la, basta acessá-la na barra de tarefas por meio da Visualizador Dinâmico de Histograma, clicando no ícone .

1.3 DSGTools: Capturar Valor do Raster

Ferramenta que atributa um campo de feição de primitiva do tipo ponto com o valor do pixel correspondente à sua posição de um raster. A ferramenta pode ser utilizada tanto para adquirir um ponto, por meio de um clique em tela, ou (re)atributa um conjunto de pontos que for selecionados dentro de um retângulo criado ao arrastar o mouse segurando o clique esquerdo do mouse e a tecla SHIFT. A ferramenta é acionada por meio do botão .

2. DSGTools: Flip Line Tool

Ferramenta utilizada para a inversão do sentido de aquisição linhas. Esta ferramenta age sobre as linhas selecionadas, sendo ativada por meio do botão .

3. DSGTools: Ferramenta de Aquisição a Mão Livre

A fim de facilitar a aquisição de novas feições, esta nova ferramenta, desenvolvida pelo contribuidor Jossan Costa (@jossanCosta), adquire feições a partir do movimento do mouse, sem a necessidade de cliques. Para utilizá-la, basta, após iniciar o modo de edição da camada a ter a feição adquirida, clicar em .

4. Novos Processos de Validação

Três novos processos foram adicionados à Caixa de Validação do DSGTools: Criar Nós da Rede, Verificar Direcionamento de Rede e Identificar Ângulos Fora dos Limites na Cobertura Terrestre. Os dois primeiros processos foram modelados para que, de forma harmoniosa, executem a validação topóligica de redes hidrológicas, incluindo o seu direcionamento.

4.1 Criar Nós da Rede

Este processo identifica e cria todos os nós da rede, classificando-os dentre 12 classes, conforme a imagem a seguir.

Para a execução do processo, é necessário o fornecimento dos seguintes parâmetros:

• Only Selected: criar nós somente as feições da rede selecionadas;
• Network Layer: camada da rede [de hidrografia] a ser direcionada;
• Search Radius: distância considerada para a classificação dos nós quanto ao posicionamento espacial relativo às camadas de comparação (moldura e camadas de corpo d'água);
• Sink Layer: camada que contém os sumidouros e vertedouros da rede; e
• Reference and Water Body Layers: camada de referência dos limites representados no conjunto de dados a serem validados (normalmente é a moldura) e todas as camadas que possuem feições representativas de corpos d'água que se relacionam com a rede.

4.2 Verificar Direcionamento de Rede

Processo projetado para a validação topológica da rede, baseada no relacionamento entre os componentes da rede hidrológica. Para a sua execução, os nós da rede devem ter sido anteriormente gerados, mesmo que não tenha sido gerado pelo processo Criar Nós da Rede (embora seja fortemente recomendado a criação e gestão de nós de forma automática por este processo).

Durante sua execução, o processo verifica a conformidade e correção, executando, sempre que possível, correções nas linhas componentes da rede hidrológica sendo validada. Considerando-se estas alterações, a rede pode assumir um comportamento bastante maleável e, assim, o processo foi concebido de maneira recursiva, de modo a tentar incorporar as alterações na rede proporcionadas por estas correções à medida que ocorrem e, por fim, mantendo o estado da rede o mais atualizado possível.

Paramâmetros do processo:

• Select All Valid Lines: indica se ao final do processo as linhas que foram consideradas válidas serão selecionadas;
• Node Layer: camada que contém os nós da rede a ser validada;
• Search Radius: distância considerada para a classificação dos nós quanto ao posicionamento espacial relativo às camadas de comparação (moldura e camadas de corpo d'água);
• Network Layer: camada da rede [de hidrografia] a ser direcionada;
• Max. Directioning Cycles: o número máximo de ciclos de direcionamento a serem executados;
• Reference and Water Body Layers: camada de referência dos limites representados no conjunto de dados a serem validados (normalmente é a moldura) e todas as camadas que possuem feições representativas de corpos d'água que se relacionam com a rede; e
• Sink Layer: camada que contém os sumidouros e vertedouros da rede.

4.3 Identificar Ângulos Fora dos Limites na Cobertura Terrestre

Processo que identifica pequenos ângulos em camadas que compõem a cobertura terrestre. Relaciona camadas de polígonos com linhas.

Paramâmetros do processo:

• Classes: camadas a serem verificadas. São exibidas somente as camadas de primitiva do tipo linha e polígono;
• Angle: limiar angular mínimo. Qualquer ângulo menor que esse valor é marcado como flag.

Melhorias

1. DSGTools: Ferramenta de Seleção Genérica

• Rubberband destancando feições: as feições que serão afetadas pela ação embaixo do cursor do mouse no menu de contexto são iluminadas por uma rubberband;
• Novo agrupamento do menu de contexto: o menu de contexto se adapata às feições presentes na região de seleção aplicada, de acordo com o estado de seleção das feições e da quantidade de classes distintas, ordenando-as em ordem alfabética, assim como as feições de cada classe (por ID);
• Seleção de classes de mesma primitiva: quando há a contínua seleção de feições, as demais feições que poderão ser selecionadas dependem da primitiva mais forte (ponto > linha > polígono) do conjunto de feições já selecionadas (e.g. se houver uma classe do tipo "ponto", apenas pontos poderão ser selecionados complementarmente); e
• Otimização de performance: ferramenta teve seu algoritmo de seleção otimizado, de forma a melhorar o tempo de execução.

2. Caixa de Ferramentas de Validação

• Identificar Pontas Livres: processo possui o parâmetro "Raio de busca" marcado como opcional;
• Filtro de flags dos processos de validação: o filtro permite filtragem por processo e classe;
• Checar Regras Espaciais: processo permite o não preenchimento da cardinalidade da regra (há casos em que a ocorrência da regra independe da cardinalidade); e
• Log de processos de validação: o log exposto no QGIS foi alterado e faz parte do log apresentado no histórico e o histórico pode ser filtrado por usuário (que executou o processo).

3. Opções

Agora alguns parâmetros das ferramentas DSGTools: Ferramenta de Seleção Genérica e DSGTools: Aquisição a Mão Livre definidos acessando DSGTools > Opções.

4. Ferramenta de Aquisição em Ângulos Retos

As seguintes melhorias foram desenvolvidas pelo contribuidor Ronaldo Martins (@ronaldomsjr):

• Comprimento da aresta em tempo real: a ferramenta agora mostra comprimento em tempo real da aresta que está sendo digitalizada;
• Rubberband melhorado: o rubberband agora já mostra a pré-visualização da figura fechada;
• Rubberband mostra construção inválida de polígono: a ferramenta avisa pela cor do rubberband quando o usuário tenta fechar uma figura que não está válida.