Manual ANA Data Acquisition 1.0

Manual de
aplicação
ANA Data Acquisition V 1.0

Ago / 2022
Parceria:
MANUAL DE APLICAÇÃO ANA DATA ACQUISITION V 1.0
APRESENTAÇÃO
A ferramenta ANA Data Acquisition realiza o download automático dos dados

de várias estações pluviométricas e fluviométricas disponibilizados pela Agência
Nacional de Águas (ANA). Foi idealizada para auxiliar na aplicação do Modelo de
Grandes Bacias (MGB), atualmente disponível no software Quantum GIS (QGIS)
(PONTES, 2017), desenvolvido pelo grupo de pesquisa Hidrologia de Grande Escala
(HGE), do Instituto de Pesquisas Hidráulicas (IPH), da Universidade Federal do Rio
Grande do Sul (UFRGS). Devido aos diferentes usos que os dados hidrológicos
podem ter, a ferramenta está agora disponível em uma versão independente.
O plugin ANA Data Acquisition versão 1.0 (stable), também é um complemento
do QGIS (versão 3), que, além de contar com as funcionalidades originais, oferece a
opção de selecionar as estações de interesse na interface do QGIS, o nível de
consistência e observar qual a disponibilidade de dados. Este manual visa a
apresentação e aplicação do plugin.
A função de seleção das estações no mapa foi inspirada nas ferramentas de
download de dados ECO Pluvia Downloader (Fontoura et al., 2016) e ECO-
Downloader (Petry et al, 2017), desenvolvidas pelo Grupo de Pesquisa em
Modelagem Hidroambiental e Ecotecnologias da Universidade Federal de Santa
Maria e coordenadas pelos professores Daniel Gustavo Allasia e Rutineia Tassi.
Ambas ferramentas são disponibilizadas em versões experimentais no QGIS (versão
2).
Autores: Ingrid Petry, Pedro Jardim, Fernando Mainardi Fan.

Contato: ingrid.petry@ufrgs.br
Código: https://github.com/HGE-IPH/ANA-Data-Acquisition
https://www.ufrgs.br/hge/ana-data-acquisition/
Como citar: Petry, I et al. 2021. Manual de Aplicação plugin ANA Data Acquisition V
1.0. Manual Técnico, HGE, IPH, UFRGS.
Atualização do repositório de estações: setembro de 2021.
1
1. INSTALAÇÃO
A instalação do plugin é feita através da aba “Complementos” >

”Gerenciar e Instalar Complementos” do QGIS, podendo ocorrer de duas
formas:
1) através do repositório do QGIS, como mostra a Figura 1; ou
2) adicionando o arquivo em formato zip disponibilizado no site do
HGE <https://www.ufrgs.br/hge/ana-data-acquisition/>, como
indica a Figura 2.
Figura 1 – Visualização do plugin no repositório do QGIS
Figura 2 – Instalação do plugin utilizando o arquivo .zip
2
Ao final da instalação o ícone da ferramenta deverá aparecer no menu

“Complementos” e na barra de ferramentas do QGIS, como mostra a Figura 3.
Figura 3 – Visualização do plugin após instalação
3
2. AQUISIÇÃO DOS DADOS HIDROLÓGICOS
Antes de passarmos para a aplicação da ferramenta, é de extrema

importância que você confira se o seu computador está configurado para que
o símbolo de separador decimal seja ponto (.) e o agrupamento de dígitos seja
vírgula (,). Isso pode ser conferido através do seguinte caminho:
Menu Iniciar → Painel de Controle → Relógio e Região → Alterar formatos
de data, hora ou número → Configurações adicionais
A Figura 4 apresenta a janela onde é feita esta configuração. Ainda, em
“Região”, é importante que o formato esteja no padrão Português (Brasil), com
o sistema de datas como mostra a Figura 5.
Figura 4 – Janela onde é necessário especificar o símbolo decimal como ponto

e o de agrupamento de dígitos como vírgula.
4
Figura 5 – Janela onde é necessário especificar o formato das datas no padrão

brasileiro.
A Figura 6 apresenta a interface principal do complemento. As

funcionalidades contidas na Figura 6, (a) são de preenchimento opcional, e
referem-se ao processo de escolha das estações de interesse na interface do
QGIS, detalhado na seção 2.1 desse manual.
O item da Figura 6, (b) abre a interface onde são definidos o intervalo de
tempo, o tipo de dado e as estações. Esse item é de preenchimento
obrigatório e será detalhado na seção 2.2.
O item da Figura 6., (c) gera um relatório de disponibilidade de dados,
também opcional, e será apresentado na seção 2.3.
5
Figura 6 – Interface principal do plugin, (a) ferramenta de seleção das estações

no mapa e (b) download dos dados
a)
b)
c)
2.1 Seleção das estações de interesse na interface do QGIS
Para seleção das estações de interesse no mapa, em “Data type”

comece escolhendo o tipo de dado que deseja obter: chuva (precipitation),
vazão (discharge) ou nível (level). Se a opção escolhida for “Precipitation”, será
adicionada à interface do QGIS o shapefile correspondente à rede
pluviométrica de monitoramento, apresentado na Figura 7. Se a escolha for
“Discharge” ou “Level”, será adicionado o shapefile correspondente à rede
fluviométrica de monitoramento, (Figura 8).
O programa realiza o download de, no máximo, 300 estações por vez,
dessa forma cada seleção não pode exceder esse valor. Selecione então as
6
estações de interesse através das ferramentas de seleção do QGIS. A Figura 7

apresenta a seleção de estações através da tabela de atributos do shapefile
das estações. A Figura 8 apresenta opções de seleção de estações no mapa.
A Figura 9 apresenta a opção de seleção das estações através de outro
shapefile que representa a área de estudo, por exemplo, uma bacia
hidrográfica.
Figura 7 – Exemplo de seleção das estações na tabela de atributos do shapefile

da rede fluviométrica
7
Figura 8 – Exemplo de seleção de estações no mapa do shapefile da rede

pluviométrica
Figura 9 – Exemplo de seleção das estações através de shapefile da área de

interesse
8
Uma vez selecionadas as estações, clique em “Create gauge file” e

escolha onde o arquivo será salvo. O programa irá criar um arquivo em
formato txt que contém o código dessas estações. Dependendo da
informação selecionada o arquivo terá como nome “gauges_precipitation.txt”,
“gauges_discharge.txt” ou “gauges_level.txt”. Esse arquivo será utilizado na
próxima etapa.
Note que a tabela de atributos dos arquivos shapefile contém diversas
informações em relação às estações disponíveis.
2.2 Download dos dados
Para fazer o download dos dados hidrológicos, clique na opção

“Downloader” indicado na Figura 6 (b). Na nova interface aberta (Figura 10),
indique o tipo de dado e o intervalo de tempo desejado.
Uma vez aberta a janela do baixador de dados, a primeira coisa que você
deve fazer é indicar qual tipo de informações você deseja baixar na parte
superior da janela, podendo optar por “precipitation”, “discharge” ou “level”.
Se você optou por escolher as estações de interesse no mapa, insira o arquivo
txt das estações em “Input files” > “Gauges”. Se não, informe as coordenadas
da área de interesse e clique em “Acquire gauges”. As estações e suas
respectivas coordenadas vão aparecer na janela à direita. Caso contrário,
verifique se o arquivo das estações corresponde ao tipo de dado selecionado.
Agora é só escolher a pasta onde deseja armazenar os dados em “Destination
folder” e clicar em “Download Data”.
No canto inferior esquerdo em “Status” é possível acompanhar o
andamento do download, ou acompanhe os dados sendo baixados na pasta
escolhida. Quando o download estiver completo o programa emitirá um aviso.
Os dados baixados estão no formato txt, sendo a primeira coluna o dia,
a segunda o mês, a terceira o ano e a quarta o valor. A precipitação é dada em
milímetros por dia, a vazão em metros cúbicos por segundo e o nível em
centímetros. As falhas são representadas por “-1” nos dados de chuva e vazão,
e -9999 nos dados de nível.
Na mesma pasta de download das estações, o plugin irá salvar o arquivo
“Consistency.txt”, contendo o nível de consistência dos dados por dia, onde 1
representa dados brutos, e 2 dados consistidos. A Figura 11 apresenta esse
relatório.
9
Figura 10 – Interface com as especificações de download dos dados
Figura 10 – Relatório de nível de consistência dos dados
10
2.3 Relatório de disponibilidade de dados
O plugin ANA Data Acquisition, versão 1.0, possui a função de gerar um

relatório de disponibilidade de dados. Esse relatório fornece qual a
porcentagem de dias com dados para cada mês de download dos dados.
Para gerar o relatório, basta clicar em “Select files” e, com uma única
seleção, escolher os arquivo das estações que foram baixadas para o mesmo
período. Após clicar em “Create data availability report”, automaticamente o
plugin irá criar o arquivo “Data_availability_REPORT.csv” no diretório das
estações. Este arquivo pode ser manipulado em uma planilha eletrônica a fim
de melhorar a vizualização dos resultados, como mostra a Figura 12.
Figura 12. Exemplo de relatório de disponibilidade de dados vizualizado em

planilha eletrônica com formatação condicional da cor das células
11
REFERÊNCIAS
FONTOURA, J. R.; ALLASIA, D. G. P.; TASSI, R.; GELLER, V. G.; FAVARETTO J.

R.; FROEMMING, G. H. Geoferramenta para Aquisição Automática de Dados
Pluviométricos a partir do QGIS. Anais 6º Simpósio de Geotecnologias no
Pantanal, Cuiabá, MT, p. 493-500, 2016.
PETRY, I.; ALLASIA, D. G. P.; FONTOURA, J. R; PACHALY, R. L. Geoferramenta

para aquisição de dados hidrometeorológicos. Congreso Aguas, Ambiente y
Energia, Mendoza, Argentina, 2017.
PONTES, P.; FAN, F. M.; FLEISCHMANN, AYAN SANTOS; PAIVA, R.;

BUARQUE, D. C.; SIQUEIRA, V. A.; JARDIM, P.; SORRIBAS, M.; COLLISCHONN,
WALTER. MGB model for hydrological and hydraulic simulation of large
floodplain river systems coupled with open source GIS. Environmental
Modelling & Software, v. 94, p. 1-20, 2017.
12

Manual ANA Data Acquisition 1.0

Enviado por

Dados do documento

Descrição original:

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual ANA Data Acquisition 1.0

Enviado por

Direitos autorais:

Formatos disponíveis

Manual de

ANA Data Acquisition V 1.0

A ferramenta ANA Data Acquisition realiza o download automático dos dados

Autores: Ingrid Petry, Pedro Jardim, Fernando Mainardi Fan.

Atualização do repositório de estações: setembro de 2021.

A instalação do plugin é feita através da aba “Complementos” >

Figura 1 – Visualização do plugin no repositório do QGIS

Figura 2 – Instalação do plugin utilizando o arquivo .zip

Ao final da instalação o ícone da ferramenta deverá aparecer no menu

Figura 3 – Visualização do plugin após instalação

2. AQUISIÇÃO DOS DADOS HIDROLÓGICOS

Antes de passarmos para a aplicação da ferramenta, é de extrema

Figura 4 – Janela onde é necessário especificar o símbolo decimal como ponto

Figura 5 – Janela onde é necessário especificar o formato das datas no padrão

A Figura 6 apresenta a interface principal do complemento. As

Figura 6 – Interface principal do plugin, (a) ferramenta de seleção das estações

2.1 Seleção das estações de interesse na interface do QGIS

Para seleção das estações de interesse no mapa, em “Data type”

estações de interesse através das ferramentas de seleção do QGIS. A Figura 7

Figura 7 – Exemplo de seleção das estações na tabela de atributos do shapefile

Figura 8 – Exemplo de seleção de estações no mapa do shapefile da rede

Figura 9 – Exemplo de seleção das estações através de shapefile da área de

Uma vez selecionadas as estações, clique em “Create gauge file” e

2.2 Download dos dados

Para fazer o download dos dados hidrológicos, clique na opção

Figura 10 – Interface com as especificações de download dos dados

Figura 10 – Relatório de nível de consistência dos dados

2.3 Relatório de disponibilidade de dados

O plugin ANA Data Acquisition, versão 1.0, possui a função de gerar um

Figura 12. Exemplo de relatório de disponibilidade de dados vizualizado em

FONTOURA, J. R.; ALLASIA, D. G. P.; TASSI, R.; GELLER, V. G.; FAVARETTO J.

PETRY, I.; ALLASIA, D. G. P.; FONTOURA, J. R; PACHALY, R. L. Geoferramenta

PONTES, P.; FAN, F. M.; FLEISCHMANN, AYAN SANTOS; PAIVA, R.;

Você também pode gostar