Bchron (version 3.2)

Bchronload: 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 2009 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.

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

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.

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)