For cases where a large number of records need to be processed using Bacon, this repository serves as a template to generate the required age files in an organized fashion. It provides default parameters for initial runs, and provides a tracking module to indicate whether any issues were encountered in the construction of the geochronological table.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
- Simon Goring
- Andria Dawson
- Allison Stegner
- Yue Wang
Continuous Integration and Quality Assurance
DESCRIPTION are used to integrate this repository with the Travis Continuous Integration platform. You can keep these files, or not, but they are required to support a process in which each new commit to the master branch is independently loaded in a virtual machine hosted by Travis. For more on the use of Continuous Integration with RMarkdown, please visit the post Adding CI to RMarkdown Documents.
LICENSE file and this
README.md file are part of best practices for public code. The Code of Conduct helps define how we as an organization expect to be treated and defines how we should aspire to treat others. It also governs how individuals who interact with this repository and others should expect to be treated, and should treat others.
LICENSE file uses an MIT license. This license is a permissive license with conditions only requiring preservation of copyright and license notices. Neotoma is funded by the National Sciences Foundation. Neotoma maintains a Data Policy that governs the use of data from the Database itself.
.gitignore file is used to ensure that local files on the developers' systems do not clutter the master repository.
How to Use This Repository
This is intended to be used as a template for users, and not as a solution in and of itself. The process for generating chronologies is itterative, as such, the use of this Rmd script is intended to be an itterative process, whereby you select sites, run Bacon, revise parameters and run the script again. Each itteration will involve modifying the parameters file, and also the
settings.yaml file. Please be sure to check carefully as you do this. Errors may result in long wait times, or runs that provide no new useful information.
The key steps of the workflow process are:
- Running the Rmd file.
- Reading in the
- Loading data from Neotoma using the
- Setting default parameters for the Bacon runs (accumulation rates, memory, etc.)
- Updating parameters based on past runs (if you have files with alternate settings)
- Building age files based on chronological controls from Neotoma
- Running Bacon
The implied final step in this process would be modifying the settings file after the first run of this workflow, and adjusting the the parameters in the parameters file generated by the run, to ensure that the Bacon runs for each core reflect the best possible age models. When the Rmd is re-run with the
settings.yaml and parameters file adjusted (see Rmd for details), it is possible to do runs faster, since the script is set to run only core that do not have successful runs, so it is possible to tinker with the settings for one or a few cores, while leaving the rest unchanged.
Running with RStudio
Open the file using RStudio and click the
Running from the command line
Navigate to the working directory and execute the command:
Rscript -e "rmarkdown::render('bulk_baconizing.Rmd')
Feedback, Suggestions and Comments
Please use the issue tracker or email a package maintainer directly.