Welcome
This is the online home of Geocomputation with R, a book on geographic data analysis, visualization and modeling.
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 hosted on bookdown.org.
Inspired by the Free and Open Source Software for Geospatial (FOSS4G) movement, the code and prose underlying this book are open, ensuring that the content is reproducible, transparent, and accessible. Hosting the source code on GitHub allows anyone to interact with the project by opening issues or contributing new content and typo fixes for the benefit of everyone.
The online version of the book is hosted at geocompr.robinlovelace.net and kept up-to-date by GitHub Actions. Its current ‘build status’ as follows:
This version of the book was built on GH Actions on 2022-08-09.
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.
If you see something like the image below, congratulations, it worked! You can start exploring Geocomputation with R in a cloud-based environment, noting mybinder.org user guidelines):
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")After installing the book’s dependencies, you can rebuild the book for testing and educational purposes.
To do this download and unzip or clone the book’s source code.
After opening the geocompr.Rproj project in RStudio (or opening the folder in another IDE such as VS Code), you should be able to reproduce the contents with the following command:
bookdown::serve_book(".")See the project’s GitHub repo for full details on reproducing the book.
Supporting the project
If you find the book useful, please support it by:
- Telling people about it in person
- Communicating about the book in digital media, e.g., via the #geocompr hashtag on Twitter (see our Guestbook at geocompr.github.io) or by letting us know of courses using the book
- Citing or linking-to it
- ‘Starring’ the geocompr GitHub repository
- Reviewing it, e.g., on Amazon or Goodreads
- Asking questions about or making suggestion on the content via GitHub or Twitter.
- Buying a copy
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.
