settings: Retrieve and record global settings
In pvermees/IsoplotR: Statistical Toolbox for Radiometric Geochronology
settings R Documentation
Retrieve and record global settings
Description
Get and set preferred values for decay constants, isotopic
abundances, molar masses, fission track etch efficiences, and
etchable lengths, and mineral densities, either individually or via
a .json file format.
Usage
settings(setting = NA, ..., fname = NA, reset = FALSE)
Arguments
setting
unless fname is provided, this should be one
of either:
'lambda': to get and set decay constants
'iratio': isotopic ratios
'imass': isotopic molar masses
'mindens': mineral densities
'etchfact': fission track etch efficiency factors
'tracklength': equivalent isotropic fission track length
'alpha': the significance level of confidence intervals
...
depends on the value for setting:
For 'lambda': the isotope of interest (one of either
"fission", "U238", "U235", "U234",
"Th232", "Th230", "Pa231", "Ra226",
"Re187", "Sm147", "Rb87", "Lu176", or
"K40") PLUS (optionally) the decay constant value and its
analytical error. Omitting the latter two numbers simply returns
the existing values.
For 'iratio': the isotopic ratio of interest (one of either
"Ar40Ar36", "Ar38Ar36", "Ca40Ca44",
"K39K41", "K40K41", "Rb85Rb87",
"Sr88Sr86", "Sr87Sr86", "Sr84Sr86",
"Re185Re187", "Os184Os188" "Os186Os188",
"Os187Os188", "Os189Os188", "Os190Os188",
"Os192Os188", "Sm144Sm152", "Sm147Sm152",
"Sm148Sm152", "Sm149Sm152", "Sm150Sm152",
"Sm154Sm152", "Nd142Nd144", "Nd143Nd144",
"Nd145Nd144", "Nd146Nd144", "Nd148Nd144",
"Nd150Nd144", "Lu176Lu175", "Hf174Hf177",
"Hf176Hf177", "Hf178Hf177", "Hf179Hf177",
"Hf180Hf177", "U238U235", "Pb207Pb206",
"Pb206Pb204", "Pb207Pb204", "Pb208Pb204",
"Pb206Pb208", "Pb207Pb208") PLUS (optionally) the
isotopic ratio and its analytical error. Omitting the latter two
numbers simply returns the existing values.
For 'imass': the (isotopic) molar mass of interest (one of
either "U", "Th", "Rb", "Rb85",
"Rb87", "Sr84", "Sr86", "Sr87",
"Sr88", "Re", "Re185", "Re187",
"Os", "Os184", "Os186", "Os187",
"Os188", "Os189", "Os190", "Os192",
"Sm", "Nd", "Lu", "Hf") PLUS
(optionally) the molar mass and its analytical error. Omitting the
latter two numbers simply returns the existing values.
For 'mindens': the mineral of interest (one of either
"apatite" or "zircon") PLUS the mineral
density. Omitting the latter number simply returns the existing
value.
For 'etchfact': the mineral of interest (one of either
"apatite" or "zircon") PLUS the etch efficiency
factor. Omitting this number simply returns the existing value.
For 'tracklength': the mineral of interest (one of either
"apatite" or "zircon") PLUS the equivalent isotropic
fission track length. Omitting this number simply returns the
existing value.
fname
the path of a .json file
reset
logical. If TRUE, restores the default values
Value
if setting=NA and fname=NA, returns a
.json string
if ... contains only the name of an isotope, isotopic ratio,
element, or mineral and no new value, then settings returns
either a scalar with the existing value, or a two-element vector
with the value and its uncertainty.
References
Decay constants:
-
^{238}U, ^{235}U: Jaffey, A. H., et
al. "Precision measurement of half-lives and specific
activities of U^{235} and U^{238}."
Physical Review C 4.5 (1971): 1889.
-
^{232}Th: Le Roux, L. J., and
L. E. Glendenin. "Half-life of ^{232}Th.", Proceedings of the
National Meeting on Nuclear Energy, Pretoria, South Africa. 1963.
-
^{234}U, ^{230}Th: Cheng, H., Edwards, R.L.,
Shen, C.C., Polyak, V.J., Asmerom, Y., Woodhead, J., Hellstrom, J.,
Wang, Y., Kong, X., Spotl, C. and Wang, X., 2013. Improvements in
^{230}Th dating, ^{230}Th and ^{234}U half-life
values, and U-Th isotopic measurements by multi-collector
inductively coupled plasma mass spectrometry. Earth and Planetary
Science Letters, 371, pp.82-91.
-
^{231}Pa, ^{226}Ra: Audi, G., Bersillon, O.,
Blachot, J. and Wapstra, A.H., 2003. The NUBASE evaluation of
nuclear and decay properties. Nuclear Physics A, 729(1), pp.3-128.
Sm: Villa, I.M., Holden, N.E., Possolo, A., Ickert, R.B.,
Hibbert, D.B. and Renne, P.R., 2020. IUPAC-IUGS recommendation on
the half-lives of ^{147}Sm and ^{146}Sm. Geochimica et
Cosmochimica Acta, 285, pp.70-77.
Nd: Zhao, Motian, et
al. "Absolute measurements of neodymium isotopic abundances and atomic
weight by MC-ICPMS." International Journal of Mass Spectrometry 245.1
(2005): 36-40.
Re: Smoliar, Michael I., Richard J. Walker, and John
W. Morgan. "Re-Os ages of group IIA, IIIA, IVA, and IVB iron meteorites."
Science 271.5252 (1996): 1099-1102.
Ar: Renne, Paul R., et
al. "Response to the comment by WH Schwarz et al. on "Joint
determination of ^{40}K decay constants and
^{40}Ar*/^{40}K for the Fish Canyon sanidine standard,
and improved accuracy for ^{40}Ar/^{39}Ar
geochronology" by PR Renne et al.(2010)." Geochimica et
Cosmochimica Acta 75.17 (2011): 5097-5100.
Rb: Villa, I.M., De Bievre, P., Holden, N.E. and Renne, P.R., 2015.
"IUPAC-IUGS recommendation on the half life of ^{87}Rb".
Geochimica et Cosmochimica Acta, 164, pp.382-385.
Lu: Soederlund, Ulf, et al. "The ^{176}Lu decay constant
determined by Lu-Hf and U-Pb isotope systematics of Precambrian mafic
intrusions." Earth and Planetary Science Letters 219.3 (2004): 311-324.
Isotopic ratios:
Ar: Lee, Jee-Yon, et
al. "A redetermination of the isotopic abundances of atmospheric Ar."
Geochimica et Cosmochimica Acta 70.17 (2006): 4507-4512.
K: Garner, E.L., et al.
"Absolute isotopic abundance ratios and the atomic weight of a reference
sample of potassium". J. Res. Natl. Bur. Stand. A
79.6 (1975): 713-725.
Ca: Moore, L.J. and Machlan, L.A., 1972. High-accuracy
determination of calcium in blood serum by isotope dilution mass
spectrometry. Analytical chemistry, 44(14), pp.2291-2296.
Rb: Catanzaro, E. J., et al. "Absolute isotopic abundance ratio and
atomic weight of terrestrial rubidium." J. Res. Natl. Bur. Stand. A 73
(1969): 511-516.
Sr: Moore, L. J., et al. "Absolute isotopic abundance ratios and atomic
weight of a reference sample of strontium." J. Res. Natl. Bur. Stand.
87.1 (1982): 1-8.
and (for ^{87}Sr/^{86}Sr):
Compston, W., Berry, H., Vernon, M.J., Chappell, B.W. and Kaye,
M.J., 1971. Rubidium-strontium chronology and chemistry of lunar
material from the Ocean of Storms. In Lunar and Planetary Science
Conference Proceedings (Vol. 2, p. 1471).
Sm: Chang, Tsing-Lien, et al. "Absolute isotopic composition and atomic
weight of samarium." International Journal of Mass Spectrometry 218.2
(2002): 167-172.
Re: Gramlich, John W., et al. "Absolute isotopic abundance ratio and
atomic weight of a reference sample of rhenium." J. Res. Natl. Bur.
Stand. A 77 (1973): 691-698.
Os: Voelkening, Joachim, Thomas Walczyk, and Klaus G. Heumann.
"Osmium isotope ratio determinations by negative thermal ionization
mass spectrometry." Int. J. Mass Spect. Ion Proc. 105.2 (1991): 147-159.
Lu: De Laeter, J. R., and N. Bukilic.
"Solar abundance of ^{176}Lu and s-process nucleosynthesis."
Physical Review C 73.4 (2006): 045806.
Hf: Patchett, P. Jonathan.
"Importance of the Lu-Hf isotopic system in studies of planetary
chronology and chemical evolution." Geochimica et Cosmochimica
Acta 47.1 (1983): 81-91.
Pb: Stacey, J.T. and Kramers,
J. "Approximation of terrestrial lead isotope evolution by a two-stage model."
Earth and Planetary Science Letters, 26(2) (1975): 207-221.
U: Hiess, Joe, et
al. "^{238}U/^{235}U systematics in terrestrial uranium-bearing minerals."
Science 335.6076 (2012): 1610-1614.
See Also
read.data
Examples
# load and show the default constants that come with IsoplotR
json <- system.file("constants.json",package="IsoplotR")
settings(fname=json)
print(settings())
# use the decay constant of Kovarik and Adams (1932)
settings('lambda','U238',0.0001537,0.0000068)
print(settings('lambda','U238'))
# returns the 238U/235U ratio of Hiess et al. (2012):
print(settings('iratio','U238U235'))
# use the 238U/235U ratio of Steiger and Jaeger (1977):
settings('iratio','U238U235',138.88,0)
print(settings('iratio','U238U235'))
pvermees/IsoplotR documentation built on Nov. 18, 2024, 1:02 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| settings | R Documentation |
Retrieve and record global settings
Description
Get and set preferred values for decay constants, isotopic
abundances, molar masses, fission track etch efficiences, and
etchable lengths, and mineral densities, either individually or via
a .json file format.
Usage
settings(setting = NA, ..., fname = NA, reset = FALSE)
Arguments
setting |
unless
|
... |
depends on the value for For For For For For For |
fname |
the path of a |
reset |
logical. If |
Value
if setting=NA and fname=NA, returns a
.json string
if ... contains only the name of an isotope, isotopic ratio,
element, or mineral and no new value, then settings returns
either a scalar with the existing value, or a two-element vector
with the value and its uncertainty.
References
Decay constants:
-
^{238}U,^{235}U: Jaffey, A. H., et al. "Precision measurement of half-lives and specific activities of U^{235}and U^{238}." Physical Review C 4.5 (1971): 1889. -
^{232}Th: Le Roux, L. J., and L. E. Glendenin. "Half-life of^{232}Th.", Proceedings of the National Meeting on Nuclear Energy, Pretoria, South Africa. 1963. -
^{234}U,^{230}Th: Cheng, H., Edwards, R.L., Shen, C.C., Polyak, V.J., Asmerom, Y., Woodhead, J., Hellstrom, J., Wang, Y., Kong, X., Spotl, C. and Wang, X., 2013. Improvements in^{230}Th dating,^{230}Th and^{234}U half-life values, and U-Th isotopic measurements by multi-collector inductively coupled plasma mass spectrometry. Earth and Planetary Science Letters, 371, pp.82-91. -
^{231}Pa,^{226}Ra: Audi, G., Bersillon, O., Blachot, J. and Wapstra, A.H., 2003. The NUBASE evaluation of nuclear and decay properties. Nuclear Physics A, 729(1), pp.3-128. Sm: Villa, I.M., Holden, N.E., Possolo, A., Ickert, R.B., Hibbert, D.B. and Renne, P.R., 2020. IUPAC-IUGS recommendation on the half-lives of
^{147}Sm and^{146}Sm. Geochimica et Cosmochimica Acta, 285, pp.70-77.Nd: Zhao, Motian, et al. "Absolute measurements of neodymium isotopic abundances and atomic weight by MC-ICPMS." International Journal of Mass Spectrometry 245.1 (2005): 36-40.
Re: Smoliar, Michael I., Richard J. Walker, and John W. Morgan. "Re-Os ages of group IIA, IIIA, IVA, and IVB iron meteorites." Science 271.5252 (1996): 1099-1102.
Ar: Renne, Paul R., et al. "Response to the comment by WH Schwarz et al. on "Joint determination of
^{40}K decay constants and^{40}Ar*/^{40}K for the Fish Canyon sanidine standard, and improved accuracy for^{40}Ar/^{39}Ar geochronology" by PR Renne et al.(2010)." Geochimica et Cosmochimica Acta 75.17 (2011): 5097-5100.Rb: Villa, I.M., De Bievre, P., Holden, N.E. and Renne, P.R., 2015. "IUPAC-IUGS recommendation on the half life of
^{87}Rb". Geochimica et Cosmochimica Acta, 164, pp.382-385.Lu: Soederlund, Ulf, et al. "The
^{176}Lu decay constant determined by Lu-Hf and U-Pb isotope systematics of Precambrian mafic intrusions." Earth and Planetary Science Letters 219.3 (2004): 311-324.
-
Isotopic ratios:
Ar: Lee, Jee-Yon, et al. "A redetermination of the isotopic abundances of atmospheric Ar." Geochimica et Cosmochimica Acta 70.17 (2006): 4507-4512.
K: Garner, E.L., et al. "Absolute isotopic abundance ratios and the atomic weight of a reference sample of potassium". J. Res. Natl. Bur. Stand. A 79.6 (1975): 713-725.
Ca: Moore, L.J. and Machlan, L.A., 1972. High-accuracy determination of calcium in blood serum by isotope dilution mass spectrometry. Analytical chemistry, 44(14), pp.2291-2296.
Rb: Catanzaro, E. J., et al. "Absolute isotopic abundance ratio and atomic weight of terrestrial rubidium." J. Res. Natl. Bur. Stand. A 73 (1969): 511-516.
Sr: Moore, L. J., et al. "Absolute isotopic abundance ratios and atomic weight of a reference sample of strontium." J. Res. Natl. Bur. Stand. 87.1 (1982): 1-8.
and (for
^{87}Sr/^{86}Sr):Compston, W., Berry, H., Vernon, M.J., Chappell, B.W. and Kaye, M.J., 1971. Rubidium-strontium chronology and chemistry of lunar material from the Ocean of Storms. In Lunar and Planetary Science Conference Proceedings (Vol. 2, p. 1471).
Sm: Chang, Tsing-Lien, et al. "Absolute isotopic composition and atomic weight of samarium." International Journal of Mass Spectrometry 218.2 (2002): 167-172.
Re: Gramlich, John W., et al. "Absolute isotopic abundance ratio and atomic weight of a reference sample of rhenium." J. Res. Natl. Bur. Stand. A 77 (1973): 691-698.
Os: Voelkening, Joachim, Thomas Walczyk, and Klaus G. Heumann. "Osmium isotope ratio determinations by negative thermal ionization mass spectrometry." Int. J. Mass Spect. Ion Proc. 105.2 (1991): 147-159.
Lu: De Laeter, J. R., and N. Bukilic. "Solar abundance of
^{176}Lu and s-process nucleosynthesis." Physical Review C 73.4 (2006): 045806.Hf: Patchett, P. Jonathan. "Importance of the Lu-Hf isotopic system in studies of planetary chronology and chemical evolution." Geochimica et Cosmochimica Acta 47.1 (1983): 81-91.
Pb: Stacey, J.T. and Kramers, J. "Approximation of terrestrial lead isotope evolution by a two-stage model." Earth and Planetary Science Letters, 26(2) (1975): 207-221.
U: Hiess, Joe, et al. "
^{238}U/^{235}U systematics in terrestrial uranium-bearing minerals." Science 335.6076 (2012): 1610-1614.
See Also
read.data
Examples
# load and show the default constants that come with IsoplotR
json <- system.file("constants.json",package="IsoplotR")
settings(fname=json)
print(settings())
# use the decay constant of Kovarik and Adams (1932)
settings('lambda','U238',0.0001537,0.0000068)
print(settings('lambda','U238'))
# returns the 238U/235U ratio of Hiess et al. (2012):
print(settings('iratio','U238U235'))
# use the 238U/235U ratio of Steiger and Jaeger (1977):
settings('iratio','U238U235',138.88,0)
print(settings('iratio','U238U235'))
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.