-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.Rmd
76 lines (54 loc) · 4.32 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
# Please put your title here to include it in the file below.
Title <- "A new Framework for Quantifying Prehistoric Grave Wealth"
```
# Repository for the paper "A new Framework for Quantifying Prehistoric Grave Wealth"
This repository contains the data and code for our paper:
> Nørtoft, Mikkel, (2022). `r Title`. _Journal of Computer Applications in Archaeology, 5(1)_, pp. 123-139 <https://doi.org/10.5334/jcaa.86>
The paper quantifies grave wealth from eight different parameters, and use these in correlation with demographic factors and for calculating Gini indices using Moravian Corded Ware Culture (CWC) graves as a case study.
One of the eight parameters is (estimated) manufacturing time of grave goods. The extensive Supplementary Information (SI) in this repository goes into more detail about how manufacturing time is calculated based on primarily experimental reference data, and then applied to archaeological data from different material-specific parameters. The SI (open SI.html in a separate window or tab) also elaborates on other theoretical, methodological, and contextual aspects that could not fit in the main paper.
Apart from this, all R-scripts, reference data and archaeological data (grave and grave good data from Moravian CWC, and geodata for raw material sources from around Europe) used in the main paper and the SI can be found in this repository.
### How to cite
Please cite this compendium as:
> Nørtoft, Mikkel, (`r format(Sys.Date(), "%Y")`). _Repository for `r Title`_. Accessed `r format(Sys.Date(), "%d %b %Y")`.
## Contents
The **analysis** directory contains:
- [:file\_folder: paper](/analysis/paper): R Markdown source document
for manuscript. Includes code (or code references) to reproduce the figures and tables
generated in the paper. See CAA journal for the main paper.
- [:file\_folder: data](/analysis/data): Data used in the analysis (both experimental reference data and archaeological data).
- [:file\_folder: scripts](/analysis/scripts): Scripts used in the analysis.
- [:file\_folder: figures](/analysis/figures): illustrations for the main paper
- [:file\_folder:
supplementary-information](/analysis/paper/SI.Rmd):
RMarkdown file for the Supplementary information (SI) with specifics on how manufacturing
time and other value parameters in the main paper were calculated as well as extended
description of theoretical, methodological, and contextual aspects that did not fit in the
main paper. See prehistoricmap.com/quantwealth/SI.html for a rendered version or the same file at Zenodo
- [:file\_folder: figures_SI](/analysis/figures_SI): illustrations for the Supplementary
Information.
## 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](https://cloud.r-project.org/)
itself and optionally [RStudio Desktop](https://rstudio.com/products/rstudio/download/).
The simplest way to work with this repository is to clone or download it, and then:
- open the `.Rproj` file in RStudio
- run `devtools::install()` to ensure you have the packages this analysis depends on (also listed in the
[DESCRIPTION](/DESCRIPTION) file).
- finally, open `analysis/paper/paper_word.Rmd` and knit to produce the paper (some things were manually edited in official version of the paper and may not appear in the re-knitted output), or run `rmarkdown::render("analysis/paper/SI.Rmd")` in the R console to produce the `SI.html` (takes some time to produce)
### Licenses
**Text and figures :** [CC-BY-4.0](http://creativecommons.org/licenses/by/4.0/)
**Code :** See the [DESCRIPTION](DESCRIPTION) file
**Data :** [CC-0](http://creativecommons.org/publicdomain/zero/1.0/) attribution requested in reuse
### Contributions
We welcome contributions from everyone. Before you get started, please see our [contributor guidelines](CONTRIBUTING.md). Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.