-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathREADME.Rmd
254 lines (156 loc) · 12.8 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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit THIS (Rmd) file. -->
<!-- Devel badges start: -->
[](https://CRAN.R-project.org/package=ds4psy)
[](https://www.r-pkg.org/pkg/ds4psy)
[](https://doi.org/10.5281/zenodo.7229812)
<!-- Devel badges end. -->
<!-- Release badges start: -->
<!-- [](https://CRAN.R-project.org/package=ds4psy) -->
<!-- [](https://www.r-pkg.org/pkg/ds4psy) -->
<!-- [](https://doi.org/10.5281/zenodo.7229812) -->
<!-- Release badges end. -->
<!-- ALL status badges:
[](https://CRAN.R-project.org/package=ds4psy)
[](https://travis-ci.org/hneth/ds4psy)
[](https://www.r-pkg.org/pkg/ds4psy)
[](https://www.r-pkg.org/pkg/ds4psy)
[](https://www.rdocumentation.org/packages/ds4psy)
-->
```{r setup, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>"
)
```
<!-- ds4psy logo 1: -->
<!-- <a href="https://bookdown.org/hneth/ds4psy/"> -->
<!-- <img src = "./inst/images/logo.png" alt = "ds4psy" width = "150px" align = "right" style = "width: 150px; float: right; border:11;"/> -->
<!-- </a> -->
# Data Science for Psychologists (ds4psy) <img src = "./inst/images/logo.png" align = "right" alt = "ds4psy" width = "150px" />
Welcome to the R package **ds4psy** — a software companion to the book and course [Data Science for Psychologists](https://bookdown.org/hneth/ds4psy/).
This R package provides datasets and functions used in the [ds4psy book](https://bookdown.org/hneth/ds4psy/) and corresponding course curricula.
The book and course introduce the principles and methods of data science for students of psychology and other biological or social sciences.
<!-- Description of ds4psy package: -->
<!-- All datasets and functions required for the examples and exercises of the book "Data Science for Psychologists" (by Hansjoerg Neth, Konstanz University, 2023), freely available at <https://bookdown.org/hneth/ds4psy/>. The book and course introduce principles and methods of data science to students of psychology and other biological or social sciences. The 'ds4psy' package primarily provides datasets, but also functions for data generation and manipulation (e.g., of text and time data) and graphics that are used in the book and its exercises. All functions included in 'ds4psy' are designed to be explicit and instructive, rather than efficient or elegant. -->
## Installation
The current release of **ds4psy** is available from [CRAN](https://CRAN.R-project.org/) at <https://CRAN.R-project.org/package=ds4psy>:
```{r install_CRAN, echo = TRUE, eval = FALSE}
install.packages('ds4psy') # install ds4psy from CRAN client
library('ds4psy') # load to use the package
```
The current development version of **ds4psy** can be installed from its [GitHub](https://github.com) repository at <https://github.com/hneth/ds4psy/>:
```{r install_github, echo = TRUE, eval = FALSE}
# install.packages('devtools') # (if not installed yet)
devtools::install_github('hneth/ds4psy')
library('ds4psy') # load to use the package
```
The most recent version of the [ds4psy book](https://bookdown.org/hneth/ds4psy/) is freely available at <https://bookdown.org/hneth/ds4psy/>.
## Course Coordinates
<!-- uni.kn logo, but link to SPDS: -->
<!--  -->
<a href="https://www.spds.uni-konstanz.de">
<img src = "./inst/images/uniKn_logo.png" alt = "spds.uni.kn" width = "300px" align = "right" style = "width: 300px; float: right; border:20;"/>
</a>
* PSY-15150, at the [University of Konstanz](https://www.uni-konstanz.de) is taught by [Hansjörg Neth](https://www.spds.uni-konstanz.de/hans-neth), [Social Psychology and Decision Sciences](https://www.spds.uni-konstanz.de), office\ D507
<!-- * Summer\ 2022: Mondays, 13:30–15:00, D430. -->
* The [ds4psy book](https://bookdown.org/hneth/ds4psy/) with examples and exercises is available at <https://bookdown.org/hneth/ds4psy/>
* The [ds4psy](https://CRAN.R-project.org/package=ds4psy) R package is available at <https://CRAN.R-project.org/package=ds4psy>
## Description
This book and course provide an introduction to data science that is tailored to the needs of students in psychology, but is also suitable for students of the humanities and other biological or social sciences.
This audience typically has some knowledge of statistics, but rarely an idea how data is prepared and shaped to allow for statistical testing.
By using various data types and working with many examples, we teach tools for transforming, summarizing, and visualizing data.
By keeping our eyes open for the perils of misleading representations, the book fosters fundamental skills of data literacy and cultivates reproducible research practices that enable and precede any practical use of statistics.
### Audience
Students of psychology and other social sciences are trained to analyze data. But the data they learn to work with (e.g., in courses on statistics and empirical research methods) is typically provided to them and structured in a (rectangular or "tidy") format that presupposes many steps of data processing regarding the aggregation and spatial layout of variables. When beginning to collect their own data, students inevitably struggle with these pre-processing steps which — even for experienced data scientists — tend to require more time and effort than choosing and conducting statistical tests.
This course develops the foundations of data analysis that allow students to collect data from real-world sources and transform and shape such data to answer scientific and practical questions. Although there are many good introductions to data science (e.g., [Grolemund & Wickham, 2017](https://r4ds.had.co.nz/)) they typically do not take into account the special needs — and often anxieties and reservations — of psychology students. As social scientists are not computer scientists, we introduce new concepts and commands without assuming a mathematical or computational background. Adopting a task-oriented perspective, we begin with a specific problem and then solve it with some combination of data collection, manipulation, and visualization.
### Goals
Our main goal is to develop a set of useful skills in analyzing real-world data and conducting reproducible research. Upon completing this course, you will be able to use R to read, transform, analyze, and visualize data of various types. Many interactive exercises allow students to continuously check their understanding, practice their skills, and monitor their progress.
### Requirements
This course assumes some basic familiarity with statistics and the [R](https://www.R-project.org/) programming language, but enthusiastic programming novices are also welcome.
## Resources
This package and the corresponding book are still being developed and are updated as new materials become available.
- A current version of the book is available at <https://bookdown.org/hneth/ds4psy/>.
- There are 2 GitHub repositories to be distinguished:
- The repository for the [ds4psy book](https://bookdown.org/hneth/ds4psy/) is <https://github.com/hneth/ds4psy> (with an additional suffix `_book`).
- The repository for the [ds4psy package](https://CRAN.R-project.org/package=ds4psy) is <https://github.com/hneth/ds4psy>.
<!-- - The current course syllabus and raw versions of all data files used in examples and exercises are available at <http://rpository.com/ds4psy/>. -->
## References
### Course materials
- A current version of [Data science for psychologists](https://bookdown.org/hneth/ds4psy/) is available online at
<https://bookdown.org/hneth/ds4psy/>.
The book and course was originally based on the following textbook:
- Wickham, H., & Grolemund, G. (2017). _R for data science: Import, tidy, transform, visualize, and model data._
Sebastopol, Canada: O'Reilly Media, Inc. [Available online at [https://r4ds.had.co.nz](https://r4ds.had.co.nz/).]
<!-- Add blank line. -->
### Software
Please install the following open-source programs on your computer:
- [The R Project for Statistical Computing](https://www.R-project.org/)
- [R Studio](https://posit.co/products/open-source/rstudio/) is an integrated development environment (IDE) for R.
- R packages of the [tidyverse](https://www.tidyverse.org/), [ds4psy](https://CRAN.R-project.org/package=ds4psy), and [unikn](https://CRAN.R-project.org/package=unikn):
<!-- Add blank line. -->
```{r install-pkgs, eval = FALSE, warning = FALSE}
# Tidyverse packages:
install.packages('tidyverse')
# Course packages:
install.packages('ds4psy') # datasets and functions
install.packages('unikn') # color palettes and functions
```
### Other resources
#### R manuals and books
- [R\ manuals](https://cran.r-project.org/manuals.html) and related [books](https://www.r-project.org/doc/bib/R-books.html)
- See the books on R and data science available on <https://bookdown.org>.
<!-- - Zumel, N., & Mount, J. (2014). _Practical data science with R_. Greenwich, CT: Manning Publications. -->
#### Software tools
- [Posit.co](https://posit.co/) resources: [RStudio IDE](https://posit.co/products/open-source/rstudio/), [R\ Markdown](https://rmarkdown.rstudio.com/), and various [cheat sheets](https://posit.co/resources/cheatsheets/)
- [Tidyverse](https://www.tidyverse.org/) resources: [blog](https://www.tidyverse.org/blog/) and [learn](https://www.tidyverse.org/learn/)
<!-- Add blank line. -->
- See also the link collections at the end of each chapter of the [ds4psy book](https://bookdown.org/hneth/ds4psy/).
## About
If you find these materials useful, or want to adopt or alter them for your purposes, please [let me know](https://www.spds.uni-konstanz.de/en/people).
### Citation
<!-- ds4psy logo: -->
<a href="https://bookdown.org/hneth/ds4psy/">
<img src = "./inst/images/logo.png" alt = "ds4psy" width = "150px" align = "right" style = "width: 150px; float: right; border:11;"/>
</a>
To cite **ds4psy** in derivations and publications, please use:
- Neth, H. (2023). ds4psy: Data Science for Psychologists.
Social Psychology and Decision Sciences, University of Konstanz, Germany.
Textbook and R package (version 1.0.0, September 15, 2023).
Retrieved from <https://bookdown.org/hneth/ds4psy/>.
doi\ [10.5281/zenodo.7229812](https://doi.org/10.5281/zenodo.7229812)
<!-- BibTeX reference: -->
A **BibTeX** entry for LaTeX users is:
```{r bitex-entry, echo = FALSE, eval = FALSE, highlight = FALSE}
@Manual{ds4psy,
title = {ds4psy: Data Science for Psychologists},
author = {Hansjörg Neth},
year = {2023},
organization = {Social Psychology and Decision Sciences, University of Konstanz},
address = {Konstanz, Germany},
note = {Textbook and R package (version 1.0.0, September 15, 2023)},
url = {https://bookdown.org/hneth/ds4psy/},
doi = {10.5281/zenodo.7229812}
}
```
<!-- BibTeX entry of current version: -->
```{r pkg-unicol-citation, echo = FALSE, eval = TRUE, comment = "", highlight = FALSE}
# From package citation:
x <- citation(package = 'ds4psy')
# print(x, prefix = "")
utils::toBibtex(x)
```
The stable URL of the **ds4psy** R package is <https://CRAN.R-project.org/package=ds4psy>.
### License
<!-- (a) Use online image: -->
<a rel="license" href="https://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a>
<!-- (b) Use local image: -->
<!-- <a rel="license" href="https://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src = "./images/CC_BY_NC_SA.png" /></a> -->
<!-- License text: -->
<span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">**Data science for psychologists** (**ds4psy**)</span> by <a xmlns:cc="http://creativecommons.org/ns#" href="https://neth.de" property="cc:attributionName" rel="cc:attributionURL">Hansjörg Neth</a> is licensed under a <a rel="license" href="https://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>.
------
<!-- Footer: -->
[File `README.md` updated on `r Sys.Date()`.]
<!-- eof. -->