fileType: Download space and time-oriented oceanographic data

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

Description

To get space and time-oriented oceanographic data in several common file formats from BloomWatch server.

Usage

fileType(lons, lats, dates, dataset, timeperiod, filetype)

Arguments

lons	the minimum and maximum desired longitude values, in the range -180W to 180E, or 0 to 360E, regardless of the range of the original data. For example, c(-118, -105.5) is the same that c(242, 254.5).
lats	the minimum and maximum desired latitude values, in the range -90S to 90N. Values are in decimal degrees north. 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.
filetype	the type of data file that you want to download. For example, you can use one of the following: ".asc", "ESRI.asc", "GoogleEarth", ".grd", ".hdf", ".mat", ".nc", ".ncHeader", "small.png", "medium.png", "large.png", "transparent.png", ".tif", ".xyz", and "FGDC".

Details

This function provides a set of tools to get oceanographic data in several format files. 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.

Author(s)

Raul O Martinez-Rincon and Héctor 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

Examples

## Get "large.png" files of monthly sea surface temperature 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)
range(getDates(dataset, timeperiod))
lons <- c(-118, -105.5)
lats <- c(22.2, 32.5)
dates <- c("2013-01-01", "2013-03-30")
filetype <- "large.png"

## download files with oceanographic data
fileType(lons, lats, dates, dataset, timeperiod, filetype)

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