Skip to contents

Data sources providing oceanographic data.

Usage

sources_oceanographic(name, formats, time_resolutions, ...)

Arguments

name

character vector: only return data sources with name or id matching these values

formats

character: for some sources, the format can be specified. See the list of sources above for details

time_resolutions

character: for some sources, the time resolution can be specified. See the list of sources above for details

...

: additional source-specific parameters. See the list of sources above for details

Value

a tibble with columns as specified by bb_source

Details

  • "CSIRO Atlas of Regional Seas 2009": CARS is a digital climatology, or atlas of seasonal ocean water properties

  • "World Ocean Atlas 2009": World Ocean Atlas 2009 is included here for convenience but has been superseded by the World Ocean Atlas 2013 V2

  • "World Ocean Atlas 2013 V2": World Ocean Atlas 2013 version 2 (WOA13 V2) is a set of objectively analyzed (1 degree grid) climatological fields of in situ temperature, salinity, dissolved oxygen, Apparent Oxygen Utilization (AOU), percent oxygen saturation, phosphate, silicate, and nitrate at standard depth levels for annual, seasonal, and monthly compositing periods for the World Ocean. It also includes associated statistical fields of observed oceanographic profile data interpolated to standard depth levels on 5 degree, 1 degree, and 0.25 degree grids

  • "World Ocean Atlas 2018": The World Ocean Atlas (WOA) is a collection of objectively analyzed, quality controlled temperature, salinity, oxygen, phosphate, silicate, and nitrate means based on profile data from the World Ocean Database (WOD). It can be used to create boundary and/or initial conditions for a variety of ocean models, verify numerical simulations of the ocean, and corroborate satellite data

  • "Argo ocean basin data (USGODAE)": Argo float data from the Global Data Access Centre in Monterey, USA (US Global Ocean Data Assimilation Experiment). These are multi-profile netcdf files divided by ocean basin. Accepts region parameter values of "pacific" (default), "atlantic", and/or "indian". Also accepts years parameter: an optional vector of years to download data for

  • "Argo profile data": Argo profile data, by default from the Global Data Access Centre in Monterey, USA (US Global Ocean Data Assimilation Experiment). The DAC can be changed by specifying a dac_url parameter (see example below). Also see bb_handler_argo for a description of the other parameters that this source accepts.

  • "Roemmich-Gilson Argo Climatology": A basic description of the modern upper ocean based entirely on Argo data is available here, to provide a baseline for comparison with past datasets and with ongoing Argo data, to test the adequacy of Argo sampling of large-scale variability, and to examine the consistency of the Argo dataset with related ocean observations from other programs

  • "Effects of Sound on the Marine Environment": ESME uses publically available environmental data sources that provide detailed information about the ocean: (1) Bottom Sediment Type (BST) v 2.0, (2) Digital Bathymetry Database (DBDB) v 5.4, (3) Generalized Digital Environment Model (GDEM) v 3.0, (4) Surface Marine Gridded Climatology (SMGC) v 2.0"

The returned tibble contains more information about each source.

References

See the doc_url and citation field in each row of the returned tibble for references associated with these particular data sources

Examples

if (FALSE) {
## define a configuration and add the Atlas of Regional Seas data to it
cf <- bb_config("/my/file/root")
src <- sources_oceanographic("CSIRO Atlas of Regional Seas 2009")
cf <- bb_add(cf,src)

## Argo data, Pacific ocean basin only, all years
src <- sources_oceanographic("Argo ocean basin data (USGODAE)", region="pacific")

## Argo data, Pacific ocean basin for 2018 only
src <- sources_oceanographic("Argo ocean basin data (USGODAE)",
  region="pacific", years=2018)

## Argo data, all ocean basins and for 2017 and 2018 only
src <- sources_oceanographic("Argo ocean basin data (USGODAE)",
  region=c("pacific", "indian", "atlantic"), years=c(2017, 2018))

## Argo merge profile data, from the French GDAC (ftp://ftp.ifremer.fr/ifremer/argo/)
## Only download profiles from institutions "CS" or "IN", south of 30S,
##  with parameter "NITRATE" or "CHLA"
src <- sources_oceanographic("Argo profile data", profile_type = "merge",
                             dac_url = "ftp://ftp.ifremer.fr/ifremer/argo/",
                             institutions = c("CS", "IN"),
                             latitude_filter = function(z) z < -30,
                             parameters = c("CHLA", "NITRATE"))
}