# ds4psy

Welcome to the R package ds4psy — a software companion to the book and course
Data Science for Psychologists.

This R package provides datasets and functions used in the book and course. Its source code is hosted at https://github.com/hneth/ds4psy.

The book and course introduce the principles and methods of data science for students of psychology and other biological or social sciences. The book is available at https://bookdown.org/hneth/ds4psy/.

## Description

The ds4psy book and course provide an introduction to data science that is tailored to the needs of psychologists, 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.

The R package ds4psy 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 at https://CRAN.R-project.org/package=ds4psy:

    install.packages('ds4psy')  # install ds4psy from CRAN client
    library('ds4psy')           # load to use the package

The current development version can be installed from its GitHub repository at https://github.com/hneth/ds4psy/:

    # install.packages('devtools')  # (if not installed yet)
    devtools::install_github('hneth/ds4psy')
    library('ds4psy')  # load to use the package

## 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/.

- The current R package is available at https://CRAN.R-project.org/package=ds4psy.

- For source versions, there are two GitHub repositories to be distinguished:

  - The repository for the ds4psy book is https://github.com/hneth/ds4psy (with an additional suffix `_book`).

  - The repository for the ds4psy package is https://github.com/hneth/ds4psy.

## About

If you find these materials useful, or want to adopt or alter them for your purposes, please let me know.

### Citation

To cite ds4psy in derivations and publications, please use:

- Neth, H. (2022). ds4psy: Data Science for Psychologists.
  Social Psychology and Decision Sciences, University of Konstanz, Germany.
  Textbook and R package (version 0.9.0, October 20, 2022).
  Retrieved from https://bookdown.org/hneth/ds4psy/.
  https://doi.org/10.5281/zenodo.7229812

A BibTeX entry for LaTeX users is:

    @Manual{ds4psy,
      title = {ds4psy: Data Science for Psychologists},
      author = {Hansjörg Neth},
      year = {2022},
      organization = {Social Psychology and Decision Sciences, University of Konstanz},
      address = {Konstanz, Germany},
      note = {Textbook and R package (version 0.9.0, October 20, 2022)},
      url = {https://bookdown.org/hneth/ds4psy/},
      doi = {10.5281/zenodo.7229812}
    }

### License

Data science for psychologists (ds4psy) by Hansjörg Neth is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

[Updated 2023-09-15 by hn.]