Skip to contents

Atribui periodo hidrologico (chuvoso / seco) a cada amostra

Source: R/seasonal.R
assign_season.Rd

Adiciona a coluna season ao data frame, classificando cada amostra como "chuvoso" ou "seco" com base no mes de coleta e no calendario hidrologico regional brasileiro.

Usage

assign_season(
  df,
  region = NULL,
  date_col = "data",
  wet_months = NULL,
  labels = c("chuvoso", "seco")
)

Arguments

df

Data frame com ao menos a coluna date_col.

region

Character ou NULL (default); regiao climatica usada para definir o calendario chuvoso/seco. Uma de "sudeste", "bahia", "centro_oeste", "nordeste", "norte", "sul" ou "custom". Este argumento e opcional: muitas analises de qualidade da agua nao consideram sazonalidade regional. Se region = NULL:

  • se wet_months for fornecido, ele e usado diretamente (equivalente a region = "custom");

  • caso contrario, a coluna season e preenchida com NA e uma mensagem informativa e exibida (sem erro), de forma que o restante do fluxo de analise nao e bloqueado.

date_col

Character; nome da coluna de datas. Default "data".

wet_months

Integer vector; meses numericos do periodo chuvoso (1 = Jan ... 12 = Dez). Obrigatorio quando region = "custom". Tambem pode ser usado com region = NULL para definir um calendario personalizado sem escolher uma regiao predefinida.

labels

Character vector de comprimento 2 com os rotulos para os periodos chuvoso e seco, nesta ordem. Default c("chuvoso", "seco").

Value

O df de entrada com a coluna season adicionada (character, podendo ser NA quando nenhuma regiao/calendario for informado).

Details

Os calendarios regionais disponiveis (meses chuvosos) sao:

"sudeste"

Outubro-Marco (Oct-Mar).

"bahia"

Outubro-Marco; adequado para BA litoral sul, regiao do Rio Buranhem, ES.

"centro_oeste"

Outubro-Marco.

"nordeste"

Fevereiro-Julho; semiarido/intertropical.

"norte"

Dezembro-Maio; Amazonia.

"sul"

Junho-Setembro; inverno umido subtropical.

"custom"

Define os meses chuvosos pelo argumento wet_months.

See also

compare_seasons()

Other seasonal-tools: compare_seasons()

Examples

data("wq_demo", package = "tikatuwq")
d <- assign_season(wq_demo, region = "bahia")
table(d$season)
#> 
#> chuvoso    seco 
#>       9      11 

# region e opcional: sem informa-la, season fica NA (sem erro)
d2 <- assign_season(wq_demo)
#> assign_season(): nenhuma 'region' ou 'wet_months' foi informada; a coluna 'season' foi preenchida com NA. Para classificar por periodo hidrologico, informe region (ex.: 'bahia') ou wet_months.
table(d2$season, useNA = "always")
#> 
#> <NA> 
#>   20