extraiserie: Extracao do regioes do dado completo

In lkhenayfis/oceantemps: Interacao com dados de temperatura na superficie dos oceanos

Extracao do regioes do dado completo

Description

Permite extrair de dado de temperaturas da superficie uma determinada regiao numa janela de tempo

Usage

extraiserie(dado, lon, lat, data, FUN = mean, plot = TRUE, ...)

Arguments

dado	o dado do qual extrair serie. Deve ter formato igual ao retornado por leFROMdir ou leFROMurl
lon	longitude da regiao desejada. Ver Detalhes
lat	latitude da regiao desejada. Ver Detalhes
data	data das observacoes desejadas no formato AAAAMM. Ver Detalhes
FUN	funcao utilizada para agregacao de observacoes por data no caso de lon ou lat serem vetores. Por padrao se usa a media
plot	booleano indicando se deve ser plotado um mapa apontando a regiao extraida.
...	parametros extras passados a FUN. Nao deve ser passado na.rm por aqui, pois e incorporado automaticamente

Details

Os parametros lon e latpodem ser fornecidos como um escalar ou vetor. No primeiro caso sera feito matching exato do valor fornecido; no segundo, quando sao informados vetores, sera buscado no dado registros entre o primeiro e ultimo valores do vetor, inclusive.

Ainda com relacao aos vetores de coordenadas, e tambem possivel fornecer lon em duas referencias distintas: na escala de 0 a 360 graus ou -180 a 180. O segundo caso e mais conveniente quando se estao extraindo series no atlantico, cujas coordenadas no sistema 0, 360 acabam sendo quebradas nas duas pontas do mapa. Caso algum valor de lon seja negativo, o codigo automaticamente entedera a mudanca de paradigma. Nao sao suportados ainda valores de lon 'circulares", isto e, que implicariam o contorno ao redor do globo (ex. lon = c(350, 370) – para isso, use lon = c(-10, 10)). Ver Exemplos

No caso das datas, algo similar pode ser feito fornecendo uma string no formato "AAAAMM:AAAAMM", indicando a janela de tempo desejada. Nao e permitida a extracao de datas nao sequenciais, dado que assim ja nao configura mais uma serie temporal.

Value

objeto ts contendo serie temporal da regiao especificada na janela especificada

Examples

# usando datexemplo

# Extracao da coordenada lon = 38, lat = -44 ao longo de todo 2020
extraiserie(datexemplo, lon = 38, lat = -44)

# Extracao da faixa lon = [38, 40], lat = [-44, -40] ao longo de 2020, combinando por media (padrao)
extraiserie(datexemplo, c(38, 40), c(-44, -40))

# Mesma regiao mas apenas na janela 202001:202006
extraiserie(datexemplo, c(38, 40), c(-44, -40), "202001:202006")

# Extraindo series no atlantico, usando escala [-180, 180]
extraiserie(datexemplo, c(-15, -10), c(-10, 0))

# Equivalente ao anterior na referencia [0, 360]
extraiserie(datexemplo, c(345, 350), c(-10, 0))

lkhenayfis/oceantemps documentation built on July 8, 2022, 1:59 a.m.