read.cmems {satin} | R Documentation |
Read ocean products data from CMEMS
Description
Read data from netCDF files downloaded from Copernicus Marine Service (CMEMS).
Usage
read.cmems(nc)
Arguments
nc |
name of the netCDF file to be read. |
Details
The function can read data from netCDF files downloaded from CMEMS web page (https://marine.copernicus.eu/). It has been tested with Global Ocean Physical Reanalysis, and Global Ocean Biogeochemistry Hindcast databases. When downloading Copernicus data files, the user can select one or several variables (see references below), depth levels, daily or monthly means, time and spatial coverage. This makes every Copernicus netCDF file unique. The read.cmems
function attempts to read all the variables and depth levels at once. When only one variable is included in the file, a "satin"
object with one additional dimension in the data array to accommodate the different depth levels, is produced. On the other hand, when several variables are present, the function returns a named list, with every element being a "satin"
object corresponding to each variable.
Value
A named list, with elements corresponding to each variable included in the netCDF file. Each list element (or when only one variable is present) is an object of class "satin"
. See satin-class
for details.
Author(s)
Héctor Villalobos
References
https://resources.marine.copernicus.eu/?option=com_csw&task=results
Fernandez, E. and Lellouche, J. M. 2018 Product User Manual for the Global Ocean Physical Reanalysis product, issue 1.1. EU Copernicus Marine Service.
Garric, G. and Parent, L. 2018 Product User Manual for the Global Ocean Reanalysis Products, issue 3.4. EU Copernicus Marine Service.
Perruche, C. 2019 Product User Manual for the Global Ocean Biogeochemistry Hindcast, issue 1.1. EU Copernicus Marine Service.
See Also
read.nasaoc
for reading NASA's oceancolor web page data, read.ghrsst
for JPL MUR SST data, and read.osunpp
for reading ocean productivity data.
Examples
if(interactive()){
# read Copernicus netcdf file with one variable
cmems <- read.cmems("global-reanalysis-phy-001-030-monthly_1553098099635.nc")
cmems
str(cmems)
# plotting the first period
plot(cmems)
# plotting the second period
plot(cmems, period = 2)
# read Copernicus netCDF file with several variables and depth levels
cmems2 <- read.cmems("global-reanalysis-phy-001-030-monthly_1553051256930.nc")
cmems2 # it is a list
# readed variables
names(cmems2)
# example plots for potential temperature
thetao <- cmems2$thetao
thetao
thetao$depth # depth levels
plot(thetao) # potential temperature at first depth level (0.49 m) and first month
plot(thetao, period = 2, depth = 5) # for fifth depth level (5.078 m), second month
}