https://github.com/openthermochronology/thermochron.jl

Open-source time-Temperature inversion of thermochronometric data

https://github.com/openthermochronology/thermochron.jl

Science Score: 39.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
    Found 29 DOI reference(s) in README
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (7.0%) to scientific vocabulary

Keywords

bayesian-inference geochronology inverse-problems julia thermochronology u-th-he
Last synced: 6 months ago · JSON representation

Repository

Open-source time-Temperature inversion of thermochronometric data

Basic Info
  • Host: GitHub
  • Owner: OpenThermochronology
  • License: gpl-3.0
  • Language: Julia
  • Default Branch: main
  • Homepage:
  • Size: 1.81 MB
Statistics
  • Stars: 12
  • Watchers: 2
  • Forks: 0
  • Open Issues: 7
  • Releases: 46
Topics
bayesian-inference geochronology inverse-problems julia thermochronology u-th-he
Created about 5 years ago · Last pushed 6 months ago
Metadata Files
Readme License

README.md

Thermochron.jl

DOI Dev CI CI (Julia nightly) codecov.io

Open-source time-Temperature inversion of thermochronometric data.

Implements a transdimensional Bayesian Markov chain Monte Carlo (MCMC) time-Temperature inversion with optional Simulated Annealing (e.g., 1, 2) and kinetic uncertainty propagation/inversion.

Currently, this package supports the inversion of mineral helium and argon ages using a spherical Crank-Nicolson forward diffusion model following the equations of Gallagher 1995 and Ketcham 2005 along with the damage and annealing model of Guenthner et al. 2013 for zircon U-Th/He (ZRDAAM), the damage and annealing model of Flowers et al. 2009 for apatite U-Th/He (RDAAM), or any constant user-specified $D0$ and $Ea$ for any other generic He or Ar chronometer. The K-feldspar multi-diffusion domain (MDD) method of Lovera et al. 1989 is also included.

Apatite fission track age and fission track length data are supported with the annealing models of Ketcham et al. 1999 and Ketcham et al. 2007, while zircon fission track data are supported with the annealing model of Yamada et al. 2007 and the simultaneous-fit fanning curvilinear ZFT annealing model from Guenthner et al. 2013, discussed further by Ketcham 2019 (sec. 3.8, pgs. 65-67). Monazite fission track is also included with the re-fit annealing model of Jones et al. 2021.

Diffusion-based chronometers: | Chronometer | Mineral | System | Geometry | Diffusion and/or annealing model(s) | | :--- | :--- | :--- | :--- | :--- | | ZirconHe | zircon | helium | spherical | ZRDAAM | | ApatiteHe | apatite | helium | spherical | RDAAM | | SphericalHe | any | helium | spherical | Diffusivity (user-specified D₀, Eₐ) | | PlanarHe | any | helium | slab | Diffusivity (user-specified D₀, Eₐ) | | SphericalAr | any | argon | spherical | Diffusivity (user-specified D₀, Eₐ) | | PlanarAr | any | argon | slab | Diffusivity (user-specified D₀, Eₐ) | | MultipleDomain | feldspar | argon | slab/sphere| MDDiffusivity |

Fission track chronometers: | Chronometer | Mineral | System | Annealing model(s) | | :--- | :--- | :--- | :--- | | ZirconFT | zircon | fission track age | Yamada2007PC,Guenthner2013FC | | MonaziteFT | monazite | fission track age | Jones2021FA | | ApatiteFT | apatite | fission track age | Ketcham1999FC Ketcham2007FC | | ZirconTrackLength | zircon | track length | Yamada2007PC, Guenthner2013FC | | MonaziteTrackLength | monazite | track length | Jones2021FA | | ApatiteTrackLength | apatite | track length | Ketcham1999FC(:unoriented) | | ApatiteTrackLengthOriented | apatite | track length | Ketcham1999FC, Ketcham2007FC |

Inversions may include any combination of chronometers.

Additional systems and models are expected to be added in future releases.

Installation

Thermochron.jl is written in the open-source programming language Julia, for which installation instructions are available at julialang.org/install. As a registered Julia package, Thermochron.jl can by installed by typing julia ] add Thermochron at the Julia REPL (where ] enters Pkg (package manager) mode, backspace to exit), or alternatively julia using Pkg Pkg.add("Thermochron")

After installation, you can check that everything is working properly by running the unit test suite (again from Pkg mode) test Thermochron

Usage

Usage is via a tTinversion.jl script, an example of which may be donwloaded from the examples folder, along with any relevant data files.

This script may be run either from the command line (e.g., julia ./tTinversion.jl) or interactively via your favorite Julia-connected editor or IDE (e.g., vscode/vscodium). A Manifest.toml is also provided in the examples folder, which you may optionally Pkg.instantiate to ensure you have the same versions of all relevant packages that the example was built for.

Several example input data files are also provided in the examples folder, including generic.csv, which illustrates the full range of possible chronometers.

Citation

Thermochron.jl may be cited as:

Keller, C.B., McDannell, K.T., Guenthner, W.R., and Shuster, D.L. (2022). Thermochron.jl: Open-source time-Temperature inversion of thermochronometric data. 10.17605/osf.io/wq2U5

Acknowledgments

The development of Thermochron.jl has been supported in part by National Science Foundation under grant EAR-2044800.

Owner

  • Name: OpenThermochronology
  • Login: OpenThermochronology
  • Kind: organization

Open-source codes for thermochronology and time-temperature inversion

GitHub Events

Total
  • Create event: 32
  • Commit comment event: 60
  • Issues event: 11
  • Release event: 25
  • Watch event: 5
  • Delete event: 13
  • Issue comment event: 44
  • Push event: 427
  • Pull request review event: 2
  • Pull request event: 20
Last Year
  • Create event: 32
  • Commit comment event: 60
  • Issues event: 11
  • Release event: 25
  • Watch event: 5
  • Delete event: 13
  • Issue comment event: 44
  • Push event: 427
  • Pull request review event: 2
  • Pull request event: 20

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 11
  • Total pull requests: 19
  • Average time to close issues: 15 days
  • Average time to close pull requests: about 4 hours
  • Total issue authors: 4
  • Total pull request authors: 3
  • Average comments per issue: 5.45
  • Average comments per pull request: 0.11
  • Merged pull requests: 16
  • Bot issues: 0
  • Bot pull requests: 5
Past Year
  • Issues: 10
  • Pull requests: 17
  • Average time to close issues: 19 days
  • Average time to close pull requests: about 5 hours
  • Issue authors: 3
  • Pull request authors: 3
  • Average comments per issue: 0.4
  • Average comments per pull request: 0.12
  • Merged pull requests: 14
  • Bot issues: 0
  • Bot pull requests: 4
Top Authors
Issue Authors
  • brenhinkeller (6)
  • isaacstential (3)
  • kmcdannell (1)
  • JuliaTagBot (1)
Pull Request Authors
  • brenhinkeller (10)
  • github-actions[bot] (5)
  • kmcdannell (4)
Top Labels
Issue Labels
enhancement (5)
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • julia 2 total
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 51
juliahub.com: Thermochron

Open-source time-Temperature inversion of thermochronometric data

  • Versions: 51
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 2 Total
Rankings
Dependent repos count: 9.9%
Dependent packages count: 38.9%
Average: 40.1%
Forks count: 53.5%
Stargazers count: 58.1%
Last synced: 6 months ago

Dependencies

.github/workflows/CI-julia-nightly.yml actions
  • actions/checkout v2 composite
  • julia-actions/cache v1 composite
  • julia-actions/julia-buildpkg v1 composite
  • julia-actions/julia-runtest v1 composite
  • julia-actions/setup-julia v1 composite
.github/workflows/CI.yml actions
  • actions/checkout v2 composite
  • codecov/codecov-action v2 composite
  • julia-actions/cache v1 composite
  • julia-actions/julia-buildpkg v1 composite
  • julia-actions/julia-docdeploy v1 composite
  • julia-actions/julia-processcoverage v1 composite
  • julia-actions/julia-runtest v1 composite
  • julia-actions/setup-julia v1 composite
.github/workflows/CompatHelper.yml actions
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite