logo by Zane Dax

terra is an R package for spatial data analysis. There are tutorials at rspatial.org. See the main documentation page or the cheatsheet (webpage or pdf) for an overview of available functions.

Stack Overflow is a good place to ask questions if you get stuck. Make sure to include a simple reproducible example. But if you think you have found a bug, or if you want to request a new feature, please file an issue.

You can try tappa if want the terra functionality in Python; or you can use the C++ library to roll your own application.

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, like this:

install.packages('terra', repos='https://rspatial.r-universe.dev')

To install from source-code, first install the Rcpp package that terra depends on:

install.packages("Rcpp")

And then continue based on the OS you are using.

On Windows, you need to first install 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")

On macOS, you can use MacPorts or Homebrew.

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/")

The easy way to install terra on Ubuntu is with 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 for installation on other Linux systems --- and for possible updates/improvements on the above instructions.