README(PTBR).md

Extrator de dados de precipitação

Esse é um protótipo que desenvolvi durante meu projeto de de iniciação científico. Seu propósito é dispor as estações de dados de diversas agências climáticas (tais como ANA, SUDENE etc) em uma imagem GeoTIFF usando a biblioteca RasterIO e, após isso, extrair os seus dados de precipitação para um arquivo .csv usando suas cordenadas geográficas.

Progresso atual

1. Adquirir imagens GeoTIFF. [:white_check_mark:]
2. Implementar a obtenção dos dados de múltiplas estações em uma única execução (esse é o padrão da biblioteca hydrobr). [:white_check_mark:]
3. Criar um diagrama Gantt para mostrar a disponibilidade de dados de cada estação selecionada. [:white_check_mark:]
4. Mostrar as estações selecionadas junto com o mapa Raster. [:white_check_mark:]
5. Iterar o passo anteior para cada imagem GeoTIFF disponível. [ ]
6. Exportar os dados de precipitação de cada estação selecionada para uma planilha .csv. [ ]

Instalação

É esperado que seja usado o Google Colab para executar o script, já que

a) uma instalação local requer um outro gerenciador de pacotes além do pip;

b) parte do código foi construída para acessar o Google Drive em busca dos arquivos necessários (mas é possível alterá-las para buscar esses arquivos na máquina local)

No entanto, é possível rodar o script localmente ao instalar as bibliotecas via pip com os seguintes comandos:

pip install hydrobr
pip install rasterio
pip install pandas
pip install matplotlib.pyplot

Porém, há uma outra biblioteca chamada ( geopandas ) que é instalada mais facilmente usando o gerenciador de pacotes Conda. É possível instalá-la via pip, mas será necessário instalar sua dependências manualmente (há um tutorial para isso no próprio site).

Usando o Conda, execute os seguintes comandos:

conda update --all
conda install geopandas

Uso

Inicialmente, você precisa de uma imagem GeoTIFF para que seja feita a extração dos dados. Esse tipo de imagem pode ser obtida pelo ClimateSERV.

Imagem de precipitação GeoTIFF obtida no ClimateSERV, do banco de dados UCSB CHIRPS.

Coloque todas as imagens na mesma pasta.

Parâmetros

municipios_lista = Escolha os municípios que deseja analisar, escrevendo seus nomes dentro de aspas e os separando com vírgulas. Também é possível deixar a lista vazia para selecionar todos os municípios do estado abaixo.

estado = Escolha o o estado que contém os municípios escolhidos acima. O script suporta apenas um estado por vez.

raster = Insira o caminho do diretório de suas imagens GeoTiff. No momento, apenas uma imagem é suportada por vez, então insira o nome da imagem também.

dados = O segundo argumento deve ser 0 ou 1. Selecione 0 para exibir o nome das estações no diagrama Gantt ou 1 para exibir os seus códigos.

Resultados atuais

No momento, é possível obter uma imagem raster que exibe as estações de coleta de cada um dos municípios selecionados sobre a imagem GeoTIFF.

Todas as estações da Bahia. A imagem GeoTIFF usada é a mesma presente na sessão "Uso".

Disponibilidade de dados de cada estação de coleta de "Mucuri" (exibindo seus códigos).

Disponibilidade de dados de cada estação de coleta de "Mucuri" (exibindo seus nomes).