logo by Zane Dax
[](https://github.com/rspatial/terra/actions/workflows/rcmdcheck.yml) [](https://cran.r-project.org/package=terra) [](https://www.r-pkg.org/pkg/terra) [](https://stackoverflow.com/questions/tagged/terra) `terra` is an *R* package for spatial data analysis. There are tutorials at [rspatial.org](https://rspatial.org/index.html). See the main [documentation page](https://rspatial.github.io/terra/reference/terra-package.html) or the cheatsheet ([webpage](https://rspatial.org/_static/terra_cheatsheet.html) or [pdf](https://rspatial.org/_static/terra_cheatsheet.pdf)) for an overview of available functions. [Stack Overflow](https://stackoverflow.com/questions/tagged/terra) is a good place to ask questions if you get stuck. Make sure to include a [simple reproducible example](https://stackoverflow.com/questions/5963269/how-to-make-a-great-r-reproducible-example). But if you think you have found a bug, or if you want to request a new feature, please file an [issue](https://github.com/rspatial/terra/issues). You can try [tappa](https://github.com/rspatial/tappa/) if want the terra functionality in Python; or you can use the C++ library to [roll your own](https://github.com/rspatial/terra/tree/master/cmdapp) application. ## Installation `terra` is available from CRAN, so you can use `install.packages("terra")` to get the current *released version*. The easiest way to use the *development version* on Windows or MacOS, is to install it from the [R-universe](https://r-universe.dev/organizations/), like this: ``` install.packages('terra', repos='https://rspatial.r-universe.dev') ``` ### From source-code To install from source-code, first install the [Rcpp](https://cran.r-project.org/web/packages/Rcpp/index.html) package that terra depends on: ``` install.packages("Rcpp") ``` And then continue based on the OS you are using. #### Windows On Windows, you need to first install [Rtools](https://cran.r-project.org/bin/windows/Rtools/) to get, among other things, a C++ compiler that *R* can use. You need the current versions of *R* and *RTools*. Then, in *R*, install terra with: ``` remotes::install_github("rspatial/terra") ``` #### macOS On macOS, you can use [MacPorts](https://www.macports.org/) or [Homebrew](https://brew.sh/). With MacPorts you can do ``` sudo port install R-terra ``` With Homebrew, you need to first install GDAL and PROJ: ``` brew install pkg-config brew install gdal proj ``` Followed by (note the additional configuration argument needed for Homebrew) ``` remotes::install_github("rspatial/terra", configure.args = "--with-proj-lib=$(brew --prefix)/lib/") ``` To install the CRAN version from source you would do ``` install.packages("terra", type = "source", configure.args = "--with-proj-lib=$(brew --prefix)/lib/") ``` #### Linux The *easy* way to install terra on Ubuntu is with [r2u](https://eddelbuettel.github.io/r2u/). The harder way: Install the system requirements GDAL (>= 2.2.3), GEOS (>= 3.4.0), PROJ (>= 4.9.3), netcdf (>=4.1.3), sqlite3, tbb ``` sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable sudo apt-get update sudo apt-get install libgdal-dev libgeos-dev libproj-dev libtbb-dev libnetcdf-dev ``` And now, in R, install the package ``` remotes::install_github("rspatial/terra") ``` See the `sf` [instructions](https://github.com/r-spatial/sf) for installation on other Linux systems --- and for possible updates/improvements on the above instructions.