learnrbook

cran version

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 and also from the first edition of 2020, ISBN 9780367182533 (pbk); ISBN 9780367182557 (hbk); ISBN 9780429060342 (ebk); DOI 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

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

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

Updates

Please see the NEWS file for information on changes.

Installation

Installation of the most recent stable version from CRAN:

install.packages("learnrbook")

Installation of the most recent development version from a CRAN-like repository at the R-Universe:

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):

# install.packages("remotes")
remotes::install_github("aphalo/learnrbook-pkg")

Documentation

HTML documentation is available at https://docs.r4photobiology.info/learnrbook/.

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 https://docs.r4photobiology.info/learnrbook/articles/user-guide.html.

News about updates are posted at https://www.r4photobiology.info/.

Contributing to the package

Please report bugs and request new features at https://github.com/aphalo/learnrbook-pkg/issues . Pull requests are welcome at https://github.com/aphalo/learnrbook-pkg.

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 https://github.com/aphalo/learnr-book-crc/issues. Pull requests are welcome at https://github.com/aphalo/learnr-book-crc.

Citation

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

citation("learnrbook")
#> To cite package 'learnrbook' in publications use:
#> 
#>   Aphalo P (2024). _learnrbook: Datasets for P. J. Aphalo's "Learn R"
#>   Book_. R package version 2.0.1,
#>   <https://CRAN.R-project.org/package=learnrbook>.
#> 
#>   Aphalo P (2020). _Learn R: As a Language_, series R Series. Chapman
#>   and Hall/CRC, New York. ISBN 9780367182533, doi:10.1201/9780429060342
#>   <https://doi.org/10.1201/9780429060342>,
#>   <https://www.routledge.com/Learn-R-As-a-Language/Aphalo/p/book/9780367182533>.
#> 
#> To see these entries in BibTeX format, use 'print(<citation>,
#> bibtex=TRUE)', 'toBibtex(.)', or set
#> 'options(citation.bibtex.max=999)'.

License

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