amber: plotBars – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

plotBars

Barplots of reference and model data with same unit

Description

This function produces barplots of annual mean values for a selection of variables and reference data. The user may choose to plot both, absolute and fractional values. A typical application is a barplot for variables related to the surface energy balance.

Usage

plotBars(mod.path.list, modelIDs, variableNames, referenceNames,
  showFractions = FALSE, targetVariable = "RNS",
  ofileName = "barplot.pdf", plot.width = 12, plot.height = 8,
  outputDir = FALSE, subcaption = FALSE)

Arguments

`mod.path.list`	A list with paths for each model run, e.g. mod.path.list <- list(mod01.path, mod02.path, mod03.path). The respective folders must each contain the file 'metricsTable' produced by the function scores.tables.
`modelIDs`	An R object with the different model run IDs, e.g. c('CLASSIC.CRUJRAv2', 'CLASSIC.GSWP3W5E5', 'CLASSIC.CRUNCEP')
`variableNames`	Names of variables that should be plotted, e.g. c('HFG', 'HFLS', 'HFSS', 'RNS')
`referenceNames`	Names of reference data that should be plotted, e.g. c('FLUXNET', 'CLASS')
`showFractions`	Logical. If set to TRUE, the Figure will show fractional values, such as the fractions of net surface radiation that are converted into heat fluxes.
`targetVariable`	A string that gives the variable for which fractions are computed, e.g. 'RNS' for net surface radiation. Only relevant if showFractions = TRUE.
`ofileName`	A string that gives the output file name, e.g. 'barplot.pdf'
`plot.width`	Number that gives the plot width, e.g. 12
`plot.height`	Number that gives the plot height, e.g. 8
`outputDir`	A string that gives the output directory, e.g. '/home/project/study'. The output will only be written if the user specifies an output directory.
`subcaption`	Logical. If TRUE then the subcaptions (a) and (b) are added.

Value

Barplots of annual mean values annual mean values for a selection of variables and reference data.

Examples

library(amber)
library(classInt)
library(doParallel)
library(foreach)
library(Hmisc)
library(latex2exp)
library(ncdf4)
library(parallel)
library(raster)
library(rgdal)
library(rgeos)
library(scico)
library(sp)
library(stats)
library(utils)
library(viridis)
library(xtable)

mod01.path <- system.file('extdata/SIMod01', package = 'amber')
mod02.path <- system.file('extdata/SIMod02', package = 'amber')

mod.path.list <- list(mod01.path, mod02.path)
modelIDs <- c('CLASSIC.CRUJRAv2', 'CLASSIC.GSWP3W5E5')
variableNames <- c('HFG', 'HFLS', 'HFSS', 'RNS')
referenceNames <- c('FLUXNET', 'CLASS')

plotBars(mod.path.list, modelIDs, variableNames, referenceNames,
showFractions = TRUE, targetVariable = 'RNS', ofileName = 'barplot.pdf',
plot.width = 5, plot.height = 5, outputDir = FALSE)

amber

Automated Model Benchmarking R Package

v1.0.3

GPL-3

Authors

Christian Seiler [cre, aut]

Initial release