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