monitoraR package:unknown R Documentation
FUNÇÃO PARA SIMULAÇÃO DAS CONDIÇÕES DE ONDA, ESTÁGIO PRAIAL E RISCO DE CORRENTE DE RETORNO
Description:
A função calcula a altura média de onda, período médio de onda, estágio praial e risco de corrente de retorno para uma praia no litoral brasileiro.
A partir dos argumentos de entrada, a função faz o download da saída do modelo Wave Watch III.
Utilizando altura de onda em água profunda e período de onda obtidos pela saída de modelo, são calculados os demais parâmetros bem como gerado gráfico da evolução dos valores do estágio de praia e risco de corrente de retorno a cada dia do intervalo amostrado.
Usage:
monitoraR (lat, long, dia.inicio, dia.final, destfile, graph = TRUE)
Arguments:
lat: número indicando o valor de latitude (em graus decimais) da praia de interesse. O mesmo deve variar de 3 a -34, que corresponde ao litoral brasileiro (class: numeric).
long: número menor que zero (lado oeste do globo) (class: numeric)
dia.inicio: data correspondente ao dia do início da simulação (recomendado usar data do dia presente) no formato YYYY-MM-DD (class: caracter)
dia.final: data correspondente ao dia do final da simulação que deve ser no máximo 6 dias depois da data de início (recomendado usar 6 dias depois da data do dia presente) no formato YYYY-MM-DD (class: caracter)
destfile: diretório e nome do arquivo (.csv) no qual será salvo a saída do modelo WaveWatch III. Exemplo: “~diretório-trabalho/nome-arquivo.csv” (dica: para escrever corretamente a pasta do diretório, escolher o mesmo e copiar como aparece no console)
graph: geração do gráfico das características da praia (estágio praial e risco de corrente de retorno) em cada dia do intervalo escolhido. Caso graph=TRUE será gerado o gráfico, do contrário não.
Details:
Para que a função seja executada de forma correta, é necessário escolher, digitando no console do R, em qual dos 17 brasileiros está localizado a praia e qual a característica do grão da praia escolhida conforme opções fornecidas (atentar para letras maiúsculas e minúsculas). Praias cuja principal forçante da dinâmica seja a maré (RTR>10) não são contempladas pela função proposta. O cálculo do fator de risco de corrente de retorno foi adaptado de Engels et al. (2002) levando em consideração amplitude de maré, altura de onda em água rasa e período de onda. Caso deseje que seja gerado o gráfico (graph=T), aparecerá no console a mensagem para clicar em algum local do gráfico para posicionar a legenda.
Value:
* Gráfico de linhas com os valores do estágio praial e risco de corrente de retorno em cada dia do intervalo escolhido para a praia de interesse.
* Lista:
Comp1: altura média de onda em água rasa por dia, no qual cada posição corresponde aos dias do intervalo (primeira posição ao primeiro dia, sucessivamente)
Comp2: período médio de onda por dia, no qual cada posição corresponde aos dias do intervalo (primeira posição ao primeiro dia, sucessivamente)
Comp3: valor do estágio praial calculado através das médias diárias de altura de onda em água rasa e período de onda, conforme equção descrita em Wright and Short (1984). Cada posição corresponde aos dias do intervalo (primeira posição ao primeiro dia, sucessivamente)
Comp4: nome correspondente a cada estágio praial calculado.
Comp5: fator de risco de ocorrência de corrente de retorno adaptado de Engels et al. (2002), baseado em altura de onda, amplitude de maré e período de onda.
Warning:
Se algum dos argumentos for inserido incorretamente, a função não é executada.
A função retorna valores estimados através de cálculos que contém aproximações e saídas do modelo WaveWatch III, logo, podem não corresponder às condições observadas in situ na praia.
Author(s):
Mariana Santos Lobato Martins
e-mail: mlobatomartins@gmail.com
References:
https://coastwatch.pfeg.noaa.gov/erddap/griddap/NWW3_Global_Best.html
CALLIARI, L.J., MUEHE, D., HOEFEL, F.G.& TOLDO JR., E. Morfodinâmica praial: uma breve revisão. Rev. Bras. Oceanogr., 51:63-78, 2003.
ENGLE, J., MacMAHAN, J., THIEKE, R.J., HANES, D.M., DEAN, R.G. Formulation of a Rip Current Predictive Index using Rescue Data. Proc. National Conf. on Beach Preservation Technology, 23-25, 2002.
Examples:
**Alterar sempre o destfile do exemplo** com o diretório de trabalho e nome do arquivo a ser salvo (.csv).
monitoraR (lat = -33.5, long = -53.3, dia.inicio = “2019-06-25”, dia.final = “2019-07-01”, destfile = “~diretorio-trabalho/nome-arquivo.csv”, graph = TRUE)
#obs! Praia do Chuí: inserir os seguintes parâmetros direto no console quando pedido - Estado = RS e característica do grão = AreiaF
monitoraR (-3.03, -39.88, dia.inicio = “2019-06-25”, dia.final = “2019-07-01”, destfile = “~diretorio-trabalho/nome-arquivo.csv”, graph = TRUE)
#obs! Praia da Almofala: inserir os seguintes parâmetros direto no console quando pedido - Estado = CE e característica do grão = AreiaM
monitorar(-23.99, -46.41, dia.inicio = “2019-06-29”, dia.final = “2019-07-04”, destfile = “~diretorio-trabalho/nome-arquivo.csv”, graph = TRUE
#obs! Praia Grande: inserir os seguintes parâmetros direto no console quando pedido - Estado = SP e característica do grão = AreiaM