Pacote Mananciais

O objetivo deste pacote é disponibilizar a base de dados sobre o volume operacional em mananciais de abastecimento público na Região Metropolitana de São Paulo (SP - Brasil). O pacote é atualizado diariamente através de um workflow com GitHub Actions.

Os dados foram obtidos no Portal dos Mananciais da SABESP.

Este pacote foi derivado de um código web scraping desenvolvido pela equipe da Curso-R, em uma live, e o código original está disponível neste link.

Este pacote foi criado no âmbito da pesquisa de doutorado de Beatriz Milz.

Caso você não utilize R, é possível fazer download da base de dados através dos seguintes links:

Os arquivos foram salvos com encoding UTF-8, e separados por ponto-e-vírgula.

Instalação

Este pacote pode ser instalado através do GitHub utilizando o seguinte código em R:

# install.packages("devtools")
devtools::install_github("beatrizmilz/mananciais")
library(mananciais)

Como usar?

Caso você tenha conexão à internet, é possível buscar a base atualizada usando a função dados_mananciais():

mananciais <- mananciais::dados_mananciais()

Caso você não tenha conexão à internet, você pode utilizar a base disponível no pacote. Porém as mesmas estarão atualizadas até a data em que você instalou (ou atualizou) o pacote.

Abaixo segue um exemplo da base disponível:

dplyr::glimpse(mananciais)
#> Rows: 55,568
#> Columns: 8
#> $ data                <date> 2024-04-25, 2024-04-25, 2024-04-25, 2024-04-25, 2…
#> $ sistema             <chr> "Cantareira", "Alto Tietê", "Guarapiranga", "Cotia…
#> $ volume_porcentagem  <dbl> 75.5, 75.4, 84.3, 85.3, 95.5, 37.8, 98.6, 75.7, 75…
#> $ volume_variacao     <dbl> -0.2, -0.2, -0.3, -0.2, -0.3, 0.1, -0.3, -0.1, -0.…
#> $ volume_operacional  <dbl> 741.57122, 422.63551, 144.24321, 14.06639, 107.103…
#> $ pluviometria_dia    <dbl> 0.0, 0.1, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.1, 0.0, …
#> $ pluviometria_mensal <dbl> 4.6, 29.3, 18.6, 49.4, 57.6, 34.8, 118.0, 4.6, 29.…
#> $ pluviometria_hist   <dbl> 80.7, 88.3, 72.1, 78.0, 102.6, 193.1, 110.0, 80.7,…

Caso queira saber o significado de cada variável, leia a documentação da base de dados ou utilize a seguinte função:

?mananciais::mananciais

Exemplo de tabela 

library(magrittr)
mananciais %>% 
  dplyr::arrange(desc(data)) %>% 
  head(7) %>%
  knitr::kable()
data sistema volume_porcentagem volume_variacao volume_operacional pluviometria_dia pluviometria_mensal pluviometria_hist
2024-04-25 Cantareira 75.5 -0.2 741.57122 0.0 4.6 80.7
2024-04-25 Alto Tietê 75.4 -0.2 422.63551 0.1 29.3 88.3
2024-04-25 Guarapiranga 84.3 -0.3 144.24321 0.0 18.6 72.1
2024-04-25 Cotia 85.3 -0.2 14.06639 0.0 49.4 78.0
2024-04-25 Rio Grande 95.5 -0.3 107.10315 0.0 57.6 102.6
2024-04-25 Rio Claro 37.8 0.1 5.16043 1.0 34.8 193.1
2024-04-25 São Lourenço 98.6 -0.3 87.57816 0.0 118.0 110.0

Como citar o pacote

DOI