-
Notifications
You must be signed in to change notification settings - Fork 7
/
abstract_Rpackaging.Rmd
36 lines (24 loc) · 3 KB
/
abstract_Rpackaging.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
---
title: "Developing R packages"
author:
- Sophie Schmidt <<[email protected]>>, DAI
- Petr Pajdla <<[email protected]>>, UAM MUNI
- Clemens Schmid <<[email protected]>>, MPI-SHH
output: pdf_document
bibliography: references.bib
geometry: "left=2cm,right=2cm,top=0cm,bottom=1cm"
---
"Other" session proposal for CAA2021, Cyprus
Organised by the CAA *Scientific Scripting Languages in Archaeology* special interest group ([SIG SSLA](https://sslarch.github.io/))
## Abstract
A growing number of researchers use the scripting language R [@R] for scientific data analysis. Many organise their code in scripts and functions to perform sequences of data manipulation, statistics and visualisation. Sometimes these workflows gain in complexity and it becomes feasible to outsource core components into a dedicated R package. Packages are one of the best ways to make R code reproducible as they provide a well established structure to share functions, data and their documentation with other R-users. The vast numbers of packages by diverse developers on the Comprehensive R Archive Network ([CRAN](https://cran.r-project.org/)) indicate their popularity in the scientific community and they could very well become a pillar of scientific progress in archaeology [@Schmidt2020]. Indeed more and more packages are also being developed by and for archaeologists (e.g. <http://open-archaeo.info>).
For CAA2021 we would like to offer a workshop to teach R-users how to develop R packages from their scripts. We believe that many archaeological R-users do not engage in package development as they lack training and the learning curve *seems* steep. We will try to fill this gap and offer a low-level introduction to R package development for users with basic R-skills.
This workshop is designed in tandem with the session *"Tools for the Revolution: developing packages for scientific programming in archaeology"* by the SIG SSLA.
### Therefore:
- Do you use the scientific scripting language R for your analyses?
- Do you, too, now have a number of script files flying about and don't know how to organise them?
Join us and learn how to create an R-package!
In this workshop we will focus on the main points in Hadley Wickham's book on package development [@wickham_2020, <https://r-pkgs.org>] and create an example application together. Workshop attendees will get to know a structured workflow, which will aid them in organizing their personal scripts afterwards.
Basic topics will include: Package setup, function documentation and development cycle. As every package should come with example data, we will show how to implement these into a package, as well as more detailed function explanations within a vignette. Testing routines and licensing for publication, e.g. using git ([Github](https://github.com/), [Gitlab](https://gitlab.com/) or similar) will enable attendees to share their work safely.
Basic R knowledge is strongly recommended for the workshop. Software requirements will be announced to registered attendees later.
## References