metaclipcc.Map: Directed metadata graph construction for AR6 Atlas Map...

Description Usage Arguments Details Author(s)

View source: R/metaclipcc.Map.R

Description

Build a directed metadata graph describing a Map product of the AR6 Interactive Atlas

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
metaclipcc.Map(
  project = "CMIP5",
  variable = NULL,
  climate.index = NULL,
  delta = FALSE,
  experiment,
  baseline,
  future.period = NULL,
  season,
  bias.adj.method = NULL,
  ref.obs.dataset = NULL,
  proj,
  map.bbox = NULL,
  uncertainty = NULL,
  test.mode = FALSE
)

Arguments

project

Project. Unused so far. Default to "CMIP5".

variable

Code of the input ECV (it can be omitted if climate.index is indicated). Current accepted values are restricted to "tas", "meanpr", "TX", "TN", "prsn", "wind" and "siconc", "ph", "tos" for oceanic variables (CMIP6 only).

climate.index

If the map is for a climate index, name of the index. Otherwise NULL (the default). Currently accepted values are restricted to the set of indices to be included in the Atlas, namely: "TXx", "TNn", "Rx1day", "Rx5day", "spi6", "CDD", "tx35", "tx40", "cd", "hdd", "fd", as well as the bias adjusted versions of "tx35isimip", "tx40isimip", "fdisimip".

delta

Logical. Is it a delta map?. The type of delta displayed can be either "absolute" or "relative".

experiment

Experiment results displayed in the map. Accepted values are restricted to "historical", "rcp26", "rcp45", "rcp85", for CORDEX and CMIP5 products, and "historical", "ssp126", "ssp245", "ssp370", "ssp460" and "ssp585" for CMIP6 products.

baseline

Character string indicating the "start-end" years of the baseline (historical) period. Accepted values are: "1981-2010" and "1961-1990" (WMO standard periods), "1986-2005" (AR5 period), "1995-2014" (AR6 period) and "1850-1900" (Preindustrial). Internally, there is a tricky part here in some cases, see Details.

future.period

future period. Default to NULL, for historical maps (i.e., period defined by the baseline argument). Otherwise, a character string indicating either the "start-end" years of the future period or a (GCM-specific) warming level. Current options include the standard AR5 future time slices for near term, "2021-2040", medium term "2041-2060" and long term "2081-2100", and the global warming levels of +1.5 degC "1.5", +2 "2", +3 "3" and +4 "4".

season

season. Integer vector of correlative months, in ascending order, encompassing the target season.

bias.adj.method

Default to NULL and unused. If the map displays a bias-corrected product, a character string idetifying the method. Current accepted values a re "EQM", for the standard VALUE empirical quantile mapping method. NOTE: since metaclipcc v1.0.0 the parameter is automatically set to "ISIMIP3" when needed as a function of the index name.

ref.obs.dataset

Default to NULL, and unused unless a bias.adj.method has been specified. This is the reference observational dataset to perform the correction. This is an individual that must be defined in the datasource vocabulary, belonging to either classes ds:ObservationalDataset or ds:Reanalysis. Currently accepted values are "W5E5" and "EWEMBI". Note that the individual instances of the observational reference are assumed to be described in the datasource vocabulary. NOTE: since metaclipcc v0.3.0 the parameter is set to "W5E5" when needed as a function of the index name.

proj

Map projection string. Accepted values are "Robin", "Arctic", "Antarctic" and "Pacific" for Robinson and WGS84 Arctic/Antarctic Polar stereographic, and Robinson Pacific-centric projections respectively.

map.bbox

Optional. numeric vector of length 4, containing, in this order the c(xmin, ymin, xmax, ymax) coordinates of the target area zoomed in by the user. If missing, then the HorizontalExtent associated to the project is assumed.

uncertainty

Uncertainty layer characteristics. Describes different hatched patterns of the output graphical product, depending of the user's choice of visualization. Possible values are NULL (default), indicating no hatching at all, or "simple" or "advanced".

test.mode

For internal use only. When the test mode is on, only the first two models are used.

Details

Baseline period definition

Two of the baseline periods considered (WMO, 1981-2010 and AR6, 1995-2014) go beyond the temporal extent of the historical experiment simulations in AR5, ending in 2005. In this case, the strategy followed in the different IPCC reports is to fill the missing period between 2006 and the end of the baseline with the years of the future simulation used in each case. For example, to compute a RCP 8.5 delta using the WMO baseline, the baseline data for the period 2006-2010 will be extracted from the RCP85 simulation, and then concatenated with the 1981-2005 period of the historical simulation in order to complete the baseline period.

Author(s)

J. Bedia


metaclip/metaclipcc documentation built on Sept. 24, 2021, 6:42 a.m.