| agedepth | R Documentation |
Plot the age-depth model of a core.
agedepth(
set = get("info"),
BCAD = set$BCAD,
depth.unit = set$depth.unit,
age.unit = "yr",
unit = depth.unit,
d.lab = c(),
age.lab = c(),
yr.lab = age.lab,
kcal = FALSE,
acc.lab = c(),
mem.lab = c(),
d.min = c(),
d.max = c(),
d.by = c(),
depths = set$depths,
depths.file = FALSE,
accordion = c(),
plotatthesedepths = c(),
age.min = c(),
yr.min = age.min,
age.max = c(),
yr.max = age.max,
hiatus.option = 1,
dark = 1,
darkest = 1,
prob = set$prob,
rounded = c(),
d.res = 500,
age.res = 500,
yr.res = age.res,
date.res = 100,
rotate.axes = FALSE,
rev.age = FALSE,
rev.yr = rev.age,
rev.d = FALSE,
use.raster = TRUE,
flip.age = FALSE,
flip.d = FALSE,
maxcalc = 500,
height = 1,
calheight = 1,
ex = 1,
mirror = TRUE,
up = TRUE,
cutoff = 0.1,
plot.range = TRUE,
range.col = grey(0.5),
range.lty = "12",
range.lwd = 1,
mn.col = "red",
mn.lty = "12",
mn.lwd = 1,
med.col = NA,
med.lty = "12",
med.lwd = 1,
C14.col = rgb(0, 0, 1, 0.35),
C14.border = rgb(0, 0, 1, 0.5),
cal.col = rgb(0, 0.5, 0.5, 0.35),
cal.border = rgb(0, 0.5, 0.5, 0.5),
dates.col = c(),
pb.background = 0.5,
pbmodelled.col = function(x) rgb(0, 0, 1, 0.5 * x),
pbmeasured.col = "blue",
pb.lim = c(),
supp.col = rgb(0.5, 0, 0.5, 0.5),
remove.tail = TRUE,
MCMC.resample = TRUE,
hiatus.col = grey(0.5),
hiatus.lty = "12",
from.col = "white",
to.col = "black",
rgb.scale = c(0, 0, 0),
rgb.res = 100,
slump.col = grey(0.8),
olderthan.size = 1,
olderthan.col = "black",
youngerthan.size = 1,
youngerthan.col = "black",
normalise.dists = TRUE,
same.heights = FALSE,
cc = set$cc,
title = set$core,
title.location = "topleft",
title.size = 1.5,
plot.labels = FALSE,
labels = c(),
label.age = 1,
label.size = 0.8,
label.col = "black",
label.offset = c(0, 0),
label.adj = c(0.5, 0),
label.rot = 0,
after = set$after,
bty = "l",
mar.left = c(),
mar.middle = c(),
mar.right = c(),
mar.main = c(),
righthand = 3,
mgp = c(1.7, 0.7, 0),
xaxs = "r",
yaxs = "i",
MCMC.col = grey(0.4),
post.col = rgb(0, 0, 0, 0.2),
post.border = rgb(0, 0, 0, 0.4),
acc.post.col = c(),
acc.post.border = c(),
mem.post.col = c(),
mem.post.border = c(),
hiatus.post.col = c(),
hiatus.post.border = c(),
phi.post.col = c(),
phi.post.border = c(),
s.post.col = c(),
s.post.border = c(),
prior.col = 3,
prior.lwd = 2,
prior.fontcol = 2,
prior.ticks = "n",
prior.fontsize = 0.9,
toppanel.fontsize = 0.9,
mainpanel.tickfontsize = 1,
mainpanel.labelfontsize = 1,
acc.xlim = c(),
acc.ylim = c(),
mem.xlim = c(),
mem.ylim = c(),
hiatus.xlim = c(),
hiatus.ylim = c(),
phi.xlim = c(),
phi.ylim = c(),
supp.xlim = c(),
supp.ylim = c(),
xaxt = "s",
yaxt = "s",
plot.pb = TRUE,
pb.lty = 1,
plot.pdf = FALSE,
quartz = FALSE,
cairo = FALSE,
dates.only = FALSE,
model.only = FALSE,
verbose = TRUE,
roundby = 2,
save.info = set$save.info,
write.summary = TRUE,
ssize = 4000,
use.cpp = TRUE,
version.legend = TRUE,
version.location = c(),
version.cex = 0.7,
version.col = grey(0.5)
)
set |
Detailed information of the current run, stored within this session's memory as variable |
BCAD |
The calendar scale of graphs and age output-files is in |
depth.unit |
Units of the depths. Defaults to the one provided in the Bacon() command, |
age.unit |
Units of the ages. Defaults to |
unit |
Deprecated and replaced by |
d.lab |
The labels for the depth axis. Default |
age.lab |
The labels for the calendar axis (default |
yr.lab |
Deprecated - use age.lab instead |
kcal |
Use kcal BP. Default is |
acc.lab |
The labels for the accumulation rate plot (top middle). Default |
mem.lab |
The labels for the memory plot (top right). Default |
d.min |
Minimum depth of age-depth model (use this to extrapolate to depths higher than the top dated depth). |
d.max |
Maximum depth of age-depth model (use this to extrapolate to depths below the bottom dated depth). |
d.by |
Depth intervals at which ages are calculated. Default 1. Alternative depth intervals can be provided using, e.g., d. |
depths |
By default, Bacon will calculate the ages for the depths |
depths.file |
By default, Bacon will calculate the ages for the depths |
accordion |
An experimental option to squeeze and stretch depths below a boundary. Needs 2 parameters: boundary depth and compression ratio, e.g., |
plotatthesedepths |
An option to plot ages at different depths (e.g., if a core has been compressed during a run). Use with extreme caution! |
age.min |
Minimum age of the age-depth plot. |
yr.min |
Deprecated - use age.min instead. |
age.max |
Maximum age of the age-depth plot. |
yr.max |
Deprecated - use age.min instead. |
hiatus.option |
How to calculate accumulation rates and ages for sections with hiatuses. Either extrapolate from surrounding sections (default, |
dark |
The value beyond which any higher values will be clipped. Set to 1 by default. This can be set to lower values if for example only a very small area in the plot obtains the darkest values - then lowering the 'dark' value will darker a larger area. |
darkest |
The darkest grey value is darkest=1 by default; lower values will result in lighter maximum colours; values >1 are not advised. |
prob |
Confidence interval to report (between 0 and 1, default 0.95 or 95%). |
rounded |
Rounding of years. Default is to round to single years (1 digit for plum models). |
d.res |
Resolution or amount of greyscale pixels to cover the depth scale of the age-model plot. Default |
age.res |
Resolution or amount of greyscale pixels to cover the age scale of the age-model plot. Default |
yr.res |
Deprecated - use age.res instead. |
date.res |
Date distributions are plotted using |
rotate.axes |
By default, the age-depth model is plotted with the depths on the horizontal axis and ages on the vertical axis. This can be changed with |
rev.age |
The direction of the age axis, which can be reversed using |
rev.yr |
Deprecated - use rev.age instead. |
rev.d |
The direction of the depth axis, which can be reversed using |
use.raster |
Raster output ( |
flip.age |
When using |
flip.d |
When using |
maxcalc |
Number of depths to calculate ages for. If this is more than |
height |
The maximum heights of the distributions of the dates on the plot. See also |
calheight |
Multiplier for the heights of the distributions of dates on the calendar scale. Defaults to |
ex |
As an alternative to 'height' and 'calheight', the distribution heights can be set as either a single value (e.g., |
mirror |
Plot the dates as 'blobs'. Set to |
up |
Directions of distributions if they are plotted non-mirrored. Default |
cutoff |
Avoid plotting very low probabilities of date distributions (default |
plot.range |
Whether or not to plot the curves showing the confidence ranges of the age-model. Defaults to ( |
range.col |
The colour of the curves showing the confidence ranges of the age-model. Defaults to medium grey ( |
range.lty |
The line type of the curves showing the confidence ranges of the age-model. Defaults to |
range.lwd |
Widths of the lines of the ranges of the age-depth model. Default |
mn.col |
The colour of the mean age-depth model: default |
mn.lty |
The line type of the mean age-depth model. Default |
mn.lwd |
Width of the line of the mean age-depth model. Default |
med.col |
The colour of the median age-depth model: not drawn by default |
med.lty |
The line type of the median age-depth model. Default |
med.lwd |
Width of the line of the median age-depth model. Default |
C14.col |
The colour of the calibrated ranges of the dates. Default is semi-transparent blue: |
C14.border |
The colours of the borders of calibrated 14C dates. Default is semi-transparent dark blue: |
cal.col |
The colour of the non-14C dates. Default is semi-transparent blue-green: |
cal.border |
The colour of the border of non-14C dates in the age-depth plot: default semi-transparent dark blue-green: |
dates.col |
As an alternative to colouring dates based on whether they are 14C or not, sets of dates can be coloured as, e.g., |
pb.background |
Probability at which total Pb values are considered to have reached background values, or in other words, that their modelled values are at or below supported + detection limit (Al)). Setting this at 0.5 means that any depth with a Pb measurement, where at least half of the iterations model Pb values reaching background values, is flagged as having reached background. The age-model is not extended to any Pb measurements that have reached background. |
pbmodelled.col |
Colour of the modelled 210Pb values. Defaults to shades of blue: |
pbmeasured.col |
Colour of the measured 210Pb values (default |
pb.lim |
Axis limits for the Pb-210 data. Calculated automatically by default ( |
supp.col |
Colour of supported Pb-210. Defaults to semi-transparent purple, because why not. |
remove.tail |
Whether or not to remove the tail measurements when plotting. Sometimes automated removal might go wrong, so then this option can be used to avoid removing the tail measurements. |
MCMC.resample |
After the MCMC run, if there are more MCMC iterations than requested, only the last 'ssize' iterations will be retained. Defaults to TRUE. |
hiatus.col |
The colour of the depths of any hiatuses. Default |
hiatus.lty |
The line type of the depths of any hiatuses. Default |
from.col |
Starting colour of the gradient for the ghost plot of the age-depth model. Defaults to |
to.col |
Colour of the gradient for the ghost plot of the age-depth model. Defaults to a greyscale, |
rgb.scale |
As alternative to 'from.col' and 'to.col', rgb.scale can be used to produce a coloured representation of all age-models. Needs 3 values for the intensity of red, green and blue. Defaults to grey-scales: |
rgb.res |
Resolution of the colour spectrum depicting the age-depth model, if using 'rgb.scale'. Default |
slump.col |
Colour of slumps. Defaults to |
olderthan.size |
size of the upward arrow to indicate 'olderthan' dates (where the model goes to ages older than said date). Defaults to size 1. |
olderthan.col |
colour of the upward arrow to indicate 'olderthan' dates (where the model goes to ages older than said date). Defaults to black. |
youngerthan.size |
size of the downward arrow to indicate 'youngerthan' dates (where the model goes to ages younger than said date). Defaults to size 1. |
youngerthan.col |
colour of the downward arrow to indicate 'youngerthan' dates (where the model goes to ages younger than said date). Defaults to black. |
normalise.dists |
By default, the distributions of more precise dates will cover less time and will thus peak higher than less precise dates. This can be avoided by specifying |
same.heights |
Plot the distributions of the dates all at the same maximum height (default |
cc |
Calibration curve for 14C dates: |
title |
The title of the age-depth model is plotted on the main panel. By default this is the core's name. To leave empty: |
title.location |
Location of the title. Default |
title.size |
Size of the title font. Defaults to |
plot.labels |
Whether or not to plot labels next to the dated depths. Defaults to |
labels |
Add labels to the dates (as given by the first column of the .csv file). |
label.age |
Position on the age axis of the date labels. By default draws them before the youngest age (1), but can also draw them after the oldest age (2), or above its mean (3). |
label.size |
Size of labels. |
label.col |
Colour of the labels. Defaults to the colour given to the borders of the dates. |
label.offset |
Offsets of the positions of the labels, giving the x and y offsets. Defaults to c(0,0). |
label.adj |
Justification of the labels. Follows R's adj option: A value of '0' produces left-justified text, '0.5' (the default) centered text and '1' right-justified text. |
label.rot |
Rotation of the label. 0 by default (horizontal). |
after |
Sets a short section above and below hiatus.depths within which to calculate ages. For internal calculations - do not change. |
bty |
Type of box to be drawn around plots ( |
mar.left |
Plot margins for the topleft panel (amount of white space along edges of axes 1-4). If left empty, it is set to |
mar.middle |
Plot margins for the middle panel(s) at the top (amount of white space along edges of axes 1-4). If left empty, it is set to |
mar.right |
Plot margins for the topright panel (amount of white space along edges of axes 1-4). If left empty, it is set to |
mar.main |
Plot margins for the main panel (amount of white space along edges of axes 1-4). If left empty, it is set to |
righthand |
Adapt the righthand margins by a certain amount (default 2) to allow a righthand axis to be plotted (for plum) |
mgp |
Axis text margins (where should titles, labels and tick marks be plotted). Defaults to |
xaxs |
Extension of x-axis. By default, add some extra white-space at both extremes ( |
yaxs |
Extension of y-axis. By default, add no extra white-space at both extremes ( |
MCMC.col |
Colour of the MCMC output. Defaults to |
post.col |
Colour of the posterior histogram. Defaults to |
post.border |
Colour of the posterior border. Defaults to |
acc.post.col |
Colour of the posterior of the accumulation rate (yr/cm). Defaults to |
acc.post.border |
Colour of the posterior border of the accumulation rate (yr/cm). Defaults to |
mem.post.col |
Colour of the posterior of the memory. Defaults to |
mem.post.border |
Colour of the posterior of the memory. Defaults to |
hiatus.post.col |
Colour of the posterior of the hiatus length. Defaults to |
hiatus.post.border |
Colour of the border of the hiatus length. Defaults to |
phi.post.col |
Colour of the posterior of the 210Pb influx phi. Defaults to |
phi.post.border |
Colour of the posterior border of the 210Pb influx phi. Defaults to |
s.post.col |
Colour of the posterior of the supported 210Pb. Defaults to |
s.post.border |
Colour of the border of the posterior supported 210Pb. Defaults to |
prior.col |
Colour of the prior curves. Defaults to light green, |
prior.lwd |
Line width of the prior curves. Defaults to |
prior.fontcol |
Colour of the font accompanying the posterior histograms. Defaults to red, |
prior.ticks |
Plot tickmarks and values on the vertical axes for the prior and posterior distributions. Defaults to no tick marks ( |
prior.fontsize |
Font size of the prior, relative to R's standard size. Defaults to |
toppanel.fontsize |
Font size of the top panels, relative to R's standard size. Defaults to |
mainpanel.tickfontsize |
Font size of values at the tick marks in the main panel, relative to R's standard size. Defaults to |
mainpanel.labelfontsize |
Font size of axis labels in the main panel, relative to R's standard size. Defaults to |
acc.xlim |
Horizontal axis limits of the accumulation rate panel. Calculated automatically by default. |
acc.ylim |
Vertical axis limits of the accumulation rate panel. Calculated automatically by default. |
mem.xlim |
Horizontal axis limits of the memory panel. Calculated automatically by default. |
mem.ylim |
Vertical axis limits of the memory panel. Calculated automatically by default. |
hiatus.xlim |
Horizontal axis limits of the hiatus size panel. Calculated automatically by default. |
hiatus.ylim |
Vertical axis limits of the hiatus size panel. Calculated automatically by default. |
phi.xlim |
Horizontal axis limits of the phi panel. Calculated automatically by default. |
phi.ylim |
Vertical axis limits of the phi panel. Calculated automatically by default. |
supp.xlim |
Horizontal axis limits of the supported-Pb panel. Calculated automatically by default. |
supp.ylim |
Vertical axis limits of the supported-Pb panel. Calculated automatically by default. |
xaxt |
Whether or not to plot the x-axis. Can be used to adapt axes after a plot. See ?par for other options. |
yaxt |
Whether or not to plot the y-axis. Can be used to adapt axes after a plot. See ?par for other options. |
plot.pb |
Plot the 210Pb data (if present). Defaults to |
pb.lty |
Line type of measured Pb-210 data. |
plot.pdf |
Produce a pdf file of the age-depth plot. |
quartz |
Use quartz-based pdf plots if available (on Mac OS). Defaults to FALSE. |
cairo |
Use cairo-based pdf plots if available (on Mac OS). Defaults to FALSE. |
dates.only |
By default, the age-depth model is plotted on top of the dates. This can be avoided by supplying |
model.only |
By default, panels showing the MCMC iterations and the priors and posteriors for accumulation rate and memory are plotted above the main age-depth model panel. This can be avoided by supplying |
verbose |
Provide a summary of the age ranges after producing the age-depth model graph; default |
roundby |
Rounding of the values reported at the end of the function. Defaults to 2 decimals. |
save.info |
By default, a variable called ‘info’ with relevant information about the run (e.g., core name, priors, settings, ages, output) is saved into the working directory. Note that this will overwrite any existing variable with the same name - as an alternative, one could run, e.g., |
write.summary |
Whether or not to write a file to the core's folder, which summarizes the run (MCMC, model fit, priors, posteriors, learning). |
ssize |
Number of MCMC iterations to use. |
use.cpp |
Whether or not to use a cpp function to calculate the ages. Defaults to TRUE, but can be set to FALSE (much slower but less experimental) |
version.legend |
Whether to print version information (including calibration curves used) inside the main panel |
version.location |
Location of the version information. Defaults to bottom right for rbacon, top right for rplum. |
version.cex |
Size of the version legend. Defaults to small, cex=0.7. |
version.col |
Colour of the version legend. Defaults to light grey. |
After loading a previous run, or after running either the scissors or thinner command, plot the age-model
again using the command agedepth().
A plot of the age-depth model, and estimated ages incl. confidence ranges for each depth.
Maarten Blaauw, J. Andres Christen
Bacon(ask=FALSE, coredir=tempfile())
agedepth()
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.