isochron_burial_dating

MATLAB scripts for calculating isochron burial age using paired cosmogenic nuclides.

https://github.com/qaidamghost/isochron_burial_dating

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.9%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

MATLAB scripts for calculating isochron burial age using paired cosmogenic nuclides.

Basic Info
  • Host: GitHub
  • Owner: QaidamGhost
  • License: gpl-3.0
  • Language: MATLAB
  • Default Branch: main
  • Size: 3 MB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 2
Created almost 4 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

README.md

MATLAB scripts for calculating isochron burial age using paired cosmogenic nuclides.

October 18, 2024

The MATLAB script "york.m" is ported from "York.R" which was written in R language and included in a toolbox called IsoplotR by Vermeesch, 2018. The "yorkfixedintercept.m" is modified after an unpublished R script written by Pieter Vermeesch (personal communication). The "production_rate.m" is modified after a MATLAB script "CNP.m" developed by Maarten Lupker, Chia-Yu Chen, Richard Ott, Erica Erlanger, and Yanyan Wang (Lupker et al., 2012). Other .m-files in this directory are written by Yizhou Yang. See file "NOTICE" for copyright and licensing notice pertaining to all .mat and .m-files in the following list.

List of .mat and .m-files

  • consts.mat: constants for calculation, including Stone's scaling parameters, mean lives of 10Be and 26Al, alpha as the cutoff value, step for KDE, simulation times, SLHL production rates, the limit for iterations, and attenuation lengths of nuclide and muons.
  • custommatfiles: Generate custom "e.mat" and "expo_age.mat" before constraining the upper limit of the post-burial concentrations and lower limit of the burial age if erosion rates and exposure age have already been known.
  • isochronburialage: An iteration process to calculate isochron line for burial dating following Erlanger et al., 2012; Erlanger, 2010; Granger, 2014
  • KDE: Find the most probable value and 1 sigma absolute error for the observed simulations of a random variable after establishing the probability density function by a "nonparametric estimation" approach known as kernel density estimation (KDE).
  • Npb_depth: Calculate the upper limit of the post-burial concentrations with 1 sigma error at the sampling location and penetration depth if the exposure age (and additional erosion rate) of the surface is constrained.
  • plot_isochron: Plot isochron line, production ratio line, and errorbars of samples
  • production_rate: Calculate 10Be or 26Al Production Rates on the surface or at a given depth from Spallation and Muons.
  • remove_outliers: Statistically remove the reworked clast(s) following Odom, 2020
  • simpleburialage: Calculate the simple burial age of each sample.
  • york: A "york fit" script modified after york.R in IsoplotR by Vermeesch, 2018
  • yorkfixedintercept: A "york fit with a fixed intercept" script modified after an unpublished R script written by Pieter Vermeesch (personal communication)

Instruction

Preparation

  1. The scripts assume the ratio of surface production rates as 6.61 which is indicated by the adopted mean lives of 10Be and 26Al. Try to modify the production rates and mean lives in the "consts.mat" and/or the codes in the "production_rate.m" if you want to switch to a different value of that ratio, or the results will show some inaccuracy in the burial ages.
  2. Make sure that all DEPENDENCIES are promised.
  3. Check the values restored in the "consts.mat". If you want to use other values, just replace them in the .mat-file before running the scripts.
  4. Create the file "expoage.mat" (and an optional "e.mat") in the root directory if the upper and lower limits of the burial age are to be determined. See the instruction for these two files in "Npbdepth.m" and "custommatfiles" for the creation. ### Calculation
  5. Define the variables, the arguments in "isochronburialdating.m", with your values. See "arguments" in "isochronburialdating.m" for further instructions. data.x=[XXXXXX,XXXXXX,...,XXXXXX]; data.dx=[XXXXXX,XXXXXX,...,XXXXXX]; data.y=[XXXXXX,XXXXXX,...,XXXXXX]; data.dy=[XXXXXX,XXXXXX,...,XXXXXX]; init_Rinh=XXXXXX; source_lat=XXXXXX; source_elv=XXXXXX; %if the intercept falls below the origin, the following variables are needed as additional arguments for constraining the upper and lower limits of the burial ages measured_lat=XXXXXX; measured_elv=XXXXXX; shielding_factor=XXXXXX; z=XXXXXX; rho=XXXXXX; option.flag2=1; % optional
  6. Run "isochronburialage.m" in the command window. ``` % for isochron burial dating only isochronburialage(data,initRinh,sourcelat,source_elv);

    % for isochron burial dating and constraining the upper and lower limits of the burial ages owing to negative intercept isochronburialage(data,initRinh,sourcelat,sourceelv,measuredlat,measuredelv,shieldingfactor,z,rho,option); ```

    Output

  7. Print the simple burial ages and their uncertainties.

  8. Print the isochron burial ages with MSWD and plot the isochron line with measured data, linearized data, and reworked clasts.

  9. If the final intercept in step 2 is less than zero, the scripts will give the upper and lower limits of the burial ages with MSWD and plot the isochron line with measured data, linearized data, and reworked clasts.

Dependencies and recommended versions

  • Matlab 2021b or higher version.
  • Optimization Toolbox 9.2 or higher version.
  • Statistics and Machine Learning Toolbox 12.2 or higher version.

Platforms for tests

  • Intel i9-9900K / HP OMEN by HP Obelisk Desktop 875-1xxx / Windows 10 21H2
  • AMD RYZEN R5-3600x / MSI B450m MORTAR / Windows 10 21H2

References

  • Balco, Greg, and Charles W. Rovey. "An isochron method for cosmogenic-nuclide dating of buried soils and sediments." American Journal of Science 308.10 (2008): 1083-1114.
  • Braucher, R., et al. "Production of cosmogenic radionuclides at great depth: A multi element approach." Earth and Planetary Science Letters 309.1-2 (2011): 1-9.
  • Chmeleff, Jérôme, et al. "Determination of the 10Be half-life by multicollector ICP-MS and liquid scintillation counting." Nuclear Instruments and Methods in Physics Research Section B: Beam Interactions with Materials and Atoms 268.2 (2010): 192-199.
  • Erlanger, Erica D. "Rock uplift, erosion, and tectonic uplift of South Africa determined with cosmogenic aluminum-26 and beryllium-10." Ph. D. Thesis (2010).
  • Erlanger, Erica D., Darryl E. Granger, and Ryan J. Gibbon. "Rock uplift rates in South Africa from isochron burial dating of fluvial and marine terraces." Geology 40.11 (2012): 1019-1022.
  • Gibbon, Ryan J., et al. "Early Acheulean technology in the Rietputs Formation, South Africa, dated with cosmogenic nuclides." Journal of Human Evolution 56.2 (2009): 152-160.
  • Granger, Darryl E., and Paul F. Muzikar. "Dating sediment burial with in situ-produced cosmogenic nuclides: theory, techniques, and limitations." Earth and Planetary Science Letters 188.1-2 (2001): 269-281.
  • Granger, D. E. "Cosmogenic nuclide burial dating in archaeology and paleoanthropology." (2014): 81-97.
  • Hidy, Alan J., et al. "A geologically constrained Monte Carlo approach to modeling exposure ages from profiles of cosmogenic nuclides: An example from Lees Ferry, Arizona." Geochemistry, Geophysics, Geosystems 11.9 (2010).
  • Korschinek, Gunther, et al. "A new value for the half-life of 10Be by heavy-ion elastic recoil detection and liquid scintillation counting." Nuclear Instruments and Methods in Physics Research Section B: Beam Interactions with Materials and Atoms 268.2 (2010): 187-191.
  • Lal, Devendra. "Cosmic ray labeling of erosion surfaces: in situ nuclide production rates and erosion models." Earth and Planetary Science Letters 104.2-4 (1991): 424-439.
  • Lupker, Maarten, et al. "10Be-derived Himalayan denudation rates and sediment budgets in the Ganga basin." Earth and Planetary Science Letters 333 (2012): 146-156.
  • Mahon, Keith I. "The New “York” regression: Application of an improved statistical method to geochemistry." International Geology Review 38.4 (1996): 293-303.
  • Samworth, E. A., E. K. Warburton, and G. A. P. Engelbertink. "Beta Decay of the Al 26 Ground State." Physical Review C 5.1 (1972): 138.
  • Stone, John O. "Air pressure and cosmogenic isotope production." Journal of Geophysical Research: Solid Earth 105.B10 (2000): 23753-23759.
  • Titterington, D. Michael, and Alex N. Halliday. "On the fitting of parallel isochrons and the method of maximum likelihood." Chemical Geology 26.3-4 (1979): 183-195.
  • Vermeesch, Pieter. "IsoplotR: A free and open toolbox for geochronology." Geoscience Frontiers 9.5 (2018): 1479-1493.
  • William III, E. Odom. Dating the Cenozoic incision history of the Tennessee and Shenandoah Rivers with cosmogenic nuclides and 40Ar/39Ar in manganese oxides. Diss. Purdue University Graduate School, 2020.
  • York, Derek. "Least squares fitting of a straight line with correlated errors." Earth and planetary science letters 5 (1968): 320-324.
  • York, Derek, et al. "Unified equations for the slope, intercept, and standard errors of the best straight line." American journal of physics 72.3 (2004): 367-375.

GitHub Events

Total
  • Release event: 2
  • Push event: 6
  • Create event: 1
Last Year
  • Release event: 2
  • Push event: 6
  • Create event: 1