bccm_bottom_oxygen: BCCM environmental variable data

View source: R/shortcuts-get-data-bccm.R

bccm_bottom_oxygenR Documentation

BCCM environmental variable data

Description

Loading and/or downloading British Columbia continental margin (BCCM) model data for the BC Pacific region to local drive.

To download all BCCM data, use the function 'bccm_all_variables()'. See help page for details ('?bccm_all_variables').

Usage

bccm_bottom_oxygen(update = FALSE, ask = interactive(), force = FALSE)

bccm_bottom_ph(update = FALSE, ask = interactive(), force = FALSE)

bccm_bottom_salinity(update = FALSE, ask = interactive(), force = FALSE)

bccm_bottom_temperature(update = FALSE, ask = interactive(), force = FALSE)

bccm_surface_oxygen(update = FALSE, ask = interactive(), force = FALSE)

bccm_surface_ph(update = FALSE, ask = interactive(), force = FALSE)

bccm_surface_salinity(update = FALSE, ask = interactive(), force = FALSE)

bccm_surface_temperature(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg0to40m_oxygen(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg0to40m_ph(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg0to40m_salinity(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg0to40m_temperature(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg40to100m_oxygen(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg40to100m_ph(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg40to100m_salinity(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg40to100m_temperature(
  update = FALSE,
  ask = interactive(),
  force = FALSE
)

bccm_avg100mtoBot_oxygen(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg100mtoBot_ph(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg100mtoBot_salinity(update = FALSE, ask = interactive(), force = FALSE)

bccm_avg100mtoBot_temperature(
  update = FALSE,
  ask = interactive(),
  force = FALSE
)

bccm_phytoplankton(update = FALSE, ask = interactive(), force = FALSE)

bccm_primaryproduction(update = FALSE, ask = interactive(), force = FALSE)

Arguments

update

Logical. Would you like to check for a newer version of the layer?

ask

Logical. Should the user be asked before downloading the data to local cache? Defaults to the value of interactive().

force

Logical. Should download of data be forced? Overrides 'ask' argument if TRUE.

Format

A simple features dataframe.

Details

The following functions serve to download specific individual ocean variables of the BCCM model data. Use ‘bccm_all_variables()' if you would like to download all variables - see help file '?bccm_all_variables' for details. If a variable has already been downloaded, the function will load data from 'pacea_cache()' folder into user’s local R environment.

The British Columbia continental margin (BCCM) model is an ocean circulation-biogeochemical model implementation of the regional ocean modelling system (ROMS). It has a horizontal resolution of 3km x 3km and a vertical discretization based on bathymetry of 42 depth levels increasing in resolution near the surface. These modelled output data were provided by Angelica Pena and the data is further detailed in Pena et al. (2019).

BCCM data were interpolated to a 2km x 2km inshore grid and a 6km x 6km offshore grid. Data provided are monthly means that span from 1993-2019. Each column represents a distinct 'year_month' combination (e.g. 2010_4).

Surface values represent values at the centre of the top BCCM grid cell. These top cells span depths that vary with the bathymetry, from 0.2 to 1.6 m.

bccm_*depth*_oxygen() Dissolved oxygen measured as mmol-oxygen m^-3
bccm_*depth*_salinity() Salinity in ppt
bccm_*depth*_temperature() Temperature in oC
bccm_*depth*_ph() pH
bccm_phytoplankton() Total phytoplankton biomass in mmol-nitrogen m^-2
bccm_primaryproduction() Total primary production in gC m^-2 d^-1

NOTE:
*depth* must be replaced by one of the following depth categories:

bottomsea bottom
0to40average between 0m and 40m depth
40to100average between 40m and 100m depth
100tobot : average between 100m depth and sea bottom
surfacesea surface

Value

'sf' data object requested.

Source

Peña, M.A., Fine, I. and Callendar, W. 2019. Interannual variability in primary production and shelf-offshore transport of nutrients along the northeast Pacific Ocean margin. Deep-Sea Research II, doi:10.1016/j.dsr2.2019.104637.

Examples

## Not run: 
my_data <- bccm_bottom_oxygen()

## End(Not run)

pbs-assess/PACea documentation built on April 17, 2025, 11:36 p.m.