Home

Versão em PDF do manual (v3.0.8)

Versão em PDF do manual (v3.1.0)

Versão em PDF do manual (v3.2_dev)

API do DsgTools (para desenvolvedores)

Alterações da versão 3.2

Visando a constante evolução e otimização das linhas de produção cartográfica, o DSGTools terá novas funcionalidades, melhorias de uso e performance de ferramentas além de correção de bugs.

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 Ferramentas DSG > Opções.

Alterações da versão 3.1

Acompanhando as melhorias no QGIS, o DSGTools agora possui versão mínima 2.18

Novas funcionalidades

1. Novo modelo de banco de dados: EDGV 3.0

A CONCAR (Comissão de Cartografia) disponibilizou em sua página de internet a versão preliminar da EDGV 3.0, a qual pode ser baixada nos seguintes links:

• Versão preliminar do texto

• Versão preliminar dos anexos

Foi implementada no DsgTools a norma supracitada. Por se tratar de uma norma preliminar, o banco implementado também é preliminar, ou seja, está sujeito a correções. A implementação é uma versão beta e a migração dos dados será a cargo do usuário. Após consolidação do modelo, a equipe do DSGTools disponibilizará um conversor da versão 2.1.3 para a versão 3.0.

2. Novo processo de validação: Unir Linhas com Atributos Comuns

Processo de validação que compara linhas que se conectam e as une baseado nos atributos, ou seja, linhas com mesmo conjunto de atributos serão unidas. Recebe como parâmetros a lista de camadas do tipo linha a serem unidas e parâmetros de atração (snap) utilizados na limpeza executada como pós processo. Neste processo existe a possibilidade de rodar somente nas feições selecionadas das camadas escolhidas. Após o procedimento de união, é executado um procedimento de limpeza no dado, para eliminar possíveis problemas advindos da união. A animação abaixo ilustra a execução do processo de unir linhas.

Para maiores informações sobre este método, visite Unir linhas na nossa Wiki.

3. Novo processo de validação: Identificar Pontas Soltas

Processo de validação que serve para indicar problemas de conectividade. Recebe como parâmetros a camada a serem validada, o raio de busca, um parâmetro de escolha de somente os selecionados, a lista de filtros e o tipo de identificação.

Para maiores informações sobre este método, visite Identificar Pontas Soltas na nossa Wiki.

4. Novo processo de validação: Seccionar Linhas com Linhas

Processo de validação que serve para aproximar linhas em um raio de atração e quebrar linhas nas intersecções.

Para maiores informações sobre este método, visite Seccionar Linhas com Linhas na nossa Wiki.

5. Novo processo de validação: Cortar Elementos Utilizando Áreas como Referência

Processo que consiste cortar um conjunto de feições de acordo com as feições da camada de referência. Existem duas opções: manter os elementos fora da referência e descartar os elementos fora da referência.

Para maiores informações sobre este método, visite Cortar elementos utilizando áreas como referência na nossa Wiki.

6. Novo processo de validação: Identificar Buracos e Sobreposições em Camadas de Cobertura Terrestre

Em uma camada de cobertura terrestre não pode haver nem buracos nem sobreposições. Devido a manipulação de dados durante a etapa de aquisição, podem ocorrer buracos e sobreposições de elementos sem que o operador perceba. Sendo assim, foi desenvolvido um processo de validação para verificar a ocorrência de buracos e sobreposições nas camadas que compõem a cobertura terrestre.

Para maiores informações sobre este método, visite Identificar buracos e sobreposições em camadas de cobertura terrestre na nossa Wiki.

7. Novo processo de validação: Identificar Buracos em Camadas

Semelhante ao processo de identificar buracos na cobertura terrestre, porém identifica apenas buracos internos a camada.

Para maiores informações sobre este método, visite Identificar Buracos em Camadas na nossa Wiki.

8. Novo processo de validação: Identificar Sobreposições em Camadas

Semelhante ao processo de identificar sobreposições na cobertura terrestre, porém identifica apenas sobreposições internas a camada.

Para maiores informações sobre este método, visite Identificar Sobreposições em Camadas na nossa Wiki.

Melhorias

1. Ferramenta de seleção genérica agora abre um menu para que o usuário escolha a feição a ser selecionada quando há múltiplas opções para a seleção

2. Ferramenta de área mínima agora permite rotação do gabarito

3. Ferramenta de aquisição em ângulos retos agora permite aquisição de linhas

4. Ferramenta de aquisição de círculos agora permite aquisição de linhas

5. Nova interface para configuração dos Ajustes para a Ferramenta de (Re)Classificação

A Ferramenta de (Re)Classificação agora permite:

• escolha de cores para os botões;

• atribuição informações complementares (tooltips);

• escolher atributos a serem ignorados;
• escolher atributos como não editáveis; e
• atribuição de atalhos;

• escolher na configuração quais formulários de feições deverão ser abertos;

6. Melhorias na Caixa de Ferramentas de Validação:

• Botão de rodar novamente o último processo de validação executado;

• A caixa de ferramentas de validação agora mostra o tempo gasto na execução do processo de validação;
• Nova funcionalidade de limpar flags pelo tipo;

• Nova funcionalidade de limpar todas as flags;

• Nova funcionalidade de filtrar flags pelo tipo;

• Novo histórico de validação;

• Flags agora são carregadas após a execução de processos de validação;

7. Possibilidade de associar ferramentas do DSGTools com atalhos:

Pesquisa de qualidade do DSG Tools 3.1