class: center, middle, inverse, title-slide # Collaboration made easy through reproducible research practice ### Julia Romanowska ### Sept 1., 2021 --- class: centre, top <img src="word_cloud_open_science.png", style="width: 60%;"> -- ## WHY BOTHER? --- class: middle, center <img src="OpenStreetMap.png" style="width: 100%;"> --- class: middle, center <img src="path_gone_wrong.png" style="width: 100%;"> --- class: middle, center <img src="path_ok.png" style="width: 100%;"> --- ## It's all about ~~us~~ the data - if we don't _document, organize, keep track and inform about the changes_: - nobody else can help us - nobody else can continue our work *(bus factor)* - nobody will trust and use our method or cite our paper --- class: inverse, middle, left ## What should we do? --- ## 1. organize - good directory structure https://slides.djnavarro.net/project-structure - consistent file naming machine readable _and_ human friendly [Check this presentation by Jenny Bryan](http://www2.stat.duke.edu/~rcs46/lectures_2015/01-markdown-git/slides/naming-slides/naming-slides.pdf) - structured datasets - <svg aria-hidden="true" role="img" viewBox="0 0 576 512" style="height:1em;width:1.12em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:navy;overflow:visible;position:relative;"><path d="M542.22 32.05c-54.8 3.11-163.72 14.43-230.96 55.59-4.64 2.84-7.27 7.89-7.27 13.17v363.87c0 11.55 12.63 18.85 23.28 13.49 69.18-34.82 169.23-44.32 218.7-46.92 16.89-.89 30.02-14.43 30.02-30.66V62.75c.01-17.71-15.35-31.74-33.77-30.7zM264.73 87.64C197.5 46.48 88.58 35.17 33.78 32.05 15.36 31.01 0 45.04 0 62.75V400.6c0 16.24 13.13 29.78 30.02 30.66 49.49 2.6 149.59 12.11 218.77 46.95 10.62 5.35 23.21-1.94 23.21-13.46V100.63c0-5.29-2.62-10.14-7.27-12.99z"/></svg> [How to create good datasets, even in Excel](https://www.tandfonline.com/doi/full/10.1080/00031305.2017.1375989) - <svg aria-hidden="true" role="img" viewBox="0 0 576 512" style="height:1em;width:1.12em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:navy;overflow:visible;position:relative;"><path d="M542.22 32.05c-54.8 3.11-163.72 14.43-230.96 55.59-4.64 2.84-7.27 7.89-7.27 13.17v363.87c0 11.55 12.63 18.85 23.28 13.49 69.18-34.82 169.23-44.32 218.7-46.92 16.89-.89 30.02-14.43 30.02-30.66V62.75c.01-17.71-15.35-31.74-33.77-30.7zM264.73 87.64C197.5 46.48 88.58 35.17 33.78 32.05 15.36 31.01 0 45.04 0 62.75V400.6c0 16.24 13.13 29.78 30.02 30.66 49.49 2.6 149.59 12.11 218.77 46.95 10.62 5.35 23.21-1.94 23.21-13.46V100.63c0-5.29-2.62-10.14-7.27-12.99z"/></svg> [How to share data with a statistician](https://amstat.tandfonline.com/doi/full/10.1080/00031305.2017.1375987) --- ## 2. document - `README` files are essential - maintain a change log - comment the code/scripts - if using R, `Rmarkdown` is highly recommended! - keep digital notebook/blog --- ## 3. track changes - with 1. and 2. tracking changes is easy - and/or use `git` --- ## 4. share information - don't just dump the data - **meta-data** is just as important - http://goodtables.io/ - checking data - <svg aria-hidden="true" role="img" viewBox="0 0 576 512" style="height:1em;width:1.12em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:navy;overflow:visible;position:relative;"><path d="M542.22 32.05c-54.8 3.11-163.72 14.43-230.96 55.59-4.64 2.84-7.27 7.89-7.27 13.17v363.87c0 11.55 12.63 18.85 23.28 13.49 69.18-34.82 169.23-44.32 218.7-46.92 16.89-.89 30.02-14.43 30.02-30.66V62.75c.01-17.71-15.35-31.74-33.77-30.7zM264.73 87.64C197.5 46.48 88.58 35.17 33.78 32.05 15.36 31.01 0 45.04 0 62.75V400.6c0 16.24 13.13 29.78 30.02 30.66 49.49 2.6 149.59 12.11 218.77 46.95 10.62 5.35 23.21-1.94 23.21-13.46V100.63c0-5.29-2.62-10.14-7.27-12.99z"/></svg> [what is 'good data'?](https://frictionlessdata.io/introduction/) - https://create.frictionlessdata.io/ - app to help annotate datasets --- background-image: url("johannes-plenio-sPt5RIjKfpk-unsplash.jpg") background-size: cover Photo by <a href="https://unsplash.com/@jplenio?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Johannes Plenio</a> on <a href="https://unsplash.com/collections/11649432/landscape?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Unsplash</a>