getGridData: Download space grid oceanographic data

In r-forge/satin: Functions for downloading, reading and displaying satellite data for oceanographic applications with R

Description

To download space and time-oriented oceanographic data from the BloomWatch server.

Usage

getGridData(lons, lats, dates, dataset, timeperiod, keep.nc = FALSE)

Arguments

lons	a vector with western- and eastern-most longitudes, in the range -180W to 180E, or 0 to 360E. Values are in decimal degrees. For example, c(-118, -105.5) or c(242, 254.5)
lats	a vector with southern- and northern-most latitudes. Values are in decimal degrees. For example, c(22.2, 32.5)
dates	the minimum and maximum dates in ISO 8601 format: YYYY-MM-DD. For example, c("2013-01-01", "2013-06-30")
dataset	the data set of the oceanographic data. Use dataSetQuery to get this 7 carchacter "BloomWatch" data set name. For example, "TBAssta" which corresponds to "global" sea surface temperature, with a spatial resolution of 0.1degrees
timeperiod	is the name of a time period. For data files which represent composites of several day's worth of data, the timeperiod indicates the length of the composite. For example, for a 3day time period, if the centered time is 2006-08-04 12:00:00, the data is a composite (the mean) of all satellite passes from 2006-08-03 00:00:00 until 2006-08-06 00:00:00
keep.nc	logical indicating if .nc files are stored in your current working directory

Details

This function provides a set of tools to get oceanographic data from the BloomWatch server (http://coastwatch.pfel.noaa.gov/coastwatch/CWBrowserWW360Info.html). However we strogly recomend to use dataSetQuery, timePeriod, and getDates functions in order to make your query more adequately, due to large database differing in spatial and temporal coverage. The user must specify the minimum and maximum latitude and longitude limits within the interval (-90, 90) and (-180, 180) respectively.

Value

getGridData returns an object of class “satin” (a list) with components:

longitude	a vector of longitudes values of selected area.
latitude	a vector of latitudes values of selected area.
rs.data	an array of three dimensions with downloaded remote sensed data (e.g. sea surface temperature). Dimensios represents: 1 = latitudes; 2 = longitudes; and 3 = time
rs.name	a character indicating the name of remote sensed variable or its abreviation
rs.units	a character indicating the units of the remote sensed variable
period	a character vector indicating downloaded time period
itype	a character indicating where oceanographic data were obtained from. For example, "bloomWatch" indicating data were obtained from BloomWatch server

Author(s)

Raul O Martinez-Rincon and Hector Villalobos

References

http://coastwatch.pfel.noaa.gov/coastwatch/CWBrowserWW360.jsp?get=griddata http://coastwatch.pfel.noaa.gov/coastwatch/CWBrowserWW360Info.html

See Also

dataSetQuery, timePeriod, getDates, plotSatin, fileType

Examples

## Get monthly sea surface temperature data with a spatial resolution 
## of 0.1degrees of the northwest of Mexico from january to march 2013.

## Query and settings
dataSetQuery(parameter = "temperature", resolution = "0.1degrees")
dataset <- "TBAssta" # or 
dataset <- dataSetQuery(dataset = 40)
timePeriod(dataset)
timeperiod <- "1month"
getDates(dataset, timeperiod) # or
range(getDates(dataset, timeperiod))#if you want to see the date's range
lons <- c(-118, -105.5)
lats <- c(22.2, 32.5)
dates <- c("2013-01-01", "2013-03-30")

## download data
my.sst.data <- getGridData(lons, lats, dates, dataset, timeperiod, keep.nc = FALSE)

## plotting the first downloaded data (i.e. january)
plotSatin(my.sst.data)

## plotting the second downloaded data (i.e. february)
plotSatin(my.sst.data, image = 2)
 

r-forge/satin documentation built on Feb. 18, 2022, 2:39 a.m.