polynesianoutliersvoyaging

This repository contains the data and code for our paper:

A. Hermann, P. Gutiérrez, C. Chauvel, R. Maury, C. Liorzou, E. Willie, I. Phillip, R. Forkel, C. Rzymski, S. Bedford, 2023. Artefact geochemistry demonstrates long-distance voyaging in the Polynesian Outliers. Science Advances. https://doi.org/10.1126/sciadv.adf4487

How to cite

Please cite this compendium as:

A. Hermann, (2022). Artefact geochemistry demonstrates long-distance voyaging in the Polynesian Outliers. Accessed 20 Apr 2023. Online at https://doi.org/10.5281/zenodo.7388196

The analysis directory contains:

📁 paper: R Markdown source document for manuscript. Includes code to reproduce the figures and tables generated by the analysis. It also has a rendered version, paper.docx, suitable for reading (the code is replaced by figures and tables in this file)
📁 data: Data used in the analysis.
📁 figures: Plots and other illustrations
📁 supplementary-materials: Supplementary materials including notes and other documents prepared and collected during the analysis.

How to run in your browser or download and run locally

This research compendium has been developed using the statistical programming language R. To work with the compendium, you will need installed on your computer the R software itself and optionally RStudio Desktop.

In order to install all of the dependencies required by the analyses devtools is required (install.packages("devtools"). Additionally, your R version needs to be >=4.0.

You can download the compendium as a zip from from this URL: main.zip. After unzipping: - open the .Rproj file in RStudio - run devtools::install() to ensure you have the packages this analysis depends on (also listed in the DESCRIPTION file). - finally, open analysis/paper/paper.Rmd and knit to produce the paper.docx, or run rmarkdown::render("analysis/paper/paper.Rmd") in the R console

How to reproduce the analysis

1/ Download locally pofatu/georoc-data and pofatu/pofatu-data repositories and unzip the SQLite database georoc.sqlite.gz (dist/pofatu.sqlite does not need unzipping). To reproduce the results please use Pofatu version v1.2 and Georoc version v1.0
2/ Run the R script helper-functions-globals after inserting the local path to the sqlite files.
3/ Run the R script sql-queries.
4/ Run any of the R scripts in paper or in supplementary-materials to reproduce the figures in the paper or in the supplementary materials.

Licenses

Text and figures : CC-BY-4.0

Code : See the DESCRIPTION file

Data : CC BY-NC 4.0

Contributions

We welcome contributions from everyone. Before you get started, please see our contributor guidelines. 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.

tupuni/polynesianoutliersvoyaging