learnrbook

R package supporting the book _Learn R: As a Language_

https://github.com/aphalo/learnrbook-pkg

Keywords

Repository

R package supporting the book _Learn R: As a Language_

README.Rmd

---
output:
  github_document:
    html_preview: TRUE
---

```{r readme-01, echo = FALSE}
knitr::opts_chunk$set(
  fig.asp = 2/3,
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-"
)
```

# learnrbook 

[![cran version](https://www.r-pkg.org/badges/version/learnrbook)](https://cran.r-project.org/package=learnrbook)
[![cran checks](https://badges.cranchecks.info/worst/learnrbook.svg)](https://cran.r-project.org/web/checks/check_results_learnrbook.html)
[![ggpmisc status badge](https://aphalo.r-universe.dev/badges/learnrbook)](https://aphalo.r-universe.dev/learnrbook)

[![](https://img.shields.io/badge/doi-10.32614/CRAN.package.learnrbook-blue.svg)](https://doi.org/10.32614/CRAN.package.learnrbook)

## Purpose

Package 'learnrbook' contains data in R objects and in foreign files, the R scripts used in examples and R code from all code chunks from the second edition of the book ***Learn R: As a Language*** by Pedro J. Aphalo, New York: Chapman and Hall/CRC, 2024, ISBN 9781032516998 (pbk); ISBN 9781032518435 (hbk); ISBN 9781003404187 (ebk); DOI [ 10.1201/9781003404187](https://doi.org/10.1201/9781003404187) and also from the first edition of 2020, ISBN 9780367182533 (pbk); ISBN 9780367182557 (hbk); ISBN 9780429060342 (ebk); DOI [10.1201/9780429060342](https://doi.org/10.1201/9780429060342).

This package also exports as character vectors the names of the packages used in the book, so as to make it easier to install them.

## The book "Learn R: As a Language" 1ed and 2ed

![](man/figures/cover-small-1ed.png){width="20%"}
![](man/figures/cover-small-2ed.jpg){width="30%"}

Learning a computer language like R can be either frustrating, fun or boring. Having fun requires challenges that wake up the learner's curiosity but also provide an emotional reward for overcoming them. The book is designed so that it includes smaller and bigger challenges, in what I call playgrounds, in the hope that all readers will enjoy their path to R fluency. Fluency in the use of a language is a skill that is acquired through practice and exploration. For students and professionals in the biological sciences, humanities and many applied fields, recognizing the parallels between R and natural languages should help them feel at home with R. The approach I use is similar to that of a travel guide, encouraging exploration and describing the available alternatives and how to reach them. The intention is to guide the reader through the R landscape of 2024 and beyond.

**Aphalo P J**. 2024. *Learn R: As a Language.* CRC/Taylor & Francis Ltd. 364 pp. ISBN 9781032516998 (Paperback), ISBN 9781032518435 (Hardback), ISBN 9781003404187 (eBook).

**Aphalo P J**. 2020. *Learn R: As a Language.* CRC/Taylor & Francis Ltd. 364 pp. ISBN 9780367182533 (Paperback), ISBN 9780367182557 (Hardback), ISBN 9780429060342 (eBook).

Information about the book and its contents is available at [https://www.learnr-book.info/](https://www.learnr-book.info/).

**Pedro J. Aphalo** is a PhD graduate from the University of Edinburgh, currently a Senior Lecturer at the University of Helsinki. A plant biologist and agriculture scientist with a passion for data, electronics, computers and photography in addition to plants. A user of R for more than 25 years, who first organized an R course for MSc students 22 years ago and the author and maintainer of 13 R packages currently in CRAN.

ORCID: [0000-0003-3385-972X](https://orcid.org/0000-0003-3385-972X "public ORCID profile")

## Updates

Please see the NEWS file for information on changes.

## Installation

Installation of the most recent stable version from CRAN:

```{r cran-installation, eval=FALSE}
install.packages("learnrbook")
```

Installation of the most recent development version from a CRAN-like repository at the [R-Universe](https://aphalo.r-universe.dev/):

```{r r-universe-installation, eval=FALSE}
install.packages('learnrbook', 
                 repos = c('https://aphalo.r-universe.dev', 
                           'https://cloud.r-project.org'))
```

Installation of the current unstable version from GitHub (from sources only):

```{r github-installation, eval=FALSE}
# install.packages("remotes")
remotes::install_github("aphalo/learnrbook-pkg")
```

## Documentation

HTML documentation is available at .

The User Guide shows how to access example code, scripts and data, and how to install the packages used in the book. The user guide is included as a vignette in this package and also available at .

News about updates are posted at .

## Contributing to the package

Please report bugs and request new features at  . Pull requests are welcome at .

## Contributing to the book

The book manuscript itself is in a public Git repository and suggestions for improvements are very welcome. They will be listed as errata and incorporated into the 2nd and later editions and acknowledged. Please, report errors, unclear text passages, and outdated code examples at . Pull requests are welcome at .

## Citation

If you use this package to produce scientific or commercial publications, please cite according to:

```{r}
citation("learnrbook")
```

## License

© 2018-2024 Pedro J. Aphalo ([pedro.aphalo\@helsinki.fi](mailto:pedro.aphalo@helsinki.fi)). Released under the GPL, version 2 or greater. This software carries no warranty of any kind.

Owner

GitHub Events

Issues and Pull Requests

Last synced: 7 months ago

Packages