Bchronload {Bchron} | R Documentation |
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).
Bchronload(name, fullname = NULL, path = NULL, outdepths=NULL,calibname = "IntCal09", extractdate = -0.05, check = FALSE, full = FALSE)
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. |
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.
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 |
Andrew Parnell <Andrew.Parnell@ucd.ie>
Haslett and Parnell (2008, JRSSC, 57:399-418) and Parnell et al (2008, QSR, 27(19-20):1872-1885)
See Bchronmenu
for 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)