Bchronload {Bchron}R Documentation

Command-line based loading of Bchron input files for a Bchron run.

Description

A quick command line function to create a Bchron data object from various inputs. Note that all text strings must be given in inverted commas (apart from TRUE/FALSE).

Usage

Bchronload(name, fullname = NULL, path = NULL, outdepths=NULL,calibname = "IntCal09", extractdate = -0.05, check = FALSE, full = FALSE)

Arguments

name A text string containing the name of the .dat file used.
fullname A text string giving the full name of the core (used for plotting purposes). Defaults to name.
path The path to the Bchron directory. Defaults to c:/Bchron (windows) or ~/Bchron (unix).
outdepths A collection of depths at which chronological ages will be calculated. Default is top dated depth to bottom dated depth, length 200.
calibname The name of the calibratiion curve .bch file used. Defaults to the Northern Hemisphere 2004 internationally agreed calibration curve.
extractdate The extracted date of the core in thousands of years before present. Defaults to the year 2000 (=-0.05 k cal years BP).
check If true, performs Bchronconvergecheck on the given data files.
full If true, also loads in chronologies, calibrated dates, etc, for further analysis. This may take a bit of extra time as some of these files are large.

Details

Useful for batch processing of calibration runs, this function allows the user to load in and create a Bchrondata object which can then be used in all the other Bchron functions.

Value

Returns a list object with the following components:

name The name of the .dat file
fullname The full name of the core
version The version number of Bchron
path The path to the Bchron directory
calibcurvefile The path to the calibration curve
c14file The path to the .14c file of the calibration curve
inputfile The path to the input file of dates and depths
calibdatesfile The path to the file of calibrated radiocarbon date samples
calibrangesfile The path to the file of calibrated radiocarbon date ranges
parsfile The path to the file of Bchron parameter output
chronsfile The path to the file containing the sample chronologies
outlierfile The path to the file containing the outlier date sumaries
rangesfile The path to the file containing the chronology summary ranges
extractdate The date of core extraction
bigcalsize The length of the .bch calibration curve
lowcal The youngest age of the given calibration curve
highcal The eldest age of the given calibration curve
input The table of input data (dates, depths, thicknesses etc)
outdepths A collection of depths at which the chronological age is required
calibdates (if full=TRUE, a matrix of sample calibrated dates
calibranges if full=TRUE, a matrix of calibrated date ranges
pars if full=TRUE, a matrix of Bchron parameter output
chrons if full=TRUE, a matrix of sample chronologies
outlier if full=TRUE, a matrix of outlier date summaries
ranges if full=TRUE, a matrix of chronology summaries

Author(s)

Andrew Parnell <Andrew.Parnell@ucd.ie>

References

Haslett and Parnell (2008, JRSSC, 57:399-418) and Parnell et al (2008, QSR, 27(19-20):1872-1885)

See Also

See Bchronmenu for examples.

Examples

# For the example data, the following should run (when the files are placed in the default directory in windows; c:/Bchron)
# myrun <- Bchronload("Glendalough")
# Bchroncalibrate(myrun)
# BchronMCMC(myrun)
# Bchronpredict(myrun)
# Bchronplot(myrun)

[Package Bchron version 3.1 Index]