Welcome

This is the online home of Geocomputation with R, a book on geographic data analysis, visualization and modeling.

The geocompr book cover

Note: The first edition of the book has been published by CRC Press in the R Series. You can buy the book from CRC Press, or Amazon, and see the archived first edition on the open source book platform bookdown.org.

Inspired by bookdown and the Free and Open Source Software for Geospatial (FOSS4G) movement, this book is open source. This ensures its contents are reproducible and publicly accessible for people worldwide.

The online version of the book is hosted at geocompr.robinlovelace.net and kept up-to-date by GitHub Actions, which provides information on its ‘build status’ as follows:

Actions

This version of the book was built on GH Actions on 2021-11-23.

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

How to contribute?

bookdown makes editing a book as easy as editing a wiki, provided you have a GitHub account (sign-up at github.com). Once logged-in to GitHub, click on the ‘Edit this page’ icon in the right panel of the book website. This will take you to an editable version of the the source R Markdown file that generated the page you’re on.

To raise an issue about the book’s content (e.g. code not running) or make a feature request, check-out the issue tracker.

Maintainers and contributors must follow this repository’s CODE OF CONDUCT.

Reproducibility

The quickest way to reproduce the contents of the book if you’re new to geographic data in R may be in the web browser, thanks to Binder. Clicking on the link below should open a new window containing RStudio Server in your web browser, enabling you to open chapter files and running code chunks to test that the code is reproducible.

Binder

If you see something like the image below, congratulations, it’s worked and you can start exploring Geocomputation with R in a cloud-based environment (while being aware of mybinder.org user guidelines):

Screenshot of reproducible code contained in Geocomputation with R running in RStudio Server on a browser served by Binder

FIGURE 0.1: Screenshot of reproducible code contained in Geocomputation with R running in RStudio Server on a browser served by Binder

To reproduce the code in the book on your own computer, you need a recent version of R and up-to-date packages. These can be installed using the remotes package.

install.packages("remotes")
remotes::install_github("geocompr/geocompkg")
remotes::install_github("nowosad/spData")
remotes::install_github("nowosad/spDataLarge")

# During development work on the 2nd edition you may also need dev versions of
# other packages to build the book, e.g.,:
remotes::install_github("rspatial/terra")
remotes::install_github("mtennekes/tmap")

After installing the book’s dependencies, you should be able to reproduce code chunks in each of the book’s chapters. If you clone the book’s repo and navigate into the geocompr folder, you should be able to reproduce the contents with the following command:

bookdown::serve_book()

See the project’s GitHub repo for details on reproducing the book.

Supporting the project

If you find the book useful, please support it by:

Further details can be found at github.com/Robinlovelace/geocompr.


The globe icon used in this book was created by Jean-Marc Viglino and is licensed under CC-BY 4.0 International.