https://github.com/rspatial/terra
R package for spatial data handling https://rspatial.github.io/terra/reference/terra-package.html
https://github.com/rspatial/terra
geospatial r r-package raster spatial vector
Last synced: 25 days ago
JSON representation
R package for spatial data handling https://rspatial.github.io/terra/reference/terra-package.html
- Host: GitHub
- URL: https://github.com/rspatial/terra
- Owner: rspatial
- License: gpl-3.0
- Created: 2018-09-14T05:45:27.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-05-10T11:22:50.000Z (29 days ago)
- Last Synced: 2025-05-10T11:47:56.654Z (28 days ago)
- Topics: geospatial, r, r-package, raster, spatial, vector
- Language: C++
- Homepage:
- Size: 210 MB
- Stars: 566
- Watchers: 26
- Forks: 96
- Open Issues: 50
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - rspatial/terra - R package for spatial data handling https://rspatial.github.io/terra/reference/terra-package.html (C++)
README
# terra 
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).
[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).
`terra` replaces the [raster](https://github.com/rspatial/raster) package. The interfaces of `terra` and `raster` are similar, but `terra` is simpler, faster and can do more.
## 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.