NEWS.md

In rbacon: Age-Depth Modelling using Bayesian Statistics

rbacon 3.3.1

• now uses the updated rice package (which loads the data rintcal package).
• new options in the age-depth function to steer the formatting of the prior information, such as line width and colour
• new functions to summarise modelled accumulation rates: 'accrate.depth.summary()' and 'accrate.age.summary()' to provide summaries of single depths and ages, respectively, and 'accrates.core()' to write these summaries for all depths of a core to its folder.

rbacon 3.3.0

• the default file name for cc4 is now "mixed.14C"
• Bacon can now run without saving the variable 'info' in the session. E.g., one can run mycore <- Bacon() and then query 'mycore' as one would query 'info'.
• If the dated depths in the .csv file are not in ascending order, this now throws an error (it was a warning, but this caused a subsequent more opaque error).
• new functions to summarise accumulation rates according for a single depth or age, or for a sequence of depths: accrate.depth.summary, accrate.age.summary and accrates.core().
• loads the new R package 'rice' to do most of the legwork related to plotting, calculating and calibrating radiocarbon ages. The 'rintcal' package will become a data package with little user-oriented functionality.

rbacon 3.2.0

• the overlap function now works better if d.min and/or d.max are set
• as per CRAN (Kurt Hornik)'s e-mail, added a sentinel "_PACKAGE" file to the documentation
• changed occurrences of %lu in twalk.h to %llu per CRAN (Prof. Brian Ripley) request
• added run puns
• elbowages are now saved with more relevant information in the file name
• now links to rintcal 0.6.4

rbacon 3.1.1

• repaired a bug related to an upgrade in the rintcal package, which caused problems with plotting young radiocarbon dates
• cleaned up cal.h to remove obsolete references to IntCal13

rbacon 3.1.0

• updated rintcal so that the files containing the NH and SH postbomb curves work as expected
• added an 'accordion' option to squeeze cores with highly irregularly dated sections (e.g., with a few cm of high-res Pb-210 data combined with much longer but lower-resolution C-14 data). Cores can be 'squeezed' and 'stretched' - please check the documentation of the new 'stretch' function. Use with great care
• added an option to agedepth called plotatthesedepths, to enable plotting alternative depths (e.g., after using the compress function), for example agedepth(depths=1:100, plotatthesedepths=1.5*(1:100), d.max=200)
• The upper panels of the accumulation rate, memory, hiatus size, phi and supported (where relevant) gain options to adapt their x/y axis limits
• renamed the options MinAge and MaxAge to the hopefully less confusing youngest.age and oldest.age
• added an option save.ages=TRUE to write a file *_elbowages.txt with the ages for all elbows
• added function set.initvals() to allow running with preset initial MCMC points
• replaced sep=paste0(sep, "\t") in read_write.R line 304 with sep=sep
• new options older.than and younger.than, to use older-than or younger-than dates (e.g. for radiocarbon dates at the dating limit)
• accrate.age and accrate.depth now keep any NA values by default (they can be removed using the option na.rm=TRUE)

rbacon 3.0.0

• accrates.depth.ghost() and accrate.age.ghost() now invisibly return the ranges, medians and means for each depth resp. age for subsequent use, e.g., tmp <- accrates.depth.ghost(); head(tmp)
• MCMC iterations are now stored in the .out files, irrespective of whether they were accepted or rejected
• ssize is now much more predictable (if there are more rows in the output file than set by ssize, rbacon keeps only the last n=ssize rows)
• files are read and written faster (assuming that the data.table R package is installed and loaded, which can be a problem on Macs)
• corrected the help description for Bacon.d.Age() with thanks to Henningte
• the length of the ages output of accrate.age() is now the same even if there are NAs in the output (with thanks to Henningte)
• corrected (hopefully) a bug in read.dets related to logical comparisons with variable lengths causing errors in R>=4.2 (with thanks to Nick McKay for reporting)
• accrate.age.ghost gains a kcal option
• repaired warning message about lengths of logical tests
• now links to rintcal package (renamed from IntCal)
• better Plum plots
• runs can now be interrupted by pressing ctrl+c

rbacon 2.5.8

• some minor updates to the vignettes
• corrected a bug in input.cpp which caused a gcc warning in debian

rbacon 2.5.7

• added an option to agedepth to plot date labels (plot.labels)
• added vignettes
• if ask=FALSE, Bacon now does not ask before writing a new folder (if so required)

rbacon 2.5.6

• removed closeAllConnections() as requested by Kurt Hornik (CRAN)
• adapted agedepth() for further Plum corrections
• corrected the behaviour of the dark option in agedepth(), accrate.depth.ghost(), accrate.age.ghost(), flux.age.ghost() and proxy.ghost()
• renamed rplum's option radon.case to ra.case
• added plot.median to flux.age.ghost() and accrate.age.ghost()
• repaired BCAD in flux.age.ghost()
• removed the error message that acc.shape cannot be equal to acc.mean (shouldn't be a problem any more)

rbacon 2.5.5

• removed revdep folder which caused issues when submitting to CRAN

rbacon 2.5.4

• further separation of rplum and rbacon
• the functions thinner and scissors now deal with Plum runs
• repaired bugs in accrate.age and accrate.age.ghost related to the option BCAD

rbacon 2.5.3

• corrected a bug where postbomb dates could not be plotted owing to wrong by sign
• further improvements to how agedepth deals with plot margins
• corrected error when d.min was set

rbacon 2.5.2

• optimised accrate.age.ghost()
• added options to modify the margins of the individual panels in the agedepth plot: mar.left, mar.middle, mar.right, mar.main
• added an option to plot the tickmarks and labels on the vertical axes of the prior panels: prior.ticks="s" (default "n")
• removed the panels option in agedepth() as it didn't work as expected and is better done outside rbacon functions (e.g., layout(1); agedepth(model.only=T))
• added median curves for accrate.age.ghost and accrate.depth.ghost (as means can be influenced by extreme values)

rbacon 2.5.1

• Adapted the default prior for memory to 0.5 (mean) and 10 (strength), to repair a bug with the original bacon c++ code. This default should work with most cores and give similar results to the previous settings for the memory prior
• Updated c/c++ code (as used in version 2.4.1 with some minor additional updates)
• pMC.age and other IntCal functions should now load as expected (without having to specify, e.g., IntCal::pMC.age)
• the heights of the calibrated distributions should now scale better according to how precise they are
• the add.dates function now handles postbomb dates. It can also store the calibrated information using, e.g., tmp <- add.dates(2450,30,20); tmp
• The greyscale age-depth graph is now more easily exported to external graphics editors, because areas with very low probabilities are now left empty (instead of plotted as white)
• corrected a bug where ages above d.min received incorrect ages
• Added an option prior.ticks to show tickmarks and values on the vertical axes of the panels that show the prior distributions. These are not drawn by default, as they don't provide much information and clutter the graphs
• Added new options title.size and prior.fontsize for the size of the fonts of the core's title and the red information on settings in the top panels, respectively
• Repaired the functions accrate.depth(), accrate.age(), accrate.depth.ghost() and accrate.age.ghost()
• agemodel.it now treats the upper depth of a core as expected

rbacon 2.5.0

• updated src/kernel.cpp and src/twalk.h, to repair a bug in one of the moves ('hop'). This means we can now add the updated MCMC code of version 2.4.0 again and accommodate code to run 210Pb-dated cores (via the package rplum)
• Radiocarbon calibration curves are now loaded from the imported IntCal R package, and have been removed from the rbacon package to save space and remove duplication
• Added option rgb.scale to draw shades of other colours than grey, e.g. red: rgb.scales(1,0,0), for the functions agedepth, accrate.depth.ghost, accrate.age.ghost, proxy.ghost and flux.age.ghost (based on an idea kindly provided by Oliver Wilson).
• Related to rgb.scale, the resolution of the colours has been renamed from grey.res to rgb.res
• added option 'add' to add proxy.ghost graphs to existing plots (based on an idea by Oliver Wilson)
• Repaired bug with greyscales accrate.age.ghost
• if the file with the dates has been modified more recently than a loaded run (e.g., dates could have been added, removed or changed), then a warning is now given that Bacon.cleanup should be ran
• Added a new function Bacon.d.Age to provide the depths belonging to a specific modelled age (kindly contributed by Timon Netzel)
• Depth units are now handled better by the agedepth function
• New option accept.suggestions, which automatically accepts suggestions regarding acc.rate and thick. Use with caution (this option was kindly suggested by Quinn Asena)
• By default, a section is now added below the bottom-most dated depth, in order to ensure that the this depth is always taken into account. Defaults to add.bottom=TRUE.
• The calibrated distributions should now be of the same size again, so that more precise dates peak more than less precise ones (suggested by Tiffany Napier).

rbacon 2.4.3

• replaced 'cat' with 'message' or 'warning' where possible
• updated to the IntCal20 calibration curves (Reimer et al., 2020)

rbacon 2.4.2

• Reverted the c/c++ code back to that of version 2.3.9.1, owing to problems with the code introduced in version 2.4.0 (posteriors of memory and age-model are apparently too wide)
• Repaired bug that caused an error when using slumps or boundaries
• Enhanced behaviour of rotate.axes option

rbacon 2.4.1

• Updated the code to deal with changes in how base-R deals with c() in loops, as suggested by Martin Maechler's e-mail 29 February 2020

rbacon 2.4.0

• The MCMC code has been updated to remove bugs and to accommodate runs with the upcoming 'rplum' package for 210Pb dating
• Added functions which are required to run the 'rplum' package (although 'rbacon' does not require 'rplum' to be installed)

rbacon 2.3.9.1

• Added a new option calheight, which acts as a multiplier for the relative height of non-14C dates
• Set default for y-axis to have no space added after the extreme values (yaxs="i"); x-axis has some space added by default (xaxs="r")
• Added a bit of space to d.max and d.min in the main age-depth graph, to accommodate age blobs
• New option kcal, which gives tick marks every 1,000 cal years (default kcal=FALSE)
• Corrected an error when running a core with 4 columns in the .csv file and cc=0
• depth.unit and age.unit now work correctly when provided as options in Bacon or agedepth
• Corrected a bug where thickness (dC) was sometimes internally set to wrong values
• Redid hiatuses: If a core has one or more hiatuses, then variables slopes.above and slopes.below are made for each hiatus, and used internally to adapt ages and accumulation rates for each depth below and above a hiatus within a section containing a hiatus.
• Slumps, hiatuses and boundaries have gone through a thorough check and should now work better than they did before. Reports of weird behaviour welcome!
• Renamed info\$d to info\$elbows (internal; for better consistency with the naming of parameters within the Bacon paper)

rbacon 2.3.8

• repaired a bug in cal.h which prevented the postbomb curve postbomb_SH3 from being used
• repaired bug where the prior for the accumulation rate would not always be drawn entirely
• Bacon.hist now takes alternative values for prob into account (e.g., prob=.68)
• The agedepth function now deals better with d.min and d.max values
• Colours of cal BP dates now as expected when cc=0 is provided as Bacon option
• The fit of the dates to the age-model is now reported correctly also when BCAD=TRUE
• Date distributions should now plot as expected over a wider range of values
• New option acc.lab to provide alternative label for the accumulation rate axis (top-middle panel of the main agedepth graph)
• When provided, d.max or d.min are now dealt with better if extra columns are provided for dR/dSTD and/or t.a/t.b in the core's .csv file
• New options depth.unit (default 'cm') and age.unit (default 'yr'), deprecating the previous poorly named option 'unit' which defaulted to 'cm'. So can now also deal with, e.g., 'Ma' and 'km'
• Replaced occurrences of yr with the more generic unit of age (deprecate yr.min, yr.max, MinYr, MaxYr)
• When Bacon asks for confirmation to run a core (Y/n), the user can now simply press Enter instead of having to type y first. Similarly, by default suggestions to adapt the prior accumulation rate are not accepted (y/N)
• Enhanced drawing of very precise ages (e.g., 1 yr)
• Bacon now stops if there are less than 2 sections between neighbouring hiatuses
• A warning is now given if acc.shape <1 (since this results in weirdly shaped gamma prior distributions)
• An error is thrown when the core's .csv file has 'orphan' commas (can happen if the file was made in a spreadsheet program - check in a plain-text editor)
• add.dates now plots better when mirror=FALSE
• More consistent error messages

rbacon 2.3.7

• adapted cpp code to allow for more than 10 hiatuses/boundaries (now limited to 50)
• corrected bug causing a warning when a hiatus was set with multiple acc.mean priors provided
• now ensures that hiatus or boundary depths are in the correct order (ascending in depth)

rbacon 2.3.6

• further enhancements to memory usage in MCMC calculations (bacon.h)

rbacon 2.3.5

• added function agemodel.it to extract single iterations of a Bacon age-depth model
• added functions clam2bacon and bacon2clam to translate Bacon dates files into clam files et vice versa (inspired by a suggestion from Dewey Dunnington)
• corrected behaviour of boundary and hiatus (especially if together with slumps)
• iterations with age reversals across a hiatus are now removed
• removed closeAllConnections (suggested by Dewey Dunnington)
• Added option to change the field separator to mix.curves (suggested by Thomas Dye)
• MinYr now defaults to the current year (1950 - as.integer(format(Sys.time(), "\%Y")))
• added option in the scissors function to remove a specific range of iterations (e.g., iterations 400 to 800, or the first/last 300)
• produced separate R files for groups of functions
• Bacon now stops if it finds 6 columns with unexpected names in the .csv file. If provided with a delta.R column, Bacon expects a delta.STD column as well.
• Added an option dates.col to colour sets of dates (suggestion by Greg Cooper)
• enhancements in bacon.h of MCMC calculations and memory usage

rbacon 2.3.4

• faster drawing of greyscale plots (though still slower yet better than in version 2.3.1.1 and before)
• added progress bar to functions that can be slow
• repaired a bug in calculating how many dates fall within the model range
• delta.R is now accepted as a header for the dates file

rbacon 2.3.3

• added an option to include slumps (sort of - more testing still welcome). Example: Bacon(slump=c(50, 52, 60, 70)) for two slumps between 50-52 and 60-70 cm depth
• date-files with .csv.txt extensions are now renamed to .csv (and informing us that it did so)
• default darkness of age-depth greyscale now adapts to a ratio between most and least precise sections (so that very imprecise sections still show some grey)
• repaired option depths (e.g., Bacon(depths=0:100))
• repaired height of prior distribution axes
• repaired Baconvergence()
• added a commentary after each run, mentioning the proportion of dates that lie within the age-depth model's range (some sort of 'agreement')

rbacon 2.3.2

• Added option boundary, which sets hiatus length to (close to) 0. This leaves the hiatus functionality more or less unchanged, and should cause less confusion with setting hiatus.depths even if no hiatus is desired.
• Enhanced plotting and age calculation of depths close to hiatuses or boundaries.
• Ensured more predictable behaviour if R is started in a non-writable directory (e.g. plain, non-Rstudio R on Windows).
• Added confidence ranges to accrate.age.ghost and accrate.depth.ghost.
• Enhanced calculation of mean and median (now based on age distribution, not on a derived histogram).
• Corrected behaviour of title.location.
• Corrected many sundry bugs related to plotting, especially with hiatuses or with BCAD=TRUE.
• Added a NEWS.md file to track changes to the package.

rbacon 2.3.1.1

• Now a CRAN R package (not called bacon since that name was already taken).
• Default core directory now Bacon_runs. Other directories can be given, for more flexibility in workflows of users.
• Calibration curves can be put in a user-specified directory ccdir (hidden by default).
• New function copyCalibrationCurve() to copy calibration curves into an R's session.
• Renamed several options to be more consistent, d.R and d.STD now named delta.R and delta.STD.
• Can now provide depths to be calculated as a variable, as alternative to using a file with depths.
• Added option to not plot x or y axis (xaxt, yaxt).
• Added option to not plot the date distributions mirrored.
• New function Baconvergence() to test for good mixing of MCMC runs.
• Renamed weighted means of age estimates to means.
• Updated documentation.
• Renamed functions flux.age, plot.accrate.age and plot.accrate.depth to flux.age.ghost, accrate.age.ghost and accrate.depth.ghost, respectively.
• BCAD dealt with more correctly.
• Repaired many sundry bugs.

Bacon 2.2

• Updated to 14C calibration curves IntCal13, Marine13 and SHCal13.
• Changed .hpd to _ages.txt since many users get tricked by the extension.
• Changed from .dat files to .csv files as these are more documented and easier to open and edit by users.
• Separator for .csv file can be adapted.
• Renamed res to hopefully more intuitive thick (thickness of sections)
• Added d.R and d.STD
• Bacon.hist gives 95% ranges, mid and wmean, and reads from a file instead of from the command line.
• Added options to change axis limits, orientation and rotation.
• BCAD introduced, though not yet working entirely as expected.
• Different prior for acc.mean suggested if initial estimates indicate that this would be beneficial.
• Introduced a settings file.
• removed calc.every (gave problems with long cores).
• Killed hist bug that assumed integers.
• Language cleanup of cpp files.
• Added option to remove unnecessary files after a run.
• Added option in agedepth to only plot the age-model (so not the upper panels).
• Many bug fixes in the Bacon.R and underlying C/C++ codes

rbacon documentation built on Sept. 30, 2024, 9:40 a.m.