From 66e322b89bdfda28a713b9b0eebeaede812bdcc4 Mon Sep 17 00:00:00 2001
From: GitHub Actions <actions@github.com>
Date: Fri, 24 May 2024 11:00:13 +0000
Subject: [PATCH] cli-40502-3903

---
 404.html                           |   2 +-
 ISSUE_TEMPLATE.html                |   2 +-
 LICENSE-text.html                  |   2 +-
 apple-touch-icon-120x120.png       | Bin 8791 -> 8791 bytes
 apple-touch-icon-152x152.png       | Bin 10982 -> 10982 bytes
 apple-touch-icon-180x180.png       | Bin 13062 -> 13062 bytes
 apple-touch-icon-60x60.png         | Bin 4145 -> 4145 bytes
 apple-touch-icon-76x76.png         | Bin 5279 -> 5279 bytes
 apple-touch-icon.png               | Bin 13062 -> 13062 bytes
 authors.html                       |   6 +++---
 favicon-16x16.png                  | Bin 1123 -> 1123 bytes
 favicon-32x32.png                  | Bin 2076 -> 2076 bytes
 index.html                         |   2 +-
 news/index.html                    |  31 ++++++++++++++++++++++++-----
 pkgdown.yml                        |   2 +-
 reference/NAflag.html              |   2 +-
 reference/RGB.html                 |   2 +-
 reference/SpatExtent-class.html    |   2 +-
 reference/SpatRaster-class.html    |   2 +-
 reference/SpatVector-class.html    |   2 +-
 reference/activeCat.html           |   2 +-
 reference/add.html                 |   2 +-
 reference/adjacent.html            |   2 +-
 reference/aggregate.html           |   2 +-
 reference/align.html               |   2 +-
 reference/all.equal.html           |   2 +-
 reference/animate.html             |   2 +-
 reference/app.html                 |   2 +-
 reference/approximate.html         |   2 +-
 reference/arith-generic.html       |   2 +-
 reference/as.character.html        |   2 +-
 reference/as.data.frame.html       |   2 +-
 reference/as.lines.html            |   2 +-
 reference/as.list.html             |   2 +-
 reference/as.points.html           |   2 +-
 reference/as.polygons.html         |   2 +-
 reference/as.raster.html           |   2 +-
 reference/atan2.html               |   2 +-
 reference/autocor.html             |   2 +-
 reference/barplot.html             |   2 +-
 reference/bestMatch.html           |   2 +-
 reference/boundaries.html          |   2 +-
 reference/box.html                 |   2 +-
 reference/boxplot.html             |   2 +-
 reference/buffer.html              |   2 +-
 reference/c.html                   |   2 +-
 reference/cartogram.html           |   2 +-
 reference/catalyze.html            |   2 +-
 reference/cellSize.html            |   2 +-
 reference/cells.html               |   2 +-
 reference/centroids.html           |   2 +-
 reference/clamp.html               |   2 +-
 reference/clamp_ts.html            |   2 +-
 reference/classify.html            |   2 +-
 reference/click.html               |   2 +-
 reference/coerce.html              |   2 +-
 reference/collapse.html            |   2 +-
 reference/colors.html              |   2 +-
 reference/combineGeoms.html        |   2 +-
 reference/compare-generics.html    |   2 +-
 reference/compareGeom.html         |   2 +-
 reference/concats.html             |   2 +-
 reference/contour.html             |   2 +-
 reference/convhull.html            |   2 +-
 reference/costDist.html            |   2 +-
 reference/cover.html               |   2 +-
 reference/crds.html                |   2 +-
 reference/crop.html                |   2 +-
 reference/crosstab.html            |   2 +-
 reference/crs.html                 |   2 +-
 reference/datatype.html            |   2 +-
 reference/deepcopy.html            |   2 +-
 reference/densify.html             |   2 +-
 reference/density.html             |   2 +-
 reference/deprecated.html          |   2 +-
 reference/depth.html               |   2 +-
 reference/describe.html            |   2 +-
 reference/diff.html                |   2 +-
 reference/dimensions.html          |   2 +-
 reference/direction.html           |   2 +-
 reference/disaggregate.html        |   2 +-
 reference/distance.html            |   2 +-
 reference/dots.html                |   2 +-
 reference/draw.html                |   2 +-
 reference/elongate.html            |   2 +-
 reference/erase.html               |   2 +-
 reference/expanse.html             |   2 +-
 reference/ext.html                 |   2 +-
 reference/extend.html              |   2 +-
 reference/extract.html             |   2 +-
 reference/extractAlong.html        |   2 +-
 reference/extractRange.html        |   2 +-
 reference/factors.html             |   2 +-
 reference/fill.html                |   2 +-
 reference/fillTime.html            |   2 +-
 reference/flip.html                |   2 +-
 reference/focal.html               |   2 +-
 reference/focal3D.html             |   2 +-
 reference/focalCpp.html            |   2 +-
 reference/focalMat.html            |   2 +-
 reference/focalPairs.html          |   2 +-
 reference/focalReg.html            |   2 +-
 reference/focalValues.html         |   2 +-
 reference/forceCCW.html            |   2 +-
 reference/freq.html                |   2 +-
 reference/gaps.html                |   2 +-
 reference/gdal.html                |   2 +-
 reference/geometry.html            |   2 +-
 reference/geomtype.html            |   2 +-
 reference/global.html              |   2 +-
 reference/graticule.html           |   2 +-
 reference/grid.html                |   2 +-
 reference/gridDist.html            |   2 +-
 reference/halo.html                |   2 +-
 reference/headtail.html            |   2 +-
 reference/hist.html                |   2 +-
 reference/identical.html           |   2 +-
 reference/ifelse.html              |   2 +-
 reference/image.html               |   2 +-
 reference/impose.html              |   2 +-
 reference/index.html               |   2 +-
 reference/init.html                |   2 +-
 reference/inplace.html             |   2 +-
 reference/inset.html               |   2 +-
 reference/interpIDW.html           |   2 +-
 reference/interpNear.html          |   2 +-
 reference/interpolate.html         |   2 +-
 reference/intersect.html           |   2 +-
 reference/is.bool.html             |   2 +-
 reference/is.empty.html            |   2 +-
 reference/is.lonlat.html           |   2 +-
 reference/is.rotated.html          |   2 +-
 reference/is.valid.html            |   2 +-
 reference/k_means.html             |   2 +-
 reference/lapp.html                |   2 +-
 reference/layerCor.html            |   2 +-
 reference/legend.html              |   2 +-
 reference/linearUnits.html         |   2 +-
 reference/lines.html               |   2 +-
 reference/makeTiles.html           |  14 ++++++-------
 reference/makeVRT.html             |   2 +-
 reference/mappal.html              |   2 +-
 reference/mask.html                |   2 +-
 reference/match.html               |   2 +-
 reference/math-generics.html       |   2 +-
 reference/mem.html                 |   8 ++++----
 reference/merge.html               |   2 +-
 reference/mergeTime.html           |   2 +-
 reference/meta.html                |   2 +-
 reference/metags.html              |   2 +-
 reference/minmax.html              |   2 +-
 reference/modal.html               |   2 +-
 reference/mosaic.html              |   2 +-
 reference/na.omit.html             |   2 +-
 reference/names.html               |   2 +-
 reference/nearby.html              |   2 +-
 reference/normalize.longitude.html |   2 +-
 reference/north.html               |   2 +-
 reference/not.na.html              |   2 +-
 reference/origin.html              |   2 +-
 reference/pairs.html               |   2 +-
 reference/panel.html               |   2 +-
 reference/patches.html             |   2 +-
 reference/perim.html               |   2 +-
 reference/persp.html               |   2 +-
 reference/plet.html                |   2 +-
 reference/plot.html                |   2 +-
 reference/plotRGB.html             |   2 +-
 reference/plot_extent.html         |   2 +-
 reference/plot_graticule.html      |   2 +-
 reference/prcomp.html              |   2 +-
 reference/predict.html             |   2 +-
 reference/princomp.html            |   2 +-
 reference/project.html             |   2 +-
 reference/quantile.html            |   2 +-
 reference/query.html               |   2 +-
 reference/rangeFill.html           |   2 +-
 reference/rapp.html                |   2 +-
 reference/rast.html                |   2 +-
 reference/rasterize.html           |   2 +-
 reference/rasterizeGeom.html       |   2 +-
 reference/rasterizeWin.html        |   2 +-
 reference/rcl.html                 |   2 +-
 reference/readwrite.html           |   2 +-
 reference/rectify.html             |   2 +-
 reference/regress.html             |   2 +-
 reference/relate.html              |   2 +-
 reference/rep.html                 |   2 +-
 reference/replace_dollar.html      |   2 +-
 reference/replace_layers.html      |   2 +-
 reference/replace_values.html      |   2 +-
 reference/resample.html            |   2 +-
 reference/rescale.html             |   2 +-
 reference/roll.html                |   2 +-
 reference/rotate.html              |   2 +-
 reference/same.crs.html            |   2 +-
 reference/sample.html              |   2 +-
 reference/sapp.html                |   2 +-
 reference/sbar.html                |   2 +-
 reference/scale.html               |   2 +-
 reference/scatter.html             |   2 +-
 reference/scoff.html               |   2 +-
 reference/sds.html                 |   2 +-
 reference/segregate.html           |   2 +-
 reference/select.html              |   2 +-
 reference/selectHigh.html          |   2 +-
 reference/selectRange.html         |   2 +-
 reference/serialize.html           |   2 +-
 reference/setValues.html           |   2 +-
 reference/shade.html               |   2 +-
 reference/sharedPaths.html         |   2 +-
 reference/shift.html               |   2 +-
 reference/sieve.html               |   2 +-
 reference/simplify.html            |   2 +-
 reference/sort.html                |   2 +-
 reference/sources.html             |   2 +-
 reference/spin.html                |   2 +-
 reference/split.html               |   2 +-
 reference/sprc.html                |   2 +-
 reference/stretch.html             |   2 +-
 reference/subset.html              |   2 +-
 reference/subset_dollar.html       |   2 +-
 reference/subset_double.html       |   2 +-
 reference/subset_single.html       |   2 +-
 reference/subst.html               |   2 +-
 reference/summarize-generics.html  |   2 +-
 reference/summary.html             |   2 +-
 reference/svc.html                 |   2 +-
 reference/symdif.html              |   2 +-
 reference/tapp.html                |   2 +-
 reference/terra-package.html       |   2 +-
 reference/terraOptions.html        |   6 +++---
 reference/terrain.html             |   2 +-
 reference/text.html                |   2 +-
 reference/time.html                |   6 +++---
 reference/tmpFile.html             |   4 ++--
 reference/topology.html            |   2 +-
 reference/transpose.html           |   2 +-
 reference/trim.html                |   2 +-
 reference/union.html               |   2 +-
 reference/unique.html              |   2 +-
 reference/units.html               |   2 +-
 reference/update.html              |   4 ++--
 reference/values.html              |   2 +-
 reference/varnames.html            |   2 +-
 reference/vect.html                |   2 +-
 reference/vector_layers.html       |   2 +-
 reference/viewshed.html            |   2 +-
 reference/voronoi.html             |   2 +-
 reference/vrt.html                 |  10 +++++-----
 reference/vrt_tiles.html           |   2 +-
 reference/weighted.mean.html       |   2 +-
 reference/where.html               |   2 +-
 reference/which.html               |   2 +-
 reference/width.html               |   2 +-
 reference/window.html              |   2 +-
 reference/wrap.html                |   2 +-
 reference/wrapCache.html           |   2 +-
 reference/writeCDF.html            |   2 +-
 reference/writeRaster.html         |   2 +-
 reference/writeVector.html         |   2 +-
 reference/xapp.html                |   2 +-
 reference/xmin.html                |   2 +-
 reference/xyCellFrom.html          |   2 +-
 reference/zonal.html               |   2 +-
 reference/zoom.html                |   2 +-
 search.json                        |   2 +-
 267 files changed, 305 insertions(+), 284 deletions(-)

diff --git a/404.html b/404.html
index b22b88bc2..e7fe9b58f 100644
--- a/404.html
+++ b/404.html
@@ -31,7 +31,7 @@
     
     <a class="navbar-brand me-2" href="https://rspatial.github.io/terra/index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/ISSUE_TEMPLATE.html b/ISSUE_TEMPLATE.html
index 0e97c2729..09417c634 100644
--- a/ISSUE_TEMPLATE.html
+++ b/ISSUE_TEMPLATE.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/LICENSE-text.html b/LICENSE-text.html
index f846dcc90..fceeb1d4b 100644
--- a/LICENSE-text.html
+++ b/LICENSE-text.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/apple-touch-icon-120x120.png b/apple-touch-icon-120x120.png
index f5036c3be52c09c8c702075f249dcc7e40e25dd4..434c937598329459683699c76a4edd22d63ea01f 100644
GIT binary patch
delta 69
zcmccaa@}P@6^8_u72gt$t<N_$DJqJXgcurFnOayGnrIssSQ!|sywK}9dAp)4hQy6t
L)1Q-HDCPqI6_FOP

delta 69
zcmccaa@}P@6^9rXr_`#n;+Y$p6ct5`LJSS83@ojT%(M-F41?Murs9*gE6QR>@XYL8
JJ^6)VJ^<yz6yyK^

diff --git a/apple-touch-icon-152x152.png b/apple-touch-icon-152x152.png
index 7980da6361e48607826ec4298bfe98a0a0f2a819..01afcdc3d06d2396df97a649ba0d1743c7304455 100644
GIT binary patch
delta 93
zcmaDB`Yd!p6^8_u75`=a*20ZV8#G-_LJSS8Of9SoO|=aStPBkJm$!XnU|>)!ag8WR
jNi0dV%FR#7OsixtGB7gHH89mRLf26D%g%RlxmG>^cTgN%

delta 93
zcmaDB`Yd!p6^9rXr}W)KXa0>%8#G;wLJSS83@ojT%(V@G41?R7?G`gIFsPQeMwFx^
imZVzc=BH$)RWcYE7@6oAnCcp#YgqNJO@4B@Rz3h_fgEH2

diff --git a/apple-touch-icon-180x180.png b/apple-touch-icon-180x180.png
index a90a20873cbe29388f3a768527b17aa23348fb78..2d286422f6c3aff48f0c1613c6586bf0d6a076a4 100644
GIT binary patch
delta 93
zcmZomYfGC@#Ua6EB@oBn(Xz4Wf}yKPh@pX%sfCrHnYMv}m4Shs|C}5K1_sp<*NBpo
j#FA92-29Zxv`Pje10xe%15;fibPfJODi<bCH_8V91R)w_

delta 93
zcmZomYfGC@#UaMUDdWs~ZOz7}3x=*nA%+H429{Pv7TN|thJo&HKQ9Ib2GtVRh?11V
il2ohQ{FKbJN(LhXBNJT%Q(Yr;4Kd5UeVaVpC?5bNiyTz|

diff --git a/apple-touch-icon-60x60.png b/apple-touch-icon-60x60.png
index 2a9de819061149ff5133e7f1ca24651ad6e6cccc..61280f2d4a3a8b22150692e79fb6743f19c9b6ab 100644
GIT binary patch
delta 69
zcmdm}uu)+`6^8_u6|XJhlh}<-zxhN=LJSS8Of9SojkOI7tPBit$~T{$Jds}(Lqb-I
KyL|E?{(Jz~-V^iy

delta 69
zcmdm}uu)+`6^9rXr-Vy}(AJGjzxhOrLJSS83@ojTOtcMv41-tEDt416^2=gK%x0U@
JH2DyJJ^;N$6Z8N8

diff --git a/apple-touch-icon-76x76.png b/apple-touch-icon-76x76.png
index 7e22e56bfea1b63a91dd396d9463f896ebca1862..0c16a757adfa9a7f6d7957d4671962bd3a364627 100644
GIT binary patch
delta 69
zcmbQQIbU-^6^8_u72gt$t<N_$WeSU!gcurFnOayGnrIssSQ!|sywK}9`M<C%hQy6t
K)1Q+KMDhXoniaYL

delta 69
zcmbQQIbU-^6^9rXr=)SdlJdr;OkokD5JLki14}C-Q*8qv!@x&JziaY;VOb0b+rsH)
IlMO`j0e3VJ_W%F@

diff --git a/apple-touch-icon.png b/apple-touch-icon.png
index 94f03cf7be1cee03d1ca0a21e7a973c5ae7ce1eb..87753f55d6f73ec8a6e6450e49b2de25ee85d2f2 100644
GIT binary patch
delta 93
zcmZomYfGC@#Ua6EC8)`;Lug~u1w&Vp5JLkiQwu9Yb8Q0yD+7ZW7SnGqFfgc=xJHzu
jB$lLF<>sekrd2W+85o)98kp)Dp=)@Vs-H4>x=}s=2UZ&(

delta 93
zcmZomYfGC@#UaMUDQm*?%xYuP1w&V(5JLki14}C-OKk%n!=Ssz^&bNRgKCLuL`h0w
iNvc(DeoAIqC4-THk%_K>sjd;ahF=%|I!&H#ln($UupF8I

diff --git a/authors.html b/authors.html
index 5e1443509..ac1fa873c 100644
--- a/authors.html
+++ b/authors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -80,13 +80,13 @@ <h2 id="citation">Citation</h2>
 
       <p>Hijmans R (2024).
 <em>terra: Spatial Data Analysis</em>.
-R package version 1.7-77, https://rspatial.github.io/terra/, <a href="https://rspatial.org/" class="external-link">https://rspatial.org/</a>. 
+R package version 1.7-79, https://rspatial.github.io/terra/, <a href="https://rspatial.org/" class="external-link">https://rspatial.org/</a>. 
 </p>
       <pre>@Manual{,
   title = {terra: Spatial Data Analysis},
   author = {Robert J. Hijmans},
   year = {2024},
-  note = {R package version 1.7-77, https://rspatial.github.io/terra/},
+  note = {R package version 1.7-79, https://rspatial.github.io/terra/},
   url = {https://rspatial.org/},
 }</pre>
     </div>
diff --git a/favicon-16x16.png b/favicon-16x16.png
index d6919d4066b5d0a86bc466833152b36159fd9764..fffee4f7b24d7797daee55fe4c343571407095f6 100644
GIT binary patch
delta 95
zcmaFN@t9*nGZTjdmzAhqZVmV5ZYC8*SCbG!11nPtD<eZ~0|P4qgVOY+j0_A6swJ)w
lB`Jv|saCo9DVb@N3`Pb<Cb|Zux<=?4Sgd6CPX5B24*<fr8A|{F

delta 95
zcmaFN@t9*nGZTjx7pJ0h?yS9=yO~rNU5!Ev4Xg|-t&EMe4S)=T$6-=>3=9maC9V-A
kDTyViR=N2pnQ4^_Mg~SEx(24YM(7$QaW9%Q`3rMC0QF89lK=n!

diff --git a/favicon-32x32.png b/favicon-32x32.png
index 305ec037d8a12ff3a41206891f6cff7716a86415..68e35995199ff03f184413c0e1d0ef5be5d3d328 100644
GIT binary patch
delta 69
zcmbOuFh^iQ6^8_umDu(a-HjWYp0SCTgcurFnOayG8EG3BSQ!|&^zWZDxrSX9L&EeD
KyTatP?D+uKCKLz&

delta 69
zcmbOuFh^iQ6^9rXr&3eOY4(jx&)7taLJSS83@ojTO|%Vw3<I@~Dhnppu*+gdgs+(+
JGkGn0J^;9u6Vw0z

diff --git a/index.html b/index.html
index 216dbf726..06c2be22c 100644
--- a/index.html
+++ b/index.html
@@ -33,7 +33,7 @@
     
     <a class="navbar-brand me-2" href="index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/news/index.html b/news/index.html
index 7613856da..ee45bbbd0 100644
--- a/news/index.html
+++ b/news/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -51,9 +51,30 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="1.7-76" id="version-17-76">version 1.7-76<a class="anchor" aria-label="anchor" href="#version-17-76"></a></h2>
+<h2 class="pkg-version" data-toc-text="1.7-79" id="version-17-79">version 1.7-79<a class="anchor" aria-label="anchor" href="#version-17-79"></a></h2>
 <div class="section level3">
-<h3 id="bug-fixes-1-7-76">bug fixes<a class="anchor" aria-label="anchor" href="#bug-fixes-1-7-76"></a></h3>
+<h3 id="bug-fixes-1-7-79">bug fixes<a class="anchor" aria-label="anchor" href="#bug-fixes-1-7-79"></a></h3>
+<ul><li>
+<code>flip(direction="vertical")</code> failed in some cases <a href="https://github.com/rspatial/terra/issues/1518" class="external-link">#1518</a> by Ed Carnell</li>
+<li>
+<code>zonal(as.raster=TRUE)</code> failed when the zonal raster was categorical <a href="https://github.com/rspatial/terra/issues/1514" class="external-link">1514</a> by Jessi L Brown</li>
+</ul></div>
+<div class="section level3">
+<h3 id="enhancements-1-7-79">enhancements<a class="anchor" aria-label="anchor" href="#enhancements-1-7-79"></a></h3>
+<ul><li>
+<code>as.list&lt;SpatRasterDataset&gt;</code> sets the names of the list <a href="https://github.com/rspatial/terra/issues/1513" class="external-link">#1513</a>
+</li>
+<li>a SpatVectorCollection can now be subsetted with the names; and if made from a list it takes the names from the list. <a href="https://github.com/rspatial/terra/issues/1515" class="external-link">1515</a> by jedgroev</li>
+</ul></div>
+<div class="section level3">
+<h3 id="new-1-7-79">new<a class="anchor" aria-label="anchor" href="#new-1-7-79"></a></h3>
+</div>
+</div>
+    <div class="section level2">
+<h2 class="pkg-version" data-toc-text="1.7-78" id="version-17-78">version 1.7-78<a class="anchor" aria-label="anchor" href="#version-17-78"></a></h2><p class="text-muted">CRAN release: 2024-05-22</p>
+<p>Released 2023-05-22</p>
+<div class="section level3">
+<h3 id="bug-fixes-1-7-78">bug fixes<a class="anchor" aria-label="anchor" href="#bug-fixes-1-7-78"></a></h3>
 <ul><li>
 <code>writeVector</code> and <code>readVector</code> better handle empty geopackage layers <a href="https://github.com/rspatial/terra/issues/1426" class="external-link">#1426</a> by Andrew Gene Brown.</li>
 <li>
@@ -80,7 +101,7 @@ <h3 id="bug-fixes-1-7-76">bug fixes<a class="anchor" aria-label="anchor" href="#
 <code>ext&lt;SpatVectorProxy&gt;</code> did not return the full extent <a href="https://github.com/rspatial/terra/issues/1501" class="external-link">#1501</a> by erkent-carb</li>
 </ul></div>
 <div class="section level3">
-<h3 id="enhancements-1-7-76">enhancements<a class="anchor" aria-label="anchor" href="#enhancements-1-7-76"></a></h3>
+<h3 id="enhancements-1-7-78">enhancements<a class="anchor" aria-label="anchor" href="#enhancements-1-7-78"></a></h3>
 <ul><li>
 <code>extract</code> has new argument “small=TRUE” to allow for strict use of “touches=FALSE” <a href="https://github.com/rspatial/terra/issues/1419" class="external-link">#1419</a> by Floris Vanderhaeghe.</li>
 <li>
@@ -96,7 +117,7 @@ <h3 id="enhancements-1-7-76">enhancements<a class="anchor" aria-label="anchor" h
 <code>as.list&lt;SpatRasterDataset&gt;</code> now returns a named list. <a href="https://github.com/rspatial/terra/issues/1513" class="external-link">#1513</a> by Eric R. Scott</li>
 </ul></div>
 <div class="section level3">
-<h3 id="new-1-7-76">new<a class="anchor" aria-label="anchor" href="#new-1-7-76"></a></h3>
+<h3 id="new-1-7-78">new<a class="anchor" aria-label="anchor" href="#new-1-7-78"></a></h3>
 <ul><li>
 <code>bestMatch&lt;SpatRaster&gt;</code> method</li>
 <li>argument “pairs=TRUE” to <code>cells</code> <a href="https://github.com/rspatial/terra/issues/1487" class="external-link">https://github.com/rspatial/terra/issues/1487</a> by Floris Vanderhaeghe</li>
diff --git a/pkgdown.yml b/pkgdown.yml
index 27fc0587a..dae79739b 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -2,7 +2,7 @@ pandoc: 3.1.11
 pkgdown: 2.0.9
 pkgdown_sha: ~
 articles: {}
-last_built: 2024-05-22T10:09Z
+last_built: 2024-05-24T10:58Z
 urls:
   reference: https://rspatial.github.io/terra/reference
   article: https://rspatial.github.io/terra/articles
diff --git a/reference/NAflag.html b/reference/NAflag.html
index 5cdbdb2f0..fe4711594 100644
--- a/reference/NAflag.html
+++ b/reference/NAflag.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/RGB.html b/reference/RGB.html
index a221e24b1..b85bc0789 100644
--- a/reference/RGB.html
+++ b/reference/RGB.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SpatExtent-class.html b/reference/SpatExtent-class.html
index 6b228902d..7128c6985 100644
--- a/reference/SpatExtent-class.html
+++ b/reference/SpatExtent-class.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SpatRaster-class.html b/reference/SpatRaster-class.html
index 7dcb03f94..21d9bf37b 100644
--- a/reference/SpatRaster-class.html
+++ b/reference/SpatRaster-class.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/SpatVector-class.html b/reference/SpatVector-class.html
index 1b2aa9486..0b8f65aac 100644
--- a/reference/SpatVector-class.html
+++ b/reference/SpatVector-class.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/activeCat.html b/reference/activeCat.html
index 5f44ab3c1..177c8b6bd 100644
--- a/reference/activeCat.html
+++ b/reference/activeCat.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add.html b/reference/add.html
index 835b57fc3..7009e717c 100644
--- a/reference/add.html
+++ b/reference/add.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/adjacent.html b/reference/adjacent.html
index 8e70cfae4..f88e48e85 100644
--- a/reference/adjacent.html
+++ b/reference/adjacent.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/aggregate.html b/reference/aggregate.html
index 8fee5f4f9..72623a98f 100644
--- a/reference/aggregate.html
+++ b/reference/aggregate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/align.html b/reference/align.html
index 1fde4e944..ac6e9fd13 100644
--- a/reference/align.html
+++ b/reference/align.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/all.equal.html b/reference/all.equal.html
index 25cf37b39..ba10a384a 100644
--- a/reference/all.equal.html
+++ b/reference/all.equal.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/animate.html b/reference/animate.html
index d5a72c67d..dfed4502e 100644
--- a/reference/animate.html
+++ b/reference/animate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/app.html b/reference/app.html
index 95333ce13..6813bee53 100644
--- a/reference/app.html
+++ b/reference/app.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/approximate.html b/reference/approximate.html
index c816fb40c..1166cfb4f 100644
--- a/reference/approximate.html
+++ b/reference/approximate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/arith-generic.html b/reference/arith-generic.html
index a644e5200..3de8b2af2 100644
--- a/reference/arith-generic.html
+++ b/reference/arith-generic.html
@@ -20,7 +20,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.character.html b/reference/as.character.html
index 4e22e5a48..7e4ba6cad 100644
--- a/reference/as.character.html
+++ b/reference/as.character.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.data.frame.html b/reference/as.data.frame.html
index d4ea636ed..ed449e88a 100644
--- a/reference/as.data.frame.html
+++ b/reference/as.data.frame.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.lines.html b/reference/as.lines.html
index c48dc4b2c..89143a1bc 100644
--- a/reference/as.lines.html
+++ b/reference/as.lines.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.list.html b/reference/as.list.html
index 80a02e528..652873e9f 100644
--- a/reference/as.list.html
+++ b/reference/as.list.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.points.html b/reference/as.points.html
index e6fdba4b4..b8f64854d 100644
--- a/reference/as.points.html
+++ b/reference/as.points.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.polygons.html b/reference/as.polygons.html
index b9092c8f5..73f90de66 100644
--- a/reference/as.polygons.html
+++ b/reference/as.polygons.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.raster.html b/reference/as.raster.html
index b91785fca..2a22f8978 100644
--- a/reference/as.raster.html
+++ b/reference/as.raster.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/atan2.html b/reference/atan2.html
index 439a1522f..df49171b3 100644
--- a/reference/atan2.html
+++ b/reference/atan2.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/autocor.html b/reference/autocor.html
index a33ad144c..26674ca1b 100644
--- a/reference/autocor.html
+++ b/reference/autocor.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/barplot.html b/reference/barplot.html
index aa3c46e4e..b97d30ca3 100644
--- a/reference/barplot.html
+++ b/reference/barplot.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/bestMatch.html b/reference/bestMatch.html
index 6a7085881..65adfa56b 100644
--- a/reference/bestMatch.html
+++ b/reference/bestMatch.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/boundaries.html b/reference/boundaries.html
index 1614a96ea..ea36ca907 100644
--- a/reference/boundaries.html
+++ b/reference/boundaries.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/box.html b/reference/box.html
index bdb0aaf8c..0e899b1e9 100644
--- a/reference/box.html
+++ b/reference/box.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/boxplot.html b/reference/boxplot.html
index ed032e7e5..36fff4013 100644
--- a/reference/boxplot.html
+++ b/reference/boxplot.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/buffer.html b/reference/buffer.html
index f7412a56c..130c109d7 100644
--- a/reference/buffer.html
+++ b/reference/buffer.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/c.html b/reference/c.html
index 5325e74d7..2bfcb58d7 100644
--- a/reference/c.html
+++ b/reference/c.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/cartogram.html b/reference/cartogram.html
index 3a356ace8..ce7b7d444 100644
--- a/reference/cartogram.html
+++ b/reference/cartogram.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/catalyze.html b/reference/catalyze.html
index d53b10b71..177fa316b 100644
--- a/reference/catalyze.html
+++ b/reference/catalyze.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/cellSize.html b/reference/cellSize.html
index f86c42e5f..99d820e67 100644
--- a/reference/cellSize.html
+++ b/reference/cellSize.html
@@ -20,7 +20,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/cells.html b/reference/cells.html
index 95674210c..51034fe2f 100644
--- a/reference/cells.html
+++ b/reference/cells.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/centroids.html b/reference/centroids.html
index 9639f81a9..1bb4d69db 100644
--- a/reference/centroids.html
+++ b/reference/centroids.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/clamp.html b/reference/clamp.html
index 4540fa858..50f2dc1f2 100644
--- a/reference/clamp.html
+++ b/reference/clamp.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/clamp_ts.html b/reference/clamp_ts.html
index 89910b4f2..2b12e1833 100644
--- a/reference/clamp_ts.html
+++ b/reference/clamp_ts.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/classify.html b/reference/classify.html
index 87b9f00a1..9c6bc4627 100644
--- a/reference/classify.html
+++ b/reference/classify.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/click.html b/reference/click.html
index b6702449c..f718edb0a 100644
--- a/reference/click.html
+++ b/reference/click.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/coerce.html b/reference/coerce.html
index 2dd3d121b..fc623aa49 100644
--- a/reference/coerce.html
+++ b/reference/coerce.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/collapse.html b/reference/collapse.html
index 623dc68fb..e018a892a 100644
--- a/reference/collapse.html
+++ b/reference/collapse.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/colors.html b/reference/colors.html
index 288398b6a..ab6e832b7 100644
--- a/reference/colors.html
+++ b/reference/colors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/combineGeoms.html b/reference/combineGeoms.html
index d3631b716..6514e29b4 100644
--- a/reference/combineGeoms.html
+++ b/reference/combineGeoms.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/compare-generics.html b/reference/compare-generics.html
index 4742af271..fc1147829 100644
--- a/reference/compare-generics.html
+++ b/reference/compare-generics.html
@@ -28,7 +28,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/compareGeom.html b/reference/compareGeom.html
index c3be42c87..a2cc2a757 100644
--- a/reference/compareGeom.html
+++ b/reference/compareGeom.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/concats.html b/reference/concats.html
index 1b3957f24..be87ce1a8 100644
--- a/reference/concats.html
+++ b/reference/concats.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/contour.html b/reference/contour.html
index 6bc8f4e8a..d9f268f77 100644
--- a/reference/contour.html
+++ b/reference/contour.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/convhull.html b/reference/convhull.html
index 0b40bc9bc..907fd033e 100644
--- a/reference/convhull.html
+++ b/reference/convhull.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/costDist.html b/reference/costDist.html
index 4726c377f..1e3226da7 100644
--- a/reference/costDist.html
+++ b/reference/costDist.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/cover.html b/reference/cover.html
index d967cf7f5..3e1ad7291 100644
--- a/reference/cover.html
+++ b/reference/cover.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/crds.html b/reference/crds.html
index d3e05f1e0..4db89d53a 100644
--- a/reference/crds.html
+++ b/reference/crds.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/crop.html b/reference/crop.html
index 1c73ecc25..e06c4a3f3 100644
--- a/reference/crop.html
+++ b/reference/crop.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/crosstab.html b/reference/crosstab.html
index 3c1d935c8..eb35c3fc9 100644
--- a/reference/crosstab.html
+++ b/reference/crosstab.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/crs.html b/reference/crs.html
index 4b919020c..2c27ba5cf 100644
--- a/reference/crs.html
+++ b/reference/crs.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/datatype.html b/reference/datatype.html
index f704755f5..679d55a7a 100644
--- a/reference/datatype.html
+++ b/reference/datatype.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/deepcopy.html b/reference/deepcopy.html
index 41721436f..265655f9e 100644
--- a/reference/deepcopy.html
+++ b/reference/deepcopy.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/densify.html b/reference/densify.html
index 47afd9e2c..1e291d4ef 100644
--- a/reference/densify.html
+++ b/reference/densify.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/density.html b/reference/density.html
index 0b11e0830..b159a408a 100644
--- a/reference/density.html
+++ b/reference/density.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/deprecated.html b/reference/deprecated.html
index ea91d0b91..c79e35500 100644
--- a/reference/deprecated.html
+++ b/reference/deprecated.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/depth.html b/reference/depth.html
index 55fe08370..7106449fe 100644
--- a/reference/depth.html
+++ b/reference/depth.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/describe.html b/reference/describe.html
index deaeaa4f6..bed7e2927 100644
--- a/reference/describe.html
+++ b/reference/describe.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/diff.html b/reference/diff.html
index cbb5bccaa..bef6f973e 100644
--- a/reference/diff.html
+++ b/reference/diff.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/dimensions.html b/reference/dimensions.html
index 0722b907f..07c0b10d2 100644
--- a/reference/dimensions.html
+++ b/reference/dimensions.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/direction.html b/reference/direction.html
index 0b572ab12..28dc106de 100644
--- a/reference/direction.html
+++ b/reference/direction.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/disaggregate.html b/reference/disaggregate.html
index 669f5b619..22450f98e 100644
--- a/reference/disaggregate.html
+++ b/reference/disaggregate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/distance.html b/reference/distance.html
index cc03b7778..f628a0070 100644
--- a/reference/distance.html
+++ b/reference/distance.html
@@ -40,7 +40,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/dots.html b/reference/dots.html
index 240f60947..c48b6689e 100644
--- a/reference/dots.html
+++ b/reference/dots.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/draw.html b/reference/draw.html
index ae44d4ea9..55183c6ba 100644
--- a/reference/draw.html
+++ b/reference/draw.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/elongate.html b/reference/elongate.html
index b056ee3b9..e2c0e7369 100644
--- a/reference/elongate.html
+++ b/reference/elongate.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/erase.html b/reference/erase.html
index 323924183..516706112 100644
--- a/reference/erase.html
+++ b/reference/erase.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/expanse.html b/reference/expanse.html
index ad4e48b6e..33a4165a9 100644
--- a/reference/expanse.html
+++ b/reference/expanse.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ext.html b/reference/ext.html
index 6789dc0cd..9db39e4db 100644
--- a/reference/ext.html
+++ b/reference/ext.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/extend.html b/reference/extend.html
index 963a86aac..7f28a8e16 100644
--- a/reference/extend.html
+++ b/reference/extend.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/extract.html b/reference/extract.html
index 21f6e1d41..793776b8e 100644
--- a/reference/extract.html
+++ b/reference/extract.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/extractAlong.html b/reference/extractAlong.html
index 9cc48bb63..d64712159 100644
--- a/reference/extractAlong.html
+++ b/reference/extractAlong.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/extractRange.html b/reference/extractRange.html
index ec3459d17..79a22f697 100644
--- a/reference/extractRange.html
+++ b/reference/extractRange.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/factors.html b/reference/factors.html
index 659da865e..f3757575d 100644
--- a/reference/factors.html
+++ b/reference/factors.html
@@ -26,7 +26,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/fill.html b/reference/fill.html
index 25dd1e0c6..f80b18b7b 100644
--- a/reference/fill.html
+++ b/reference/fill.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/fillTime.html b/reference/fillTime.html
index bd4c3a00b..c1b27b0a6 100644
--- a/reference/fillTime.html
+++ b/reference/fillTime.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/flip.html b/reference/flip.html
index 7d8e7f6d4..dd0fc760b 100644
--- a/reference/flip.html
+++ b/reference/flip.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/focal.html b/reference/focal.html
index 73e6ea047..a359e1e6d 100644
--- a/reference/focal.html
+++ b/reference/focal.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/focal3D.html b/reference/focal3D.html
index f7fbff534..91cb65ab1 100644
--- a/reference/focal3D.html
+++ b/reference/focal3D.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/focalCpp.html b/reference/focalCpp.html
index 664bac415..56f9c1e24 100644
--- a/reference/focalCpp.html
+++ b/reference/focalCpp.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/focalMat.html b/reference/focalMat.html
index 85f9ac330..2e81abed1 100644
--- a/reference/focalMat.html
+++ b/reference/focalMat.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/focalPairs.html b/reference/focalPairs.html
index 334419007..71d6479e7 100644
--- a/reference/focalPairs.html
+++ b/reference/focalPairs.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/focalReg.html b/reference/focalReg.html
index f85542421..1f1ec1764 100644
--- a/reference/focalReg.html
+++ b/reference/focalReg.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/focalValues.html b/reference/focalValues.html
index accb1da31..3c5d7861b 100644
--- a/reference/focalValues.html
+++ b/reference/focalValues.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/forceCCW.html b/reference/forceCCW.html
index b7b55ef62..18a8b6c16 100644
--- a/reference/forceCCW.html
+++ b/reference/forceCCW.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/freq.html b/reference/freq.html
index 69950b0b3..64cae6ef8 100644
--- a/reference/freq.html
+++ b/reference/freq.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/gaps.html b/reference/gaps.html
index e7ddd86bf..657e85af4 100644
--- a/reference/gaps.html
+++ b/reference/gaps.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/gdal.html b/reference/gdal.html
index 9e24c7a59..f31581ae5 100644
--- a/reference/gdal.html
+++ b/reference/gdal.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/geometry.html b/reference/geometry.html
index 7183a29ed..09be82754 100644
--- a/reference/geometry.html
+++ b/reference/geometry.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/geomtype.html b/reference/geomtype.html
index c06a13a5b..1db9d368d 100644
--- a/reference/geomtype.html
+++ b/reference/geomtype.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/global.html b/reference/global.html
index d830f5e0e..4992164a7 100644
--- a/reference/global.html
+++ b/reference/global.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/graticule.html b/reference/graticule.html
index 5b6c2474c..bc1421355 100644
--- a/reference/graticule.html
+++ b/reference/graticule.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/grid.html b/reference/grid.html
index 2a111c116..b44a24915 100644
--- a/reference/grid.html
+++ b/reference/grid.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/gridDist.html b/reference/gridDist.html
index e2284a1ff..41b0fb491 100644
--- a/reference/gridDist.html
+++ b/reference/gridDist.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/halo.html b/reference/halo.html
index b862313c5..ed56f2012 100644
--- a/reference/halo.html
+++ b/reference/halo.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/headtail.html b/reference/headtail.html
index e48662bcc..724904fc8 100644
--- a/reference/headtail.html
+++ b/reference/headtail.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/hist.html b/reference/hist.html
index 3d092c4d1..b5504421c 100644
--- a/reference/hist.html
+++ b/reference/hist.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/identical.html b/reference/identical.html
index 9b4a86bbb..c102346c1 100644
--- a/reference/identical.html
+++ b/reference/identical.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ifelse.html b/reference/ifelse.html
index 7bbd5d5e4..a03ab8919 100644
--- a/reference/ifelse.html
+++ b/reference/ifelse.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/image.html b/reference/image.html
index 70e059912..2e20559db 100644
--- a/reference/image.html
+++ b/reference/image.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/impose.html b/reference/impose.html
index 0939d6cc1..00719db92 100644
--- a/reference/impose.html
+++ b/reference/impose.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/index.html b/reference/index.html
index 1ce13356d..69c278cbe 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/init.html b/reference/init.html
index 878087f30..c310a3ba2 100644
--- a/reference/init.html
+++ b/reference/init.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/inplace.html b/reference/inplace.html
index 8825519b4..2f0c227fa 100644
--- a/reference/inplace.html
+++ b/reference/inplace.html
@@ -20,7 +20,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/inset.html b/reference/inset.html
index 223702617..649f7b1fd 100644
--- a/reference/inset.html
+++ b/reference/inset.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/interpIDW.html b/reference/interpIDW.html
index aeb8f1523..62bf5d291 100644
--- a/reference/interpIDW.html
+++ b/reference/interpIDW.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/interpNear.html b/reference/interpNear.html
index bc3c5463f..23e0451c0 100644
--- a/reference/interpNear.html
+++ b/reference/interpNear.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/interpolate.html b/reference/interpolate.html
index f2429f164..137dbe9c1 100644
--- a/reference/interpolate.html
+++ b/reference/interpolate.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/intersect.html b/reference/intersect.html
index 4c5fe97d0..6933aa1ee 100644
--- a/reference/intersect.html
+++ b/reference/intersect.html
@@ -20,7 +20,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/is.bool.html b/reference/is.bool.html
index 102ace4dd..dafaf5a2e 100644
--- a/reference/is.bool.html
+++ b/reference/is.bool.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/is.empty.html b/reference/is.empty.html
index 02ea6b5bb..1db6bcbfb 100644
--- a/reference/is.empty.html
+++ b/reference/is.empty.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/is.lonlat.html b/reference/is.lonlat.html
index b7a29fe05..6d882b944 100644
--- a/reference/is.lonlat.html
+++ b/reference/is.lonlat.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/is.rotated.html b/reference/is.rotated.html
index 59c6ab204..2374ae32d 100644
--- a/reference/is.rotated.html
+++ b/reference/is.rotated.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/is.valid.html b/reference/is.valid.html
index ca64f5442..b064d0d40 100644
--- a/reference/is.valid.html
+++ b/reference/is.valid.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/k_means.html b/reference/k_means.html
index d1fec0d85..131d3c8c2 100644
--- a/reference/k_means.html
+++ b/reference/k_means.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/lapp.html b/reference/lapp.html
index d9c4801aa..3b52875f2 100644
--- a/reference/lapp.html
+++ b/reference/lapp.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/layerCor.html b/reference/layerCor.html
index cb1f8fa1b..b4f220826 100644
--- a/reference/layerCor.html
+++ b/reference/layerCor.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/legend.html b/reference/legend.html
index 11a18169f..718c6d2b2 100644
--- a/reference/legend.html
+++ b/reference/legend.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/linearUnits.html b/reference/linearUnits.html
index 72fe0def6..1b49e5ae7 100644
--- a/reference/linearUnits.html
+++ b/reference/linearUnits.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/lines.html b/reference/lines.html
index 49da08769..4ca562658 100644
--- a/reference/lines.html
+++ b/reference/lines.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/makeTiles.html b/reference/makeTiles.html
index 97da3ef2a..54653fca0 100644
--- a/reference/makeTiles.html
+++ b/reference/makeTiles.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -129,10 +129,10 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span><span class="va">filename</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/paste.html" class="external-link">paste0</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/tempfile.html" class="external-link">tempfile</a></span><span class="op">(</span><span class="op">)</span>, <span class="st">"_.tif"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="va">ff</span> <span class="op">&lt;-</span> <span class="fu">makeTiles</span><span class="op">(</span><span class="va">r</span>, <span class="va">x</span>, <span class="va">filename</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="va">ff</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_1.tif"</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [2] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_2.tif"</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [3] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_3.tif"</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [4] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_4.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_1.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [2] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_2.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [3] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_3.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [4] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_4.tif"</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu"><a href="vrt.html">vrt</a></span><span class="op">(</span><span class="va">ff</span><span class="op">)</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> class       : SpatRaster </span>
@@ -140,8 +140,8 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> resolution  : 3.6, 1.8  (x, y)</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax)</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> coord. ref. : lon/lat WGS 84 (EPSG:4326) </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> source      : spat_3511124f81fe_13585.vrt </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> name        : spat_3511124f81fe_13585 </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> source      : spat_34aa77ebb8f7_13482.vrt </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> name        : spat_34aa77ebb8f7_13482 </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> min value   :                       1 </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> max value   :                   10000 </span>
 </code></pre></div>
diff --git a/reference/makeVRT.html b/reference/makeVRT.html
index 0dc1f67f1..0e36d1894 100644
--- a/reference/makeVRT.html
+++ b/reference/makeVRT.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mappal.html b/reference/mappal.html
index 5b10540df..6b9e93bb5 100644
--- a/reference/mappal.html
+++ b/reference/mappal.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mask.html b/reference/mask.html
index 177b21f04..f85039319 100644
--- a/reference/mask.html
+++ b/reference/mask.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/match.html b/reference/match.html
index ff3eb8b3b..af8eb2305 100644
--- a/reference/match.html
+++ b/reference/match.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/math-generics.html b/reference/math-generics.html
index 2599d764a..0769da293 100644
--- a/reference/math-generics.html
+++ b/reference/math-generics.html
@@ -22,7 +22,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mem.html b/reference/mem.html
index acbddade2..fe4534bd4 100644
--- a/reference/mem.html
+++ b/reference/mem.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -89,8 +89,8 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> Memory (GB) </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> ------------------------</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> check threshold : 1 (memmin)</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> available       : 3.36</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> allowed (60%)   : 2.02</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> available       : 3.18</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> allowed (60%)   : 1.91</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> needed (n=1)    : 0</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> ------------------------</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> proc in memory  : TRUE</span>
@@ -98,7 +98,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> ------------------------</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">free_RAM</span><span class="op">(</span><span class="op">)</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] 3522416</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] 3337328</span>
 </code></pre></div>
     </div>
   </main><aside class="col-md-3"><nav id="toc"><h2>On this page</h2>
diff --git a/reference/merge.html b/reference/merge.html
index 5cec3e5b8..a3f3a2459 100644
--- a/reference/merge.html
+++ b/reference/merge.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mergeTime.html b/reference/mergeTime.html
index e3425412d..c62962920 100644
--- a/reference/mergeTime.html
+++ b/reference/mergeTime.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/meta.html b/reference/meta.html
index e17acff4c..43ac19456 100644
--- a/reference/meta.html
+++ b/reference/meta.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/metags.html b/reference/metags.html
index e8efce3a8..a87c72549 100644
--- a/reference/metags.html
+++ b/reference/metags.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/minmax.html b/reference/minmax.html
index 6df556177..aabe4527e 100644
--- a/reference/minmax.html
+++ b/reference/minmax.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/modal.html b/reference/modal.html
index bfcb433c9..adfc1aad7 100644
--- a/reference/modal.html
+++ b/reference/modal.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mosaic.html b/reference/mosaic.html
index 3843354ba..d869e0ade 100644
--- a/reference/mosaic.html
+++ b/reference/mosaic.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/na.omit.html b/reference/na.omit.html
index ee4ac386f..1f0946015 100644
--- a/reference/na.omit.html
+++ b/reference/na.omit.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/names.html b/reference/names.html
index c68d47f01..1622f3632 100644
--- a/reference/names.html
+++ b/reference/names.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/nearby.html b/reference/nearby.html
index 7b2ef74e4..0b20ec655 100644
--- a/reference/nearby.html
+++ b/reference/nearby.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/normalize.longitude.html b/reference/normalize.longitude.html
index 3957cbee5..0e7719862 100644
--- a/reference/normalize.longitude.html
+++ b/reference/normalize.longitude.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/north.html b/reference/north.html
index 5a9f067ea..9c7262615 100644
--- a/reference/north.html
+++ b/reference/north.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/not.na.html b/reference/not.na.html
index a473a9687..37c904c1e 100644
--- a/reference/not.na.html
+++ b/reference/not.na.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/origin.html b/reference/origin.html
index 05c3a8497..7cd2c85f1 100644
--- a/reference/origin.html
+++ b/reference/origin.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/pairs.html b/reference/pairs.html
index e001e2879..79dea41af 100644
--- a/reference/pairs.html
+++ b/reference/pairs.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/panel.html b/reference/panel.html
index 6f2069a97..08247c00c 100644
--- a/reference/panel.html
+++ b/reference/panel.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/patches.html b/reference/patches.html
index 9cb941721..e7f99e040 100644
--- a/reference/patches.html
+++ b/reference/patches.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/perim.html b/reference/perim.html
index e3aa6ddd2..31b618a99 100644
--- a/reference/perim.html
+++ b/reference/perim.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/persp.html b/reference/persp.html
index b05ee7859..473635585 100644
--- a/reference/persp.html
+++ b/reference/persp.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/plet.html b/reference/plet.html
index 3beca8cb7..b6220dc0b 100644
--- a/reference/plet.html
+++ b/reference/plet.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/plot.html b/reference/plot.html
index 8c2ba0131..55871cf33 100644
--- a/reference/plot.html
+++ b/reference/plot.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/plotRGB.html b/reference/plotRGB.html
index d7411b7c4..2bf0f8733 100644
--- a/reference/plotRGB.html
+++ b/reference/plotRGB.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/plot_extent.html b/reference/plot_extent.html
index fb279a3cd..6f2b7e969 100644
--- a/reference/plot_extent.html
+++ b/reference/plot_extent.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/plot_graticule.html b/reference/plot_graticule.html
index 84f9d3c05..55f0a5cd4 100644
--- a/reference/plot_graticule.html
+++ b/reference/plot_graticule.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/prcomp.html b/reference/prcomp.html
index 90e40666b..f506222d8 100644
--- a/reference/prcomp.html
+++ b/reference/prcomp.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/predict.html b/reference/predict.html
index dc0df4547..409b1e74e 100644
--- a/reference/predict.html
+++ b/reference/predict.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/princomp.html b/reference/princomp.html
index dcd031f68..2e7def5f7 100644
--- a/reference/princomp.html
+++ b/reference/princomp.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/project.html b/reference/project.html
index fd9da3b64..c483022ba 100644
--- a/reference/project.html
+++ b/reference/project.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/quantile.html b/reference/quantile.html
index aab463335..20fd671fd 100644
--- a/reference/quantile.html
+++ b/reference/quantile.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/query.html b/reference/query.html
index 7488bcc61..548b5e339 100644
--- a/reference/query.html
+++ b/reference/query.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rangeFill.html b/reference/rangeFill.html
index 6790799a9..de0e377e4 100644
--- a/reference/rangeFill.html
+++ b/reference/rangeFill.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rapp.html b/reference/rapp.html
index 2ea14d1f7..32bd4249c 100644
--- a/reference/rapp.html
+++ b/reference/rapp.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rast.html b/reference/rast.html
index 53e10fdb6..5cfa17795 100644
--- a/reference/rast.html
+++ b/reference/rast.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rasterize.html b/reference/rasterize.html
index 34da7997d..50bff0649 100644
--- a/reference/rasterize.html
+++ b/reference/rasterize.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rasterizeGeom.html b/reference/rasterizeGeom.html
index 85893d6e2..d6b9066a2 100644
--- a/reference/rasterizeGeom.html
+++ b/reference/rasterizeGeom.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rasterizeWin.html b/reference/rasterizeWin.html
index 6dc79d9ef..b0f469cc0 100644
--- a/reference/rasterizeWin.html
+++ b/reference/rasterizeWin.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rcl.html b/reference/rcl.html
index 3cf50bf9d..8dc6655a5 100644
--- a/reference/rcl.html
+++ b/reference/rcl.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/readwrite.html b/reference/readwrite.html
index bd1eac991..709101eb6 100644
--- a/reference/readwrite.html
+++ b/reference/readwrite.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rectify.html b/reference/rectify.html
index e1da13e9d..6fea1f823 100644
--- a/reference/rectify.html
+++ b/reference/rectify.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/regress.html b/reference/regress.html
index 8a0ba3d0b..a6b2995c2 100644
--- a/reference/regress.html
+++ b/reference/regress.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/relate.html b/reference/relate.html
index 78eefbd66..868b2845a 100644
--- a/reference/relate.html
+++ b/reference/relate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rep.html b/reference/rep.html
index c89214793..a909c9775 100644
--- a/reference/rep.html
+++ b/reference/rep.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/replace_dollar.html b/reference/replace_dollar.html
index efbfbc399..156b1fac4 100644
--- a/reference/replace_dollar.html
+++ b/reference/replace_dollar.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/replace_layers.html b/reference/replace_layers.html
index d5de41369..9d8fdb0d5 100644
--- a/reference/replace_layers.html
+++ b/reference/replace_layers.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/replace_values.html b/reference/replace_values.html
index 2f162df78..5c9c769a6 100644
--- a/reference/replace_values.html
+++ b/reference/replace_values.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/resample.html b/reference/resample.html
index 4151910c1..e8a44e478 100644
--- a/reference/resample.html
+++ b/reference/resample.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rescale.html b/reference/rescale.html
index 3a70873db..f12982036 100644
--- a/reference/rescale.html
+++ b/reference/rescale.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/roll.html b/reference/roll.html
index 6731f2747..0b468849b 100644
--- a/reference/roll.html
+++ b/reference/roll.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/rotate.html b/reference/rotate.html
index 9707aca71..6f1935fb4 100644
--- a/reference/rotate.html
+++ b/reference/rotate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/same.crs.html b/reference/same.crs.html
index f5caac5c7..de8fd8c54 100644
--- a/reference/same.crs.html
+++ b/reference/same.crs.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sample.html b/reference/sample.html
index 7624deb55..6f458940f 100644
--- a/reference/sample.html
+++ b/reference/sample.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sapp.html b/reference/sapp.html
index 50d743809..31de4ff01 100644
--- a/reference/sapp.html
+++ b/reference/sapp.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sbar.html b/reference/sbar.html
index d801d9e5d..641997b27 100644
--- a/reference/sbar.html
+++ b/reference/sbar.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/scale.html b/reference/scale.html
index c0b1b21f4..4b4248415 100644
--- a/reference/scale.html
+++ b/reference/scale.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/scatter.html b/reference/scatter.html
index bcefd235f..111f1c094 100644
--- a/reference/scatter.html
+++ b/reference/scatter.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/scoff.html b/reference/scoff.html
index 49c0634b3..bf39a2941 100644
--- a/reference/scoff.html
+++ b/reference/scoff.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sds.html b/reference/sds.html
index 1d7d83a5e..79b696c5c 100644
--- a/reference/sds.html
+++ b/reference/sds.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/segregate.html b/reference/segregate.html
index efc3e6c4c..39756a65e 100644
--- a/reference/segregate.html
+++ b/reference/segregate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/select.html b/reference/select.html
index b175dda54..bc5f3c42a 100644
--- a/reference/select.html
+++ b/reference/select.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/selectHigh.html b/reference/selectHigh.html
index 40dba2ae1..6b5e6547f 100644
--- a/reference/selectHigh.html
+++ b/reference/selectHigh.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/selectRange.html b/reference/selectRange.html
index df96879c7..bf6c483b1 100644
--- a/reference/selectRange.html
+++ b/reference/selectRange.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/serialize.html b/reference/serialize.html
index 8b9a634ff..76e7b7743 100644
--- a/reference/serialize.html
+++ b/reference/serialize.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/setValues.html b/reference/setValues.html
index a8fb46131..cb58e972b 100644
--- a/reference/setValues.html
+++ b/reference/setValues.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/shade.html b/reference/shade.html
index 9ed070824..903652daf 100644
--- a/reference/shade.html
+++ b/reference/shade.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sharedPaths.html b/reference/sharedPaths.html
index ccc95d333..b8d83f189 100644
--- a/reference/sharedPaths.html
+++ b/reference/sharedPaths.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/shift.html b/reference/shift.html
index 0df018c8f..8535d3d0d 100644
--- a/reference/shift.html
+++ b/reference/shift.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sieve.html b/reference/sieve.html
index bddf8d5de..467c3077e 100644
--- a/reference/sieve.html
+++ b/reference/sieve.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/simplify.html b/reference/simplify.html
index bc50eb5c7..c0cf93176 100644
--- a/reference/simplify.html
+++ b/reference/simplify.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sort.html b/reference/sort.html
index c7791971c..b888a8cab 100644
--- a/reference/sort.html
+++ b/reference/sort.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sources.html b/reference/sources.html
index f3d65d6a5..47fc5cdad 100644
--- a/reference/sources.html
+++ b/reference/sources.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/spin.html b/reference/spin.html
index 3498e7f74..a380ca792 100644
--- a/reference/spin.html
+++ b/reference/spin.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/split.html b/reference/split.html
index 9d7a2f496..5e67638cc 100644
--- a/reference/split.html
+++ b/reference/split.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sprc.html b/reference/sprc.html
index 0b63455de..4ae0be81a 100644
--- a/reference/sprc.html
+++ b/reference/sprc.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/stretch.html b/reference/stretch.html
index f74285ef0..d057a4d3a 100644
--- a/reference/stretch.html
+++ b/reference/stretch.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/subset.html b/reference/subset.html
index f5d7d44ac..11feda0cb 100644
--- a/reference/subset.html
+++ b/reference/subset.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/subset_dollar.html b/reference/subset_dollar.html
index e35e77b91..0938d92de 100644
--- a/reference/subset_dollar.html
+++ b/reference/subset_dollar.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/subset_double.html b/reference/subset_double.html
index b98864f3c..1def31e59 100644
--- a/reference/subset_double.html
+++ b/reference/subset_double.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/subset_single.html b/reference/subset_single.html
index 47aadcb77..462f12a74 100644
--- a/reference/subset_single.html
+++ b/reference/subset_single.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/subst.html b/reference/subst.html
index 69c54582a..4b5e3d81f 100644
--- a/reference/subst.html
+++ b/reference/subst.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/summarize-generics.html b/reference/summarize-generics.html
index 09ca83e15..b8a0451c4 100644
--- a/reference/summarize-generics.html
+++ b/reference/summarize-generics.html
@@ -26,7 +26,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/summary.html b/reference/summary.html
index 2e3739c87..a1e06d14d 100644
--- a/reference/summary.html
+++ b/reference/summary.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/svc.html b/reference/svc.html
index 3f20339f5..d093e4f10 100644
--- a/reference/svc.html
+++ b/reference/svc.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/symdif.html b/reference/symdif.html
index 194f61d45..440978b92 100644
--- a/reference/symdif.html
+++ b/reference/symdif.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/tapp.html b/reference/tapp.html
index 288c1f66e..854f96ca5 100644
--- a/reference/tapp.html
+++ b/reference/tapp.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/terra-package.html b/reference/terra-package.html
index 1f4fe9564..06e0d0646 100644
--- a/reference/terra-package.html
+++ b/reference/terra-package.html
@@ -26,7 +26,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/terraOptions.html b/reference/terraOptions.html
index 3ea851380..8d4227efa 100644
--- a/reference/terraOptions.html
+++ b/reference/terraOptions.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -103,7 +103,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> tolerance : 0.1</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> verbose   : FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> todisk    : FALSE</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpsTXkfZ</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpUrLSv3</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> datatype  : FLT4S</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> memmin    : 1</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> progress  : 3</span>
@@ -115,7 +115,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> tolerance : 0.1</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> verbose   : FALSE</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> todisk    : FALSE</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpsTXkfZ</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpUrLSv3</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> datatype  : FLT4S</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> memmin    : 1</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> progress  : 10</span>
diff --git a/reference/terrain.html b/reference/terrain.html
index 309a111b6..f9644a4eb 100644
--- a/reference/terrain.html
+++ b/reference/terrain.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/text.html b/reference/text.html
index f607b1030..03a0c0c61 100644
--- a/reference/text.html
+++ b/reference/text.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/time.html b/reference/time.html
index e04bbdbe3..1d4dbbd7f 100644
--- a/reference/time.html
+++ b/reference/time.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -119,8 +119,8 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span><span class="co"># with time zone</span></span></span>
 <span class="r-in"><span><span class="fu">time</span><span class="op">(</span><span class="va">s</span><span class="op">)</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/as.POSIXlt.html" class="external-link">as.POSIXlt</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/Sys.time.html" class="external-link">Sys.time</a></span><span class="op">(</span><span class="op">)</span>, <span class="st">"America/New_York"</span><span class="op">)</span> <span class="op">+</span> <span class="fl">0</span><span class="op">:</span><span class="fl">2</span></span></span>
 <span class="r-in"><span><span class="fu">time</span><span class="op">(</span><span class="va">s</span><span class="op">)</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "2024-05-22 06:10:59 EDT" "2024-05-22 06:11:00 EDT"</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [3] "2024-05-22 06:11:01 EDT"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "2024-05-24 06:59:47 EDT" "2024-05-24 06:59:48 EDT"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [3] "2024-05-24 06:59:49 EDT"</span>
 <span class="r-in"><span><span class="fu">timeInfo</span><span class="op">(</span><span class="va">s</span><span class="op">)</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   time    step             zone</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> 1 TRUE seconds America/New_York</span>
diff --git a/reference/tmpFile.html b/reference/tmpFile.html
index 4f8ccfba7..e0a0701a9 100644
--- a/reference/tmpFile.html
+++ b/reference/tmpFile.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -92,7 +92,7 @@ <h2 id="see-also">See also<a class="anchor" aria-label="anchor" href="#see-also"
     <div class="section level2">
     <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
     <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="fu">tmpFiles</span><span class="op">(</span><span class="op">)</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "/private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpsTXkfZ/spat_3511124f81fe_13585.vrt"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "/private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpUrLSv3/spat_34aa77ebb8f7_13482.vrt"</span>
 </code></pre></div>
     </div>
   </main><aside class="col-md-3"><nav id="toc"><h2>On this page</h2>
diff --git a/reference/topology.html b/reference/topology.html
index 94bf9002b..9ec5b213d 100644
--- a/reference/topology.html
+++ b/reference/topology.html
@@ -22,7 +22,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/transpose.html b/reference/transpose.html
index f58e3aec0..de71e7fc6 100644
--- a/reference/transpose.html
+++ b/reference/transpose.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/trim.html b/reference/trim.html
index e2ed77205..2fc1b402c 100644
--- a/reference/trim.html
+++ b/reference/trim.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/union.html b/reference/union.html
index 6a29c33c4..d212458bb 100644
--- a/reference/union.html
+++ b/reference/union.html
@@ -20,7 +20,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/unique.html b/reference/unique.html
index 1d22689ed..b9dbacc24 100644
--- a/reference/unique.html
+++ b/reference/unique.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/units.html b/reference/units.html
index 390436f6c..76cf10381 100644
--- a/reference/units.html
+++ b/reference/units.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/update.html b/reference/update.html
index dc4720c19..7760d67a4 100644
--- a/reference/update.html
+++ b/reference/update.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -98,7 +98,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> resolution  : 1.019802, 1.025974  (x, y)</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> extent      : -1, 102, -1, 78  (xmin, xmax, ymin, ymax)</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> coord. ref. : WGS 84 / UTM zone 1N (EPSG:32601) </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> source      : file3511416415b3.tif </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> source      : file34aa1b475c6.tif </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> colors RGB  : 1, 2, 3 </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> names       : red, green, blue </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> min values  :   0,     0,    0 </span>
diff --git a/reference/values.html b/reference/values.html
index a5004f21f..904a35260 100644
--- a/reference/values.html
+++ b/reference/values.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/varnames.html b/reference/varnames.html
index 04e2d3559..3bf5461c5 100644
--- a/reference/varnames.html
+++ b/reference/varnames.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/vect.html b/reference/vect.html
index 57be2b9bb..9d62b2010 100644
--- a/reference/vect.html
+++ b/reference/vect.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/vector_layers.html b/reference/vector_layers.html
index 9f673aced..0c9663beb 100644
--- a/reference/vector_layers.html
+++ b/reference/vector_layers.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/viewshed.html b/reference/viewshed.html
index fc529071e..a6b168895 100644
--- a/reference/viewshed.html
+++ b/reference/viewshed.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/voronoi.html b/reference/voronoi.html
index 71499cc1b..948a3182a 100644
--- a/reference/voronoi.html
+++ b/reference/voronoi.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/vrt.html b/reference/vrt.html
index 61af906fe..306aab261 100644
--- a/reference/vrt.html
+++ b/reference/vrt.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -108,10 +108,10 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-in"><span><span class="va">filename</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/paste.html" class="external-link">paste0</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/tempfile.html" class="external-link">tempfile</a></span><span class="op">(</span><span class="op">)</span>, <span class="st">"_.tif"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="va">ff</span> <span class="op">&lt;-</span> <span class="fu"><a href="makeTiles.html">makeTiles</a></span><span class="op">(</span><span class="va">r</span>, <span class="va">x</span>, <span class="va">filename</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="va">ff</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_1.tif"</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [2] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_2.tif"</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [3] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_3.tif"</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [4] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_4.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_1.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [2] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_2.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [3] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_3.tif"</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [4] "/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_4.tif"</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co">#vrtfile &lt;- paste0(tempfile(), ".vrt")</span></span></span>
 <span class="r-in"><span><span class="co">#v &lt;- vrt(ff, vrtfile)</span></span></span>
diff --git a/reference/vrt_tiles.html b/reference/vrt_tiles.html
index fa132c76f..91efb1615 100644
--- a/reference/vrt_tiles.html
+++ b/reference/vrt_tiles.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/weighted.mean.html b/reference/weighted.mean.html
index 79437c317..af4f653d7 100644
--- a/reference/weighted.mean.html
+++ b/reference/weighted.mean.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/where.html b/reference/where.html
index 62968d8ca..d5ea4e142 100644
--- a/reference/where.html
+++ b/reference/where.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/which.html b/reference/which.html
index 9ae5fb43e..8e1213201 100644
--- a/reference/which.html
+++ b/reference/which.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/width.html b/reference/width.html
index 12ce6414d..272269903 100644
--- a/reference/width.html
+++ b/reference/width.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/window.html b/reference/window.html
index a737b8aa9..8c728bcec 100644
--- a/reference/window.html
+++ b/reference/window.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/wrap.html b/reference/wrap.html
index fbf163a9a..c57d96f26 100644
--- a/reference/wrap.html
+++ b/reference/wrap.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/wrapCache.html b/reference/wrapCache.html
index f75bcffd4..8ef3c23f8 100644
--- a/reference/wrapCache.html
+++ b/reference/wrapCache.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/writeCDF.html b/reference/writeCDF.html
index 7942ecc6f..181dc0367 100644
--- a/reference/writeCDF.html
+++ b/reference/writeCDF.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/writeRaster.html b/reference/writeRaster.html
index 57a09e980..fdad9f593 100644
--- a/reference/writeRaster.html
+++ b/reference/writeRaster.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/writeVector.html b/reference/writeVector.html
index 391b30ac0..2e53a5cbf 100644
--- a/reference/writeVector.html
+++ b/reference/writeVector.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/xapp.html b/reference/xapp.html
index a3de0b4e1..c53057687 100644
--- a/reference/xapp.html
+++ b/reference/xapp.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/xmin.html b/reference/xmin.html
index 79c0121ca..86b6d0db8 100644
--- a/reference/xmin.html
+++ b/reference/xmin.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/xyCellFrom.html b/reference/xyCellFrom.html
index a797bd325..25575902f 100644
--- a/reference/xyCellFrom.html
+++ b/reference/xyCellFrom.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/zonal.html b/reference/zonal.html
index b36934da1..c16900dd9 100644
--- a/reference/zonal.html
+++ b/reference/zonal.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/zoom.html b/reference/zoom.html
index 8240adfd2..cd80139a9 100644
--- a/reference/zoom.html
+++ b/reference/zoom.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">terra</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-77</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">1.7-79</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/search.json b/search.json
index 0ee471e52..7e81c9ee9 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://rspatial.github.io/terra/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Robert J. Hijmans. Maintainer, author. Roger Bivand. Contributor. Krzysztof Dyba. Contributor. Edzer Pebesma. Contributor. Michael D. Sumner. Contributor.","code":""},{"path":"https://rspatial.github.io/terra/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Hijmans R (2024). terra: Spatial Data Analysis. R package version 1.7-77, https://rspatial.github.io/terra/, https://rspatial.org/.","code":"@Manual{,   title = {terra: Spatial Data Analysis},   author = {Robert J. Hijmans},   year = {2024},   note = {R package version 1.7-77, https://rspatial.github.io/terra/},   url = {https://rspatial.org/}, }"},{"path":"https://rspatial.github.io/terra/index.html","id":"terra-","dir":"","previous_headings":"","what":"Spatial Data Analysis","title":"Spatial Data Analysis","text":"logo Zane Dax  terra R package spatial data analysis. tutorials rspatial.org/terra. Stack Overflow good place ask questions get stuck. Make sure include simple reproducible example. think found bug, want request new feature, please file issue. terra replaces raster package. interfaces terra raster similar, terra simpler, faster can .","code":""},{"path":"https://rspatial.github.io/terra/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Spatial Data Analysis","text":"terra available CRAN, can use install.packages(\"terra\") get current released version. easiest way use development version Windows MacOS, install R-universe, like :","code":"install.packages('terra', repos='https://rspatial.r-universe.dev')"},{"path":"https://rspatial.github.io/terra/index.html","id":"from-source-code","dir":"","previous_headings":"Installation","what":"From source-code","title":"Spatial Data Analysis","text":"install source-code, first install Rcpp package terra depends : continue based OS using.","code":"install.packages(\"Rcpp\")"},{"path":"https://rspatial.github.io/terra/index.html","id":"windows","dir":"","previous_headings":"Installation > From source-code","what":"Windows","title":"Spatial Data Analysis","text":"Windows, need first install Rtools get C++ compiler R can use. need recent version Rtools42 (rtools42-5355-5357). , R, install package.","code":"Sys.setenv(\"R_REMOTES_NO_ERRORS_FROM_WARNINGS\" = \"true\") remotes::install_github(\"rspatial/terra\")"},{"path":"https://rspatial.github.io/terra/index.html","id":"macos","dir":"","previous_headings":"Installation > From source-code","what":"macOS","title":"Spatial Data Analysis","text":"macOS, can use MacPorts Homebrew. MacPorts can Homebrew, need first install GDAL: Followed (note additional configuration argument needed Homebrew) install CRAN version source ","code":"sudo port install R-terra brew install pkg-config brew install gdal remotes::install_github(\"rspatial/terra\", configure.args = \"--with-proj-lib=$(brew --prefix)/lib/\") install.packages(\"terra\", type = \"source\", configure.args = \"--with-proj-lib=$(brew --prefix)/lib/\")"},{"path":"https://rspatial.github.io/terra/index.html","id":"linux","dir":"","previous_headings":"Installation > From source-code","what":"Linux","title":"Spatial Data Analysis","text":"easy way install terra Ubuntu r2u. harder way: Install system requirements GDAL (>= 2.2.3), GEOS (>= 3.4.0), PROJ (>= 4.9.3), sqlite3. now, R, install package See sf instructions installation linux systems — possible updates/improvements instructions.","code":"sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable sudo apt-get update sudo apt-get install libgdal-dev libgeos-dev libproj-dev remotes::install_github(\"rspatial/terra\")"},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":null,"dir":"Reference","previous_headings":"","what":"Set the NA flag — NAflag","title":"Set the NA flag — NAflag","text":"main purpose method allow correct reading SpatRaster based file incorrect NA flag. file changed, flagged value set NA values read file (\"lazy evaluation\"). contrast, values memory change made immediately. change values, generally better use classify","code":""},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set the NA flag — NAflag","text":"","code":"# S4 method for SpatRaster NAflag(x)  # S4 method for SpatRaster NAflag(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set the NA flag — NAflag","text":"x SpatRaster value numeric. value interpreted NA; set reading values file. can single value, multiple values, one data source (file / subdataset)","code":""},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set the NA flag — NAflag","text":"none numeric","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set the NA flag — NAflag","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))[[1]]    NAflag(s) <- 255 plot(s)  NAflag(s) #> [1] 255"},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":null,"dir":"Reference","previous_headings":"","what":"Layers representing colors — RGB","title":"Layers representing colors — RGB","text":"RGB can get set layers used Red, Green Blue plotting SpatRaster. Currently, benefit plot send object plotRGB. can also associated layers another color space (HSV, HSI HSL) colorize can convert three-layer RGB SpatRaster color spaces. can also convert single-layer SpatRaster color-table.","code":""},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Layers representing colors — RGB","text":"","code":"# S4 method for SpatRaster RGB(x)  # S4 method for SpatRaster RGB(x, ..., type=\"rgb\")<-value  # S4 method for SpatRaster colorize(x, to=\"hsv\", alpha=FALSE, stretch=NULL,    grays=FALSE, NAzero=FALSE, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatRaster has.RGB(x, strict=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Layers representing colors — RGB","text":"x SpatRaster value vector three (four) positive integers indicating layers red, green blue (optionally fourth transparency layer). NULL remove RGB settings type character. color space. One \"rgb\" \"hsv\", \"hsi\" \"hsl\" character. color space transform values . x RGB set, can transform \"hsv\", \"hsi\" \"hsl\", use \"col\" create single layer color table. can also use \"rgb\" back transform RGB alpha logical. alpha (transparency) channel included? used x color-table =\"rgb\" stretch character. Option stretch values increase contrast: \"lin\" (linear) \"hist\" (histogram). used transforming RGB col grays logical. TRUE, gray-scale color-table created. used transforming RGB col NAzero logical. TRUE, NAs treated zeros color can returned least one three channels value. used transforming RGB (\"col\") strict logical. TRUE, function returns FALSE color space \"hsv\", \"hsi\" \"hsl\" used filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Layers representing colors — RGB","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    plot(r)  has.RGB(r) #> [1] TRUE RGB(r) <- NULL has.RGB(r) #> [1] FALSE plot(r)  RGB(r) <- c(3,1,2) plot(r)   RGB(r) <- 1:3 x <- colorize(r, \"col\") y <- colorize(r, \"hsv\") z <- colorize(y, \"rgb\")"},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":null,"dir":"Reference","previous_headings":"","what":"Class ","title":"Class ","text":"Objects class SpatExtent used define spatial extent (extremes) objects SpatRaster class.","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":"objects-from-the-class","dir":"Reference","previous_headings":"","what":"Objects from the Class","title":"Class ","text":"can use ext function create SpatExtent objects, extract SpatRaster, SpatVector related objects.","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":"methods","dir":"Reference","previous_headings":"","what":"Methods","title":"Class ","text":"show display values SpatExtent object","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Class ","text":"","code":"e <- ext(-180, 180, -90, 90) e #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/SpatRaster-class.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster class — SpatRaster-class","title":"SpatRaster class — SpatRaster-class","text":"SpatRaster represents rectangular part world sub-divided rectangular cells equal area (terms units coordinate reference system). cell can multiple values (\"layers\"). object SpatRaster class can point one files disk hold cell values, /can hold values memory. objects can created rast method. SpatRasterDataset collection sub-datasets, SpatRaster area (extent) coordinate reference system, possibly different resolution. Sub-datasets often used capture variables (e.g. temperature precipitation), fourth dimension (e.g. height, depth time) sub-datasets already three dimensions (multiple layers). SpatRasterCollection collection SpatRasters restriction extent geometric parameters.","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatRaster-class.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster class — SpatRaster-class","text":"","code":"rast() #> class       : SpatRaster  #> dimensions  : 180, 360, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)"},{"path":"https://rspatial.github.io/terra/reference/SpatVector-class.html","id":null,"dir":"Reference","previous_headings":"","what":"Class ","title":"Class ","text":"SpatVector can represent points, lines polygons. SpatVectorCollection can hold collection SpatVectors SpatVectorProxy SpatVector data -disk -stead memory.","code":""},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":null,"dir":"Reference","previous_headings":"","what":"Active category — activeCat","title":"Active category — activeCat","text":"Get set active category multi-categorical SpatRaster layer","code":""},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Active category — activeCat","text":"","code":"# S4 method for SpatRaster activeCat(x, layer=1) # S4 method for SpatRaster activeCat(x, layer=1)<-value"},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Active category — activeCat","text":"x SpatRaster layer positive integer, layer number name value positive integer character, indicating column categories use. Note number used index zero based, \"1\" refers second column. first column categories cell values, categorical labels","code":""},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Active category — activeCat","text":"integer","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Active category — activeCat","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) + 10 d <- data.frame(id=11:13, cover=c(\"forest\", \"water\", \"urban\"), letters=letters[1:3], value=10:12) levels(r) <- d  activeCat(r) #> [1] 1 activeCat(r) <- 3 activeCat(r) #> [1] 3"},{"path":"https://rspatial.github.io/terra/reference/add.html","id":null,"dir":"Reference","previous_headings":"","what":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"Add (place) SpatRaster another SpatRaster. Comparable c, without copying object.","code":""},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"","code":"# S4 method for SpatRaster,SpatRaster add(x)<-value  # S4 method for SpatRasterDataset,SpatRaster add(x)<-value  # S4 method for SpatRasterCollection,SpatRaster add(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"x SpatRaster, SpatRasterDataset SpatRasterCollection value SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"","code":"r <- rast(nrows=5, ncols=9, vals=1:45) x <- c(r, r*2) add(x) <- r*3 x #> class       : SpatRaster  #> dimensions  : 5, 9, 3  (nrow, ncol, nlyr) #> resolution  : 40, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     1,     2,     3  #> max values  :    45,    90,   135"},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":null,"dir":"Reference","previous_headings":"","what":"Adjacent cells — adjacent","title":"Adjacent cells — adjacent","text":"Identify cells adjacent set raster cells. identify adjacent polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Adjacent cells — adjacent","text":"","code":"# S4 method for SpatRaster adjacent(x, cells, directions=\"rook\", pairs=FALSE, include=FALSE, symmetrical=FALSE)  # S4 method for SpatVector adjacent(x, type=\"rook\", pairs=TRUE, symmetrical=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Adjacent cells — adjacent","text":"x SpatRaster cells vector cell numbers adjacent cells found. Cell numbers start 1 upper-left corner increase left right top bottom directions character matrix indicated directions cells considered connected. following character values allowed: \"rook\" \"4\" horizontal vertical neighbors; \"bishop\" get diagonal neighbors; \"queen\" \"8\" get vertical, horizontal diagonal neighbors; \"16\" knight one-cell queen move neighbors. directions matrix odd dimensions logical (0, 1) values pairs logical. TRUE, two-column matrix pairs adjacent cells returned. x SpatRaster pairs FALSE, n*m matrix returned number rows n length(cells) number columns m number neighbors requested directions include logical. focal cells included result? type character. One \"rook\", \"queen\", \"touches\", \"intersects\". \"queen\" \"touches\" synonyms. \"rook\" exclude polygons touch single node . \"intersects\" includes polygons touch overlap symmetrical logical. TRUE pairs=TRUE, adjacent pair included . example, polygon 1 adjacent polygon 3, implied adjacency 3 1 reported","code":""},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Adjacent cells — adjacent","text":"using global lon/lat rasters, adjacent cells side date-line included.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Adjacent cells — adjacent","text":"matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Adjacent cells — adjacent","text":"","code":"r <- rast(nrows=10, ncols=10) adjacent(r, cells=c(1, 5, 55), directions=\"queen\")  #>    [,1] [,2] [,3] [,4] [,5] [,6] [,7] [,8] #> 0   NaN  NaN  NaN   10    2   20   11   12 #> 4   NaN  NaN  NaN    4    6   14   15   16 #> 54   44   45   46   54   56   64   65   66 r <- rast(nrows=10, ncols=10, crs=\"+proj=utm +zone=1 +datum=WGS84\") adjacent(r, cells=11, directions=\"rook\")  #>    [,1] [,2] [,3] [,4] #> 10    1  NaN   12   21  #same as  rk <- matrix(c(0,1,0,1,0,1,0,1,0), 3, 3) adjacent(r, cells=11, directions=rk)  #>    [,1] [,2] [,3] [,4] #> 10    1  NaN   12   21  ## note that with global lat/lon data the E and W connect r <- rast(nrows=10, ncols=10, crs=\"+proj=longlat +datum=WGS84\") adjacent(r, cells=11, directions=\"rook\")  #>    [,1] [,2] [,3] [,4] #> 10    1   20   12   21  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) a <- adjacent(v, symmetrical=TRUE) head(a) #>      from to #> [1,]    1  2 #> [2,]    1  4 #> [3,]    1  5 #> [4,]    2  3 #> [5,]    2  4 #> [6,]    2  5"},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":null,"dir":"Reference","previous_headings":"","what":"Aggregate raster or vector data — aggregate","title":"Aggregate raster or vector data — aggregate","text":"Aggregate SpatRaster create new SpatRaster lower resolution (larger cells). Aggregation groups rectangular areas create larger cells. value resulting cells computed user-specified function. can also aggregate (\"dissolve\") SpatVector. either combines geometries one geometry, combines geometries value variable(s) specified argument .","code":""},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Aggregate raster or vector data — aggregate","text":"","code":"# S4 method for SpatRaster aggregate(x, fact=2, fun=\"mean\", ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatVector aggregate(x, by=NULL, dissolve=TRUE, fun=\"mean\", count=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Aggregate raster or vector data — aggregate","text":"x SpatRaster fact positive integer. Aggregation factor expressed number cells direction (horizontally vertically). two integers (horizontal vertical aggregation factor) three integers (also aggregating layers) fun function used aggregate values. Either actual function, following, name: \"mean\", \"max\", \"min\", \"median\", \"sum\", \"modal\", \"\", \"\", \"prod\", \".min\", \".max\", \"sd\" (sample standard deviation) \"std\" (population standard deviation) ... additional arguments passed fun, na.rm=TRUE cores positive integer. cores > 1, 'parallel' package cluster many cores created. Ignored C++ level implemented functions listed fun filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster character. variable(s) used group geometries dissolve logical. borders aggregated geometries dissolved? count logical. TRUE NULL, variable \"agg_n\" included shows number input geometries output geometry","code":""},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Aggregate raster or vector data — aggregate","text":"Aggregation starts upper-left end SpatRaster. division number columns rows factor return integer, extent resulting SpatRaster somewhat larger original SpatRaster. example, input SpatRaster 100 columns, fact=12, output SpatRaster 9 columns maximum x coordinate output SpatRaster also adjusted. function fun take multiple numbers, return single number. example mean, modal, min max. also accept na.rm argument (ignore one 'dots' arguments).","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Aggregate raster or vector data — aggregate","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Aggregate raster or vector data — aggregate","text":"","code":"r <- rast() # aggregated SpatRaster, no values ra <- aggregate(r, fact=10)  values(r) <- runif(ncell(r)) # aggregated raster, max of the values ra <- aggregate(r, fact=10, fun=max)  # multiple layers s <- c(r, r*2) x <- aggregate(s, 20)   ## SpatVector  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) va <- aggregate(v, \"ID_1\")  plot(va, \"NAME_1\", lwd=5, plg=list(x=\"topright\"), mar=rep(2,4)) lines(v, lwd=3, col=\"light gray\") lines(va) text(v, \"ID_1\", halo=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/align.html","id":null,"dir":"Reference","previous_headings":"","what":"Align a SpatExtent — align","title":"Align a SpatExtent — align","text":"Align SpatExtent SpatRaster can useful create new SpatRaster origin resolution existing SpatRaster. use force data match really match (use e.g. resample (dis)aggregate ). also possible align SpatExtent clean divisor.","code":""},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Align a SpatExtent — align","text":"","code":"# S4 method for SpatExtent,SpatRaster align(x, y, snap=\"near\")  # S4 method for SpatExtent,numeric align(x, y)"},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Align a SpatExtent — align","text":"x SpatExtent y SpatRaster numeric snap Character. One \"near\", \"\", \"\", determine direction extent aligned. nearest border, inwards outwards","code":""},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Align a SpatExtent — align","text":"SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Align a SpatExtent — align","text":"","code":"r <- rast() e <- ext(-10.1, 9.9, -20.1, 19.9) ea <- align(e, r) e #> SpatExtent : -10.1, 9.9, -20.1, 19.9 (xmin, xmax, ymin, ymax) ext(r) #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax) ea #> SpatExtent : -10, 10, -20, 20 (xmin, xmax, ymin, ymax)  align(e, 0.5) #> SpatExtent : -10.5, 10, -20.5, 20 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare two SpatRasters for equality — all.equal","title":"Compare two SpatRasters for equality — all.equal","text":"Compare two SpatRasters (near) equality. First attributes objects compared. , (perhaps small) sample raster cells compared well. sample size used can increased maxcell argument. can set Inf, large rasters computer may sufficient memory. See examples safe way compare values.","code":""},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare two SpatRasters for equality — all.equal","text":"","code":"# S4 method for SpatRaster,SpatRaster all.equal(target, current, maxcell=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare two SpatRasters for equality — all.equal","text":"target SpatRaster current SpatRaster maxcell positive integer. size regular sample used compare cell values ... additional arguments passed .equal.numeric compare cell values","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare two SpatRasters for equality — all.equal","text":"Either TRUE character vector describing differences target current.","code":""},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare two SpatRasters for equality — all.equal","text":"","code":"x <- sqrt(1:100) mat <- matrix(x, 10, 10) r1 <- rast(nrows=10, ncols=10, xmin=0, vals = x) r2 <- rast(nrows=10, ncols=10, xmin=0, vals = mat)  all.equal(r1, r2) #> [1] \"Mean relative difference: 0.3858482\" all.equal(r1, r1*1) #> [1] TRUE all.equal(rast(r1), rast(r2)) #> [1] TRUE  # compare geometries  compareGeom(r1, r2) #> [1] TRUE  # Compare all cell values for near equality # as floating point number imprecision can be a problem m <- minmax(r1 - r2) all(abs(m) < 1e-7) #> [1] FALSE  # comparison of cell values to create new SpatRaster e <- r1 == r2"},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":null,"dir":"Reference","previous_headings":"","what":"Animate a SpatRaster — animate","title":"Animate a SpatRaster — animate","text":"Animate (sequentially plot) layers SpatRaster create movie. work R-Studio.","code":""},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Animate a SpatRaster — animate","text":"","code":"# S4 method for SpatRaster animate(x, pause=0.25, main, range, maxcell=50000, n=1, ...)"},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Animate a SpatRaster — animate","text":"x SpatRaster pause numeric. long pause layers? main title layer. supplied z-value used available. Otherwise names used. range numeric vector length 2. Range values plot maxcell positive integer. Maximum number cells use plot. maxcell < ncell(x), spatSample(type=\"regular\") used plotting n integer > 0. Number loops ... Additional arguments passed plot","code":""},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Animate a SpatRaster — animate","text":"None","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Animate a SpatRaster — animate","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    animate(s, n=1)"},{"path":"https://rspatial.github.io/terra/reference/app.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to the cells of a SpatRaster — app","title":"Apply a function to the cells of a SpatRaster — app","text":"Apply function values cell SpatRaster. Similar apply -- think layer SpatRaster column (row) matrix. generally used summarize values multiple layers one layer; required. app calls function fun raster data first argument. Depending function supplied, raster data represented either matrix layer column, vector representing cell. function return vector matrix divisible ncell(x). Thus, \"sum\" \"rowSums\" can used, \"colSums\" used. can also apply function fun across datasets layer SpatRasterDataset. case, summarization layer across SpatRasters.","code":""},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to the cells of a SpatRaster — app","text":"","code":"# S4 method for SpatRaster app(x, fun, ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterDataset app(x, fun, ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to the cells of a SpatRaster — app","text":"x SpatRaster SpatRasterDataset fun function operates vector matrix. can function defined base-R package, function write (see examples). Functions return complex output (e.g. list) may need wrapped function simplify output vector matrix. following functions re-implemented C++ speed: \"sum\", \"mean\", \"median\", \"modal\", \"\", \".min\", \".max\", \"min\", \"max\", \"prod\", \"\", \"\", \"sd\", \"std\", \"first\". use base-R function say, \"min\", use something like fun=function() min() equivalent fun = \\() min() ... additional arguments fun. typically numerical constants. *never* another SpatRaster cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object. Ignored functions implemented terra C++ (see fun) filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to the cells of a SpatRaster — app","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply a function to the cells of a SpatRaster — app","text":"speed things , parallelization supported, often helpful, may actually slower. speed gain many cores (> 8) /complex (slow) function fun. write fun , consider supplying cppFunction made Rcpp package instead (go cup tea computer works ).","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to the cells of a SpatRaster — app","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) x <- c(r, sqrt(r), r+50) s <- app(x, fun=sum) s #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : sum  #> min value   :  53  #> max value   : 260  # for a few generic functions like  # \"sum\", \"mean\", and \"max\" you can also do sum(x) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : sum  #> min value   :  53  #> max value   : 260   ## SpatRasterDataset sd <- sds(x, x*2, x/3) a <- app(sd, max) a #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     2,     2,   102  #> max values  :   200,    20,   300  # same as  max(x, x*2, x/3) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     2,     2,   102  #> max values  :   200,    20,   300  # and as (but slower) b <- app(sd, function(i) max(i))   ## also works for a single layer f <- function(i) (i+1) * 2 * i + sqrt(i) s <- app(r, f) # same as above, but that is not memory-safe # and has no filename argument  s <- f(r)  if (FALSE) { #### multiple cores  test0 <- app(x, sqrt)  test1 <- app(x, sqrt, cores=2)  testfun <- function(i) { 2 * sqrt(i) } test2 <- app(x, fun=testfun, cores =2)  ## this fails because testfun is not exported to the nodes # test3 <- app(x, fun=function(i) testfun(i), cores=2) ## to export it, add it as argument to fun test3 <- app(x, fun=function(i, ff) ff(i), cores =3, ff=testfun) }"},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":null,"dir":"Reference","previous_headings":"","what":"Estimate values for cell values that are NA by interpolating between layers — approximate","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"approximate uses stats function approx estimate values cells NA interpolation across layers. Layers considered equidistant, unless argument z used, time(x) returns values NA, case values used determine distance layers. estimation based neighboring cells see focal","code":""},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"","code":"# S4 method for SpatRaster approximate(x, method=\"linear\", yleft, yright,             rule=1, f=0, ties=mean, z=NULL, NArule=1,filename=\"\",  ...)"},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"x SpatRaster method specifies interpolation method used. Choices \"linear\" \"constant\" (step function; see example approx yleft value returned non-NA value encountered. default defined value rule given yright value returned last non-NA value encountered. default defined value rule given rule integer (length 1 2) describing interpolation take place first last cells (non-NA values encountered). rule 1 NAs returned points 2, value closest data extreme used. Use, e.g., rule = 2:1, left right side extrapolation differ f method = \"constant\" number 0 1 inclusive, indicating compromise left- right-continuous step functions. y0 y1 values left right point value y0*(1-f)+y1*f f = 0) right-continuous f = 1 left-continuous ties Handling tied 'z' values. Either function single vector argument returning single number result string \"ordered\" z numeric vector indicate distance layers (e.g., depth). default time(x) NA else 1:nlys(x) NArule single integer used determine single layer non-NA value encountered (linear interpolation possible). default value 1 indicates layers get value cell; values change cell values filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"","code":"r <- rast(ncols=5, nrows=5) r1 <- setValues(r, runif(ncell(r))) r2 <- setValues(r, runif(ncell(r))) r3 <- setValues(r, runif(ncell(r))) r4 <- setValues(r, runif(ncell(r))) r5 <- setValues(r, NA) r6 <- setValues(r, runif(ncell(r))) r1[6:10] <- NA r2[5:15] <- NA r3[8:25] <- NA s <- c(r1,r2,r3,r4,r5,r6) s[1:5] <- NA x1 <- approximate(s) x2 <- approximate(s, rule=2) x3 <- approximate(s, rule=2, z=c(1,2,3,5,14,15))"},{"path":"https://rspatial.github.io/terra/reference/arith-generic.html","id":null,"dir":"Reference","previous_headings":"","what":"Arithmetic — Arith-methods","title":"Arithmetic — Arith-methods","text":"Standard arithmetic operators computations SpatRasters. Computations local (applied cell cell basis). multiple SpatRasters used, must geometry (extent resolution). operators implemented: +, -, *, /, ^, %%, %/% can also use SpatRaster vector matrix. use SpatRaster vector multiple numbers, element vector considered layer (constant value). use SpatRaster matrix, number columns matrix must match number layers SpatRaster. rows used match cells. , two rows, match cells 1 2, recycled 3 4, etc. following methods implemented (SpatExtent, SpatExtent): +, -, following (SpatExtent, numeric): +, -, *, /, %%","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/arith-generic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Arithmetic — Arith-methods","text":"SpatRaster SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/arith-generic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Arithmetic — Arith-methods","text":"","code":"r1 <- rast(ncols=10, nrows=10) v <- runif(ncell(r1)) v[10:20] <- NA values(r1) <- v r2 <- rast(r1) values(r2) <- 1:ncell(r2) / ncell(r2) r3 <- r1 + r2 r2 <- r1 / 10 r3 <- r1 * (r2 - 1 / r2)  b <- c(r1, r2, r3) b2 <- b * 10  ### SpatExtent methods x <- ext(0.1, 2.2, 0, 3) y <- ext(-2, 1, -2,2) # union x + y #> SpatExtent : -2, 2.2, -2, 3 (xmin, xmax, ymin, ymax) # intersection x * y #> SpatExtent : 0.1, 1, 0, 2 (xmin, xmax, ymin, ymax)  e <- x  e #> SpatExtent : 0.1, 2.2, 0, 3 (xmin, xmax, ymin, ymax) e * 2 #> SpatExtent : -0.95, 3.25, -1.5, 4.5 (xmin, xmax, ymin, ymax) e / 2 #> SpatExtent : 0.625, 1.675, 0.75, 2.25 (xmin, xmax, ymin, ymax) e + 1 #> SpatExtent : -0.9, 3.2, -1, 4 (xmin, xmax, ymin, ymax) e - 1 #> SpatExtent : 1.1, 1.2, 1, 2 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a text representation of (the skeleton of) an object — as.character","title":"Create a text representation of (the skeleton of) an object — as.character","text":"Create text representation (skeleton ) object","code":""},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a text representation of (the skeleton of) an object — as.character","text":"","code":"# S4 method for SpatExtent as.character(x)  # S4 method for SpatRaster as.character(x)"},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a text representation of (the skeleton of) an object — as.character","text":"x SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a text representation of (the skeleton of) an object — as.character","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a text representation of (the skeleton of) an object — as.character","text":"","code":"r <- rast() ext(r) #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax) ext(c(0, 20, 0, 20)) #> SpatExtent : 0, 20, 0, 20 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster or SpatVector to data.frame — as.data.frame","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"Coerce SpatRaster SpatVector data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"","code":"# S4 method for SpatVector as.data.frame(x, row.names=NULL, optional=FALSE, geom=NULL, ...)  # S4 method for SpatRaster as.data.frame(x, row.names=NULL, optional=FALSE, xy=FALSE,    cells=FALSE, time=FALSE, na.rm=NA, wide=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"x SpatRaster SpatVector geom character NULL. NULL, either \"WKT\" \"HEX\", get geometry included Well-Known-Text hexadecimal notation. x point geometry, can also \"XY\" add coordinates point xy logical. TRUE, coordinates raster cell included time logical. TRUE, time data included (available) na.rm logical. TRUE, cells NA value least one layer removed. argument set NA cells NA values layers removed cells logical. TRUE, cell numbers raster cell included wide logical. FALSE, data.frame returned \"long\" format ... Additional arguments passed data.frame row.names argument ignored optional argument ignored","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) as.data.frame(v) #>    ID_1       NAME_1 ID_2           NAME_2 AREA    POP #> 1     1     Diekirch    1         Clervaux  312  18081 #> 2     1     Diekirch    2         Diekirch  218  32543 #> 3     1     Diekirch    3          Redange  259  18664 #> 4     1     Diekirch    4          Vianden   76   5163 #> 5     1     Diekirch    5            Wiltz  263  16735 #> 6     2 Grevenmacher    6       Echternach  188  18899 #> 7     2 Grevenmacher    7           Remich  129  22366 #> 8     2 Grevenmacher   12     Grevenmacher  210  29828 #> 9     3   Luxembourg    8         Capellen  185  48187 #> 10    3   Luxembourg    9 Esch-sur-Alzette  251 176820 #> 11    3   Luxembourg   10       Luxembourg  237 182607 #> 12    3   Luxembourg   11           Mersch  233  32112"},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":null,"dir":"Reference","previous_headings":"","what":"Conversion to a SpatVector of lines — as.lines","title":"Conversion to a SpatVector of lines — as.lines","text":"Conversion SpatRaster, SpatVector SpatExtent SpatVector lines.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Conversion to a SpatVector of lines — as.lines","text":"","code":"# S4 method for SpatRaster as.lines(x)  # S4 method for SpatVector as.lines(x)  # S4 method for SpatExtent as.lines(x, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Conversion to a SpatVector of lines — as.lines","text":"x SpatRaster, SpatVector SpatExtent crs character. coordinate reference system (see crs)","code":""},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Conversion to a SpatVector of lines — as.lines","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Conversion to a SpatVector of lines — as.lines","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  as.lines(r) #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 6, 0  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)   as.lines(ext(r), crs=crs(r)) #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 1, 0  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)   if  (gdal() >= \"3.0.0\") {   p <- as.polygons(r)   as.lines(p) } #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 4, 1  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <int> #>  values      :     1 #>                    2 #>                    3"},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerce a Spat* object to a list — as.list","title":"Coerce a Spat* object to a list — as.list","text":"Coerce SpatRaster, SpatRasterCollection, SpatRasterDataset, SpatVector SpatVectorCollection list. SpatRaster, layer becomes list element. SpatRasterCollection SpatRasterDataset, SpatRaster becomes list element. SpatVector, variable (attribute) becomes list element. SpatVectorCollection, SpatVector becomes list element.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerce a Spat* object to a list — as.list","text":"","code":"# S4 method for SpatRaster as.list(x, geom=NULL, ...)  # S4 method for SpatRasterCollection as.list(x, ...)  # S4 method for SpatVector as.list(x, geom=NULL, ...)  # S4 method for SpatVectorCollection as.list(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerce a Spat* object to a list — as.list","text":"x SpatRaster, SpatRasterDataset, SpatRasterCollection, SpatVector geom character NULL. NULL, x SpatVector, either \"WKT\" \"HEX\", get geometry included Well-Known-Text hexadecimal notation. x point geometry, can also bey \"XY\" add coordinates point. x SpatRaster, value NULL return list parameters describing geometry SpatRaster returned ... additional arguments. ignored","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerce a Spat* object to a list — as.list","text":"list","code":""},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coerce a Spat* object to a list — as.list","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) as.list(v) #> $ID_1 #>  [1] 1 1 1 1 1 2 2 2 3 3 3 3 #>  #> $NAME_1 #>  [1] \"Diekirch\"     \"Diekirch\"     \"Diekirch\"     \"Diekirch\"     \"Diekirch\"     #>  [6] \"Grevenmacher\" \"Grevenmacher\" \"Grevenmacher\" \"Luxembourg\"   \"Luxembourg\"   #> [11] \"Luxembourg\"   \"Luxembourg\"   #>  #> $ID_2 #>  [1]  1  2  3  4  5  6  7 12  8  9 10 11 #>  #> $NAME_2 #>  [1] \"Clervaux\"         \"Diekirch\"         \"Redange\"          \"Vianden\"          #>  [5] \"Wiltz\"            \"Echternach\"       \"Remich\"           \"Grevenmacher\"     #>  [9] \"Capellen\"         \"Esch-sur-Alzette\" \"Luxembourg\"       \"Mersch\"           #>  #> $AREA #>  [1] 312 218 259  76 263 188 129 210 185 251 237 233 #>  #> $POP #>  [1]  18081  32543  18664   5163  16735  18899  22366  29828  48187 176820 #> [11] 182607  32112 #>    s <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) + 1   as.list(s) #> [[1]] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> name        : red  #> min value   :   1  #> max value   : 256  #>  #> [[2]] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> name        : green  #> min value   :     1  #> max value   :   256  #>  #> [[3]] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> name        : blue  #> min value   :    1  #> max value   :  256  #>"},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":null,"dir":"Reference","previous_headings":"","what":"Conversion to a SpatVector of points — as.points","title":"Conversion to a SpatVector of points — as.points","text":"Conversion SpatRaster, SpatVector SpatExtent SpatVector points.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Conversion to a SpatVector of points — as.points","text":"","code":"# S4 method for SpatRaster as.points(x, values=TRUE, na.rm=TRUE, na.all=FALSE)  # S4 method for SpatVector as.points(x, multi=FALSE, skiplast=TRUE)  # S4 method for SpatExtent as.points(x, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Conversion to a SpatVector of points — as.points","text":"x SpatRaster, SpatVector SpatExtent values logical; include cell values attributes? multi logical. TRUE multi-point geometry returned skiplast logical. TRUE last point polygon (first point) included na.rm logical. TRUE cells NA ignored na.logical. TRUE cells ignored na.rm=TRUE value NA layers instead layer crs character. coordinate reference system (see crs)","code":""},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Conversion to a SpatVector of points — as.points","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Conversion to a SpatVector of points — as.points","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  as.points(r) #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 4, 1  (geometries, attributes) #>  extent      : -90, 90, -45, 45  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <num> #>  values      :     1 #>                    2 #>                    3  if  (gdal() >= \"3.0.0\") {   p <- as.polygons(r)   as.points(p) } #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 16, 1  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <int> #>  values      :     1 #>                    1 #>                    1"},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":null,"dir":"Reference","previous_headings":"","what":"Conversion to a SpatVector of polygons — as.polygons","title":"Conversion to a SpatVector of polygons — as.polygons","text":"Conversion SpatRaster, SpatVector SpatExtent SpatVector polygons.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Conversion to a SpatVector of polygons — as.polygons","text":"","code":"# S4 method for SpatRaster as.polygons(x, round=TRUE, aggregate=TRUE, values=TRUE,     na.rm=TRUE, na.all=FALSE, extent=FALSE, digits=0, ...)  # S4 method for SpatVector as.polygons(x, extent=FALSE)  # S4 method for SpatExtent as.polygons(x, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Conversion to a SpatVector of polygons — as.polygons","text":"x SpatRaster, SpatVector SpatExtent round logical; TRUE aggregate=TRUE, values rounded aggregation. value FALSE SpatVector returned can many polygons can large aggregate logical; combine cells values? TRUE first layer x processed values logical; include cell values attributes? extent logical. TRUE, polygon extent SpatRaster SpatVector returned. x SpatRaster, polygon vertices row column, just four corners raster. can useful precise projection. required, efficient get extent represented four corners .polygons(ext(x), crs=crs(x)) na.rm logical. TRUE cells NA ignored na.logical. TRUE cells ignored na.rm=TRUE value NA layers instead layer digits integer. number digits rounding (round=TRUE) crs character. coordinate reference system (see crs) ... additional arguments. backward compatibility. removed future","code":""},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Conversion to a SpatVector of polygons — as.polygons","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Conversion to a SpatVector of polygons — as.polygons","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  if  (gdal() >= \"3.0.0\") {   p <- as.polygons(r)   p } #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 4, 1  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <int> #>  values      :     1 #>                    2 #>                    3"},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerce to a ","title":"Coerce to a ","text":"Implementation generic .raster function create \"raster\" (small r) object. objects can used plotting rasterImage function. CONFUSED Raster* (big R) objects defined 'raster' package!","code":""},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerce to a ","text":"","code":"# S4 method for SpatRaster as.raster(x, maxcell=500000, col)"},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerce to a ","text":"x SpatRaster maxcell positive integer. Maximum number cells use plot col vector colors. default map.pal(\"viridis\", 100)","code":""},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerce to a ","text":"'raster' object","code":""},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coerce to a ","text":"","code":"r <- rast(ncols=3, nrows=3) values(r) <- 1:ncell(r) as.raster(r) #>      [,1]      [,2]      [,3]      #> [1,] \"#440154\" \"#472B7A\" \"#3A528B\" #> [2,] \"#2C718E\" \"#218F8D\" \"#27AD80\" #> [3,] \"#5BC863\" \"#ADDC2F\" \"#FDE725\""},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":null,"dir":"Reference","previous_headings":"","what":"Two argument arc-tangent — atan2","title":"Two argument arc-tangent — atan2","text":"SpatRasters x y, atan2(y, x) returns angle radians tangent y/x, handling case x zero. See Trig See Math-methods trigonometric mathematical functions can used SpatRasters.","code":""},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Two argument arc-tangent — atan2","text":"","code":"# S4 method for SpatRaster,SpatRaster atan2(y, x)  # S4 method for SpatRaster,SpatRaster atan_2(y, x, filename, ...)"},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Two argument arc-tangent — atan2","text":"y SpatRaster x SpatRaster filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Two argument arc-tangent — atan2","text":"","code":"r1 <- rast(nrows=10, ncols=10) r2 <- rast(nrows=10, ncols=10) values(r1) <- (runif(ncell(r1))-0.5) * 10 values(r2) <- (runif(ncell(r1))-0.5) * 10 atan2(r1, r2) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :     lyr.1  #> min value   : -3.125421  #> max value   :  2.948635"},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial autocorrelation — autocorrelation","title":"Spatial autocorrelation — autocorrelation","text":"Compute spatial autocorrelation numeric vector SpatRaster. can compute standard (global) Moran's Geary's C, local indicators spatial autocorrelation (Anselin, 1995).","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial autocorrelation — autocorrelation","text":"","code":"# S4 method for numeric autocor(x, w, method=\"moran\")  # S4 method for SpatRaster autocor(x, w=matrix(c(1,1,1,1,0,1,1,1,1),3), method=\"moran\", global=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial autocorrelation — autocorrelation","text":"x numeric SpatRaster w Spatial weights defined rectangular matrix. SpatRaster matrix must sides must odd length (3, 5, ...) global logical. TRUE global autocorrelation computed instead local autocorrelation method character. x numeric SpatRaster: \"moran\" Moran's \"geary\" Geary's C. x numeric also: \"Gi\", \"Gi*\" (Getis-Ord statistics), locmor (local Moran's ) \"mean\" (local mean)","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial autocorrelation — autocorrelation","text":"numeric SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Spatial autocorrelation — autocorrelation","text":"default setting uses 3x3 neighborhood compute \"Queen's case\" indices. can use filter (weights matrix) things, \"Rook's case\", different lags.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Spatial autocorrelation — autocorrelation","text":"Moran, P..P., 1950. Notes continuous stochastic phenomena. Biometrika 37:17-23 Geary, R.C., 1954. contiguity ratio statistical mapping. Incorporated Statistician 5: 115-145 Anselin, L., 1995. Local indicators spatial association-LISA. Geographical Analysis 27:93-115 https://en.wikipedia.org/wiki/Indicators_of_spatial_association","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial autocorrelation — autocorrelation","text":"","code":"### raster r <- rast(nrows=10, ncols=10, xmin=0) values(r) <- 1:ncell(r)  autocor(r) #>    lyr.1  #> 1.117188   # rook's case neighbors f <- matrix(c(0,1,0,1,0,1,0,1,0), nrow=3) autocor(r, f) #> lyr.1  #>  1.25   # local  rc <- autocor(r, w=f, global=FALSE)  ### numeric (for vector data) f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- relate(v, relation=\"touches\")  # global autocor(v$AREA, w) #> [1] -0.1531971  # local v$Gi <- autocor(v$AREA, w, \"Gi\")  plot(v, \"Gi\")"},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":null,"dir":"Reference","previous_headings":"","what":"Bar plot of a SpatRaster — barplot","title":"Bar plot of a SpatRaster — barplot","text":"Create barplot values first layer SpatRaster. large datasets regular sample size approximately maxcells used.","code":""},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Bar plot of a SpatRaster — barplot","text":"","code":"# S4 method for SpatRaster barplot(height, maxcell=1000000, digits=0, breaks=NULL, col, ...)"},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Bar plot of a SpatRaster — barplot","text":"height SpatRaster maxcell integer. regularly subsample large datasets digits integer used determine round values tabulating. Set NULL large number want rounding breaks breaks used group data cut col color generating function rainbow (default), vector colors ... additional arguments plotting barplot","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Bar plot of a SpatRaster — barplot","text":"numeric vector (matrix, beside = TRUE) coordinates bar midpoints, useful adding graph. See barplot","code":""},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Bar plot of a SpatRaster — barplot","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) barplot(r, digits=-1, las=2, ylab=\"Frequency\")   op <- par(no.readonly = TRUE) par(mai = c(1, 2, .5, .5)) barplot(r, breaks=10, col=c(\"red\", \"blue\"), horiz=TRUE, digits=NULL, las=1)  par(op)"},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":null,"dir":"Reference","previous_headings":"","what":"bestMatch — bestMatch","title":"bestMatch — bestMatch","text":"Determine grid cell reference similar . reference consists SpatVector reference locations, data.frame column matches layer name SpatRaster. Similarity computed sum squared differences cell reference. may important first scale input.","code":""},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"bestMatch — bestMatch","text":"","code":"# S4 method for SpatRaster,SpatVector bestMatch(x, y, labels=\"\", filename=\"\", ...)  # S4 method for SpatRaster,data.frame bestMatch(x, y, labels=\"\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"bestMatch — bestMatch","text":"x SpatRaster y SpatVector data.frame labels character. labels correspond class (row y filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"bestMatch — bestMatch","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"bestMatch — bestMatch","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f)  # locations of interest  pts <- vect(cbind(c(25.25, 34.324, 43.003), c(54.577, 46.489, 30.905))) pts$code <- LETTERS[1:3]  plot(r) points(pts, pch=20, cex=2, col=\"red\") text(pts, \"code\", pos=4, halo=TRUE)   x <- scale(r)  s1 <- bestMatch(x, pts, labels=pts$code) plot(s1)   # same result e <- extract(x, pts, ID=FALSE) s2 <- bestMatch(x, e, labels=c(\"Ap\", \"Nt\", \"Ms\"))"},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":null,"dir":"Reference","previous_headings":"","what":"Detect boundaries (edges) — boundaries","title":"Detect boundaries (edges) — boundaries","text":"Detect boundaries (edges). Boundaries cells one class 4 8 cells surrounding , , classes=FALSE, cells values cells NA.","code":""},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Detect boundaries (edges) — boundaries","text":"","code":"# S4 method for SpatRaster boundaries(x, classes=FALSE, inner=TRUE,           directions=8, falseval=0, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Detect boundaries (edges) — boundaries","text":"x SpatRaster inner logical. TRUE, \"inner\" boundaries returned, else \"outer\" boundaries returned classes character. Logical. TRUE different values (rounding) distinguished, well NA. FALSE (default) edges NA non-NA cells considered directions integer. cells considered adjacent? 8 (Queen's case) 4 (Rook's case) falseval numeric. value use cells boundary NA filename character. Output filename ... options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Detect boundaries (edges) — boundaries","text":"SpatRaster. Cell values either 1 (border) 0 (border), NA","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Detect boundaries (edges) — boundaries","text":"","code":"r <- rast(nrows=18, ncols=36, xmin=0) r[150:250] <- 1 r[251:450] <- 2 bi <- boundaries(r) bo <- boundaries(r, inner=FALSE) bc <- boundaries(r, classes=TRUE) #plot(bc)"},{"path":"https://rspatial.github.io/terra/reference/box.html","id":null,"dir":"Reference","previous_headings":"","what":"draw a box — add_box","title":"draw a box — add_box","text":"Similar box allowing adding box around map. function place legend locations within mapped area delineated axes.","code":""},{"path":"https://rspatial.github.io/terra/reference/box.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"draw a box — add_box","text":"","code":"add_box(...)"},{"path":"https://rspatial.github.io/terra/reference/box.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"draw a box — add_box","text":"... arguments passed lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/box.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"draw a box — add_box","text":"","code":"v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) plot(v) add_box(col=\"red\", lwd=3, xpd=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":null,"dir":"Reference","previous_headings":"","what":"Box plot of SpatRaster data — boxplot","title":"Box plot of SpatRaster data — boxplot","text":"Box plot layers SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Box plot of SpatRaster data — boxplot","text":"","code":"# S4 method for SpatRaster boxplot(x, y=NULL, maxcell=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Box plot of SpatRaster data — boxplot","text":"x SpatRaster y NULL SpatRaster. x SpatRaster used group values x \"zone\" maxcell Integer. Number cells sample datasets ... additional arguments passed graphics::boxplot","code":""},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Box plot of SpatRaster data — boxplot","text":"boxplot returns list (invisibly) can used bxp","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Box plot of SpatRaster data — boxplot","text":"","code":"r1 <- r2 <- r3 <- rast(ncols=10, nrows=10) set.seed(409) values(r1) <- rnorm(ncell(r1), 100, 40) values(r2) <- rnorm(ncell(r1), 80, 10) values(r3) <- rnorm(ncell(r1), 120, 30) s <- c(r1, r2, r3) names(s) <- c(\"Apple\", \"Pear\", \"Cherry\")  boxplot(s, notch=TRUE, col=c(\"red\", \"blue\", \"orange\"), main=\"Box plot\", ylab=\"random\", las=1)   op <- par(no.readonly = TRUE) par(mar=c(4,6,2,2)) boxplot(s, horizontal=TRUE, col=\"lightskyblue\", axes=FALSE) axis(1) axis(2, at=0:3, labels=c(\"\", names(s)), las=1, cex.axis=.9, lty=0)  par(op)  ## boxplot with 2 layers v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) y <- rasterize(v, r, \"NAME_2\") b <- boxplot(r, y)  bxp(b)"},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a buffer around vector geometries or raster patches — buffer","title":"Create a buffer around vector geometries or raster patches — buffer","text":"Calculate buffer around cells NA SpatRaster, around geometries SpatVector. SpatRaster cells inside buffer distance get value 1. Note distance unit buffer width parameter meters CRS (+proj=longlat), map units (typically also meters) .","code":""},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a buffer around vector geometries or raster patches — buffer","text":"","code":"# S4 method for SpatRaster buffer(x, width, background=0, filename=\"\", ...)  # S4 method for SpatVector buffer(x, width, quadsegs=10, capstyle=\"round\",      joinstyle=\"round\", mitrelimit=NA, singlesided=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a buffer around vector geometries or raster patches — buffer","text":"x SpatRaster SpatVector width numeric. Unit meter x longitude/latitude CRS, units coordinate reference system cases (typically also meter). value > 0 x SpatRaster. x SpatVector, argument vectorized, meaning can provide different value geometry x; can also use name variable x widths filename character. Output filename ... additional arguments writing files writeRaster background numeric. value assign cells outside buffer. value zero FALSE, boolean SpatRaster returned quadsegs positive integer. Number line segments use draw quart circle capstyle character. One \"round\", \"square\" \"flat\". Ignored .lonlat(x) joinstyle character. One \"round\", \"mitre\" \"bevel\". Ignored .lonlat(x) mitrelimit numeric. Place upper bound mitre join avoid extending far acute angles input geometry. Ignored .lonlat(x) singlesided logical. TRUE buffer constructed one side input line.  Ignored .lonlat(x)","code":""},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a buffer around vector geometries or raster patches — buffer","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a buffer around vector geometries or raster patches — buffer","text":"","code":"r <- rast(ncols=36, nrows=18) r[500] <- 1 b <- buffer(r, width=5000000)  plot(b)   v <- vect(rbind(c(10,10), c(0,60)), crs=\"+proj=merc\") b <- buffer(v, 20) plot(b) points(v)   crs(v) <- \"+proj=longlat\"  b <- buffer(v, 1500000) plot(b) points(v)"},{"path":"https://rspatial.github.io/terra/reference/c.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine SpatRaster or SpatVector objects — c","title":"Combine SpatRaster or SpatVector objects — c","text":"c can: -- Combine SpatRaster objects. must extent resolution. However, x empty (cell values), geometry ignored warning. Two empty SpatRasters geometry can also combined (get summed number layers). Also see add<- -- Add SpatRaster SpatRasterDataset SpatRasterCollection -- Add SpatVector objects new existing SpatVectorCollection append SpatVectors, use rbind.","code":""},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine SpatRaster or SpatVector objects — c","text":"","code":"# S4 method for SpatRaster c(x, ..., warn=TRUE)  # S4 method for SpatRasterDataset c(x, ...)  # S4 method for SpatRasterCollection c(x, ...)  # S4 method for SpatVector c(x, ...)  # S4 method for SpatVectorCollection c(x, ...)"},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine SpatRaster or SpatVector objects — c","text":"x SpatRaster, SpatVector, SpatRasterDataset SpatVectorCollection warn logical. TRUE, warning emitted x empty SpatRaster ... x (can combine raster raster data vector vector data)","code":""},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine SpatRaster or SpatVector objects — c","text":"class x","code":""},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Combine SpatRaster or SpatVector objects — c","text":"","code":"r <- rast(nrows=5, ncols=9) values(r) <- 1:ncell(r) x <- c(r, r*2, r*3)"},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Cartogram — cartogram","title":"Cartogram — cartogram","text":"Make cartogram, , map area polygons made proportional another variable. can good way map raw count data (e.g. votes).","code":""},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cartogram — cartogram","text":"","code":"# S4 method for SpatVector cartogram(x, var, type)"},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cartogram — cartogram","text":"x SpatVector var character. variable name x type character. Cartogram type, \"nc\" (non-contiguous) currently supported","code":""},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cartogram — cartogram","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cartogram — cartogram","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$value <- 1:12 p <- cartogram(v, \"value\", \"nc\") plot(v, col=\"light gray\", border=\"gray\") lines(p, col=\"red\", lwd=2)"},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":null,"dir":"Reference","previous_headings":"","what":"Factors to numeric — catalyze","title":"Factors to numeric — catalyze","text":"Change categorical layer one numerical layers. .numeric can transfer active category values cell values non-categorical SpatRaster. catalyze creates new layers category.","code":""},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Factors to numeric — catalyze","text":"","code":"# S4 method for SpatRaster as.numeric(x, index=NULL, filename=\"\", ...)  # S4 method for SpatRaster catalyze(x, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Factors to numeric — catalyze","text":"x SpatRaster index positive integer category indicating category use. NULL active category used filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Factors to numeric — catalyze","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Factors to numeric — catalyze","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) + 10 d <- data.frame(id=11:13, cover=c(\"forest\", \"water\", \"urban\"), letters=letters[1:3], value=10:12) levels(r) <- d catalyze(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : cover, letters, value  #> min values  :     1,       1,    10  #> max values  :     3,       3,    12   activeCat(r) <- 3 as.numeric(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : letters  #> min value   :       1  #> max value   :       3"},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":null,"dir":"Reference","previous_headings":"","what":"Area covered by each raster cell — cellSize","title":"Area covered by each raster cell — cellSize","text":"Compute area covered individual raster cells. Computing surface area raster cells especially relevant longitude/latitude rasters. note angular (longitude/latitude) planar (projected) coordinate reference systems raster cells sizes generally constant, unless using equal-area coordinate reference system. planar CRSs, area therefore computed based linear units coordinate reference system, *actual* area transforming cells longitude/latitude. want correction, can use transform=FALSE init(x, prod(res(x)))","code":""},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Area covered by each raster cell — cellSize","text":"","code":"# S4 method for SpatRaster cellSize(x, mask=FALSE, lyrs=FALSE, unit=\"m\", transform=TRUE, rcx=100, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Area covered by each raster cell — cellSize","text":"x SpatRaster mask logical. TRUE, cells NA x also NA output lyrs logical. TRUE mask=TRUE, output number layers x. useful cases layers x different cells NA unit character. One \"m\", \"km\", \"ha\" transform logical. TRUE, planar CRS data transformed lon/lat accuracy rcx positive integer. maximum number rows columns used compute area planar data transform=TRUE. x rows /columns, raster aggregated match limit, values original cells estimated bilinear interpolation (see resample). can save lot time filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Area covered by each raster cell — cellSize","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Area covered by each raster cell — cellSize","text":"","code":"# SpatRaster  r <- rast(nrows=18, ncols=36) v <- 1:ncell(r) v[200:400] <- NA values(r) <- v  # size of each raster cell a <- cellSize(r)  # illustration of distortion r <- rast(ncols=90, nrows=45, ymin=-80, ymax=80) m <- project(r, \"+proj=merc\")  bad <- init(m, prod(res(m)) / 1000000, names=\"naive\") good <- cellSize(m, unit=\"km\", names=\"corrected\") plot(c(good, bad), nc=1, mar=c(2,2,1,6))"},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":null,"dir":"Reference","previous_headings":"","what":"Get cell numbers — cells","title":"Get cell numbers — cells","text":"Get cell numbers covered SpatVector SpatExtent. match values vector; non NA values.","code":""},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get cell numbers — cells","text":"","code":"# S4 method for SpatRaster,missing cells(x, y)  # S4 method for SpatRaster,numeric cells(x, y, pairs=FALSE)  # S4 method for SpatRaster,SpatVector cells(x, y, method=\"simple\", weights=FALSE, exact=FALSE,          touches=is.lines(y), small=TRUE)  # S4 method for SpatRaster,SpatExtent cells(x, y)"},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get cell numbers — cells","text":"x SpatRaster y SpatVector, SpatExtent, 2-column matrix representing points, numeric representing values match, missing method character. Method getting cell numbers points. default \"simple\", alternative \"bilinear\". \"bilinear\", four nearest cells weights returned weights logical. TRUE y polygons, approximate fraction cell covered returned well pairs logical. TRUE cell values matched area also returned exact logical. TRUE y polygons, exact fraction cell covered returned well touches logical. TRUE, values cells touched lines polygons extracted, just line render path, whose center point within polygon. relevant points small logical. TRUE, values cells touched polygons extracted none cells center points within polygon; even touches=FALSE","code":""},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get cell numbers — cells","text":"numeric vector matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get cell numbers — cells","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) r[c(1:25, 31:100)] <- NA r <- ifel(r > 28, r + 10, r)  # all cell numbers of cells that are not NA cells(r) #> [1] 26 27 28 29 30  # cell numbers that match values x <- cells(r, c(28,38)) x$lyr.1 #> [1] 28  # cells for points m <- cbind(x=c(0,10,-30), y=c(40,-10,20)) cellFromXY(r, m) #> [1] 26 56 35  v <- vect(m) cells(r, v) #>      ID cell #> [1,]  1   26 #> [2,]  2   56 #> [3,]  3   35 cells(r, v, method=\"bilinear\") #>      ID c1 c2 c3 c4  w1  w2  w3  w4 #> [1,]  1 25 26 35 36   0   1   0   0 #> [2,]  2 55 56 65 66 NaN NaN NaN NaN #> [3,]  3 34 35 44 45 NaN NaN NaN NaN  # cells for polygons f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) r <- rast(v) cv <- cells(r, v)"},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":null,"dir":"Reference","previous_headings":"","what":"Centroids — centroids","title":"Centroids — centroids","text":"Get centroids polygons lines, centroid-like points guaranteed inside polygons lines.","code":""},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Centroids — centroids","text":"","code":"# S4 method for SpatVector centroids(x, inside=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Centroids — centroids","text":"x SpatVector inside logical. TRUE points returned guaranteed inside polygons lines, true centroids. True centroids may outside polygon, example polygon \"bean shaped\", unlikely line","code":""},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Centroids — centroids","text":"SpatVector points","code":""},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Centroids — centroids","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) x <- centroids(v) y <- centroids(v, TRUE)"},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":null,"dir":"Reference","previous_headings":"","what":"Clamp values — clamp","title":"Clamp values — clamp","text":"Clamp values minimum maximum value. , values lower threshold value upper threshold value become either NA, , values=TRUE, become threshold value","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clamp values — clamp","text":"","code":"# S4 method for SpatRaster clamp(x, lower=-Inf, upper=Inf, values=TRUE, filename=\"\", ...)  # S4 method for numeric clamp(x, lower=-Inf, upper=Inf, values=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clamp values — clamp","text":"x SpatRaster lower numeric lowest acceptable value (can specify different value layer). SpatRaster single layer number layers x upper numeric highest acceptable value (can specify different value layer). SpatRaster single layer number layers x values logical. FALSE values outside clamping range become NA, TRUE, get extreme values filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Clamp values — clamp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Clamp values — clamp","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) rc <- clamp(r, 25, 75)  rc #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   :    25  #> max value   :    75"},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":null,"dir":"Reference","previous_headings":"","what":"clamp time series data — clamp_ts","title":"clamp time series data — clamp_ts","text":"clamp time-series datat S shaped. value layers minimum value cell can set minimum value, value layers maximum value cell can set maximum value.","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"clamp time series data — clamp_ts","text":"","code":"# S4 method for SpatRaster clamp_ts(x, min=FALSE, max=TRUE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"clamp time series data — clamp_ts","text":"x SpatRaster min logical. TRUE time-series clamped minimum value max logical. TRUE time-series clamped maximum value filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"clamp time series data — clamp_ts","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"clamp time series data — clamp_ts","text":"","code":"sigm <- function(x) { .8 / (1 + exp(-(x-10))) + runif(length(x))/4 } r <- rast(ncols=10, nrows=10, nlyr=50) s <- seq(5.2, 15,.2) set.seed(1) values(r) <- t(replicate(100, sigm(s)))  x <- clamp_ts(r, TRUE, TRUE)   plot(unlist(r[4])) lines(unlist(x[4]))"},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":null,"dir":"Reference","previous_headings":"","what":"Classify (or reclassify) cell values — classify","title":"Classify (or reclassify) cell values — classify","text":"Classify values SpatRaster. function (re-)classifies groups values values. classification done based argument rcl. can classify ranges specifying three-column matrix \"--becomes\" change specific values using two-column matrix \"-becomes\". can also supply vector \"cuts\" \"number cuts\". \"--becomes\" \"-becomes\" classification done row order matrix. Thus, overlapping ranges values, first time number within range determines reclassification value. \"cuts\" values sorted, order provided matter.","code":""},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Classify (or reclassify) cell values — classify","text":"","code":"# S4 method for SpatRaster classify(x, rcl, include.lowest=FALSE, right=TRUE,       others=NULL, brackets=TRUE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Classify (or reclassify) cell values — classify","text":"x SpatRaster rcl matrix classification. matrix must 1, 2 3 columns. three columns, first two columns \"\" \"\" input values, third column \"becomes\" new value range. two column matrix (\"\", \"becomes\") can useful classifying integer values. case, arguments right include.lowest ignored. single column matrix (vector) interpreted set cuts one value. case values classified based location -cut-values. single number provided, used make number cuts, equal intervals lowest highest values SpatRaster. include.lowest logical, indicating value equal lowest value rcl (highest value second column, right=FALSE) included. right logical. TRUE, intervals closed right (open left). FALSE open right closed left. \"open\" means extreme value ** included interval. Thus, right-closed left open (0,1] = {x | 0 < x <= 1}. can also close sides right=NA, meaningful \"--becomes\" classification integers. example classify 1-5 -> 1, 6-10 -> 2, 11-15 -> 3. may easier read write equivalent 1-5 -> 1, 5-10 -> 2, 10-15 -> 3 right=TRUE include.lowest=TRUE others numeric. NULL values matched set value. Otherwise retain original value. brackets logical. TRUE, intervals parenthesis brackets around indicate whether open closed. applies rcl vector (single column matrix) filename character. Output filename ... Additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Classify (or reclassify) cell values — classify","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Classify (or reclassify) cell values — classify","text":"classify works \"raw\" values categorical rasters, ignoring levels (labels, categories). change labels categorical rasters, use subst instead. model-based classification see predict","code":""},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Classify (or reclassify) cell values — classify","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- (0:99)/99  ## from-to-becomes # classify the values into three groups  # all values >= 0 and <= 0.25 become 1, etc. m <- c(0, 0.25, 1,        0.25, 0.5, 2,        0.5, 1, 3) rclmat <- matrix(m, ncol=3, byrow=TRUE) rc1 <- classify(r, rclmat, include.lowest=TRUE)  ## cuts # equivalent to the above, but now a categorical SpatRaster is returned  rc2 <- classify(r, c(0, 0.25, 0.5, 1), include.lowest=TRUE, brackets=TRUE) freq(rc2) #>   layer      value count #> 1     1   [0–0.25]    25 #> 2     1 (0.25–0.5]    25 #> 3     1    (0.5–1]    50  ## is-becomes  x <- round(r*3) unique(x) #>   lyr.1 #> 1     0 #> 2     1 #> 3     2 #> 4     3 # replace 0 with NA y <- classify(x, cbind(0, NA)) unique(y) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3  # multiple replacements m <- rbind(c(2, 200), c(3, 300)) m #>      [,1] [,2] #> [1,]    2  200 #> [2,]    3  300  rcx1 <- classify(x, m) unique(rcx1) #>   lyr.1 #> 1     0 #> 2     1 #> 3   200 #> 4   300  rcx2 <- classify(x, m, others=NA) unique(rcx2) #>   lyr.1 #> 1   200 #> 2   300"},{"path":"https://rspatial.github.io/terra/reference/click.html","id":null,"dir":"Reference","previous_headings":"","what":"Query by clicking on a map — click","title":"Query by clicking on a map — click","text":"Click map (plot) get coordinates values SpatRaster SpatVector location. SpatRaster can also get coordinates cell number location. work well default RStudio plotting device. work around , can first run dev.new(noRStudioGD = TRUE) create separate window plotting, use plot() followed click() click map.","code":""},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query by clicking on a map — click","text":"","code":"# S4 method for SpatRaster click(x, n=10, id=FALSE, xy=FALSE, cell=FALSE, type=\"p\", show=TRUE, ...)  # S4 method for SpatVector click(x,  n=10, id=FALSE, xy=FALSE, type=\"p\", show=TRUE, ...)  # S4 method for missing click(x, n=10, id=FALSE, type=\"p\", show=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query by clicking on a map — click","text":"x SpatRaster SpatVector, missing n number clicks plot (map) id logical. TRUE, numeric ID shown map corresponds row number output xy logical. TRUE, xy coordinates included output cell logical. TRUE, cell numbers included output type one \"n\", \"p\", \"l\" \"o\". \"p\" \"o\" points plotted; \"l\" \"o\" joined lines. See locator show logical. Print values click? ... additional graphics parameters used type != \"n\" plotting locations. See locator","code":""},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query by clicking on a map — click","text":"value(s) x point(s) clicked (touched box drawn). data.frame value(s) layers SpatRaster x cell(s) clicked ; attributes geometries SpatVector x intersect box drawn).","code":""},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Query by clicking on a map — click","text":"plot provides coordinates spatial query, values read SpatRaster SpatVector passed argument. Thus, can extract values object plotted, long spatially overlaps extent plot. Unless process terminated prematurely values n positions determined. identification process can terminated, depending interact R, hitting Esc, clicking right mouse button selecting \"Stop\" menu, \"Stop\" menu graphics window.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query by clicking on a map — click","text":"","code":"if (FALSE) { r <-rast(system.file(\"ex/elev.tif\", package=\"terra\")) plot(r) click(r, n=1) ## now click on the plot (map) }"},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":null,"dir":"Reference","previous_headings":"","what":"Coercion to vector, matrix or array — coerce","title":"Coercion to vector, matrix or array — coerce","text":"Coercion SpatRaster vector, matrix array. coerce SpatExtent vector matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coercion to vector, matrix or array — coerce","text":"","code":"# S4 method for SpatRaster as.vector(x, mode='any')  # S4 method for SpatRaster as.matrix(x, wide=FALSE, ...)  # S4 method for SpatRaster as.array(x)  # S4 method for SpatExtent as.vector(x, mode='any')  # S4 method for SpatExtent as.matrix(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coercion to vector, matrix or array — coerce","text":"x SpatRaster SpatVector wide logical. FALSE layer SpatRaster becomes column matrix cell SpatRaster becomes row. TRUE row SpatRaster becomes row matrix column SpatRaster becomes column matrix mode argument ignored ... additional arguments (none implemented)","code":""},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coercion to vector, matrix or array — coerce","text":"vector, matrix, array","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coercion to vector, matrix or array — coerce","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  as.vector(r) #> [1] 1 2 3 4 as.matrix(r) #>      lyr.1 #> [1,]     1 #> [2,]     2 #> [3,]     3 #> [4,]     4 as.matrix(r, wide=TRUE) #>      [,1] [,2] #> [1,]    1    2 #> [2,]    3    4 as.data.frame(r, xy=TRUE) #>     x   y lyr.1 #> 1 -90  45     1 #> 2  90  45     2 #> 3 -90 -45     3 #> 4  90 -45     4 as.array(r) #> , , 1 #>  #>      [,1] [,2] #> [1,]    1    2 #> [2,]    3    4 #>   as.vector(ext(r)) #> xmin xmax ymin ymax  #> -180  180  -90   90  as.matrix(ext(r)) #>       min max #> [1,] -180 180 #> [2,]  -90  90"},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":null,"dir":"Reference","previous_headings":"","what":"tighten SpatRaster or SpatRasterDataset objects — tighten","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"Combines data sources within SpatRaster (memory, file) allow faster processing. combine sub-datasets SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"","code":"# S4 method for SpatRaster tighten(x)  # S4 method for SpatRasterDataset tighten(x)"},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"x SpatRaster SpatRasterDataset","code":""},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"","code":"r <- rast(nrow=5, ncol=9, vals=1:45) x <- c(r, r*2, r*3) x #> class       : SpatRaster  #> dimensions  : 5, 9, 3  (nrow, ncol, nlyr) #> resolution  : 40, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     1,     2,     3  #> max values  :    45,    90,   135  tighten(x) #> class       : SpatRaster  #> dimensions  : 5, 9, 3  (nrow, ncol, nlyr) #> resolution  : 40, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     1,     2,     3  #> max values  :    45,    90,   135"},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":null,"dir":"Reference","previous_headings":"","what":"Color table — colors","title":"Color table — colors","text":"Get set color table(s) associated SpatRaster. Color tables used associating colors values, use mapping (plot).","code":""},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Color table — colors","text":"","code":"# S4 method for SpatRaster coltab(x)  # S4 method for SpatRaster coltab(x, ..., layer=1)<-value  # S4 method for SpatRaster has.colors(x)"},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Color table — colors","text":"x SpatRaster layer positive integer, layer number name value two-column data.frame (first column cell value, second column color);    vector colors (first one color value 0 ); four (value,red,green,blue) five (including alpha) column data.frame also 0 n; NULL remove color table. can also supply list data.frames set color table layers ... additional arguments (none implemented)","code":""},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Color table — colors","text":"data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Color table — colors","text":"","code":"r <- rast(ncols=3, nrows=2, vals=1:6) coltb <- data.frame(value=1:6, col=rainbow(6, end=.9)) coltb #>   value     col #> 1     1 #FF0000 #> 2     2 #EBFF00 #> 3     3 #00FF29 #> 4     4 #00C2FF #> 5     5 #5200FF #> 6     6 #FF0099  plot(r)   has.colors(r) #> [1] FALSE coltab(r) <- coltb plot(r)  has.colors(r) #> [1] TRUE  tb <- coltab(r) class(tb) #> [1] \"list\" dim(tb[[1]]) #> [1] 6 5"},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine geometries — combineGeoms","title":"Combine geometries — combineGeoms","text":"Combine geometries one SpatVector another. Geometries can combined based overlap, shared boundaries distance (order operation). typical use-case method editing geometries number small polygons one SpatVector part geometries another SpatVector; perhaps small holes inbetween borders two SpatVectors. append SpatVectors use `rbind` see methods like intersect union \"normal\" polygons combinations.","code":""},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine geometries — combineGeoms","text":"","code":"# S4 method for SpatVector,SpatVector combineGeoms(x, y, overlap=TRUE, boundary=TRUE, distance=TRUE,   append=TRUE, minover=0.1, maxdist=Inf, dissolve=TRUE, erase=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine geometries — combineGeoms","text":"x SpatVector polygons y SpatVector polygons geometries combined x overlap logical. TRUE, geometry combined geometry overlap , overlap minover boundary logical. TRUE, geometry combined geometry shared border distance logical. TRUE, geometry combined geometry nearest append logical. remaining geometries appended output? relevant distance=TRUE minover numeric. fraction geometry y overlaps geometry x. threshold, geometries considered overlapping maxdist numeric. Geometries away distance (meters) combined dissolve logical. internal boundaries dissolved? erase logical. TRUE new overlapping areas created","code":""},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine geometries — combineGeoms","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Combine geometries — combineGeoms","text":"","code":"x1 <- vect(\"POLYGON ((0 0, 8 0, 8 9, 0 9, 0 0))\") x2 <- vect(\"POLYGON ((10 4, 12 4, 12 7, 11 7, 11 6, 10 6, 10 4))\")  y1 <- vect(\"POLYGON ((5 6, 15 6, 15 15, 5 15, 5 6))\") y2 <- vect(\"POLYGON ((8 2, 9 2, 9 3, 8 3, 8 2))\") y3 <- vect(\"POLYGON ((2 6, 3 6, 3 8, 2 8, 2 6))\") y4 <- vect(\"POLYGON ((2 12, 3 12, 3 13, 2 13, 2 12))\")  x <- rbind(x1, x2) values(x) <- data.frame(xid=1:2) crs(x) <- \"+proj=utm +zone=1\"  y <- rbind(y1, y2, y3, y4) values(y) <- data.frame(yid=letters[1:4]) crs(y) <- \"+proj=utm +zone=1\"  plot(rbind(x, y), border=c(rep(\"red\",2), rep(\"blue\", 4)), lwd=2) text(x, \"xid\") text(y, \"yid\")   v <- combineGeoms(x, y) plot(v, col=c(\"red\", \"blue\"))   v <- combineGeoms(x, y, boundary=FALSE, maxdist=1, minover=.05) plot(v, col=rainbow(4))"},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare and logical methods — Compare-methods","title":"Compare and logical methods — Compare-methods","text":"Standard comparison logical operators computations SpatRasters. Computations local (applied cell cell basis). multiple SpatRasters used, must geometry (extent resolution). operators implemented: Logical: !, &, |, isTRUE, isFALSE Compare:  ==, !=, >, <,  <=, >=, .na, .nan, .finite, .infinite See .na inverse .na, noNA detect cells missing value across layers. compare logic methods implement operators method can return NA istead FALSE allows setting output filename. terra package distinguish NA (available) NaN (number). cases state represented NaN. use SpatRaster vector multiple numbers, element vector considered layer (constant value). use SpatRaster matrix, number columns matrix must match number layers SpatRaster. rows used match cells. , two rows, match cells 1 2, recycled 3 4, etc. following method implemented (SpatExtent, SpatExtent): ==","code":""},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare and logical methods — Compare-methods","text":"","code":"# S4 method for SpatRaster compare(x, y, oper, falseNA=FALSE, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatRaster logic(x, oper, falseNA=FALSE, filename=\"\", overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare and logical methods — Compare-methods","text":"x SpatRaster y SpatRaster numeric oper character. Operator name. compare can one \"==\", \"!=\", \">\", \"<\", \">=\", \"<=\" logic can one \"!\", \".na\", \"allNA\", \"noNA\", \".infinite\", \".finite\", \"iSTRUE\", \"isFALSE\" falseNA logical. result TRUE, NA instead TRUE, FALSE? filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare and logical methods — Compare-methods","text":"SpatRaster SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare and logical methods — Compare-methods","text":"","code":"r1 <- rast(ncols=10, nrows=10) values(r1) <- runif(ncell(r1)) r1[10:20] <- NA r2 <- rast(r1) values(r2) <- 1:ncell(r2) / ncell(r2)  x <- is.na(r1) !x #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   : FALSE  #> max value   :  TRUE  r1 == r2  #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   : FALSE  #> max value   : FALSE  compare(r1, r2, \"==\") #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   : FALSE  #> max value   : FALSE  compare(r1, r2, \"==\", TRUE) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   :  TRUE  #> max value   :  TRUE"},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare geometries of SpatRasters — compareGeom","title":"Compare geometries of SpatRasters — compareGeom","text":"Evaluate whether two SpatRasters extent, number rows columns, projection, resolution, origin (subset comparisons). evaluate whether two SpatVectors geometries, whether SpatVector duplicated geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare geometries of SpatRasters — compareGeom","text":"","code":"# S4 method for SpatRaster,SpatRaster compareGeom(x, y, ..., lyrs=FALSE, crs=TRUE, warncrs=FALSE, ext=TRUE,   rowcol=TRUE, res=FALSE, stopOnError=TRUE, messages=FALSE)  # S4 method for SpatVector,SpatVector compareGeom(x, y, tolerance=0)  # S4 method for SpatVector,missing compareGeom(x, y, tolerance=0)"},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare geometries of SpatRasters — compareGeom","text":"x SpatRaster SpatVector y x. x SpatRaster, y can also list SpatRasters. x SpatVector, y can missing ... Additional SpatRasters lyrs logical. TRUE, number layers compared crs logical. TRUE, coordinate reference systems compared warncrs logical. TRUE, warning given crs different (instead error) ext logical. TRUE, bounding boxes compared rowcol logical. TRUE, number rows columns objects compared res logical. TRUE, resolutions compared (redundant checking extent rowcol) stopOnError logical. TRUE, code execution stops raster match messages logical. TRUE, warning/error messages printed even stopOnError=FALSE tolerance numeric","code":""},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare geometries of SpatRasters — compareGeom","text":"logical (SpatRaster) matrix logical (SpatVector)","code":""},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare geometries of SpatRasters — compareGeom","text":"","code":"r1 <- rast() r2 <- rast() r3 <- rast() compareGeom(r1, r2, r3) #> [1] TRUE nrow(r3) <- 10   if (FALSE) { compareGeom(r1, r3) }"},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":null,"dir":"Reference","previous_headings":"","what":"Concatenate categorical rasters — concats","title":"Concatenate categorical rasters — concats","text":"Combine two categorical rasters concatenating levels.","code":""},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Concatenate categorical rasters — concats","text":"","code":"# S4 method for SpatRaster concats(x, y, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Concatenate categorical rasters — concats","text":"x SpatRaster (single, categorical, layer) y SpatRaster (single, categorical, layer) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Concatenate categorical rasters — concats","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Concatenate categorical rasters — concats","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) levels(r) <- data.frame(id=1:3, cover=c(\"forest\", \"water\", \"urban\"))  rr <- rast(r) values(rr) <- sample(1:3, ncell(rr), replace=TRUE) levels(rr) <- data.frame(id=c(1:3), color=c(\"red\", \"green\", \"blue\"))  x <- concats(r, rr) x #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : cover_color  #> name        : cover_color  #> min value   :  forest_red  #> max value   :  urban_blue  levels(x)[[1]] #>   ID  cover_color #> 1  0   forest_red #> 2  1 forest_green #> 3  2  forest_blue #> 4  3    water_red #> 5  4  water_green #> 6  5   water_blue #> 7  6    urban_red #> 8  7  urban_green #> 9  8   urban_blue"},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":null,"dir":"Reference","previous_headings":"","what":"Contour plot — contour","title":"Contour plot — contour","text":"Contour lines (isolines) SpatRaster. Use add=TRUE add lines current plot.  See graphics::contour details. filled=TRUE, new filled contour plot made. See graphics::filled.contour details. .contour returns contour lines SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Contour plot — contour","text":"","code":"# S4 method for SpatRaster contour(x, maxcells=100000, filled=FALSE, ...)  # S4 method for SpatRaster as.contour(x, maxcells=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Contour plot — contour","text":"x SpatRaster. first layer used maxcells maximum number pixels used create contours filled logical. TRUE, filled.contour plot made ... argument can passed contour  filled.contour (graphics package)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Contour plot — contour","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) plot(r) contour(r, add=TRUE)   v <- as.contour(r) plot(r) lines(v)   contour(r, filled=TRUE, nlevels=5)   ## if you want a SpatVector with contour lines template <- disagg(rast(r), 10) rr <- resample(r, template) rr <- floor(rr/100) * 100 v <- as.polygons(rr) plot(v, 1, col=terrain.colors(7))"},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":null,"dir":"Reference","previous_headings":"","what":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"Get convex hull, minimal bounding rotated rectangle, minimal bounding circle SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"","code":"# S4 method for SpatVector convHull(x, by=\"\")  # S4 method for SpatVector minRect(x, by=\"\")  # S4 method for SpatVector minCircle(x, by=\"\")"},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"x SpatVector character (variable name), get new geometry groups input geometries","code":""},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"","code":"p <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) h <- convHull(p)  hh <- convHull(p, \"NAME_1\") rr <- minRect(p, \"NAME_1\")  plot(rr, lwd=5, border=\"gray\") plot(hh, \"NAME_1\", col=rainbow(10, alpha=.5), lwd=3, add=TRUE, plg=list(x=\"topright\")) lines(aggregate(p, \"NAME_1\"), col=\"blue\", lty=2, lwd=2)"},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":null,"dir":"Reference","previous_headings":"","what":"Cost-distance — costDist","title":"Cost-distance — costDist","text":"Use friction (cost) surface compute cost-distance cell border one target cells. Distances computed summing local distances cells, connected neighbors 8 directions, assuming path go centers one neighboring raster cells. Distances multiplied friction, thus get cost-distance, friction surface must express cost per unit distance (speed) travel.","code":""},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cost-distance — costDist","text":"","code":"# S4 method for SpatRaster costDist(x, target=0, scale=1, maxiter=50, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cost-distance — costDist","text":"x SpatRaster target numeric. value target cells (compute cost-distance ) scale numeric. Scale factor. cost distance divided number maxiter numeric. maximum number iterations. Increase number get warning costDistance converge filename character. output filename (optional) ... additional arguments writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cost-distance — costDist","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cost-distance — costDist","text":"","code":"r <- rast(ncols=5, nrows=5, crs=\"+proj=utm +zone=1 +datum=WGS84\",      xmin=0, xmax=5, ymin=0, ymax=5, vals=1) r[13] <- 0 d <- costDist(r) plot(d) text(d, digits=1)   r <- rast(ncols=10, nrows=10,  xmin=0, xmax=10, ymin=0, ymax=10,         vals=10, crs=\"+proj=utm +zone=1 +datum=WGS84\") r[5, 1] <- -10 r[2:3, 1] <- r[1, 2:4] <- r[2, 5] <- 0 r[3, 6] <- r[2, 7] <- r[1, 8:9] <- 0 r[6, 6:10] <- NA r[6:9, 6] <- NA  d <- costDist(r, -10) plot(d) text(d, digits=1, cex=.8)"},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace values with values from another object — cover","title":"Replace values with values from another object — cover","text":"Replace NA values SpatRaster x values SpatRaster y polygons: areas x overlap y replaced y , identity=TRUE intersected y.","code":""},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace values with values from another object — cover","text":"","code":"# S4 method for SpatRaster,SpatRaster cover(x, y, values=NA, filename=\"\", ...)  # S4 method for SpatVector,SpatVector cover(x, y, identity=FALSE, expand=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace values with values from another object — cover","text":"x SpatRaster SpatVector y x values numeric. cell values x replaced values y filename character. Output filename ... additional arguments writing files writeRaster identity logical. TRUE overlapping areas intersected rather replaced expand logical. parts y outside x included?","code":""},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace values with values from another object — cover","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace values with values from another object — cover","text":"","code":"r1 <- r2 <- rast(ncols=36, nrows=18) values(r1) <- 1:ncell(r1) values(r2) <- runif(ncell(r2)) r2 <- classify(r2, cbind(-Inf, 0.5, NA)) r3 <- cover(r2, r1)   p <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) e <- as.polygons(ext(6, 6.4, 49.75, 50)) values(e) <- data.frame(y=10)  cv <- cover(p, e) plot(cv, col=rainbow(12)) ci <- cover(p, e, identity=TRUE) lines(e, lwd=3)   plot(ci, col=rainbow(12)) lines(e, lwd=3)"},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"Get coordinates SpatVector SpatRaster cells. matrix data.frame x (longitude) y (latitude) coordinates returned.","code":""},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"","code":"# S4 method for SpatVector crds(x, df=FALSE, list=FALSE)  # S4 method for SpatRaster crds(x, df=FALSE, na.rm=TRUE, na.all=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"x SpatRaster SpatVector df logical. TRUE data.frame returned instead matrix list logical. TRUE list returned instead matrix na.rm logical. TRUE cells NA excluded. Ignored SpatRaster template associated cell values na.logical. TRUE cells ignored na.rm=TRUE value NA layers instead layer","code":""},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"matrix data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"","code":"x1 <- rbind(c(-175,-20), c(-140,55), c(10, 0), c(-140,-60)) x2 <- rbind(c(-125,0), c(0,60), c(40,5), c(15,-45)) x3 <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) x4 <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13)) z <- rbind(cbind(object=1, part=1, x1), cbind(object=2, part=1, x2),             cbind(object=3, part=1, x3), cbind(object=3, part=2, x4)) colnames(z)[3:4] <- c('x', 'y') z <- cbind(z, hole=0) z[(z[, \"object\"]==3 & z[,\"part\"]==2), \"hole\"] <- 1  p <- vect(z, \"polygons\") crds(p) #>          x   y #>  [1,] -175 -20 #>  [2,] -140  55 #>  [3,]   10   0 #>  [4,] -140 -60 #>  [5,] -175 -20 #>  [6,] -125   0 #>  [7,]    0  60 #>  [8,]   40   5 #>  [9,]   15 -45 #> [10,] -125   0 #> [11,]  -10   0 #> [12,]  140  60 #> [13,]  160   0 #> [14,]  140 -55 #> [15,]  -10   0 #> [16,]   80   0 #> [17,]  105  13 #> [18,]  120   2 #> [19,]  105 -13 #> [20,]   80   0  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) g <- crds(v) head(g) #>             x        y #> [1,] 6.026519 50.17767 #> [2,] 6.031361 50.16563 #> [3,] 6.035646 50.16410 #> [4,] 6.042747 50.16157 #> [5,] 6.043894 50.16116 #> [6,] 6.048243 50.16008"},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":null,"dir":"Reference","previous_headings":"","what":"Cut out a geographic subset — crop","title":"Cut out a geographic subset — crop","text":"Cut part SpatRaster SpatVector. can crop SpatRaster SpatExtent, another object extent can obtained. Note SpatRaster returned may exactly extent SpatExtent supplied can select entire cells (rows columns), add new areas. See methods like resample disagg force SpatRasters align extend add rows /columns. can crop rectangular areas SpatRaster, see argument mask=TRUE setting cell values within SpatRaster NA; use mask method crop additional masking options. can crop SpatVector another SpatVector. polygons, minimum convex hull used. Unlike intersect geometries attributes y transferred output. can also crop SpatVector rectangle (SpatRaster, SpatExtent).","code":""},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cut out a geographic subset — crop","text":"","code":"# S4 method for SpatRaster crop(x, y, snap=\"near\", mask=FALSE, touches=TRUE, extend=FALSE, filename=\"\", ...)  # S4 method for SpatRasterDataset crop(x, y, snap=\"near\", extend=FALSE)  # S4 method for SpatRasterCollection crop(x, y, snap=\"near\", extend=FALSE)  # S4 method for SpatVector crop(x, y, ext=FALSE)  # S4 method for SpatGraticule crop(x, y)"},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cut out a geographic subset — crop","text":"x SpatRaster SpatVector y SpatRaster, SpatVector, SpatExtent, object SpatExtent (ext returns SpatExtent) snap character. One \"near\", \"\", \"\". Used align y geometry x mask logical. y used mask? used y SpatVector, SpatRaster sf touches logical. TRUE mask=TRUE, cells touched lines polygons masked, just line render path, whose center point within polygon extend logical. rows /columns added y beyond extent x? Also see extend filename character. Output filename ... additional arguments writing files writeRaster ext logical. Use extent y instead y. also changes behavior y extent two ways: (1) points extent boundary removed (2) lon/lat extents go beyond -180 180 degrees longitude wrapped around earth include areas end dateline","code":""},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cut out a geographic subset — crop","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cut out a geographic subset — crop","text":"","code":"r <- rast(xmin=0, xmax=10, ymin=0, ymax=10, nrows=25, ncols=25) values(r) <- 1:ncell(r) e <- ext(-5, 5, -5, 5) rc <- crop(r, e)  # crop and mask f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) cm <- crop(r, v[9:12,], mask=TRUE) plot(cm) lines(v)   # crop vector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) e <- ext(6.15, 6.3, 49.7, 49.8) x <- crop(v, e) plot(x, \"NAME_1\")"},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":null,"dir":"Reference","previous_headings":"","what":"Cross-tabulate — crosstab","title":"Cross-tabulate — crosstab","text":"Cross-tabulate layers SpatRaster create contingency table.","code":""},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cross-tabulate — crosstab","text":"","code":"# S4 method for SpatRaster,missing crosstab(x, digits=0, long=FALSE, useNA=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cross-tabulate — crosstab","text":"x SpatRaster digits integer. number digits rounding values cross-tabulation long logical. TRUE results returned 'long' format data.frame instead table useNA logical, indicting table includes counts NA values","code":""},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cross-tabulate — crosstab","text":"table data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cross-tabulate — crosstab","text":"","code":"r <- s <- rast(nc=5, nr=5) set.seed(1) values(r) <- runif(ncell(r)) * 2 values(s) <- runif(ncell(r)) * 3 x <- c(r, s)  crosstab(x) #>      lyr.1.1 #> lyr.1 0 1 2 3 #>     0 1 1 4 0 #>     1 2 5 5 0 #>     2 0 2 4 1  rs <- r/s r[1:5] <- NA s[20:25] <- NA x <- c(r, s, rs) crosstab(x, useNA=TRUE, long=TRUE) #>    lyr.1 lyr.1.1 lyr.1.2 n #> 1      0       2       0 3 #> 2      0      NA       0 1 #> 3      0      NA       6 1 #> 4      1       0       4 1 #> 5      1       1       1 1 #> 6      1       1       2 1 #> 7      1       2       0 3 #> 8      1       2       1 1 #> 9      1      NA       0 1 #> 10     1      NA       1 1 #> 11     2       1       1 2 #> 12     2       2       1 2 #> 13     2      NA       1 2 #> 14    NA       0      19 1 #> 15    NA       1       0 2 #> 16    NA       1       1 1 #> 17    NA       3       1 1"},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":null,"dir":"Reference","previous_headings":"","what":"Get or set a coordinate reference system — crs","title":"Get or set a coordinate reference system — crs","text":"Get set coordinate reference system (CRS), also referred \"projection\", SpatRaster SpatVector. Setting new CRS change data , just changes label. set CRS dataset (come one) **, *like *. See project *transform* object one CRS another.","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get or set a coordinate reference system — crs","text":"","code":"# S4 method for SpatRaster crs(x, proj=FALSE, describe=FALSE, parse=FALSE)  # S4 method for SpatVector crs(x, proj=FALSE, describe=FALSE, parse=FALSE)  # S4 method for character crs(x, proj=FALSE, describe=FALSE, parse=FALSE)  # S4 method for SpatRaster crs(x, warn=FALSE)<-value  # S4 method for SpatVector crs(x, warn=FALSE)<-value"},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get or set a coordinate reference system — crs","text":"x SpatRaster SpatVector proj logical. TRUE crs returned PROJ-string notation describe logical. TRUE name, EPSG code, name extent area use returned known warn logical. TRUE, message printed object already non-empty crs value character string describing coordinate reference system. can WKT format, <authority:number> code \"EPSG:4326\", PROJ-string format \"+proj=utm +zone=12\" (see Note) parse logical. TRUE, wkt parts parsed vector (line becomes element)","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Get or set a coordinate reference system — crs","text":"Projections handled PROJ/GDAL libraries. PROJ developers suggest define CRS WKT2 <authority>:<code> notation. practical define one's custom CRS WKT2, <authority>:<code> system covers handful (commonly used) CRSs. work around problem still possible use deprecated PROJ-string notation (+proj=...) one major caveat: datum WGS84 (equivalent NAD83) -- want transform data coordinate reference system different datum. Thus long use WGS84, ellipsoid instead datum, can safely use PROJ-strings represent CRS; including define custom CRS. can also set crs \"local\" get informal coordinate system arbitrary Euclidean (Cartesian) plane units meter.","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get or set a coordinate reference system — crs","text":"character modified SpatRaster/Vector","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get or set a coordinate reference system — crs","text":"","code":"r <- rast() crs(r) #> [1] \"GEOGCRS[\\\"WGS 84 (CRS84)\\\",\\n    DATUM[\\\"World Geodetic System 1984\\\",\\n        ELLIPSOID[\\\"WGS 84\\\",6378137,298.257223563,\\n            LENGTHUNIT[\\\"metre\\\",1]]],\\n    PRIMEM[\\\"Greenwich\\\",0,\\n        ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\\n    CS[ellipsoidal,2],\\n        AXIS[\\\"geodetic longitude (Lon)\\\",east,\\n            ORDER[1],\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\\n        AXIS[\\\"geodetic latitude (Lat)\\\",north,\\n            ORDER[2],\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\\n    USAGE[\\n        SCOPE[\\\"unknown\\\"],\\n        AREA[\\\"World\\\"],\\n        BBOX[-90,-180,90,180]],\\n    ID[\\\"OGC\\\",\\\"CRS84\\\"]]\" crs(r, describe=TRUE, proj=TRUE) #>             name authority  code  area             extent #> 1 WGS 84 (CRS84)       OGC CRS84 World -180, 180, -90, 90 #>                                  proj #> 1 +proj=longlat +datum=WGS84 +no_defs  crs(r) <- \"+proj=lcc +lat_1=48 +lat_2=33 +lon_0=-100 +ellps=WGS84\" crs(r) #> [1] \"PROJCRS[\\\"unknown\\\",\\n    BASEGEOGCRS[\\\"unknown\\\",\\n        DATUM[\\\"Unknown based on WGS 84 ellipsoid\\\",\\n            ELLIPSOID[\\\"WGS 84\\\",6378137,298.257223563,\\n                LENGTHUNIT[\\\"metre\\\",1],\\n                ID[\\\"EPSG\\\",7030]]],\\n        PRIMEM[\\\"Greenwich\\\",0,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8901]]],\\n    CONVERSION[\\\"unknown\\\",\\n        METHOD[\\\"Lambert Conic Conformal (2SP)\\\",\\n            ID[\\\"EPSG\\\",9802]],\\n        PARAMETER[\\\"Latitude of false origin\\\",0,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8821]],\\n        PARAMETER[\\\"Longitude of false origin\\\",-100,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8822]],\\n        PARAMETER[\\\"Latitude of 1st standard parallel\\\",48,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8823]],\\n        PARAMETER[\\\"Latitude of 2nd standard parallel\\\",33,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8824]],\\n        PARAMETER[\\\"Easting at false origin\\\",0,\\n            LENGTHUNIT[\\\"metre\\\",1],\\n            ID[\\\"EPSG\\\",8826]],\\n        PARAMETER[\\\"Northing at false origin\\\",0,\\n            LENGTHUNIT[\\\"metre\\\",1],\\n            ID[\\\"EPSG\\\",8827]]],\\n    CS[Cartesian,2],\\n        AXIS[\\\"(E)\\\",east,\\n            ORDER[1],\\n            LENGTHUNIT[\\\"metre\\\",1,\\n                ID[\\\"EPSG\\\",9001]]],\\n        AXIS[\\\"(N)\\\",north,\\n            ORDER[2],\\n            LENGTHUNIT[\\\"metre\\\",1,\\n                ID[\\\"EPSG\\\",9001]]]]\"  # You can use epsg codes crs(r)  <- \"epsg:25831\" crs(r, describe=TRUE)$area #> [1] \"Europe between 0°E and 6°E: Andorra; Belgium - onshore and offshore; Denmark - offshore; Germany - offshore; Jan Mayen - offshore; Norway including Svalbard - onshore and offshore; Spain - onshore and offshore\"  crs(\"epsg:25831\", describe=TRUE) #>                    name authority  code #> 1 ETRS89 / UTM zone 31N      EPSG 25831 #>                                                                                                                                                                                                                area #> 1 Europe between 0°E and 6°E: Andorra; Belgium - onshore and offshore; Denmark - offshore; Germany - offshore; Jan Mayen - offshore; Norway including Svalbard - onshore and offshore; Spain - onshore and offshore #>                     extent #> 1 0.00, 6.01, 37.00, 82.45"},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":null,"dir":"Reference","previous_headings":"","what":"Data type of a SpatRaster or SpatVector — datatype","title":"Data type of a SpatRaster or SpatVector — datatype","text":"Get data types fields (attributes, variables) SpatVector file(s) associated SpatRaster. (layer ) SpatRaster datatype values, values memory.","code":""},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data type of a SpatRaster or SpatVector — datatype","text":"","code":"# S4 method for SpatRaster datatype(x, bylyr=TRUE)  # S4 method for SpatVector datatype(x)"},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Data type of a SpatRaster or SpatVector — datatype","text":"x SpatRaster SpatVector bylyr logical. TRUE value returned layer. Otherwise, value returned data source (file)","code":""},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Data type of a SpatRaster or SpatVector — datatype","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data type of a SpatRaster or SpatVector — datatype","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) datatype(v) #> [1] \"double\" \"string\" \"double\" \"string\" \"double\" \"long\"    f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) datatype(r) #> [1] \"INT2S\"  # no data type datatype(rast())  #> [1] \"\""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":null,"dir":"Reference","previous_headings":"","what":"Deep copy — deepcopy","title":"Deep copy — deepcopy","text":"Make deep copy SpatRaster SpatVector. occasionally useful wanting use replacement function shallow copy. copy created like : x <- y. use replacement function change object, shallow copies also change.","code":""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deep copy — deepcopy","text":"","code":"# S4 method for SpatRaster deepcopy(x)  # S4 method for SpatVector deepcopy(x)"},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Deep copy — deepcopy","text":"x SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Deep copy — deepcopy","text":"x","code":""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Deep copy — deepcopy","text":"","code":"r <- rast(ncols=10, nrows=10, nl=3) tm <- as.Date(\"2001-05-03\") + 1:3 time(r) <- tm time(r) #> [1] \"2001-05-04\" \"2001-05-05\" \"2001-05-06\" x <- r time(x) <- tm + 365 time(x) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\" time(r) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\"  y <- deepcopy(r) time(y) <- tm - 365 time(y) #> [1] \"2000-05-04\" \"2000-05-05\" \"2000-05-06\" time(r) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\"  # or make a new object like this z <- rast(r) time(z) <- tm time(z) #> [1] \"2001-05-04\" \"2001-05-05\" \"2001-05-06\" time(r) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":null,"dir":"Reference","previous_headings":"","what":"Add additional nodes to lines or polygons — densify","title":"Add additional nodes to lines or polygons — densify","text":"Add additional nodes lines polygons. can useful prior using project path change much.","code":""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add additional nodes to lines or polygons — densify","text":"","code":"# S4 method for SpatVector densify(x, interval, equalize=TRUE, flat=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add additional nodes to lines or polygons — densify","text":"x SpatVector interval positive number, specifying desired minimum distance nodes. unit meter lonlat data, linear unit crs planar data equalize logical. TRUE, new nodes spread equal intervals old nodes flat logical. TRUE, earth's curvature ignored lonlat data, distance unit degrees, meter","code":""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add additional nodes to lines or polygons — densify","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add additional nodes to lines or polygons — densify","text":"","code":"v <- vect(rbind(c(-120,-20), c(-80,5), c(-40,-60), c(-120,-20)),    type=\"polygons\", crs=\"+proj=longlat\") vd <- densify(v, 200000)  p <- project(v, \"+proj=robin\") pd <- project(vd, \"+proj=robin\")  # good  plot(pd, col=\"gray\", border=\"red\", lwd=10) points(pd, col=\"gray\")  # bad lines(p, col=\"blue\", lwd=3) points(p, col=\"blue\", cex=2) plot(p, col=\"blue\", alpha=.1, add=TRUE) legend(\"topright\", c(\"good\", \"bad\"), col=c(\"red\", \"blue\"), lty=1, lwd=3)   ## the other way around does not work ## unless the original data was truly planar (e.g. derived from a map) x <- densify(p, 250000) y <- project(x, \"+proj=longlat\") # bad plot(y) # good lines(vd, col=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/density.html","id":null,"dir":"Reference","previous_headings":"","what":"Density plot — density","title":"Density plot — density","text":"Create density plots cell values SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Density plot — density","text":"","code":"# S4 method for SpatRaster density(x, maxcells=100000, plot=TRUE, main, ...)"},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Density plot — density","text":"x SpatRaster maxcells maximum number (randomly sampled) cells used creating plot plot TRUE produce plot, else return density object main character. Caption plot(s) ... additional arguments passed plot","code":""},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Density plot — density","text":"density plot (density object, returned invisibly plot=TRUE)","code":""},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Density plot — density","text":"","code":"logo <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) density(logo)"},{"path":"https://rspatial.github.io/terra/reference/deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"deprecated methods — deprecated","title":"deprecated methods — deprecated","text":"methods deprecated removed future versions","code":""},{"path":"https://rspatial.github.io/terra/reference/deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"deprecated methods — deprecated","text":"","code":"# S4 method for SpatRaster setCats(x, ...)  # S4 method for SpatRaster area(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/deprecated.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"deprecated methods — deprecated","text":"x object ... additional arguments","code":""},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":null,"dir":"Reference","previous_headings":"","what":"depth of SpatRaster layers — depth","title":"depth of SpatRaster layers — depth","text":"Get set depth layers SpatRaster. Experimental.","code":""},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"depth of SpatRaster layers — depth","text":"","code":"# S4 method for SpatRaster depth(x)  # S4 method for SpatRaster depth(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"depth of SpatRaster layers — depth","text":"x SpatRaster value numeric vector","code":""},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"depth of SpatRaster layers — depth","text":"numeric","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"depth of SpatRaster layers — depth","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     depth(s) <- 1:3 depth(s) #> [1] 1 2 3"},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":null,"dir":"Reference","previous_headings":"","what":"describe — describe","title":"describe — describe","text":"Describe properties spatial data file generated \"GDALinfo\" tool.","code":""},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"describe — describe","text":"","code":"# S4 method for character describe(x, sds=FALSE, meta=FALSE, parse=FALSE, options=\"\", print=FALSE, open_opt=\"\")"},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"describe — describe","text":"x character. name file spatial data. fully specified subdataset within file \"NETCDF:\\\"AVHRR.nc\\\":NDVI\" sds logical. TRUE description metadata subdatasets returned (available) meta logical. Get file level metadata instead parse logical. TRUE, metadata subdatasets parsed components (meta=TRUE) options character. vector valid options (meta=FALSE) including \"json\", \"mm\", \"stats\", \"hist\", \"nogcp\", \"nomd\", \"norat\", \"noct\", \"nofl\", \"checksum\", \"proj4\", \"listmdd\", \"mdd <value>\" <value> specifies domain '', \"wkt_format <value>\" value one 'WKT1', 'WKT2', 'WKT2_2015', 'WKT2_2018', \"sd <subdataset>\" <subdataset> name identifier sub-dataset. See https://gdal.org/programs/gdalinfo.html. Ignored sds=TRUE print logical. TRUE, print results open_opt character. Driver specific open options","code":""},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"describe — describe","text":"character (invisibly, print=FALSE)","code":""},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"describe — describe","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") describe(f) #>  [1] \"Driver: GTiff/GeoTIFF\"                                                     #>  [2] \"Files: /Users/runner/work/_temp/Library/terra/ex/elev.tif\"                 #>  [3] \"Size is 95, 90\"                                                            #>  [4] \"Coordinate System is:\"                                                     #>  [5] \"GEOGCRS[\\\"WGS 84\\\",\"                                                       #>  [6] \"    ENSEMBLE[\\\"World Geodetic System 1984 ensemble\\\",\"                     #>  [7] \"        MEMBER[\\\"World Geodetic System 1984 (Transit)\\\"],\"                 #>  [8] \"        MEMBER[\\\"World Geodetic System 1984 (G730)\\\"],\"                    #>  [9] \"        MEMBER[\\\"World Geodetic System 1984 (G873)\\\"],\"                    #> [10] \"        MEMBER[\\\"World Geodetic System 1984 (G1150)\\\"],\"                   #> [11] \"        MEMBER[\\\"World Geodetic System 1984 (G1674)\\\"],\"                   #> [12] \"        MEMBER[\\\"World Geodetic System 1984 (G1762)\\\"],\"                   #> [13] \"        MEMBER[\\\"World Geodetic System 1984 (G2139)\\\"],\"                   #> [14] \"        ELLIPSOID[\\\"WGS 84\\\",6378137,298.257223563,\"                       #> [15] \"            LENGTHUNIT[\\\"metre\\\",1]],\"                                     #> [16] \"        ENSEMBLEACCURACY[2.0]],\"                                           #> [17] \"    PRIMEM[\\\"Greenwich\\\",0,\"                                               #> [18] \"        ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\"                        #> [19] \"    CS[ellipsoidal,2],\"                                                    #> [20] \"        AXIS[\\\"geodetic latitude (Lat)\\\",north,\"                           #> [21] \"            ORDER[1],\"                                                     #> [22] \"            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\"                    #> [23] \"        AXIS[\\\"geodetic longitude (Lon)\\\",east,\"                           #> [24] \"            ORDER[2],\"                                                     #> [25] \"            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\"                    #> [26] \"    USAGE[\"                                                                #> [27] \"        SCOPE[\\\"Horizontal component of 3D system.\\\"],\"                    #> [28] \"        AREA[\\\"World.\\\"],\"                                                 #> [29] \"        BBOX[-90,-180,90,180]],\"                                           #> [30] \"    ID[\\\"EPSG\\\",4326]]\"                                                    #> [31] \"Data axis to CRS axis mapping: 2,1\"                                        #> [32] \"Origin = (5.741666666666666,50.191666666666663)\"                           #> [33] \"Pixel Size = (0.008333333333333,-0.008333333333333)\"                       #> [34] \"Metadata:\"                                                                 #> [35] \"  AREA_OR_POINT=Area\"                                                      #> [36] \"Image Structure Metadata:\"                                                 #> [37] \"  COMPRESSION=LZW\"                                                         #> [38] \"  INTERLEAVE=BAND\"                                                         #> [39] \"Corner Coordinates:\"                                                       #> [40] \"Upper Left  (   5.7416667,  50.1916667) (  5d44'30.00\\\"E, 50d11'30.00\\\"N)\" #> [41] \"Lower Left  (   5.7416667,  49.4416667) (  5d44'30.00\\\"E, 49d26'30.00\\\"N)\" #> [42] \"Upper Right (   6.5333333,  50.1916667) (  6d32' 0.00\\\"E, 50d11'30.00\\\"N)\" #> [43] \"Lower Right (   6.5333333,  49.4416667) (  6d32' 0.00\\\"E, 49d26'30.00\\\"N)\" #> [44] \"Center      (   6.1375000,  49.8166667) (  6d 8'15.00\\\"E, 49d49' 0.00\\\"N)\" #> [45] \"Band 1 Block=95x43 Type=Int16, ColorInterp=Gray\"                           #> [46] \"  Description = elevation\"                                                 #> [47] \"  Min=141.000 Max=547.000 \"                                                #> [48] \"  Minimum=141.000, Maximum=547.000, Mean=-9999.000, StdDev=-9999.000\"      #> [49] \"  NoData Value=-32768\"                                                     #> [50] \"  Metadata:\"                                                               #> [51] \"    STATISTICS_MAXIMUM=547\"                                                #> [52] \"    STATISTICS_MEAN=-9999\"                                                 #> [53] \"    STATISTICS_MINIMUM=141\"                                                #> [54] \"    STATISTICS_STDDEV=-9999\"                                               describe(f, meta=TRUE) #> [1] \"AREA_OR_POINT=Area\" #g <- describe(f, options=c(\"json\", \"nomd\", \"proj4\")) #head(g)"},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":null,"dir":"Reference","previous_headings":"","what":"Lagged differences — diff","title":"Lagged differences — diff","text":"Compute difference consecutive layers SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Lagged differences — diff","text":"","code":"# S4 method for SpatRaster diff(x, lag=1, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Lagged differences — diff","text":"x SpatRaster lag positive integer indicating lag use filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Lagged differences — diff","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Lagged differences — diff","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    d <- diff(s)"},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":null,"dir":"Reference","previous_headings":"","what":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"Get number rows (nrow), columns (ncol), cells (ncell), layers (nlyr), sources (nsrc), size size (nlyr(x)*ncell(x)), spatial resolution SpatRaster. length returns number sub-datasets SpatRasterDataset SpatVectorCollection. SpatVector length(x) nrow(x). can also set number rows columns layers. setting dimensions, cell values dropped.","code":""},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"","code":"# S4 method for SpatRaster ncol(x)  # S4 method for SpatRaster nrow(x)  # S4 method for SpatRaster nlyr(x)  # S4 method for SpatRaster ncell(x)  # S4 method for SpatRaster nsrc(x)  # S4 method for SpatRaster,numeric ncol(x)<-value  # S4 method for SpatRaster,numeric nrow(x)<-value  # S4 method for SpatRaster,numeric nlyr(x)<-value  # S4 method for SpatRaster res(x)  # S4 method for SpatRaster,numeric res(x)<-value  # S4 method for SpatRaster xres(x)  # S4 method for SpatRaster yres(x)  # S4 method for SpatVector ncol(x)  # S4 method for SpatVector nrow(x)  # S4 method for SpatVector length(x)"},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"x SpatRaster SpatVector related objects value ncol nrow: positive integer. res: one two positive numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"integer","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"","code":"r <- rast() ncol(r) #> [1] 360 nrow(r) #> [1] 180 nlyr(r) #> [1] 1 dim(r) #> [1] 180 360   1 nsrc(r) #> [1] 1 ncell(r) #> [1] 64800  rr  <- c(r,r) nlyr(rr) #> [1] 2 nsrc(rr) #> [1] 2 ncell(rr) #> [1] 64800  nrow(r) <- 18 ncol(r) <- 36 # equivalent to dim(r) <- c(18, 36)   dim(r) #> [1] 18 36  1 dim(r) <- c(10, 10, 5) dim(r) #> [1] 10 10  5  xres(r) #> [1] 36 yres(r) #> [1] 18 res(r) #> [1] 36 18  res(r) <- 1/120 # different xres and yres res(r) <- c(1/120, 1/60)"},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":null,"dir":"Reference","previous_headings":"","what":"Direction — direction","title":"Direction — direction","text":"direction (azimuth) nearest cell NA. direction expressed radians, unless use argument degrees=TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Direction — direction","text":"","code":"# S4 method for SpatRaster direction(x, from=FALSE, degrees=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Direction — direction","text":"x SpatRaster filename Character. Output filename (optional) degrees Logical. FALSE (default) unit direction radians. Logical. Default FALSE. TRUE, direction (instead )  nearest cell NA returned ... Additional arguments writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Direction — direction","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Direction — direction","text":"","code":"r <- rast(ncol=36,nrow=18, crs=\"+proj=merc\") values(r) <- NA r[306] <- 1 b <- direction(r, degrees=TRUE)  plot(b)   crs(r) <- \"+proj=longlat\" b <- direction(r)  plot(b)"},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":null,"dir":"Reference","previous_headings":"","what":"Disaggregate raster cells or vector geometries — disagg","title":"Disaggregate raster cells or vector geometries — disagg","text":"SpatRaster: Create SpatRaster higher resolution (smaller cells). values new SpatRaster larger original cells. SpatVector: Separate multi-objects (points, lines, polygons) single objects; segments (lines polygons).","code":""},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Disaggregate raster cells or vector geometries — disagg","text":"","code":"# S4 method for SpatRaster disagg(x, fact, method=\"near\", filename=\"\", ...)  # S4 method for SpatVector disagg(x, segments=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Disaggregate raster cells or vector geometries — disagg","text":"x SpatRaster SpatVector fact positive integer. Aggregation factor expressed number cells direction (horizontally vertically). two integers (horizontal vertical aggregation factor) three integers (also aggregating layers) method character. Either \"near\" nearest \"bilinear\" bilinear interpolation segments logical. (poly-)lines polygons disaggregated line-segments? filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Disaggregate raster cells or vector geometries — disagg","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Disaggregate raster cells or vector geometries — disagg","text":"","code":"r <- rast(ncols=10, nrows=10) rd <- disagg(r, fact=c(10, 2)) ncol(rd) #> [1] 20 nrow(rd) #> [1] 100 values(r) <- 1:ncell(r) rd <- disagg(r, fact=c(4, 2))"},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":null,"dir":"Reference","previous_headings":"","what":"Geographic distance — distance","title":"Geographic distance — distance","text":"x SpatRaster: y missing method computes distance, cells NA SpatRaster x nearest cell NA (values, see arguments \"target\" \"exclude\"). y numeric value, cells value ignored. , distance cells computed (grid=FALSE). y SpatVector, distance SpatVector computed cells. lines polygons done rasterization; overlapping areas vector raster considered (now). distance always expressed meter coordinate reference system longitude/latitude, map units otherwise. Map units typically meter, inspect crs(x) doubt. Results precise, sometimes much precise, using longitude/latitude rather planar coordinate reference system, distort distance. x SpatVector: y missing, distance matrix objects x computed. distance matrix object class \"dist\" returned. y SpatVector geographic distance objects computed (matrix returned). sets number points, pairwise=TRUE, distance pair objects computed, vector returned. distance always expressed meter, except coordinate reference system longitude/latitude one SpatVector(s) consists lines polygons. case distance degrees, thus useful (fixed soon). Otherwise, results precise, sometimes much precise, using longitude/latitude rather planar coordinate reference system, distort distance. x matrix: x consist two columns, first \"x\" (longitude) second \"y\" coordinates (latitude). y also matrix, distance points x points y computed, unless pairwise=TRUE y missing, distance points x points x computed, unless sequential=TRUE","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Geographic distance — distance","text":"","code":"# S4 method for SpatRaster,missing distance(x, y, target=NA, exclude=NULL, unit=\"m\", haversine=TRUE, filename=\"\", ...)  # S4 method for SpatRaster,SpatVector distance(x, y, unit=\"m\", rasterize=FALSE, haversine=TRUE, filename=\"\", ...)  # S4 method for SpatVector,ANY distance(x, y, sequential=FALSE, pairs=FALSE, symmetrical=TRUE, unit=\"m\")  # S4 method for SpatVector,SpatVector distance(x, y, pairwise=FALSE, unit=\"m\")  # S4 method for matrix,matrix distance(x, y, lonlat, pairwise=FALSE, unit=\"m\")  # S4 method for matrix,missing distance(x, y, lonlat, sequential=FALSE, pairs=FALSE, symmetrical=TRUE, unit=\"m\")"},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Geographic distance — distance","text":"x SpatRaster, SpatVector, two-column matrix coordinates (x,y) (lon,lat) y missing, numeric, SpatVector, two-column matrix target numeric. value cells distances cells NA computed exclude numeric. value cells considered computing distances unit character. Can either \"m\" \"km\" haversine logical. Use haversine formula lon/lat data use haversine formula? FALSE, precise slower method Karney (2003) used rasterize logical. TRUE distance computed cells covered geometries rasterization. can much faster cases filename character. Output filename ... additional arguments writing files writeRaster sequential logical. TRUE, distance sequential geometries returned pairwise logical. TRUE x y size (number rows), pairwise distances returned instead distances elements lonlat logical. TRUE coordinates interpreted angular (longitude/latitude). FALSE interpreted planar pairs logical. TRUE \"\", \"\", \"distance\" matrix returned symmetrical logical. TRUE pairs=TRUE, distance pair included . distance geometry 1 3 included, () distance 3 1 ","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Geographic distance — distance","text":"SpatRaster numeric matrix distance matrix (object class \"dist\")","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Geographic distance — distance","text":"distance matrix can coerced regular matrix .matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Geographic distance — distance","text":"Karney, C.F.F., 2013. Algorithms geodesics, J. Geodesy 87: 43-55. doi:10.1007/s00190-012-0578-z.","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Geographic distance — distance","text":"","code":"#lonlat r <- rast(ncols=36, nrows=18, crs=\"+proj=longlat +datum=WGS84\") r[500] <- 1 d <- distance(r)  #>  |---------|---------|---------|---------| =========================================                                            plot(d / 100000)   #planar rr <- rast(ncols=36, nrows=18, crs=\"+proj=utm +zone=1 +datum=WGS84\") rr[500] <- 1 d <- distance(rr)   rr[3:10, 3:10] <- 99 e <- distance(rr, exclude=99)   p1 <- vect(rbind(c(0,0), c(90,30), c(-90,-30)), crs=\"+proj=longlat +datum=WGS84\") dp <- distance(r, p1)  #>  |---------|---------|---------|---------| =========================================                                             d <- distance(p1) d #>          1        2 #> 2 10014577          #> 3 10014577 20003931 as.matrix(d) #>          1        2        3 #> 1        0 10014577 10014577 #> 2 10014577        0 20003931 #> 3 10014577 20003931        0  p2 <- vect(rbind(c(30,-30), c(25,40), c(-9,-3)), crs=\"+proj=longlat +datum=WGS84\") dd <- distance(p1, p2) dd #>          [,1]     [,2]     [,3] #> [1,]  4596223  5104507  1054933 #> [2,]  9192445  5905838 11048088 #> [3,] 10825924 14117180  8981037 pd <- distance(p1, p2, pairwise=TRUE) pd #> [1] 4596223 5905838 8981037 pd == diag(dd) #> [1] TRUE TRUE TRUE   # polygons, lines crs <- \"+proj=utm +zone=1\" p1 <- vect(\"POLYGON ((0 0, 8 0, 8 9, 0 9, 0 0))\", crs=crs) p2 <- vect(\"POLYGON ((5 6, 15 6, 15 15, 5 15, 5 6))\", crs=crs) p3 <- vect(\"POLYGON ((2 12, 3 12, 3 13, 2 13, 2 12))\", crs=crs) p <- rbind(p1, p2, p3) L1 <- vect(\"LINESTRING(1 11, 4 6, 10 6)\", crs=crs) L2 <- vect(\"LINESTRING(8 14, 12 10)\", crs=crs) L3 <- vect(\"LINESTRING(1 8, 12 14)\", crs=crs) lns <- rbind(L1, L2, L3) pts <- vect(cbind(c(7,10,10), c(3,5,6)), crs=crs)  distance(p1,p3) #>      [,1] #> [1,]    3 distance(p) #>   1 2 #> 2 0   #> 3 3 2 distance(p,pts) #>          [,1]     [,2]     [,3] #> [1,] 0.000000 2.000000 2.000000 #> [2,] 3.000000 1.000000 0.000000 #> [3,] 9.848858 9.899495 9.219544 distance(p,lns) #>          [,1]     [,2]     [,3] #> [1,] 0.000000 3.535534 0.000000 #> [2,] 0.000000 0.000000 0.000000 #> [3,] 1.414214 5.099020 2.553878 distance(pts,lns) #>      [,1]     [,2]     [,3] #> [1,]    3 8.602325 7.262591 #> [2,]    1 5.385165 6.943356 #> [3,]    0 4.472136 6.065460"},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":null,"dir":"Reference","previous_headings":"","what":"Make a dot-density map — dots","title":"Make a dot-density map — dots","text":"Create dots dot-density map add current map. Dot-density maps made display count data. example population counts, dot represents n persons. dots returned SpatVector. active graphics device, dots added points.","code":""},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make a dot-density map — dots","text":"","code":"# S4 method for SpatVector dots(x, field, size,  ...)"},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make a dot-density map — dots","text":"x SpatVector field character numeric indicating field name. numeric vector length x size positive number indicating number cases associated dot ... graphical arguments passed points","code":""},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make a dot-density map — dots","text":"SpatVector (invisibly)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make a dot-density map — dots","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$population <- 1000*(1:12)^2 plot(v, lwd=3, col=\"light gray\", border=\"white\") d <- dots(v, \"population\", 1000, col=\"red\", cex=.75) lines(v)  d #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 650, 7  (geometries, attributes) #>  extent      : 5.774251, 6.515615, 49.45477, 50.03893  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP population #>  type        : <num>    <chr> <num>    <chr> <num> <int>      <num> #>  values      :     1 Diekirch     1 Clervaux   312 18081       1000 #>                    1 Diekirch     2 Diekirch   218 32543       4000 #>                    1 Diekirch     2 Diekirch   218 32543       4000"},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":null,"dir":"Reference","previous_headings":"","what":"Draw a polygon, line, extent, or points — draw","title":"Draw a polygon, line, extent, or points — draw","text":"Draw plot (map) get SpatVector SpatExtent object later use. calling function, start clicking map. done, press ESC. can also preset maximum number clicks. work well default RStudio plotting device. work around , can first run dev.new(noRStudioGD = TRUE) create separate window plotting, use plot() followed click() click map.","code":""},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Draw a polygon, line, extent, or points — draw","text":"","code":"# S4 method for character draw(x=\"extent\", col=\"red\", lwd=2, id=FALSE, n=1000, xpd=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Draw a polygon, line, extent, or points — draw","text":"x character. type object draw. One \"extent\", \"polygon\", \"line\", \"points\" col color used lwd width lines drawn id logical. TRUE, numeric ID shown map n maximum number clicks (apply x==\"extent\" case n always 2) xpd logical. TRUE, can draw outside current plotting area ... additional graphics arguments drawing","code":""},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Draw a polygon, line, extent, or points — draw","text":"SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":null,"dir":"Reference","previous_headings":"","what":"elongate lines — elongate","title":"elongate lines — elongate","text":"Elongate SpatVector lines","code":""},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"elongate lines — elongate","text":"","code":"# S4 method for SpatVector elongate(x, length=1, flat=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"elongate lines — elongate","text":"x SpatVector length positive number indicating much lines elongated end. unit meter crs lonlat linear unit crs cases (also meter cases) flat logical. TRUE, earth's curvature ignored lonlat data, distance unit degrees, meter","code":""},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"elongate lines — elongate","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"elongate lines — elongate","text":"","code":"v <- vect(cbind(c(0,1,2), c(0,0,2)), \"lines\", crs=\"lonlat\") e <- elongate(v, 100000) plot(e) points(e)  geom(e) #>      geom part          x        y hole #> [1,]    1    1 -0.8983153 0.000000    0 #> [2,]    1    1  1.0000000 0.000000    0 #> [3,]    1    1  2.4044661 2.807681    0"},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":null,"dir":"Reference","previous_headings":"","what":"Erase parts of a SpatVector object — erase","title":"Erase parts of a SpatVector object — erase","text":"Erase parts SpatVector another SpatVector SpatExtent. can also erase (parts ) polygons polygons SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Erase parts of a SpatVector object — erase","text":"","code":"# S4 method for SpatVector,SpatVector erase(x, y)  # S4 method for SpatVector,missing erase(x, sequential=TRUE)  # S4 method for SpatVector,SpatExtent erase(x, y)"},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Erase parts of a SpatVector object — erase","text":"x SpatVector y SpatVector SpatExtent sequential logical. areas erased sequentially? See Details","code":""},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Erase parts of a SpatVector object — erase","text":"SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Erase parts of a SpatVector object — erase","text":"polygons erased sequentially, everything covered first polygon removed polygons, everything covered (remaining ) second polygon removed, etc. polygons erased sequentially, overlapping areas erased areas covered single geometry returned.","code":""},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Erase parts of a SpatVector object — erase","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  # polygons with polygons or extent  e <- ext(5.6, 6, 49.55, 49.7) x <- erase(v, e)  p <- vect(\"POLYGON ((5.8 49.8, 6 49.9, 6.15 49.8, 6 49.6, 5.8 49.8))\") y <- erase(v, p)  # lines with polygons lns <- as.lines(rast(v, ncol=10, nrow=10))[12:22] eln <- erase(lns, v) plot(v) lines(lns, col='blue', lwd=4, lty=3) lines(eln, col='red', lwd=2)    ## self-erase h <- convHull(v[-12], \"NAME_1\") he <- erase(h) plot(h, lwd=2, border=\"red\", lty=2) lines(he, col=\"gray\", lwd=3)"},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"Compute area covered polygons raster cells NA. method computes areas longitude/latitude rasters, size cells constant degrees, square meters. can also important coordinate reference system planar, equal-area. vector data, best way compute area use longitude/latitude CRS. contrary (erroneous) popular belief suggest use planar coordinate reference system. done automatically, transform=TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"","code":"# S4 method for SpatRaster expanse(x, unit=\"m\", transform=TRUE, byValue=FALSE,       zones=NULL, wide=FALSE, usenames=FALSE)  # S4 method for SpatVector expanse(x, unit=\"m\", transform=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"x SpatRaster SpatVector unit character. Output unit area. One \"m\", \"km\", \"ha\" transform logical. TRUE, planar CRS transformed lon/lat accuracy byValue logical. TRUE, area unique cell value returned zones NULL SpatRaster geometry identifying zones x wide logical. results \"wide\" rather \"long\" format? usenames logical. TRUE layers identified names instead numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"SpatRaster: data.frame least two columns (\"layer\" \"area\") possibly also \"value\" (byValue TRUE), \"zone\" (zones TRUE). x values, total area cells returned. Otherwise, area cells NA returned. SpatVector: numeric (one value (multi-) polygon geometry.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"","code":"### SpatRaster  r <- rast(nrows=18, ncols=36) v <- 1:ncell(r) v[200:400] <- NA values(r) <- v  # summed area in km2 expanse(r, unit=\"km\") #>   layer      area #> 1     1 273986501  # all cells  expanse(rast(r), unit=\"km\") #>   layer      area #> 1     1 510065622  r <- rast(ncols=90, nrows=45, ymin=-80, ymax=80) m <- project(r, \"+proj=merc\")  expanse(m, unit=\"km\") #>   layer      area #> 1     1 498751903 expanse(m, unit=\"km\", transform=FALSE) #>   layer       area #> 1     1 1241591858  m2 <- c(m, m) values(m2) <- cbind(c(1,2,NA,NA), c(11:14)) #> Warning: [setValues] values were recycled expanse(m2, unit=\"km\", byValue=TRUE, wide=TRUE) #>   layer        1        2       11       12       13       14 #> 1     1 10182145 10182145        0        0        0        0 #> 3     2        0        0 10182145 10182145 10182145 10182145   v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) r <- round((r-50)/100) levels(r) <- data.frame(id=1:5, name=c(\"forest\", \"water\", \"urban\", \"crops\", \"grass\")) expanse(r, byValue=TRUE) #>   layer  value       area #> 1     1 forest   50778375 #> 2     1  water  715780779 #> 3     1  urban 1118216460 #> 4     1  crops  617965652 #> 5     1  grass   60868836  g <- rasterize(v, r, \"NAME_1\") expanse(r, byValue=TRUE, zones=g, wide=TRUE) #>   layer         zone   forest     water     urban     crops    grass #> 1     1     Diekirch  1110530 146734320 332045014 584531527 58106847 #> 2     1 Grevenmacher 46327739 247619382 219364571   1670053        0 #> 5     1   Luxembourg        0 315854211 555664543  25106417        0   ### SpatVector v <- vect(system.file(\"ex/lux.shp\", package=\"terra\"))  a <- expanse(v) a #>  [1] 312283206 218674025 259454806  76200409 263174257 188282143 128991500 #>  [8] 210354494 185630770 251322021 237113004 233329960 sum(a) #> [1] 2564810595"},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":null,"dir":"Reference","previous_headings":"","what":"Create, get or set a SpatExtent — ext","title":"Create, get or set a SpatExtent — ext","text":"Get SpatExtent SpatRaster, SpatVector, spatial objects. create SpatExtent vector (length=4; order=xmin, xmax, ymin, ymax) can set extent SpatRaster, set extent SpatVector (see rescale ). See set.ext set extent place.","code":""},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create, get or set a SpatExtent — ext","text":"","code":"# S4 method for SpatRaster ext(x, cells=NULL)  # S4 method for SpatVector ext(x)  # S4 method for numeric ext(x, ..., xy=FALSE)  # S4 method for SpatRaster,SpatExtent ext(x)<-value  # S4 method for SpatRaster,numeric ext(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create, get or set a SpatExtent — ext","text":"x SpatRaster cells positive integer (cell) numbers subset extent area covered cells value SpatExtent, numeric vector length four (xmin, xmax, ymin, ymax) ... x single numeric value, additional numeric values xmax, ymin, ymax xy logical. Set TRUE indicate coordinates (xmin, ymin, xmax, ymax) order, instead terra standard order (xmin, xmax, ymin, ymax)","code":""},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create, get or set a SpatExtent — ext","text":"SpatExtent object.","code":""},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create, get or set a SpatExtent — ext","text":"","code":"r <- rast() e <- ext(r) as.vector(e) #> xmin xmax ymin ymax  #> -180  180  -90   90  as.character(e) #> [1] \"ext(-180, 180, -90, 90)\"  ext(r) <- c(0, 2.5, 0, 1.5) r #> class       : SpatRaster  #> dimensions  : 180, 360, 1  (nrow, ncol, nlyr) #> resolution  : 0.006944444, 0.008333333  (x, y) #> extent      : 0, 2.5, 0, 1.5  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  er <- ext(r)  round(er) #> SpatExtent : 0, 3, 0, 2 (xmin, xmax, ymin, ymax) # go \"in\" floor(er) #> SpatExtent : 0, 3, 0, 2 (xmin, xmax, ymin, ymax) # go \"out\" ceiling(er) #> SpatExtent : 0, 2, 0, 1 (xmin, xmax, ymin, ymax)  ext(r) <- e"},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":null,"dir":"Reference","previous_headings":"","what":"Extend — extend","title":"Extend — extend","text":"Enlarge spatial extent SpatRaster. See crop (also) want remove rows columns. Note can enlarge SpatRasters entire rows columns. Therefore, extent output SpatRaster may exactly requested. Depending argument snap may bit smaller larger. can also enlarge SpatExtent method, algebraic notation (see examples)","code":""},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extend — extend","text":"","code":"# S4 method for SpatRaster extend(x, y, snap=\"near\", fill=NA, filename=\"\", overwrite=FALSE, ...)   # S4 method for SpatExtent extend(x, y)"},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extend — extend","text":"x SpatRaster SpatExtent y x SpatRaster, y SpatExtent, object can extracted (SpatRaster SpatVector objects). Alternatively, can provide one, two four non-negative integers indicating number rows columns need added side (single positive integer number rows columns added equal; 2 number (columns, rows), four (left column, right column, bottom row, top row).   x SpatExtent, y likewise numeric vector 1, 2, 4 elements snap character. One \"near\", \"\", \"\". Used align y geometry x fill numeric. value used new raster cells filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extend — extend","text":"SpatRaster SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extend — extend","text":"","code":"r <- rast(xmin=-150, xmax=-120, ymin=30, ymax=60, ncols=36, nrows=18) values(r) <- 1:ncell(r) e <- ext(-180, -100, 40, 70) re <- extend(r, e)  # extend with a number of rows and columns (at each side) re2 <- extend(r, c(2,10))  # SpatExtent e <- ext(r) e #> SpatExtent : -150, -120, 30, 60 (xmin, xmax, ymin, ymax) extend(e, 10) #> SpatExtent : -160, -110, 20, 70 (xmin, xmax, ymin, ymax) extend(e, c(10, -10, 0, 20)) #> SpatExtent : -160, -110, 30, 80 (xmin, xmax, ymin, ymax)   # add 10 columns / rows on all sides e + 10 #> SpatExtent : -160, -110, 20, 70 (xmin, xmax, ymin, ymax) # double extent e * 2 #> SpatExtent : -165, -105, 15, 75 (xmin, xmax, ymin, ymax) # increase extent by 25% e * 1.25 #> SpatExtent : -153.75, -116.25, 26.25, 63.75 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract values from a SpatRaster — extract","title":"Extract values from a SpatRaster — extract","text":"Extract values SpatRaster set locations. locations can SpatVector (points, lines, polygons), data.frame matrix (x, y) (longitude, latitude -- order!) coordinates, vector cell numbers. argument y SpatVector first column ID (record number) SpatVector used (unless set ID=FALSE). Alternatively, can use zonal using rasterize SpatVector (may efficient cases).","code":""},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract values from a SpatRaster — extract","text":"","code":"# S4 method for SpatRaster,SpatVector extract(x, y, fun=NULL, method=\"simple\", cells=FALSE, xy=FALSE,     ID=TRUE, weights=FALSE, exact=FALSE, touches=is.lines(y), small=TRUE,   layer=NULL, bind=FALSE, raw=FALSE, ...)  # S4 method for SpatRaster,SpatExtent extract(x, y, cells=FALSE, xy=FALSE)  # S4 method for SpatRaster,matrix extract(x, y, cells=FALSE, method=\"simple\")  # S4 method for SpatRaster,numeric extract(x, y, xy=FALSE, raw=FALSE)  # S4 method for SpatVector,SpatVector extract(x, y)"},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract values from a SpatRaster — extract","text":"x SpatRaster SpatVector polygons y SpatVector (points, lines, polygons). Alternatively, points, 2-column matrix data.frame (x, y) (lon, lat). vector cell numbers fun function summarize extracted data line polygon geometry. can use fun=table tabulate raster values line polygon geometry. weights=TRUE exact=TRUE mean, sum, min, max table accepted). Ignored y point geometry method character. method extracting values points (\"simple\" \"bilinear\"). \"simple\" values cell point falls returned. \"bilinear\" returned values interpolated values four nearest raster cells cells logical. TRUE cell numbers also returned, unless fun NULL. Also see cells xy logical. TRUE coordinates cells also returned, unless fun NULL. See xyFromCell ID logical. ID column added? , first column returned IDs (record numbers) y weights logical. TRUE y polygons, approximate fraction cell covered returned well, example compute weighted mean exact logical. TRUE y polygons, exact fraction cell covered returned well, example compute weighted mean touches logical. TRUE, values cells touched lines polygons extracted, just line render path, whose center point within polygon. relevant points; always considered TRUE weights=TRUE exact=TRUE small logical. TRUE, values cells touched polygons extracted none cells center points within polygon; even touches=FALSE layer character numeric select layer extract geometry. layer character can name y vector layer names. numeric, must integer values 1 nlyr(x) bind logical. TRUE, SpatVector returned consisting input SpatVector y cbind-ed extracted values raw logical. TRUE, matrix returned \"raw\" numeric cell values. FALSE, data.frame returned cell values transformed factor, logical, integer values, appropriate ... additional arguments fun y SpatVector. example na.rm=TRUE. arguments passed SpatRaster,SpatVector method y matrix (method cells arguments)","code":""},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract values from a SpatRaster — extract","text":"data.frame, matrix SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract values from a SpatRaster — extract","text":"","code":"r <- rast(ncols=5, nrows=5, xmin=0, xmax=5, ymin=0, ymax=5) values(r) <- 1:25 xy <- rbind(c(0.5,0.5), c(2.5,2.5)) p <- vect(xy, crs=\"+proj=longlat +datum=WGS84\")  extract(r, xy) #>   lyr.1 #> 1    21 #> 2    13 extract(r, p) #>   ID lyr.1 #> 1  1    21 #> 2  2    13  r[1,] #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 #> 5     5 r[5] #>   lyr.1 #> 1     5 r[,5] #>   lyr.1 #> 1     5 #> 2    10 #> 3    15 #> 4    20 #> 5    25  r[c(0:2, 99:101)] #>   lyr.1 #> 1     1 #> 2     2 #> 3    NA #> 4    NA #> 5    NA  f <- system.file(\"ex/meuse.tif\", package=\"terra\") r <- rast(f)  xy <- cbind(179000, 330000) xy <- rbind(xy-100, xy, xy+1000) extract(r, xy) #>   meuse #> 1   378 #> 2   251 #> 3   208  p <- vect(xy) g <- geom(p) g #>      geom part      x      y hole #> [1,]    1    1 178900 329900    0 #> [2,]    2    1 179000 330000    0 #> [3,]    3    1 180000 331000    0  extract(r, p) #>   ID meuse #> 1  1   378 #> 2  2   251 #> 3  3   208  x <- r + 10 extract(x, p) #>   ID meuse #> 1  1   388 #> 2  2   261 #> 3  3   218  i <- cellFromXY(r, xy) x[i] #>   meuse #> 1   388 #> 2   261 #> 3   218 r[i] #>   meuse #> 1   378 #> 2   251 #> 3   208  y <- c(x,x*2,x*3) y[i] #>   meuse meuse meuse #> 1   388   776  1164 #> 2   261   522   783 #> 3   218   436   654  ## extract with a polygon f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v <- v[1:2,]  rf <- system.file(\"ex/elev.tif\", package=\"terra\") x <- rast(rf) extract(x, v, mean, na.rm=TRUE) #>   ID elevation #> 1  1  467.1052 #> 2  2  333.8629  z <- rast(v, resolution=.1, names=\"test\") values(z) <- 1:ncell(z) e <- extract(z, v, ID=TRUE) e #>   ID test #> 1  1    2 #> 2  1    3 #> 3  1    6 #> 4  1    7 #> 5  1    8 #> 6  2   13 #> 7  2   17 #> 8  2   18 #> 9  2   19 tapply(e[,2], e[,1], mean, na.rm=TRUE) #>     1     2  #>  5.20 16.75   x <- c(z, z*2, z/3) names(x) <- letters[1:3]  e <- extract(x, v, ID=TRUE) de <- data.frame(e) aggregate(de[,2:4], de[,1,drop=FALSE], mean) #>   ID     a    b        c #> 1  1  5.20 10.4 1.733333 #> 2  2 16.75 33.5 5.583333"},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":null,"dir":"Reference","previous_headings":"","what":"extract values along lines — extractAlong","title":"extract values along lines — extractAlong","text":"Extract raster values along line. , returned values ordered along line. case extract","code":""},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"extract values along lines — extractAlong","text":"","code":"extractAlong(x, y, ID=TRUE, cells=FALSE, xy=FALSE, online=FALSE, bilinear=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"extract values along lines — extractAlong","text":"x SpatRaster y SpatVector lines geometry ID logical. ID column added? , first column returned IDs (record numbers) input SpatVector y cells logical. TRUE cell numbers also returned xy logical. TRUE coordinates cells traversed y also returned. See xyFromCell online logical. TRUE returned coordinates snapped y bilinear logical. TRUE returned raster values computed bilinear interpolation nearest four cells. relevant online=TRUE","code":""},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"extract values along lines — extractAlong","text":"data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"extract values along lines — extractAlong","text":"","code":"r <- rast(ncols=36, nrows=18, vals=1:(18*36)) cds1 <- rbind(c(-50,0), c(0,60), c(40,5), c(15,-45), c(-10,-25)) cds2 <- rbind(c(80,20), c(140,60), c(160,0), c(140,-55)) lines <- vect(list(cds1, cds2), \"lines\")  extractAlong(r, lines) #>    ID lyr.1 #> 1   1   337 #> 2   1   302 #> 3   1   266 #> 4   1   267 #> 5   1   231 #> 6   1   232 #> 7   1   196 #> 8   1   197 #> 9   1   161 #> 10  1   162 #> 11  1   126 #> 12  1    91 #> 13  1   127 #> 14  1   163 #> 15  1   164 #> 16  1   200 #> 17  1   201 #> 18  1   237 #> 19  1   273 #> 20  1   274 #> 21  1   310 #> 22  1   310 #> 23  1   346 #> 24  1   382 #> 25  1   381 #> 26  1   417 #> 27  1   453 #> 28  1   452 #> 29  1   488 #> 30  1   488 #> 31  1   487 #> 32  1   451 #> 33  1   450 #> 34  1   414 #> 35  2   279 #> 36  2   243 #> 37  2   244 #> 38  2   208 #> 39  2   209 #> 40  2   210 #> 41  2   174 #> 42  2   175 #> 43  2   139 #> 44  2   140 #> 45  2   105 #> 46  2   141 #> 47  2   177 #> 48  2   213 #> 49  2   214 #> 50  2   250 #> 51  2   286 #> 52  2   322 #> 53  2   323 #> 54  2   358 #> 55  2   394 #> 56  2   430 #> 57  2   429 #> 58  2   465 #> 59  2   501 #> 60  2   537"},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract values for a range of layers from a SpatRaster — extractRange","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"Extract values SpatRaster set locations range layers. extract values single layers, use extract","code":""},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"","code":"# S4 method for SpatRaster extractRange(x, y, first, last, lyr_fun=NULL,      geom_fun=NULL, ID=FALSE, na.rm=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"x SpatRaster y SpatVector (points, lines, polygons). Alternatively, points, 2-column matrix data.frame (x, y) (lon, lat). vector cell numbers first layer name number, indicating first layer range layers considered last layer name number, indicating last layer range considered lyr_fun function summarize extracted data across layers geom_fun function summarize extracted data line polygon geometry. Ignored y point geometry ID logical. ID column added? , first column returned IDs (record numbers) y na.rm logical. missing values ignored? ... additional arguments passed extract","code":""},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"numeric data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    xy <- data.frame(c(50,80), c(30, 60)) extract(r, xy) #>   ID red green blue #> 1  1 149   158  215 #> 2  2  68    67   63 extract(r, xy, layer=c(\"red\", \"green\")) #>   ID layer value #> 1  1   red   149 #> 2  2 green    67 extractRange(r, xy, first=1:2, last=3:2, lyr_fun=sum) #> [1] 522  67"},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":null,"dir":"Reference","previous_headings":"","what":"Categorical rasters — factors","title":"Categorical rasters — factors","text":"SpatRaster layer can represent categorical variable (factor). Like factors, SpatRaster categories stored integers associated label. categories can inspected levels cats. represented data.frame must two columns, first one identifying (integer) cell values column(s) providing category labels. multiple columns categories, can set \"active\" category choose one want use. cats returns entire data.frame, whereas levels return two columns: index active category. set categories first layer SpatRaster, can provide levels<- data.frame list data.frame. set categories multiple layers can provide levels<- list one element (either data.frame NULL) layer. Use categories set categories specific layer specific layers. droplevels removes categories used (declared present values raster) levels=NULL. addCats adds additional categories layer already categorical. adds new variables, new levels existing categorical variable.","code":""},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Categorical rasters — factors","text":"","code":"# S4 method for SpatRaster levels(x)  # S4 method for SpatRaster levels(x)<-value  # S4 method for SpatRaster cats(x, layer)  # S4 method for SpatRaster categories(x, layer=1, value, active=1, ...)  # S4 method for SpatRaster droplevels(x, level=NULL, layer=1)  # S4 method for SpatRaster addCats(x, value, merge=FALSE, layer=1)"},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Categorical rasters — factors","text":"x SpatRaster layer layer name number (positive integer); 0 layers value data.frame (ID, category) define categories. NULL remove active positive integer, indicating column value used active category (zero based skip first column cell values; 1 second column value) level categories remove layer specified layer merge logical. TRUE, categories combined merge using first column value ID. FALSE categories combined cbind ... additional arguments (none)","code":""},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Categorical rasters — factors","text":"list data.frames (levels, cats) logical (.factor)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Categorical rasters — factors","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) is.factor(r) #> [1] FALSE  cls <- data.frame(id=1:3, cover=c(\"forest\", \"water\", \"urban\")) levels(r) <- cls is.factor(r) #> [1] TRUE r #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : cover  #> name        :  cover  #> min value   : forest  #> max value   :  urban   plot(r, col=c(\"green\", \"blue\", \"light gray\")) text(r, digits=3, cex=.75, halo=TRUE)   # raster starts at 3 x <- r + 2 is.factor(x) #> [1] FALSE  # Multiple categories d <- data.frame(id=3:5, cover=cls[,2], letters=letters[1:3], value=10:12) levels(x) <- d x #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : cover, letters, value  #> name        :  cover  #> min value   : forest  #> max value   :  urban   # get current index activeCat(x) #> [1] 1 # set index  activeCat(x) <- 3 activeCat(x) #> [1] 3 activeCat(x) <- \"letters\" plot(x, col=c(\"green\", \"blue\", \"light gray\")) text(x, digits=3, cex=.75, halo=TRUE)   r <- as.numeric(x) r #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : cover  #> min value   :     1  #> max value   :     3   p <- as.polygons(x) plot(p, \"letters\", col=c(\"green\", \"blue\", \"light gray\"))"},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":null,"dir":"Reference","previous_headings":"","what":"Remove holes from polygons — fillHoles","title":"Remove holes from polygons — fillHoles","text":"Remove holes SpatVector polygons. inverse=TRUE holes returned (polygons).","code":""},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Remove holes from polygons — fillHoles","text":"","code":"# S4 method for SpatVector fillHoles(x, inverse=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Remove holes from polygons — fillHoles","text":"x SpatVector inverse logical. TRUE holes returned polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Remove holes from polygons — fillHoles","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Remove holes from polygons — fillHoles","text":"","code":"x <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) hole <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13))  z <- rbind(cbind(object=1, part=1, x, hole=0),         cbind(object=1, part=1, hole, hole=1)) colnames(z)[3:4] <- c('x', 'y') p <- vect(z, \"polygons\", atts=data.frame(id=1)) p #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 1, 1  (geometries, attributes) #>  extent      : -10, 160, -55, 60  (xmin, xmax, ymin, ymax) #>  coord. ref. :   #>  names       :    id #>  type        : <num> #>  values      :     1  f <- fillHoles(p) g <- fillHoles(p, inverse=TRUE)  plot(p, lwd=16, border=\"gray\", col=\"light yellow\") polys(f, border=\"blue\", lwd=3, density=4, col=\"orange\") polys(g, col=\"white\", lwd=3)"},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":null,"dir":"Reference","previous_headings":"","what":"Fill time gaps in a SpatRaster — fillTime","title":"Fill time gaps in a SpatRaster — fillTime","text":"Add empty layers existing layers time step layer .  See approximate estimate values layer (missing values)","code":""},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fill time gaps in a SpatRaster — fillTime","text":"","code":"# S4 method for SpatRaster fillTime(x, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fill time gaps in a SpatRaster — fillTime","text":"x SpatRaster filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fill time gaps in a SpatRaster — fillTime","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Fill time gaps in a SpatRaster — fillTime","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s <- c(r, r) time(s) <- as.Date(\"2001-01-01\") + c(0:2, 5:7) time(s) #> [1] \"2001-01-01\" \"2001-01-02\" \"2001-01-03\" \"2001-01-06\" \"2001-01-07\" #> [6] \"2001-01-08\" ss <- fillTime(s) time(ss) #> [1] \"2001-01-01\" \"2001-01-02\" \"2001-01-03\" \"2001-01-04\" \"2001-01-05\" #> [6] \"2001-01-06\" \"2001-01-07\" \"2001-01-08\"  a <- approximate(ss)"},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":null,"dir":"Reference","previous_headings":"","what":"Flip or reverse a raster — flip","title":"Flip or reverse a raster — flip","text":"Flip values SpatRaster inverting order rows (vertical=TRUE) columns (vertical=FALSE). rev horizontal ** vertical flip.","code":""},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Flip or reverse a raster — flip","text":"","code":"# S4 method for SpatRaster flip(x, direction=\"vertical\", filename=\"\", ...)  # S4 method for SpatVector flip(x, direction=\"vertical\")  # S4 method for SpatRaster rev(x)"},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Flip or reverse a raster — flip","text":"x SpatRaster SpatVector direction character. (partially) match \"vertical\" flip rows, \"horizontal\" flip columns filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Flip or reverse a raster — flip","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Flip or reverse a raster — flip","text":"","code":"r <- rast(nrow=18, ncol=36) m <- matrix(1:ncell(r), nrow=18) values(r) <- as.vector(t(m)) rx <- flip(r, direction=\"h\")  values(r) <- as.vector(m) ry <- flip(r, direction=\"v\")  v <- rev(r)"},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal values — focal","title":"Focal values — focal","text":"Calculate focal (\"moving window\") values cell.","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal values — focal","text":"","code":"# S4 method for SpatRaster focal(x, w=3, fun=\"sum\", ..., na.policy=\"all\", fillvalue=NA,      expand=FALSE, silent=TRUE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal values — focal","text":"x SpatRaster w window. window can defined one (square) two numbers (row, col); odd-sized weights matrix. See Details. fun function takes multiple numbers, returns numeric vector (one multiple numbers). example mean, modal, min max ... additional arguments passed fun na.rm na.policy character. Can used determine cells x focal values computed. Must one \"\" (compute cells), \"\" (cells NA) \"omit\" (skip cells NA). Note value argument affect cells around focal cell included computations (use na.rm=TRUE ignore cells NA ) fillvalue numeric. value cells virtual rows columns outside raster expand logical. TRUE value cells virtual rows columns outside raster set value border. available \"build-\" funs mean, sum, min max silent logical. TRUE error messages printed may occur trying fun determine length returned value. can useful debugging fun work filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Focal values — focal","text":"focal  window used must odd dimensions. need even sides, can use matrix add column row NA's mask values. Window values typically 1 NA indicate whether value used ignored computations, respectively. NA values w can useful creating non-rectangular (e.g. circular) windows. weights matrix numeric values can also supplied w. case weights matrix, cells NA weights ignored, rest values focal window multiplied corresponding weight prior `fun` applied. Note, na.rm need TRUE w contains NA values cells ignored computations. \"mean\" function special case, supplying weights w instead calculate weighted mean. \"sum\" function returns NA focal cells NA na.rm=TRUE. R normally return zero cases. See difference focal(x, fun=sum, na.rm=TRUE) focal(x, fun=\\() sum(, na.rm=TRUE)) Example weight matrices Laplacian filter: filter=matrix(c(0,1,0,1,-4,1,0,1,0), nrow=3) Sobel filters (edge detection): fx=matrix(c(-1,-2,-1,0,0,0,1,2,1), nrow=3) fy=matrix(c(1,0,-1,2,0,-2,1,0,-1), nrow=3)","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Focal values — focal","text":"using global lon/lat rasters, focal window \"wraps around\" date-line.","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal values — focal","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal values — focal","text":"","code":"r <- rast(ncols=10, nrows=10, ext(0, 10, 0, 10)) values(r) <- 1:ncell(r)  f <- focal(r, w=3, fun=function(x, ...) quantile(x, c(.25, .5, .75), ...), na.rm=TRUE)   f <- focal(r, w=3, fun=\"mean\")   # the following two statements are equivalent: a <- focal(r, w=matrix(1/9, nc=3, nr=3)) b <- focal(r, w=3, fun=mean, na.rm=FALSE)  # but this is different d <- focal(r, w=3, fun=mean, na.rm=TRUE)  ## illustrating the effect of different  ## combinations of na.rm and na.policy v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) r[45:50, 45:50] <- NA  # also try \"mean\" or \"min\" f <- \"sum\"  # na.rm=FALSE plot(focal(r, 5, f) , fun=lines(v))   # na.rm=TRUE plot(focal(r, 5, f, na.rm=TRUE), fun=lines(v))   # only change cells that are NA plot(focal(r, 5, f, na.policy=\"only\", na.rm=TRUE), fun=lines(v))   # do not change cells that are NA plot(focal(r, 5, f, na.policy=\"omit\", na.rm=TRUE), fun=lines(v))   # does not do anything # focal(r, 5, f, na.policy=\"only\", na.rm=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":null,"dir":"Reference","previous_headings":"","what":"Three-dimensional focal values — focal3D","title":"Three-dimensional focal values — focal3D","text":"Calculate focal (\"moving window\") values three-dimensional neighborhood (window) focal cells. See focal two-dimensional focal computation.","code":""},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Three-dimensional focal values — focal3D","text":"","code":"# S4 method for SpatRaster focal3D(x, w=3, fun=mean, ..., na.policy=\"all\", fillvalue=NA, pad=FALSE,    padvalue=fillvalue, expand=FALSE, silent=TRUE,    filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Three-dimensional focal values — focal3D","text":"x SpatRaster w window. rectangular prism (cuboid) defined three numbers three-dimensional array. values used weights, usually zero, one, NA, fractions. window used must odd dimensions. desire use even sides, can use array, pad values rows /columns contain NAs. fun function takes multiple numbers, returns one multiple numbers focal area. example mean, modal, min max ... additional arguments passed fun na.rm na.policy character. Can used determine cells x, central layer, focal values computed. Must one \"\" (compute cells), \"\" (cells NA) \"omit\" (skip cells NA). Note value argument affect cells around focal cell included computations (use na.rm=TRUE ignore cells NA computation focal value) fillvalue numeric. value cells virtual rows columns outside raster pad logical. Add virtual layers first last layer padvalue numeric. value cells virtual layers expand logical. Add virtual layers first last layer first last layers. TRUE, arguments pad padvalue ignored silent logical. TRUE error messages printed may occur trying fun determine length returned value. can useful debugging function passed fun work filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Three-dimensional focal values — focal3D","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Three-dimensional focal values — focal3D","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- focal3D(r, c(5,5,3), na.rm=TRUE)  a <- array(c(0,1,0,1,1,1,0,1,0, rep(1,9), 0,1,0,1,1,1,0,1,0), c(3,3,3)) a[a==0] <- NA z <- focal3D(r, a, na.rm=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute focal values with an iterating C++ function — focalCpp","title":"Compute focal values with an iterating C++ function — focalCpp","text":"Calculate focal values C++ function iterates cells speed computations avoiding R loop (apply). See focal easier use method.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute focal values with an iterating C++ function — focalCpp","text":"","code":"# S4 method for SpatRaster focalCpp(x, w=3, fun, ..., fillvalue=NA,      silent=TRUE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute focal values with an iterating C++ function — focalCpp","text":"x SpatRaster w window. window can defined one (square) two numbers (row, col); odd-sized weights matrix. See Details section focal fun cppFunction iterates cells. C++ functions operate single focal window, R functions use focal instead. function must least three arguments. first argument can name, must Rcpp::NumericVector, Rcpp::IntegerVector std::vector<double>. container receives focal values. two arguments ni wi must type size_t. ni represents number cells nw represents size (number elements ) window ... additional arguments fun fillvalue numeric. value cells virtual rows columns outside raster silent logical. TRUE error messages printed may occur trying fun determine length returned value. can useful debugging fun work filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute focal values with an iterating C++ function — focalCpp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute focal values with an iterating C++ function — focalCpp","text":"","code":"if (FALSE) { library(Rcpp) cppFunction(    'NumericVector sum_and_multiply(NumericVector x, double m, size_t ni, size_t nw) {     NumericVector out(ni);     // loop over cells     size_t start = 0;     for (size_t i=0; i<ni; i++) {       size_t end = start + nw;       // compute something for a window       double v = 0;       // loop over the values of a window       for (size_t j=start; j<end; j++) {         v += x[j];       }       out[i] = v * m;       start = end;     }     return out;   }' )  nr <- nc <- 10 r <- rast(ncols=nc, nrows=nr, ext= c(0, nc, 0, nr)) values(r) <- 1:ncell(r)  raw <- focalCpp(r, w=3, fun=sum_and_multiply, fillvalue=0, m=10)  # same as f1 <- focal(r, w=3, fun=sum, fillvalue=0) *10 all(values(f1) == values(raw))  # and as ffun <- function(x, m) { sum(x) * m } f2 <- focal(r, w=3, fun=ffun, fillvalue=0, m=10)   # You can also use an R function with focalCpp but this # is not recommended   R_sm_iter <- function(x, m, ni, nw) {   out <- NULL   for (i in 1:ni) {     start <- (i-1) * nw + 1     out[i] <- sum(x[start:(start+nw-1)]) * m   }   out }  fr <- focalCpp(r, w=3, fun=R_sm_iter, fillvalue=0, m=10)  }"},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal weights matrix — focalMat","title":"Focal weights matrix — focalMat","text":"Make focal (\"moving window\") weight matrix use focal function. sum values adds one.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal weights matrix — focalMat","text":"","code":"focalMat(x, d, type=c('circle', 'Gauss', 'rectangle'), fillNA=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal weights matrix — focalMat","text":"x SpatRaster d numeric. type=circle, radius circle (units crs). type=rectangle dimension rectangle (one two numbers). type=Gauss size sigma, optionally another number determine size matrix returned (default 3*sigma) type character indicating type filter returned fillNA logical. TRUE, zeros set NA ignored computations. applies type=\"circle\"","code":""},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal weights matrix — focalMat","text":"matrix can used focal","code":""},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal weights matrix — focalMat","text":"","code":"r <- rast(ncols=180, nrows=180, xmin=0) focalMat(r, 2, \"circle\") #>            [,1]       [,2]       [,3]       [,4]       [,5] #> [1,] 0.00000000 0.00000000 0.07692308 0.00000000 0.00000000 #> [2,] 0.00000000 0.07692308 0.07692308 0.07692308 0.00000000 #> [3,] 0.07692308 0.07692308 0.07692308 0.07692308 0.07692308 #> [4,] 0.00000000 0.07692308 0.07692308 0.07692308 0.00000000 #> [5,] 0.00000000 0.00000000 0.07692308 0.00000000 0.00000000  focalMat(r, c(2,3), \"rect\") #>            [,1]       [,2]       [,3]       [,4]       [,5] #> [1,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [2,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [3,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [4,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [5,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [6,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [7,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143  # Gaussian filter for square cells gf <- focalMat(r, 1, \"Gauss\")"},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal function across two layers — focalPairs","title":"Focal function across two layers — focalPairs","text":"Calculate values correlation coefficient focal regions two neighboring layers. function applied first second layer, second third layer, etc.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal function across two layers — focalPairs","text":"","code":"# S4 method for SpatRaster focalPairs(x, w=3, fun, ..., fillvalue=NA,      filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal function across two layers — focalPairs","text":"x SpatRaster least two layers w numeric matrix define focal window. window defined one (square) two numbers (row, col); odd-sized weights matrix. See Details section focal. Note matrix numbers zero one used, values used weights. work, fun must argument weights fun function least two arguments (one layer). built-function \"pearson\" (weighted unweighted Pearson correlation coefficient. function additional argument na.rm=FALSE ... additional arguments fun fillvalue numeric. value cells virtual rows columns outside raster filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal function across two layers — focalPairs","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal function across two layers — focalPairs","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) set.seed(0) r[[1]] <- flip(r[[1]], \"horizontal\") r[[2]] <- flip(r[[2]], \"vertical\") + init(rast(r,1), runif) r[[3]] <- init(rast(r,1), runif)  x <- focalPairs(r, w=5, \"pearson\", na.rm=TRUE) plot(x)    # suppress warning \"the standard deviation is zero\" suppressWarnings(x <- focalPairs(r, w=5, \"pearson\", use=\"complete.obs\"))  z <- focalPairs(r, w=9, function(x, y) mean(x) + mean(y))"},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal regression — focalReg","title":"Focal regression — focalReg","text":"Calculate values moving-window comparing value one layers values one many layers. typical case computation coefficients focal linear regression model.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal regression — focalReg","text":"","code":"# S4 method for SpatRaster focalReg(x, w=3, fun=\"ols\", ..., fillvalue=NA, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal regression — focalReg","text":"x SpatRaster least two layers. first \"Y\" (dependent) variable remainder \"X\" (independent) variables w numeric matrix define focal window. window defined one (square) two numbers (row, col); odd-sized weights matrix. See Details section focal. Note matrix numbers zero one used, values used weights. work, fun must argument weights fun function least two arguments (one layer). built-function \"ols\" weighted unweighted Ordinary Least Square regression. function additional argument na.rm=FALSE intercept=TRUE ... additional arguments fun fillvalue numeric. value cells virtual rows columns outside raster filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal regression — focalReg","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal regression — focalReg","text":"","code":"r <- rast(ncols=10, nrows=10, ext(0, 10, 0, 10)) values(r) <- 1:ncell(r) x <- c(r, init(r, runif) * r) f <- focalReg(x, 3)"},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":null,"dir":"Reference","previous_headings":"","what":"Get focal values — focalValues","title":"Get focal values — focalValues","text":"Get matrix row focal values cell. values cell rectangular window around .","code":""},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get focal values — focalValues","text":"","code":"# S4 method for SpatRaster focalValues(x, w=3, row=1, nrows=nrow(x), fill=NA)"},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get focal values — focalValues","text":"x SpatRaster SpatVector w window. window can defined one (square) two odd numbers (row, col); odd sized matrix row positive integer. Row number start , 1 nrow(x) nrows positive integer. many rows? fill numeric used values imaginary cells outside raster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get focal values — focalValues","text":"matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get focal values — focalValues","text":"","code":"r <- rast(ncol=4, nrow=4, crs=\"+proj=utm +zone=1 +datum=WGS84\") values(r) <- 1:ncell(r) focalValues(r) #>       [,1] [,2] [,3] [,4] [,5] [,6] [,7] [,8] [,9] #>  [1,]   NA   NA   NA   NA    1    2   NA    5    6 #>  [2,]   NA   NA   NA    1    2    3    5    6    7 #>  [3,]   NA   NA   NA    2    3    4    6    7    8 #>  [4,]   NA   NA   NA    3    4   NA    7    8   NA #>  [5,]   NA    1    2   NA    5    6   NA    9   10 #>  [6,]    1    2    3    5    6    7    9   10   11 #>  [7,]    2    3    4    6    7    8   10   11   12 #>  [8,]    3    4   NA    7    8   NA   11   12   NA #>  [9,]   NA    5    6   NA    9   10   NA   13   14 #> [10,]    5    6    7    9   10   11   13   14   15 #> [11,]    6    7    8   10   11   12   14   15   16 #> [12,]    7    8   NA   11   12   NA   15   16   NA #> [13,]   NA    9   10   NA   13   14   NA   NA   NA #> [14,]    9   10   11   13   14   15   NA   NA   NA #> [15,]   10   11   12   14   15   16   NA   NA   NA #> [16,]   11   12   NA   15   16   NA   NA   NA   NA"},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":null,"dir":"Reference","previous_headings":"","what":"force counter-clockwise polygons — forceCCW","title":"force counter-clockwise polygons — forceCCW","text":"Assure nodes outer rings polygons counter-clockwise order.","code":""},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"force counter-clockwise polygons — forceCCW","text":"","code":"# S4 method for SpatVector forceCCW(x)"},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"force counter-clockwise polygons — forceCCW","text":"x SpatVector polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"force counter-clockwise polygons — forceCCW","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"force counter-clockwise polygons — forceCCW","text":"","code":"p <- vect(\"POLYGON ((2 45, 2 55, 18 55, 18 45, 2 45))\") pcc <- forceCCW(p) geom(pcc, wkt=TRUE) #> [1] \"POLYGON ((2 45, 18 45, 18 55, 2 55, 2 45))\""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":null,"dir":"Reference","previous_headings":"","what":"Frequency table — freq","title":"Frequency table — freq","text":"Frequency table values SpatRaster. NAs counted unless value=NA. can provide SpatVector additional SpatRaster define zones tabulations.","code":""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Frequency table — freq","text":"","code":"# S4 method for SpatRaster freq(x, digits=0, value=NULL, bylayer=TRUE, usenames=FALSE, zones=NULL, wide=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Frequency table — freq","text":"x SpatRaster digits integer. Used rounding values tabulation. Ignored NA value numeric. optional single value count number cells value. value can NA bylayer logical. TRUE tabulation done layer usenames logical. TRUE layers identified names instead numbers relevant bylayer TRUE zones SpatRaster SpatVector define zones tabulation done wide logical. results \"wide\" instead \"long\"?","code":""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Frequency table — freq","text":"data.frame 3 columns (layer, value, count) unless bylayer=FALSE case adata.frame two columns returned (value, count).","code":""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Frequency table — freq","text":"","code":"r <- rast(nrows=10, ncols=10) set.seed(2) values(r) <- sample(5, ncell(r), replace=TRUE)  freq(r) #>   layer value count #> 1     1     1    27 #> 2     1     2    15 #> 3     1     3    17 #> 4     1     4    17 #> 5     1     5    24  x <- c(r, r/3) freq(x, bylayer=FALSE) #>   value count #> 1     0    27 #> 2     1    76 #> 3     2    39 #> 4     3    17 #> 5     4    17 #> 6     5    24 freq(x) #>   layer value count #> 1     1     1    27 #> 2     1     2    15 #> 3     1     3    17 #> 4     1     4    17 #> 5     1     5    24 #> 6     2     0    27 #> 7     2     1    49 #> 8     2     2    24  freq(x, digits=1) #>    layer value count #> 1      1   1.0    27 #> 2      1   2.0    15 #> 3      1   3.0    17 #> 4      1   4.0    17 #> 5      1   5.0    24 #> 6      2   0.3    27 #> 7      2   0.7    15 #> 8      2   1.0    17 #> 9      2   1.3    17 #> 10     2   1.7    24 freq(x, digits=-1) #>   layer value count #> 1     1     0    76 #> 2     1    10    24 #> 3     2     0   100  freq(x, value=5) #>   layer value count #> 1     1     5    24 #> 2     2     5     0"},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":null,"dir":"Reference","previous_headings":"","what":"Find gaps between polygons — gaps","title":"Find gaps between polygons — gaps","text":"Get gaps polygons SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find gaps between polygons — gaps","text":"","code":"# S4 method for SpatVector gaps(x)"},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find gaps between polygons — gaps","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find gaps between polygons — gaps","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Find gaps between polygons — gaps","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) h <- convHull(v[-12], \"NAME_1\") g <- gaps(h)"},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":null,"dir":"Reference","previous_headings":"","what":"GDAL version, supported file formats, and cache size — gdal","title":"GDAL version, supported file formats, and cache size — gdal","text":"Set GDAL warning level get data.frame available GDAL drivers (file formats), , warn=NA drivers=FALSE, get version numbers one GDAL, PROJ GEOS libraries. GDAL software library terra builds read write spatial data raster data processing. PROJ used transformation coordinates (\"projection\") GEOS used geometric operations vector data.","code":""},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"GDAL version, supported file formats, and cache size — gdal","text":"","code":"gdal(warn=NA, drivers=FALSE, lib=\"gdal\") gdalCache(size=NA) setGDALconfig(option, value=\"\") getGDALconfig(option)"},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"GDAL version, supported file formats, and cache size — gdal","text":"warn NA drivers=FALSE, version library specified lib returned. Otherwise, value integer 1 4 representing level GDAL warnings errors passed R. 1 = warnings errors; 2 = errors (recoverable errors warning); 3 = irrecoverable errors ; 4 = ignore errors warnings. default setting 3 drivers logical. TRUE data.frame raster vector data formats available. lib character. \"gdal\", \"proj\", \"geos\", value get versions numbers three size numeric. new cache size MB option character. GDAL configuration option name, \"name=value\" string (case value argument ignored value character. value GDAL configuration option. Use \"\" reset default value","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"GDAL version, supported file formats, and cache size — gdal","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"GDAL version, supported file formats, and cache size — gdal","text":"","code":"gdal() #> [1] \"3.9.0\" gdal(2) head(gdal(drivers=TRUE)) #>      name raster vector        can  vsi                     long.name #> 1 AAIGrid   TRUE  FALSE read/write TRUE           Arc/Info ASCII Grid #> 2    ACE2   TRUE  FALSE       read TRUE                          ACE2 #> 3    ADRG   TRUE  FALSE read/write TRUE ARC Digitized Raster Graphics #> 4     AIG   TRUE  FALSE       read TRUE          Arc/Info Binary Grid #> 5  AVCBin  FALSE   TRUE       read TRUE      Arc/Info Binary Coverage #> 6  AVCE00  FALSE   TRUE       read TRUE Arc/Info E00 (ASCII) Coverage"},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the geometry (coordinates) of a SpatVector — geom","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"Get geometry SpatVector. wkt=FALSE, five-column matrix data.frame: vector object ID, IDs parts object (e.g. five polygons together one spatial object), x (longitude) y (latitude) coordinates, flag indicating whether part \"hole\" (relevant polygons). wkt=TRUE, \"well-known text\" representation returned character vector.","code":""},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"","code":"# S4 method for SpatVector geom(x, wkt=FALSE, hex=FALSE, df=FALSE, list=FALSE, xnm=\"x\", ynm=\"y\")"},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"x SpatVector wkt logical. TRUE WKT geometry returned (unless hex also TRUE) hex logical. TRUE hexadecimal geometry returned df logical. TRUE data.frame returned instead matrix (wkt=FALSE, hex=FALSE, list=FALSE) list logical. TRUE nested list returned data.frames coordinates xnm character. list=TRUE \"x\" column name coordinates data.frame ynm character. list=TRUE \"y\" column name coordinates data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"matrix, vector, data.frame, list","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"","code":"x1 <- rbind(c(-175,-20), c(-140,55), c(10, 0), c(-140,-60)) x2 <- rbind(c(-125,0), c(0,60), c(40,5), c(15,-45)) x3 <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) x4 <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13)) z <- rbind(cbind(object=1, part=1, x1), cbind(object=2, part=1, x2),             cbind(object=3, part=1, x3), cbind(object=3, part=2,  x4)) colnames(z)[3:4] <- c('x', 'y') z <- cbind(z, hole=0) z[(z[, \"object\"]==3 & z[,\"part\"]==2), \"hole\"] <- 1  p <- vect(z, \"polygons\") geom(p) #>       geom part    x   y hole #>  [1,]    1    1 -175 -20    0 #>  [2,]    1    1 -140  55    0 #>  [3,]    1    1   10   0    0 #>  [4,]    1    1 -140 -60    0 #>  [5,]    1    1 -175 -20    0 #>  [6,]    2    1 -125   0    0 #>  [7,]    2    1    0  60    0 #>  [8,]    2    1   40   5    0 #>  [9,]    2    1   15 -45    0 #> [10,]    2    1 -125   0    0 #> [11,]    3    1  -10   0    0 #> [12,]    3    1  140  60    0 #> [13,]    3    1  160   0    0 #> [14,]    3    1  140 -55    0 #> [15,]    3    1  -10   0    0 #> [16,]    3    1   80   0    1 #> [17,]    3    1  105  13    1 #> [18,]    3    1  120   2    1 #> [19,]    3    1  105 -13    1 #> [20,]    3    1   80   0    1  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) g <- geom(v) head(g) #>      geom part        x        y hole #> [1,]    1    1 6.026519 50.17767    0 #> [2,]    1    1 6.031361 50.16563    0 #> [3,]    1    1 6.035646 50.16410    0 #> [4,]    1    1 6.042747 50.16157    0 #> [5,]    1    1 6.043894 50.16116    0 #> [6,]    1    1 6.048243 50.16008    0  w <- geom(v, wkt=TRUE) substr(w, 1, 60) #>  [1] \"POLYGON ((6.026519 50.17767, 6.031361 50.165627, 6.035646 50\" #>  [2] \"POLYGON ((6.178368 49.876823, 6.185479 49.870525, 6.189417 4\" #>  [3] \"POLYGON ((5.881378 49.870148, 5.881672 49.868866, 5.886637 4\" #>  [4] \"POLYGON ((6.131309 49.972565, 6.134291 49.972382, 6.139316 4\" #>  [5] \"POLYGON ((5.977929 50.026016, 5.982312 50.022949, 5.981743 5\" #>  [6] \"POLYGON ((6.385532 49.837029, 6.3886 49.833683, 6.390184 49.\" #>  [7] \"POLYGON ((6.316665 49.623375, 6.31835 49.623157, 6.320131 49\" #>  [8] \"POLYGON ((6.425158 49.731644, 6.42657 49.73082, 6.427332 49.\" #>  [9] \"POLYGON ((5.998312 49.699924, 5.998632 49.698559, 5.998956 4\" #> [10] \"POLYGON ((6.039474 49.448261, 6.036906 49.448696, 6.036822 4\" #> [11] \"POLYGON ((6.155963 49.685047, 6.159284 49.685036, 6.161457 4\" #> [12] \"POLYGON ((6.067982 49.828465, 6.071922 49.825478, 6.073236 4\""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":null,"dir":"Reference","previous_headings":"","what":"Geometry type of a SpatVector — geomtype","title":"Geometry type of a SpatVector — geomtype","text":"Get geometry type (points, lines, polygons) SpatVector. See datatype data types fields (attributes, variables) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Geometry type of a SpatVector — geomtype","text":"","code":"# S4 method for SpatVector geomtype(x)  # S4 method for SpatVector is.points(x)  # S4 method for SpatVector is.lines(x)  # S4 method for SpatVector is.polygons(x)"},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Geometry type of a SpatVector — geomtype","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Geometry type of a SpatVector — geomtype","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Geometry type of a SpatVector — geomtype","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  geomtype(v) #> [1] \"polygons\" is.polygons(v) #> [1] TRUE is.lines(v) #> [1] FALSE is.points(v) #> [1] FALSE  names(v) #> [1] \"ID_1\"   \"NAME_1\" \"ID_2\"   \"NAME_2\" \"AREA\"   \"POP\"    datatype(v) #> [1] \"double\" \"string\" \"double\" \"string\" \"double\" \"long\""},{"path":"https://rspatial.github.io/terra/reference/global.html","id":null,"dir":"Reference","previous_headings":"","what":"global statistics — global","title":"global statistics — global","text":"Compute global statistics, summarized values entire SpatRaster. x large global can fail, except fun one built-functions \"mean\", \"min\", \"max\", \"sum\", \"prod\", \"range\" (min max), \"rms\" (root mean square), \"sd\" (sample standard deviation), \"std\" (population standard deviation), \"isNA\" (number cells NA), \"notNA\" (number cells NA). reason can fail large raster custom function values need loaded memory. circumvent problem can run global sample cells. can compute weighted mean sum providing SpatRaster weights.","code":""},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"global statistics — global","text":"","code":"# S4 method for SpatRaster global(x, fun=\"mean\", weights=NULL, maxcell=Inf, ...)"},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"global statistics — global","text":"x SpatRaster fun function applied summarize values zone. Either one built-character values: \"max\", \"min\", \"mean\", \"sum\", \"range\", \"rms\" (root mean square), \"sd\", \"std\" (population sd, using n rather n-1), \"isNA\", \"notNA\"; proper R function (may fail large SpatRasters unless specify maxcell) ... additional arguments passed fun weights NULL SpatRaster maxcell positive integer used take regular sample x. Ignored built-functions.","code":""},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"global statistics — global","text":"data.frame row layer","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"global statistics — global","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) global(r, \"sum\") #>        sum #> lyr.1 5050 global(r, \"mean\", na.rm=TRUE) #>       mean #> lyr.1 50.5 x <- c(r, r/10) global(x, c(\"sum\", \"mean\", \"sd\"), na.rm=TRUE) #>          sum  mean        sd #> lyr.1   5050 50.50 29.011492 #> lyr.1.1  505  5.05  2.901149  global(x, function(i) min(i) / max(i)) #>         global #> lyr.1     0.01 #> lyr.1.1   0.01"},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a graticule — graticule","title":"Create a graticule — graticule","text":"Create graticule. , grid lon/lat lines can used projected map. object returned, SpatGraticule, can plotted plot lines. also crop method.","code":""},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a graticule — graticule","text":"","code":"graticule(lon=30, lat=30, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a graticule — graticule","text":"lon numeric. Either single number (interval longitudes), vector longitudes lat numeric. Either single number (interval latitudes), vector latitudes crs character. coordinate reference system use","code":""},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a graticule — graticule","text":"SpatGraticule","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a graticule — graticule","text":"","code":"g <- graticule(60, 30, crs=\"+proj=robin\") g #> class       : SpatGraticule  #> lon         : -180 -120 -60 0 60 120 180  #> lat         : -90 -60 -30 0 30 60 90  #> coord. ref. : +proj=robin +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs  #> extent      : -17005833, 17005833, -8625155, 8625155  (xmin, xmax, ymin, ymax)  graticule(90, c(-90, -60, -23.5, 0, 23.5, 60, 90), crs=\"+proj=robin\") #> class       : SpatGraticule  #> lon         : -180 -90 0 90 180  #> lat         : -90 -60 -23.5 0 23.5 60 90  #> coord. ref. : +proj=robin +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs  #> extent      : -17005833, 17005833, -8625155, 8625155  (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":null,"dir":"Reference","previous_headings":"","what":"add a grid to a map made with terra — add_grid","title":"add a grid to a map made with terra — add_grid","text":"Adaptation grid allows adding grid map. function place legend locations within mapped area delineated axes. Also see graticule","code":""},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"add a grid to a map made with terra — add_grid","text":"","code":"add_grid(nx=NULL, ny=nx, col=\"lightgray\", lty=\"dotted\", lwd=1)"},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"add a grid to a map made with terra — add_grid","text":"nx, ny number cells grid x y direction. NULL, per default, grid aligns tick marks corresponding default axis (.e., tickmarks computed axTicks). NA, grid lines drawn corresponding direction col character (integer) numeric; color grid lines lty character (integer) numeric; line type grid lines lwd non-negative numeric giving line width grid lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"add a grid to a map made with terra — add_grid","text":"","code":"v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) plot(v) add_grid()"},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":null,"dir":"Reference","previous_headings":"","what":"Distance on a grid — gridDistance","title":"Distance on a grid — gridDistance","text":"function calculates distance cells SpatRaster path go centers eight neighboring raster cells. default distance (scale=1, meters coordinate reference system (CRS) SpatRaster longitude/latitude (+proj=longlat) linear units CRS (typically meters) cases. Distances computed summing local distances cells, connected neighbors 8 directions. shortest distance cells target value computed cells NA. Cells NA traversed ignored, unless target NA, case distance nearest cell NA computed cells NA.","code":""},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Distance on a grid — gridDistance","text":"","code":"# S4 method for SpatRaster gridDist(x, target=0, scale=1, maxiter=50, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Distance on a grid — gridDistance","text":"x SpatRaster target numeric. value target cells (compute distance ) scale numeric. Scale factor. longitude/latitude data 1 = \"m\" 1000 = \"km\". planar data also case distance unit crs \"m\" maxiter numeric. maximum number iterations. Increase number get warning costDistance converge. relevant target NA filename character. output filename (optional) ... additional arguments writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Distance on a grid — gridDistance","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Distance on a grid — gridDistance","text":"","code":"# global lon/lat raster r <- rast(ncol=10,nrow=10, vals=1) r[48] <- 0 r[66:68] <- NA d <- gridDist(r)  plot(d)    # planar crs(r) <- \"+proj=utm +zone=15 +ellps=GRS80 +datum=NAD83 +units=m +no_defs\" d <- gridDist(r)  plot(d)   # distance to cells that are not NA  rr <- classify(r, cbind(1, NA)) dd <- gridDist(rr, NA)"},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":null,"dir":"Reference","previous_headings":"","what":"Add halo-ed text to a plot — halo","title":"Add halo-ed text to a plot — halo","text":"Add text plot \"halo\". , buffer around enhance visibility.","code":""},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add halo-ed text to a plot — halo","text":"","code":"halo(x, y=NULL, labels, col=\"black\", hc=\"white\", hw=0.1, ...)"},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add halo-ed text to a plot — halo","text":"x,y numeric. coordinates text labels written labels character. text written col character. main color used hc character. halo color hw numeric. halo width ... additional arguments pass text","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add halo-ed text to a plot — halo","text":"","code":"r <- rast(nrows=4, ncols=4) values(r) <- 1:ncell(r) plot(r, col=\"blue\", legend=FALSE)  text(-100, 20, \"hello\", cex=2) halo(50, 20, \"hello\", cex=2)  halo(0, -20, \"world\", font=3, hc=\"light blue\", cex=2, hw=.2) halo(0, 90, \"world\", font=2, cex=2, hw=.2, xpd=TRUE, pos=2) halo(0, 90, \"world\", col=\"white\", font=2, hc=\"blue\", cex=2, hw=.2, xpd=TRUE, pos=4)"},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":null,"dir":"Reference","previous_headings":"","what":"head and tail of a SpatRaster or SpatVector — headtail","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"Show head (first values) tail (last values) SpatRaster attributes SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"","code":"head(x, ...)  tail(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"x SpatRaster SpatVector ... additional arguments passed methods","code":""},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"matrix (SpatRaster) data.frame (SpatVector)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"","code":"r <- rast(nrows=25, ncols=25) values(r) <- 1:ncell(r) head(r) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 #> 5     5 #> 6     6 tail(r) #>   lyr.1 #> 1   620 #> 2   621 #> 3   622 #> 4   623 #> 5   624 #> 6   625"},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":null,"dir":"Reference","previous_headings":"","what":"Histogram — hist","title":"Histogram — hist","text":"Create histogram values SpatRaster. large datasets sample maxcell used.","code":""},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Histogram — hist","text":"","code":"# S4 method for SpatRaster hist(x, layer, maxcell=1000000, plot=TRUE, maxnl=16, main, ...)"},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Histogram — hist","text":"x SpatRaster layer positive integer character indicate layer numbers (names). missing, layers maxnl used maxcell integer. regularly sample large objects plot logical. Plot histogram return histogram values maxnl positive integer. maximum number layers use. Ignored layer missing main character. Main title(s) plot. Default value names ... additional arguments. See hist","code":""},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Histogram — hist","text":"function principally used plotting histogram, also returns object class \"histogram\" (invisibly plot=TRUE).","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Histogram — hist","text":"","code":"r1 <- r2 <- rast(nrows=50, ncols=50) values(r1) <- runif(ncell(r1)) values(r2) <- runif(ncell(r1)) rs <- r1 + r2 rp <- r1 * r2  opar <- par(no.readonly =TRUE) par(mfrow=c(2,2)) plot(rs, main='sum') plot(rp, main='product') hist(rs) a <- hist(rp)  a #> $breaks #>  [1] 0.0 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0 #>  #> $counts #>  [1] 816 483 352 250 188 159 117  76  42  17 #>  #> $density #>  [1] 3.264 1.932 1.408 1.000 0.752 0.636 0.468 0.304 0.168 0.068 #>  #> $mids #>  [1] 0.05 0.15 0.25 0.35 0.45 0.55 0.65 0.75 0.85 0.95 #>  #> $xname #> [1] \"lyr.1\" #>  #> $equidist #> [1] TRUE #>  #> attr(,\"class\") #> [1] \"histogram\" x <- c(rs, rp, sqrt(rs)) hist(x) par(opar)"},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare two SpatRasters for equality — identical","title":"Compare two SpatRasters for equality — identical","text":"Compare two SpatRasters equality. First attributes objects compared. , raster cells compared well. can time consuming, may prefer use sample instead .equal","code":""},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare two SpatRasters for equality — identical","text":"","code":"# S4 method for SpatRaster,SpatRaster identical(x, y)"},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare two SpatRasters for equality — identical","text":"x SpatRaster y SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare two SpatRasters for equality — identical","text":"single logical value","code":""},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare two SpatRasters for equality — identical","text":"","code":"x <- sqrt(1:100) mat <- matrix(x, 10, 10) r1 <- rast(nrows=10, ncols=10, xmin=0, vals = x) r2 <- rast(nrows=10, ncols=10, xmin=0, vals = t(mat))  identical(r1, r2) #> [1] TRUE identical(r1, r1*1) #> [1] TRUE identical(rast(r1), rast(r2)) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":null,"dir":"Reference","previous_headings":"","what":"ifelse for SpatRasters — ifel","title":"ifelse for SpatRasters — ifel","text":"Implementation ifelse SpatRasters. method allows concise expression can otherwise achieved combination classify, mask, cover. ifel R equivalent Con method ArcGIS (arcpy).","code":""},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"ifelse for SpatRasters — ifel","text":"","code":"# S4 method for SpatRaster ifel(test, yes, no, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"ifelse for SpatRasters — ifel","text":"test SpatRaster logical (TRUE/FALSE) values yes SpatRaster numeric SpatRaster numeric filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"ifelse for SpatRasters — ifel","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"ifelse for SpatRasters — ifel","text":"","code":"r <- rast(nrows=5, ncols=5, xmin=0, xmax=1, ymin=0, ymax=1) values(r) <- c(-10:0, NA, NA, NA, 0:10)  x <- ifel(r > 1, 1, r) # same as  a <- classify(r, cbind(1, Inf, 1)) # or b <- app(r, fun=function(i) {i[i > 1] <- 1; i}) # or  d <- clamp(r, -Inf, 1) # or (not recommended for large datasets) e <- r e[e>1] <- 1  ## other examples f <- ifel(is.na(r), 100, r)  z <- ifel(r > -2 & r < 2, 100, 0)  # nested expressions y <- ifel(r > 1, 1, ifel(r < -1, -1, r))  k <- ifel(r > 0, r+10, ifel(r < 0, r-10, 3))"},{"path":"https://rspatial.github.io/terra/reference/image.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster image method — image","title":"SpatRaster image method — image","text":"Plot (make map ) values SpatRaster via image. See plot need fancy options legend.","code":""},{"path":"https://rspatial.github.io/terra/reference/image.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster image method — image","text":"","code":"# S4 method for SpatRaster image(x, y=1, maxcell=500000, ...)"},{"path":"https://rspatial.github.io/terra/reference/image.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster image method — image","text":"x SpatRaster y positive integer indicating layer plotted, character indicating name layer maxcell positive integer. Maximum number cells use plot ... additional arguments graphics::image","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/image.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster image method — image","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\")  r <- rast(f) image(r)  image(r, col=rainbow(24))"},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":null,"dir":"Reference","previous_headings":"","what":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"Warp members SpatRasterCollection match geometry SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"","code":"# S4 method for SpatRasterCollection impose(x, y, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"x SpatRasterCollection y SpatRaster filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/init.html","id":null,"dir":"Reference","previous_headings":"","what":"Initialize a SpatRaster with values — initialize","title":"Initialize a SpatRaster with values — initialize","text":"Create SpatRaster values reflecting cell property: \"x\", \"y\", \"col\", \"row\", \"cell\" \"chess\". Alternatively, function can used. case, cell values initialized without reference pre-existing values. E.g., initialize random number (fun=runif). direct ways achieving small objects (see examples) vector values can created memory, init function also work SpatRasters many cells.","code":""},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Initialize a SpatRaster with values — initialize","text":"","code":"# S4 method for SpatRaster init(x, fun, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Initialize a SpatRaster with values — initialize","text":"x SpatRaster fun function applied. must either single number, multiple numbers, function, one set known character values. function must take number cells single argument return vector values length equal number cells, fun=runif. Allowed character values \"x\", \"y\", \"row\", \"col\", \"cell\", \"chess\" get x y coordinate, row, col cell number chessboard pattern (alternating 0 1 values) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Initialize a SpatRaster with values — initialize","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Initialize a SpatRaster with values — initialize","text":"","code":"r <- rast(ncols=10, nrows=5, xmin=0, xmax=10, ymin=0, ymax=5) x <- init(r, fun=\"cell\") y <- init(r, fun=runif)  # initialize with a single value  z <- init(r, fun=8)"},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":null,"dir":"Reference","previous_headings":"","what":"Change values in-place — inplace","title":"Change values in-place — inplace","text":"\"-place\" replacement methods assign new value object without making copy. efficient, copy object made standard assignment (e.g. y <- x), copy also changed. set.names -place replacement version names<-. set.ext -place replacement version ext<- set.values -place replacement version [<-. set.cats -place replacement version categories set.crs -place replacement version crs<-","code":""},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Change values in-place — inplace","text":"","code":"# S4 method for SpatRaster set.names(x, value, index=1:nlyr(x), validate=FALSE) # S4 method for SpatRasterDataset set.names(x, value, index=1:length(x), validate=FALSE) # S4 method for SpatVector set.names(x, value, index=1:ncol(x), validate=FALSE)  # S4 method for SpatRaster set.ext(x, value) # S4 method for SpatVector set.ext(x, value)  # S4 method for SpatRaster set.crs(x, value) # S4 method for SpatVector set.crs(x, value)  # S4 method for SpatRaster set.values(x, cells, values, layer=0)  # S4 method for SpatRaster set.cats(x, layer=1, value, active=1)  # S4 method for SpatRaster set.RGB(x, value, type=\"rgb\")"},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Change values in-place — inplace","text":"x SpatRaster value character set.names. set.cats: data.frame columns (value, category) vector category names. set.RGB 3 4 numbers indicating RGB() layers index positive integer indicating layer(s) assign name validate logical. Make names valid /unique? cells cell numbers missing values replacement values missing load values memory layer positive integer(s) indicating layer(s) want assign categories want set values. number < 1 indicates \"layers\" active positive integer indicating active category (column number value, counting first column type character. color space. One \"rgb\" \"hsv\", \"hsi\" \"hsl\"","code":""},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Change values in-place — inplace","text":"logical (invisibly)","code":""},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Change values in-place — inplace","text":"","code":"s <- rast(ncols=5, nrows=5, nlyrs=3) x <- s names(s) #> [1] \"lyr.1\" \"lyr.2\" \"lyr.3\" names(s) <- c(\"a\", \"b\", \"c\") names(s) #> [1] \"a\" \"b\" \"c\" names(x) #> [1] \"lyr.1\" \"lyr.2\" \"lyr.3\"  x <- s set.names(s, c(\"e\", \"f\", \"g\")) names(s) #> [1] \"e\" \"f\" \"g\" names(x) #> [1] \"e\" \"f\" \"g\"  set.ext(x, c(0,180,0,90))  f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f)  #values from file to memory set.values(r)  # change values set.values(r, 1:1000, 900)"},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":null,"dir":"Reference","previous_headings":"","what":"Make an inset map — inset","title":"Make an inset map — inset","text":"Make inset map scale extent SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make an inset map — inset","text":"","code":"# S4 method for SpatVector inset(x, e, loc=\"\", scale=0.2, background=\"white\",    perimeter=TRUE, box=NULL, pper, pbox, offset=0.1, add=TRUE, ...)  # S4 method for SpatRaster inset(x, e, loc=\"\", scale=0.2, background=\"white\",    perimeter=TRUE, box=NULL, pper, pbox, offset=0.1, add=TRUE, ...)  # S4 method for SpatVector inext(x, e, y=NULL, gap=0)"},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make an inset map — inset","text":"x SpatVector, SpatRaster e SpatExtent set size location inset. missing loc character. One \"bottomright\", \"bottom\", \"bottomleft\", \"left\", \"topleft\", \"top\", \"topright\", \"right\", \"center\" scale numeric. relative size inset, used x missing background color background inset. Use NA background color perimeter logical. TRUE perimeter (border) drawn around inset box SpatExtent missing, draw box inset, e.g. show map located larger area pper list graphical parameters (arguments) col lwd perimeter line pbox list graphical parameters (arguments) col lwd box (line) offset numeric. Value 0.1 1 indicate relative distance mapped bounding box add logical. Add inset map? ... additional arguments passed plot drawing x y SpatVector. NULL, y scaled based parameters x. useful, example, x represent boundaries, y points within boundaries gap numeric add space SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make an inset map — inset","text":"scaled shifted SpatVector SpatRaster (returned invisibly)","code":""},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make an inset map — inset","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) x <- v[v$NAME_2 == \"Diekirch\", ]  plot(x, density=10, col=\"blue\") inset(v)   # more elaborate plot(x, density=10, col=\"blue\") inset(v, col = \"brown\", border=\"lightgrey\", perimeter=TRUE,      pper=list(col=\"orange\", lwd=3, lty=2),      box=ext(x), pbox=list(col=\"blue\", lwd=2))  cols <- rep(\"light grey\", 12) cols[2] <- \"red\" e <- ext(c(6.2, 6.3, 49.9, 50)) b <- ext(x)+0.02 inset(v, e=e, col=cols, box=b)   # with a SpatRaster ff <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(ff) r <- crop(r, ext(x) + .01) plot(r, type=\"int\", mar=c(2,2,2,2), plg=list(x=\"topright\")) lines(v, lwd=1.5) lines(x, lwd=2.5) inset(v, col=cols, loc=\"topleft\", scale=0.15)   # a more complex one plot(r, plg=list(title=\"meter\\n\", shrink=.2, cex=.8)) lines(v, lwd=4, col=\"white\") lines(v, lwd=1.5) lines(x, lwd=2.5) text(x, \"NAME_2\", cex=1.5, halo=TRUE) sbar(6, c(6.04, 49.785), type=\"bar\", below=\"km\", label=c(0,3,6), cex=.8) s <- inset(v, col=cols, box=b, scale=.2, loc=\"topright\", background=\"light yellow\",   pbox=list(lwd=2, lty=5, col=\"blue\"))  # note the returned inset SpatVector s #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 6.255333, 6.321333, 49.9348, 49.99657  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 lines(s, col=\"orange\")"},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":null,"dir":"Reference","previous_headings":"","what":"Interpolate points using a moving window — interpIDW","title":"Interpolate points using a moving window — interpIDW","text":"Interpolate points within moving window using inverse distance weighting. maximum number points used can restricted, optionally selecting nearest points.","code":""},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Interpolate points using a moving window — interpIDW","text":"","code":"# S4 method for SpatRaster,SpatVector interpIDW(x, y, field, radius, power=2, smooth=0,        maxPoints=Inf, minPoints=1, near=TRUE, fill=NA, filename=\"\", ...)  # S4 method for SpatRaster,matrix interpIDW(x, y, radius, power=2, smooth=0,         maxPoints=Inf, minPoints=1, near=TRUE, fill=NA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Interpolate points using a moving window — interpIDW","text":"x SpatRaster y SpatVector matrix three columns (x,y,z) field character. field name SpatVector y radius numeric. radius circle (single number). near=FALSE, also possible use two three numbers. Two numbers interpreted radii ellipse (x y-axis). third number indicated desired, counter clockwise, rotation ellipse (degrees) power numeric. Weighting power smooth numeric. Smoothing parameter minPoints numeric. minimum number points use. fewer points found search ellipse considered empty fill value returned maxPoints numeric. maximum number points consider search area. Additional points ignored. fewer points found, fill value returned near logical. nearest points within neighborhood used maxPoints reached? fill numeric. value use fill empty cells filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Interpolate points using a moving window — interpIDW","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Interpolate points using a moving window — interpIDW","text":"","code":"r <- rast(ncol=100, nrow=100, crs=\"local\", xmin=0, xmax=50, ymin=0, ymax=50) set.seed(100) x <- runif(25, 5, 45) y <- runif(25, 5, 45) z <- sample(25) xyz <- cbind(x,y,z)  x <- interpIDW(r, xyz, radius=5, power=1, smooth=1, maxPoints=5)"},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":null,"dir":"Reference","previous_headings":"","what":"Nearest neighbor interpolation — interpNear","title":"Nearest neighbor interpolation — interpNear","text":"Nearest neighbor interpolation points, using moving window","code":""},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Nearest neighbor interpolation — interpNear","text":"","code":"# S4 method for SpatRaster,SpatVector interpNear(x, y, field, radius, interpolate=FALSE, fill=NA, filename=\"\", ...)  # S4 method for SpatRaster,matrix interpNear(x, y, radius, interpolate=FALSE, fill=NA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Nearest neighbor interpolation — interpNear","text":"x SpatRaster y SpatVector matrix three columns (x,y,z) field character. field name SpatVector y radius numeric. radius circle (single number). interpolate=FALSE also possible use two three numbers. Two numbers interpreted radii ellipse (x y-axis). third number indicated desired, counter clockwise, rotation ellipse (degrees) interpolate logical. nearest neighbor values linearly interpolated points? fill numeric. value use fill empty cells filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Nearest neighbor interpolation — interpNear","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Nearest neighbor interpolation — interpNear","text":"","code":"r <- rast(ncol=100, nrow=100, crs=\"local\", xmin=0, xmax=50, ymin=0, ymax=50) set.seed(100) x <- runif(25, 5, 45) y <- runif(25, 5, 45) z <- sample(25) xyz <- cbind(x,y,z)  x <- interpNear(r, xyz, radius=5)  p <- vect(data.frame(xyz), geom=c(\"x\", \"y\"))  v <- voronoi(p)  plot(x, col=rainbow(25)) lines(v)   # plot(v, col=rainbow(25)); points(p)"},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial interpolation — interpolation","title":"Spatial interpolation — interpolation","text":"Make SpatRaster interpolated values using fitted model object classes \"gstat\" (gstat package) \"Krige\" (fields package), model location (e.g., \"x\" \"y\", \"longitude\" \"latitude\") predictors (independent variables). x y predictors, efficient provide empty (associated data memory file) SpatRaster want predictions. spatial predictor variables, provide SpatRaster first argument function. x y locations implicit predictors model use predict instead.","code":""},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial interpolation — interpolation","text":"","code":"# S4 method for SpatRaster interpolate(object, model, fun=predict, ..., xyNames=c(\"x\", \"y\"),         factors=NULL, const=NULL, index = NULL, cores=1, cpkgs=NULL,       na.rm=FALSE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial interpolation — interpolation","text":"object SpatRaster model model object fun function. Default value \"predict\", can replaced e.g. \"predict.se\" (depending class model), custom function (see examples) ... additional arguments passed fun xyNames character. variable names model uses spatial coordinates. E.g., c(\"longitude\", \"latitude\") factors list levels factor variables. list elements named names correspond names object can matched. argument may omitted models levels can extracted model object const data.frame. Can used add constant SpatRaster model predictions. particularly useful constant character-like factor value index positive integer NULL. Allows selecting variable returned model returns multiple variables cores positive integer. cores > 1, 'parallel' package cluster many cores created used cpkgs character. package(s) need loaded nodes able run model.predict function (see examples predict) na.rm logical. TRUE, cells NA values predictors removed computation. option prevents errors models handle NA values. cases affect output. exception predicting model returns predicted values even (!) variables NA filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial interpolation — interpolation","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial interpolation — interpolation","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) ra <- aggregate(r, 10) xy <- data.frame(xyFromCell(ra, 1:ncell(ra))) v <- values(ra) i <- !is.na(v) xy <- xy[i,] v <- v[i]  if (FALSE) { library(fields)  tps <- Tps(xy, v) p <- rast(r)  # use model to predict values at all locations p <- interpolate(p, tps) p <- mask(p, r) plot(p)  ### change \"fun\" from predict to fields::predictSE to get the TPS standard error ## need to use \"rast(p)\" to remove the values se <- interpolate(rast(p), tps, fun=predictSE) se <- mask(se, r) plot(se)  ### another predictor variable, \"e\" e <- (init(r, \"x\") * init(r, \"y\")) / 100000000 names(e) <- \"e\"  z <- as.matrix(extract(e, xy)[,-1])  ## add as another independent variable xyz <- cbind(xy, z) tps2 <- Tps(xyz, v) p2 <- interpolate(e, tps2, xyOnly=FALSE)  ## as a linear covariate tps3 <- Tps(xy, v, Z=z)  ## Z is a separate argument in Krig.predict, so we need a new function ## Internally (in interpolate) a matrix is formed of x, y, and elev (Z)  pfun <- function(model, x, ...) {    predict(model, x[,1:2], Z=x[,3], ...) } p3 <- interpolate(e, tps3, fun=pfun)   #### gstat examples library(gstat) library(sp) data(meuse)  ### inverse distance weighted (IDW) r <- rast(system.file(\"ex/meuse.tif\", package=\"terra\")) mg <- gstat(id = \"zinc\", formula = zinc~1, locations = ~x+y, data=meuse,              nmax=7, set=list(idp = .5)) z <- interpolate(r, mg, debug.level=0, index=1) z <- mask(z, r)  ## with a model built with an `sf` object you need to provide custom function  library(sf) sfmeuse <- st_as_sf(meuse, coords = c(\"x\", \"y\"), crs=crs(r)) mgsf <- gstat(id = \"zinc\", formula = zinc~1, data=sfmeuse,  nmax=7, set=list(idp = .5))  interpolate_gstat <- function(model, x, crs, ...) {   v <- st_as_sf(x, coords=c(\"x\", \"y\"), crs=crs)   p <- predict(model, v, ...)   as.data.frame(p)[,1:2] }  zsf <- interpolate(r, mgsf, debug.level=0, fun=interpolate_gstat, crs=crs(r), index=1) zsf <- mask(zsf, r)  ### kriging  ### ordinary kriging v <- variogram(log(zinc)~1, ~x+y, data=meuse) mv <- fit.variogram(v, vgm(1, \"Sph\", 300, 1)) gOK <- gstat(NULL, \"log.zinc\", log(zinc)~1, meuse, locations=~x+y, model=mv) OK <- interpolate(r, gOK, debug.level=0)  ## universal kriging vu <- variogram(log(zinc)~elev, ~x+y, data=meuse) mu <- fit.variogram(vu, vgm(1, \"Sph\", 300, 1)) gUK <- gstat(NULL, \"log.zinc\", log(zinc)~elev, meuse, locations=~x+y, model=mu) names(r) <- \"elev\" UK <- interpolate(r, gUK, debug.level=0)  ## co-kriging gCoK <- gstat(NULL, 'log.zinc', log(zinc)~1, meuse, locations=~x+y) gCoK <- gstat(gCoK, 'elev', elev~1, meuse, locations=~x+y) gCoK <- gstat(gCoK, 'cadmium', cadmium~1, meuse, locations=~x+y) gCoK <- gstat(gCoK, 'copper', copper~1, meuse, locations=~x+y) coV <- variogram(gCoK) plot(coV, type='b', main='Co-variogram') coV.fit <- fit.lmc(coV, gCoK, vgm(model='Sph', range=1000)) coV.fit plot(coV, coV.fit, main='Fitted Co-variogram') coK <- interpolate(r, coV.fit, debug.level=0) plot(coK) }"},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":null,"dir":"Reference","previous_headings":"","what":"Intersection — intersect","title":"Intersection — intersect","text":"can intersect SpatVectors SpatExtent. Intersecting points points uses extent y get intersection. Intersecting points lines supported numerical inaccuracies . can use buffer, create polygons lines use intersect. can also intersect two SpatExtents. intersecting two SpatRasters need aligned (origin spatial resolution). values returned SpatRaster TRUE input rasters values, FALSE one values, NA cells. intersecting SpatExtent SpatRaster, SpatExtent first aligned raster cell boundaries. See crop intersection SpatRaster SpatExtent (extent SpatRaster SpatVector) want SpatRaster (SpatExtent) output. See .related(x, y, \"intersects\") find geometries SpatVector intersect. can spatially subset SpatVector another one x[y].","code":""},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Intersection — intersect","text":"","code":"# S4 method for SpatVector,SpatVector intersect(x, y)  # S4 method for SpatVector,SpatExtent intersect(x, y)  # S4 method for SpatExtent,SpatVector intersect(x, y)  # S4 method for SpatExtent,SpatExtent intersect(x, y)  # S4 method for SpatRaster,SpatRaster intersect(x, y)  # S4 method for SpatRaster,SpatExtent intersect(x, y)  # S4 method for SpatExtent,SpatRaster intersect(x, y)"},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Intersection — intersect","text":"x SpatVector, SpatExtent, SpatRaster y SpatVector, SpatExtent, SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Intersection — intersect","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Intersection — intersect","text":"","code":"e1 <- ext(-10, 10, -20, 20) e2 <- ext(0, 20, -40, 5) intersect(e1, e2) #> SpatExtent : 0, 10, -20, 5 (xmin, xmax, ymin, ymax)  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) e <- ext(5.6, 6, 49.55, 49.7) x <- intersect(v, e)  p <- vect(c(\"POLYGON ((5.8 49.8, 6 49.9, 6.15 49.8, 6 49.6, 5.8 49.8))\",  \"POLYGON ((6.3 49.9, 6.2 49.7, 6.3 49.6, 6.5 49.8, 6.3 49.9))\"), crs=crs(v)) values(p) <- data.frame(pid=1:2, area=expanse(p))  y <- intersect(v, p)  r <- s <- rast(ncol=5, nrow=5, xmin=1, xmax=5, ymin=1, ymax=5) r[5:20] <- 5:20 s[11:20] <- 11:20 rs <- intersect(r, s)  u <- shift(r, .8) us <- intersect(u, s)"},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":null,"dir":"Reference","previous_headings":"","what":"Raster value types — is.bool","title":"Raster value types — is.bool","text":"values SpatRaster layer default numeric, can also set logical (Boolean), integer, categorical (factor). SpatRaster, .logical isTRUE equivalent .bool. isFALSE equivalent !.bool, .integer .int. .bool .int force values correct range (e.g. whole integers) -memory cell values still stored numeric. behave like assigned types, though, written files data type (file type supports ). See levels cats create categorical layers setting labels.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Raster value types — is.bool","text":"","code":"# S4 method for SpatRaster is.bool(x)  # S4 method for SpatRaster as.bool(x, filename, ...)  # S4 method for SpatRaster is.int(x)  # S4 method for SpatRaster as.int(x, filename, ...)  # S4 method for SpatRaster is.factor(x)  # S4 method for SpatRaster as.factor(x)"},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Raster value types — is.bool","text":"x SpatRaster filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Raster value types — is.bool","text":".* methods return new SpatRaster, whereas .* methods return logical value layer x.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Raster value types — is.bool","text":"","code":"r <- rast(nrows=10, ncols=10, vals=1:100) is.bool(r) #> [1] FALSE z <- as.bool(r) is.bool(z) #> [1] TRUE  x <- r > 25 is.bool(x) #> [1] TRUE  rr <- r/2 is.int(rr) #> [1] FALSE is.int(round(rr)) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if a SpatExtent or SpatVector is empty — is.empty","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"empty SpatExtent area empty SpatVector geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"","code":"# S4 method for SpatExtent is.empty(x)  # S4 method for SpatVector is.empty(x)"},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"x SpatVector SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"logical","code":""},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"","code":"e <- ext(0,0,0,0) is.valid(e) #> [1] TRUE is.empty(e) #> [1] TRUE  v <- vect() is.valid(v) #> logical(0) is.empty(v) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":null,"dir":"Reference","previous_headings":"","what":"Check for longitude/latitude crs — is.lonlat","title":"Check for longitude/latitude crs — is.lonlat","text":"Test whether SpatRaster SpatVector longitude/latitude coordinate reference system (CRS), perhaps one. , CRS unknown (\"\") x coordinates within -181 181 y coordinates within -90.1 90.1. SpatRaster can also test longitude/latitude CRS \"global\" (covers longitudes). warning given CRS missing specified longitude/latitude coordinates match .","code":""},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check for longitude/latitude crs — is.lonlat","text":"","code":"# S4 method for SpatRaster is.lonlat(x, perhaps=FALSE, warn=TRUE, global=FALSE)  # S4 method for SpatVector is.lonlat(x, perhaps=FALSE, warn=TRUE)  # S4 method for character is.lonlat(x, perhaps=FALSE, warn=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check for longitude/latitude crs — is.lonlat","text":"x SpatRaster SpatVector perhaps logical. TRUE CRS unknown, method returns TRUE coordinates plausible longitude/latitude warn logical. TRUE, warning given CRS unknown assumed lon/lat  perhaps=TRUE global logical. TRUE, method tests raster covers longitudes (-180 180 degrees) extreme columns fact adjacent","code":""},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check for longitude/latitude crs — is.lonlat","text":"logical NA","code":""},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check for longitude/latitude crs — is.lonlat","text":"","code":"r <- rast() is.lonlat(r) #> [1] TRUE is.lonlat(r, global=TRUE) #> [1] TRUE  crs(r) <- \"\" is.lonlat(r) #> Warning: [is.lonlat] unknown crs #> [1] NA is.lonlat(r, perhaps=TRUE, warn=FALSE) #> [1] TRUE  crs(r) <- \"+proj=lcc +lat_1=48 +lat_2=33 +lon_0=-100 +ellps=WGS84\" is.lonlat(r) #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":null,"dir":"Reference","previous_headings":"","what":"Check for rotation — is.rotated","title":"Check for rotation — is.rotated","text":"Check SpatRaster \"rotated\" needs rectified can used See rectify","code":""},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check for rotation — is.rotated","text":"","code":"# S4 method for SpatRaster is.rotated(x)"},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check for rotation — is.rotated","text":"x SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check for rotation — is.rotated","text":"logical. One value raster data *source*","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check for rotation — is.rotated","text":"","code":"r <- rast(nrows=10, ncols=10, vals=1:100) is.rotated(r) #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":null,"dir":"Reference","previous_headings":"","what":"Check or fix polygon or extent validity — is.valid","title":"Check or fix polygon or extent validity — is.valid","text":"Check validity polygons attempt fix . check validity SpatExtent.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check or fix polygon or extent validity — is.valid","text":"","code":"# S4 method for SpatVector is.valid(x, messages=FALSE, as.points=FALSE)  # S4 method for SpatVector makeValid(x)  # S4 method for SpatExtent is.valid(x)"},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check or fix polygon or extent validity — is.valid","text":"x SpatVector SpatExtent messages logical. TRUE error messages returned .points logical. TRUE, attempted return locations polygons invalid SpatVector points","code":""},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check or fix polygon or extent validity — is.valid","text":"logical","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check or fix polygon or extent validity — is.valid","text":"","code":"w <- vect(\"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\") is.valid(w) #> [1] TRUE  w <- vect(\"POLYGON ((0 -5, 10 0, 10 -10, 4 -2, 0 -5))\") is.valid(w) #> [1] FALSE is.valid(w, TRUE) #>   valid                                                reason #> 1 FALSE Self-intersection[4.54545454545454 -2.72727272727273]  plot(w) points(cbind(4.54, -2.72), cex=2, col=\"red\")    e <- ext(0, 1, 0, 1) is.valid(e) #> [1] TRUE  ee <- ext(0, 0, 0, 0) is.valid(ee) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":null,"dir":"Reference","previous_headings":"","what":"k_means — k_means","title":"k_means — k_means","text":"Compute k-means clusters SpatRaster. large SpatRasters (ncell(x) > maxcell) done two steps. First sample cells used compute cluster centers. cell assigned cluster computing distance centers.","code":""},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"k_means — k_means","text":"","code":"# S4 method for SpatRaster k_means(x, centers=3, ..., maxcell=1000000, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"k_means — k_means","text":"x SpatRaster centers either number clusters, set initial (distinct) cluster centres. number, random set (distinct) cells x chosen initial centres ... additional arguments passed kmeans maxcell positive integer. size regular sample used smaller ncell(x) filename character. Output filename (ignored .raster=FALSE) overwrite logical. TRUE, filename overwritten wopt list additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"k_means — k_means","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"k_means — k_means","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f) km <- k_means(r, centers=5) km #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> name        : lyr1  #> min value   :    1  #> max value   :    5"},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"Apply function SpatRaster, using layers arguments. number arguments function fun must match number layers SpatRaster (number sub-datasets SpatRasterDataset). example, want multiply two layers, use function: fun=function(x,y){return(x*y)} percentage: fun=function(x,y){return(100 * x / y)}. combine three layers use fun=function(x,y,z){return((x + y) * z)} use function, test make sure vectorized. , work vectors longer one, single numbers. input SpatRaster(s) multiple layers, work matrix (multiple cells) input data (matrices case SpatRasterDataSet). function must return number elements input vectors, multiples . Also make sure function NA-proof: returns number values input values NA. function must return vector matrix, data.frame. test , run .call(fun, data) (see examples). Use app summarize functions sum, take number arguments; tapp groups layers.","code":""},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"","code":"# S4 method for SpatRaster lapp(x, fun, ..., usenames=FALSE, cores=1, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterDataset lapp(x, fun, ..., usenames=FALSE, recycle=FALSE,      filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"x SpatRaster SpatRasterDataset fun function takes vector can applied cell x ... additional arguments passed fun usenames logical. Use layer names (dataset names x SpatRasterDataset) match function arguments? FALSE, argument matching position cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object recycle logical. Recycle layers match subdataset largest number layers filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"Use sapp lapply apply function takes SpatRaster argument layer SpatRaster (rarely necessary).","code":""},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) + 1   ss <- s[[2:1]]  fvi <- function(x, y){ (x - y ) / (x + y) }  # test the function data <- list(c(1:5,NA), 6:1) do.call(fvi, data) #> [1] -0.7142857 -0.4285714 -0.1428571  0.1428571  0.4285714         NA  x <- lapp(ss, fun=fvi )  # which is the same as supplying the layers to \"fun\" # in some cases this will be much faster  y <- fvi(s[[2]], s[[1]])  f2 <- function(x, y, z){ (z - y + 1) / (x + y + 1) }  p1 <- lapp(s, fun=f2 )  p2 <- lapp(s[[1:2]], f2, z=200)  # the usenames argument  fvi2 <- function(red, green){ (red - green ) / (red + green) }  names(s) #> [1] \"red\"   \"green\" \"blue\"  x1 <- lapp(s[[1:2]], fvi2, usenames=TRUE) x2 <- lapp(s[[2:1]], fvi2, usenames=TRUE) # x1 and x2 are the same, despite the change in the order of the layers # x4 is also the same, but x3 is not x3 <- lapp(s[[2:1]], fvi2, usenames=FALSE) x4 <- lapp(s, fvi2, usenames=TRUE)  # while this would fail because  # there are too many layers in s # x5 <- lapp(s, fvi2, usenames=FALSE)  pairs(c(x1, x2, x3, x4))   ## SpatRasterDataset x <- sds(s, s[[1]]+50) fun <- function(x, y) { x/y }  # test \"fun\" data <- list(matrix(1:9, ncol=3), matrix(9:1, ncol=3)) do.call(fun, data) #>           [,1]      [,2]     [,3] #> [1,] 0.1111111 0.6666667 2.333333 #> [2,] 0.2500000 1.0000000 4.000000 #> [3,] 0.4285714 1.5000000 9.000000  lapp(x, fun, recycle=TRUE) #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> names       :      lyr.1,      lyr.2,      lyr.3  #> min values  : 0.01960784, 0.01851852, 0.01694915  #> max values  : 0.83660131, 0.88571429, 1.12359551   # the same, more concisely z <- s / (s[[1]]+50)"},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":null,"dir":"Reference","previous_headings":"","what":"Correlation and (weighted) covariance — layerCor","title":"Correlation and (weighted) covariance — layerCor","text":"Compute correlation, (weighted) covariance, similar summary statistics compare values pairs layers SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Correlation and (weighted) covariance — layerCor","text":"","code":"# S4 method for SpatRaster layerCor(x, fun, w, asSample=TRUE, use=\"everything\", maxcell=Inf, ...)"},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Correlation and (weighted) covariance — layerCor","text":"x SpatRaster fun character. statistic compute: either \"cov\" (covariance), \"weighted.cov\" (weighted covariance), \"cor\" (pearson correlation coefficient) function takes two vectors argument compute single number w SpatRaster weights  compute weighted covariance. single layer geometry x asSample logical. TRUE, statistic sample (denominator n-1) computed, rather population (denominator n). standard functions use character. decide handle missing values. must (abbreviation ) one \"everything\", \"complete.obs\", \"pairwise.complete.obs\", \"masked.complete\". \"pairwise.complete.obs\", value pair layers computed cells NA pair. Therefore, may (number ) cells used varies pairs. benefit approach available data used. Use \"complete.obs\", want use values cells NA layers. using \"masked.complete\" indicate layers NA values cells maxcell positive integer. maximum number cells used. smaller ncell(x), regular sample x used ... additional arguments fun (proper function)","code":""},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Correlation and (weighted) covariance — layerCor","text":"fun one three standard statistics, get list three items:  correlation (weighted) covariance matrix, (weighted) means, number data cells  comparison. means also matrix may depend combination layers  different cells missing values excluded computation. rows  mean matrix represent layer whose (weighted) mean calculated columns  represent layer paired . cells non-missing observations  layers used calculation (weighted) mean. diagonals mean n  matrices set missing. fun function, get single matrix.","code":""},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Correlation and (weighted) covariance — layerCor","text":"weighted covariance: Canty, M.J. .. Nielsen, 2008. Automatic radiometric normalization multitemporal satellite imagery iteratively re-weighted MAD transformation. Remote Sensing Environment 112:1025-1036. Nielsen, .., 2007. regularized iteratively reweighted MAD method change detection multi- hyperspectral data. IEEE Transactions Image Processing 16(2):463-478.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Correlation and (weighted) covariance — layerCor","text":"","code":"b <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    layerCor(b, \"pearson\") #> $correlation #>             red     green      blue #> red   1.0000000 0.9980961 0.9501633 #> green 0.9980961 1.0000000 0.9658011 #> blue  0.9501633 0.9658011 1.0000000 #>  #> $mean #>            red    green     blue #> red        NaN 182.2855 182.2855 #> green 185.3509      NaN 185.3509 #> blue  192.8046 192.8046      NaN #>  #> $n #>        red green blue #> red    NaN  7777 7777 #> green 7777   NaN 7777 #> blue  7777  7777  NaN #>   layerCor(b, \"cov\") #> $covariance #>            red    green     blue #> red   5564.371 5443.405 4993.165 #> green 5443.405 5345.403 4974.478 #> blue  4993.165 4974.478 4962.942 #>  #> $mean #>            red    green     blue #> red   182.2855 182.2855 182.2855 #> green 185.3509 185.3509 185.3509 #> blue  192.8046 192.8046 192.8046 #>  #> $n #>      [,1] [,2] [,3] #> [1,] 7777 7777 7777 #> [2,] 7777 7777 7777 #> [3,] 7777 7777 7777 #>   # weigh by column number w <- init(b, fun=\"col\") layerCor(b, \"weighted.cov\", w=w) #> $weighted_covariance #>            red    green     blue #> red   5670.750 5536.351 5009.851 #> green 5536.351 5427.161 4987.092 #> blue  5009.851 4987.092 4937.007 #>  #> $weighted_mean #>            red    green     blue #> red   177.5983 177.5983 177.5983 #> green 181.3521 181.3521 181.3521 #> blue  191.5236 191.5236 191.5236 #>"},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":null,"dir":"Reference","previous_headings":"","what":"add a custom legend — add_legend","title":"add a custom legend — add_legend","text":"Wrapper around legend allows adding custom legend map using keyword \"topleft\" \"bottomright\". function place legend locations within mapped area delineated axes.","code":""},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"add a custom legend — add_legend","text":"","code":"add_legend(x, y, ...)"},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"add a custom legend — add_legend","text":"x keyword used position legend (x coordinate) y y coordinate used position legend (x also coordinate) ... arguments passed legend","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"add a custom legend — add_legend","text":"","code":"v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) plot(v) points(centroids(v), col=\"red\") legend(\"topleft\", legend = \"centroids\", pch = 20, xpd=NA, bg=\"white\", col=\"red\") add_legend(\"topright\", legend = \"centroids\", pch = 20, col=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":null,"dir":"Reference","previous_headings":"","what":"Linear units of the coordinate reference system — linearUnits","title":"Linear units of the coordinate reference system — linearUnits","text":"Get linear units coordinate reference system (crs) SpatRaster SpatVector expressed m. value returned used internally transform area perimeter measures meters. value returned longitude/latitude crs zero.","code":""},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Linear units of the coordinate reference system — linearUnits","text":"","code":"# S4 method for SpatRaster linearUnits(x)  # S4 method for SpatVector linearUnits(x)"},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Linear units of the coordinate reference system — linearUnits","text":"x SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Linear units of the coordinate reference system — linearUnits","text":"numeric (meter)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Linear units of the coordinate reference system — linearUnits","text":"","code":"x <- rast() crs(x) <- \"\" linearUnits(x) #> [1] NaN  crs(x) <- \"+proj=longlat +datum=WGS84\" linearUnits(x) #> [1] 0  crs(x) <- \"+proj=utm +zone=1 +units=cm\" linearUnits(x) #> [1] 0.01  crs(x) <- \"+proj=utm +zone=1 +units=km\" linearUnits(x) #> [1] 1000  crs(x) <- \"+proj=utm +zone=1 +units=us-ft\" linearUnits(x) #> [1] 0.3048006"},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":null,"dir":"Reference","previous_headings":"","what":"Add points, lines, or polygons to a map — lines","title":"Add points, lines, or polygons to a map — lines","text":"Add vector geometries plot (map) points, lines, polys. simpler alternatives plot(x, add=TRUE) methods also work small(!) SpatRaster. cells NA first layer used.","code":""},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add points, lines, or polygons to a map — lines","text":"","code":"# S4 method for SpatVector points(x, col, cex=0.7, pch=16, alpha=1, ...)  # S4 method for SpatVector lines(x, y=NULL, col, lwd=1, lty=1, arrows=FALSE, alpha=1, ...)  # S4 method for SpatVector polys(x, col, border=\"black\", lwd=1, lty=1, alpha=1, ...)  # S4 method for SpatRaster points(x, ...)  # S4 method for SpatRaster lines(x, mx=10000, ...)  # S4 method for SpatRaster polys(x, mx=10000, dissolve=TRUE, ...)  # S4 method for SpatExtent points(x, col=\"black\", alpha=1, ...)  # S4 method for SpatExtent lines(x, col=\"black\", alpha=1, ...)  # S4 method for SpatExtent polys(x, col, alpha=1, ...)"},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add points, lines, or polygons to a map — lines","text":"x SpatVector SpatExtent y missing SpatVector. x y point geometry number rows, lines drawn pairs points col character. Colors border character. color(s) polygon borders. Use NULL NA draw border cex numeric. point size magnifier. See par pch positive integer, point type. See points. (linux) devices, default symbol \"16\" smooth circle. can use \"20\" instead (takes bit longer draw) \"1\" open circle alpha number 0 1 set transparency lwd numeric, line-width. See par lty positive integer, line type. See par arrows logical. TRUE y SpatVector, arrows drawn intead lines. See ?arrows additional arguments mx positive number. number cells SpatRaster x higher, method fail error message dissolve logical. boundaries cells value removed? ... additional graphical arguments lwd, cex pch","code":""},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add points, lines, or polygons to a map — lines","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  r <- rast(v) values(r) <- 1:ncell(r) plot(r) lines(v) points(v)"},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":null,"dir":"Reference","previous_headings":"","what":"Make tiles or get their extents — makeTiles","title":"Make tiles or get their extents — makeTiles","text":"Divide SpatRaster \"tiles\". cells another SpatRaster (normally much lower resolution) SpatVector polygon geometry can used define tiles. can also provide one two numbers indicate number rows columns per tile. getTileExtents returns extents (virtual) tiles, makeTiles creates files tiles returns filenames.","code":""},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make tiles or get their extents — makeTiles","text":"","code":"# S4 method for SpatRaster makeTiles(x, y, filename=\"tile_.tif\", extend=FALSE,     na.rm=FALSE, buffer=0, overwrite=FALSE, ...)  # S4 method for SpatRaster getTileExtents(x, y, extend=FALSE, buffer=0)"},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make tiles or get their extents — makeTiles","text":"x SpatRaster y SpatRaster SpatVector defining zones; numeric specifying number rows columns zone (1 2 numbers number rows columns ) filename character. Output filename template. Filenames altered adding tile number tile extend logical. TRUE, extent y expanded assure covers x na.rm logical. TRUE, tiles missing values ignored buffer integer. number additional rows columns added tile. Can single number, two numbers specify separate number rows columns. allows creating overlapping tiles can used computing spatial context dependent values e.g. focal. expansion inside x, rows columns outside x added overwrite logical. TRUE, existing tiles overwritten; otherwise skipped (without error warning) ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make tiles or get their extents — makeTiles","text":"character (filenames) matrix (extents)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make tiles or get their extents — makeTiles","text":"","code":"r <- rast(ncols=100, nrows=100) values(r) <- 1:ncell(r) x <- rast(ncols=2, nrows=2)  getTileExtents(r, x) #>               xmin         xmax          ymin         ymax #> [1,] -1.800000e+02 4.440892e-15 -2.220446e-15 9.000000e+01 #> [2,]  4.440892e-15 1.800000e+02 -2.220446e-15 9.000000e+01 #> [3,] -1.800000e+02 4.440892e-15 -9.000000e+01 2.220446e-15 #> [4,]  4.440892e-15 1.800000e+02 -9.000000e+01 2.220446e-15 getTileExtents(r, x, buffer=3) #>        xmin  xmax  ymin ymax #> [1,] -180.0  10.8  -5.4 90.0 #> [2,]  -10.8 180.0  -5.4 90.0 #> [3,] -180.0  10.8 -90.0  5.4 #> [4,]  -10.8 180.0 -90.0  5.4   filename <- paste0(tempfile(), \"_.tif\") ff <- makeTiles(r, x, filename) ff #> [1] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_1.tif\" #> [2] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_2.tif\" #> [3] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_3.tif\" #> [4] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file35111970dbdc_4.tif\"  vrt(ff) #> class       : SpatRaster  #> dimensions  : 100, 100, 1  (nrow, ncol, nlyr) #> resolution  : 3.6, 1.8  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : spat_3511124f81fe_13585.vrt  #> name        : spat_3511124f81fe_13585  #> min value   :                       1  #> max value   :                   10000"},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":null,"dir":"Reference","previous_headings":"","what":"Make a VRT header file — makeVRT","title":"Make a VRT header file — makeVRT","text":"Create VRT header file \"flat binary\" raster file needs header file able read , .","code":""},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make a VRT header file — makeVRT","text":"","code":"makeVRT(filename, nrow, ncol, nlyr=1, extent, xmin, ymin, xres, yres=xres, xycenter=TRUE,    crs=\"+proj=longlat\", lyrnms=\"\", datatype, NAflag=NA, bandorder=\"BIL\", byteorder=\"LSB\",    toptobottom=TRUE, offset=0, scale=1)"},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make a VRT header file — makeVRT","text":"filename character. raster filename (without \".vrt\" extension) nrow positive integer, number rows ncol positive integer, number columns nlyr positive integer, number layers extent SpatExtent missing xmin numeric. minimum x coordinate (used extent missing) ymin numeric. minimum y coordinate (used extent missing) xres positive number. x resolution yres positive number. y resolution) xycenter logical. TRUE, xmin xmax represent coordinates center extreme cell, stead coordinates outside corner. used extent missing crs character. Coordinate reference system description lyrnms character. Layer names datatype character. One \"INT2S\", \"INT4S\", \"INT1U\", \"INT2U\", \"INT4U\", \"FLT4S\", \"FLT8S\". missing, guessed file size (INT1U 1 byte per value, INT2S 2 bytes FLT4S 4 bytes per value). may wrong , example, 2 bytes per value may fact INT2U (U unsigned) values NAflag numeric. value used \"NA flag\" bandorder character. One \"BIL\", \"BIP\", \"BSQ\". Band Interleaved Line, Pixel, Band SeQuential byteorder character. One \"LSB\", \"MSB\". \"MSB\" common files generated Linux systems, whereas \"LSB\" common files generated windows toptobottom logical. FALSE, values read bottom top offset numeric. offset applied scale numeric. scale applied","code":""},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make a VRT header file — makeVRT","text":"character (.VRT filename)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":null,"dir":"Reference","previous_headings":"","what":"map.pal arrow — map.pal","title":"map.pal arrow — map.pal","text":"Get color palette mapping. palettes copied GRASS.","code":""},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"map.pal arrow — map.pal","text":"","code":"map.pal(name, n=50, ...)"},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"map.pal arrow — map.pal","text":"name character (name palette, see Details), missing (get available names) n numeric. number colors ... additional arguments passed colorRamp","code":""},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"map.pal arrow — map.pal","text":"none","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"map.pal arrow — map.pal","text":"","code":"map.pal(\"elevation\", 10) #>  [1] \"#00BFBF\" \"#00E254\" \"#1CFF00\" \"#A9FF00\" \"#FFE200\" \"#FF9B00\" \"#E97F14\" #>  [8] \"#C67F37\" \"#C39F7B\" \"#C8C8C8\"  r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) plot(r, col=map.pal(\"elevation\"))   map.pal() #>  [1] \"aspect\"      \"bcyr\"        \"bgyr\"        \"blues\"       \"byg\"         #>  [6] \"byr\"         \"curvature\"   \"differences\" \"elevation\"   \"grass\"       #> [11] \"greens\"      \"grey\"        \"gyr\"         \"haxby\"       \"inferno\"     #> [16] \"magma\"       \"oranges\"     \"plasma\"      \"rainbow\"     \"ramp\"        #> [21] \"reds\"        \"roygbiv\"     \"rstcurv\"     \"ryb\"         \"ryg\"         #> [26] \"sepia\"       \"viridis\"     \"water\"       \"wave\""},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Mask values in a SpatRaster or SpatVector — mask","title":"Mask values in a SpatRaster or SpatVector — mask","text":"x SpatRaster:  Create new SpatRaster values SpatRaster x, except cells NA (maskvalue) another SpatRaster ('mask'), cells covered SpatVector SpatExtent. cells become NA (another updatevalue). x SpatVector SpatExtent:  Select geometries x intersect, intersect, geometries y.","code":""},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mask values in a SpatRaster or SpatVector — mask","text":"","code":"# S4 method for SpatRaster,SpatRaster mask(x, mask, inverse=FALSE, maskvalues=NA,     updatevalue=NA, filename=\"\", ...)     # S4 method for SpatRaster,SpatVector mask(x, mask, inverse=FALSE, updatevalue=NA,   touches=TRUE, filename=\"\", ...)  # S4 method for SpatRaster,SpatExtent mask(x, mask, inverse=FALSE, updatevalue=NA,   touches=TRUE, filename=\"\", ...)  # S4 method for SpatVector,SpatVector mask(x, mask, inverse=FALSE)  # S4 method for SpatVector,SpatExtent mask(x, mask, inverse=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mask values in a SpatRaster or SpatVector — mask","text":"x SpatRaster SpatVector mask SpatRaster SpatVector inverse logical. TRUE, areas mask _not_ maskvalue masked maskvalues numeric. value(s) mask indicate cells x masked (change value updatevalue (default = NA)) updatevalue numeric. value masked cells become (NA) touches logical. TRUE, cells touched lines polygons masked, just line render path, whose center point within polygon filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Mask values in a SpatRaster or SpatVector — mask","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Mask values in a SpatRaster or SpatVector — mask","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) msk <- ifel(r < 400, NA, 1)  m <- mask(r, msk)  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)[1,]  mv1 <- mask(r, v) mv2 <- crop(r, v, mask=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/match.html","id":null,"dir":"Reference","previous_headings":"","what":"Value matching for SpatRasters — match","title":"Value matching for SpatRasters — match","text":"match returns SpatRaster position matched values. cell values index table argument. %% returns 0/1 (FALSE/TRUE) SpatRaster indicating cells values matched .","code":""},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Value matching for SpatRasters — match","text":"","code":"match(x, table, nomatch = NA_integer_, incomparables = NULL)  x %in% table"},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Value matching for SpatRasters — match","text":"x SpatRaster table vector values matched nomatch value returned case match found. Note coerced integer incomparables vector values matched. value x matching value vector assigned nomatch value. historical reasons, FALSE equivalent NULL","code":""},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Value matching for SpatRasters — match","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Value matching for SpatRasters — match","text":"","code":"r <- rast(nrows=10, ncols=10) values(r) <- 1:100 m <- match(r, c(5:10, 50:55)) n <- r %in% c(5:10, 50:55)"},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":null,"dir":"Reference","previous_headings":"","what":"General mathematical methods — Math-methods","title":"General mathematical methods — Math-methods","text":"Standard mathematical methods computations SpatRasters. Computations local (applied cell cell basis). multiple SpatRasters used, must extent resolution. implemented: abs, sign, sqrt, ceiling, floor, trunc,  cummax, cummin, cumprod, cumsum, log, log10, log2, log1p, acos, acosh, asin, asinh, atan, atanh, exp, expm1, cos, cosh, sin, sinh, tan, tanh, round, signif Instead directly calling methods, can also provide name math method. useful want provide output filename. following methods implemented SpatExtent: round, floor, ceiling round also implemented SpatVector, round coordinates geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"General mathematical methods — Math-methods","text":"","code":"# S4 method for SpatRaster sqrt(x)  # S4 method for SpatRaster log(x, base=exp(1))  # S4 method for SpatRaster round(x, digits=0)  # S4 method for SpatRaster math(x, fun, digits=0, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatVector round(x, digits=4)  # S4 method for SpatRaster cumsum(x)"},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"General mathematical methods — Math-methods","text":"x SpatRaster base positive complex number: base respect logarithms computed digits Number digits rounding fun character. Math function name filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"General mathematical methods — Math-methods","text":"SpatRaster SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"General mathematical methods — Math-methods","text":"","code":"r1 <- rast(ncols=10, nrows=10) v <- runif(ncell(r1)) v[10:20] <- NA values(r1) <- v r2 <- rast(r1) values(r2) <- 1:ncell(r2) / ncell(r2) r <- c(r1, r2)  s <- sqrt(r) # same as  math(r, \"sqrt\") #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :     lyr.1, lyr.1  #> min values  : 0.1074500,   0.1  #> max values  : 0.9975409,   1.0   round(s, 1) #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1  #> min values  :   0.1,   0.1  #> max values  :   1.0,   1.0   cumsum(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :     lyr.1,      lyr.1  #> min values  : 0.0115455, 0.07105275  #> max values  : 0.9950879, 1.90387150"},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":null,"dir":"Reference","previous_headings":"","what":"Memory available and needed — mem","title":"Memory available and needed — mem","text":"mem_info prints amount RAM required available process SpatRaster. free_RAM returns amount RAM available","code":""},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Memory available and needed — mem","text":"","code":"mem_info(x, n=1)  free_RAM()"},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Memory available and needed — mem","text":"x SpatRaster n positive integer. number copies x needed","code":""},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Memory available and needed — mem","text":"free_RAM returns amount available RAM kilobytes","code":""},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Memory available and needed — mem","text":"","code":"mem_info(rast()) #>  #> ------------------------ #> Memory (GB)  #> ------------------------ #> check threshold : 1 (memmin) #> available       : 3.36 #> allowed (60%)   : 2.02 #> needed (n=1)    : 0 #> ------------------------ #> proc in memory  : TRUE #> nr chunks       : 1 #> ------------------------  free_RAM() #> [1] 3522416"},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"Merge multiple SpatRasters create new SpatRaster larger spatial extent. SpatRasters must origin spatial resolution. areas SpatRasters overlap, values SpatRaster first sequence arguments (SpatRasterCollection) retained (unless first=FALSE). Cells NA ignored unless na.rm=FALSE also method merging SpatVector data.frame; , join data.frame attribute table SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"","code":"# S4 method for SpatRaster,SpatRaster merge(x, y, ..., first=TRUE, na.rm=TRUE, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterCollection,missing merge(x, first=TRUE, na.rm=TRUE, filename=\"\", ...)  # S4 method for SpatVector,data.frame merge(x, y, ...)"},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"x SpatRaster, SpatRasterCollection, SpatVector y missing x SpatRasterCollection. SpatRaster x SpatRaster. data.frame x SpatVector ... x SpatRaster: additional objects class x. x SpatRasterCollection: options writing files writeRaster. x SpatVector, arguments merge first logical. TRUE, areas rasters overlap, first value used. Otherwise last value used na.rm logical. TRUE values NA ignored filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"SpatRaster SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"","code":"x <- rast(xmin=-110, xmax=-80, ymin=40, ymax=70, res=1, vals=1) y <- rast(xmin=-85, xmax=-55, ymax=60, ymin=30, res=1, vals=2) z <- rast(xmin=-60, xmax=-30, ymax=50, ymin=20, res=1, vals=3)  m1 <- merge(x, y, z) m2 <- merge(z, y, x) m3 <- merge(y, x, z)  # if you have many SpatRasters, it may be convenient # to make a SpatRasterCollection rlist <- list(x, y, z) rsrc <- sprc(rlist)  m <- merge(rsrc)   ## SpatVector with data.frame f <- system.file(\"ex/lux.shp\", package=\"terra\") p <- vect(f) dfr <- data.frame(District=p$NAME_1, Canton=p$NAME_2, Value=round(runif(length(p), 100, 1000))) dfr <- dfr[1:5, ] pm <- merge(p, dfr, all.x=TRUE, by.x=c('NAME_1', 'NAME_2'), by.y=c('District', 'Canton')) pm #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 7  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2  ID_1  ID_2  AREA   POP Value #>  type        :    <chr>    <chr> <num> <num> <num> <int> <num> #>  values      : Diekirch Clervaux     1     1   312 18081   433 #>                Diekirch Diekirch     1     2   218 32543   961 #>                Diekirch  Redange     1     3   259 18664   922 values(pm) #>          NAME_1           NAME_2 ID_1 ID_2 AREA    POP Value #> 1      Diekirch         Clervaux    1    1  312  18081   433 #> 2      Diekirch         Diekirch    1    2  218  32543   961 #> 3      Diekirch          Redange    1    3  259  18664   922 #> 4      Diekirch          Vianden    1    4   76   5163   841 #> 5      Diekirch            Wiltz    1    5  263  16735   388 #> 6  Grevenmacher       Echternach    2    6  188  18899    NA #> 7  Grevenmacher           Remich    2    7  129  22366    NA #> 8  Grevenmacher     Grevenmacher    2   12  210  29828    NA #> 9    Luxembourg         Capellen    3    8  185  48187    NA #> 10   Luxembourg Esch-sur-Alzette    3    9  251 176820    NA #> 11   Luxembourg       Luxembourg    3   10  237 182607    NA #> 12   Luxembourg           Mersch    3   11  233  32112    NA"},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":null,"dir":"Reference","previous_headings":"","what":"merge SpatRasters by timelines to create a single timeseries — mergeTime","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"Combine SpatRasters partly overlapping time-stamps create single time series. overlap SpatRasters point using function (use c instead). Also note time gaps filled. can use fillTime .","code":""},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"","code":"# S4 method for SpatRasterDataset mergeTime(x, fun=mean, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"x SpatRasterDataset fun function reduces vector single number, mean min filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s1 <- c(r, r) time(s1) <- as.Date(\"2001-01-01\") + 0:5 s1 <- s1/10 time(s1) <- as.Date(\"2001-01-07\") + 0:5 s2 <- s1*10 time(s2) <- as.Date(\"2001-01-05\") + 0:5 x <- sds(s1, s1, s2)  m <- mergeTime(x, mean)"},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":null,"dir":"Reference","previous_headings":"","what":"meta — meta","title":"meta — meta","text":"Get metadata associated sources layers SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"meta — meta","text":"","code":"# S4 method for SpatRaster meta(x, layers=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"meta — meta","text":"x SpatRaster layers logical. layer level metadata returned?","code":""},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"meta — meta","text":"list","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":null,"dir":"Reference","previous_headings":"","what":"Set or get metadata — metags","title":"Set or get metadata — metags","text":"can set arbitrary metadata SpatRaster using \"name=value\" tags.","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set or get metadata — metags","text":"","code":"# S4 method for SpatRaster metags(x, layer=NULL)<-value  # S4 method for SpatRaster metags(x, layer=NULL, name=NULL)"},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set or get metadata — metags","text":"x SpatRaster layer NULL positive integer. value NULL, tags assigned returned SpatRaster. Otherwise layer number(s) name character value character \"name=value\" two-column matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set or get metadata — metags","text":"SpatRaster (metags<-), named character (metags)","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set or get metadata — metags","text":"","code":"r <- rast(ncol=5, nrow=5) m <- cbind(c(\"one\", \"two\", \"three\"), c(\"ABC\", \"123\", \"hello\")) metags(r) <- m metags(r) #>     one   three     two  #>   \"ABC\" \"hello\"   \"123\"   metags(r) <- c(\"another_tag=another_value\", \"one more=this value\") metags(r) #>     another_tag             one        one more           three             two  #> \"another_value\"           \"ABC\"    \"this value\"         \"hello\"           \"123\"   metags(r) <- c(another_tag=\"44\", `one more`=\"that value\") metags(r) #>  another_tag          one     one more        three          two  #>         \"44\"        \"ABC\" \"that value\"      \"hello\"        \"123\"    metags(r, name=\"two\") #>   two  #> \"123\"   # remove a tag metags(r) <- cbind(\"one\", \"\") metags(r) <- \"two=\" metags(r) #>  another_tag     one more        three  #>         \"44\" \"that value\"      \"hello\"   # remove all metags metags(r) <- NULL metags(r) #> named character(0)"},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":null,"dir":"Reference","previous_headings":"","what":"Get or compute the minimum and maximum cell values — extremes","title":"Get or compute the minimum and maximum cell values — extremes","text":"minimum maximum value SpatRaster returned computed (file disk necessary) stored object.","code":""},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get or compute the minimum and maximum cell values — extremes","text":"","code":"# S4 method for SpatRaster minmax(x, compute=FALSE) # S4 method for SpatRaster hasMinMax(x) # S4 method for SpatRaster setMinMax(x, force=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get or compute the minimum and maximum cell values — extremes","text":"x SpatRaster compute logical. TRUE min max values computed available force logical. TRUE min max values recomputed even already available","code":""},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get or compute the minimum and maximum cell values — extremes","text":"minmax: numeric matrix minimum maximum cell values layer hasMinMax: logical indicating whether min max values available. setMinMax: nothing. Used side-effect computing minimum maximum values SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get or compute the minimum and maximum cell values — extremes","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) minmax(r) #>     elevation #> min       141 #> max       547"},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":null,"dir":"Reference","previous_headings":"","what":"modal value — modal","title":"modal value — modal","text":"Compute mode cell across layers SpatRaster. mode, modal value, frequent value set values.","code":""},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"modal value — modal","text":"","code":"# S4 method for SpatRaster modal(x, ..., ties=\"first\", na.rm=FALSE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"modal value — modal","text":"x SpatRaster ... additional argument type x numeric ties character. Indicates treat ties. Either \"random\", \"lowest\", \"highest\", \"first\", \"NA\" na.rm logical. TRUE, NA values ignored. FALSE, NA returned x NA values filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"modal value — modal","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"modal value — modal","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    r <- c(r/2, r, r*2) m <- modal(r)"},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":null,"dir":"Reference","previous_headings":"","what":"mosaic SpatRasters — mosaic","title":"mosaic SpatRasters — mosaic","text":"Combine adjacent (partly) overlapping SpatRasters form single new SpatRaster. Values overlapping cells averaged (default) can computed another function. SpatRasters must origin spatial resolution. method similar simpler, much faster, merge method.","code":""},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"mosaic SpatRasters — mosaic","text":"","code":"# S4 method for SpatRaster,SpatRaster mosaic(x, y, ..., fun=\"mean\", filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterCollection,missing mosaic(x, fun=\"mean\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"mosaic SpatRasters — mosaic","text":"x SpatRaster y object class x ... additional SpatRasters fun character. One \"mean\", \"median\", \"min\", \"max\", \"modal\", \"sum\", \"first\", \"last\" filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"mosaic SpatRasters — mosaic","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"mosaic SpatRasters — mosaic","text":"","code":"x <- rast(xmin=-110, xmax=-60, ymin=40, ymax=70, res=1, vals=1) y <- rast(xmin=-95, xmax=-45, ymax=60, ymin=30, res=1, vals=2) z <- rast(xmin=-80, xmax=-30, ymax=50, ymin=20, res=1, vals=3)  m1 <- mosaic(x, y, z)  m2 <- mosaic(z, y, x)  # with many SpatRasters, make a SpatRasterCollection from a list rlist <- list(x, y, z) rsrc <- sprc(rlist)  m <- mosaic(rsrc)"},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":null,"dir":"Reference","previous_headings":"","what":"Find and remove geometries that are NA — na.omit","title":"Find and remove geometries that are NA — na.omit","text":"Find geometries NA; remove geometries /records NA.","code":""},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find and remove geometries that are NA — na.omit","text":"","code":"# S4 method for SpatVector is.na(x)  # S4 method for SpatVector na.omit(object, field=NA, geom=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find and remove geometries that are NA — na.omit","text":"x SpatVector object SpatVector field character NA. NA, missing values attributes ignored. values either one field (variable) names, \"\" consider fields geom logical. TRUE empty geometries removed","code":""},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find and remove geometries that are NA — na.omit","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Find and remove geometries that are NA — na.omit","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$test <- c(1,2,NA) nrow(v) #> [1] 12 x <- na.omit(v, \"test\") nrow(x) #> [1] 8"},{"path":"https://rspatial.github.io/terra/reference/names.html","id":null,"dir":"Reference","previous_headings":"","what":"Names of Spat* objects — names","title":"Names of Spat* objects — names","text":"Get set names layers SpatRaster attributes SpatVector. See set.names -place setting names.","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Names of Spat* objects — names","text":"","code":"# S4 method for SpatRaster names(x)  # S4 method for SpatRaster names(x)<-value  # S4 method for SpatRasterDataset names(x)  # S4 method for SpatRasterDataset names(x)<-value  # S4 method for SpatVector names(x)  # S4 method for SpatVector names(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Names of Spat* objects — names","text":"x SpatRaster, SpatRasterDataset, SpatVector value character (vector)","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Names of Spat* objects — names","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Names of Spat* objects — names","text":"terra enforces neither unique valid names. See make.unique create unique names make.names make syntactically valid names.","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Names of Spat* objects — names","text":"","code":"s <- rast(ncols=5, nrows=5, nlyrs=3) nlyr(s) #> [1] 3 names(s) #> [1] \"lyr.1\" \"lyr.2\" \"lyr.3\" names(s) <- c(\"a\", \"b\", \"c\") names(s) #> [1] \"a\" \"b\" \"c\"  # SpatVector names f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) names(v) #> [1] \"ID_1\"   \"NAME_1\" \"ID_2\"   \"NAME_2\" \"AREA\"   \"POP\"    names(v) <- paste0(substr(names(v), 1, 2), \"_\", 1:ncol(v)) names(v) #> [1] \"ID_1\" \"NA_2\" \"ID_3\" \"NA_4\" \"AR_5\" \"PO_6\""},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":null,"dir":"Reference","previous_headings":"","what":"nearby geometries — nearest","title":"nearby geometries — nearest","text":"Identify geometries near . Either get index geometries within certain distance, k nearest neighbors, (nearest) get nearest points two geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"nearby geometries — nearest","text":"","code":"# S4 method for SpatVector nearby(x, y=NULL, distance=0, k=1, centroids=TRUE, symmetrical=TRUE)  # S4 method for SpatVector nearest(x, y, pairs=FALSE, centroids=TRUE, lines=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"nearby geometries — nearest","text":"x SpatVector y SpatVector NULL distance numeric. maximum distance k positive integer. number neighbors. Ignored distance > 0 centroids logical. centroids polygons used? symmetrical logical. TRUE, near pair included . , geometry 1 near geometry 3, implied nearness 3 1 reported. Ignored k neighbors returned pairs logical. TRUE pairwise nearest points returned (relevant using least one SpatVector lines polygons lines logical. TRUE lines nearest points instead (nearest) points","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"nearby geometries — nearest","text":"matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"nearby geometries — nearest","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) nearby(v, distance=12000) #>      from to #> [1,]    2  4 #> [2,]    6  8"},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":null,"dir":"Reference","previous_headings":"","what":"normalize vector data that crosses the dateline — normalize.longitude","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"Normalize longitude geometries, move outside -180 180 degrees range.","code":""},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"","code":"# S4 method for SpatVector normalize.longitude(x)"},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"","code":"p <- vect(\"POLYGON ((120 10, 230 75, 230 -75, 120 10))\") normalize.longitude(p) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 1, 0  (geometries, attributes) #>  extent      : -180, 180, -75, 75  (xmin, xmax, ymin, ymax) #>  coord. ref. :"},{"path":"https://rspatial.github.io/terra/reference/north.html","id":null,"dir":"Reference","previous_headings":"","what":"North arrow — north","title":"North arrow — north","text":"Add (North) arrow map","code":""},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"North arrow — north","text":"","code":"north(xy=NULL, type=1, label=\"N\", angle=0, d, head=0.1, xpd=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"North arrow — north","text":"xy numeric. x y coordinate place arrow. can also one following character values: \"bottomleft\", \"bottom\", \"bottomright\", topleft\", \"top\", \"topright\", \"left\", \"right\", NULL type integer 1 12, character (unicode) representation right pointing arrow \"\\u27A9\" label character, printed near arrow angle numeric. angle arrow degrees d numeric. Distance covered arrow plot coordinates. applies type=1 head numeric. size arrow \"head\", type=1 xpd logical. TRUE, scale bar arrow can outside plot area ... graphical arguments passed methods","code":""},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"North arrow — north","text":"none","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"North arrow — north","text":"","code":"f <- system.file(\"ex/meuse.tif\", package=\"terra\") r <- rast(f) plot(r) north() north(c(178550, 332500), d=250)   if (FALSE) { f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) plot(r, type=\"interval\") sbar(15, c(6.3, 50), type=\"bar\", below=\"km\", label=c(0,7.5,15), cex=.8) north(type=3, cex=.8) north(xy=c(6.7, 49.9), type=2, angle=45, label=\"NE\") north(xy=c(6.6, 49.7), type=5, cex=1.25) north(xy=c(5.5, 49.6), type=9) north(d=.05, xy=c(5.5, 50), angle=180, label=\"S\", lwd=2, col=\"blue\")   ## all arrows r <- rast(res=10) values(r) <- 1 plot(r, col=\"white\", axes=FALSE, legend=FALSE, mar=c(0,0,0,0), reset=TRUE) for (i in 1:12) {   x = -200+i*30   north(xy=cbind(x,30), type=i)   text(x, -20, i, xpd=TRUE) }  }"},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":null,"dir":"Reference","previous_headings":"","what":"is not NA — not.na","title":"is not NA — not.na","text":"Shortcut method avoid two-step !.na(x)","code":""},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"is not NA — not.na","text":"","code":"# S4 method for SpatRaster not.na(x, falseNA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"is not NA — not.na","text":"x SpatRaster falseNA logical. result TRUE, NA instead TRUE, FALSE? filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"is not NA — not.na","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"is not NA — not.na","text":"","code":"r <- rast(ncols=10, nrows=10, vals=1) r[10:20] <- NA x <- not.na(r)"},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":null,"dir":"Reference","previous_headings":"","what":"Origin — origin","title":"Origin — origin","text":"Get set coordinates point origin SpatRaster. point closest (0, 0) get moved towards point steps x y resolution.","code":""},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Origin — origin","text":"","code":"# S4 method for SpatRaster origin(x)  # S4 method for SpatRaster origin(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Origin — origin","text":"x SpatRaster value numeric vector length 1 2","code":""},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Origin — origin","text":"vector two numbers (x y coordinates)","code":""},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Origin — origin","text":"","code":"r <- rast(xmin=-0.5, xmax = 9.5, ncols=10) origin(r) #> [1] 0.5 0.0 origin(r) <- c(0,0) r #> class       : SpatRaster  #> dimensions  : 180, 10, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 10, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)"},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":null,"dir":"Reference","previous_headings":"","what":"Pairs plot (matrix of scatterplots) — pairs","title":"Pairs plot (matrix of scatterplots) — pairs","text":"Pair plots layers SpatRaster. wrapper around graphics function pairs.","code":""},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Pairs plot (matrix of scatterplots) — pairs","text":"","code":"# S4 method for SpatRaster pairs(x, hist=TRUE, cor=TRUE, use=\"pairwise.complete.obs\", maxcells=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Pairs plot (matrix of scatterplots) — pairs","text":"x SpatRaster hist logical. TRUE histogram values shown diagonal cor logical. TRUE correlation coefficient shown upper panels use argument passed cor function maxcells integer. Number pixels sample layer large SpatRaster ... additional arguments (graphical parameters)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Pairs plot (matrix of scatterplots) — pairs","text":"","code":"r <-rast(system.file(\"ex/elev.tif\", package=\"terra\")) s <- c(r, 1/r, sqrt(r)) names(s) <- c(\"elevation\", \"inverse\", \"sqrt\")  pairs(s)   # to make indvidual histograms: hist(r)  # or scatter plots: plot(s[[1]], s[[2]])"},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":null,"dir":"Reference","previous_headings":"","what":"Map panel — panel","title":"Map panel — panel","text":"Show multiple maps share single legend.","code":""},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Map panel — panel","text":"","code":"# S4 method for SpatRaster panel(x, main, loc.main=\"topleft\", nc, nr, maxnl=16,    maxcell=500000, box=FALSE, pax=list(), plg=list(), range=NULL, ...)"},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Map panel — panel","text":"x SpatRaster main character. Main plot titles (one layer plotted). can use arguments cex.main, font.main, col.main change appearance loc.main numeric character set location main title. Either two coordinates, character value \"topleft\") nc positive integer. Optional. number columns divide plotting device (plotting multiple layers) nr positive integer. Optional. number rows divide plotting device (plotting multiple layers) maxnl positive integer. Maximum number layers plot (multi-layer object) maxcell positive integer. Maximum number cells use plot box logical. box drawn around map? plg see plot pax see plot range numeric. minimum maximum values used continuous legend ... arguments passed plot(\"SpatRaster\", \"numeric\") additional graphical arguments","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Map panel — panel","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) x <- c(r, r/2, r*2, r) names(x) <- paste0(\"(\", LETTERS[1:4], \")\") panel(x)  panel(x, fun=\\()lines(v), loc.main=\"topright\")"},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":null,"dir":"Reference","previous_headings":"","what":"Detect patches (clumps) of cells — patches","title":"Detect patches (clumps) of cells — patches","text":"Detect patches (clumps). Patches groups cells surrounded cells NA. Set zeroAsNA TRUE also identify patches separated cells values zero.","code":""},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Detect patches (clumps) of cells — patches","text":"","code":"# S4 method for SpatRaster patches(x, directions=4, zeroAsNA=FALSE, allowGaps=TRUE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Detect patches (clumps) of cells — patches","text":"x SpatRaster directions integer indicating cells considered adjacent. 8 (Queen's case) 4 (Rook's case) zeroAsNA logical. TRUE treat cells zero NA allowGaps logical. TRUE may gaps patch IDs (e.g. may patch IDs 1, 2, 3 5, 4). FALSE, numbers recoded 1 number patches (4 example) filename character. Output filename ... options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Detect patches (clumps) of cells — patches","text":"SpatRaster. Cell values patch numbers","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Detect patches (clumps) of cells — patches","text":"","code":"r <- rast(nrows=18, ncols=36, xmin=0) r[1:2, 5:8] <- 1 r[5:8, 2:6] <- 1 r[7:12, 22:36] <- 1 r[15:16, 18:29] <- 1 p <- patches(r)  # zero as background instead of NA r <- rast(nrows=10, ncols=10, xmin=0, vals=0) r[3, 3] <- 10 r[4, 4] <- 10 r[5, 5:8] <- 12 r[6, 6:9] <- 12  # treat zeros as NA  p4 <- patches(r, zeroAsNA=TRUE) p8 <- patches(r, 8, zeroAsNA=TRUE)  ### patches for different values # remove zeros manually rr <- classify(r, cbind(0, NA))  # make layers for each value s <- segregate(rr, keep=TRUE, other=NA) p <- patches(s)   ### patch ID values are not guaranteed to be consecutive r <- rast(nrows=5, ncols=10, xmin=0) set.seed(0) values(r)<- round(runif(ncell(r))*0.7) rp <- patches(r, directions=8, zeroAsNA=TRUE)  plot(rp, type=\"classes\"); text(rp)   ## unless you set allowGaps=FALSE rp <- patches(r, directions=8, zeroAsNA=TRUE, allowGaps=FALSE)  plot(rp, type=\"classes\"); text(rp)   ### use zonal to remove small patches  f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- classify(r, cbind(-Inf, 400, NA)) y <- patches(x) # remove patches smaller than 100 ha rz <- zonal(cellSize(y, unit=\"ha\"), y, sum, as.raster=TRUE) s <- ifel(rz < 250, NA, y)"},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":null,"dir":"Reference","previous_headings":"","what":"Perimeter or length — perim","title":"Perimeter or length — perim","text":"method returns length lines perimeter polygons. crs longitude/latitude, may get accurate results first unprojecting SpatVector (can use project transform crs longitude/latitude)","code":""},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Perimeter or length — perim","text":"","code":"# S4 method for SpatVector perim(x)"},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Perimeter or length — perim","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Perimeter or length — perim","text":"numeric (m)","code":""},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Perimeter or length — perim","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) perim(v) #>  [1] 117100.12  93477.28  84502.45  44919.14  85032.61  74708.05  57991.42 #>  [8]  81203.93  74443.82  95564.74  80618.76  70810.67"},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":null,"dir":"Reference","previous_headings":"","what":"Perspective plot — persp","title":"Perspective plot — persp","text":"Perspective plot SpatRaster. implementation generic function graphics package.","code":""},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Perspective plot — persp","text":"","code":"# S4 method for SpatRaster persp(x, maxcells=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Perspective plot — persp","text":"x SpatRaster. first layer used maxcells integer > 0. Maximum number cells use plot. maxpixels < ncell(x), spatSample(method=\"regular\") used plotting ... argument can passed persp (graphics package)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Perspective plot — persp","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) persp(r)"},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot with leaflet — plet","title":"Plot with leaflet — plet","text":"Plot values SpatRaster SpatVector make interactive leaflet map displayed browser.","code":""},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot with leaflet — plet","text":"","code":"# S4 method for SpatRaster plet(x, y=1, col, alpha=0.8, main=names(x),    tiles=c(\"Streets\", \"Esri.WorldImagery\", \"OpenTopoMap\"),    wrap=TRUE, maxcell=500000, legend=\"bottomright\",    shared=FALSE, panel=FALSE, collapse=TRUE, map=NULL)    # S4 method for SpatVector plet(x, y=\"\", col,fill=0.2, main=y, cex=1, lwd=2,    border=\"black\", alpha=1, popup=TRUE, label=FALSE, split=FALSE,   tiles=c(\"Streets\", \"Esri.WorldImagery\", \"OpenTopoMap\"),    wrap=TRUE, legend=\"bottomright\", collapse=FALSE, type=NULL, breaks=NULL,   breakby=\"eqint\", sort=TRUE, decreasing=FALSE, map=NULL, ...)   # S4 method for SpatVectorCollection plet(x, col, fill=0, cex=1, lwd=2, border=\"black\", alpha=1, popup=TRUE,     label=FALSE, tiles=c(\"Streets\", \"Esri.WorldImagery\", \"OpenTopoMap\"), wrap=TRUE,    legend=\"bottomright\", collapse=FALSE, map=NULL)   # S4 method for leaflet lines(x, y, col, lwd=2, alpha=1, ...)  # S4 method for leaflet points(x, y, col, cex=1, alpha=1, popup=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot with leaflet — plet","text":"x SpatRaster, SpatVector, leaflet object y missing, positive integer, character (variable layer name) indicating layer(s) plotted. x SpatRater, can select multiple layers col character. Vector colors color generating function alpha Number 0 1 set transparency lines (0 transparent, 1 opaque) fill Number 0 1 set transparency polygon areas (0 transparent, 1 opaque) tiles character NULL. Names background tile providers wrap logical. TRUE, tiles wrap around maxcell positive integer. Maximum number cells use plot legend character indicate legend position (\"bottomleft\", \"bottomright\", \"topleft\" \"topright\") NULL suppress legend main character. Title legend. length 1 x SpatVector length nlyr(x) x SpatVector shared logical. legend rasters (multiple layers SpatRaster x mapped) map leaflet object ... additional arguments drawing points, lines, polygons passed relevant leaflet function border character. Color polygon borders collapse logical. layers \"control\" panel collapsed? split logical. TRUE check-box created toggle value y (x SpatVector) cex numeric. point size magnifier. See par lwd numeric, line-width. See par popup logical. pop-ups created? label logical. mouse-labels added? panel logical. SpatRaster layers shown panel\" type character. Type map/legend. One \"classes\", \"interval\". specified, type chosen based data. Use \"\" suppress legend breaks numeric. Either single number indicate number breaks desired, actual breaks. providing argument, default legend becomes \"interval\" breakby character function. Either \"eqint\" equal interval breaks, \"cases\" equal quantile breaks. function supplied take single argument (vector values) create groups sort logical. TRUE legends character values sorted. can also supply vector unique values, order want appear legend decreasing logical. TRUE, legends sorted decreasing order","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot with leaflet — plet","text":"","code":"if (FALSE) { if (require(leaflet) && (packageVersion(\"leaflet\") > \"2.1.1\")) {  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) p <- spatSample(as.polygons(v, ext=T), 30) values(p) = data.frame(id=11:40, name=letters[1:30])  m <- plet(v, \"NAME_1\", tiles=\"\", border=\"blue\") m <- points(m, p, col=\"red\", cex=2, popup=T) lines(m, v, lwd=1, col=\"white\")  plet(v, \"NAME_1\", split=TRUE, alpha=.2) |>    points(p, col=\"gray\", cex=2, popup=TRUE,     clusterOptions = markerClusterOptions())  s <- svc(v, p) names(s) <- c(\"the polys\", \"set of points\") plet(s, col=c(\"red\", \"blue\"), lwd=1)   r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) plet(r, main=\"Hi\\nthere\", tiles=NULL) |> lines(v, lwd=1)  plet(r, tiles=\"OpenTopoMap\") |> lines(v, lwd=2, col=\"blue\")  x <- c(r, 50*classify(r, 5)) names(x) <- c(\"first\", \"second\")  # each their own legend plet(x, 1:2, collapse=FALSE) |> lines(v, lwd=2, col=\"blue\")  # shared legend plet(x, 1:2, shared=TRUE, collapse=FALSE) |> lines(v, lwd=2, col=\"blue\")  }}"},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Make a map — plot","title":"Make a map — plot","text":"Plot values SpatRaster SpatVector make map. See points, lines polys add SpatVector existing map (use argument add=TRUE). separate help file plotting SpatGraticule SpatExtent.","code":""},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make a map — plot","text":"","code":"# S4 method for SpatRaster,numeric plot(x, y=1, col, type=NULL, mar=NULL, legend=TRUE, axes=!add, plg=list(), pax=list(),      maxcell=500000, smooth=FALSE, range=NULL, levels=NULL, all_levels=FALSE,   breaks=NULL, breakby=\"eqint\", fun=NULL, colNA=NULL, alpha=NULL, sort=FALSE,    decreasing=FALSE, grid=FALSE, ext=NULL, reset=FALSE, add=FALSE, buffer=FALSE,    background=NULL, box=axes, clip=TRUE, ...)  # S4 method for SpatRaster,missing plot(x, y, main, mar=NULL, nc, nr, maxnl=16, maxcell=500000, add=FALSE, ...)  # S4 method for SpatRaster,character plot(x, y, ...)  # S4 method for SpatVector,character plot(x, y, col=NULL, type=NULL, mar=NULL, add=FALSE, legend=TRUE, axes=!add,      main=\"\", buffer=TRUE, background=NULL, grid=FALSE, ext=NULL, sort=TRUE,    decreasing=FALSE, plg=list(), pax=list(), nr, nc, colNA=NA, alpha=NULL,    box=axes, clip=TRUE, ...)  # S4 method for SpatVector,numeric plot(x, y, ...)  # S4 method for SpatVector,missing plot(x, y, values=NULL, ...)"},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make a map — plot","text":"x SpatRaster SpatVector y missing positive integer name indicating layer(s) plotted col character vector specify colors use. default map.pal(\"viridis\", 100). default can changed terra.pal option. example: options(terra.pal=terrain.colors(10)). x SpatRaster, can also data.frame two columns (value, color) get \"classes\" type legend three columns (, , color) get \"interval\" type legend type character. Type map/legend. One \"continuous\", \"classes\", \"interval\". specified, type chosen based data mar numeric vector length 4 set margins plot (make space legend). default (3.1, 3.1, 2.1, 7.1) single plot legend (3.1, 3.1, 2.1, 2.1) otherwise. default RGB raster 0. Use mar=NA set margins legend logical character. FALSE legend drawn. character value can used indicate legend drawn. example \"topright\" \"bottomleft\". Use plg refined placement. supported continuous legends (default raster data) axes logical. Draw axes? buffer logical. TRUE plotting area made slightly larger extent x background background color. Default color (white) box logical. box drawn around map? clip logical. axes clipped extent x? plg list parameters drawing legend. classes interval type legend see arguments legend. example x y can used place legend. can also use keywords \"topleft\" \"bottomright\" place legend locations inside map rectangle. apply continuous legend, behave little differently. example, placement keywords \"left\", \"right\", \"top\", \"bottom\" recognized; using keywords, legend placed outside map rectangle. Additional parameters continuous legends include:  digits set number digits print decimal point. size change height /width; defaults c(1,1), negative values size flip order legend. set location tic-marks tic One partially matched values: \"\", \"\", \"\", \"none\", choose tic-mark placement/length different default \"\".  pax list parameters drawing axes. See arguments axis. Arguments side, tick lab can used indicate four axes draw line (side), tick-mark, /tick-mark labels. default c(1:4) side 1:2 two. side changed two default value. Logical argument retro can used use sexagesimal notation labels (degrees/minutes/hemisphere) instead standard decimal notation maxcell positive integer. Maximum number cells use plot smooth logical. TRUE cell values smoothed (continuous legend used) range numeric. minimum maximum values used continuous legend levels character. labels legend type=\"classes\" all_levels logical. TRUE, legend shows levels categorical raster, even present data breaks numeric. Either single number indicate number breaks desired, actual breaks. providing argument, default legend becomes \"interval\" breakby character function. Either \"eqint\" equal interval breaks, \"cases\" equal quantile breaks. function supplied, take single argument (vector values) create groups fun function called plotting SpatRaster layer add something map (text, legend, lines). example, SpatVector v, fun=function() lines(v). function may one argument, representing layer plotted (1 number layers) colNA character. color NA values alpha Either single numeric 0 1 set transparency colors (0 transparent, 1 opaque) SpatRaster values 0 1 set transparency cell. set transparency given color, set colors directly sort logical. TRUE legends categorical values sorted. x SpatVector can also supply vector unique values, order want appear legend decreasing logical. TRUE, legends sorted decreasing order grid logical. TRUE grid lines drawn. properties type color can set pax argument nc positive integer. Optional. number columns divide plotting device (plotting multiple layers) nr positive integer. Optional. number rows divide plotting device (plotting multiple layers) main character. Main plot titles (one layer plotted). can use arguments cex.main, font.main, col.main change appearance; loc.main change location main title (either two coordinates, character value \"topleft\") maxnl positive integer. Maximum number layers plot (multi-layer object) add logical. TRUE add object current plot ext SpatExtent. Can use instead xlim ylim set extent plot reset logical. TRUE add margins (see argument mar) reset calling plot; may affect display additional objects added map (e.g.  lines) values Either vector values used plotting two-column data.frame, first column matches variable x second column values plotted ... arguments passed plot(\"SpatRaster\", \"numeric\") additional graphical arguments","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make a map — plot","text":"","code":"## SpatRaster f <- system.file(\"ex/elev.tif\", package=\"terra\")  r <- rast(f) plot(r)   plot(r, type=\"interval\")   e <- c(6.37, 6.41, 49.9, 50.1) plot(r, plg=list(ext=e, title=\"Legend\\nTitle\", title.cex=0.9),      pax=list(side=1:4, retro=TRUE)) north(cbind(5.8, 50.1))     d <- classify(r, c(100,200,300,400,500,600)) plot(d, type=\"classes\")   plot(d, type=\"interval\", breaks=1:5)   plot(d, type=\"interval\", breaks=c(1,4,5), plg=list(legend=c(\"1-4\", \"4-5\")))   plot(d, type=\"classes\", xlim=c(5.6, 6.6),    plg=list(legend=c(\"Mr\", \"Xx\", \"As\", \"Zx\", \"Bb\"), x=\"bottomleft\"))    x <- trunc(r/200) levels(x) <- data.frame(id=0:2, element=c(\"earth\", \"wind\", \"fire\")) plot(x, plg=list(x=\"topright\"),mar=c(2,2,2,2))   oldpar <- par(no.readonly=TRUE)  # two plots with the same legend dev.new(width=6, height=4, noRStudioGD = TRUE) par(mfrow=c(1,2)) plot(r, range=c(50,600), mar=c(1,1,1,4)) plot(r/2, range=c(50,600), mar=c(1,1,1,4))  # as we only need one legend: par(mfrow=c(1,2)) plot(r, range=c(50,600), mar=c(2, 2, 2, 2), plg=list(size=0.9, cex=.8),    pax=list(side=1:2, cex.axis=.6), box=FALSE) #text(182500, 335000, \"Two maps, one plot\", xpd=NA) plot(r/2, range=c(50,600), mar=c(2, 2, 2, 2), legend=FALSE,    pax=list(side=c(1,4), cex.axis=.6), box=FALSE)  par(oldpar)  # multi-layer with RGB s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  plot(s) # remove RGB plot(s*1) # or use layers plot(s, 1) plot(s, 1:3)  # fix legend by linking values and colors  x = rast(nrows = 2, ncols = 2, vals=1) y = rast(nrows = 2, ncols = 2, vals=c(1,2,2,1)) cols = data.frame(id=1:2, col=c(\"red\", \"blue\")) plot(c(x,y), col=cols)  r  = rast(nrows=10, ncols=10, vals=1:100) dr = data.frame(from=c(5,33,66,150), to=c(33, 66, 95,200), col=rainbow(4)) plot(r, col=dr)  ### SpatVector   f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  plot(v)  plot(v, \"NAME_2\", col=rainbow(12), border=c(\"gray\", \"blue\"), lwd=3)  plot(v, 2, pax=list(side=1:2), plg=list(x=6.16, y=50.17, cex=.8), xlim=c(5.7, 6.7))  plot(v, 4, pax=list(side=1:2), plg=list(x=6.2, y=50.2, ncol=2), main=\"\", box=FALSE)   plot(v, 1, plg=list(x=5.8, y=49.37, horiz=TRUE, cex=1.1), main=\"\", mar=c(5,2,0.5,0.5))  plot(v, density=1:12, angle=seq(18, 360, 20), col=rainbow(12))   plot(v, \"AREA\", type=\"interval\", breaks=3, mar=c(3.1, 3.1, 2.1, 3.1),   plg=list(x=\"topright\"), main=\"\")  plot(v, \"AREA\", type=\"interval\", breaks=c(0,200,250,350),    mar=c(2,2,2,2), xlim=c(5.7, 6.75),   plg=list(legend=c(\"<200\", \"200-250\", \">250\"), cex=1, bty=\"o\",    x=6.3, y=50.15, box.lwd=2, bg=\"light yellow\", title=\"My legend\"))"},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":null,"dir":"Reference","previous_headings":"","what":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"Make Red-Green-Blue plot based three layers SpatRaster. layers (sometimes referred \"bands\" may represent different bandwidths electromagnetic spectrum) combined represent red, green blue channel. function can used make \"true\" (\"false\") color images Landsat multi-spectral satellite images. Note margins plot set zero (axes titles visible) can set mar argument. alternative way plot RGB images first use colorize create single layer SpatRaster color-table use plot.","code":""},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"","code":"# S4 method for SpatRaster plotRGB(x, r=1, g=2, b=3, a=NULL, scale=NULL, mar=0,      stretch=NULL, smooth=TRUE, colNA=\"white\", alpha=NULL, bgalpha=NULL,      zlim=NULL, zcol=FALSE, axes=FALSE ,...)"},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"x SpatRaster r integer 1 nlyr(x). Layer use Red channel g integer 1 nlyr(x). Layer use Green channel b integer 1 nlyr(x). Layer use Blue channel NULL integer 1 nlyr(x). Layer use alpha (transparency) channel. NULL, argument alpha ignored scale integer. Maximum (possible) value three channels. Defaults 255 maximum value x known larger 255 mar numeric vector recycled length 4 set margins plot. Use mar=NULL mar=NA set margins stretch character. Option stretch values increase contrast: \"lin\" (linear) \"hist\" (histogram). linear stretch uses stretch arguments minq=0.02 maxq=0.98 smooth logical. TRUE, smooth image drawing get appearance higher spatial resolution colNA color. color used cells NA values alpha transparency. Integer 0 (transparent) 255 (opaque) bgalpha Background transparency. Integer 0 (transparent) 255 (opaque) zlim numeric vector length 2. Range values plot (optional). set, stretch=\"lin\" used, values stretched within range zlim. allows creating consistent coloring SpatRasters different cell-value ranges, even stretching colors improved contrast zcol logical. TRUE values outside range zlim get color extremes range. Otherwise, values outside zlim range get color NA values (see argument \"colNA\") axes logical. TRUE axes drawn (arguments main=\"title\" honored) ... graphical parameters plot<SpatRaster-method>","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"","code":"b <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    plotRGB(b) plotRGB(b, mar=2)  plotRGB(b, 3, 2, 1)   b[1000:2000] <- NA plotRGB(b, 3, 2, 1, stretch=\"hist\")"},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot a SpatExtent — plot_extent","title":"Plot a SpatExtent — plot_extent","text":"Plot SpatExtent. Use lines add SpatExtent existing map. See plot plotting object types.","code":""},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot a SpatExtent — plot_extent","text":"","code":"# S4 method for SpatExtent,missing plot(x, y, ...)"},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot a SpatExtent — plot_extent","text":"x SpatExtent y missing ... additional graphical arguments lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot a SpatExtent — plot_extent","text":"","code":"r <- rast() plot(ext(r))"},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot a graticule — plot_graticule","title":"Plot a graticule — plot_graticule","text":"Plot SpatGraticule. can create SpatGraticule graticule.","code":""},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot a graticule — plot_graticule","text":"","code":"# S4 method for SpatGraticule,missing plot(x, y, background=NULL, col=\"black\", mar=NULL, labels=TRUE,   retro=FALSE, lab.loc=c(1,1), lab.lon=NULL, lab.lat=NULL, lab.cex=0.65,    lab.col=\"black\", off.lat=0.25, off.lon=0.25, box=FALSE, box.col=\"black\",   add=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot a graticule — plot_graticule","text":"x SpatRaster SpatVector y missing positive integer name indicating layer(s) plotted background background color. NULL, background drawn mar numeric vector length 4 set margins plot. make space legend may use something like c(3.1, 3.1, 2.1, 7.1). fill plotting canvas, can use c(0,0,0,0. Use NA set margins col character. Color graticule lines labels logical. TRUE, show graticule labels retro logical. TRUE, show \"retro\" instead decimal labels graticule lab.loc numeric. first number indicates longitude graticule labels drawn (1=bottom, 2=top, NA=drawn, number=top bottom). second number indicates latitude graticule labels drawn (1=left, 2=right, NA=drawn, number=left right) lab.lon positive integers 1 number labels, indicating longitude graticule labels included lab.lat positive integers 1 number labels, indicating latitude graticule labels included lab.cex double. size label font lab.col character. color labels .lon numeric. longitude labels offset .lat numeric. latitude labels offset box logical. TRUE, outer lines graticule drawn top sold line lty=1 box.col character. color outer lines graticule box=TRUE add logical. Add graticule current plot? ... additional graphical arguments passed lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot a graticule — plot_graticule","text":"","code":"g <- graticule(60, 30, crs=\"+proj=robin\")  plot(g, background=\"azure\", col=\"red\", lty=2, box=TRUE)  plot(g, background=\"azure\", col=\"light gray\", lab.loc=c(1,2),      lab.lon=c(2,4,6), lab.lat=3:5, lty=3, retro=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster PCA with prcomp — prcomp","title":"SpatRaster PCA with prcomp — prcomp","text":"Compute principal components SpatRaster layers. method may preferred princomp greater numerical accuracy. However, slower large rasters can done sample. may good enough see princomp want use values. Unlike princomp, method sample variances used n-1 denominator.","code":""},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster PCA with prcomp — prcomp","text":"","code":"# S4 method for SpatRaster prcomp(x, retx=TRUE, center=TRUE, scale.=FALSE,      tol=NULL, rank.=NULL, maxcell=Inf)"},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster PCA with prcomp — prcomp","text":"x SpatRaster retx logical value indicating whether rotated variables returned center logical value indicating whether variables shifted zero centered. Alternately, vector length equal number columns x can supplied. value passed scale scale. logical value indicating whether variables scaled unit variance analysis takes place. default FALSE consistency S, general scaling advisable. Alternatively, vector length equal number columns x can supplied. value passed scale tol value indicating magnitude components omitted. (Components omitted standard deviations less equal tol times standard deviation first component.) default null setting, components omitted (unless rank. specified less min(dim(x))). settings tol tol = 0 tol = sqrt(.Machine$double.eps), omit essentially constant components rank. optionally, number specifying maximal rank, .e., maximal number principal components used. Can set alternative addition tol, useful notably desired rank considerably smaller dimensions matrix maxcell positive integer. maximum number cells used. smaller ncell(x), regular sample x used","code":""},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster PCA with prcomp — prcomp","text":"prcomp object","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster PCA with prcomp — prcomp","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f) pca <- prcomp(r) x <- predict(r, pca)  # use \"index\" to get a subset of the components p <- predict(r, pca, index=1:2)"},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial model predictions — predict","title":"Spatial model predictions — predict","text":"Make SpatRaster predictions fitted model object (example, obtained glm randomForest). first argument SpatRaster object predictor variables. names SpatRaster exactly match expected model. regression like model predict method implemented (can implemented) can used. method work model's predict function returns vector, matrix data.frame (list can coerced data.frame). cases may necessary provide custom \"predict\" function wraps model's predict function return values required form. See examples. approach using model predictions commonly used remote sensing (classification satellite images) ecology, species distribution modeling.","code":""},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial model predictions — predict","text":"","code":"# S4 method for SpatRaster predict(object, model, fun=predict, ..., const=NULL, na.rm=FALSE,           index=NULL, cores=1, cpkgs=NULL, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial model predictions — predict","text":"object SpatRaster model fitted model class \"predict\" method (can supply similar method fun argument. E.g. glm, gam, randomForest fun function. predict function takes model first argument. default value predict, can replaced e.g. predict.se (depending type model), custom function ... additional arguments fun const data.frame. Can used add constant value predictor variable need make SpatRaster layer na.rm logical. TRUE, cells NA values layers x removed computation (even NA cell layer used variable model). option prevents errors models handle NA values makeing predictions. cases affect output. However, models return predicted values even () variables NA index integer character. Can used select subset model output variables cores positive integer. cores > 1, 'parallel' package cluster many cores created used cpkgs character. package(s) need loaded nodes able run model.predict function (see examples) filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial model predictions — predict","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial model predictions — predict","text":"","code":"logo <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    names(logo) <- c(\"red\", \"green\", \"blue\") p <- matrix(c(48, 48, 48, 53, 50, 46, 54, 70, 84, 85, 74, 84, 95, 85,     66, 42, 26, 4, 19, 17, 7, 14, 26, 29, 39, 45, 51, 56, 46, 38, 31,     22, 34, 60, 70, 73, 63, 46, 43, 28), ncol=2)  a <- matrix(c(22, 33, 64, 85, 92, 94, 59, 27, 30, 64, 60, 33, 31, 9,    99, 67, 15, 5, 4, 30, 8, 37, 42, 27, 19, 69, 60, 73, 3, 5, 21,    37, 52, 70, 74, 9, 13, 4, 17, 47), ncol=2)  xy <- rbind(cbind(1, p), cbind(0, a))  # extract predictor values for points e <- extract(logo, xy[,2:3])  # combine with response (excluding the ID column) v <- data.frame(cbind(pa=xy[,1], e))  #build a model, here with glm  model <- glm(formula=pa~., data=v)  #predict to a raster r1 <- predict(logo, model)  plot(r1) points(p, bg='blue', pch=21) points(a, bg='red', pch=21)   # logistic regression model <- glm(formula=pa~., data=v, family=\"binomial\") #> Warning: glm.fit: algorithm did not converge #> Warning: glm.fit: fitted probabilities numerically 0 or 1 occurred r1log <- predict(logo, model, type=\"response\")  # to get the probability and standard error r1se <- predict(logo, model, se.fit=TRUE)  # or provide a custom predict function  predfun <- function(model, data) {   v <- predict(model, data, se.fit=TRUE)   cbind(p=as.vector(v$fit), se=as.vector(v$se.fit)) }  r2 <- predict(logo, model, fun=predfun)  ### principal components of a SpatRaster pca <- prcomp(logo)  # or use sampling if you have a large raster  # and cannot process all cell values sr <- spatSample(logo, 100000, \"regular\") pca <- prcomp(sr)  x <- predict(logo, pca) plot(x)   ## parallelization if (FALSE) { ## simple case with GLM  model <- glm(formula=pa~., data=v) p <- predict(logo, model, cores=2)  ## The above does not work with a model from a contributed ## package, as the package needs to be loaded in each core.  ## Below are three approaches to deal with that   library(randomForest) rfm <- randomForest(formula=pa~., data=v)  ## approach 0 (not parallel)  rp0 <- predict(logo, rfm)  ## approach 1, use the \"cpkgs\" argument  rp1 <- predict(logo, rfm, cores=2, cpkgs=\"randomForest\")  ## approach 2, write a custom predict function that loads the package rfun <- function(mod, dat, ...) {   library(randomForest)   predict(mod, dat, ...) } rp2 <- predict(logo, rfm, fun=rfun, cores=2)  ## approach 3, write a parallelized custom predict function  rfun <- function(mod, dat, ...) {   ncls <- length(cls)   nr <- nrow(dat)   s <- split(dat, rep(1:ncls, each=ceiling(nr/ncls), length.out=nr))   unlist(  parallel::clusterApply(cls, s, function(x, ...) predict(mod, x, ...))  ) }  library(parallel) cls <- parallel::makeCluster(2) parallel::clusterExport(cls, c(\"rfm\", \"rfun\", \"randomForest\")) rp3 <- predict(logo, rfm, fun=rfun) parallel::stopCluster(cls)  plot(c(rp0, rp1, rp2, rp3))   ### with two output variables (probabilities for each class) v$pa <- as.factor(v$pa) rfm2 <- randomForest(formula=pa~., data=v) rfp <- predict(logo, rfm2, cores=2, type=\"prob\", cpkgs=\"randomForest\") }"},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster PCA with princomp — princomp","title":"SpatRaster PCA with princomp — princomp","text":"Compute principal components SpatRaster layers. method can use values compute principal components, even large rasters. computes covariance matrix processing data chunks, necessary, using layerCor. population covariance used (sample, n-1 denominator, covariance). Alternatively, can specify maxcell sample raster values data.frame speed calculations large rasters (see examples ). See prcomp alternative method higher numerical accuracy, slower, large rasters can accomplished sample since values must read memory.","code":""},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster PCA with princomp — princomp","text":"","code":"# S4 method for SpatRaster princomp(x, cor=FALSE, fix_sign=TRUE, use=\"pairwise.complete.obs\", maxcell=Inf)"},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster PCA with princomp — princomp","text":"x SpatRaster cor logical. FALSE, covariance matrix used. Otherwise correlation matrix used fix_sign logical.  TRUE, signs loadings scores chosen first element loading non-negative use character. decide handle missing values. must (abbreviation ) one strings \"everything\", \"complete.obs\", \"pairwise.complete.obs\", \"masked.complete\". \"pairwise.complete.obs\", covariance pair layers computed cells NA pair. Therefore, may (number ) cells used varies pairs. benefit approach available data used. Use \"complete.obs\", want use values cells NA layers. using \"masked.complete\" indicate layers NA values cells maxcell positive integer. maximum number cells used. smaller ncell(x), regular sample x used","code":""},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster PCA with princomp — princomp","text":"princomp object","code":""},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"SpatRaster PCA with princomp — princomp","text":"Alex Ilich Robert Hijmans, based similar method Benjamin Leutner","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster PCA with princomp — princomp","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f) pca <- princomp(r) x <- predict(r, pca)  # use \"index\" to get a subset of the components p <- predict(r, pca, index=1:2)  ### use princomp directly pca2 <- princomp(values(r),  fix_sign = TRUE) p2 <- predict(r, pca2)  ### may need to use sampling with a large raster  ### here with prcomp instead of princomp sr <- spatSample(r, 100000, \"regular\") pca3 <- prcomp(sr) p3 <- predict(r, pca3)"},{"path":"https://rspatial.github.io/terra/reference/project.html","id":null,"dir":"Reference","previous_headings":"","what":"Change the coordinate reference system — project","title":"Change the coordinate reference system — project","text":"Change coordinate reference system (\"project\") SpatVector, SpatRaster matrix coordinates.","code":""},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Change the coordinate reference system — project","text":"","code":"# S4 method for SpatVector project(x, y, partial = FALSE)  # S4 method for SpatRaster project(x, y, method, mask=FALSE, align_only=FALSE, res=NULL,    origin=NULL, threads=FALSE, filename=\"\", ..., use_gdal=TRUE, by_util = FALSE)  # S4 method for SpatExtent project(x, from, to)  # S4 method for matrix project(x, from, to)"},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Change the coordinate reference system — project","text":"x SpatRaster, SpatVector, SpatExtent matrix (x y columns) whose coordinates project y (x SpatRaster, preferred approach y SpatRaster well, serving template geometry (extent resolution) output SpatRaster. Alternatively, can provide coordinate reference system (CRS) description. can use following formats define coordinate reference systems: WKT,  PROJ.4 (e.g., +proj=longlat +datum=WGS84), EPSG code (e.g., \"epsg:4326\"). note PROJ.4 notation deprecated, can use WGS84/NAD83 NAD27 datums. datums silently ignored. x SpatVector, can provide crs definition discussed , object crs can extracted crs partial logical. TRUE, geometries can partially represented output crs included output method character. Method used estimating new cell values SpatRaster. One : near: nearest neighbor. method fast, can preferred method cell values represent classes. good choice continuous values. used default first layer x categorical. bilinear: bilinear interpolation. default first layer x numeric (categorical). cubic: cubic interpolation. cubicspline: cubic spline interpolation. lanczos: Lanczos windowed sinc resampling. sum: weighted sum non-NA contributing grid cells. min, q1, med, q3, max, average, mode, rms: minimum, first quartile, median, third quartile, maximum, mean, mode, root-mean-square value non-NA contributing grid cells. mask logical. TRUE, mask areas outside input extent. example avoid data wrapping around date-line (see example Robinson projection). remove cells NA y (y SpatRaster) can use mask method calling project (function) align_only logical. TRUE, y SpatRaster, template used spatial resolution origin, extent set extent x included res numeric. Can used set resolution output raster y CRS origin numeric. Can used set origin output raster y CRS threads logical. TRUE multiple threads used (faster large files) filename character. Output filename ... additional arguments writing files writeRaster use_gdal logical. TRUE GDAL-warp algorithm used. Otherwise slower internal algorithm used may accurate much variation cell sizes output raster. near bilinear algorithms available internal algorithm by_util logical. TRUE gdal=TRUE, GDAL warp utility used character. Coordinate reference system x character. Output coordinate reference system","code":""},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Change the coordinate reference system — project","text":"SpatVector SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Change the coordinate reference system — project","text":"PROJ.4 notation coordinate reference systems partly deprecated GDAL/PROJ library used function. can still use notation, ** WGS84 datum. datums silently ignored. Transforming (projecting) raster data fundamentally different transforming vector data. Vector data can transformed back-transformed without loss precision without changes values. case raster data. transformation values new cells estimated fashion. Therefore, need match raster vector data analysis, generally transform vector data. using method SpatRaster, preferable approach provide template SpatRaster argument y. template another raster dataset want data align . template begin , can project(rast(x), crs) manipulate output get template want. example, possible use whole numbers extent resolution worry small differences future. can use commands like dim(z) = c(180, 360) res(z) <- 100000. output resolution generally similar input resolution, \"correct\" resolution raster transformation. obvious resolution using lon/lat data spans large North-South extent.","code":""},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Change the coordinate reference system — project","text":"","code":"## SpatRaster a <- rast(ncols=40, nrows=40, xmin=-110, xmax=-90, ymin=40, ymax=60,            crs=\"+proj=longlat +datum=WGS84\") values(a) <- 1:ncell(a) newcrs=\"+proj=lcc +lat_1=48 +lat_2=33 +lon_0=-100 +datum=WGS84\" b <- rast(ncols=94, nrows=124, xmin=-944881, xmax=935118, ymin=4664377, ymax=7144377, crs=newcrs) w <- project(a, b)   ## SpatVector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) crs(v, proj=TRUE) #> [1] \"+proj=longlat +datum=WGS84 +no_defs\" cat(crs(v), \"\\n\") #> GEOGCRS[\"WGS 84\", #>     DATUM[\"World Geodetic System 1984\", #>         ELLIPSOID[\"WGS 84\",6378137,298.257223563, #>             LENGTHUNIT[\"metre\",1]]], #>     PRIMEM[\"Greenwich\",0, #>         ANGLEUNIT[\"degree\",0.0174532925199433]], #>     CS[ellipsoidal,2], #>         AXIS[\"geodetic latitude (Lat)\",north, #>             ORDER[1], #>             ANGLEUNIT[\"degree\",0.0174532925199433]], #>         AXIS[\"geodetic longitude (Lon)\",east, #>             ORDER[2], #>             ANGLEUNIT[\"degree\",0.0174532925199433]], #>     ID[\"EPSG\",4326]]   project(v, \"+proj=moll\") #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 437476.4, 497805.3, 5815524, 5892478  (xmin, xmax, ymin, ymax) #>  coord. ref. : +proj=moll +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664   project(v, \"EPSG:2169\") #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 49540.31, 105922, 57009.53, 138631.1  (xmin, xmax, ymin, ymax) #>  coord. ref. : LUREF / Luxembourg TM (EPSG:2169)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664"},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":null,"dir":"Reference","previous_headings":"","what":"Quantiles of spatial data — quantile","title":"Quantiles of spatial data — quantile","text":"Compute quantiles cell across layers SpatRaster. can use use global(x, fun=quantile) instead compute quantiles across cells layer. can also use method compute quantiles numeric variables SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Quantiles of spatial data — quantile","text":"","code":"# S4 method for SpatRaster quantile(x, probs=seq(0, 1, 0.25), na.rm=FALSE, filename=\"\", ...)   # S4 method for SpatVector quantile(x, probs=seq(0, 1, 0.25), ...)"},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Quantiles of spatial data — quantile","text":"x SpatRaster SpatVector probs numeric vector probabilities values [0,1] na.rm logical. TRUE, NA's removed x quantiles computed filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Quantiles of spatial data — quantile","text":"SpatRaster layers representing quantiles","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Quantiles of spatial data — quantile","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    rr <- c(r/2, r, r*2) qr <- quantile(rr) qr #> class       : SpatRaster  #> dimensions  : 77, 101, 5  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> names       :    q0, q0.25, q0.5, q0.75,  q1  #> min values  :   0.0,   0.0,    0,     0,   0  #> max values  : 127.5, 127.5,  255,   510, 510   if (FALSE) { # same but slower qa <- app(rr, quantile) }  #quantile by layer instead of by cell qg <- global(r, quantile)"},{"path":"https://rspatial.github.io/terra/reference/query.html","id":null,"dir":"Reference","previous_headings":"","what":"Query a SpatVectorProxy object — query","title":"Query a SpatVectorProxy object — query","text":"Query SpatVectorProxy extract subset","code":""},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query a SpatVectorProxy object — query","text":"","code":"# S4 method for SpatVectorProxy query(x, start=1, n=nrow(x), vars=NULL, where=NULL,      extent=NULL, filter=NULL, sql=NULL, what=\"\")"},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query a SpatVectorProxy object — query","text":"x SpatVectorProxy start positive integer. record start reading n positive integer. number records requested vars character. Variable names. Must subset names(x) character. expression like \"NAME_1='California' ID > 3\" , subset records. Note start n applied executing statement extent Spat* object. extent object used spatial filter select geometries read. Ignored filter NULL filter SpatVector. Used spatial filter select geometries read (convex hull used lines points) sql character. Arbitrary SQL statement. used, arguments \"start\", \"n\", \"vars\" \"\" ignored character indicating read. Either \"\" geometries attributes, \"geoms\" read geometries, \"attributes\" read attributes (returned data.frame)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query a SpatVectorProxy object — query","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query a SpatVectorProxy object — query","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f, proxy=TRUE) v #>  class       : SpatVectorProxy #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1 NAME_1  ID_2 NAME_2  AREA   POP #>  type        : <num>  <chr> <num>  <chr> <num> <int>  x <- query(v, vars=c(\"ID_2\", \"NAME_2\"), start=5, n=2) x #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.72324, 50.03632  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_2     NAME_2 #>  type        : <num>      <chr> #>  values      :     5      Wiltz #>                    6 Echternach  query(v, vars=c(\"ID_2\", \"NAME_1\", \"NAME_2\"), where=\"NAME_1='Grevenmacher' AND ID_2 > 6\") #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 3  (geometries, attributes) #>  extent      : 6.169137, 6.516485, 49.46498, 49.75016  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_2       NAME_1       NAME_2 #>  type        : <num>        <chr>        <chr> #>  values      :     7 Grevenmacher       Remich #>                   12 Grevenmacher Grevenmacher  ## with an extent e <- ext(5.9, 6.3, 49.9, 50)  x <- query(v, extent=e)  ## with polygons p <- as.polygons(e) x <- query(v, filter=p) x #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 4, 6  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     4  Vianden    76  5163"},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":null,"dir":"Reference","previous_headings":"","what":"Fill layers with a range — rangeFill","title":"Fill layers with a range — rangeFill","text":"Fill layers cell-varying ranges defined start end SpatRaster. range must start 1 end user-defined maximum. Output values either zero (range) one (range). example, cell start=3, end=5 limit=8, output cell 0,0,1,1,1,0,0,0","code":""},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fill layers with a range — rangeFill","text":"","code":"# S4 method for SpatRaster rangeFill(x, limit, circular=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fill layers with a range — rangeFill","text":"x SpatRaster two layers. cell values first layer indicate start range (1 based); cell values indicate end range limit numeric > 1. range size circular logical. TRUE values considered circular, days year. case, first > last layers used c(first:limit, 1:last). Otherwise, circular=FALSE, range considered invalid NA used filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fill layers with a range — rangeFill","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Fill layers with a range — rangeFill","text":"","code":"x <- y <- rast(ncol=2, nrow=2) values(x) <- c(NA, 1:3) values(y) <- c(NA, 4:6)  r <- rangeFill(c(x, y), 8)"},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Range-apply — rapp","title":"Range-apply — rapp","text":"Apply function range layers SpatRaster varies cell. range specified cell one two SpatRasters (arguments first last). either first last can use single number instead. use single numbers first last case use app Summary-methods, perhaps subsetting layers SpatRaster. See selectRange create new SpatRaster extracting one values starting cell-varying layer.","code":""},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Range-apply — rapp","text":"","code":"# S4 method for SpatRaster rapp(x, first, last, fun, ..., allyrs=FALSE, fill=NA,          clamp=FALSE, circular=FALSE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Range-apply — rapp","text":"x SpatRaster first SpatRaster positive integer 1 nlyr(x), indicating first layer range layers considered last SpatRaster positive integer 1 nlyr(x), indicating last layer range considered fun function applied ... additional arguments passed fun allyrs logical. TRUE, values layers passed fun values outside range set fill fill numeric. fill value values outside range, allyrs=TRUE clamp logical. FALSE specified range outside 1:nlyr(x) cells considered NA. Otherwise, invalid part range ignored circular logical. TRUE values considered circular, days year. case, first > last layers used c(first:nlyr(x), 1:last). Otherwise, range considered invalid NA returned filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Range-apply — rapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Range-apply — rapp","text":"","code":"r <- rast(ncols=9, nrows=9) values(r) <- 1:ncell(r) s <- c(r, r, r, r, r, r) s <- s * 1:6 s[1:2] <- NA start <- end <- rast(r) start[] <- 1:3 end[]   <- 4:6 a <- rapp(s, start, end, fun=\"mean\") b <- rapp(s, start, 2, fun=\"mean\")  # cumsum from start to nlyr(x). return all layers r <- rapp(s, start, nlyr(s), cumsum, allyrs=TRUE, fill=0) # return only the final value rr <- rapp(s, start, nlyr(s), function(i) max(cumsum(i)))"},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatRaster — rast","title":"Create a SpatRaster — rast","text":"Methods create SpatRaster. objects can created scratch, filename, another object. SpatRaster represents spatially referenced surface divided three dimensional cells (rows, columns, layers). SpatRaster created file, load cell (pixel) values memory (RAM). reads parameters describe geometry SpatRaster, number rows columns coordinate reference system. actual values read needed.","code":""},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatRaster — rast","text":"","code":"# S4 method for character rast(x, subds=0, lyrs=NULL, drivers=NULL, opts=NULL,        win=NULL, snap=\"near\", vsi=FALSE, raw=FALSE)  # S4 method for missing rast(x, nrows=180, ncols=360, nlyrs=1, xmin=-180, xmax=180,            ymin=-90, ymax=90, crs, extent, resolution, vals, names, time, units)  # S4 method for SpatRaster rast(x, nlyrs=nlyr(x), names, vals, keeptime=TRUE,        keepunits=FALSE, props=FALSE, tags=FALSE)   # S4 method for matrix rast(x, type=\"\", crs=\"\", digits=6, extent=NULL)  # S4 method for data.frame rast(x, type=\"xyz\", crs=\"\", digits=6, extent=NULL)  # S4 method for array rast(x, crs=\"\", extent=NULL)  # S4 method for list rast(x, warn=TRUE)  # S4 method for SpatRasterDataset rast(x)  # S4 method for SpatVector rast(x, ...)                      # S4 method for SpatExtent rast(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatRaster — rast","text":"x filename (character), missing, SpatRaster, SpatRasterDataset, SpatExtent, SpatVector, matrix, array, list SpatRasters. types attempted create SpatRaster via (`(x, \"SpatRaster\")` subds positive integer character select sub-dataset. zero \"\", sub-datasets returned (possible) lyrs positive integer character select subset layers (.k.. \"bands\") drivers character. GDAL drivers consider opts character. GDAL dataset open options win SpatExtent set window (area interest) snap character. One \"near\", \"\", \"\", indicate extent window \"snapped\" x vsi logical. TRUE, \"\\vsicurl\\\" prepended filenames start \"http\" raw logical. TRUE, scale offset values ignored nrows positive integer. Number rows ncols positive integer. Number columns nlyrs positive integer. Number layers xmin minimum x coordinate (left border) xmax maximum x coordinate (right border) ymin minimum y coordinate (bottom border) ymax maximum y coordinate (top border) crs character. Description Coordinate Reference System (map projection) PROJ.4, WKT authority:code notation. See crs. argument missing, x coordinates within -360 .. 360 y coordinates within -90 .. 90, longitude/latitude assigned keeptime logical. FALSE time stamps discarded keepunits logical. FALSE layer units discarded props logical. TRUE properties (categories color-table) kept tags logical. TRUE user specified metadata tags kept (see metags). extent object class SpatExtent. present, arguments xmin, xmax, ymin ymax ignored resolution numeric vector length 1 2 set spatial resolution (see res). argument used, arguments ncols nrows ignored vals numeric. optional vector cell values (fewer values provided, recycled reach number cells) names character. optional vector layer names (must match number layers) time time date stamps layer units character. units layer type character. value \"xyz\", matrix data.frame x must least two columns, first x (longitude) second y (latitude) coordinates represent centers raster cells. additional columns values associated raster cells. value \"xylz\", x must four columns third representing layer fourth cell values. value \"\", resulting SpatRaster number rows columns x. digits integer set precision detecting whether points regular grid (low number digits low precision). used type=\"xyz\" warn logical. TRUE, warnings empty rasters may emitted ... additional arguments passed rast,missing-method","code":""},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatRaster — rast","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create a SpatRaster — rast","text":"Files read GDAL library. GDAL guesses file format name, /tries reading different \"drivers\" (see gdal) succeeds. cases may cause file opened wrong driver, information may lost. example, netCDF file opened HDF5 driver. can avoid using argument rast(\"filename.ncdf\", drivers=\"NETCDF\") classes hold C++ pointer data \"reference class\" creates limitations. recovered saved R session either directly passed nodes computer cluster. Generally, use writeRaster save SpatRaster objects disk (pass filename cell values ot cluster nodes). Also see wrap.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatRaster — rast","text":"","code":"# Create a SpatRaster from scratch x <- rast(nrows=108, ncols=21, xmin=0, xmax=10)  # Create a SpatRaster from a file f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f)  s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     # Create a skeleton with no associated cell values rast(s) #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)   # from a matrix  m <- matrix(1:25, nrow=5, ncol=5) rm <- rast(m)  # from a \"xyz\" data.frame d <- as.data.frame(rm, xy=TRUE) head(d) #>     x   y lyr.1 #> 1 0.5 4.5     1 #> 2 1.5 4.5     6 #> 3 2.5 4.5    11 #> 4 3.5 4.5    16 #> 5 4.5 4.5    21 #> 6 0.5 3.5     2 rast(d, type=\"xyz\") #> class       : SpatRaster  #> dimensions  : 5, 5, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 5, 0, 5  (xmin, xmax, ymin, ymax) #> coord. ref. :   #> source(s)   : memory #> name        : lyr.1  #> min value   :     1  #> max value   :    25"},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":null,"dir":"Reference","previous_headings":"","what":"Rasterize vector data — rasterize","title":"Rasterize vector data — rasterize","text":"Transfer values associated geometries vector data raster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rasterize vector data — rasterize","text":"","code":"# S4 method for SpatVector,SpatRaster rasterize(x, y, field=\"\", fun, ..., background=NA, touches=FALSE, update=FALSE,    cover=FALSE, by=NULL, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for matrix,SpatRaster rasterize(x, y, values=1, fun, ..., background=NA, update=FALSE,    by=NULL, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rasterize vector data — rasterize","text":"x SpatVector two-column matrix (point coordinates) y SpatRaster field character numeric. field character, variable name x. field numeric typically single number vector length nrow(x). values recycled nrow(x) values typically numeric vector length 1 nrow(x). length nrow(x) values recycled nrow(x). used x matrix. Can also matrix data.frame fun summarizing function multiple geometries one cell. lines polygons can use  \"min\", \"max\", \"mean\", \"count\" \"sum\"   points can use function returns single number; example mean, length (get count), min max ... additional arguments passed fun background numeric. Value put cells covered features x. Default NA touches logical. TRUE, cells touched lines polygons affected, just line render path, whose center point within polygon. touches=TRUE, add TRUE update logical. TRUE, values input SpatRaster updated cover logical. TRUE geometry x polygons, fraction cell covered polygons returned. estimated determining presence/absence polygon least 100 sub-cells (cells) character numeric value(s) split x multiple groups. separate layer group returned. x SpatVector, can column number name. x matrix, vector identifies group membership row x filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rasterize vector data — rasterize","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rasterize vector data — rasterize","text":"","code":"r <- rast(xmin=0, ncols=18, nrows=18)  # generate points set.seed(1) p <- spatSample(r, 1000, xy=TRUE, replace=TRUE)  # rasterize points as a matrix x <- rasterize(p, r, fun=sum) y <- rasterize(p, r, value=1:nrow(p), fun=max)  # rasterize points as a SpatVector pv <- vect(p) xv <- rasterize(pv, r, fun=sum)  # Polygons f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) r <- rast(v, ncols=75, nrows=100) z <- rasterize(v, r, \"NAME_2\") plot(z) lines(v)"},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":null,"dir":"Reference","previous_headings":"","what":"Rasterize geometric properties of vector data — rasterizeGeom","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"Rasterization geometric properties vector data. can get count number geometries cell; area covered polygons; length lines; number lines cross boundary cell. See rasterize standard rasterization (attribute values associated geometries). area polygons intended summing area polygons relatively small relative raster cells, may multiple polygons per cell. See rasterize(fun=\"sum\") counting large polygons rasterize(cover=TRUE) get fraction covered larger polygons.","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"","code":"# S4 method for SpatVector,SpatRaster rasterizeGeom(x, y, fun=\"count\", unit=\"m\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"x SpatVector y SpatRaster fun character. \"count\", \"area\", \"length\", \"crosses\" unit character. \"m\" \"km\" filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) r <- rast(v, res=.1)  # length of lines lns <- as.lines(v) x <- rasterizeGeom(lns, r, fun=\"length\", \"km\")  # count of points set.seed(44) pts <- spatSample(v, 100) y <- rasterizeGeom(pts, r)  # area of polygons pols <- buffer(pts, 1000) z <- rasterizeGeom(pols, r, fun=\"area\")"},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":null,"dir":"Reference","previous_headings":"","what":"Rasterize points with a moving window — rasterizeWin","title":"Rasterize points with a moving window — rasterizeWin","text":"Rasterize points using circle (ellipse) moving window. raster cell, points (x, y) fall within window centered cell considered. function used compute summary value (e.g. \"mean\") values (z) associated points. can result much smoother results compared standard rasterize method.","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rasterize points with a moving window — rasterizeWin","text":"","code":"# S4 method for SpatVector,SpatRaster rasterizeWin(x, y, field, win=\"circle\", pars, fun, ..., cvars=FALSE,          minPoints=1, fill=NA, filename=\"\", wopt=list())  # S4 method for data.frame,SpatRaster rasterizeWin(x, y, win=\"circle\", pars, fun, ..., cvars=FALSE,            minPoints=1, fill=NA, filename=\"\", wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rasterize points with a moving window — rasterizeWin","text":"x SpatVector matrix least three columns ((x, y) coordinates variable rasterized) y SpatRaster field character. field name SpatVector x values rasterize win character choose window type. Can \"circle\", \"ellipse\", \"rectangle\", \"buffer\" pars parameters define window. win=\"circle\" win=\"buffer\", single number set radius circle width buffer. win=\"ellipse\", either two numbers (x y-axis) three numbers axes rotation (degrees). win=\"rectangle\", either two (width, height) three (width, height) rotation degrees. unit radius/width/height/axis parameters coordinate reference system (expressed cells). , lon/lat crs, conversion degrees meters vice-versa. fun function summarize values cell. cvars=FALSE, functions must take numeric vector return (cases) one numbers. cvars=TRUE, multiple variables used, function must take single argument (data.frame names variables).      win=\"circle\" win=\"ellipse\" two additional character values can used: \"distto\" (average distance points center cell) \"distbetween\" (average distance points inside window) ... additional named arguments passed fun minPoints numeric. minimum number points use. fewer points found search ellipse considered empty fill value returned fill numeric. value use fill cells empty search areas cvars logical. using multiple fields, fun operate ? , fun applied variable separately filename character. Output filename wopt list additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rasterize points with a moving window — rasterizeWin","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rasterize points with a moving window — rasterizeWin","text":"","code":"r <- rast(ncol=100, nrow=100, crs=\"local\", xmin=0, xmax=50, ymin=0, ymax=50) set.seed(100) x <- runif(50, 5, 45) y <- runif(50, 5, 45) z <- sample(50) xyz <- data.frame(x,y,z)  r <- rasterizeWin(xyz, r, fun=\"count\", pars=5)  rfuns <- c(\"count\", \"min\", \"max\", \"mean\") x <- lapply(rfuns, function(f) rasterizeWin(xyz, r, fun=f, pars=5)) names(x) <- rfuns  x <- rast(x) #plot(x)"},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine row, column, and layer numbers — rcl","title":"Combine row, column, and layer numbers — rcl","text":"Get matrix combination row, column, layer numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine row, column, and layer numbers — rcl","text":"","code":"# S4 method for SpatRaster rcl(x, row=NULL, col=NULL, lyr=NULL)"},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine row, column, and layer numbers — rcl","text":"x SpatRaster row positive integer row number(s), list thereof, NULL rows col columns lyr layers","code":""},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Combine row, column, and layer numbers — rcl","text":"list used least one row, col lyr, evaluated parallel. combinations made list element, across list elements. , case another argument list either length 1 (used cases) length (longest) list, case value coerced list .list multiple arguments list different lengths, theyare recycled longest list.","code":""},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine row, column, and layer numbers — rcl","text":"matrix","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Combine row, column, and layer numbers — rcl","text":"","code":"x <- rast(ncol=5, nrow=5, nlyr=2) values(x) <- 1:size(x)  rcl(x, 1, 2:3, 1:2) #>      row col lyr #> [1,]   1   2   1 #> [2,]   1   3   1 #> [3,]   1   2   2 #> [4,]   1   3   2  i <- rcl(x, 1, list(1:2, 3:4), 1:2) i #>      row col lyr #> [1,]   1   1   1 #> [2,]   1   2   1 #> [3,]   1   3   2 #> [4,]   1   4   2  # get the values for these cells x[i] #> [1]  1  2 28 29"},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":null,"dir":"Reference","previous_headings":"","what":"Read from, or write to, file — readwrite","title":"Read from, or write to, file — readwrite","text":"Methods read write chunks values file. low level methods programmers. Use writeRaster want save entire SpatRaster file one step. much easier use. write chunks, begin opening file writeStart, write values chunks using list returned writeStart. writing done, close file writeStop. blocks returns chunk size information. can useful reading, writing, raster data.","code":""},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Read from, or write to, file — readwrite","text":"","code":"# S4 method for SpatRaster readStart(x)  # S4 method for SpatRaster readStop(x)  # S4 method for SpatRaster readValues(x, row=1, nrows=nrow(x), col=1, ncols=ncol(x), mat=FALSE, dataframe=FALSE, ...)  # S4 method for SpatRaster,character writeStart(x, filename=\"\", overwrite=FALSE, n=4, sources=\"\", ...)  # S4 method for SpatRaster writeStop(x)  # S4 method for SpatRaster,vector writeValues(x, v, start, nrows)  # S4 method for SpatRaster blocks(x, n=4)  fileBlocksize(x)"},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Read from, or write to, file — readwrite","text":"x SpatRaster filename character. Output filename v vector cell values written start integer. Row number (counting starts 1) start writing v row positive integer. Row number start , 1 nrow(x) nrows positive integer. many rows? col positive integer. Column number start , 1 ncol(x) ncols positive integer. many columns? Default number columns left start column mat logical. TRUE, values returned numeric matrix instead vector, except dataframe=TRUE. layers x factor, level index returned, label. Use dataframe=TRUE get labels dataframe logical. TRUE, values returned data.frame instead vector (also matrix TRUE) overwrite logical. TRUE, filename overwritten n positive integer indicating many copies data may memory point time. used determine many blocks (large) datasets need read sources character. Filenames may overwritten used input function. Can obtained sources(x) ... writeStart: additional arguments writing files writeRaster readValues: additional arguments data.frame (thus relevant dataframe=TRUE)","code":""},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Read from, or write to, file — readwrite","text":"readValues returns vector, matrix, data.frame writeStart returns list can used processing file chunks. methods invisibly return logical value indicating whether successful . purpose side-effect opening closing files.","code":""},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":null,"dir":"Reference","previous_headings":"","what":"Rectify a SpatRaster — rectify","title":"Rectify a SpatRaster — rectify","text":"Rectify rotated SpatRaster non-rotated object","code":""},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rectify a SpatRaster — rectify","text":"","code":"# S4 method for SpatRaster rectify(x, method=\"bilinear\", aoi=NULL, snap=TRUE,          filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rectify a SpatRaster — rectify","text":"x SpatRaster rectified method character. Method used resampling. See resample aoi SpatExtent SpatRaster crop x smaller area interest; Using SpatRaster allowing set exact output extent output resolution snap logical. TRUE, origin resolution output case aoi = NULL. relevant aoi SpatExtent filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rectify a SpatRaster — rectify","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":null,"dir":"Reference","previous_headings":"","what":"Cell level regression — regress","title":"Cell level regression — regress","text":"Run regression model cell SpatRaster. independent variable can either defined vector, another SpatRaster make spatially variable.","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cell level regression — regress","text":"","code":"# S4 method for SpatRaster,numeric regress(y, x, formula=y~x, na.rm=FALSE, cores=1, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatRaster,SpatRaster regress(y, x, formula=y~x, na.rm=FALSE, cores=1, filename=\"\", overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cell level regression — regress","text":"y SpatRaster x SpatRaster numeric (length nlyr(x) formula regression formula general form y ~ x. can add additional terms (x^2) na.rm logical. Remove NA values? cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object. filename character. Output filename overwrite logical. TRUE, filename overwritten ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cell level regression — regress","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cell level regression — regress","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- regress(s, 1:nlyr(s))"},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial relationships between geometries — relate","title":"Spatial relationships between geometries — relate","text":"relate returns logical matrix indicating presence absence specific spatial relationships geometries x y. .related returns logical vector indicating presence absence specific spatial relationships x geometries y","code":""},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial relationships between geometries — relate","text":"","code":"# S4 method for SpatVector,SpatVector relate(x, y, relation, pairs=FALSE, na.rm=TRUE)  # S4 method for SpatVector,missing relate(x, y, relation, pairs=FALSE, na.rm=TRUE)  # S4 method for SpatVector,SpatVector is.related(x, y, relation)"},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial relationships between geometries — relate","text":"x SpatVector SpatExtent y missing x relation character. One \"intersects\", \"touches\", \"crosses\", \"overlaps\", \"within\", \"contains\", \"covers\", \"coveredby\", \"disjoint\". \"DE-9IM\" string \"FF*FF****\". See wikipedia geotools doc pairs logical. TRUE two-column matrix returned indices cases requested relation TRUE. especially helpful dealing many geometries returned value generally much smaller na.rm logical. TRUE pairs=TRUE, geometries x related geometry y omitted","code":""},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial relationships between geometries — relate","text":"matrix (relate) vector (.related)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial relationships between geometries — relate","text":"","code":"# polygons p1 <- vect(\"POLYGON ((0 0, 8 0, 8 9, 0 9, 0 0))\") p2 <- vect(\"POLYGON ((5 6, 15 6, 15 15, 5 15, 5 6))\") p3 <- vect(\"POLYGON ((8 2, 9 2, 9 3, 8 3, 8 2))\") p4 <- vect(\"POLYGON ((2 6, 3 6, 3 8, 2 8, 2 6))\") p5 <- vect(\"POLYGON ((2 12, 3 12, 3 13, 2 13, 2 12))\") p6 <- vect(\"POLYGON ((10 4, 12 4, 12 7, 11 7, 11 6, 10 6, 10 4))\")  p <- rbind(p1, p2, p3, p4, p5, p6) plot(p, col=rainbow(6, alpha=.5)) lines(p, lwd=2) text(p)   ## relate SpatVectors relate(p1, p2, \"intersects\") #>      [,1] #> [1,] TRUE relate(p1, p3, \"touches\") #>      [,1] #> [1,] TRUE relate(p1, p5, \"disjoint\") #>      [,1] #> [1,] TRUE relate(rbind(p1, p2), p4, \"disjoint\") #>       [,1] #> [1,] FALSE #> [2,]  TRUE  ## relate geometries within SpatVectors # which are completely separated? relate(p, relation=\"disjoint\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,] FALSE FALSE FALSE FALSE  TRUE  TRUE #> [2,] FALSE FALSE  TRUE  TRUE  TRUE FALSE #> [3,] FALSE  TRUE FALSE  TRUE  TRUE  TRUE #> [4,] FALSE  TRUE  TRUE FALSE  TRUE  TRUE #> [5,]  TRUE  TRUE  TRUE  TRUE FALSE  TRUE #> [6,]  TRUE FALSE  TRUE  TRUE  TRUE FALSE  # which touch (not overlap or within)? relate(p, relation=\"touches\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,] FALSE FALSE  TRUE FALSE FALSE FALSE #> [2,] FALSE FALSE FALSE FALSE FALSE FALSE #> [3,]  TRUE FALSE FALSE FALSE FALSE FALSE #> [4,] FALSE FALSE FALSE FALSE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE FALSE FALSE #> [6,] FALSE FALSE FALSE FALSE FALSE FALSE # which overlap (not merely touch, and not within)? relate(p, relation=\"overlaps\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,] FALSE  TRUE FALSE FALSE FALSE FALSE #> [2,]  TRUE FALSE FALSE FALSE FALSE  TRUE #> [3,] FALSE FALSE FALSE FALSE FALSE FALSE #> [4,] FALSE FALSE FALSE FALSE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE FALSE FALSE #> [6,] FALSE  TRUE FALSE FALSE FALSE FALSE # which are within (not merely overlap)? relate(p, relation=\"within\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,]  TRUE FALSE FALSE FALSE FALSE FALSE #> [2,] FALSE  TRUE FALSE FALSE FALSE FALSE #> [3,] FALSE FALSE  TRUE FALSE FALSE FALSE #> [4,]  TRUE FALSE FALSE  TRUE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE  TRUE FALSE #> [6,] FALSE FALSE FALSE FALSE FALSE  TRUE  # do they touch or overlap or are within? relate(p, relation=\"intersects\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,]  TRUE  TRUE  TRUE  TRUE FALSE FALSE #> [2,]  TRUE  TRUE FALSE FALSE FALSE  TRUE #> [3,]  TRUE FALSE  TRUE FALSE FALSE FALSE #> [4,]  TRUE FALSE FALSE  TRUE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE  TRUE FALSE #> [6,] FALSE  TRUE FALSE FALSE FALSE  TRUE  all(relate(p, relation=\"intersects\") ==    (relate(p, relation=\"overlaps\") |     relate(p, relation=\"touches\") |    relate(p, relation=\"within\"))) #> [1] FALSE  #for polygons, \"coveredby\" is \"within\" relate(p, relation=\"coveredby\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,]  TRUE FALSE FALSE FALSE FALSE FALSE #> [2,] FALSE  TRUE FALSE FALSE FALSE FALSE #> [3,] FALSE FALSE  TRUE FALSE FALSE FALSE #> [4,]  TRUE FALSE FALSE  TRUE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE  TRUE FALSE #> [6,] FALSE FALSE FALSE FALSE FALSE  TRUE  # polygons, lines, and points   pp <- rbind(p1, p2) L1 <- vect(\"LINESTRING(1 11, 4 6, 10 6)\") L2 <- vect(\"LINESTRING(8 14, 12 10)\") L3 <- vect(\"LINESTRING(1 8, 12 14)\") lns <- rbind(L1, L2, L3) pts <- vect(cbind(c(7,10,10), c(3,5,6)))  plot(pp, col=rainbow(2, alpha=.5)) text(pp, paste0(\"POL\", 1:2), halo=TRUE) lines(pp, lwd=2) lines(lns, col=rainbow(3), lwd=4) text(lns, paste0(\"L\", 1:3), halo=TRUE) points(pts, cex=1.5) text(pts, paste0(\"PT\", 1:3), halo=TRUE, pos=4)    relate(lns, relation=\"crosses\") #>       [,1]  [,2]  [,3] #> [1,] FALSE FALSE  TRUE #> [2,] FALSE FALSE  TRUE #> [3,]  TRUE  TRUE FALSE relate(lns, pp, relation=\"crosses\")  #>       [,1]  [,2] #> [1,]  TRUE FALSE #> [2,] FALSE FALSE #> [3,]  TRUE  TRUE relate(lns, pp, relation=\"touches\")  #>       [,1]  [,2] #> [1,] FALSE  TRUE #> [2,] FALSE FALSE #> [3,] FALSE FALSE relate(lns, pp, relation=\"intersects\")  #>       [,1] [,2] #> [1,]  TRUE TRUE #> [2,] FALSE TRUE #> [3,]  TRUE TRUE  relate(lns, pp, relation=\"within\") #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE  TRUE #> [3,] FALSE FALSE # polygons can contain lines or points, not the other way around relate(lns, pp, relation=\"contains\")  #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE FALSE #> [3,] FALSE FALSE relate(pp, lns, relation=\"contains\")  #>       [,1]  [,2]  [,3] #> [1,] FALSE FALSE FALSE #> [2,] FALSE  TRUE FALSE # points and lines can be covered by polygons relate(lns, pp, relation=\"coveredby\") #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE  TRUE #> [3,] FALSE FALSE  relate(pts, pp, \"within\") #>       [,1]  [,2] #> [1,]  TRUE FALSE #> [2,] FALSE FALSE #> [3,] FALSE FALSE relate(pts, pp, \"touches\") #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE FALSE #> [3,] FALSE  TRUE relate(pts, lns, \"touches\") #>       [,1]  [,2]  [,3] #> [1,] FALSE FALSE FALSE #> [2,] FALSE FALSE FALSE #> [3,]  TRUE FALSE FALSE"},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":null,"dir":"Reference","previous_headings":"","what":"Replicate layers — rep","title":"Replicate layers — rep","text":"Replicate layers SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replicate layers — rep","text":"","code":"# S4 method for SpatRaster rep(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replicate layers — rep","text":"x SpatRaster ... arguments rep","code":""},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replicate layers — rep","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replicate layers — rep","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- rep(s, 2) nlyr(x) #> [1] 6 names(x) #> [1] \"red\"   \"green\" \"blue\"  \"red\"   \"green\" \"blue\"  x #> class       : SpatRaster  #> dimensions  : 77, 101, 6  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green, blue, red, green, blue  #> min values  :   0,     0,    0,   0,     0,    0  #> max values  : 255,   255,  255, 255,   255,  255"},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace with $<- — replace_dollar","title":"Replace with $<- — replace_dollar","text":"Replace layer SpatRaster, attribute variable SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace with $<- — replace_dollar","text":"","code":"# S4 method for SpatRaster $(x, name) <- value  # S4 method for SpatVector $(x, name)<-value  # S4 method for SpatExtent $(x, name) <- value"},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace with $<- — replace_dollar","text":"x SpatRaster, SpatVector SpatExtent name character. x SpatRaster: layer name. x SpatVector: variable name. x SpatExtent: \"xmin\", \"xmax\". \"ymin\" \"ymax\" value x SpatRaster, SpatRaster TRUE: nlyr(value) == length(); x SpatVector, vector new values; x SpatExtent single number","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace with $<- — replace_dollar","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace with $<- — replace_dollar","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$ID_1 <- LETTERS[1:12] v$new <- sample(12) values(v) #>    ID_1       NAME_1 ID_2           NAME_2 AREA    POP new #> 1     A     Diekirch    1         Clervaux  312  18081  12 #> 2     B     Diekirch    2         Diekirch  218  32543   5 #> 3     C     Diekirch    3          Redange  259  18664  10 #> 4     D     Diekirch    4          Vianden   76   5163   4 #> 5     E     Diekirch    5            Wiltz  263  16735   9 #> 6     F Grevenmacher    6       Echternach  188  18899   1 #> 7     G Grevenmacher    7           Remich  129  22366   2 #> 8     H Grevenmacher   12     Grevenmacher  210  29828   3 #> 9     I   Luxembourg    8         Capellen  185  48187  11 #> 10    J   Luxembourg    9 Esch-sur-Alzette  251 176820   6 #> 11    K   Luxembourg   10       Luxembourg  237 182607   7 #> 12    L   Luxembourg   11           Mersch  233  32112   8"},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace layers or variables — replace_layers","title":"Replace layers or variables — replace_layers","text":"Replace layers SpatRaster (layers ) another SpatRaster replace variables SpatVector. can also create new layers/variables methods.","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace layers or variables — replace_layers","text":"","code":"# S4 method for SpatRaster,numeric [[(x, i) <- value  # S4 method for SpatRaster,character [[(x, i) <- value  # S4 method for SpatVector,numeric [[(x, i) <- value  # S4 method for SpatVector,character [[(x, i) <- value"},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace layers or variables — replace_layers","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace layers or variables — replace_layers","text":"x SpatRaster SpatVector x SpatRaster: layer number(s) name(s). x SpatVector: variable  number(s) name(s) (column attributes) value x SpatRaster: SpatRaster TRUE: nlyr(value) == length(). x SpatVector: vector data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace layers or variables — replace_layers","text":"","code":"# raster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s[[\"red\"]] <- mean(s) s[[2]] <- sqrt(s[[1]])  # vector v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[[\"ID_1\"]] <- 12:1"},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace values of a SpatRaster — replace_values","title":"Replace values of a SpatRaster — replace_values","text":"Replace values SpatRaster. convenience functions smaller objects . larger rasters see link{classify} subst","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace values of a SpatRaster — replace_values","text":"","code":"# S4 method for SpatRaster,ANY,ANY,ANY [(x, i, j, k) <- value  # S4 method for SpatVector,ANY,ANY [(x, i, j) <- value  # S4 method for SpatExtent,numeric,missing [(x, i, j) <- value"},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace values of a SpatRaster — replace_values","text":"x SpatRaster row numbers. numeric, logical, missing rows. Can also SpatRaster SpatVector j column numbers. numeric, logical missing columns k layer number. numeric, logical missing layers value numeric, matrix, data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace values of a SpatRaster — replace_values","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace values of a SpatRaster — replace_values","text":"","code":"## SpatRaster r <- rast(ncols=5, nrows=5, xmin=0, xmax=5, ymin=0, ymax=5) r[] <- 1:25 r[1,] <- 5 r[,2] <- 10 r[r>10] <- NA  ## SpatVector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v[2,2] <- \"hello\" v[1,] <- v[10,] v[,3] <- v[,1] v[2, \"NAME_2\"] <- \"terra\" head(v, 3) #>   ID_1     NAME_1 ID_2           NAME_2 AREA    POP #> 1    3 Luxembourg    3 Esch-sur-Alzette  251 176820 #> 2    1      hello    1            terra  218  32543 #> 3    1   Diekirch    1          Redange  259  18664"},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":null,"dir":"Reference","previous_headings":"","what":"Transfer values of a SpatRaster to another one with a different geometry — resample","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"resample transfers values SpatRaster objects align (different origin /resolution). See project change coordinate reference system (crs). origin extent input output , consider using functions instead: aggregate, disagg, extend crop.","code":""},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"","code":"# S4 method for SpatRaster,SpatRaster resample(x, y, method, threads=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"x SpatRaster resampled y SpatRaster geometry x resampled method character. Method used estimating new cell values. One : near: nearest neighbor. method fast, can preferred method cell values represent classes. good choice continuous values. used default first layer x categorical. bilinear: bilinear interpolation. default first layer x numeric (categorical). cubic: cubic interpolation. cubicspline: cubic spline interpolation. lanczos: Lanczos windowed sinc resampling. sum: weighted sum non-NA contributing grid cells. min, q1, med, q3, max, average, mode, rms: minimum, first quartile, median, third quartile, maximum, mean, mode, root-mean-square value non-NA contributing grid cells.  threads logical. TRUE multiple threads used (faster large files) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"","code":"r <- rast(nrows=3, ncols=3, xmin=0, xmax=10, ymin=0, ymax=10) values(r) <- 1:ncell(r) s <- rast(nrows=25, ncols=30, xmin=1, xmax=11, ymin=-1, ymax=11) x <- resample(r, s, method=\"bilinear\")  opar <- par(no.readonly =TRUE) par(mfrow=c(1,2)) plot(r) plot(x)  par(opar)"},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":null,"dir":"Reference","previous_headings":"","what":"rescale — rescale","title":"rescale — rescale","text":"Rescale SpatVector SpatRaster. may useful make small inset maps georeferencing.","code":""},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rescale — rescale","text":"","code":"# S4 method for SpatRaster rescale(x, fx=0.5, fy=fx, x0, y0)  # S4 method for SpatVector rescale(x, fx=0.5, fy=fx, x0, y0)"},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rescale — rescale","text":"x SpatVector SpatRaster fx numeric > 0. horizontal scaling factor fy numeric > 0. vertical scaling factor x0 numeric. x-coordinate center rescaling. missing, center extent x used y0 numeric. y-coordinate center rescaling. missing, center extent x used","code":""},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rescale — rescale","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"rescale — rescale","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- rescale(v, 0.2) plot(v) lines(w, col=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":null,"dir":"Reference","previous_headings":"","what":"Rolling (moving) functions — roll","title":"Rolling (moving) functions — roll","text":"Compute \"rolling\" \"moving\" values, \"rolling average\" cell SpatRaster. See focal spatially moving averages similar computations. see cumsum cum* functions compute cumulate values.","code":""},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rolling (moving) functions — roll","text":"","code":"# S4 method for SpatRaster roll(x, n, fun=mean, type=\"around\", circular=FALSE,       na.rm=FALSE, filename=\"\", ..., wopt=list())   # S4 method for numeric roll(x, n, fun=mean, type=\"around\", circular=FALSE, na.rm=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rolling (moving) functions — roll","text":"x SpatRaster numeric n integer > 1. size \"window\", , number sequential cells use fun fun function like mean, min, max, sum type character. One \"around\", \"\", \"\". choice indicates values used computation. focal cell always used. type \"around\", (n-1)/2 focal cell also included. type = \"\", n-1 cells focal cell included. type = \"\", n-1 cells focal cell included. example, using n=3 element 5 vector; \"around\" used elements 4,5,6; \"\" used elements 3,4,5, \"\" uses elements 5,6,7 circular logical. TRUE, data considered circular nature (e.g. days months year), missing values first last value. na.rm logical. TRUE, NA values ignored (fun) filename character. Output filename ... additional arguments fun wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rolling (moving) functions — roll","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rolling (moving) functions — roll","text":"","code":"## numeric roll(1:12, 3, mean) #>  [1] NA  2  3  4  5  6  7  8  9 10 11 NA roll(1:12, 3, mean, \"to\") #>  [1] NA NA  2  3  4  5  6  7  8  9 10 11 roll(1:12, 3, mean, circular=TRUE) #>  [1]  5  2  3  4  5  6  7  8  9 10 11  8  ## SpatRaster r <- rast(ncol=2, nrow=2, nlyr=10, vals=1) r[1,2] = 2 r[2,2] = 4  roll(r, n=3, \"sum\", \"from\", na.rm=FALSE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3   NaN    NaN #> [2,]     6     6     6     6     6     6     6     6   NaN    NaN #> [3,]     3     3     3     3     3     3     3     3   NaN    NaN #> [4,]    12    12    12    12    12    12    12    12   NaN    NaN roll(r, n=3, \"sum\", \"from\", na.rm=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3     2      1 #> [2,]     6     6     6     6     6     6     6     6     4      2 #> [3,]     3     3     3     3     3     3     3     3     2      1 #> [4,]    12    12    12    12    12    12    12    12     8      4 roll(r, n=3, \"sum\", \"from\", circular=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3     3      3 #> [2,]     6     6     6     6     6     6     6     6     6      6 #> [3,]     3     3     3     3     3     3     3     3     3      3 #> [4,]    12    12    12    12    12    12    12    12    12     12  roll(r, n=3, \"sum\", \"to\", na.rm=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     1     2     3     3     3     3     3     3     3      3 #> [2,]     2     4     6     6     6     6     6     6     6      6 #> [3,]     1     2     3     3     3     3     3     3     3      3 #> [4,]     4     8    12    12    12    12    12    12    12     12  roll(r, n=3, \"sum\", \"around\", circular=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3     3      3 #> [2,]     6     6     6     6     6     6     6     6     6      6 #> [3,]     3     3     3     3     3     3     3     3     3      3 #> [4,]    12    12    12    12    12    12    12    12    12     12"},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":null,"dir":"Reference","previous_headings":"","what":"Rotate data along longitude — rotate","title":"Rotate data along longitude — rotate","text":"Rotate SpatRaster longitude coordinates 0 360, standard coordinates -180 180 degrees (vice-versa). Longitude 0 360 frequently used global climate models. Rotate SpatVector SpatRaster split=TRUE, correct coordinates connected across date line (end \"side\" longitude scale) reconnected.","code":""},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rotate data along longitude — rotate","text":"","code":"# S4 method for SpatRaster rotate(x, left=TRUE, filename=\"\", ...)  # S4 method for SpatVector rotate(x, longitude=0, split=FALSE, left=TRUE, normalize=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rotate data along longitude — rotate","text":"x SpatRaster SpatVector left logical. TRUE, rotate left, else right filename character. Output filename ... additional arguments writing files writeRaster longitude numeric. longitude around rotate split logical. geometries split longitude? normalize logical. output normalized longitudes -180 180? See normalize.longitude","code":""},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rotate data along longitude — rotate","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rotate data along longitude — rotate","text":"","code":"x <- rast(nrows=9, ncols=18, nl=3, xmin=0, xmax=360) v <- rep(as.vector(t(matrix(1:ncell(x), nrow=9, ncol=18))), 3) values(x) <- v z <- rotate(x)  if (FALSE) { #SpatVector p <- rbind(c(3847903, 1983584 ), c(3847903, 5801864), c(8301883, 5801864), c(8301883, 1983584 )) p <- vect(p, \"polygons\", crs=\"+init=EPSG:3347\") d <- densify(p, 100000) g <- project(d, \"+proj=longlat\")  x <- rotate(g, 50) plot(g) lines(x, col=\"red\") }  ## rotate countries to 0-360 longitude #w <- geodata::world(path=\".\") #x <- rotate(w, long=0, split=TRUE, left=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare coordinate reference systems — same.crs","title":"Compare coordinate reference systems — same.crs","text":"function takes two coordinate reference system descriptions compares equality.","code":""},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare coordinate reference systems — same.crs","text":"","code":"same.crs(x, y)"},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare coordinate reference systems — same.crs","text":"x character, SpatRaster, SpatVector, CRS, object returns something intelligible withcrs(x) y types x","code":""},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare coordinate reference systems — same.crs","text":"logical","code":""},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare coordinate reference systems — same.crs","text":"","code":"r <- rast() same.crs(r, \"+proj=longlat\") #> [1] TRUE  same.crs(r, \"+proj=utm +zone=1\") #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":null,"dir":"Reference","previous_headings":"","what":"Take a regular sample — spatSample","title":"Take a regular sample — spatSample","text":"Take spatial sample SpatRaster, SpatVector SpatExtent. Sampling SpatVector SpatExtent always returns SpatVector points. SpatRaster, can get cell values, cell numbers (cells=TRUE), coordinates (xy=TRUE) (method=\"regular\" .raster=TRUE) get new SpatRaster extent, fewer cells. order assure regularity requesting regular sample, number cells points returned may exactly size requested.","code":""},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Take a regular sample — spatSample","text":"","code":"# S4 method for SpatRaster spatSample(x, size, method=\"random\", replace=FALSE, na.rm=FALSE,      as.raster=FALSE, as.df=TRUE, as.points=FALSE, values=TRUE, cells=FALSE,      xy=FALSE, ext=NULL, warn=TRUE, weights=NULL, exp=5, exhaustive=FALSE)  # S4 method for SpatVector spatSample(x, size, method=\"random\", strata=NULL, chess=\"\")  # S4 method for SpatExtent spatSample(x, size, method=\"random\", lonlat, as.points=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Take a regular sample — spatSample","text":"x SpatRaster, SpatVector SpatExtent size numeric. sample size. x SpatVector, can also provide vector length x case sampling done separately geometry. x SpatRaster, using method=\"regular\" can specify size two numbers (number rows columns) method character. \"regular\" \"random\", x SpatRaster, can also \"stratified\" (value x stratum) \"weights\" (value x probability weight) replace logical. TRUE, sampling replacement (method=\"random\") na.rm logical. TRUE, NAs removed. used random sampling cell values. method=\"random\", .raster=FALSE, cells=FALSE .raster logical. TRUE, SpatRaster returned .df logical. TRUE, data.frame returned instead matrix .points logical. TRUE, SpatVector points returned values logical. TRUE raster cell values returned cells logical. TRUE, cell numbers returned. method=\"stratified\" always set TRUE xy=FALSE xy logical. TRUE, cell coordinates returned ext SpatExtent NULL restrict sampling subset area x warn logical. Give warning sample size returned smaller requested weights SpatRaster. Used provide weights method=\"stratified\" strata NULL, stratified random sampling done, taking size samples stratum. x polygon geometry, strata must field name (index) x. x point geometry, strata can SpatVector polygons SpatRaster chess character. One \"\", \"white\", \"black\". stratified sampling strata SpatRaster. \"\", samples taken alternate cells, organized like \"white\" \"black\" fields chessboard lonlat logical. TRUE, sampling SpatExtent weighted cos(latitude). SpatRaster SpatVector done based crs, ignored .raster=TRUE exp numeric >= 1. \"Expansion factor\" multiplied size get initial sample used stratified samples random samples na.rm=TRUE try get least size samples exhaustive logical. TRUE na.rm=TRUE first cells NA determined sample taked cells. useful dealing large raster sparse (cells NA). Otherwise, default approach may find enough samples. used cases, especially large rasters mostly values","code":""},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Take a regular sample — spatSample","text":"numeric matrix, data.frame, SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Take a regular sample — spatSample","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) s <- spatSample(r, 10, as.raster=TRUE) spatSample(r, 5) #>   elevation #> 1       288 #> 2        NA #> 3       497 #> 4        NA #> 5        NA spatSample(r, 5, na.rm=TRUE) #>   elevation #> 1       458 #> 2       269 #> 3       271 #> 4       142 #> 5       202 spatSample(r, 5, \"regular\") #>   elevation #> 1       479 #> 2       NaN #> 3       NaN #> 4       419 #> 5       290 #> 6       306 #> 7       281 #> 8       286 #> 9       NaN  ## if you require cell numbers and/or coordinates size <- 6 spatSample(r, 6, \"random\", cells=TRUE, xy=TRUE, values=FALSE) #>      cell        x        y #> [1,] 5800 5.779167 49.67917 #> [2,] 7874 6.437500 49.50417 #> [3,]  843 6.429167 50.12083 #> [4,]  426 6.120833 50.15417 #> [5,] 2775 5.904167 49.94583 #> [6,] 2267 6.420833 49.99583  # regular, with values  spatSample(r, 6, \"regular\", cells=TRUE, xy=TRUE) #>   cell        x        y elevation #> 1 7458 6.137500 49.53750       264 #> 2 7505 6.529167 49.53750        NA #> 3 7411 5.745833 49.53750        NA #> 4 5368 6.137500 49.72083       289 #> 5 5415 6.529167 49.72083        NA #> 6 5321 5.745833 49.72083        NA #> 7 3183 6.137500 49.91250       322 #> 8 1093 6.137500 50.09583        NA  # stratified rr <- rast(ncol=10, nrow=10, names=\"stratum\") set.seed(1) values(rr) <- round(runif(ncell(rr), 1, 3)) spatSample(rr, 2, \"stratified\", xy=TRUE) #>      x   y stratum #> 1 -126  63       1 #> 2  126 -27       1 #> 3  126  27       2 #> 4 -162  81       2 #> 5   18 -45       3 #> 6  -18  27       3  s <- spatSample(rr, 5, \"stratified\", as.points=TRUE) plot(rr, plg=list(title=\"raster\")) plot(s, 1, add=TRUE, plg=list(x=185, y=1, title=\"points\"))    ## SpatExtent  e <- ext(r) spatSample(e, 10, \"random\", lonlat=TRUE) #>              x        y #>  [1,] 6.362453 49.60080 #>  [2,] 6.214008 50.07085 #>  [3,] 5.841767 49.53690 #>  [4,] 5.832523 50.14225 #>  [5,] 6.160047 49.56096 #>  [6,] 6.504415 49.51819 #>  [7,] 6.188561 49.58855 #>  [8,] 6.299401 49.90880 #>  [9,] 6.361697 49.46779 #> [10,] 6.250035 49.81599  ## SpatVector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  # sample the geometries  i <- sample(v, 3)  # sample points in geometries p <- spatSample(v, 3)"},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"Apply layers SpatRaster function takes single layer SpatRaster returns SpatRaster (rare). cases can also use lapply sapply . apply method sub-dataset (SpatRaster) SpatRasterDataset","code":""},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"","code":"# S4 method for SpatRaster sapp(x, fun, ..., filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterDataset sapp(x, fun, ..., filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"x SpatRaster SpatRasterDataset fun x SpatRaster: function takes SpatRaster argument can applied layer x (e.g. terrain.    x SpatRasterDataset: function applied layers SpatRasters x (e.g. mean ... additional arguments passed fun filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) + 1    #SpatRasterDataset sd <- sds(s*2, s/2) y <- sapp(sd, mean) z <- sapp(sd, \\(i) 2 * mean(i))"},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":null,"dir":"Reference","previous_headings":"","what":"scale bar — sbar","title":"scale bar — sbar","text":"Add scale bar map","code":""},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"scale bar — sbar","text":"","code":"sbar(d, xy=NULL, type=\"line\", divs=2, below=\"\", lonlat=NULL, labels,   adj=c(0.5, -1), lwd=2, xpd=TRUE, ticks=FALSE, scaleby=1, halo=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"scale bar — sbar","text":"d numeric. Distance covered scale bar. scale bar, units coordinates plot (map), km angular (longitude/latitude) data; see argument lonlat. can also missing xy numeric. x y coordinate place scale bar. can also one following character values: \"bottomleft\", \"bottom\", \"bottomright\", topleft\", \"top\", \"topright\", \"left\", \"right\", NULL type sbar: \"line\" \"bar\" divs number divisions bar: 2 4 character. Text go scale bar (e.g., \"kilometers\") lonlat logical NULL. logical, TRUE indicates plot using longitude/latitude coordinates. NULL guessed plot's coordinates labels vector three numbers label scale bar (beginning, midpoint, end) adj adjustment text placement lwd line width \"line\" type scale bar xpd logical. TRUE, scale bar can outside plotting area ticks logical numeric. FALSE, tick marks added \"line\" scale bar. length tick marks can specified scaleby numeric. labels provided. labels divided number. example, use 1000 go m km halo logical. TRUE \"line\" type scale bar gets white background ... graphical arguments passed methods","code":""},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"scale bar — sbar","text":"none","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"scale bar — sbar","text":"","code":"f <- system.file(\"ex/meuse.tif\", package=\"terra\") r <- rast(f) plot(r) sbar() sbar(1000, xy=c(178500, 333500), type=\"bar\", divs=4, cex=.8) sbar(1000, xy=\"bottomright\", divs=3, cex=.8, ticks=TRUE) north(d=250, c(178550, 332500))    f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) plot(r, type=\"interval\") sbar(20, c(6.2, 50.1), type=\"bar\", cex=.8, divs=4) sbar(15, c(6.3, 50), type=\"bar\", below=\"km\", label=c(0,7.5,15), cex=.8) sbar(15, c(6.65, 49.8), cex=.8, label=c(0,\"km\",15)) north(type=2) sbar(15, c(6.65, 49.7), cex=.8, label=\"15 kilometer\", lwd=5) sbar(15, c(6.65, 49.6), divs=4, cex=.8, below=\"km\")"},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":null,"dir":"Reference","previous_headings":"","what":"Scale values — scale","title":"Scale values — scale","text":"Center /scale raster data. details see scale","code":""},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scale values — scale","text":"","code":"# S4 method for SpatRaster scale(x, center=TRUE, scale=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scale values — scale","text":"x SpatRaster center logical numeric. TRUE, centering done subtracting layer means (omitting NAs), FALSE, centering done. center numeric vector (recycled nlyr(x)), layer x corresponding value center subtracted . scale logical numeric. TRUE, scaling done dividing (centered) layers x standard deviations center TRUE, root mean square otherwise. scale FALSE, scaling done. scale numeric vector (recycled nlyr(x)), layer x divided corresponding value. Scaling done centering.","code":""},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Scale values — scale","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Scale values — scale","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s <- scale(r)  ## the equivalent, computed in steps m <- global(r, \"mean\") rr <- r - m[,1] rms <- global(rr, \"rms\") ss <- rr / rms[,1]"},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":null,"dir":"Reference","previous_headings":"","what":"Scatterplot of two SpatRaster layers — scatterplot","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"Scatterplot values two SpatRaster layers","code":""},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"","code":"# S4 method for SpatRaster,SpatRaster plot(x, y, maxcell=100000, warn=TRUE, nc, nr,     maxnl=16, smooth=FALSE, gridded=FALSE, ncol=25, nrow=25, ...)"},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"x SpatRaster y SpatRaster maxcell positive integer. Maximum number cells use plot nc positive integer. Optional. number columns divide plotting device (plotting multiple layers) nr positive integer. Optional. number rows divide plotting device (plotting multiple layers) maxnl positive integer. Maximum number layers plot (multi-layer objects) smooth logical. TRUE show smooth scatterplot gridded logical. TRUE scatterplot gridded (counts cells) warn boolean. Show warning sample pixels used (scatterplot ) ncol positive integer. Number columns gridding nrow positive integer. Number rows gridding ... additional graphical arguments","code":""},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    plot(s[[1]], s[[2]])  plot(s, sqrt(s[[3:1]]))"},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":null,"dir":"Reference","previous_headings":"","what":"Scale (gain) and offset — scoff","title":"Scale (gain) and offset — scoff","text":"functions can used get set scale (gain) offset parameters used transform values reading raster data file. parameters applied raw values using formula : value <- value * scale + offset default value scale 1 offset 0. 'scale' sometimes referred 'gain'. Note setting scale /offset intended used values stored file. values memory, assigning scale offset values lead immediate computation new values; cases clearer use Arith-methods.","code":""},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scale (gain) and offset — scoff","text":"","code":"# S4 method for SpatRaster scoff(x)  # S4 method for SpatRaster scoff(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scale (gain) and offset — scoff","text":"x SpatRaster value two-column matrix scale (first column) offset (second column) layer. NULL remove scale offset values","code":""},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Scale (gain) and offset — scoff","text":"matrix changed SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Scale (gain) and offset — scoff","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) minmax(r) #>     elevation #> min       141 #> max       547 scoff(r) #>      scale offset #> [1,]     1      0 r[4603] #>   elevation #> 1       279  scoff(r) <- cbind(10, 5) minmax(r) #>     elevation #> min      1415 #> max      5475 scoff(r) #>      scale offset #> [1,]    10      5 r[4603] #>   elevation #> 1      2795"},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatRasterDataset — sds","title":"Create a SpatRasterDataset — sds","text":"Methods create SpatRasterDataset. object hold \"sub-datasets\", SpatRaster cases multiple layers. See describe getting information sub-datasets present file.","code":""},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatRasterDataset — sds","text":"","code":"# S4 method for missing sds(x)   # S4 method for character sds(x, ids=0, opts=NULL, raw=FALSE)  # S4 method for SpatRaster sds(x, ...)   # S4 method for list sds(x)   # S4 method for array sds(x, crs=\"\", extent=NULL)"},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatRasterDataset — sds","text":"x character (filename), SpatRaster, list SpatRasters, missing. multiple filenames provided, attempted make SpatRasters , combine SpatRasterDataset ids optional. vector integer subdataset ids. Ignored first value positive integer opts character. GDAL dataset open options raw logical. TRUE, scale offset values ignored crs character. Description Coordinate Reference System (map projection) PROJ.4, WKT authority:code notation. argument missing, x coordinates within -360 .. 360 y coordinates within -90 .. 90, longitude/latitude assigned extent SpatExtent ... additional SpatRaster objects","code":""},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatRasterDataset — sds","text":"SpatRasterDataset","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatRasterDataset — sds","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- sds(s, s/2) names(x) <- c(\"first\", \"second\") x #> class       : SpatRasterDataset  #> subdatasets : 2  #> dimensions  : 77, 101 (nrow, ncol) #> nlyr        : 3, 3  #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : logo.tif, memory  #> names       : first, second  length(x) #> [1] 2  # extract the second SpatRaster x[2] #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> names       :   red, green,  blue  #> min values  :   0.0,   0.0,   0.0  #> max values  : 127.5, 127.5, 127.5   a <- array(1:9, c(3,3,3,3)) sds(a) #> class       : SpatRasterDataset  #> subdatasets : 3  #> dimensions  : 3, 3 (nrow, ncol) #> nlyr        : 3, 3, 3  #> resolution  : 1, 1  (x, y) #> extent      : 0, 3, 0, 3  (xmin, xmax, ymin, ymax) #> coord. ref. :   #> source(s)   : memory"},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":null,"dir":"Reference","previous_headings":"","what":"segregate — segregate","title":"segregate — segregate","text":"Create SpatRaster layer class (value, subset values) input SpatRaster. example, input vegetation types, function create layer (presence/absence; dummy variable) classes. called \"one-hot encoding\" \"dummy encoding\" (dummy encoding scheme can remove () one output layers redundant).","code":""},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"segregate — segregate","text":"","code":"# S4 method for SpatRaster segregate(x, classes=NULL, keep=FALSE, other=0, round=FALSE, digits=0, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"segregate — segregate","text":"x SpatRaster classes numeric. values (classes) layers made. NULL classes used keep logical. TRUE, cells class represented layer get value, rather value 1 numeric. Value assign cells class represented layer round logical. values rounded first? digits integer. Number digits round values filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"segregate — segregate","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"segregate — segregate","text":"","code":"r <- rast(nrows=5, ncols=5) values(r) <- rep(c(1:4, NA), each=5) b <- segregate(r) bb <- segregate(r, keep=TRUE, other=NA)"},{"path":"https://rspatial.github.io/terra/reference/select.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial selection — sel","title":"Spatial selection — sel","text":"Geometrically subset SpatRaster SpatVector (done) drawing plot (map).","code":""},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial selection — sel","text":"","code":"# S4 method for SpatRaster sel(x, ...)  # S4 method for SpatVector sel(x, use=\"rec\", show=TRUE, col=\"cyan\", draw=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial selection — sel","text":"x SpatRaster SpatVector use character indicating draw. One \"rec\" (rectangle) \"pol\" (polygon) show logical. TRUE selected geometries shown map col color used drawing draw=TRUE draw logical. TRUE area drawn select geometries shown map ... additional graphics arguments drawing selected geometries","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial selection — sel","text":"SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial selection — sel","text":"","code":"if (FALSE) { # select a subset of a SpatRaster r <- rast(nrows=10, ncols=10) values(r) <- 1:ncell(r) plot(r) s <- sel(r) # now click on the map twice  # plot the selection on a new canvas: x11() plot(s)  # vector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) plot(v) x <- sel(v) # now click on the map twice x }"},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":null,"dir":"Reference","previous_headings":"","what":"select cells with high or low values — selectHighest","title":"select cells with high or low values — selectHighest","text":"Identify n cells highest lowest values first layer SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"select cells with high or low values — selectHighest","text":"","code":"# S4 method for SpatRaster selectHighest(x, n, low=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"select cells with high or low values — selectHighest","text":"x SpatRaster. first layer processed n number cells select low logical. TRUE, lowest values selected instead highest values","code":""},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"select cells with high or low values — selectHighest","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"select cells with high or low values — selectHighest","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- selectHighest(r, 1000) y <- selectHighest(r, 1000, TRUE)  m <- merge(y-1, x) levels(m) <- data.frame(id=0:1, elevation=c(\"low\", \"high\")) plot(m)"},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":null,"dir":"Reference","previous_headings":"","what":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"Use single layer SpatRaster select cell values different layers multi-layer SpatRaster. values SpatRaster select layers (y) whole numbers 1 nlyr(x) (values outside range ignored). See rapp applying function range variable size. See extract extraction values cell, point, otherwise.","code":""},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"","code":"# S4 method for SpatRaster selectRange(x, y, z=1, repint=0, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"x SpatRaster y SpatRaster. Cell values must positive integers. indicate first layer select cell z positive integer. number layers select repint integer > 1 < nlyr(x) allowing repeated selection fixed interval. example, x 36 layers, value cell y=2 repint = 12, values layers 2, 14 26 returned filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1 s <- c(r, r+2, r+5) s <- c(s, s) set.seed(1) values(r) <- sample(3, ncell(r), replace=TRUE) x <- selectRange(s, r)  x <- selectRange(s, r, 3)"},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":null,"dir":"Reference","previous_headings":"","what":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"serialize saveRDS SpatVector, SpatRaster, SpatRasterDataset SpatRasterCollection. Note objects first \"packed\" wrap, unserialize/readRDS need unpacked rast vect. Extensive use functions recommended. Especially SpatRaster generally much efficient use writeRaster write, e.g., GTiff file.","code":""},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"","code":"# S4 method for SpatRaster saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatRasterDataset saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatRasterCollection saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatVector saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatRaster serialize(object, connection, ascii = FALSE, xdr = TRUE, version = NULL, refhook = NULL)  # S4 method for SpatVector serialize(object, connection, ascii = FALSE, xdr = TRUE, version = NULL, refhook = NULL)"},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"object SpatVector, SpatRaster, SpatRasterDataset SpatRasterCollection file file name save object connection see serialize ascii see serialize saveRDS version see serialize saveRDS compress see serialize saveRDS refhook see serialize saveRDS xdr see serialize saveRDS","code":""},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"Packed* object","code":""},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) p <- serialize(v, NULL) head(p) #> [1] 58 0a 00 00 00 03 x <- unserialize(p) x #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664"},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":null,"dir":"Reference","previous_headings":"","what":"Set the values of raster cells or of geometry attributes — setValues","title":"Set the values of raster cells or of geometry attributes — setValues","text":"Set cell values SpatRaster attributes SpatVector. large SpatRasters use init instead set values.","code":""},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set the values of raster cells or of geometry attributes — setValues","text":"","code":"# S4 method for SpatRaster,ANY values(x)<-value  # S4 method for SpatRaster,ANY setValues(x, values, keeptime=TRUE, keepunits=TRUE, keepnames=FALSE, props=FALSE)  # S4 method for SpatVector,ANY values(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set the values of raster cells or of geometry attributes — setValues","text":"x SpatRaster SpatVector value SpatRaster: numeric, matrix data.frame. length numeric values must match total number cells (ncell(x) * nlyr(x)), single value. number columns matrix data.frame must match number layers x, number rows must match number cells x. also possible use matrix number rows x number columns matches ncol(x) * nlyr(x). SpatVector: data.frame, matrix, vector, NULL values value keeptime logical. TRUE time stamps kept keepunits logical. FALSE units discarded keepnames logical. FALSE layer names replaced column names y (present) props logical. TRUE properties (categories color-table) kept","code":""},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set the values of raster cells or of geometry attributes — setValues","text":"object type x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set the values of raster cells or of geometry attributes — setValues","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- setValues(r, 1:ncell(r)) x #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> name        : elevation  #> min value   :         1  #> max value   :      8550  values(x) <- runif(ncell(x)) x #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> name        :    elevation  #> min value   : 0.0001064336  #> max value   : 0.9999305937  head(x) #>    elevation #> 1 0.20754511 #> 2 0.22865814 #> 3 0.59571200 #> 4 0.57487220 #> 5 0.07706438 #> 6 0.03554058  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) values(v) <- data.frame(ID=1:12, name=letters[1:12]) head(v) #>   ID name #> 1  1    a #> 2  2    b #> 3  3    c #> 4  4    d #> 5  5    e #> 6  6    f"},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":null,"dir":"Reference","previous_headings":"","what":"Hill shading — shade","title":"Hill shading — shade","text":"Compute hill shade slope aspect layers (radians). Slope aspect can computed function terrain. hill shade layer often used backdrop top another, semi-transparent, layer drawn.","code":""},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Hill shading — shade","text":"","code":"shade(slope, aspect, angle=45, direction=0, normalize=FALSE,    filename=\"\", overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Hill shading — shade","text":"slope SpatRasterwith slope values (radians) aspect SpatRaster aspect values (radians) angle elevation angle(s) light source (sun), degrees direction direction (azimuth) angle(s) light source (sun), degrees normalize Logical. TRUE, values zero set zero results multiplied 255 filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Hill shading — shade","text":"Horn, B.K.P., 1981. Hill shading reflectance map. Proceedings IEEE 69(1):14-47","code":""},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Hill shading — shade","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) alt <- disagg(r, 10, method=\"bilinear\") slope <- terrain(alt, \"slope\", unit=\"radians\") aspect <- terrain(alt, \"aspect\", unit=\"radians\") hill <- shade(slope, aspect, 40, 270) plot(hill, col=grey(0:100/100), legend=FALSE, mar=c(2,2,1,4)) plot(alt, col=rainbow(25, alpha=0.35), add=TRUE)   # A better hill shade may be achieved by combining  # different angles and directions. For example  h <- shade(slope, aspect, angle = c(45, 45, 45, 80), direction = c(225, 270, 315, 135)) h <- Reduce(mean, h)"},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":null,"dir":"Reference","previous_headings":"","what":"Shared paths — sharedPaths","title":"Shared paths — sharedPaths","text":"Get shared paths line polygon geometries. can geometries single SpatVector, two SpatVectors","code":""},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Shared paths — sharedPaths","text":"","code":"# S4 method for SpatVector sharedPaths(x, y=NULL)"},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Shared paths — sharedPaths","text":"x SpatVector lines polygons y missing SpatVector lines polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Shared paths — sharedPaths","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Shared paths — sharedPaths","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) plot(v, col=\"light gray\") text(v, halo=TRUE)  x <- sharedPaths(v) lines(x, col=\"red\", lwd=2) text(x, col=\"blue\", halo=TRUE, cex=0.8)  head(x) #>   id1 id2 #> 1   1   2 #> 2   1   4 #> 3   1   5 #> 4   2   3 #> 5   2   4 #> 6   2   5  z <- sharedPaths(v[3,], v[12,])"},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":null,"dir":"Reference","previous_headings":"","what":"Shift — shift","title":"Shift — shift","text":"Shift SpatRaster, SpatVector SpatExtent another location.","code":""},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Shift — shift","text":"","code":"# S4 method for SpatRaster shift(x, dx=0, dy=0, filename=\"\", ...)  # S4 method for SpatVector shift(x, dx=0, dy=0)  # S4 method for SpatExtent shift(x, dx=0, dy=0)"},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Shift — shift","text":"x SpatRaster, SpatVector SpatExtent dx numeric. shift horizontal direction dy numeric. shift vertical direction filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Shift — shift","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Shift — shift","text":"","code":"r <- rast(xmin=0, xmax=1, ymin=0, ymax=1) r <- shift(r, dx=1, dy=-1)  e <- ext(r) shift(e, 5, 5) #> SpatExtent : 6, 7, 4, 5 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":null,"dir":"Reference","previous_headings":"","what":"Sieve filter — sieve","title":"Sieve filter — sieve","text":"Apply sieve filter. , remove \"noise\", changing small clumps cells value different surrounding cells, value largest neighboring clump. Note input raster data rounded integers.","code":""},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sieve filter — sieve","text":"","code":"# S4 method for SpatRaster sieve(x, threshold, directions=8, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sieve filter — sieve","text":"x SpatRaster, single layer elevation values. Values unit map units threshold positive integer. clumps smaller threshold removed directions numeric indicate cells connected. Either 4 consider horizontal vertical neighbors (\"rook\"), 8 consider vertical, horizontal diagonal neighbors filename character. Output filename ... Options writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Sieve filter — sieve","text":"","code":"r <- rast(nrows=18, ncols=18, xmin=0, vals=0, crs=\"local\") r[2, 5] <- 1 r[5:8, 2:3] <- 2 r[7:12, 10:15] <- 3 r[15:16, 15:18] <- 4 freq(r, bylayer=FALSE) #>   value count #> 1     0   271 #> 2     1     1 #> 3     2     8 #> 4     3    36 #> 5     4     8  x <- sieve(r, 8) y <- sieve(r, 9)"},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":null,"dir":"Reference","previous_headings":"","what":"simplifyGeom geometries — simplifyGeom","title":"simplifyGeom geometries — simplifyGeom","text":"Reduce number nodes used represent geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"simplifyGeom geometries — simplifyGeom","text":"","code":"# S4 method for SpatVector simplifyGeom(x, tolerance=0.1, preserveTopology=TRUE, makeValid=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"simplifyGeom geometries — simplifyGeom","text":"x SpatVector lines polygons tolerance numeric. minimum distance nodes units crs (.e. degrees long/lat) preserveTopology logical. TRUE topology output geometries preserved makeValid logical. TRUE, makeValid run simplification assure output polygons valid","code":""},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"simplifyGeom geometries — simplifyGeom","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"simplifyGeom geometries — simplifyGeom","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- simplifyGeom(v, .02, makeValid=FALSE) e <- erase(w) g <- gaps(e) plot(e, lwd=5, border=\"light gray\") polys(g, col=\"red\", border=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":null,"dir":"Reference","previous_headings":"","what":"Sort a SpatRaster or SpatVector — sort","title":"Sort a SpatRaster or SpatVector — sort","text":"Sort cell values SpatRaster across layers. can also compute sorting order. sort records SpatVector (data.frame) specifying column number(s) names(s) sort .","code":""},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sort a SpatRaster or SpatVector — sort","text":"","code":"# S4 method for SpatRaster sort(x, decreasing=FALSE, order=FALSE, filename=\"\", ...)  # S4 method for SpatVector sort(x, v, decreasing=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sort a SpatRaster or SpatVector — sort","text":"x SpatRaster decreasing logical. TRUE, sorting decreasing order order logical. TRUE sorting order returned instead sorted values filename character. Output filename ... additional arguments writing files writeRaster v character numeric indicating column(s) sort ","code":""},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sort a SpatRaster or SpatVector — sort","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Sort a SpatRaster or SpatVector — sort","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) r <- c(r, r/2, r*2) sort(r) #> class       : SpatRaster  #> dimensions  : 90, 95, 3  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> names       : elevation, elevation, elevation  #> min values  :      70.5,       141,       282  #> max values  :     273.5,       547,      1094   ord <- sort(r, order=TRUE) # these two are the same  ord[[1]] #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> name        : elevation  #> min value   :         0  #> max value   :         1  which.min(r) #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> name        : which.min  #> min value   :         2  #> max value   :         2"},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":null,"dir":"Reference","previous_headings":"","what":"Data sources of a SpatRaster — sources","title":"Data sources of a SpatRaster — sources","text":"Get data sources SpatRaster SpatVector related object. Sources either files (similar resources) \"\", meaning memory. can use hasValues check -memory layers actually cell values.","code":""},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data sources of a SpatRaster — sources","text":"","code":"# S4 method for SpatRaster sources(x, nlyr=FALSE, bands=FALSE)  # S4 method for SpatVector sources(x)  # S4 method for SpatRaster hasValues(x)  # S4 method for SpatRaster inMemory(x, bylayer=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Data sources of a SpatRaster — sources","text":"x SpatRaster, SpatRasterCollection, SpatVector SpatVectorProxy nlyr logical. TRUE source, number layers returned bands logical. TRUE source, \"bands\" used, , layer number source file, returned bylayer logical. TRUE value returned layer instead source","code":""},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Data sources of a SpatRaster — sources","text":"vector filenames, \"\" filename, nlyr bands FALSE. Otherwise data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data sources of a SpatRaster — sources","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) s <- rast(r) values(s) <- 1:ncell(s) rs <- c(r,r,s,r) sources(rs) #> [1] \"/Users/runner/work/_temp/Library/terra/ex/elev.tif\" #> [2] \"/Users/runner/work/_temp/Library/terra/ex/elev.tif\" #> [3] \"\"                                                   #> [4] \"/Users/runner/work/_temp/Library/terra/ex/elev.tif\" hasValues(r) #> [1] TRUE x <- rast() hasValues(x) #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":null,"dir":"Reference","previous_headings":"","what":"spin a SpatVector — spin","title":"spin a SpatVector — spin","text":"Spin (rotate) geometry SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"spin a SpatVector — spin","text":"","code":"# S4 method for SpatVector spin(x, angle, x0, y0)"},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"spin a SpatVector — spin","text":"x SpatVector angle numeric. Angle rotation degrees x0 numeric. x-coordinate center rotation. missing, center extent x used y0 numeric. y-coordinate center rotation. missing, center extent x used","code":""},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"spin a SpatVector — spin","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"spin a SpatVector — spin","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- spin(v, 180) plot(v) lines(w, col=\"red\")   # lower-right corner as center e <- as.vector(ext(v)) x <- spin(v, 45, e[1], e[3])"},{"path":"https://rspatial.github.io/terra/reference/split.html","id":null,"dir":"Reference","previous_headings":"","what":"Split — split","title":"Split — split","text":"Split SpatRaster layer, SpatVector attributes. can also split geometry polygon SpatVector another SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split — split","text":"","code":"# S4 method for SpatRaster,ANY split(x, f)  # S4 method for SpatVector,ANY split(x, f)  # S4 method for SpatVector,SpatVector split(x, f)"},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split — split","text":"x SpatRaster SpatVector f x SpatRaster: vector length nlyr(x). x SpatVector: field (variable) name vector length x; , x SpatVector polygons, SpatVector lines polygons split polygon geometries","code":""},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Split — split","text":"list SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split — split","text":"","code":"## split layers s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    y <- split(s, c(1,2,1)) sds(y) #> class       : SpatRasterDataset  #> subdatasets : 2  #> dimensions  : 77, 101 (nrow, ncol) #> nlyr        : 2, 1  #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : logo.tif   ## split attributes v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) x <- split(v, \"NAME_1\")  ## split geometries v <- v[1:5,] line <- vect(matrix(c(5.79, 6.22, 5.75, 6.1, 5.8,    50.14, 50.05, 49.88, 49.85, 49.71), ncol=2), \"line\") s <- split(v, line)"},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatRasterCollection — sprc","title":"Create a SpatRasterCollection — sprc","text":"Methods create SpatRasterCollection. object hold collection (list) SpatRasters. restrictions similarity SpatRaster geometry. can used combine several SpatRasters used merge mosaic can create SpatRasterCollection file subdatasets.","code":""},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatRasterCollection — sprc","text":"","code":"# S4 method for character sprc(x, ids=0, opts=NULL, raw=FALSE)   # S4 method for SpatRaster sprc(x, ...)   # S4 method for list sprc(x)   # S4 method for missing sprc(x)"},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatRasterCollection — sprc","text":"x SpatRaster, list SpatRasters, missing, filename ids optional. vector integer subdataset ids. Ignored first value positive integer opts character. GDAL dataset open options raw logical. TRUE, scale offset values ignored ... additional SpatRasters","code":""},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatRasterCollection — sprc","text":"SpatRasterCollection","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatRasterCollection — sprc","text":"","code":"x <- rast(xmin=-110, xmax=-50, ymin=40, ymax=70, ncols=60, nrows=30) y <- rast(xmin=-80, xmax=-20, ymax=60, ymin=30) res(y) <- res(x) values(x) <- 1:ncell(x) values(y) <- 1:ncell(y)  z <- sprc(x, y) z #> class       : SpatRasterCollection  #> length      : 2  #> nrow        : 30, 30  #> ncol        : 60, 60  #> nlyr        :  1,  1  #> extent      : -110, -20, 30, 70  (xmin, xmax, ymin, ymax) #> crs (first) : lon/lat WGS 84 (CRS84) (OGC:CRS84)"},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":null,"dir":"Reference","previous_headings":"","what":"Stretch — stretch","title":"Stretch — stretch","text":"Linear histogram equalization stretch values SpatRaster. linear stretch, provide desired output range (minv maxv) lower upper bounds original data, either quantiles (minq maxq, cell values (smin smax). smin smax NA, minq maxq ignored. histogram equalization, arguments ignored, can provide desired scale output maximum number cells used compute histogram (empirical cumulative distribution function).","code":""},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Stretch — stretch","text":"","code":"# S4 method for SpatRaster stretch(x, minv=0, maxv=255, minq=0, maxq=1, smin=NA, smax=NA,     histeq=FALSE, scale=1, maxcell=500000, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Stretch — stretch","text":"x SpatRaster minv numeric >= 0 smaller maxv. lower bound stretched value maxv numeric <= 255 larger maxv. upper bound stretched value minq numeric >= 0 smaller maxq. lower quantile bound original value. Ignored smin supplied maxq numeric <= 1 larger minq. upper quantile bound original value. Ignored smax supplied smin numeric < smax. user supplied lower value layers, used instead quantile computed function smax numeric > smin. user supplied upper value layers, used instead quantile computed function histeq logical. TRUE histogram equalization used instead linear stretch scale numeric. scale (maximum value) output histeq=TRUE maxcell positive integer. size regular sample used compute histogram filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Stretch — stretch","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Stretch — stretch","text":"","code":"r <- rast(nc=10, nr=10) values(r) <- rep(1:25, 4) rs <- stretch(r) s <- c(r, r*2) sr <- stretch(s)"},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":null,"dir":"Reference","previous_headings":"","what":"Subset a SpatRaster or a SpatVector — subset","title":"Subset a SpatRaster or a SpatVector — subset","text":"Select subset layers SpatRaster select subset records (row) /variables (columns) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Subset a SpatRaster or a SpatVector — subset","text":"","code":"# S4 method for SpatRaster subset(x, subset, negate=FALSE, NSE=FALSE, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatVector subset(x, subset, select, drop=FALSE, NSE=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Subset a SpatRaster or a SpatVector — subset","text":"x SpatRaster SpatVector subset x SpatRaster: integer character select layers x SpatVector: logical expression indicating rows keep (missing values taken FALSE) select expression, indicating columns select negate logical. TRUE layers subset selected NSE logical. TRUE, non-standard evaluation (use unquoted variable names) allowed. Set FALSE calling subset function drop logical. TRUE, geometries dropped, data.frame returned filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Subset a SpatRaster or a SpatVector — subset","text":"x SpatRaster: SpatRaster x SpatVector: SpatVector , drop=TRUE, data.frame.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Subset a SpatRaster or a SpatVector — subset","text":"","code":"### SpatRaster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    subset(s, 2:3) #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : green, blue  #> min values  :     0,    0  #> max values  :   255,  255  subset(s, c(3,2,3,1)) #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255   #equivalent to  s[[ c(3,2,3,1) ]] #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255   s[[c(\"red\", \"green\")]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s$red #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # expression based (partial) matching of names with single brackets s[\"re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s[\"^re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # not with double brackets # s[[\"re\"]]   ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\"))  subset(v, v$NAME_1 == \"Diekirch\", c(\"NAME_1\", \"NAME_2\")) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange  subset(v, NAME_1 == \"Diekirch\", c(NAME_1, NAME_2), NSE=TRUE) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange  # or like this v[2:3,] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 6  (geometries, attributes) #>  extent      : 5.746118, 6.315773, 49.69933, 49.98745  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 v[1:2, 2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2 v[1:2, c(\"NAME_1\", \"NAME_2\")] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch"},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":null,"dir":"Reference","previous_headings":"","what":"Subset a SpatRaster or a SpatVector — subset_dollar","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"Select subset layers SpatRaster select subset records (row) /variables (columns) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"","code":"# S4 method for SpatExtent $(x, name)"},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"x SpatRaster, SpatVector SpatExtent name character. x SpatRaster: layer name. x SpatVector: variable name. x SpatExtent: xmin, xmax, ymin ymax","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"x SpatRaster: SpatRaster x SpatVector: SpatVector , drop=TRUE, data.frame.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"","code":"### SpatRaster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    subset(s, 2:3) #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : green, blue  #> min values  :     0,    0  #> max values  :   255,  255  subset(s, c(3,2,3,1)) #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255  #equivalent to  s[[ c(3,2,3,1) ]] #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255   s[[c(\"red\", \"green\")]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s$red #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # expression based (partial) matching of names with single brackets s[\"re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s[\"^re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # not with double brackets # s[[\"re\"]]   ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[2:3,] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 6  (geometries, attributes) #>  extent      : 5.746118, 6.315773, 49.69933, 49.98745  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 v[1:2, 2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2  subset(v, v$NAME_1 == \"Diekirch\", c(\"NAME_1\", \"NAME_2\")) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange  subset(v, NAME_1 == \"Diekirch\", c(NAME_1, NAME_2), NSE=TRUE) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange"},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":null,"dir":"Reference","previous_headings":"","what":"Subset a SpatRaster or a SpatVector — subset_double","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"Select subset layers SpatRaster select subset records (row) /variables (columns) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"","code":"# S4 method for SpatRaster,numeric,missing [[(x, i, j)  # S4 method for SpatRasterDataset,ANY,ANY [[(x, i, j, drop=TRUE)  # S4 method for SpatVector,numeric,missing [[(x, i, j, drop=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"x SpatRaster SpatVector x SpatRaster: integer, logical, character select layers x SpatVector: integer, logical, character select variables j missing, , SpatRasterDataset , numeric drop logical. TRUE, geometries dropped, data.frame returned","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"x SpatRaster SpatRasterDataset: SpatRaster x SpatVector: data.frame.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"","code":"### SpatRaster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s[[ 1:2 ]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255   s[[c(\"red\", \"green\")]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255   # expression based (partial) matching of names with single brackets s[\"re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s[\"^re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # does not with double brackets # s[[\"re\"]]   ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[[2:3]] #>          NAME_1 ID_2 #> 1      Diekirch    1 #> 2      Diekirch    2 #> 3      Diekirch    3 #> 4      Diekirch    4 #> 5      Diekirch    5 #> 6  Grevenmacher    6 #> 7  Grevenmacher    7 #> 8  Grevenmacher   12 #> 9    Luxembourg    8 #> 10   Luxembourg    9 #> 11   Luxembourg   10 #> 12   Luxembourg   11  # to keep the geometry use v[,2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 2  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2 #>                Diekirch     3"},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"Extract values SpatRaster; subset records (row) /variables (columns) SpatVector; number SpatExtent. can use indices (row, column, layer cell numbers) extract. can also use Spat* objects.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"","code":"# S4 method for SpatRaster,ANY,ANY,ANY [(x, i, j, k)  # S4 method for SpatVector,numeric,numeric [(x, i, j, drop=FALSE)  # S4 method for SpatVector,SpatVector,missing [(x, i, j)  # S4 method for SpatExtent,numeric,missing [(x, i, j)"},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"x SpatRaster, SpatVector SpatExtent x SpatRaster: numeric, logical missing select rows , j missing, select cells numbers. x SpatVector: numeric missing select rows.    another SpatVector: get new SpatVector geometries intersect. x SpatExtent: integer 1 4. j numeric, logical, missing select columns k numeric, character, missing select layers drop logical. FALSE object class x returned","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"numeric x SpatExtent.  x drop=FALSE. Otherwise data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"","code":"### SpatRaster f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) r[3638] #>   elevation #> 1       473 rowColFromCell(r, 2638) #>      [,1] [,2] #> [1,]   28   73 r[39, 28] #>   elevation #> 1       473 x <- r[39:40, 28:29, drop=FALSE]  as.matrix(x, wide=TRUE) #>      [,1] [,2] #> [1,]  473  429 #> [2,]  430  436  ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[2:3,] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 6  (geometries, attributes) #>  extent      : 5.746118, 6.315773, 49.69933, 49.98745  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 v[1:2, 2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2 v[1:2, 2:3, drop=TRUE] #>     NAME_1 ID_2 #> 1 Diekirch    1 #> 2 Diekirch    2"},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":null,"dir":"Reference","previous_headings":"","what":"replace cell values — subst","title":"replace cell values — subst","text":"Substitute(replace) cell values SpatRaster new value. See classify complex/flexible replacement.","code":""},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"replace cell values — subst","text":"","code":"# S4 method for SpatRaster subst(x, from, to, others=NULL, raw=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"replace cell values — subst","text":"x SpatRaster numeric value(s). Normally vector length ``. x multiple layers, can also matrix numeric value(s) nrow(x) == length(). case output single layer, values based combination values input layers numeric value(s). Normally vector length ``. x single layer, can also matrix numeric value(s) nrow(x) == length(). case output multiple layers, one column others numeric. NULL values matched set value. Otherwise retain original value. raw logical. TRUE, values raw cell values, categorical labels. relevant .factor(x) filename character. Output filename ... Additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"replace cell values — subst","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"replace cell values — subst","text":"","code":"r <- rast(ncols=5, nrows=5, xmin=0, xmax=1, ymin=0, ymax=1, crs=\"\") r <- init(r, 1:6) x <- subst(r, 3, 7) x <- subst(r, 2:3, NA) x <- subst(x, NA, 10)  # multiple output layers z <- subst(r, 2:3, cbind(20,30))  # multiple input layers rr <- c(r, r+1, r+2) m <- rbind(c(1:3), c(3:5)) zz <- subst(rr, m, c(100, 200))"},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize — summarize","title":"Summarize — summarize","text":"Compute summary statistics cells, either across layers layers (parallel summary). following summary methods available SpatRaster: , anyNA, , allNA, max, min, mean, median, prod, range, stdev, sum, .min, .max. See modal compute mode app compute summary statistics included . generic functions used, method applied chosen based first argument: \"x\". means r SpatRaster, mean(r, 5) work, mean(5, r) work. mean method argument \"trim\" ignored. pop=TRUE stdev computes population standard deviation, computed : f <- function(x) sqrt(sum((x-mean(x))^2) / length(x)) different sample standard deviation returned sd (uses n-1 denominator).","code":""},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize — summarize","text":"","code":"# S4 method for SpatRaster min(x, ..., na.rm=FALSE)  # S4 method for SpatRaster max(x, ..., na.rm=FALSE)  # S4 method for SpatRaster range(x, ..., na.rm=FALSE)  # S4 method for SpatRaster prod(x, ..., na.rm=FALSE)  # S4 method for SpatRaster sum(x, ..., na.rm=FALSE)  # S4 method for SpatRaster any(x, ..., na.rm=FALSE)  # S4 method for SpatRaster all(x, ..., na.rm=FALSE)  # S4 method for SpatRaster range(x, ..., na.rm=FALSE)  # S4 method for SpatRaster which.min(x)  # S4 method for SpatRaster which.max(x)  # S4 method for SpatRaster stdev(x, ..., pop=TRUE, na.rm=FALSE)  # S4 method for SpatRaster mean(x, ..., trim=NA, na.rm=FALSE)  # S4 method for SpatRaster median(x, na.rm=FALSE, ...)  # S4 method for SpatRaster anyNA(x)  # S4 method for SpatRaster countNA(x, n=0)  # S4 method for SpatRaster noNA(x, falseNA=FALSE)  # S4 method for SpatRaster allNA(x, falseNA=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize — summarize","text":"x SpatRaster ... additional SpatRasters numeric values; arguments par parallel summarization (see Details), filename, overwrite wopt writeRaster na.rm logical. TRUE, NA values ignored. FALSE, NA returned x NA values trim ignored pop logical. TRUE, population standard deviation computed. Otherwise sample standard deviation computed falseNA logical. TRUE, cells otherwise FALSE set NA n integer. n > 0, cell values TRUE least n layers NA","code":""},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize — summarize","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Summarize — summarize","text":"Additional argument par can used \"parallel\" summarizing SpatRaster numeric logical value. SpatRaster x three layers, max(x, 5) return single layer (number five treated layer cells value five). contrast max(x, 5, par=TRUE) returns three layers (number five treated another SpatRaster single layer cells value five.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Summarize — summarize","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10, nlyrs=3) values(r) <- runif(ncell(r) * nlyr(r))  x <- mean(r) # note how this returns one layer x <- sum(c(r, r[[2]]), 5)  # and this returns three layers y <- sum(r, r[[2]], 5)  max(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :       max  #> min value   : 0.1808664  #> max value   : 0.9926841   ## when adding a number, do you want 1 layer or all layers? # 1 layer max(r, 0.5) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :       max  #> min value   : 0.5000000  #> max value   : 0.9926841   # all layers max(r, 0.5, par=TRUE) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :     lyr.1,     lyr.2,     lyr.3  #> min values  : 0.5000000, 0.5000000, 0.5000000  #> max values  : 0.9919061, 0.9926841, 0.9815635   y <- stdev(r) # not the same as  yy <- app(r, sd)  z <- stdev(r, r*2)  x <- mean(r, filename=paste0(tempfile(), \".tif\"))   v <- values(r) set.seed(3) v[sample(length(v), 50)] <- NA values(r) <- v is.na(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.2, lyr.3  #> min values  : FALSE, FALSE, FALSE  #> max values  :  TRUE,  TRUE,  TRUE  anyNA(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :  lyr1  #> min value   : FALSE  #> max value   :  TRUE  allNA(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :  lyr1  #> min value   : FALSE  #> max value   :  TRUE  countNA(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr1  #> min value   :    0  #> max value   :    3  countNA(r, 2) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :  lyr1  #> min value   : FALSE  #> max value   :  TRUE"},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":null,"dir":"Reference","previous_headings":"","what":"summary — summary","title":"summary — summary","text":"Compute summary statistics (min, max, mean, quartiles) SpatRaster using base summary method. sample used large files. single statistics see Summary-methods, global, quantile","code":""},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"summary — summary","text":"","code":"# S4 method for SpatRaster summary(object, size=100000, warn=TRUE, ...)  # S4 method for SpatVector summary(object, ...)"},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"summary — summary","text":"object SpatRaster SpatVector size positive integer. Size regular sample used large datasets (see spatSample) warn logical. TRUE warning given sample used ... additional arguments passed base summary method","code":""},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"summary — summary","text":"matrix (estimate ) median, minimum maximum values, first third quartiles, number cells NA values","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"summary — summary","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10, nlyrs=3) values(r) <- runif(nlyr(r)*ncell(r)) summary(r) #>      lyr.1             lyr.2             lyr.3         #>  Min.   :0.01339   Min.   :0.01308   Min.   :0.02779   #>  1st Qu.:0.32308   1st Qu.:0.28440   1st Qu.:0.18947   #>  Median :0.48781   Median :0.51860   Median :0.37810   #>  Mean   :0.52076   Mean   :0.51569   Mean   :0.43403   #>  3rd Qu.:0.77171   3rd Qu.:0.72570   3rd Qu.:0.63596   #>  Max.   :0.99191   Max.   :0.99268   Max.   :0.98156"},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatVectorCollection — svc","title":"Create a SpatVectorCollection — svc","text":"Methods create SpatVectorCollection. object hold \"sub-datasets\", SpatVector, perhaps different geometry type.","code":""},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatVectorCollection — svc","text":"","code":"# S4 method for missing svc(x)   # S4 method for SpatVector svc(x, ...)   # S4 method for list svc(x)   # S4 method for character svc(x, layer=\"\", query=\"\", extent=NULL, filter=NULL)"},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatVectorCollection — svc","text":"x SpatVector, character (filename), list SpatVectors, missing ... Additional SpatVectors layer character. layer name select layer file (database) multiple layers query character. query subset dataset OGR-SQL dialect extent Spat* object. extent object used spatial filter select geometries read. Ignored filter NULL filter SpatVector. Used spatial filter select geometries read (convex hull used lines points). guaranteed features overlap extent filter returned. can happen additional geometries returned","code":""},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatVectorCollection — svc","text":"SpatVectorCollection","code":""},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatVectorCollection — svc","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) x <- svc() x <- svc(v, v[1:3,], as.lines(v[3:5,]), as.points(v)) length(x) #> [1] 4 x #>  class       : SpatVectorCollection  #>  length      : 4  #>  geometry    : polygons (12) #>                polygons (3) #>                lines (3) #>                points (3983) #>  crs (first) : lon/lat WGS 84 (EPSG:4326)  #>  names       : , , ,    # extract x[3] #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 3, 6  (geometries, attributes) #>  extent      : 5.74414, 6.239243, 49.69933, 50.03632  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2  NAME_2  AREA   POP #>  type        : <num>    <chr> <num>   <chr> <num> <int> #>  values      :     1 Diekirch     3 Redange   259 18664 #>                    1 Diekirch     4 Vianden    76  5163 #>                    1 Diekirch     5   Wiltz   263 16735  # replace x[2] <- as.lines(v[1,])"},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":null,"dir":"Reference","previous_headings":"","what":"Symmetrical difference — symdif","title":"Symmetrical difference — symdif","text":"Symmetrical difference polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Symmetrical difference — symdif","text":"","code":"# S4 method for SpatVector,SpatVector symdif(x, y)"},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Symmetrical difference — symdif","text":"x SpatVector y SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Symmetrical difference — symdif","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Symmetrical difference — symdif","text":"","code":"p <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) b <- as.polygons(ext(6, 6.4, 49.75, 50)) #sd <- symdif(p, b) #plot(sd, col=rainbow(12))"},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to subsets of layers of a SpatRaster — tapp","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"Apply function subsets layers SpatRaster (similar tapply aggregate). layers combined based index. number layers output SpatRaster equals number unique values index times number values supplied function returns single vector numbers. example, SpatRaster 6 layers, can use index=c(1,1,1,2,2,2) fun=sum. return SpatRaster two layers. first layer sum first three layers input SpatRaster, second layer sum last three layers input SpatRaster. Indices recycled index=c(1,2) also return SpatRaster two layers (one based odd layers (1,3,5), based even layers (2,4,6)). index can also one following values group time period (x appropriate time values): \"years\", \"months\", \"yearmonths\", \"week\" (ISO 8601 week number, see Details), \"yearweeks\", \"days\", \"doy\" (day year), \"7days\" (seven-day periods starting Jan 1 year), \"10days\", \"15days\". can also function makes groups time values. See app Summary-methods want use efficient function returns multiple layers based layers SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"","code":"# S4 method for SpatRaster tapp(x, index, fun, ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"x SpatRaster index factor numeric (integer). Vector length nlyr(x) (shorter vectors recycled) grouping input layers. can also one following values: \"years\", \"months\", \"yearmonths\", \"days\", \"week\" (ISO 8601 week number), \"doy\" (day year) fun function applied. following functions re-implemented C++ speed: \"sum\", \"mean\", \"median\", \"modal\", \"\", \".min\", \".max\", \"min\", \"max\", \"prod\", \"\", \"\", \"sd\", \"std\", \"first\". use base-R function say, \"min\", use something like fun = \\() min() ... additional arguments passed fun cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object. Ignored functions implemented terra C++ (see fun) filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"\"week\" follows ISO 8601 definition. Weeks start Monday. week containing 1 January four days new year, considered week \"01\". Otherwise, last week previous year (week \"52\" \"53\", next week week 1.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) s <- c(r, r, r, r, r, r) s <- s * 1:6 b1 <- tapp(s, index=c(1,1,1,2,2,2), fun=sum) b1 #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :  X1,   X2  #> min values  :   6,   15  #> max values  : 600, 1500  b2 <- tapp(s, c(1,2,3,1,2,3), fun=sum) b2 #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :  X1,  X2,  X3  #> min values  :   5,   7,   9  #> max values  : 500, 700, 900"},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":null,"dir":"Reference","previous_headings":"","what":"Description of the methods in the terra package — terra-package","title":"Description of the methods in the terra package — terra-package","text":"terra provides methods manipulate geographic (spatial) data \"raster\" \"vector\" form. Raster data divide space rectangular grid cells commonly used represent spatially continuous phenomena, elevation weather. Satellite images also data structure, context grid cells often referred pixels. contrast, \"vector\" spatial data (points, lines, polygons) typically used represent discrete spatial entities, road, country, bus stop. package implements two main classes (data types): SpatRaster SpatVector. SpatRaster supports handling large raster files loaded memory; local, focal, zonal, global raster operations; polygon, line point raster conversion; integration modeling methods make spatial predictions; . SpatVector supports types geometric operations intersections. Additional classes include SpatExtent, used define spatial extent (bounding box); SpatRasterDataset, represents collection sub-datasets area. sub-dataset SpatRaster possibly many layers, may, example, represent different weather variables; SpatRasterCollection SpatVectorCollection equivalent lists SpatRaster SpatVector objects. also SpatGraticule class assist adding longitude/latitude lines labels map another coordinate reference system. classes hold C++ pointer data \"reference class\" creates limitations. recovered saved R session either directly passed nodes computer cluster. Generally, use writeRaster save SpatRaster objects disk (pass filename cell values cluster nodes). Also see wrap. Also, package developers directly access pointer, user-interface stable. terra package conceived replacement raster package. terra similar, simpler, interface, faster raster. bottom page table shows differences methods two packages. list important methods grouped theme. ---------------------------------------------------------------------------------------------------------------------","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"spatraster","dir":"Reference","previous_headings":"","what":"SpatRaster","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"ii-changing-the-spatial-extent-or-resolution","dir":"Reference","previous_headings":"","what":"II. Changing the spatial extent or resolution","title":"Description of the methods in the terra package — terra-package","text":"Also see methods section VIII","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"vii-accessing-cell-values","dir":"Reference","previous_headings":"","what":"VII. Accessing cell values","title":"Description of the methods in the terra package — terra-package","text":"Apart function listed , can also use indexing [ cell numbers, row /column numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"viii-getting-and-setting-dimensions-","dir":"Reference","previous_headings":"","what":"VIII. Getting and setting dimensions","title":"Description of the methods in the terra package — terra-package","text":"Get set basic parameters SpatRasters. values associated SpatRaster (either memory via link file) lost change number columns rows resolution. case extent changed (number columns rows affected). Similarly, crs can set coordinate reference system, transform data (see project ).","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"ix-computing-row-column-cell-numbers-and-coordinates","dir":"Reference","previous_headings":"","what":"IX. Computing row, column, cell numbers and coordinates","title":"Description of the methods in the terra package — terra-package","text":"Cell numbers start 1 upper-left corner. increase within rows, left right, row row top bottom. Likewise, row numbers start 1 top raster, column numbers start 1 left side raster.","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xiv-spatrasterdataset","dir":"Reference","previous_headings":"","what":"XIV. SpatRasterDataset","title":"Description of the methods in the terra package — terra-package","text":"SpatRasterDataset contains SpatRasters represent sub-datasets area. extent resolution.","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xv-spatrastercollections","dir":"Reference","previous_headings":"","what":"XV. SpatRasterCollections","title":"Description of the methods in the terra package — terra-package","text":"SpatRasterCollection vector SpatRaster objects. Unlike SpatRasterDataset, extent resolution SpatRasters need match .","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"spatvector","dir":"Reference","previous_headings":"","what":"SpatVector","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xx-spatvector-attributes","dir":"Reference","previous_headings":"","what":"XX. SpatVector attributes","title":"Description of the methods in the terra package — terra-package","text":"use term \"attributes\" tabular data (data.frame) associated vector geometries.","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxiii-spatvectorcollections","dir":"Reference","previous_headings":"","what":"XXIII. SpatVectorCollections","title":"Description of the methods in the terra package — terra-package","text":"SpatVectorCollection vector SpatVector objects.","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"other-classes","dir":"Reference","previous_headings":"","what":"Other classes","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"general-methods","dir":"Reference","previous_headings":"","what":"General methods","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxvi-conversion-between-spatial-data-objects-from-different-packages","dir":"Reference","previous_headings":"","what":"XXVI. Conversion between spatial data objects from different packages","title":"Description of the methods in the terra package — terra-package","text":"can coerce SpatRasters Raster* objects, loading raster package, (object, \"Raster\"), raster(object) brick(object) stack(object)","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"comparison-with-the-raster-package","dir":"Reference","previous_headings":"","what":"Comparison with the raster package","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxviii-new-method-names","dir":"Reference","previous_headings":"","what":"XXVIII. New method names","title":"Description of the methods in the terra package — terra-package","text":"terra single class SpatRaster raster three (RasterLayer, RasterStack, RasterBrick). Likewise single class vector data SpatVector replaces six Spatial* classes. method names , note following important differences methods names raster package","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxix-changed-behavior","dir":"Reference","previous_headings":"","what":"XXIX. Changed behavior","title":"Description of the methods in the terra package — terra-package","text":"Also note even function names terra raster, output can different. cases done get consistency returned values (thus fewer errors downstream code uses ). cases simply seemed better. examples:","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"authors","dir":"Reference","previous_headings":"","what":"Authors","title":"Description of the methods in the terra package — terra-package","text":"Except indicated otherwise, methods functions package written Robert Hijmans. configuration scripts written Roger Bivand. code using GEOS library adapted code Edzer Pebesma sf. Michael Sumner contributed various bits pieces.","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"acknowledgments","dir":"Reference","previous_headings":"","what":"Acknowledgments","title":"Description of the methods in the terra package — terra-package","text":"package attempt climb shoulders giants (GDAL, PROJ, GEOS, NCDF, GeographicLib, Rcpp, R). Many people contributed asking questions raising issues. Feedback suggestions Márcia Barbosa, Kendon Bell, Andrew Gene Brown, Jean-Luc Dupouey, Krzysztof Dyba, Sarah Endicott, Derek Friend, Alex Ilich, Gerald Nelson, Jakub Nowosad, Monika Tomaszewska especially helpful.","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":null,"dir":"Reference","previous_headings":"","what":"Options — options","title":"Options — options","text":"Get set general options.","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Options — options","text":"","code":"terraOptions(..., print=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Options — options","text":"... option names values (see Details). missing, get show current options print logical. TRUE option names values printed","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Options — options","text":"following options available. memfrac - value 0 0.9 (larger values give warning). fraction RAM may used program. memmin - memory required threshold (GB), memory assumed available. Otherwise, terra checks available. memmax - maximum amount RAM (GB) terra allowed use processing raster dataset. less detected (see mem_info), higher values ignored. Set negative number NA set option. terraOptions shows value memmax set. tempdir - directory temporary files written. default returned tempdir(). datatype - default data type. See writeRaster todisk - logical. TRUE write raster data disk (temp file file name specified). debugging. progress - non-negative integer. progress bar shown number chunks data processed larger number. progress bar shown value zero verbose - logical. TRUE debugging info printed functions","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Options — options","text":"possible set default options \"etc/.Rprofile.site\" R installation like options(terra_default=list(tempdir=\"d:/temp\", memfrac=.4)) may good practice. clearer set favorite options beginning script.","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Options — options","text":"list. Invisibly print=TRUE","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Options — options","text":"","code":"terraOptions() #> memfrac   : 0.6 #> tolerance : 0.1 #> verbose   : FALSE #> todisk    : FALSE #> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpsTXkfZ #> datatype  : FLT4S #> memmin    : 1 #> progress  : 3 terraOptions(memfrac=0.5, tempdir = \"c:/temp\") #> Warning: [options] you cannot set the tempdir to a path that does not exist terraOptions(progress=10) terraOptions() #> memfrac   : 0.5 #> tolerance : 0.1 #> verbose   : FALSE #> todisk    : FALSE #> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpsTXkfZ #> datatype  : FLT4S #> memmin    : 1 #> progress  : 10"},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":null,"dir":"Reference","previous_headings":"","what":"terrain characteristics — terrain","title":"terrain characteristics — terrain","text":"Compute terrain characteristics elevation data. elevation values units map units (typically meter) projected (planar) raster data. meter coordinate reference system longitude/latitude. accuracy, always compute values original data (first change projection). Distances (needed slope aspect) longitude/latitude data computed WGS84 ellipsoid Karney's algorithm.","code":""},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"terrain characteristics — terrain","text":"","code":"# S4 method for SpatRaster terrain(x, v=\"slope\", neighbors=8, unit=\"degrees\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"terrain characteristics — terrain","text":"x SpatRaster, single layer elevation values. Values unit map units, meters crs longitude/latitude v character. One options: slope, aspect, TPI, TRI, TRIriley, TRIrmsd, roughness, flowdir (see Details) unit character. \"degrees\" \"radians\" output \"slope\" \"aspect\" neighbors integer. Indicating many neighboring cells use compute slope aspect . Either 8 (queen case) 4 (rook case) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"terrain characteristics — terrain","text":"neighbors=4, slope aspect computed according Fleming Hoffer (1979) Ritter (1987). neighbors=8, slope aspect computed according Horn (1981). Horn algorithm may best rough surfaces, Fleming Hoffer algorithm may better smoother surfaces (Jones, 1997; Burrough McDonnell, 1998). slope = 0, aspect set 0.5*pi radians (90 degrees unit=\"degrees\"). computing slope aspect, coordinate reference system x must known algorithm differentiate planar longitude/latitude data. terrain vectorized \"neighbors\" \"unit\" -- first value used. flowdir returns \"flow direction\" (water), direction greatest drop elevation (smallest rise neighbors higher). encoded powers 2 (0 7). cell right focal cell 1, one 2, : Cells without lower neighboring cells encoded zero. two cells drop elevation, random cell picked. ideal may prevent creation connected flow networks. ArcGIS implements approach Greenlee (1987) might adopt future. terrain indices according Wilson et al. (2007), gdaldem. TRI (Terrain Ruggedness Index) mean absolute differences value cell 8 surrounding cells. TPI (Topographic Position Index) difference value cell mean value 8 surrounding cells. Roughness difference maximum minimum value cell 8 surrounding cells. TRIriley (TRI according Riley et al., 2007) returns square root summed squared differences value cell 8 surrounding cells. TRIrmsd computes square root mean squared differences cells. measures can also computed focal functions: TRI <- focal(x, w=3, fun=\\(x) sum(abs(x[-5]-x[5]))/8) TPI <- focal(x, w=3, fun=\\(x) x[5] - mean(x[-5])) rough <- focal(x, w=3, fun=\\(x) max(x) - min(x))","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"terrain characteristics — terrain","text":"Burrough, P., R.. McDonnell, 1998. Principles Geographical Information Systems. Oxford University Press. Fleming, M.D. Hoffer, R.M., 1979. Machine processing Landsat MSS data DMA topographic data forest cover type mapping. LARS Technical Report 062879. Laboratory Applications Remote Sensing, Purdue University, West Lafayette, Indiana. Horn, B.K.P., 1981. Hill shading reflectance map. Proceedings IEEE 69:14-47 Jones, K.H., 1998. comparison algorithms used compute hill slope property DEM. Computers & Geosciences 24: 315-323 Karney, C.F.F., 2013. Algorithms geodesics, J. Geodesy 87: 43-55. doi:10.1007/s00190-012-0578-z. Riley, S.J., De Gloria, S.D., Elliot, R. (1999): Terrain Ruggedness Quantifies Topographic Heterogeneity. Intermountain Journal Science 5: 23-27. Ritter, P., 1987. vector-based terrain aspect generation algorithm. Photogrammetric Engineering Remote Sensing 53: 1109-1111 Wilson et al 2007, Multiscale Terrain Analysis Multibeam Bathymetry Data Habitat Mapping Continental Slope. Marine Geodesy 30:3-35","code":""},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"terrain characteristics — terrain","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- terrain(r, \"slope\")"},{"path":"https://rspatial.github.io/terra/reference/text.html","id":null,"dir":"Reference","previous_headings":"","what":"Add labels to a map — text","title":"Add labels to a map — text","text":"Plots labels, textual (rather color) representation values, top existing plot (map).","code":""},{"path":"https://rspatial.github.io/terra/reference/text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add labels to a map — text","text":"","code":"# S4 method for SpatRaster text(x, labels, digits=0, halo=FALSE, ...)  # S4 method for SpatVector text(x, labels, halo=FALSE, inside=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add labels to a map — text","text":"x SpatRaster SpatVector labels character. Optional. Vector labels length(x) variable name names(x) digits integer. many digits used? halo logical. TRUE \"halo\" printed around text. TRUE, additional arguments hc=\"white\" hw=0.1 can modified set color width halo inside logical. text always placed inside one sub-geometries? ... additional arguments pass graphics function text","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add labels to a map — text","text":"","code":"r <- rast(nrows=4, ncols=4) values(r) <- 1:ncell(r) plot(r) text(r)   plot(r) text(r, halo=TRUE, hc=\"blue\", col=\"white\", hw=0.2)   plot(r, col=rainbow(16)) text(r, col=c(\"black\", \"white\"), vfont=c(\"sans serif\", \"bold\"), cex=2)"},{"path":"https://rspatial.github.io/terra/reference/time.html","id":null,"dir":"Reference","previous_headings":"","what":"time of SpatRaster layers — time","title":"time of SpatRaster layers — time","text":"Get set time layers SpatRaster. Time can stored POSIXlt (date time,  resolution seconds, time zone), Date, \"months\", \"years\", \"yearmonths\". timeInfo .time helper functions understand time data SpatRaster .","code":""},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"time of SpatRaster layers — time","text":"","code":"# S4 method for SpatRaster has.time(x)  # S4 method for SpatRaster time(x, format=\"\")  # S4 method for SpatRaster time(x, tstep=\"\")<-value  # S4 method for SpatRaster timeInfo(x)"},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"time of SpatRaster layers — time","text":"x SpatRaster SpatRasterDataset format One \"\", \"seconds\" (POSIXlt), \"days\" (Date), \"yearmonths\" (decimal years), \"years\", \"months\". \"\", returned format (based ) format used set time value Date, POSIXt, yearmon (defined package zoo), numeric tstep One \"years\", \"months\", \"yearmonths\". Used value numeric. Ignored value type Date, POSIXt, yearmon","code":""},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"time of SpatRaster layers — time","text":"time: POSIXlt, Date, numeric timeInfo: data.frame time step time zone information (available) .time: logical","code":""},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"time of SpatRaster layers — time","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     # Date\" d <- as.Date(\"2001-05-04\") + 0:2 time(s) <- d time(s) #> [1] \"2001-05-04\" \"2001-05-05\" \"2001-05-06\"  # POSIX (date/time with a resolution of seconds) time(s) <- as.POSIXlt(d) time(s) #> [1] \"2001-05-04 UTC\" \"2001-05-05 UTC\" \"2001-05-06 UTC\"  # with time zone time(s) <- as.POSIXlt(Sys.time(), \"America/New_York\") + 0:2 time(s) #> [1] \"2024-05-22 06:10:59 EDT\" \"2024-05-22 06:11:00 EDT\" #> [3] \"2024-05-22 06:11:01 EDT\" timeInfo(s) #>   time    step             zone #> 1 TRUE seconds America/New_York  # years time(s, tstep=\"years\") <- 2000 + 0:2 s #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  #> time (years): 2000 to 2002   time(s, tstep=\"months\") <- 1:3 s  #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  #> time (mnts) : Jan to Mar"},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":null,"dir":"Reference","previous_headings":"","what":"Temporary files — tmpFiles","title":"Temporary files — tmpFiles","text":"List optionally remove temporary files created terra package. files created output SpatRaster may large store memory (RAM). can happen filename provided function using functions provide filename. Temporary files automatically removed end R session ends normally. can use tmpFiles see files current sessions, including orphaned (connect SpatRaster object ) (perhaps old) sessions, remove temporary files.","code":""},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Temporary files — tmpFiles","text":"","code":"tmpFiles(current=TRUE, orphan=FALSE, old=FALSE, remove=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Temporary files — tmpFiles","text":"current logical. TRUE, temporary files current R session included orphan logical. TRUE, temporary files current R session longer associated SpatRaster (current TRUE also included) old logical. TRUE, temporary files \"R\" sessions. Unless running multiple instances R time, old (possibly crashed) R  sessions removed remove logical. TRUE, temporary files removed","code":""},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Temporary files — tmpFiles","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Temporary files — tmpFiles","text":"","code":"tmpFiles() #> [1] \"/private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpsTXkfZ/spat_3511124f81fe_13585.vrt\""},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":null,"dir":"Reference","previous_headings":"","what":"Vector topology methods — topology","title":"Vector topology methods — topology","text":"makeNodes create nodes lines mergeLines connect lines form polygons removeDupNodes removes duplicate nodes geometries optionally rounds coordinates emptyGeoms returns indices empty (null) geometries. .na also checks coordinates NA. snap makes boundaries geometries identical close .","code":""},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Vector topology methods — topology","text":"","code":"# S4 method for SpatVector mergeLines(x) # S4 method for SpatVector snap(x, y=NULL, tolerance) # S4 method for SpatVector removeDupNodes(x, digits = -1) # S4 method for SpatVector makeNodes(x)"},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Vector topology methods — topology","text":"x SpatVector lines polygons y SpatVector lines polygons snap . NULL snapping geometries x tolerance numeric. Snapping tolerance (distance geometries) digits numeric. Number digits used rounding. Ignored < 0","code":""},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Vector topology methods — topology","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Vector topology methods — topology","text":"","code":"p1 <- as.polygons(ext(0,1,0,1)) p2 <- as.polygons(ext(1.1,2,0,1))  p <- rbind(p1, p2)  y <- snap(p, tol=.15) plot(p, lwd=3, col=\"light gray\") lines(y, col=\"red\", lwd=2)"},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":null,"dir":"Reference","previous_headings":"","what":"Transpose — transpose","title":"Transpose — transpose","text":"Transpose SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transpose — transpose","text":"","code":"# S4 method for SpatRaster t(x)  # S4 method for SpatVector t(x)  # S4 method for SpatRaster trans(x, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transpose — transpose","text":"x SpatRaster SpatVector filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transpose — transpose","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transpose — transpose","text":"","code":"r <- rast(nrows=18, ncols=36) values(r) <- 1:ncell(r) tr1 <- t(r) tr2 <- trans(r) ttr <- trans(tr2)"},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":null,"dir":"Reference","previous_headings":"","what":"Trim a SpatRaster — trim","title":"Trim a SpatRaster — trim","text":"Trim (shrink) SpatRaster removing outer rows columns NA another value.","code":""},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Trim a SpatRaster — trim","text":"","code":"# S4 method for SpatRaster trim(x, padding=0, value=NA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Trim a SpatRaster — trim","text":"x SpatRaster padding integer. Number outer rows/columns keep value numeric. value outer rows columns removed filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Trim a SpatRaster — trim","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Trim a SpatRaster — trim","text":"","code":"r <- rast(ncols=10, nrows=10, xmin=0,xmax=10,ymin=0,ymax=10) v <- rep(NA, ncell(r)) v[c(12,34,69)] <- 1:3 values(r) <- v s <- trim(r)"},{"path":"https://rspatial.github.io/terra/reference/union.html","id":null,"dir":"Reference","previous_headings":"","what":"Union SpatVector or SpatExtent objects — union","title":"Union SpatVector or SpatExtent objects — union","text":"Overlapping polygons (, within, objects) intersected. Union lines points simply combines two data sets; without geometric intersections. equivalent c. Attributes joined. See c want combine polygons without intersection. x y different geometry type, SpatVectorCollection returned. single SpatVector supplied, overlapping polygons intersected. Original attributes lost. New attributes allow determining many, , polygons overlapped. SpatExtent: Objects combined union; equivalent +.","code":""},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Union SpatVector or SpatExtent objects — union","text":"","code":"# S4 method for SpatVector,SpatVector union(x, y)  # S4 method for SpatVector,missing union(x, y)  # S4 method for SpatExtent,SpatExtent union(x, y)"},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Union SpatVector or SpatExtent objects — union","text":"x SpatVector SpatExtent y x missing","code":""},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Union SpatVector or SpatExtent objects — union","text":"SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Union SpatVector or SpatExtent objects — union","text":"","code":"e1 <- ext(-10, 10, -20, 20) e2 <- ext(0, 20, -40, 5) union(e1, e2) #> SpatExtent : -10, 20, -40, 20 (xmin, xmax, ymin, ymax)  #SpatVector v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v <- v[,3:4] p <- vect(c(\"POLYGON ((5.8 49.8, 6 49.9, 6.15 49.8, 6 49.65, 5.8 49.8))\",  \"POLYGON ((6.3 49.9, 6.2 49.7, 6.3 49.6, 6.5 49.8, 6.3 49.9))\"), crs=crs(v)) values(p) <- data.frame(pid=1:2, value=expanse(p)) u <- union(v, p) plot(u, \"pid\")   b <- buffer(v, 1000)  u <- union(b) u$sum <- rowSums(as.data.frame(u)) plot(u, \"sum\")"},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":null,"dir":"Reference","previous_headings":"","what":"Unique values — unique","title":"Unique values — unique","text":"method returns unique values SpatRaster, removes duplicates records (geometry attributes) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unique values — unique","text":"","code":"# S4 method for SpatRaster unique(x, incomparables=FALSE, digits=NA, na.rm=TRUE, as.raster=FALSE)   # S4 method for SpatVector unique(x, incomparables=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Unique values — unique","text":"x SpatRaster SpatVector incomparables logical. FALSE x SpatRaster: unique values determined layers together, result matrix. TRUE, layer evaluated separately, list returned. x SpatVector argument data.frame digits integer. number digits rounding values finding unique values. Use NA means rounding na.rm logical. TRUE, NaN included missing values .raster logical. TRUE, single-layer categorical SpatRaster unique values returned ... additional arguments passed unique","code":""},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Unique values — unique","text":"x SpatRaster: data.frame list (incomparables=FALSE) x SpatVector: SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Unique values — unique","text":"","code":"r <- rast(ncols=5, nrows=5) values(r) <- rep(1:5, each=5) unique(r) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 #> 5     5 s <- c(r, round(r/3)) unique(s) #>   lyr.1 lyr.1 #> 1     1     0 #> 2     2     1 #> 3     3     1 #> 4     4     1 #> 5     5     2 unique(s,TRUE) #> [[1]] #> [1] 1 2 3 4 5 #>  #> [[2]] #> [1] 0 1 2 #>   unique(s, as.raster=TRUE) #> class       : SpatRaster  #> dimensions  : 5, 5, 1  (nrow, ncol, nlyr) #> resolution  : 72, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : label, lyr.1, lyr.1.1  #> name        : label  #> min value   :   1_0  #> max value   :   5_2    v <- vect(cbind(x=c(1:5,1:5), y=c(5:1,5:1)),      crs=\"+proj=utm +zone=1 +datum=WGS84\") nrow(v) #> [1] 10 u <- unique(v) nrow(u) #> [1] 5  values(v) <- c(1:5, 1:3, 5:4) unique(v) #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 7, 1  (geometries, attributes) #>  extent      : 1, 5, 1, 5  (xmin, xmax, ymin, ymax) #>  coord. ref. : +proj=utm +zone=1 +datum=WGS84 +units=m +no_defs  #>  names       : value #>  type        : <int> #>  values      :     1 #>                    2 #>                    3"},{"path":"https://rspatial.github.io/terra/reference/units.html","id":null,"dir":"Reference","previous_headings":"","what":"units of SpatRaster or SpatRasterDataSet — units","title":"units of SpatRaster or SpatRasterDataSet — units","text":"Get set units layers SpatRaster datasets SpatRasterDataSet.","code":""},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"units of SpatRaster or SpatRasterDataSet — units","text":"","code":"# S4 method for SpatRaster units(x)  # S4 method for SpatRaster units(x)<-value  # S4 method for SpatRasterDataset units(x)  # S4 method for SpatRasterDataset units(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"units of SpatRaster or SpatRasterDataSet — units","text":"x SpatRaster value character","code":""},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"units of SpatRaster or SpatRasterDataSet — units","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"units of SpatRaster or SpatRasterDataSet — units","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     units(s) <- c(\"m/s\", \"kg\", \"ha\") units(s) #> [1] \"m/s\" \"kg\"  \"ha\"  s #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  #> unit        : m/s,    kg,   ha   units(s) <- \"kg\" units(s) #> [1] \"kg\" \"kg\" \"kg\""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":null,"dir":"Reference","previous_headings":"","what":"Change values in a file — update","title":"Change values in a file — update","text":"Change contents file data source SpatRaster. CAREFUL overwriting values existing file.","code":""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Change values in a file — update","text":"","code":"# S4 method for SpatRaster update(object, names=FALSE, crs=FALSE, extent=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Change values in a file — update","text":"object SpatRaster names logical. names updated? crs logical. coordinate reference system updated? extent logical. extent updated?","code":""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Change values in a file — update","text":"SpatRaster (invisibly)","code":""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Change values in a file — update","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    fname <- paste0(tempfile(), \".tif\") x <- writeRaster(s, fname) names(x) <- c(\"A\", \"B\", \"C\") ext(x) <- ext(x) + 1 crs(x) <- \"+proj=utm +zone=1\"  update(x, names=TRUE, crs=TRUE, extent=TRUE)  rast(fname) #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1.019802, 1.025974  (x, y) #> extent      : -1, 102, -1, 78  (xmin, xmax, ymin, ymax) #> coord. ref. : WGS 84 / UTM zone 1N (EPSG:32601)  #> source      : file3511416415b3.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255"},{"path":"https://rspatial.github.io/terra/reference/values.html","id":null,"dir":"Reference","previous_headings":"","what":"Cell values and geometry attributes — values","title":"Cell values and geometry attributes — values","text":"Get cell values SpatRaster attributes SpatVector. default values returned numeric. vector matrix can store one data type, SpatRaster may consist multiple data types. However, layers integer logical values, returned values also datatype. Note values(x, dataframe=TRUE) .data.frame(x) values returned match type layer, can mix numeric, logical, integer, factor.","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cell values and geometry attributes — values","text":"","code":"# S4 method for SpatRaster values(x, mat=TRUE, dataframe=FALSE, row=1,      nrows=nrow(x), col=1, ncols=ncol(x), na.rm=FALSE, ...)  # S4 method for SpatVector values(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cell values and geometry attributes — values","text":"x SpatRaster SpatVector mat logical. TRUE, values returned matrix instead vector, except dataframe TRUE dataframe logical. TRUE, values returned data.frame instead vector (also matrix TRUE) row positive integer. Row number start , 1 nrow(x) nrows positive integer. many rows? col positive integer. Column number start , 1 ncol(x) ncols positive integer. many columns? Default number columns left start column na.rm logical. Remove NAs? ... additional arguments passed data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Cell values and geometry attributes — values","text":"x SpatRaster, mat=FALSE, values returned vector. cell-order layer. mat=TRUE, matrix returned values layer represented column (ncell(x) rows). values per layer cell-order, , top-left, top-right row. Use .matrix(x, wide=TRUE) alternative matrix representation number rows columns matches x.","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Cell values and geometry attributes — values","text":"raster values NA (missing) represented NaN (--number) unless argument dataframe TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cell values and geometry attributes — values","text":"matrix data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cell values and geometry attributes — values","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) r #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : elev.tif  #> name        : elevation  #> min value   :       141  #> max value   :       547  x <- values(r) x[3650:3655, ] #> [1] 349 287 334 319 271 228 r[3650:3655] #>   elevation #> 1       349 #> 2       287 #> 3       334 #> 4       319 #> 5       271 #> 6       228   ff <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(ff) y <- values(v) head(y) #>   ID_1       NAME_1 ID_2     NAME_2 AREA   POP #> 1    1     Diekirch    1   Clervaux  312 18081 #> 2    1     Diekirch    2   Diekirch  218 32543 #> 3    1     Diekirch    3    Redange  259 18664 #> 4    1     Diekirch    4    Vianden   76  5163 #> 5    1     Diekirch    5      Wiltz  263 16735 #> 6    2 Grevenmacher    6 Echternach  188 18899"},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":null,"dir":"Reference","previous_headings":"","what":"variable and long variable names — varnames","title":"variable and long variable names — varnames","text":"Set get names dataset (variable) SpatRasterDataset. SpatRaster _data source_ can also variable name long variable name. set reading file possibly multiple sub-datasets (e.g. netcdf hdf5 format) single SpatRaster. sub-datset seperate \"data-source\" SpatRaster. Note newly created derived SpatRasters always single variable (data source), therefore variable names lost processing multi-variable SpatRaster. Thus variable names mostly useful understand SpatRaster created files managing SpatRasterDatasets. See link{names} commonly used _layer_ names.","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"variable and long variable names — varnames","text":"","code":"# S4 method for SpatRaster varnames(x)  # S4 method for SpatRaster varnames(x)<-value  # S4 method for SpatRaster longnames(x)  # S4 method for SpatRaster longnames(x)<-value  # S4 method for SpatRasterDataset varnames(x)  # S4 method for SpatRasterDataset varnames(x)<-value  # S4 method for SpatRasterDataset longnames(x)  # S4 method for SpatRasterDataset longnames(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"variable and long variable names — varnames","text":"x SpatRaster, SpatRasterDataset value character (vector)","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"variable and long variable names — varnames","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"variable and long variable names — varnames","text":"terra enforces neither unique valid names. See make.unique create unique names {make.names} make syntactically valid names.","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"variable and long variable names — varnames","text":"","code":"s <- rast(ncols=5, nrows=5, nlyrs=3) names(s) <- c(\"a\", \"b\", \"c\") x <- sds(s, s) varnames(x) <- c(\"one\", \"two\") x #> class       : SpatRasterDataset  #> subdatasets : 2  #> dimensions  : 5, 5 (nrow, ncol) #> nlyr        : 3, 3  #> resolution  : 72, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory  #> names       : one, two"},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":null,"dir":"Reference","previous_headings":"","what":"Create SpatVector objects — vect","title":"Create SpatVector objects — vect","text":"Methods create SpatVector filename R object. filename can shapefile spatial file format. can use data.frame make SpatVector points; \"geom\" matrix make SpatVector supported geometry (see examples geom). can supply list SpatVectors append single SpatVector. SpatVectors can also created \"Well Known Text\", spatial vector data objects defined sf sp packages.","code":""},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create SpatVector objects — vect","text":"","code":"# S4 method for character vect(x, layer=\"\", query=\"\", extent=NULL, filter=NULL,      crs=\"\", proxy=FALSE, what=\"\", opts=NULL)  # S4 method for matrix vect(x, type=\"points\", atts=NULL, crs=\"\")  # S4 method for data.frame vect(x, geom=c(\"lon\", \"lat\"), crs=\"\", keepgeom=FALSE)  # S4 method for list vect(x, type=\"points\", crs=\"\")  # S4 method for SpatExtent vect(x, crs=\"\")  # S4 method for SpatVectorCollection vect(x)  # S4 method for sf vect(x)"},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create SpatVector objects — vect","text":"x character. filename; \"Well Known Text\" string; SpatExtent, data.frame (make SpatVector points); \"geom\" matrix make SpatVector supported geometry (see examples geom); spatial vector data object defined sf sp packages; list matrices coordinates layer character. layer name select layer file (database) multiple layers query character. query subset dataset OGR-SQL dialect extent Spat* object. extent object used spatial filter select geometries read. Ignored filter NULL filter SpatVector. Used spatial filter select geometries read (convex hull used lines points). guaranteed features overlap extent filter returned. can happen additional geometries returned type character. Geometry type. Must \"points\", \"lines\", \"polygons\" atts data.frame attributes. number rows must match number geometrical elements crs character. coordinate reference system one following formats: WKT/WKT2, <authority>:<code>, PROJ-string notation (see crs) proxy logical. TRUE SpatVectorProxy returned character indicating read. Either \"\" geometries attributes, \"geoms\" read geometries, \"attributes\" read attributes (returned data.frame) opts character. GDAL dataset open options geom character. field name(s) geometry data. Either two names x y coordinates points, single name single column WKT geometries keepgeom logical. TRUE geom variable(s) () also included attributes","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create SpatVector objects — vect","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create SpatVector objects — vect","text":"","code":"### SpatVector from file f <- system.file(\"ex/lux.shp\", package=\"terra\") f #> [1] \"/Users/runner/work/_temp/Library/terra/ex/lux.shp\" v <- vect(f) v #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664  ## subsetting (large) files ## with attribute query  v <- vect(f, query=\"SELECT NAME_1, NAME_2, ID_2 FROM lux WHERE ID_2 < 4\")  ## with an extent e <- ext(5.9, 6.3, 49.9, 50)  v <- vect(f, extent=e)  ## with polygons p <- as.polygons(e) v <- vect(f, filter=p)   ### SpatVector from a geom matrix x1 <- rbind(c(-180,-20), c(-140,55), c(10, 0), c(-140,-60)) x2 <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) x3 <- rbind(c(-125,0), c(0,60), c(40,5), c(15,-45)) hole <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13)) z <- rbind(cbind(object=1, part=1, x1, hole=0), cbind(object=2, part=1, x3, hole=0),       cbind(object=3, part=1, x2, hole=0), cbind(object=3, part=1, hole, hole=1)) colnames(z)[3:4] <- c('x', 'y')  p <- vect(z, \"polygons\") p #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 3, 0  (geometries, attributes) #>  extent      : -180, 160, -60, 60  (xmin, xmax, ymin, ymax) #>  coord. ref. :    z[z[, \"hole\"]==1, \"object\"] <- 4 lns <- vect(z[,1:4], \"lines\") plot(p) lines(lns, col=\"red\", lwd=2)   ### from wkt v <- vect(\"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\")  wkt <- c(\"MULTIPOLYGON ( ((40 40, 20 45, 45 30, 40 40)),  ((20 35, 10 30, 10 10, 30 5, 45 20, 20 35),(30 20, 20 15, 20 25, 30 20)))\",  \"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\") w <- vect(wkt)  # combine two SpatVectors  vw <- rbind(w, v)  # add a data.frame d <- data.frame(id=1:2, name=c(\"a\", \"b\")) values(w) <- d  # add data.frame on creation, here from a geom matrix g <- geom(w) d <- data.frame(id=1:2, name=c(\"a\", \"b\")) m <- vect(g, \"polygons\", atts=d, crs=\"+proj=longlat +datum=WGS84\")  ### SpatVector from a data.frame d$wkt <- wkt x <- vect(d, geom=\"wkt\")  d$wkt <- NULL d$lon <- c(0,10) d$lat <- c(0,10) x <- vect(d, geom=c(\"lon\", \"lat\"))  # SpatVector to sf #sf::st_as_sf(x)"},{"path":"https://rspatial.github.io/terra/reference/vector_layers.html","id":null,"dir":"Reference","previous_headings":"","what":"List or remove layers from a vector file — vector_layers","title":"List or remove layers from a vector file — vector_layers","text":"List remove layers vector file supports layers GPGK","code":""},{"path":"https://rspatial.github.io/terra/reference/vector_layers.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"List or remove layers from a vector file — vector_layers","text":"","code":"vector_layers(filename, delete=\"\", return_error=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/vector_layers.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"List or remove layers from a vector file — vector_layers","text":"filename character. filename delete character. layers deleted (ignored value \"\" return_error logical. TRUE, error occurs layers deleted. Otherwise warning given","code":""},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute a viewshed — viewshed","title":"Compute a viewshed — viewshed","text":"Use elevation data compute locations can seen, much higher seen, certain position. raster data coordinate reference system must planar (lon/lat), elevation values unit distance unit coordinate reference system.","code":""},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute a viewshed — viewshed","text":"","code":"# S4 method for SpatRaster viewshed(x, loc, observer=1.80, target=0, curvcoef=6/7, output=\"yes/no\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute a viewshed — viewshed","text":"x SpatRaster, single layer elevation values. Values unit map units loc location (x y coordinates) cell number observer numeric. height elevation data observer target numeric. height elevation data targets curvcoef numeric. Coefficient consider effect curvature earth refraction atmosphere. elevation values corrected : elevation = elevation - curvcoeff * (distance)^2 / (earth_diameter). means default value 0.85714, lose sight 1 meter elevation 385 m planar distance output character. Can \"yes/\" get binary (logical) output showing areas visible; \"land\" get height current elevation visible; \"sea\" elevation sea level visible filename character. Output filename ... Options writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Compute a viewshed — viewshed","text":"algorithm used Wang et al.: https://www.asprs.org/wp-content/uploads/pers/2000journal/january/2000_jan_87-90.pdf.","code":""},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute a viewshed — viewshed","text":"","code":"if (gdal() >= 3.1) {   f <- system.file(\"ex/elev.tif\", package=\"terra\")   r <- rast(f)   x <- project(r, \"EPSG:2169\")   p <- cbind(70300, 96982)   v <- viewshed(x, p, 0, 0, 0.85714) }"},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":null,"dir":"Reference","previous_headings":"","what":"Voronoi diagram and Delaunay triangles — voronoi","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"Get Voronoi diagram Delaunay triangles points, nodes lines polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"","code":"# S4 method for SpatVector voronoi(x, bnd=NULL, tolerance=0, as.lines=FALSE, deldir=FALSE)   # S4 method for SpatVector delaunay(x, tolerance=0, as.lines=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"x SpatVector bnd SpatVector set outer boundary voronoi diagram tolerance numeric >= 0, snapping tolerance (0 snapping) .lines logical. TRUE, lines returned without outer boundary deldir logical. TRUE, deldir used instead GEOS C++ library method. reported deldir choke large data sets","code":""},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"","code":"wkt <- c(\"MULTIPOLYGON ( ((40 40, 20 45, 45 30, 40 40)),    ((20 35, 10 30, 10 10, 30 5, 45 20, 20 35),(30 20, 20 15, 20 25, 30 20)))\",    \"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\") x <- vect(wkt) v <- voronoi(x) v #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 14, 0  (geometries, attributes) #>  extent      : -55, 100, -65, 100  (xmin, xmax, ymin, ymax) #>  coord. ref. :    d <- delaunay(x) d #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 18, 0  (geometries, attributes) #>  extent      : 0, 45, -10, 45  (xmin, xmax, ymin, ymax) #>  coord. ref. :    plot(v, lwd=2, col=rainbow(15)) lines(x, col=\"gray\", lwd=2) points(x)"},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":null,"dir":"Reference","previous_headings":"","what":"Virtual Raster Dataset — vrt","title":"Virtual Raster Dataset — vrt","text":"Create Virtual Raster Dataset (VRT) collection file-based raster datasets (tiles). See  gdalbuildvrt details.","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Virtual Raster Dataset — vrt","text":"","code":"# S4 method for character vrt(x, filename=\"\", options=NULL, overwrite=FALSE, set_names=FALSE, return_filename=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Virtual Raster Dataset — vrt","text":"x character. Filenames raster \"tiles\". , files data , typically non-overlapping, sub-regions raster. See makeTiles filename character. output VRT filename options character. arguments separate vector elements. Options gdalbuildvrt overwrite logical. filename overwritten exists? set_names logical. Add layer names first tile vrt? return_filename logical. TRUE filename returned, otherwise SpatRaster returned","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Virtual Raster Dataset — vrt","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Virtual Raster Dataset — vrt","text":"VRT can reference many datasets. opened time. default open 100 files. increase performance, maximum limit can increased setting GDAL_MAX_DATASET_POOL_SIZE configuration option bigger value setGDALconfig. Note typical user process Linux limited 1024 simultaneously opened files.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Virtual Raster Dataset — vrt","text":"","code":"r <- rast(ncols=100, nrows=100) values(r) <- 1:ncell(r) x <- rast(ncols=2, nrows=2) filename <- paste0(tempfile(), \"_.tif\") ff <- makeTiles(r, x, filename) ff #> [1] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_1.tif\" #> [2] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_2.tif\" #> [3] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_3.tif\" #> [4] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpsTXkfZ/file3511129e2943_4.tif\"  #vrtfile <- paste0(tempfile(), \".vrt\") #v <- vrt(ff, vrtfile)   ## output in lower resolution #vrtfile <- paste0(tempfile(), \".vrt\") #v <- vrt(ff, vrtfile, options = c(\"-tr\", 5, 5)) #head(readLines(vrtfile)) #v"},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":null,"dir":"Reference","previous_headings":"","what":"filenames of VRT tiles — vrt_tiles","title":"filenames of VRT tiles — vrt_tiles","text":"Get filenames tiles Virtual Raster Dataset (VRT)","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"filenames of VRT tiles — vrt_tiles","text":"","code":"vrt_tiles(x)"},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"filenames of VRT tiles — vrt_tiles","text":"x character (filename) SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"filenames of VRT tiles — vrt_tiles","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":null,"dir":"Reference","previous_headings":"","what":"Weighted mean of layers — weighted.mean","title":"Weighted mean of layers — weighted.mean","text":"Compute weighted mean cell layers SpatRaster. weights can spatially variable .","code":""},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Weighted mean of layers — weighted.mean","text":"","code":"# S4 method for SpatRaster,numeric weighted.mean(x, w, na.rm=FALSE, filename=\"\", ...)  # S4 method for SpatRaster,SpatRaster weighted.mean(x, w, na.rm=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Weighted mean of layers — weighted.mean","text":"x SpatRaster w vector weights (one number layer), spatially variable weights, SpatRaster weights (extent, resolution number layers x) na.rm Logical. missing values removed? filename character. Output filename ... options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Weighted mean of layers — weighted.mean","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Weighted mean of layers — weighted.mean","text":"","code":"b <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     # give least weight to first layer, most to last layer wm1 <- weighted.mean(b, w=1:3)  # spatially varying weights # weigh by column number w1 <- init(b, \"col\")  # weigh by row number w2 <- init(b, \"row\") w <- c(w1, w2, w2)  wm2 <- weighted.mean(b, w=w)"},{"path":"https://rspatial.github.io/terra/reference/where.html","id":null,"dir":"Reference","previous_headings":"","what":"Where are the cells with the min or max values? — where","title":"Where are the cells with the min or max values? — where","text":"method returns cell numbers cells min max values layer SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Where are the cells with the min or max values? — where","text":"","code":"# S4 method for SpatRaster where.min(x, values=TRUE, list=FALSE)  # S4 method for SpatRaster where.max(x, values=TRUE, list=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Where are the cells with the min or max values? — where","text":"x SpatRaster values logical. TRUE min max values also returned list logical. TRUE list returned instead matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Where are the cells with the min or max values? — where","text":"matrix list","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Where are the cells with the min or max values? — where","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) where.min(r) #>      layer cell value #> [1,]     1 7770   141 #> [2,]     1 8055   141"},{"path":"https://rspatial.github.io/terra/reference/which.html","id":null,"dir":"Reference","previous_headings":"","what":"Which cells are TRUE? — which.lyr","title":"Which cells are TRUE? — which.lyr","text":"method returns single layer SpatRaster cell values indicating first layer input TRUE. numbers zero (FALSE), considered TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Which cells are TRUE? — which.lyr","text":"","code":"# S4 method for SpatRaster which.lyr(x)"},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Which cells are TRUE? — which.lyr","text":"x SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Which cells are TRUE? — which.lyr","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Which cells are TRUE? — which.lyr","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- which.lyr(s > 100)"},{"path":"https://rspatial.github.io/terra/reference/width.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatVector geometric properties — width","title":"SpatVector geometric properties — width","text":"width returns minimum diameter geometry, defined smallest band contains geometry, band strip plane defined two parallel lines. can thought smallest hole geometry can moved , single rotation. clearance returns minimum clearance geometry. minimum clearance smallest amount vertex moved produce invalid polygon, non-simple linestring, multipoint repeated points. geometry minimum clearance 'mc', can said : two distinct vertices geometry separated less 'mc' vertex closer 'mc' line segment endpoint. minimum clearance defined geometry (single point, multipoint whose points identical, NA returned.","code":""},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatVector geometric properties — width","text":"","code":"# S4 method for SpatVector width(x, as.lines=FALSE) # S4 method for SpatVector clearance(x, as.lines=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatVector geometric properties — width","text":"x SpatVector lines polygons .lines logical. TRUE lines returned define width clearance","code":""},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatVector geometric properties — width","text":"numeric SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatVector geometric properties — width","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) width(v) #>  [1] 25511.501 20333.498 19019.103  9255.223 20141.189 14308.518 15475.916 #>  [8] 18111.001 17435.502 15750.096 18936.122 15692.522 clearance(v) #>  [1] 24.349993 50.070894 31.878312 51.390103 13.517168 15.960117  2.871879 #>  [8] 17.584083  9.023613  4.239727  8.231322 60.918397"},{"path":"https://rspatial.github.io/terra/reference/window.html","id":null,"dir":"Reference","previous_headings":"","what":"Set a window — window","title":"Set a window — window","text":"Assign window (area interest) SpatRaster SpatExtent, set NULL remove window. similar crop without actually creating new dataset. window intersect extent SpatRaster. envisioned future version, window may also go outside boundaries.","code":""},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set a window — window","text":"","code":"# S4 method for SpatRaster window(x)<-value  # S4 method for SpatRaster window(x)"},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set a window — window","text":"x SpatRaster value SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set a window — window","text":"none window<- logical window","code":""},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set a window — window","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\")  r <- rast(f) global(r, \"mean\", na.rm=TRUE) #>               mean #> elevation 348.3366 e <- ext(c(5.9, 6,49.95, 50))  window(r) <- e global(r, \"mean\", na.rm=TRUE) #>               mean #> elevation 396.4167 r #> class       : SpatRaster  #> dimensions  : 6, 12, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> window      : 5.9, 6, 49.95, 50  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : elev.tif  #> name        : elevation  #> min value   :      >141  #> max value   :      547<   x <- rast(f) xe <- crop(x, e) global(xe, \"mean\", na.rm=TRUE) #>               mean #> elevation 396.4167  b <- c(xe, r) window(b) #> [1] FALSE  TRUE b #> class       : SpatRaster  #> dimensions  : 6, 12, 2  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent (win): 5.9, 6, 49.95, 50  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> sources     : memory   #>               elev.tif   #> varnames    : elev  #>               elev  #> names       : elevation, elevation  #> min values  :       323,      >141  #> max values  :       492,      547<   window(r) <- NULL r #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : elev.tif  #> name        : elevation  #> min value   :       141  #> max value   :       547"},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":null,"dir":"Reference","previous_headings":"","what":"wrap and unwrap — wrap","title":"wrap and unwrap — wrap","text":"Use wrap pack SpatVector SpatRaster* create Packed* object. Packed objects can passed connection serializes (e.g. nodes computer cluster). receiving end need unpacked unwrap.","code":""},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"wrap and unwrap — wrap","text":"","code":"# S4 method for SpatRaster wrap(x, proxy=FALSE)  # S4 method for SpatRasterDataset wrap(x, proxy=FALSE)  # S4 method for SpatRasterCollection wrap(x, proxy=FALSE)  # S4 method for SpatVector wrap(x)  # S4 method for ANY unwrap(x)"},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"wrap and unwrap — wrap","text":"x SpatVector, SpatRaster, SpatRasterDataset SpatRasterCollection proxy logical. FALSE raster cell values forced memory possible. TRUE, reference source filenames stored data sources memory","code":""},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"wrap and unwrap — wrap","text":"wrap: Packed* object unwrap: SpatVector, SpatRaster, SpatRasterCollection, SpatRasterDataset","code":""},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"wrap and unwrap — wrap","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) p <- wrap(v) p #> [1] \"This is a PackedSpatVector object. Use 'terra::unwrap()' to unpack it\" vv <- vect(p) vv #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664"},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster wrap with caching options — wrapCache","title":"SpatRaster wrap with caching options — wrapCache","text":"Use wrap pack SpatRaster caching options. See wrap general approach easier better use cases. method allows specifying folder, filenames, cache sources SpatRaster specific location (disk).","code":""},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster wrap with caching options — wrapCache","text":"","code":"# S4 method for SpatRaster wrapCache(x, filename=NULL, path=NULL, overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster wrap with caching options — wrapCache","text":"x SpatRaster filename character. single filename, one filename per SpatRaster data source. NULL, raster sources saved files path character. NULL, path raster sources saved. Ignored filenames NULL overwrite existing files overwritten files path NULL? value TRUE FALSE, files exist created ... Additional arguments writeRaster. used raster sources memory, sources cached copying files","code":""},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster wrap with caching options — wrapCache","text":"PackedSpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster wrap with caching options — wrapCache","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f)  x <- wrapCache(r, path=tempdir()) x #> [1] \"This is a PackedSpatRaster object. Use 'terra::unwrap()' to unpack it\""},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":null,"dir":"Reference","previous_headings":"","what":"Write raster data to a NetCDF file — writeCDF","title":"Write raster data to a NetCDF file — writeCDF","text":"Write SpatRaster SpatRasterDataset NetCDF file. using SpatRasterDataset, varname, longname, unit set object (see examples). Always use \".nc\" \".cdf\" file extension assure file can properly read GDAL","code":""},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write raster data to a NetCDF file — writeCDF","text":"","code":"# S4 method for SpatRaster writeCDF(x, filename, varname, longname=\"\", unit=\"\", split=FALSE, ...)  # S4 method for SpatRasterDataset writeCDF(x, filename, overwrite=FALSE, zname=\"time\", atts=\"\",      gridmap=\"\", prec=\"float\", compression=NA, missval, ...)"},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write raster data to a NetCDF file — writeCDF","text":"x SpatRaster SpatRasterDataset filename character. Output filename varname character. Name dataset longname character. Long name dataset unit character. Unit data split logical. TRUE layer x treated sub-dataset atts character. vector additional global attributes write. must formatted like c(\"x=value\", \"y=abc\") gridmap character. crs always writting file standard formats. argument can also write format commonly used netcdf files. Something like c(\"grid_mapping_name=lambert_azimuthal_equal_area\", \"longitude_of_projection_origin=10\", \"latitude_of_projection_origin=52\", \"false_easting=4321000\", \"false_northing=3210000\") overwrite logical. TRUE, filename overwritten zname character. name \"time\" dimension prec character. One \"double\", \"float\", \"integer\", \"short\", \"byte\" \"char\" compression Can set integer 1 (least compression) 9 (compression) missval numeric, number used indicate missing values ... additional arguments passed SpatRasterDataset method, possibly ncvar_def","code":""},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Write raster data to a NetCDF file — writeCDF","text":"SpatRaster SpatDataSet","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write raster data to a NetCDF file — writeCDF","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) fname <- paste0(tempfile(), \".nc\") rr <- writeCDF(r, fname, overwrite=TRUE, varname=\"alt\",        longname=\"elevation in m above sea level\", unit=\"m\")  a <- rast(ncols=5, nrows=5, nl=50) values(a) <- 1:prod(dim(a)) time(a) <- as.Date(\"2020-12-31\") + 1:nlyr(a) aa <- writeCDF(a, fname, overwrite=TRUE, varname=\"power\",        longname=\"my nice data\", unit=\"U/Pa\")  b <- sqrt(a) s <- sds(a, b) names(s) <- c(\"temp\", \"prec\") longnames(s) <- c(\"temperature (C)\", \"precipitation (mm)\") units(s) <- c(\"°C\", \"mm\") ss <- writeCDF(s, fname, overwrite=TRUE)  # for CRAN file.remove(fname) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":null,"dir":"Reference","previous_headings":"","what":"Write raster data to a file — writeRaster","title":"Write raster data to a file — writeRaster","text":"Write SpatRaster file.","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write raster data to a file — writeRaster","text":"","code":"# S4 method for SpatRaster,character writeRaster(x, filename, overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write raster data to a file — writeRaster","text":"x SpatRaster filename character. Output filename. Can single filename, many filenames nlyr(x) write file layer overwrite logical. TRUE, filename overwritten ... additional arguments writing files. See Details","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Write raster data to a file — writeRaster","text":"SpatRaster. function used side-effect writing values file.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Write raster data to a file — writeRaster","text":"writeRaster, methods generate SpatRasters, options writing raster files disk can provided additional arguments , cases, wopt argument (named list) additional arguments already used different purpose. See terraOptions get set default values. following options available:","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Write raster data to a file — writeRaster","text":"GeoTiff files , default, written LZW compression. want compression, use gdal=\"COMPRESS=NONE\". writing integer values lowest available value (given datatype) used represent NA signed types, highest value used unsigned values. can problem byte data (0 255) value 255 reserved NA. keep value 255, need set another value NAflag, set NAflag (NAflag=NA)","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write raster data to a file — writeRaster","text":"","code":"r <- rast(nrows=5, ncols=5, vals=1:25)  # create a temporary filename for the example f <- file.path(tempdir(), \"test.tif\")  writeRaster(r, f, overwrite=TRUE)  writeRaster(r, f, overwrite=TRUE, gdal=c(\"COMPRESS=NONE\", \"TFW=YES\"), datatype='INT1U')  ## Or with a wopt argument:  writeRaster(r, f, overwrite=TRUE, wopt= list(gdal=c(\"COMPRESS=NONE\"), datatype='INT1U'))  ## remove the file unlink(f)"},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":null,"dir":"Reference","previous_headings":"","what":"Write SpatVector data to a file — writeVector","title":"Write SpatVector data to a file — writeVector","text":"Write SpatVector file. can choose one many file formats.","code":""},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write SpatVector data to a file — writeVector","text":"","code":"# S4 method for SpatVector,character writeVector(x, filename, filetype=NULL, layer=NULL, insert=FALSE,     overwrite=FALSE, options=\"ENCODING=UTF-8\")"},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write SpatVector data to a file — writeVector","text":"x SpatVector filename character. Output filename filetype character. file format associated GDAL \"driver\" \"ESRI Shapefile\". See gdal(drivers=TRUE) GDAL docs. NULL attempted guess filetype filename extension layer character. Output layer name. NULL filename used insert logical. TRUE, new layer inserted file, format allows (e.g. GPKG allows ). See vector_layers remove layer overwrite logical. TRUE, filename overwritten options character. Format specific GDAL options \"ENCODING=UTF-8\". Use NULL \"\" use options","code":""},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write SpatVector data to a file — writeVector","text":"","code":"v <- vect(cbind(1:5,1:5)) crs(v) <- \"+proj=longlat +datum=WGS84\" v$id <- 1:length(v) v$name <- letters[1:length(v)] tmpf1 <- paste0(tempfile(), \".gpkg\") writeVector(v, tmpf1, overwrite=TRUE) x <- vect(tmpf1)  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) tmpf2 <- paste0(tempfile(), \".gpkg\") writeVector(v, tmpf2, overwrite=TRUE) y <- vect(tmpf2)"},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to the cells of a two SpatRasters — xapp","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"Apply function values cell two (multilayer) SpatRasters.","code":""},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"","code":"# S4 method for SpatRaster,SpatRaster xapp(x, y, fun, ..., filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"x SpatRaster y SpatRaster geometry x fun function operates two vectors ... additional arguments fun. typically numerical constants. *never* another SpatRaster filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"","code":"r <- rast(ncols=10, nrows=10, nlyr=5) set.seed(1) r <- init(r, runif) s <- init(r, runif) x <- xapp(r, s, fun=cor)"},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":null,"dir":"Reference","previous_headings":"","what":"Get or set single values of an extent — xmin","title":"Get or set single values of an extent — xmin","text":"Get set single values extent. Values can set SpatExtent SpatRaster, SpatVector)","code":""},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get or set single values of an extent — xmin","text":"","code":"# S4 method for SpatExtent xmin(x)  # S4 method for SpatExtent xmax(x)  # S4 method for SpatExtent ymin(x)  # S4 method for SpatExtent ymax(x)  # S4 method for SpatRaster xmin(x)  # S4 method for SpatRaster xmax(x)  # S4 method for SpatRaster ymin(x)  # S4 method for SpatRaster ymax(x)  # S4 method for SpatVector xmin(x)  # S4 method for SpatVector xmax(x)  # S4 method for SpatVector ymin(x)  # S4 method for SpatVector ymax(x)  # S4 method for SpatRaster,numeric xmin(x)<-value  # S4 method for SpatRaster,numeric xmax(x)<-value  # S4 method for SpatRaster,numeric ymin(x)<-value  # S4 method for SpatRaster,numeric ymax(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get or set single values of an extent — xmin","text":"x SpatRaster, SpatExtent, SpatVector value numeric","code":""},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get or set single values of an extent — xmin","text":"SpatExtent numeric coordinate","code":""},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get or set single values of an extent — xmin","text":"","code":"r <- rast() ext(r) #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax) ext(c(0, 20, 0, 20)) #> SpatExtent : 0, 20, 0, 20 (xmin, xmax, ymin, ymax)  xmin(r) #> [1] -180 xmin(r) <- 0 xmin(r) #> [1] 0"},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":null,"dir":"Reference","previous_headings":"","what":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"Get coordinates center raster cells row, column, cell number SpatRaster. get row, column, cell numbers coordinates . Cell numbers start 1 upper left corner, increase left right, top bottom. last cell number equals number cells SpatRaster. row numbers start 1 top, column numbers start 1 left.","code":""},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"","code":"# S4 method for SpatRaster,numeric xFromCol(object, col)  # S4 method for SpatRaster,numeric yFromRow(object, row)  # S4 method for SpatRaster,numeric xyFromCell(object, cell)  # S4 method for SpatRaster,numeric xFromCell(object, cell)  # S4 method for SpatRaster,numeric yFromCell(object, cell)  # S4 method for SpatRaster,numeric colFromX(object, x)  # S4 method for SpatRaster,numeric rowFromY(object, y)  # S4 method for SpatRaster,numeric,numeric cellFromRowCol(object, row, col)  # S4 method for SpatRaster,numeric,numeric cellFromRowColCombine(object, row, col)  # S4 method for SpatRaster,numeric,numeric rowColCombine(object, row, col)  # S4 method for SpatRaster,numeric rowFromCell(object, cell)  # S4 method for SpatRaster,numeric colFromCell(object, cell)  # S4 method for SpatRaster,numeric rowColFromCell(object, cell)  # S4 method for SpatRaster,matrix cellFromXY(object, xy)"},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"object SpatRaster cell integer. cell number(s) col integer. column number(s) missing (equivalent columns) row integer. row number(s) missing (equivalent rows) x x coordinate(s) y y coordinate(s) xy matrix x y coordinates","code":""},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"Cell numbers start 1 upper left corner, increase left right, top bottom. last cell number equals number cells SpatRaster (see ncell).","code":""},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"xFromCol, yFromCol, xFromCell, yFromCell: vector x y coordinates xyFromCell: matrix(x,y) coordinate pairs colFromX, rowFromY, cellFromXY, cellFromRowCol, rowFromCell, colFromCell: vector row, column, cell numbers rowColFromCell, rowColCombine: matrix row column numbers","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"","code":"r <- rast()  xFromCol(r, c(1, 120, 180)) #> [1] -179.5  -60.5   -0.5 yFromRow(r, 90) #> [1] 0.5 xyFromCell(r, 10000) #>         x    y #> [1,] 99.5 62.5 xyFromCell(r, c(0, 1, 32581, ncell(r), ncell(r)+1)) #>           x     y #> [1,]    NaN   NaN #> [2,] -179.5  89.5 #> [3,]    0.5  -0.5 #> [4,]  179.5 -89.5 #> [5,]    NaN   NaN  cellFromRowCol(r, 5, 5) #> [1] 1445 cellFromRowCol(r, 1:2, 1:2) #> [1]   1 362 cellFromRowCol(r, 1, 1:3) #> [1] 1 2 3  # all combinations cellFromRowColCombine(r, 1:2, 1:2) #> [1]   1   2 361 362  colFromX(r, 10) #> [1] 191 rowFromY(r, 10) #> [1] 81 xy <- cbind(lon=c(10,5), lat=c(15, 88)) cellFromXY(r, xy) #> [1] 27191   906  # if no row/col specified all are returned range(xFromCol(r)) #> [1] -179.5  179.5 length(yFromRow(r)) #> [1] 180"},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":null,"dir":"Reference","previous_headings":"","what":"Zonal statistics — zonal","title":"Zonal statistics — zonal","text":"Compute zonal statistics, summarize values SpatRaster \"zone\" defined another SpatRaster, SpatVector polygon geometry. fun true R function, <SpatRaster,SpatRaster> method may fail using large SpatRasters, except functions (\"mean\", \"min\", \"max\", \"sum\", \"isNA\", \"notNA\"). can also summarize values SpatVector polygon (zone) defined another SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Zonal statistics — zonal","text":"","code":"# S4 method for SpatRaster,SpatRaster zonal(x, z, fun=\"mean\", ..., w=NULL, wide=TRUE,     as.raster=FALSE, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRaster,SpatVector zonal(x, z, fun=\"mean\", na.rm=FALSE, w=NULL, weights=FALSE,     exact=FALSE, touches=FALSE, small=TRUE, as.raster=FALSE,     as.polygons=FALSE, wide=TRUE, filename=\"\", wopt=list())  # S4 method for SpatVector,SpatVector zonal(x, z, fun=mean, ..., weighted=FALSE, as.polygons=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Zonal statistics — zonal","text":"x SpatRaster SpatVector z SpatRaster cell-values representing zones SpatVector polygon geometry representing zone. z can multiple layers define intersecting zones fun function applied summarize values zone. Either character: \"mean\", \"min\", \"max\", \"sum\", \"isNA\", \"notNA\" , relatively small SpatRasters, proper function ... additional arguments passed fun, na.rm=TRUE w SpatRaster weights. single-layer non-negative values wide logical. values returned wide format? SpatRaster, SpatRaster method affects results nlyr(z) == 2. SpatRaster, SpatVector method affects results fun=table .raster logical. TRUE, SpatRaster returned zonal statistic zone filename character. Output filename (ignored .raster=FALSE overwrite logical. TRUE, filename overwritten wopt list additional arguments writing files writeRaster weights logical. TRUE y polygons, approximate fraction cell covered returned well, example compute weighted mean exact logical. TRUE y polygons, exact fraction cell covered returned well, example compute weighted mean touches logical. TRUE, values cells touched lines polygons extracted, just line render path, whose center point within polygon. relevant points; always considered TRUE weights=TRUE exact=TRUE small logical. TRUE, values cells touched polygons extracted none cells center points within polygon; even touches=FALSE weighted logical. TRUE, weighted.mean computed fun ignored. Weights based length lines area polygons x intersect z. argument ignored x SpatVector points .polygons logical. zonal statistics combined geometry z? na.rm logical. TRUE, NAs removed","code":""},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Zonal statistics — zonal","text":"data.frame value zone, SpatRaster, SpatVector polygons.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Zonal statistics — zonal","text":"","code":"### SpatRaster, SpatRaster r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) z <- rast(r) values(z) <- rep(c(1:2, NA, 3:4), each=20) names(z) <- \"zone\" zonal(r, z, \"sum\", na.rm=TRUE) #>   zone lyr.1 #> 1    1   210 #> 2    2   610 #> 3    3  1410 #> 4    4  1810  # with weights  w <- init(r, \"col\") zonal(r, z, w=w, \"mean\", na.rm=TRUE) #>   zone lyr.1 #> 1    1    12 #> 2    2    32 #> 3    3    72 #> 4    4    92  # multiple layers r <- rast(system.file(\"ex/logo.tif\", package = \"terra\"))  # zonal layer  z <- rast(r, 1) names(z) <- \"zone\" values(z) <- rep(c(1:2, NA, c(3:4)), each=ncell(r)/5, length.out=ncell(r))  zonal(r, z, \"mean\", na.rm = TRUE) #>   zone      red    green     blue #> 1    1 197.9486 198.0103 193.5556 #> 2    2 173.2219 176.7717 185.2585 #> 3    3 168.2952 172.6232 184.6939 #> 4    4 193.5859 197.0019 206.5717  # raster of zonal values zr <- zonal(r, z, \"mean\", na.rm = TRUE, as.raster=TRUE)   ### SpatRaster, SpatVector x <- rast(ncol=2,nrow=2, vals=1:4, xmin=0, xmax=1, ymin=0, ymax=1, crs=\"+proj=utm +zone=1\") p <- as.polygons(x) pp <- shift(p, .2) r <- disagg(x, 4)  zonal(r, p) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 zonal(r, p, sum) #>   lyr.1 #> 1    16 #> 2    32 #> 3    48 #> 4    64 zonal(x, pp, exact=TRUE) #>   lyr.1 #> 1   1.4 #> 2   2.0 #> 3   3.4 #> 4   4.0 zonal(c(x, x*10), pp, w=x) #>   lyr.1 lyr.1 #> 1     1    10 #> 2     2    20 #> 3     3    30 #> 4     4    40   ### SpatVector, SpatVector  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)[,c(2,4)]  p <- spatSample(v, 100) values(p) <- data.frame(b2=1:100, ssep1=100:1)  zonal(p, v, mean) #>    zone       b2    ssep1 #> 1     1 45.60000 55.40000 #> 2     2 45.66667 55.33333 #> 3     3 49.00000 52.00000 #> 4     4 66.66667 34.33333 #> 5     5 50.66667 50.33333 #> 6     6 59.33333 41.66667 #> 7     7 59.16667 41.83333 #> 8     8 48.88889 52.11111 #> 9     9 55.40000 45.60000 #> 10   10 49.42857 51.57143 #> 11   11 40.85714 60.14286 #> 12   12 48.16667 52.83333"},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":null,"dir":"Reference","previous_headings":"","what":"Zoom in on a map — zoom","title":"Zoom in on a map — zoom","text":"Zoom map (plot) providing new extent, default done clicking twice map.","code":""},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Zoom in on a map — zoom","text":"","code":"# S4 method for SpatRaster zoom(x, e=draw(), maxcell=100000, layer=1, new=FALSE, ...)  # S4 method for SpatVector zoom(x, e=draw(), new=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Zoom in on a map — zoom","text":"x SpatRaster e SpatExtent maxcell positive integer. Maximum number cells used map layer positive integer select layer used new logical. TRUE, zoomed map appear new device (window) ... additional arguments passed plot","code":""},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Zoom in on a map — zoom","text":"SpatExtent (invisibly)","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-76","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-76","text":"writeVector readVector better handle empty geopackage layers #1426 Andrew Gene Brown. writeCDF wrote global variables one #1443 Daniel Schlaepfer rasterize “” returned odd layernames #1435 Philippe Massicotte convHull, minCircle minRect zero-row SpatVector crashed R #1445 Andrew Gene Brown rangeFill argument circular=TRUE work properly #1460 Alice crs(describe = TRUE) returned mis-ordered extent #1485 Dimitri Falk tapp custom function index like “yearmonths” shift time considering time zone. #1483 Finn Roberts plot<SpatRaster> fail multiple values small differences #1491 srfall .data.frame<SpatRaster> “xy=TRUE” “wide=FALSE” fail coordinates similar #1476 Pascal Oettli rasterizeGeom now returns correct layer name #1472 HRodenhizer cellSize “mask=TRUE” failed output written temp file #1496 Pascal Sauer ext<SpatVectorProxy> return full extent #1501 erkent-carb","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-76","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-76","text":"extract new argument “small=TRUE” allow strict use “touches=FALSE” #1419 Floris Vanderhaeghe. .list<SpatRaster> new argument “geom=NULL” rast<list> now recognizes (x, y, z) base R “image” structures stackoverflow Ignacio Marzan. inset new arguments “offset” “add” #1422 Armand-CT expanse<SpatRaster> argument usenames #1446 Bappa Das default color palette now terra::map.pal(\"viridis\") instead terrain.colors. default can changes options(terra.pal=...) #1474 Derek Friend .list<SpatRasterDataset> now returns named list. #1513 Eric R. Scott","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-76","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-76","text":"bestMatch<SpatRaster> method argument “pairs=TRUE” cells https://github.com/rspatial/terra/issues/1487 Floris Vanderhaeghe add_grid add grid map","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-71","dir":"Changelog","previous_headings":"","what":"version 1.7-71","title":"version 1.7-71","text":"CRAN release: 2024-01-31 Released 2023-01-31","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-71","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-71","text":"k_means work NAs #1314 Jakub Nowosad layerCor custom function work anymore #1387 Jakub Nowosad plet broke using “panel=TRUE” #1384 Elise Hellwig using /vis3/ open SpatRaster work #1382 Mike Koontz plot<SpatRaster>(add=TRUE) sampled raster data without considering extent map. #1394 Márcia Barbosa plot<SpatRaster>(add=TRUE) now considers first layer multi-layer SpatRaster 1395 Márcia Barbosa set.cats failed tibble used instead data.frame #1406 Mike Koontz polys argument “alpha” ignored single color used. #1413 Derek Friend query ignore “vars” argument rows selected. #1398 erkent-carb. spatSample ignored “replace=TRUE” random sampling, na.rm=TRUE, sample size larger non NA cells. #1411 Babak Naimi spatSample sometimes returned fewer values requested available lonlat rasters. #1396 Márcia Barbosa.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-71","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-71","text":"vect<character> now argument “opts” GDAL open options, e.g. declare file encoding. #1389 Mats Blomqvist plot(plg=list(tic=\"\")) now allows choosing alternative continuous legend tic-mark styles (“”, “”, “” “none”) makeTiles new argument “buffer” #1408 Joy Flowers.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-71","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-71","text":"prcomp<SpatRaster> method #1361 Jakub Nowosad add_box add box around map. box drawn axes , around plotting region. getTileExtents provides extents tiles. may used parallelization. See #1391 Alex Ilich.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-65","dir":"Changelog","previous_headings":"","what":"version 1.7-65","title":"version 1.7-65","text":"CRAN release: 2023-12-15 Released 2023-12-15","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-65","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-65","text":"flip argument direction=\"vertical\" filed cases large rasters processed chunks 0b714b0 Dulci stackoveflow SpatRaster now correctly handles NA & FALSE NA | TRUE #1316 John Baums set.names wasn’t working properly SpatRasterDataset SpatRasterCollection #1333 Derek Friend extract argument “layer” NULL shifted layers #1332 Ewan Wakefield terraOptions capture “memmin” stackoverflow dww rasterize points built-function crash field used #1369 anjelinejeline","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-65","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-65","text":"mosaic can now use fun=\"modal\" rast<matrix> rast<data.frame> now option ’type=“xylz” #1318 Agustin Lobo extract<SpatRaster,SpatVector> can now use multiple summarizing functions #1335 Derek Friend disagg focal optimistic memory requirement estimation #1334 Mikko Kuronen","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-65","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-65","text":"k_means<SpatRaster> method #1314 Agustin Lobo princomp<SpatRaster> method #1361 Alex Ilich .time<SpatRaster> method new argument “raw=FALSE” rast, sds, sprc allow ignoring scale offset 1354 Insang Song","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-55","dir":"Changelog","previous_headings":"","what":"version 1.7-55","title":"version 1.7-55","text":"CRAN release: 2023-10-13 Released 2023-10-14","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-55","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-55","text":"mosaic ignored filename argument SpatRasterCollection single SpatRaster #1267 Michael Mahoney Attempting use extract raster file deleted crashed R. #1268 Derek Friend split<SpatVector,SpatVector> work well cases. #1256 Derek Corcoran Barrios intersect two SpatVectors crashed R date/time variable #1273 Dave Dixon “values=FALSE” ignored spatSample<SpatRaster>(method=\"weights\") #1275 François Rousseu coltab<- works list value #1280 Diego Hernangómez stretch histogram equalization memory-safe #1305 Evan Hersh plot now resets “mar” parameter #1297 Márcia Barbosa plotRGB ignored “smooth” argument #1307 Timothée Giraud","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-55","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-55","text":"argument “gdal” project renamed “use_gdal” #1269 Stuart Brown. SpatVector attributes can now stored ordered factor #1277 Ben Notkin plot<SpatVector> now uses “interval” legend breaks supplied #1303 Gonzalo Rizzo crop<SpatRaster> now keeps metadata, including variable names #1302 rhgof extract(fun=\"table\") now returns easier use data.frame #1294 Fernando Aramburu.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-55","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-55","text":"metags<- metags set arbitrary SpatRaster/file level metadata #1304 Francesco Chianucci","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-46","dir":"Changelog","previous_headings":"","what":"version 1.7-46","title":"version 1.7-46","text":"CRAN release: 2023-09-06 Released 2023-09-06","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-46","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-46","text":"plot<SpatVector> used wrong main label cases #1210 Márcia Barbosa plotRGB failed “ext=” argument #1228 Dave Edge rast<array> failed badly array less three dimensions. #1254 andreimirt. .equal SpatRaster multiple layers #1236 Sarah Endicott zonal(wide=FALSE) give wrong results zonal SpatRaster “layer” layername. #1251 Jeff Hanson panel now support argument “range” #141 Jakub Nowosad rasterize = returned wrong layernames field sorted #1266 Sebastian Dunnett mosaic multiple layers correct #1262 Jean-Romain","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-46","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-46","text":"wrap<SpatRaster> now stores color tables #1215 Patrick Brown global now “maxcell” argument #1213 Alex Ilich layerCor fun=‘pearson’ now returns output layer names #1206 vrt now argument “set_names” #1244 sam--levy vrt now argument “return_filename” #1258 Krzysztof Dyba project<SpatRaster> new argument “by_util” exposing GDAL warp utility #1222 Michael Sumner.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-46","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-46","text":"compareGeom list SpatRasterCollection #1207 Sarah Endicott .rotated<SpatRaster> method #1229 Andy Lyons forceCCW<SpatVector> method force counter-clockwise orientation polygons #1249 srfall. vrt_tiles returns filenames tiles vrt file #1261 Derek Friend extractAlong extract raster cell values line ordered along line. #1257 adamkc.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-39","dir":"Changelog","previous_headings":"","what":"version 1.7-39","title":"version 1.7-39","text":"CRAN release: 2023-06-23 Released 2023-06-23","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-39","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-39","text":"tempdir option use path.expand. #1195 Alex Ilich layer names returned predict inconsistent using argument “index”. #1194 Michael Mahoney compilation failed older compilers use std::filesystem #1191 Small changes RGB<- coltab<- terra can installed R-devel (bug fix https://bugs.r-project.org/show_bug.cgi?id=18538)","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-37","dir":"Changelog","previous_headings":"","what":"version 1.7-37","title":"version 1.7-37","text":"CRAN release: 2023-06-18 Released 2023-06-18","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-37","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-37","text":"rasterize points custom function work large rasters. #1127 Skip Woolley crop<SpatRaster, SpatVector> “mask=TRUE” work well raster scale/offset #1128 Monika Anna Tomaszewska zonal<SpatRaster> custom function always removed NAs. #1133 Matthias Weigand wrap<SpatRaster> lost changed layer names source disk; information time-step cases. #1144 Pascal Führlich global(fun=\"isNA\") correct SpatRaster multiple layers #1141 Robin Freeman interpIDW near=TRUE work properly (near=TRUE now default). #1186 Hugh Graham “YYYY-1-1” sometimes encoded “YYYY-13-1”. #1168 Colin Brust","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-37","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-37","text":"panel categorical SpatRasters. #1143 Jason Flower argument “ext” plot<SpatRaster> can now also expand plot. #1136 Jakub Nowosad. argument overwrite=FALSE makeTiles. #1167 Gray Martin. legend options <plet,SpatVector>. #1177 Agustin Lobo. better handling mixed geometry type vector data vect svc. #1160 Mike Sumner. new argument sql query<SpatVectorProxy>. #1157 Carl Boettiger support writing raster data vitual file system #1209 Carl Boettiger","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-37","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-37","text":"wrap<SpatRasterDataset> wrap<SpatRasterCollection> methods. #954 James Camac","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-29","dir":"Changelog","previous_headings":"","what":"version 1.7-29","title":"version 1.7-29","text":"CRAN release: 2023-04-21 Released 2023-04-22","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-29","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-29","text":"regress<SpatRaster,numeric> get regression model coefficients cell, fixed “X”. regress<SpatRaster,SpatRaster> get regression model coefficients cell.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-29","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-29","text":"lapp<SpatRasterDataset> now flexible can now also use functions vectorized cell, chunk. See #1029 project<SpatVector> new argument “partial=FALSE” can used keep geometries can partially included output crs. extracting SpatVector column non-existing variable name now returns NULL (data.frame ) instead throwing error. #1118 Derek Friend.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-29","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-29","text":"problem reading empty categories .img files created buggy SpatRasters global fun=“notNA” wrong #111 Jeffrey Hanson extract<SpatRaster,SpatVector> “bind=TRUE” work extract<SpatRaster,SpatVector> point geometries “fun” returned values wrong order plot<SpatRaster> argument “colNA” work “alpha” also set #1102 Márcia Barbosa crop<SpatRaster> “extend=TRUE” extend SpatRaster input cell values. #1114 Jasper van Doninck setting factor date/time variable SpatVector work #1117 MK Schneider focalMat work well using terraOptions(todisk=T) #1116","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-23","dir":"Changelog","previous_headings":"","what":"version 1.7-23","title":"version 1.7-23","text":"CRAN release: 2023-04-08 Released 2023-04-08","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-23","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-23","text":"halo function adding halo-ed text plots now exposed add_legend allow using keyword “topleft” position custom legend. #1053 Márcia Barbosa .crs function now exported countNA<SpatRaster> method split<SpatVector,SpatVector> split polygons lines","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-23","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-23","text":"better support color spaces RGB #1060 Dominic Royé path expansion writeVector #1055 Andrew Gene Brown. clamp<SpatRaster> now also accepts SpatRasters set lower upper boundaries. freq new arguments “zones=NULL” “wide=FALSE”, allow tabulation values zone. expanse<SpatRaster> new arguments “zones=NULL” “wide=FALSE”, allow tabulation values zone. unique<SpatRaster> new argument “digits=NA” rasterize<SpatRaster,SpatVector> now accepts fun=“table” tabulate cells cell value rast<character> new argument “snap” snap window . #1094 Derek Friend plot new argument “clip=TRUE” can set FALSE avoid clipping axes mapped area #1080 Márcia Barbosa better error message coercing sf object fully formed #1098 Brandon McNellis writeCDF<SpatRaster> new argument “split” allowing treat layer subdataset #1077 Andrea Manica global now accepts multiple summarizing functions","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-23","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-23","text":"SpatRaster RGB layers forced INT1U writing #1051 Cesar Aybar files multiple vector layers, crs first layer always used; ignoring crs different layers #1052 Andrew Gene Brown sieve able write file #1061 leo rasterize work sf objects #1054 Jakub Nowosad query work hyphenated layer names #1058 Robbie Price focal3D na.policy work #1057 Flávio Mota layerCor na.rm=TRUE failed SpatRaster 2 layers #1056 Alex Ilich. inset keyword positioning work well #1053 Márcia Barbosa yearmonths time stamps read file years <1970 >2037 #1062 Colin Brust compareGeom work multiple SpatRasters #1063 viewshed handle filename argument. #1100 kamistick","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-18","dir":"Changelog","previous_headings":"","what":"version 1.7-18","title":"version 1.7-18","text":"CRAN release: 2023-03-06 Released 2023-03-06","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-18","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-18","text":"argument order=FALSE sort<SpatRaster> sort<SpatVector> (<data.frame> method argument =NULL rasterize> #986 Sam Weber meta<SpatRaster> method get metadata compare<SpatRaster> logic<SpatRaster> methods vect<SpatExtent> method panel<SpatRaster> “panel” plots (multiple layers, single legend)","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-18","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-18","text":"now possible save terra options across sessions #995 Guillaume Patoine. better warnings .lonlat #1006 Andrew Gene Brown argument na.rm merge<SpatRaster> axes maps created plot now snug around mapped area, instead limits graphics figure region. C++ cleaning avoid warnings clang-tidy (e.g. now using .empty() instead .size()==0). [#1013-1017] Michael Chirico rasterize lines polygons can now use “fun” argument (min, max, mean, sum) #1041 Bart Huntley","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-18","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-18","text":"legend created plet always correct. #983 Simon Rolph spatSample<SpatRaster>(regular=TRUE) failed providing two numbers (row, col) sample size. #991 srfall merge<SpatRaster> ignore NAs #1002 jmmonnet. writeCDF failed using argument force_v4 #1009 R. Kyle Bocinsky predict better handling rasters many NAs #988 Lucas Johnson layerCor handle NAs well different cells across layers #1034 François Rousseu.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-3","dir":"Changelog","previous_headings":"","what":"version 1.7-3","title":"version 1.7-3","text":"CRAN release: 2023-01-24 Released 2023-01-24","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-3","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-3","text":"argument w zonal<SpatRaster,SpatRaster> compute weighted means zonal<SpatRaster,SpatVector> method clamp_ts method","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-3","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-3","text":"previous version, bug introduced order operation arithmetic operations SpatRasters ignored. #978 Andrew Marx Fixed split<SpatVector>. #979 srfall spatSample .df=FALSE returned data.frame instead matrix #982 Alex Ilich","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-53","dir":"Changelog","previous_headings":"","what":"version 1.6-53","title":"version 1.6-53","text":"CRAN release: 2023-01-17 Released 2023-01-17","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-53","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-53","text":"arithmetic logical operations SpatRaster matrix, allow using cell-varying cell/layer-varying scalars. layer-varying scalars already supported via vectors.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-53","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-53","text":"shade now vectorized arguments angle direction facilitate generating multiple hillshades can combined better result #948 Jürgen Niedballa sharedPaths now uses spatial indices #960 Jeff Hanson predict better support models ranger return anything missing values #968 Alex Ilich","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-53","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-53","text":"writeCDF now supports writing yearly time steps #926 Andrea Manica .contour now works single level #966 Johannes Signer subsetting SpatRaster window returned SpatRaster dimensions non-windowed raster, thus changing resolution. #964 Derek Friend removing factor variable SpatVector crashed R. #969 Andrew Gene Brown median always return correct number SpatRaster 3 layers #970 MatteaE","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-47","dir":"Changelog","previous_headings":"","what":"version 1.6-47","title":"version 1.6-47","text":"CRAN release: 2022-12-02 Released 2022-12-02","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-47","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-47","text":"roll<SpatRaster> method rolling (moving) average rolling functions noNA<SpatRaster> method identify cells NA (across layers) rangeFill<SpatRaster> method","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-47","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-47","text":"argument exhaustive spatSample<SpatRaster> large sparse rasters. [#905] PetiteTong. focalPairs focalReg can now use values custom windows weights. [#907] Fabian Fischer. focalReg now additional argument “intercept=TRUE”. [#916] Jordan Adamson crs(x, warn=TRUE)<- now emits warning difference transforming setting crs x already crs. [#897] Márcia Barbosa. now possible write scale offset writeRaster [#900] Kyle David crosstab now shows labels names categorical SpatRaster. [895] Derek Corcoran Barrios makeTiles can now take SpatVector define tiles. [920] Tristan Goodbody","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-47","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-47","text":"focalPairs focalReg now work custom windows [#907] Fabian Fischer argument “alpha” plot<SpatVector> working properly. [#906] Márcia Barbosa. time<- time-step “years” handle negative years. [#911] Andrea Manica wrap/unwrap (extension saveRDS/readRDS) handle categorical rasters well [#912] Christine Anderson. interpIDW failed GDAL 3.6 [#910] Roger Bivand spatSample strata bug fix “unable find inherited method function ‘trim’” [#919] Alfredo Ascanio possible slice SpatRaster SpatExtent [#914] Jakub Nowosad. merge/mosaic handle NAs using two layers [#913] Joao Carreiras.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-6-47","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.6-47","text":"focalCor -> focalPairs reflect possible use beyond correlation","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-41","dir":"Changelog","previous_headings":"","what":"version 1.6-41","title":"version 1.6-41","text":"CRAN release: 2022-11-18 Released 2022-11-18","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-41","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-41","text":"[ [<- SpatRaster now third index k subsetting assigning values layer anyNA allNA SpatRaster unwrap restore PackedSpatVector PackedSpatRaster rasterizeWin method rasterization moving window (circle, ellipse, rectangle, buffer) interpIDW method inverse-distance-weighted interpolation points moving window interpNear method nearest neighbor interpolation points moving window viewshed method SpatRaster update method SpatRaster write new names new extent crs existing raster file. sieve filter SpatRaster argument segments=FALSE disagg<SpatRaster> sprc<character> method create SpatRasterCollection file subdatasets graticule function create SpatGraticule related methods plot<SpatGraticule> crop<SpatGraticule> elongate method SpatVector lines","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-41","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-41","text":"faster mosaic merge<SpatRaster> [#577] Jean-Romain wrap<SpatRaster> now uses file references data deemed large load memory. [#801] Jean-Romain readRDS unserialize now return SpatRaster SpatVector (instead PackedSpat*) better support “local” arbitrary Euclidean crs [#797] Agustin Lobo clamp can now take low high values layer pax argument plot now provides control draw axis via parameters side, tick lab pax argument plot now argument retro use sexagesimal notation degrees extend new argument fill=NA warning now given combining SpatRasters different CRSs. [#818] Andrew Marx plotRGB now accounts value zlim stretching; allowing use coloring scheme across SpatRasters [#810] Agustin Lobo. center rotation spin now vectorized","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-41","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-41","text":"annoying garbage collection messages Error x$.self$finalize() : attempt apply non-function now suppressed cases. [#218] Charlie Joey Hadley. problem go away altogether new version “Rcpp” released (ETA Jan 2023) thanks fix Kevin Ushey [#30] spatSample na.rm SpatRasters multiple layers work. [#800] Andrea Manica adjacent<SpatRaster> pairs=TRUE, include=TRUE ignored include=TRUE [#808] Joseph Lewis rasterize accept “NA” value updating [#809] Márcia Barbosa extract perfectly vertical horizontal line failed cases [#823] Dimitri Falk wrap<SpatVector> failed single point geometry [#815] Patrick Schaefer extract<SpatRaster> weights=TRUE return values [#814] Jean-Luc Dupouey. x[[\"newname\"]] <- r SpatRasters x r work [#795] Jim Shady fixed support non-conventional netCDF files [#869] Mike Sumner, [#864] eleanorecc, [#851] Philippe Massicotte.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-6-41","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.6-41","text":"costDistance -> costDist avoid conflict {gdistance} gridDistance -> gridDist consistency","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-17","dir":"Changelog","previous_headings":"","what":"version 1.6-17","title":"version 1.6-17","text":"CRAN release: 2022-09-10 Released 2022-09-10","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-17","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-17","text":"droplevels SpatRaster. [#757] Rodolfo Jaffe. normalize.longitude SpatVector. scoff get scoff<- set scale (gain) offset SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-17","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-17","text":"new argument raw=FALSE extract<SpatRaster> [#776] Thomas Roh. .data.frame now takes na.rm=NA remove rows NA layers. default value changed TRUE NA. [#792] Ed Carnell faster plotting SpatVector data [#774] Krzysztof Dyba distance<SpatRaster> new arguments “target” “exclude”. [#560] Bernardo Brandão Niebuhr new argument sparse=FALSE `relate<SpatVector,SpatVector>. new argument usenames=FALSE lapp<SpatRasterDataset> [#793] Colin Brust. vect<character> now reports file non-existent [#784] John Baums faster relate [#716] Krzysztof Dyba focal3D now checks window’s dimensions odd [#772] Neander Marcel Heming","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-17","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-17","text":".equal bug [#756] fixed John Baums extract<\"SpatRaster\",\"sf\"> ignored ID argument. [#755] Dainius Masiliūnas. now (cases) check avoid overwriting (one ) input file(s) writing raster file [#760] John Baums vrt longer constrained maximum number files can opened [#780] 8Ginette8 weighted.mean crashed numeric weights na.rm=TRUE [#777] David Holstius project<SpatRaster> consider extent set user [#775] Philippe Massicotte focalCor failed large rasters [#607] John Clark focal expand=TRUE prone run memory [#610] Nathan Elliott crop<SpatVector> work well second argument points lines [#782] Márcia Barbosa adjacent pairs=TRUE now respects include=TRUE argument [808] Joseph Lewis","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-7","dir":"Changelog","previous_headings":"","what":"version 1.6-7","title":"version 1.6-7","text":"CRAN release: 2022-08-07 Released 2022-08-07","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-7","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-7","text":"method blocks guide reading raster data chunks. [#748] John Baums","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-7","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-7","text":"warning given writing raster values outside limits requested datatype [#752] Jim Shady Arguments extract simplified. [#736] François Rousseu","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-7","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-7","text":"values focal correct input SpatRaster multiple layers “custom” function. [#727] Jean-Luc Dupouey. plot<SpatRaster> honor argument legend=FALSE. [#738] Grzegorz Sapijaszko expanse failed processing chunks [#741] Gareth Davies crop<SpatRaster,SpatExtent> argument snap=\"\" lead crash extent beyond SpatRaster. [#740] Mauricio Zambrano-Bigiarini","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-3","dir":"Changelog","previous_headings":"","what":"version 1.6-3","title":"version 1.6-3","text":"CRAN release: 2022-07-25 Released 2022-07-25","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-3","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-3","text":"subst longer uses values changed earlier . [#639] Paul Smith .points<SpatRaster> return wrong factor labels. [#640] Attilio Benini mask<SpatRaster,SpatVector> crashed results written disk. [#646] Monika Anna Tomaszewska extract<SpatRaster,SpatVector(points)>(xy=TRUE) returned locations points, xy-coordinates cells. [#650] Ward Fonteyn wrap<SpatRaster> return correct labels categorical rasters. [#652] Jakub Nowosad better support non-latin characters legend [#658] Krzysztof Dyba holes small lon/lat polygons now properly buffered [#689] David Hofmann","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-3","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-3","text":"subst can now substitute values multiple input layers single output value (layer) subset<SpatVector> now behaves like subset<data.frame> [#648] Andrew Gene Brown setting category labels vector names now deprecated. data.frame least two columns used. first column cell values (IDs). now possible “drop” layer SpatRaster setting NULL [#664] Daniel Valentins freq now provides labels factors, even bylayer=FALSE. now always returns data.frame (used return matrix cases. [#687] Rodolfo Jaffé disagg aggregate now return warning instead error using (dis)aggregation factor 1.[#684] Justin Fain. project crashed erroneously projecting raster data one celestial body another [#688] Mike Sumner can now set color table two column (value, ID) data.frame categorical rasters can now updated easily [#667] Alex Ilich control matching values colors using plot. [#673] Jakub Nowosad. SpatVector attributes can now also factor, date, POSIXct. [#697] Grant Williamson improved handling missing values extract(method=\"bilinear\"). [#693] swooping-magpie","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-3","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-3","text":"argument .raster unique<SpatRaster> create categorical raster unique combinations layers input raster. default argument na.rm changed FALSE sort<SpatRaster> sort cell values across layers. .colors .RGB SpatRaster cover can now combine categorical rasters concats combine levels two SpatRaster new categories [#663] Alex Ilich zonal<SpatVector,SpatVector> method aggregate SpatVector attributes polygons","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-34","dir":"Changelog","previous_headings":"","what":"version 1.5-34","title":"version 1.5-34","text":"CRAN release: 2022-06-09 Released 2022-06-09","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-5-34","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.5-34","text":"“flipped” rasters always handled well. [#546] Dan Baston better reading GTiff subdatsets. [#601] Kyle Doherty better handling multi-layer categorical rasters extract. [#580] André M. Bellvé weighted.mean adjust weights NAs values. [#574] Lars Dalby bug masking. [#552] reported Márcia Barbosa [565] Jakub Nowosad. fixed stretch option plotRGB [#550] Agustin Lobo unwrap SpatRaster failed crs including “’”. [#602] Jean Romain. spatSample cells=TRUE failed planar data [#544] Benjamin Misiuk compareGeom(x, y, stopOnError=FALSE) remove error messages stored x leading unexpected warnings later . [#568] David Hofmann.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-34","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-34","text":"Using & | SpatRasters now returns boolean SpatRaster. [#594] Dan Baston SpatVector now supports logical values. [#593] Derek Friend Attempt create SpatRaster invalid number rows now gives error. [#544] Dan Baston layerCor create temp files anymore. [#551] Christine Anderson using iterator symbols nested loops avoid warnings Intel compiler. [#573] Gareth Davies.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-5-34","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.5-34","text":"new arguments res origin project<SpatRaster> method. [#596] Alex Ilich new argument inside=TRUE centroids get centroid-like point guaranteed geometry (“point surface”). [#588] Márcia Barbosa new argument keepgeom=FALSE vect<data.frame> allows setting (keeping) geometry attribute. [#586] Márcia Barbosa saveRDS serialize methods SpatRaster SpatVector. [#549] Andrei Mîrț xFromCol yFromCol now <SpatRaster,missing> method. [#583] Michael Sumner. svc<sf> method deal GeometryCollection types. [#585] Sarah Endicott .points<SpatRaster> .polygons<SpatRaster> new argument na.=FALSE affects interpretation na.rm. [#548] Jean-Luc Dupouey. setGDALconfig getGDALconfig set GDAL configuration options. [#608] Erik Bolch. new argument circular rapp allow start end (layers represent days year) new method costDistance<SpatRaster> new methods .min .max SpatRaster get cell numbers extreme values SpatRaster. new method emptyGeoms<SpatVector> get indices empty (null) geometries new method rasterizeGeom rasterize geometry count area (small) polygons length lines. new method .na SpatRaster shortcut !.na(x). .list implemented <SpatRasterDataset>. sources implemented <SpatRasterDataset>, <SpatVector> <SpatVectorProxy> [#638] Andrew Gene Brown","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-5-34","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.5-34","text":"delauny -> delaunay [#627] Derek Friend","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-21","dir":"Changelog","previous_headings":"","what":"version 1.5-21","title":"version 1.5-21","text":"CRAN release: 2022-02-16 Released 2022-02-17 writeVector vect now work GPGK path non-ascii characters [#518] results predict cores > 1 one output variable garbled zonal dropped category names using external (R) function [#527] Jakub Nowosad focal/focalCpp showed strange patterns window size larger block size [#519] Alex Ilich using xy=TRUE .data.frame normalized names [#538] Kodi Arfer new argument options vrt [#629] Monika Tomaszewska.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-21","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-21","text":"makeTiles new arguments extend na.rm [#520] L. Dalby project<SpatRaster> now uses nearest neighbor default method RGB rasters new argument na.rm=TRUE unique. [#561] Matthieu Stigler","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-17","dir":"Changelog","previous_headings":"","what":"version 1.5-17","title":"version 1.5-17","text":"CRAN release: 2022-01-30 Released 2022-01-30","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-5-17","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.5-17","text":"app<SpatRasterDataset> ignored filename. [#498] jszhao vect<data.frame> failed silently xy coordinates integers [#496] Márcia Barbosa output aggregate<SpatRaster> malformed nrow(x) %% fact != 0. [#492] Jean-François Bourdon Integer NAs SpatVector attributes recognized Windows [#491] Márcia Barbosa plot<SpatVector> failed using character variable many unique values. [#489] Márcia Barbosa rotate failed large files. Reported Ujjawal Singh writing raster files color table lead crash [#501] Kodi Arfer crds replicated coordinates [#504] Murray Efford .data.frame<SpatRaster> returned integers file stored values integers, even scale/offset creates decimal numbers [#509] Kodi Arfer project opened input raster file read/write mode instead read mode. work files updated.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-17","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-17","text":"distance, gridDistance, direction patches now process layers input SpatRaster. [#503] Chris Haak consistent copy--modify behavior ()<- methods. -place updating available set. methods set.names set.values. [#493] Jean Romain [#511] Bryan Fuentes much faster writing GPGK vector data using single transaction (following sf) [#460] Krzysztof Dyba aggregate<SpatRaster> now accepts functions return one value per aggregated cell writeVector new argument insert add layer existing file (e.g. GPKG).","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-5-17","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.5-17","text":"new option method=\"weights\" spatSample<SpatRaster> new mask<SpatVector,SpatVector> method select intersecting geometries new method .related values<SpatRaster> new option na.rm=TRUE. [#490] Henk Harmsen new class SpatVectorProxy provide access large vector databases read memory entirety. new argument proxy=FALSE vect create SpatVectorProxy object new method query<SpatVectorProxy> extract parts SpatVectorProxy new method vector_layers returns, can delete, vector format layers database/file GPKG","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-5-17","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.5-17","text":"avoid name clashes tidyverse arrow -> north src -> sprc simplify -> simplifyGeom consistency setCats -> set.cats","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-12","dir":"Changelog","previous_headings":"","what":"version 1.5-12","title":"version 1.5-12","text":"CRAN release: 2022-01-13 Released 2022-01-13","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-5-12","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.5-12","text":"setValues init failed (even crashed R) using single value largish raster. [#414] conversion sfc SpatVector lost crs. [#415] Jean-Luc Dupouey buffer SpatRaster values caused crash [#416] Sebastian Brinkmann writeVector now assumes “traditional GIS order” (long/lat) CRS specifies lat/long. [#333]( Agustin Lobo argument main ignored density using single layer SpatRaster [#424] dvictori Summary type math functions min mean, used multiple SpatRasters numbers, ignored additional SpatRasters [#426] Zhuonan Wang names now conserved creating SpatRaster RasterStack points file(s) [#430] Dan Baston classify right=FALSE ignored include.lowest=TRUE [#442] Alex Ilich patches now combines patches connect across data line [#366] Hirscht patches(directions=8) now connects NE/SW direction [#451] Jean-François Bourdon. centroids now considers cases SpatVector parts nearest crossing date line instead zero-meridian [#366] Hirscht terrain created empty (NA) rows chunks used processing large rasters. [#453] Robert Ritson. inset draw “box” correctly. [#457] Márcia Barbosa .lines now works points SpatVector [#464] Márcia Barbosa","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-12","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-12","text":"values(x)<- now accepts (hex coded) colors values focal now wraps around dateline like raster::focal [#242] Alexander Marbler aggregate now show progress bar cases [#249] Lachlan .data.frame<SpatRaster> <SpatVector> now also implemented S3 methods assure correct dispatch S3 methods data.table::.data.table. See [#284] Patrick Schratz crs now shows correct authority EPSG. [#419] Matthew Williamson now possible add SpatRaster empty SpatRaster (values), even different geometry, ignoring empty SpatRaster [#421] Alex Ilich. rast<filename> new argument lyrs subset layers open file one step. rast<array> now crs extent argument. [#439] RS-eco type=\"xyz\" now default rast<data.frame>. [#438] RS-eco classify new argument brackets show side interval open closed. support categorical data freq .data.frame. [#441] ngould7 speed processing multi-layer memory data. [#437] Krzysztof Dyba vect<matrix> vect<data.frame> now much faster. [#413] BastienFR extract points provided matrix cell numbers much faster. [#341] focal new argument na.policy can set one “” (default), “” “omit”. argument na.removed, can now use na.policy=\"\" inset argument border changed perimeter allow passing border plot<Spat*>. [#456] Márcia Barbosa compile-time run-time versions GEOS now compared warning given . [#459] Edzer Pebesma now possible add sub-datasets GPKG GTiff files. [#300] gtitov general option memfrac can now set zero (stead lower 0.1). [#476] Matt Strimas-Mackey new argument allowGaps patches disallow gaps patch IDs. See [#478] Dunbar Carpenter.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-5-12","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.5-12","text":"timestamps units now saved auxiliary file (filename.aux.json) raster formats except NetCDF using writeCDF (case stored netcdf file) new method mergeTime combine multiple rasters, perhaps partly overlapping time, single time series new method fillTime can add empty layers existing layers assure time step layers constant new method approximate fill missing values cell across layers new methods .bool .bool SpatRaster explicit recognition Boolean raster data various places (e.g., extract, plot) new methods .int .int SpatRaster. assigning integer values SpatRaster, reading integer file, corresponding layers now classified integer type [#446] L. Dalby new method layerCor (like raster::layerStats). [#420] Alex Ilich new method focalCor (like raster::corLocal). [#427] Zhuonan Wang new method .equal SpatRaster. See [#428] Dongdong Kong new method math SpatRaster implements Math-generic methods accepts filename new method sds<array> new method rasterize<matrix>, see [#413] BastienFR new method colorize transform color representations new method arrow draw (North) arrow map. [#461] Márcia Barbosa new method densify insert nodes existing nodes line polygon SpatVector new method direction SpatRaster. [#462] Márcia Barbosa new method focal3D compute focal values three-dimensional (row, column, layer) window new function makeVRT create vrt file file needs header read. new option method=\"stratified\" spatSample<SpatRaster>. [#470] Michael Mahoney new general option memmax cap amount RAM terra can used raster processing [#476] Matt Strimas-Mackey new method gridDistance compute distances traversing raster, perhaps obstacles. [#477] Márcia Barbosa","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-22","dir":"Changelog","previous_headings":"","what":"version 1.4-22","title":"version 1.4-22","text":"CRAN release: 2021-11-24 Released 2021-11-24","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"changes-1-4-22","dir":"Changelog","previous_headings":"","what":"changes","title":"version 1.4-22","text":"focal now ellipses (...) allow providing additional arguments fun. reason na.rm argument anymore can supplied via ellipses. practice means default na.rm=FALSE standard functions mean sum.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-22","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-22","text":"app grossly overestimated RAM needed, slowing . Reported Jerry Nelson terra now installs, , older versions GEOS [#406] fparyani terra install Clang CRAN/OSX due using C++13 idiom.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-22","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-22","text":"lapp tapp now cores argument (app predict). Suggested Dongdong Kong [#365] focal now also works function returns multiple values. See [#318] Alex Ilich. focal can now process multiple layers one step. expanded support conversion stars objects [#220] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-4-22","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.4-22","text":"focalCpp takes C++ function iterates cells speed computation avoiding apply (see [#318] Alex Ilich). focalReg focal OLS regression models layers","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-20","dir":"Changelog","previous_headings":"","what":"version 1.4-20","title":"version 1.4-20","text":"CRAN release: 2021-11-16 Released 2021-11-16","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-20","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-20","text":"terra install versions GDAL 3 [#402] Alex Ilich. distance two SpatVectors matrices pairwise=FALSE returned matrix filled column instead row [#403] Paul Smith","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-19","dir":"Changelog","previous_headings":"","what":"version 1.4-19","title":"version 1.4-19","text":"CRAN release: 2021-11-15 Released 2021-11-15","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-19","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-19","text":"rast NetCDF files failed bad parsing dates. [#361] Juan Carlos Zamora-Pereira distance<SpatRaster> lon/lat data correct. [#368] Greg Schmidt .polygons<SpatRaster> failed SpatRaster categorical layer first layer. [#370] Patrick Schratz filename argument rasterize ignored, also causing errors writing temporary files. [#377] Robbie Price rast<character> crashed sds empty character string. [#381] Dan Baston plot<SpatVector> now responds range argument [#385] Márcia Barbosa zonal failed user-defined functions. [#393] mqueinnec","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-4-19","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.4-19","text":"new method selectHighest select n cell values highest lowest values. new method vect<list> append SpatVectors (faster .call(rbind, x)) new argument align=FALSE project align template SpatRaster ignore resolution new method gdalCache set GDAL cache size, contributed Dan Baston [#387] new method fileBlocksize new argument options writeVector pass layer creation options GDAL new SpatVector topology methods mergeLines, snap, makeNodes, removeDupNodes, gaps, simplify new SpatVector characterization methods width clearance","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-19","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-19","text":"terra now installs older versions GEOS [#363] terra now installs CentOS 7 GDAL 2.1.4 C++ compiler support std::regexp. [#384] Ariel Paulson","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-11","dir":"Changelog","previous_headings":"","what":"version 1.4-11","title":"version 1.4-11","text":"CRAN release: 2021-10-11 Released 2021-10-11","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-11","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-11","text":"definition setValues now two arguments (x values), just like raster ; avoid reverse dependency problems raster","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-9","dir":"Changelog","previous_headings":"","what":"version 1.4-9","title":"version 1.4-9","text":"CRAN release: 2021-10-07 Released 2021-10-07","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-4-9","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.4-9","text":"avoid name conflicts sp (via raster) disaggregate now called disagg bbox,SpatRaster bbox<SpatVector> removed (resurrected raster another name).","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-9","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-9","text":"project resample now choose resampling method based first layer, using “near” categorical data. Thanks Matthew Lewis [#355]","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-9","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-9","text":"hist failed small samples. Issue [#356] Martin Queinnec","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-7","dir":"Changelog","previous_headings":"","what":"version 1.4-7","title":"version 1.4-7","text":"CRAN release: 2021-10-05 Released 2021-10-05","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"note-1-4-7","dir":"Changelog","previous_headings":"","what":"note","title":"version 1.4-7","text":"terra longer depends raster. avoid name clashes two packages, allow replacing methods rgeos rgdal raster, raster now depends terra instead.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-7","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-7","text":"freq new argument usenames. See issue [#309] Bappa Das rast<character> new argument opts can used pass GDAL open options. See issue [#314] rast<SpatRaster> now takes arguments names vals. See issue [#323] Dongdong Kong crs<- now warns unsupported datum used. See issue [#317] spatSample now returns factor values SpatRaster layer .factor except using .df=FALSE new method origin<- set origin SpatRaster. See issue [#326] Jakub Nowosad crs new argument parse. See [#344] plot<SpatRaster,missing> new argument reset=FALSE allows resetting par()$mar parameters plotting. See issue [#340] Derek Friend crds new argument na.rm. See [#338] Kodi Arfer show(Spat*) now prints name EPSG code crs available. See [#317] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-7","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-7","text":"plotRGB failed NAs. Issue [#308] Jakub Nowosad writeVector crashed R used SpatVector geometries. Reported Timothy White issue [#319] summary<SpatRaster> now returns counts classes (instead numerical summary indices) [#324] Jakub Nowosad tapp character index now returns SpatRaster correct names [#345] Stuart Brown rasterize character variable now adds ID column categories [#337] Tate Brasel cellSize now masks values cases (requested mask=TRUE). Issue [#339] Jean-Luc Dupouey buffer<SpatVector> longer treats lines like polygons [#332] Márcia Barbosa plot now passes layer index fun [#310] Ben Tupper to_id nearest sometimes wrong. See [#328] Shawn Ligocki better support ESRI value attribute tables (VAT). See question focal reset initial values NA cells processing chunks. [#312] Jeffrey Evans focal run memory using large window user-defined function, inexact chunk boundary [#347] zonal .raster=TRUE failed categorical SpatRasters [#348] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-13-22","dir":"Changelog","previous_headings":"","what":"version 1.3-22","title":"version 1.3-22","text":"CRAN release: 2021-08-20 Released 2021-08-20","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-3-22","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.3-22","text":"time(x) <- d set Date class object, time(x) now returns Date object instead POSIXct object. Issue [#256] Mauricio Zambrano-Bigiarini UTF-8 encoding character attributes SpatVector now declared display correctly R. See issue [#258] AGeographer. Also implemented names SpatVector SpatRaster rast<data.frame> method avoid confusion matrix list methods response question Stackbeans extreme values used represent NA intended (one two lower) INT2U INT4U. Reported Jean-Luc Dupouey stackoverflow writeCDF now also writes time dimensions one time-step. See question vect<character> (filename) now argument layer select layer multi-layer file / database, arguments query, extent filter reading subset subst can now create multiple output layers See [issue 276] Agustin Lobo classify can now create different multiple output layers See [issue 276] Agustin Lobo Argument alpha plot<SpatRaster> can now SpatRaster. See question James McCarthy","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-3-22","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.3-22","text":"filename overwrite arguments ignored rasterize gdal options now also honored create-copy drivers [#260] buffer lonlat now works better world’s “edges” [#261] scale/offset ignored project. Reported Fabian Fischer rasterize<SpatRaster,SpatVector> inverse=TRUE crashed R session. Issue [#264] Jean-Luc Dupouey output merge mosaic correct large rasters (first rows used). Reported Zavud Baghirov [#271] .points,SpatRaster remove NA’s correctly shifted values. Issues [#269] [#273] Julian Hagenauer rast<matrix> rotated values using equal-sided matrix [#274] Jakub Nowosad number rows columns reversed using project crs argument. [#283] Timothée Giraud classify, argument right TRUE FALSE reversed. terrain edge effects [#303] Andrew Gene Brown. terrain can now compute multiple variables [#286] Žan Kuralt wrap<SpatRaster> changed factors numeric [#302] Patrick Schratz writeVector failed “FlatGeobuf” (probably formats well) using proper MultiPolygon [#299] L Dalby regular sampling polygons spatSample now much regular [#289] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-13-4","dir":"Changelog","previous_headings":"","what":"version 1.3-4","title":"version 1.3-4","text":"CRAN release: 2021-06-20 Released 2021-06-20","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-3-4","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.3-4","text":"na.omit<SpatVector> remove empty geometries /attribute records NA new method src create SpatRasterCollection (loose collection tiles). merge mosaic now methods SpatRasterCollection. avoid (inefficient) use .call. #210 Matthew Talluto. activeCat activeCat<- get set “active” category multiple categories (raster attributes) .numeric catalyze transfer categories numeric cell values summarize methods range mean (attributes ) SpatVector new method shade, compute hill shading","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-3-4","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.3-4","text":"additional arguments (na.rm) now used rasterize point geometries. #209 Jakub Nowosad improved handling (documentation) gstat models interpolate. #208 Jakub Nowosad new argument cpkgs predict list packages need exported cores argument cores larger one. ?predict now shows different approaches parallelize predict (based examples issue. #178 Matthew Coghill. freq now returns labels categorical layers adjacent now pairs argument. #239 Kenneth Blake Vernon adjacent now also takes matrix specify adjacent cells mean summarize methods now take filename argument disallow non-recognized named arguments. #238 Jessica Nephin raster attribute table ESRI-GRID integer data, ESRI vat.dbf file now ignored counts values. #234 Jullee time attributes longer lost raster operations. #246 Mauricio Zambrano-Bigiarini resample (project) longer ignore gdal=\"\" write options use BIGTIFF necessary (suggested Ani Ghosh) new argument layer extract-SpatRaster,SpatVector method extract values single layers specified geometry (see question).","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-3-4","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.3-4","text":"better handling paths non-ASCII characters (e.g., Chinese) GeoTiff still fails NetCDF. [#233] Dongdong Kong extract points cells=TRUE xy=TRUE gave garbled output .character<SpatRaster> (called wrap) capture layer names. [#213] Pascal Title focal mirrored weight matrix, thus affecting results using asymmetrical weight matrix. Reported Sebastiano Trevisani terra::terraOptions now works without attaching package. [#229] Karl Dunkle Werner app ncores > 0 function returns multiple layers now works. [#240] BastienFR. autocor (local) can now handle NA values. [#245] Jakub Nowosad . mask SpatVector large (memory) multi-layer SpatRaster worked first layer. Reported Monika Tomaszewska.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-12-10","dir":"Changelog","previous_headings":"","what":"version 1.2-10","title":"version 1.2-10","text":"CRAN release: 2021-05-13 Released 2021-05-13","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-2-10","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.2-10","text":".lines method SpatRaster .polygons method SpatVector lines autocor<numeric> new methods mean, compute local mean, locmor, local Moran’s sharedPaths method SpatVector (lines polygons) RGB2col method reduce three-layer RGB SpatRaster single layer SpatRaster color-table (<= 256 colors) split methods SpatVector SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-2-10","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.2-10","text":"rast<Raster*> now takes crs Raster object, file may point . [#200] Floris Vanderhaeghe convhull new argument =\"\" make convex hulls sub-sets SpatVector. faster processing large memory rasters. See issue [#206] Krzysztof Dyba.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-2-10","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.2-10","text":"extract multiple layers return data.frame values correct order (row instead column) crop works sf objects. [#201] Sebastian Brinkmann vect<sf> now also works lines, faster vect<character> crashed R file empty geometries. [#202] consumere extract(points, bilinear=TRUE, cells=TRUE) now works. [#203] fab4app zonal now works min max. [#207] Reported Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-2-10","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.2-10","text":"avoid name conflicts spatstat package area,SpatRaster-method(x, sum=FALSE) -> cellSize(x) area,SpatRaster/SpatVector-method(x, sum=TRUE) -> expanse(x) convexhull -> convHull perimeter -> perim tiles -> makeTiles coords -> crds","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-12-5","dir":"Changelog","previous_headings":"","what":"version 1.2-5","title":"version 1.2-5","text":"CRAN release: 2021-04-30 Released 2021-04-30","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-2-5","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.2-5","text":"trim new argument value allows trimming rows columns values default NA rapp new argument clamp allows clamping start end values 1:nlyr(x), avoiding values considered NA spatSample<SpatRaster> new arguments .points values. Getting values, cells coordinates longer mutually exclusive. response [#191] Agustin Lobo area<SpatRaster> new argument mask=FALSE classify can now take single number request many cuts mosaic merge now warn resample rasters aligned extract new argument exact get fraction covered cell","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-2-5","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.2-5","text":"flip(x, direction=\"vertical\") longer reverses order layers extract work horizontal vertical lines extent considered invalid. Reported Monika Tomaszewska autocor handle NA values [#192] Laurence Hawker nearest now works angular coordinates unit slope terrain correct (tangent returned instead slope), [#196] Sven Alder quantile now works rasters cells NA. Reported Jerry Nelson","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-2-5","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.2-5","text":"avoid name conflicts tidyverse deprecation warning: separate -> segregate expand -> extend near -> nearby pack -> wrap without deprecation warning: transpose -> trans collapse -> tighten fill -> fillHoles select -> sel","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-11-17","dir":"Changelog","previous_headings":"","what":"version 1.1-17","title":"version 1.1-17","text":"CRAN release: 2021-04-14 Released 2021-04-14","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"major-changes-1-1-17","dir":"Changelog","previous_headings":"","what":"major changes","title":"version 1.1-17","text":"c<SpatVector> now returns list. rbind used append SpatVector objects overhaul handling factors. rats removed, levels cats changed","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-11-4","dir":"Changelog","previous_headings":"","what":"version 1.1-4","title":"version 1.1-4","text":"CRAN release: 2021-03-09 news recorded earlier versions","code":""}]
+[{"path":"https://rspatial.github.io/terra/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Robert J. Hijmans. Maintainer, author. Roger Bivand. Contributor. Krzysztof Dyba. Contributor. Edzer Pebesma. Contributor. Michael D. Sumner. Contributor.","code":""},{"path":"https://rspatial.github.io/terra/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Hijmans R (2024). terra: Spatial Data Analysis. R package version 1.7-79, https://rspatial.github.io/terra/, https://rspatial.org/.","code":"@Manual{,   title = {terra: Spatial Data Analysis},   author = {Robert J. Hijmans},   year = {2024},   note = {R package version 1.7-79, https://rspatial.github.io/terra/},   url = {https://rspatial.org/}, }"},{"path":"https://rspatial.github.io/terra/index.html","id":"terra-","dir":"","previous_headings":"","what":"Spatial Data Analysis","title":"Spatial Data Analysis","text":"logo Zane Dax  terra R package spatial data analysis. tutorials rspatial.org/terra. Stack Overflow good place ask questions get stuck. Make sure include simple reproducible example. think found bug, want request new feature, please file issue. terra replaces raster package. interfaces terra raster similar, terra simpler, faster can .","code":""},{"path":"https://rspatial.github.io/terra/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Spatial Data Analysis","text":"terra available CRAN, can use install.packages(\"terra\") get current released version. easiest way use development version Windows MacOS, install R-universe, like :","code":"install.packages('terra', repos='https://rspatial.r-universe.dev')"},{"path":"https://rspatial.github.io/terra/index.html","id":"from-source-code","dir":"","previous_headings":"Installation","what":"From source-code","title":"Spatial Data Analysis","text":"install source-code, first install Rcpp package terra depends : continue based OS using.","code":"install.packages(\"Rcpp\")"},{"path":"https://rspatial.github.io/terra/index.html","id":"windows","dir":"","previous_headings":"Installation > From source-code","what":"Windows","title":"Spatial Data Analysis","text":"Windows, need first install Rtools get C++ compiler R can use. need recent version Rtools42 (rtools42-5355-5357). , R, install package.","code":"Sys.setenv(\"R_REMOTES_NO_ERRORS_FROM_WARNINGS\" = \"true\") remotes::install_github(\"rspatial/terra\")"},{"path":"https://rspatial.github.io/terra/index.html","id":"macos","dir":"","previous_headings":"Installation > From source-code","what":"macOS","title":"Spatial Data Analysis","text":"macOS, can use MacPorts Homebrew. MacPorts can Homebrew, need first install GDAL: Followed (note additional configuration argument needed Homebrew) install CRAN version source ","code":"sudo port install R-terra brew install pkg-config brew install gdal remotes::install_github(\"rspatial/terra\", configure.args = \"--with-proj-lib=$(brew --prefix)/lib/\") install.packages(\"terra\", type = \"source\", configure.args = \"--with-proj-lib=$(brew --prefix)/lib/\")"},{"path":"https://rspatial.github.io/terra/index.html","id":"linux","dir":"","previous_headings":"Installation > From source-code","what":"Linux","title":"Spatial Data Analysis","text":"easy way install terra Ubuntu r2u. harder way: Install system requirements GDAL (>= 2.2.3), GEOS (>= 3.4.0), PROJ (>= 4.9.3), sqlite3. now, R, install package See sf instructions installation linux systems — possible updates/improvements instructions.","code":"sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable sudo apt-get update sudo apt-get install libgdal-dev libgeos-dev libproj-dev remotes::install_github(\"rspatial/terra\")"},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":null,"dir":"Reference","previous_headings":"","what":"Set the NA flag — NAflag","title":"Set the NA flag — NAflag","text":"main purpose method allow correct reading SpatRaster based file incorrect NA flag. file changed, flagged value set NA values read file (\"lazy evaluation\"). contrast, values memory change made immediately. change values, generally better use classify","code":""},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set the NA flag — NAflag","text":"","code":"# S4 method for SpatRaster NAflag(x)  # S4 method for SpatRaster NAflag(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set the NA flag — NAflag","text":"x SpatRaster value numeric. value interpreted NA; set reading values file. can single value, multiple values, one data source (file / subdataset)","code":""},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set the NA flag — NAflag","text":"none numeric","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/NAflag.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set the NA flag — NAflag","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))[[1]]    NAflag(s) <- 255 plot(s)  NAflag(s) #> [1] 255"},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":null,"dir":"Reference","previous_headings":"","what":"Layers representing colors — RGB","title":"Layers representing colors — RGB","text":"RGB can get set layers used Red, Green Blue plotting SpatRaster. Currently, benefit plot send object plotRGB. can also associated layers another color space (HSV, HSI HSL) colorize can convert three-layer RGB SpatRaster color spaces. can also convert single-layer SpatRaster color-table.","code":""},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Layers representing colors — RGB","text":"","code":"# S4 method for SpatRaster RGB(x)  # S4 method for SpatRaster RGB(x, ..., type=\"rgb\")<-value  # S4 method for SpatRaster colorize(x, to=\"hsv\", alpha=FALSE, stretch=NULL,    grays=FALSE, NAzero=FALSE, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatRaster has.RGB(x, strict=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Layers representing colors — RGB","text":"x SpatRaster value vector three (four) positive integers indicating layers red, green blue (optionally fourth transparency layer). NULL remove RGB settings type character. color space. One \"rgb\" \"hsv\", \"hsi\" \"hsl\" character. color space transform values . x RGB set, can transform \"hsv\", \"hsi\" \"hsl\", use \"col\" create single layer color table. can also use \"rgb\" back transform RGB alpha logical. alpha (transparency) channel included? used x color-table =\"rgb\" stretch character. Option stretch values increase contrast: \"lin\" (linear) \"hist\" (histogram). used transforming RGB col grays logical. TRUE, gray-scale color-table created. used transforming RGB col NAzero logical. TRUE, NAs treated zeros color can returned least one three channels value. used transforming RGB (\"col\") strict logical. TRUE, function returns FALSE color space \"hsv\", \"hsi\" \"hsl\" used filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/RGB.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Layers representing colors — RGB","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    plot(r)  has.RGB(r) #> [1] TRUE RGB(r) <- NULL has.RGB(r) #> [1] FALSE plot(r)  RGB(r) <- c(3,1,2) plot(r)   RGB(r) <- 1:3 x <- colorize(r, \"col\") y <- colorize(r, \"hsv\") z <- colorize(y, \"rgb\")"},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":null,"dir":"Reference","previous_headings":"","what":"Class ","title":"Class ","text":"Objects class SpatExtent used define spatial extent (extremes) objects SpatRaster class.","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":"objects-from-the-class","dir":"Reference","previous_headings":"","what":"Objects from the Class","title":"Class ","text":"can use ext function create SpatExtent objects, extract SpatRaster, SpatVector related objects.","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":"methods","dir":"Reference","previous_headings":"","what":"Methods","title":"Class ","text":"show display values SpatExtent object","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatExtent-class.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Class ","text":"","code":"e <- ext(-180, 180, -90, 90) e #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/SpatRaster-class.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster class — SpatRaster-class","title":"SpatRaster class — SpatRaster-class","text":"SpatRaster represents rectangular part world sub-divided rectangular cells equal area (terms units coordinate reference system). cell can multiple values (\"layers\"). object SpatRaster class can point one files disk hold cell values, /can hold values memory. objects can created rast method. SpatRasterDataset collection sub-datasets, SpatRaster area (extent) coordinate reference system, possibly different resolution. Sub-datasets often used capture variables (e.g. temperature precipitation), fourth dimension (e.g. height, depth time) sub-datasets already three dimensions (multiple layers). SpatRasterCollection collection SpatRasters restriction extent geometric parameters.","code":""},{"path":"https://rspatial.github.io/terra/reference/SpatRaster-class.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster class — SpatRaster-class","text":"","code":"rast() #> class       : SpatRaster  #> dimensions  : 180, 360, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)"},{"path":"https://rspatial.github.io/terra/reference/SpatVector-class.html","id":null,"dir":"Reference","previous_headings":"","what":"Class ","title":"Class ","text":"SpatVector can represent points, lines polygons. SpatVectorCollection can hold collection SpatVectors SpatVectorProxy SpatVector data -disk -stead memory.","code":""},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":null,"dir":"Reference","previous_headings":"","what":"Active category — activeCat","title":"Active category — activeCat","text":"Get set active category multi-categorical SpatRaster layer","code":""},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Active category — activeCat","text":"","code":"# S4 method for SpatRaster activeCat(x, layer=1) # S4 method for SpatRaster activeCat(x, layer=1)<-value"},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Active category — activeCat","text":"x SpatRaster layer positive integer, layer number name value positive integer character, indicating column categories use. Note number used index zero based, \"1\" refers second column. first column categories cell values, categorical labels","code":""},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Active category — activeCat","text":"integer","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/activeCat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Active category — activeCat","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) + 10 d <- data.frame(id=11:13, cover=c(\"forest\", \"water\", \"urban\"), letters=letters[1:3], value=10:12) levels(r) <- d  activeCat(r) #> [1] 1 activeCat(r) <- 3 activeCat(r) #> [1] 3"},{"path":"https://rspatial.github.io/terra/reference/add.html","id":null,"dir":"Reference","previous_headings":"","what":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"Add (place) SpatRaster another SpatRaster. Comparable c, without copying object.","code":""},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"","code":"# S4 method for SpatRaster,SpatRaster add(x)<-value  # S4 method for SpatRasterDataset,SpatRaster add(x)<-value  # S4 method for SpatRasterCollection,SpatRaster add(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"x SpatRaster, SpatRasterDataset SpatRasterCollection value SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/add.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add (in place) a SpatRaster to another SpatRaster or to a SpatRasterDataset or SpatRasterCollection — add","text":"","code":"r <- rast(nrows=5, ncols=9, vals=1:45) x <- c(r, r*2) add(x) <- r*3 x #> class       : SpatRaster  #> dimensions  : 5, 9, 3  (nrow, ncol, nlyr) #> resolution  : 40, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     1,     2,     3  #> max values  :    45,    90,   135"},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":null,"dir":"Reference","previous_headings":"","what":"Adjacent cells — adjacent","title":"Adjacent cells — adjacent","text":"Identify cells adjacent set raster cells. identify adjacent polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Adjacent cells — adjacent","text":"","code":"# S4 method for SpatRaster adjacent(x, cells, directions=\"rook\", pairs=FALSE, include=FALSE, symmetrical=FALSE)  # S4 method for SpatVector adjacent(x, type=\"rook\", pairs=TRUE, symmetrical=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Adjacent cells — adjacent","text":"x SpatRaster cells vector cell numbers adjacent cells found. Cell numbers start 1 upper-left corner increase left right top bottom directions character matrix indicated directions cells considered connected. following character values allowed: \"rook\" \"4\" horizontal vertical neighbors; \"bishop\" get diagonal neighbors; \"queen\" \"8\" get vertical, horizontal diagonal neighbors; \"16\" knight one-cell queen move neighbors. directions matrix odd dimensions logical (0, 1) values pairs logical. TRUE, two-column matrix pairs adjacent cells returned. x SpatRaster pairs FALSE, n*m matrix returned number rows n length(cells) number columns m number neighbors requested directions include logical. focal cells included result? type character. One \"rook\", \"queen\", \"touches\", \"intersects\". \"queen\" \"touches\" synonyms. \"rook\" exclude polygons touch single node . \"intersects\" includes polygons touch overlap symmetrical logical. TRUE pairs=TRUE, adjacent pair included . example, polygon 1 adjacent polygon 3, implied adjacency 3 1 reported","code":""},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Adjacent cells — adjacent","text":"using global lon/lat rasters, adjacent cells side date-line included.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Adjacent cells — adjacent","text":"matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/adjacent.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Adjacent cells — adjacent","text":"","code":"r <- rast(nrows=10, ncols=10) adjacent(r, cells=c(1, 5, 55), directions=\"queen\")  #>    [,1] [,2] [,3] [,4] [,5] [,6] [,7] [,8] #> 0   NaN  NaN  NaN   10    2   20   11   12 #> 4   NaN  NaN  NaN    4    6   14   15   16 #> 54   44   45   46   54   56   64   65   66 r <- rast(nrows=10, ncols=10, crs=\"+proj=utm +zone=1 +datum=WGS84\") adjacent(r, cells=11, directions=\"rook\")  #>    [,1] [,2] [,3] [,4] #> 10    1  NaN   12   21  #same as  rk <- matrix(c(0,1,0,1,0,1,0,1,0), 3, 3) adjacent(r, cells=11, directions=rk)  #>    [,1] [,2] [,3] [,4] #> 10    1  NaN   12   21  ## note that with global lat/lon data the E and W connect r <- rast(nrows=10, ncols=10, crs=\"+proj=longlat +datum=WGS84\") adjacent(r, cells=11, directions=\"rook\")  #>    [,1] [,2] [,3] [,4] #> 10    1   20   12   21  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) a <- adjacent(v, symmetrical=TRUE) head(a) #>      from to #> [1,]    1  2 #> [2,]    1  4 #> [3,]    1  5 #> [4,]    2  3 #> [5,]    2  4 #> [6,]    2  5"},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":null,"dir":"Reference","previous_headings":"","what":"Aggregate raster or vector data — aggregate","title":"Aggregate raster or vector data — aggregate","text":"Aggregate SpatRaster create new SpatRaster lower resolution (larger cells). Aggregation groups rectangular areas create larger cells. value resulting cells computed user-specified function. can also aggregate (\"dissolve\") SpatVector. either combines geometries one geometry, combines geometries value variable(s) specified argument .","code":""},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Aggregate raster or vector data — aggregate","text":"","code":"# S4 method for SpatRaster aggregate(x, fact=2, fun=\"mean\", ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatVector aggregate(x, by=NULL, dissolve=TRUE, fun=\"mean\", count=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Aggregate raster or vector data — aggregate","text":"x SpatRaster fact positive integer. Aggregation factor expressed number cells direction (horizontally vertically). two integers (horizontal vertical aggregation factor) three integers (also aggregating layers) fun function used aggregate values. Either actual function, following, name: \"mean\", \"max\", \"min\", \"median\", \"sum\", \"modal\", \"\", \"\", \"prod\", \".min\", \".max\", \"sd\" (sample standard deviation) \"std\" (population standard deviation) ... additional arguments passed fun, na.rm=TRUE cores positive integer. cores > 1, 'parallel' package cluster many cores created. Ignored C++ level implemented functions listed fun filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster character. variable(s) used group geometries dissolve logical. borders aggregated geometries dissolved? count logical. TRUE NULL, variable \"agg_n\" included shows number input geometries output geometry","code":""},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Aggregate raster or vector data — aggregate","text":"Aggregation starts upper-left end SpatRaster. division number columns rows factor return integer, extent resulting SpatRaster somewhat larger original SpatRaster. example, input SpatRaster 100 columns, fact=12, output SpatRaster 9 columns maximum x coordinate output SpatRaster also adjusted. function fun take multiple numbers, return single number. example mean, modal, min max. also accept na.rm argument (ignore one 'dots' arguments).","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Aggregate raster or vector data — aggregate","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/aggregate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Aggregate raster or vector data — aggregate","text":"","code":"r <- rast() # aggregated SpatRaster, no values ra <- aggregate(r, fact=10)  values(r) <- runif(ncell(r)) # aggregated raster, max of the values ra <- aggregate(r, fact=10, fun=max)  # multiple layers s <- c(r, r*2) x <- aggregate(s, 20)   ## SpatVector  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) va <- aggregate(v, \"ID_1\")  plot(va, \"NAME_1\", lwd=5, plg=list(x=\"topright\"), mar=rep(2,4)) lines(v, lwd=3, col=\"light gray\") lines(va) text(v, \"ID_1\", halo=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/align.html","id":null,"dir":"Reference","previous_headings":"","what":"Align a SpatExtent — align","title":"Align a SpatExtent — align","text":"Align SpatExtent SpatRaster can useful create new SpatRaster origin resolution existing SpatRaster. use force data match really match (use e.g. resample (dis)aggregate ). also possible align SpatExtent clean divisor.","code":""},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Align a SpatExtent — align","text":"","code":"# S4 method for SpatExtent,SpatRaster align(x, y, snap=\"near\")  # S4 method for SpatExtent,numeric align(x, y)"},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Align a SpatExtent — align","text":"x SpatExtent y SpatRaster numeric snap Character. One \"near\", \"\", \"\", determine direction extent aligned. nearest border, inwards outwards","code":""},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Align a SpatExtent — align","text":"SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/align.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Align a SpatExtent — align","text":"","code":"r <- rast() e <- ext(-10.1, 9.9, -20.1, 19.9) ea <- align(e, r) e #> SpatExtent : -10.1, 9.9, -20.1, 19.9 (xmin, xmax, ymin, ymax) ext(r) #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax) ea #> SpatExtent : -10, 10, -20, 20 (xmin, xmax, ymin, ymax)  align(e, 0.5) #> SpatExtent : -10.5, 10, -20.5, 20 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare two SpatRasters for equality — all.equal","title":"Compare two SpatRasters for equality — all.equal","text":"Compare two SpatRasters (near) equality. First attributes objects compared. , (perhaps small) sample raster cells compared well. sample size used can increased maxcell argument. can set Inf, large rasters computer may sufficient memory. See examples safe way compare values.","code":""},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare two SpatRasters for equality — all.equal","text":"","code":"# S4 method for SpatRaster,SpatRaster all.equal(target, current, maxcell=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare two SpatRasters for equality — all.equal","text":"target SpatRaster current SpatRaster maxcell positive integer. size regular sample used compare cell values ... additional arguments passed .equal.numeric compare cell values","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare two SpatRasters for equality — all.equal","text":"Either TRUE character vector describing differences target current.","code":""},{"path":"https://rspatial.github.io/terra/reference/all.equal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare two SpatRasters for equality — all.equal","text":"","code":"x <- sqrt(1:100) mat <- matrix(x, 10, 10) r1 <- rast(nrows=10, ncols=10, xmin=0, vals = x) r2 <- rast(nrows=10, ncols=10, xmin=0, vals = mat)  all.equal(r1, r2) #> [1] \"Mean relative difference: 0.3858482\" all.equal(r1, r1*1) #> [1] TRUE all.equal(rast(r1), rast(r2)) #> [1] TRUE  # compare geometries  compareGeom(r1, r2) #> [1] TRUE  # Compare all cell values for near equality # as floating point number imprecision can be a problem m <- minmax(r1 - r2) all(abs(m) < 1e-7) #> [1] FALSE  # comparison of cell values to create new SpatRaster e <- r1 == r2"},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":null,"dir":"Reference","previous_headings":"","what":"Animate a SpatRaster — animate","title":"Animate a SpatRaster — animate","text":"Animate (sequentially plot) layers SpatRaster create movie. work R-Studio.","code":""},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Animate a SpatRaster — animate","text":"","code":"# S4 method for SpatRaster animate(x, pause=0.25, main, range, maxcell=50000, n=1, ...)"},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Animate a SpatRaster — animate","text":"x SpatRaster pause numeric. long pause layers? main title layer. supplied z-value used available. Otherwise names used. range numeric vector length 2. Range values plot maxcell positive integer. Maximum number cells use plot. maxcell < ncell(x), spatSample(type=\"regular\") used plotting n integer > 0. Number loops ... Additional arguments passed plot","code":""},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Animate a SpatRaster — animate","text":"None","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/animate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Animate a SpatRaster — animate","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    animate(s, n=1)"},{"path":"https://rspatial.github.io/terra/reference/app.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to the cells of a SpatRaster — app","title":"Apply a function to the cells of a SpatRaster — app","text":"Apply function values cell SpatRaster. Similar apply -- think layer SpatRaster column (row) matrix. generally used summarize values multiple layers one layer; required. app calls function fun raster data first argument. Depending function supplied, raster data represented either matrix layer column, vector representing cell. function return vector matrix divisible ncell(x). Thus, \"sum\" \"rowSums\" can used, \"colSums\" used. can also apply function fun across datasets layer SpatRasterDataset. case, summarization layer across SpatRasters.","code":""},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to the cells of a SpatRaster — app","text":"","code":"# S4 method for SpatRaster app(x, fun, ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterDataset app(x, fun, ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to the cells of a SpatRaster — app","text":"x SpatRaster SpatRasterDataset fun function operates vector matrix. can function defined base-R package, function write (see examples). Functions return complex output (e.g. list) may need wrapped function simplify output vector matrix. following functions re-implemented C++ speed: \"sum\", \"mean\", \"median\", \"modal\", \"\", \".min\", \".max\", \"min\", \"max\", \"prod\", \"\", \"\", \"sd\", \"std\", \"first\". use base-R function say, \"min\", use something like fun=function() min() equivalent fun = \\() min() ... additional arguments fun. typically numerical constants. *never* another SpatRaster cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object. Ignored functions implemented terra C++ (see fun) filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to the cells of a SpatRaster — app","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply a function to the cells of a SpatRaster — app","text":"speed things , parallelization supported, often helpful, may actually slower. speed gain many cores (> 8) /complex (slow) function fun. write fun , consider supplying cppFunction made Rcpp package instead (go cup tea computer works ).","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/app.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to the cells of a SpatRaster — app","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) x <- c(r, sqrt(r), r+50) s <- app(x, fun=sum) s #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : sum  #> min value   :  53  #> max value   : 260  # for a few generic functions like  # \"sum\", \"mean\", and \"max\" you can also do sum(x) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : sum  #> min value   :  53  #> max value   : 260   ## SpatRasterDataset sd <- sds(x, x*2, x/3) a <- app(sd, max) a #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     2,     2,   102  #> max values  :   200,    20,   300  # same as  max(x, x*2, x/3) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     2,     2,   102  #> max values  :   200,    20,   300  # and as (but slower) b <- app(sd, function(i) max(i))   ## also works for a single layer f <- function(i) (i+1) * 2 * i + sqrt(i) s <- app(r, f) # same as above, but that is not memory-safe # and has no filename argument  s <- f(r)  if (FALSE) { #### multiple cores  test0 <- app(x, sqrt)  test1 <- app(x, sqrt, cores=2)  testfun <- function(i) { 2 * sqrt(i) } test2 <- app(x, fun=testfun, cores =2)  ## this fails because testfun is not exported to the nodes # test3 <- app(x, fun=function(i) testfun(i), cores=2) ## to export it, add it as argument to fun test3 <- app(x, fun=function(i, ff) ff(i), cores =3, ff=testfun) }"},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":null,"dir":"Reference","previous_headings":"","what":"Estimate values for cell values that are NA by interpolating between layers — approximate","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"approximate uses stats function approx estimate values cells NA interpolation across layers. Layers considered equidistant, unless argument z used, time(x) returns values NA, case values used determine distance layers. estimation based neighboring cells see focal","code":""},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"","code":"# S4 method for SpatRaster approximate(x, method=\"linear\", yleft, yright,             rule=1, f=0, ties=mean, z=NULL, NArule=1,filename=\"\",  ...)"},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"x SpatRaster method specifies interpolation method used. Choices \"linear\" \"constant\" (step function; see example approx yleft value returned non-NA value encountered. default defined value rule given yright value returned last non-NA value encountered. default defined value rule given rule integer (length 1 2) describing interpolation take place first last cells (non-NA values encountered). rule 1 NAs returned points 2, value closest data extreme used. Use, e.g., rule = 2:1, left right side extrapolation differ f method = \"constant\" number 0 1 inclusive, indicating compromise left- right-continuous step functions. y0 y1 values left right point value y0*(1-f)+y1*f f = 0) right-continuous f = 1 left-continuous ties Handling tied 'z' values. Either function single vector argument returning single number result string \"ordered\" z numeric vector indicate distance layers (e.g., depth). default time(x) NA else 1:nlys(x) NArule single integer used determine single layer non-NA value encountered (linear interpolation possible). default value 1 indicates layers get value cell; values change cell values filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/approximate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Estimate values for cell values that are NA by interpolating between layers — approximate","text":"","code":"r <- rast(ncols=5, nrows=5) r1 <- setValues(r, runif(ncell(r))) r2 <- setValues(r, runif(ncell(r))) r3 <- setValues(r, runif(ncell(r))) r4 <- setValues(r, runif(ncell(r))) r5 <- setValues(r, NA) r6 <- setValues(r, runif(ncell(r))) r1[6:10] <- NA r2[5:15] <- NA r3[8:25] <- NA s <- c(r1,r2,r3,r4,r5,r6) s[1:5] <- NA x1 <- approximate(s) x2 <- approximate(s, rule=2) x3 <- approximate(s, rule=2, z=c(1,2,3,5,14,15))"},{"path":"https://rspatial.github.io/terra/reference/arith-generic.html","id":null,"dir":"Reference","previous_headings":"","what":"Arithmetic — Arith-methods","title":"Arithmetic — Arith-methods","text":"Standard arithmetic operators computations SpatRasters. Computations local (applied cell cell basis). multiple SpatRasters used, must geometry (extent resolution). operators implemented: +, -, *, /, ^, %%, %/% can also use SpatRaster vector matrix. use SpatRaster vector multiple numbers, element vector considered layer (constant value). use SpatRaster matrix, number columns matrix must match number layers SpatRaster. rows used match cells. , two rows, match cells 1 2, recycled 3 4, etc. following methods implemented (SpatExtent, SpatExtent): +, -, following (SpatExtent, numeric): +, -, *, /, %%","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/arith-generic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Arithmetic — Arith-methods","text":"SpatRaster SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/arith-generic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Arithmetic — Arith-methods","text":"","code":"r1 <- rast(ncols=10, nrows=10) v <- runif(ncell(r1)) v[10:20] <- NA values(r1) <- v r2 <- rast(r1) values(r2) <- 1:ncell(r2) / ncell(r2) r3 <- r1 + r2 r2 <- r1 / 10 r3 <- r1 * (r2 - 1 / r2)  b <- c(r1, r2, r3) b2 <- b * 10  ### SpatExtent methods x <- ext(0.1, 2.2, 0, 3) y <- ext(-2, 1, -2,2) # union x + y #> SpatExtent : -2, 2.2, -2, 3 (xmin, xmax, ymin, ymax) # intersection x * y #> SpatExtent : 0.1, 1, 0, 2 (xmin, xmax, ymin, ymax)  e <- x  e #> SpatExtent : 0.1, 2.2, 0, 3 (xmin, xmax, ymin, ymax) e * 2 #> SpatExtent : -0.95, 3.25, -1.5, 4.5 (xmin, xmax, ymin, ymax) e / 2 #> SpatExtent : 0.625, 1.675, 0.75, 2.25 (xmin, xmax, ymin, ymax) e + 1 #> SpatExtent : -0.9, 3.2, -1, 4 (xmin, xmax, ymin, ymax) e - 1 #> SpatExtent : 1.1, 1.2, 1, 2 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a text representation of (the skeleton of) an object — as.character","title":"Create a text representation of (the skeleton of) an object — as.character","text":"Create text representation (skeleton ) object","code":""},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a text representation of (the skeleton of) an object — as.character","text":"","code":"# S4 method for SpatExtent as.character(x)  # S4 method for SpatRaster as.character(x)"},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a text representation of (the skeleton of) an object — as.character","text":"x SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a text representation of (the skeleton of) an object — as.character","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/as.character.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a text representation of (the skeleton of) an object — as.character","text":"","code":"r <- rast() ext(r) #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax) ext(c(0, 20, 0, 20)) #> SpatExtent : 0, 20, 0, 20 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster or SpatVector to data.frame — as.data.frame","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"Coerce SpatRaster SpatVector data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"","code":"# S4 method for SpatVector as.data.frame(x, row.names=NULL, optional=FALSE, geom=NULL, ...)  # S4 method for SpatRaster as.data.frame(x, row.names=NULL, optional=FALSE, xy=FALSE,    cells=FALSE, time=FALSE, na.rm=NA, wide=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"x SpatRaster SpatVector geom character NULL. NULL, either \"WKT\" \"HEX\", get geometry included Well-Known-Text hexadecimal notation. x point geometry, can also \"XY\" add coordinates point xy logical. TRUE, coordinates raster cell included time logical. TRUE, time data included (available) na.rm logical. TRUE, cells NA value least one layer removed. argument set NA cells NA values layers removed cells logical. TRUE, cell numbers raster cell included wide logical. FALSE, data.frame returned \"long\" format ... Additional arguments passed data.frame row.names argument ignored optional argument ignored","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/as.data.frame.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster or SpatVector to data.frame — as.data.frame","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) as.data.frame(v) #>    ID_1       NAME_1 ID_2           NAME_2 AREA    POP #> 1     1     Diekirch    1         Clervaux  312  18081 #> 2     1     Diekirch    2         Diekirch  218  32543 #> 3     1     Diekirch    3          Redange  259  18664 #> 4     1     Diekirch    4          Vianden   76   5163 #> 5     1     Diekirch    5            Wiltz  263  16735 #> 6     2 Grevenmacher    6       Echternach  188  18899 #> 7     2 Grevenmacher    7           Remich  129  22366 #> 8     2 Grevenmacher   12     Grevenmacher  210  29828 #> 9     3   Luxembourg    8         Capellen  185  48187 #> 10    3   Luxembourg    9 Esch-sur-Alzette  251 176820 #> 11    3   Luxembourg   10       Luxembourg  237 182607 #> 12    3   Luxembourg   11           Mersch  233  32112"},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":null,"dir":"Reference","previous_headings":"","what":"Conversion to a SpatVector of lines — as.lines","title":"Conversion to a SpatVector of lines — as.lines","text":"Conversion SpatRaster, SpatVector SpatExtent SpatVector lines.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Conversion to a SpatVector of lines — as.lines","text":"","code":"# S4 method for SpatRaster as.lines(x)  # S4 method for SpatVector as.lines(x)  # S4 method for SpatExtent as.lines(x, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Conversion to a SpatVector of lines — as.lines","text":"x SpatRaster, SpatVector SpatExtent crs character. coordinate reference system (see crs)","code":""},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Conversion to a SpatVector of lines — as.lines","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.lines.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Conversion to a SpatVector of lines — as.lines","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  as.lines(r) #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 6, 0  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)   as.lines(ext(r), crs=crs(r)) #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 1, 0  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)   if  (gdal() >= \"3.0.0\") {   p <- as.polygons(r)   as.lines(p) } #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 4, 1  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <int> #>  values      :     1 #>                    2 #>                    3"},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerce a Spat* object to a list — as.list","title":"Coerce a Spat* object to a list — as.list","text":"Coerce SpatRaster, SpatRasterCollection, SpatRasterDataset, SpatVector SpatVectorCollection list. SpatRaster, layer becomes list element. SpatRasterCollection SpatRasterDataset, SpatRaster becomes list element. SpatVector, variable (attribute) becomes list element. SpatVectorCollection, SpatVector becomes list element.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerce a Spat* object to a list — as.list","text":"","code":"# S4 method for SpatRaster as.list(x, geom=NULL, ...)  # S4 method for SpatRasterCollection as.list(x, ...)  # S4 method for SpatVector as.list(x, geom=NULL, ...)  # S4 method for SpatVectorCollection as.list(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerce a Spat* object to a list — as.list","text":"x SpatRaster, SpatRasterDataset, SpatRasterCollection, SpatVector geom character NULL. NULL, x SpatVector, either \"WKT\" \"HEX\", get geometry included Well-Known-Text hexadecimal notation. x point geometry, can also bey \"XY\" add coordinates point. x SpatRaster, value NULL return list parameters describing geometry SpatRaster returned ... additional arguments. ignored","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerce a Spat* object to a list — as.list","text":"list","code":""},{"path":"https://rspatial.github.io/terra/reference/as.list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coerce a Spat* object to a list — as.list","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) as.list(v) #> $ID_1 #>  [1] 1 1 1 1 1 2 2 2 3 3 3 3 #>  #> $NAME_1 #>  [1] \"Diekirch\"     \"Diekirch\"     \"Diekirch\"     \"Diekirch\"     \"Diekirch\"     #>  [6] \"Grevenmacher\" \"Grevenmacher\" \"Grevenmacher\" \"Luxembourg\"   \"Luxembourg\"   #> [11] \"Luxembourg\"   \"Luxembourg\"   #>  #> $ID_2 #>  [1]  1  2  3  4  5  6  7 12  8  9 10 11 #>  #> $NAME_2 #>  [1] \"Clervaux\"         \"Diekirch\"         \"Redange\"          \"Vianden\"          #>  [5] \"Wiltz\"            \"Echternach\"       \"Remich\"           \"Grevenmacher\"     #>  [9] \"Capellen\"         \"Esch-sur-Alzette\" \"Luxembourg\"       \"Mersch\"           #>  #> $AREA #>  [1] 312 218 259  76 263 188 129 210 185 251 237 233 #>  #> $POP #>  [1]  18081  32543  18664   5163  16735  18899  22366  29828  48187 176820 #> [11] 182607  32112 #>    s <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) + 1   as.list(s) #> [[1]] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> name        : red  #> min value   :   1  #> max value   : 256  #>  #> [[2]] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> name        : green  #> min value   :     1  #> max value   :   256  #>  #> [[3]] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> name        : blue  #> min value   :    1  #> max value   :  256  #>"},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":null,"dir":"Reference","previous_headings":"","what":"Conversion to a SpatVector of points — as.points","title":"Conversion to a SpatVector of points — as.points","text":"Conversion SpatRaster, SpatVector SpatExtent SpatVector points.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Conversion to a SpatVector of points — as.points","text":"","code":"# S4 method for SpatRaster as.points(x, values=TRUE, na.rm=TRUE, na.all=FALSE)  # S4 method for SpatVector as.points(x, multi=FALSE, skiplast=TRUE)  # S4 method for SpatExtent as.points(x, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Conversion to a SpatVector of points — as.points","text":"x SpatRaster, SpatVector SpatExtent values logical; include cell values attributes? multi logical. TRUE multi-point geometry returned skiplast logical. TRUE last point polygon (first point) included na.rm logical. TRUE cells NA ignored na.logical. TRUE cells ignored na.rm=TRUE value NA layers instead layer crs character. coordinate reference system (see crs)","code":""},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Conversion to a SpatVector of points — as.points","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.points.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Conversion to a SpatVector of points — as.points","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  as.points(r) #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 4, 1  (geometries, attributes) #>  extent      : -90, 90, -45, 45  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <num> #>  values      :     1 #>                    2 #>                    3  if  (gdal() >= \"3.0.0\") {   p <- as.polygons(r)   as.points(p) } #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 16, 1  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <int> #>  values      :     1 #>                    1 #>                    1"},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":null,"dir":"Reference","previous_headings":"","what":"Conversion to a SpatVector of polygons — as.polygons","title":"Conversion to a SpatVector of polygons — as.polygons","text":"Conversion SpatRaster, SpatVector SpatExtent SpatVector polygons.","code":""},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Conversion to a SpatVector of polygons — as.polygons","text":"","code":"# S4 method for SpatRaster as.polygons(x, round=TRUE, aggregate=TRUE, values=TRUE,     na.rm=TRUE, na.all=FALSE, extent=FALSE, digits=0, ...)  # S4 method for SpatVector as.polygons(x, extent=FALSE)  # S4 method for SpatExtent as.polygons(x, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Conversion to a SpatVector of polygons — as.polygons","text":"x SpatRaster, SpatVector SpatExtent round logical; TRUE aggregate=TRUE, values rounded aggregation. value FALSE SpatVector returned can many polygons can large aggregate logical; combine cells values? TRUE first layer x processed values logical; include cell values attributes? extent logical. TRUE, polygon extent SpatRaster SpatVector returned. x SpatRaster, polygon vertices row column, just four corners raster. can useful precise projection. required, efficient get extent represented four corners .polygons(ext(x), crs=crs(x)) na.rm logical. TRUE cells NA ignored na.logical. TRUE cells ignored na.rm=TRUE value NA layers instead layer digits integer. number digits rounding (round=TRUE) crs character. coordinate reference system (see crs) ... additional arguments. backward compatibility. removed future","code":""},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Conversion to a SpatVector of polygons — as.polygons","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/as.polygons.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Conversion to a SpatVector of polygons — as.polygons","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  if  (gdal() >= \"3.0.0\") {   p <- as.polygons(r)   p } #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 4, 1  (geometries, attributes) #>  extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #>  names       : lyr.1 #>  type        : <int> #>  values      :     1 #>                    2 #>                    3"},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerce to a ","title":"Coerce to a ","text":"Implementation generic .raster function create \"raster\" (small r) object. objects can used plotting rasterImage function. CONFUSED Raster* (big R) objects defined 'raster' package!","code":""},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerce to a ","text":"","code":"# S4 method for SpatRaster as.raster(x, maxcell=500000, col)"},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerce to a ","text":"x SpatRaster maxcell positive integer. Maximum number cells use plot col vector colors. default map.pal(\"viridis\", 100)","code":""},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerce to a ","text":"'raster' object","code":""},{"path":"https://rspatial.github.io/terra/reference/as.raster.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coerce to a ","text":"","code":"r <- rast(ncols=3, nrows=3) values(r) <- 1:ncell(r) as.raster(r) #>      [,1]      [,2]      [,3]      #> [1,] \"#440154\" \"#472B7A\" \"#3A528B\" #> [2,] \"#2C718E\" \"#218F8D\" \"#27AD80\" #> [3,] \"#5BC863\" \"#ADDC2F\" \"#FDE725\""},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":null,"dir":"Reference","previous_headings":"","what":"Two argument arc-tangent — atan2","title":"Two argument arc-tangent — atan2","text":"SpatRasters x y, atan2(y, x) returns angle radians tangent y/x, handling case x zero. See Trig See Math-methods trigonometric mathematical functions can used SpatRasters.","code":""},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Two argument arc-tangent — atan2","text":"","code":"# S4 method for SpatRaster,SpatRaster atan2(y, x)  # S4 method for SpatRaster,SpatRaster atan_2(y, x, filename, ...)"},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Two argument arc-tangent — atan2","text":"y SpatRaster x SpatRaster filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/atan2.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Two argument arc-tangent — atan2","text":"","code":"r1 <- rast(nrows=10, ncols=10) r2 <- rast(nrows=10, ncols=10) values(r1) <- (runif(ncell(r1))-0.5) * 10 values(r2) <- (runif(ncell(r1))-0.5) * 10 atan2(r1, r2) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :     lyr.1  #> min value   : -3.125421  #> max value   :  2.948635"},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial autocorrelation — autocorrelation","title":"Spatial autocorrelation — autocorrelation","text":"Compute spatial autocorrelation numeric vector SpatRaster. can compute standard (global) Moran's Geary's C, local indicators spatial autocorrelation (Anselin, 1995).","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial autocorrelation — autocorrelation","text":"","code":"# S4 method for numeric autocor(x, w, method=\"moran\")  # S4 method for SpatRaster autocor(x, w=matrix(c(1,1,1,1,0,1,1,1,1),3), method=\"moran\", global=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial autocorrelation — autocorrelation","text":"x numeric SpatRaster w Spatial weights defined rectangular matrix. SpatRaster matrix must sides must odd length (3, 5, ...) global logical. TRUE global autocorrelation computed instead local autocorrelation method character. x numeric SpatRaster: \"moran\" Moran's \"geary\" Geary's C. x numeric also: \"Gi\", \"Gi*\" (Getis-Ord statistics), locmor (local Moran's ) \"mean\" (local mean)","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial autocorrelation — autocorrelation","text":"numeric SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Spatial autocorrelation — autocorrelation","text":"default setting uses 3x3 neighborhood compute \"Queen's case\" indices. can use filter (weights matrix) things, \"Rook's case\", different lags.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Spatial autocorrelation — autocorrelation","text":"Moran, P..P., 1950. Notes continuous stochastic phenomena. Biometrika 37:17-23 Geary, R.C., 1954. contiguity ratio statistical mapping. Incorporated Statistician 5: 115-145 Anselin, L., 1995. Local indicators spatial association-LISA. Geographical Analysis 27:93-115 https://en.wikipedia.org/wiki/Indicators_of_spatial_association","code":""},{"path":"https://rspatial.github.io/terra/reference/autocor.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial autocorrelation — autocorrelation","text":"","code":"### raster r <- rast(nrows=10, ncols=10, xmin=0) values(r) <- 1:ncell(r)  autocor(r) #>    lyr.1  #> 1.117188   # rook's case neighbors f <- matrix(c(0,1,0,1,0,1,0,1,0), nrow=3) autocor(r, f) #> lyr.1  #>  1.25   # local  rc <- autocor(r, w=f, global=FALSE)  ### numeric (for vector data) f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- relate(v, relation=\"touches\")  # global autocor(v$AREA, w) #> [1] -0.1531971  # local v$Gi <- autocor(v$AREA, w, \"Gi\")  plot(v, \"Gi\")"},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":null,"dir":"Reference","previous_headings":"","what":"Bar plot of a SpatRaster — barplot","title":"Bar plot of a SpatRaster — barplot","text":"Create barplot values first layer SpatRaster. large datasets regular sample size approximately maxcells used.","code":""},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Bar plot of a SpatRaster — barplot","text":"","code":"# S4 method for SpatRaster barplot(height, maxcell=1000000, digits=0, breaks=NULL, col, ...)"},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Bar plot of a SpatRaster — barplot","text":"height SpatRaster maxcell integer. regularly subsample large datasets digits integer used determine round values tabulating. Set NULL large number want rounding breaks breaks used group data cut col color generating function rainbow (default), vector colors ... additional arguments plotting barplot","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Bar plot of a SpatRaster — barplot","text":"numeric vector (matrix, beside = TRUE) coordinates bar midpoints, useful adding graph. See barplot","code":""},{"path":"https://rspatial.github.io/terra/reference/barplot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Bar plot of a SpatRaster — barplot","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) barplot(r, digits=-1, las=2, ylab=\"Frequency\")   op <- par(no.readonly = TRUE) par(mai = c(1, 2, .5, .5)) barplot(r, breaks=10, col=c(\"red\", \"blue\"), horiz=TRUE, digits=NULL, las=1)  par(op)"},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":null,"dir":"Reference","previous_headings":"","what":"bestMatch — bestMatch","title":"bestMatch — bestMatch","text":"Determine grid cell reference similar . reference consists SpatVector reference locations, data.frame column matches layer name SpatRaster. Similarity computed sum squared differences cell reference. may important first scale input.","code":""},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"bestMatch — bestMatch","text":"","code":"# S4 method for SpatRaster,SpatVector bestMatch(x, y, labels=\"\", filename=\"\", ...)  # S4 method for SpatRaster,data.frame bestMatch(x, y, labels=\"\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"bestMatch — bestMatch","text":"x SpatRaster y SpatVector data.frame labels character. labels correspond class (row y filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"bestMatch — bestMatch","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/bestMatch.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"bestMatch — bestMatch","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f)  # locations of interest  pts <- vect(cbind(c(25.25, 34.324, 43.003), c(54.577, 46.489, 30.905))) pts$code <- LETTERS[1:3]  plot(r) points(pts, pch=20, cex=2, col=\"red\") text(pts, \"code\", pos=4, halo=TRUE)   x <- scale(r)  s1 <- bestMatch(x, pts, labels=pts$code) plot(s1)   # same result e <- extract(x, pts, ID=FALSE) s2 <- bestMatch(x, e, labels=c(\"Ap\", \"Nt\", \"Ms\"))"},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":null,"dir":"Reference","previous_headings":"","what":"Detect boundaries (edges) — boundaries","title":"Detect boundaries (edges) — boundaries","text":"Detect boundaries (edges). Boundaries cells one class 4 8 cells surrounding , , classes=FALSE, cells values cells NA.","code":""},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Detect boundaries (edges) — boundaries","text":"","code":"# S4 method for SpatRaster boundaries(x, classes=FALSE, inner=TRUE,           directions=8, falseval=0, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Detect boundaries (edges) — boundaries","text":"x SpatRaster inner logical. TRUE, \"inner\" boundaries returned, else \"outer\" boundaries returned classes character. Logical. TRUE different values (rounding) distinguished, well NA. FALSE (default) edges NA non-NA cells considered directions integer. cells considered adjacent? 8 (Queen's case) 4 (Rook's case) falseval numeric. value use cells boundary NA filename character. Output filename ... options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Detect boundaries (edges) — boundaries","text":"SpatRaster. Cell values either 1 (border) 0 (border), NA","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/boundaries.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Detect boundaries (edges) — boundaries","text":"","code":"r <- rast(nrows=18, ncols=36, xmin=0) r[150:250] <- 1 r[251:450] <- 2 bi <- boundaries(r) bo <- boundaries(r, inner=FALSE) bc <- boundaries(r, classes=TRUE) #plot(bc)"},{"path":"https://rspatial.github.io/terra/reference/box.html","id":null,"dir":"Reference","previous_headings":"","what":"draw a box — add_box","title":"draw a box — add_box","text":"Similar box allowing adding box around map. function place legend locations within mapped area delineated axes.","code":""},{"path":"https://rspatial.github.io/terra/reference/box.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"draw a box — add_box","text":"","code":"add_box(...)"},{"path":"https://rspatial.github.io/terra/reference/box.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"draw a box — add_box","text":"... arguments passed lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/box.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"draw a box — add_box","text":"","code":"v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) plot(v) add_box(col=\"red\", lwd=3, xpd=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":null,"dir":"Reference","previous_headings":"","what":"Box plot of SpatRaster data — boxplot","title":"Box plot of SpatRaster data — boxplot","text":"Box plot layers SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Box plot of SpatRaster data — boxplot","text":"","code":"# S4 method for SpatRaster boxplot(x, y=NULL, maxcell=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Box plot of SpatRaster data — boxplot","text":"x SpatRaster y NULL SpatRaster. x SpatRaster used group values x \"zone\" maxcell Integer. Number cells sample datasets ... additional arguments passed graphics::boxplot","code":""},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Box plot of SpatRaster data — boxplot","text":"boxplot returns list (invisibly) can used bxp","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/boxplot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Box plot of SpatRaster data — boxplot","text":"","code":"r1 <- r2 <- r3 <- rast(ncols=10, nrows=10) set.seed(409) values(r1) <- rnorm(ncell(r1), 100, 40) values(r2) <- rnorm(ncell(r1), 80, 10) values(r3) <- rnorm(ncell(r1), 120, 30) s <- c(r1, r2, r3) names(s) <- c(\"Apple\", \"Pear\", \"Cherry\")  boxplot(s, notch=TRUE, col=c(\"red\", \"blue\", \"orange\"), main=\"Box plot\", ylab=\"random\", las=1)   op <- par(no.readonly = TRUE) par(mar=c(4,6,2,2)) boxplot(s, horizontal=TRUE, col=\"lightskyblue\", axes=FALSE) axis(1) axis(2, at=0:3, labels=c(\"\", names(s)), las=1, cex.axis=.9, lty=0)  par(op)  ## boxplot with 2 layers v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) y <- rasterize(v, r, \"NAME_2\") b <- boxplot(r, y)  bxp(b)"},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a buffer around vector geometries or raster patches — buffer","title":"Create a buffer around vector geometries or raster patches — buffer","text":"Calculate buffer around cells NA SpatRaster, around geometries SpatVector. SpatRaster cells inside buffer distance get value 1. Note distance unit buffer width parameter meters CRS (+proj=longlat), map units (typically also meters) .","code":""},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a buffer around vector geometries or raster patches — buffer","text":"","code":"# S4 method for SpatRaster buffer(x, width, background=0, filename=\"\", ...)  # S4 method for SpatVector buffer(x, width, quadsegs=10, capstyle=\"round\",      joinstyle=\"round\", mitrelimit=NA, singlesided=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a buffer around vector geometries or raster patches — buffer","text":"x SpatRaster SpatVector width numeric. Unit meter x longitude/latitude CRS, units coordinate reference system cases (typically also meter). value > 0 x SpatRaster. x SpatVector, argument vectorized, meaning can provide different value geometry x; can also use name variable x widths filename character. Output filename ... additional arguments writing files writeRaster background numeric. value assign cells outside buffer. value zero FALSE, boolean SpatRaster returned quadsegs positive integer. Number line segments use draw quart circle capstyle character. One \"round\", \"square\" \"flat\". Ignored .lonlat(x) joinstyle character. One \"round\", \"mitre\" \"bevel\". Ignored .lonlat(x) mitrelimit numeric. Place upper bound mitre join avoid extending far acute angles input geometry. Ignored .lonlat(x) singlesided logical. TRUE buffer constructed one side input line.  Ignored .lonlat(x)","code":""},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a buffer around vector geometries or raster patches — buffer","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/buffer.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a buffer around vector geometries or raster patches — buffer","text":"","code":"r <- rast(ncols=36, nrows=18) r[500] <- 1 b <- buffer(r, width=5000000)  plot(b)   v <- vect(rbind(c(10,10), c(0,60)), crs=\"+proj=merc\") b <- buffer(v, 20) plot(b) points(v)   crs(v) <- \"+proj=longlat\"  b <- buffer(v, 1500000) plot(b) points(v)"},{"path":"https://rspatial.github.io/terra/reference/c.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine SpatRaster or SpatVector objects — c","title":"Combine SpatRaster or SpatVector objects — c","text":"c can: -- Combine SpatRaster objects. must extent resolution. However, x empty (cell values), geometry ignored warning. Two empty SpatRasters geometry can also combined (get summed number layers). Also see add<- -- Add SpatRaster SpatRasterDataset SpatRasterCollection -- Add SpatVector objects new existing SpatVectorCollection append SpatVectors, use rbind.","code":""},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine SpatRaster or SpatVector objects — c","text":"","code":"# S4 method for SpatRaster c(x, ..., warn=TRUE)  # S4 method for SpatRasterDataset c(x, ...)  # S4 method for SpatRasterCollection c(x, ...)  # S4 method for SpatVector c(x, ...)  # S4 method for SpatVectorCollection c(x, ...)"},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine SpatRaster or SpatVector objects — c","text":"x SpatRaster, SpatVector, SpatRasterDataset SpatVectorCollection warn logical. TRUE, warning emitted x empty SpatRaster ... x (can combine raster raster data vector vector data)","code":""},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine SpatRaster or SpatVector objects — c","text":"class x","code":""},{"path":"https://rspatial.github.io/terra/reference/c.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Combine SpatRaster or SpatVector objects — c","text":"","code":"r <- rast(nrows=5, ncols=9) values(r) <- 1:ncell(r) x <- c(r, r*2, r*3)"},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Cartogram — cartogram","title":"Cartogram — cartogram","text":"Make cartogram, , map area polygons made proportional another variable. can good way map raw count data (e.g. votes).","code":""},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cartogram — cartogram","text":"","code":"# S4 method for SpatVector cartogram(x, var, type)"},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cartogram — cartogram","text":"x SpatVector var character. variable name x type character. Cartogram type, \"nc\" (non-contiguous) currently supported","code":""},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cartogram — cartogram","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/cartogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cartogram — cartogram","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$value <- 1:12 p <- cartogram(v, \"value\", \"nc\") plot(v, col=\"light gray\", border=\"gray\") lines(p, col=\"red\", lwd=2)"},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":null,"dir":"Reference","previous_headings":"","what":"Factors to numeric — catalyze","title":"Factors to numeric — catalyze","text":"Change categorical layer one numerical layers. .numeric can transfer active category values cell values non-categorical SpatRaster. catalyze creates new layers category.","code":""},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Factors to numeric — catalyze","text":"","code":"# S4 method for SpatRaster as.numeric(x, index=NULL, filename=\"\", ...)  # S4 method for SpatRaster catalyze(x, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Factors to numeric — catalyze","text":"x SpatRaster index positive integer category indicating category use. NULL active category used filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Factors to numeric — catalyze","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/catalyze.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Factors to numeric — catalyze","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) + 10 d <- data.frame(id=11:13, cover=c(\"forest\", \"water\", \"urban\"), letters=letters[1:3], value=10:12) levels(r) <- d catalyze(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : cover, letters, value  #> min values  :     1,       1,    10  #> max values  :     3,       3,    12   activeCat(r) <- 3 as.numeric(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : letters  #> min value   :       1  #> max value   :       3"},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":null,"dir":"Reference","previous_headings":"","what":"Area covered by each raster cell — cellSize","title":"Area covered by each raster cell — cellSize","text":"Compute area covered individual raster cells. Computing surface area raster cells especially relevant longitude/latitude rasters. note angular (longitude/latitude) planar (projected) coordinate reference systems raster cells sizes generally constant, unless using equal-area coordinate reference system. planar CRSs, area therefore computed based linear units coordinate reference system, *actual* area transforming cells longitude/latitude. want correction, can use transform=FALSE init(x, prod(res(x)))","code":""},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Area covered by each raster cell — cellSize","text":"","code":"# S4 method for SpatRaster cellSize(x, mask=FALSE, lyrs=FALSE, unit=\"m\", transform=TRUE, rcx=100, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Area covered by each raster cell — cellSize","text":"x SpatRaster mask logical. TRUE, cells NA x also NA output lyrs logical. TRUE mask=TRUE, output number layers x. useful cases layers x different cells NA unit character. One \"m\", \"km\", \"ha\" transform logical. TRUE, planar CRS data transformed lon/lat accuracy rcx positive integer. maximum number rows columns used compute area planar data transform=TRUE. x rows /columns, raster aggregated match limit, values original cells estimated bilinear interpolation (see resample). can save lot time filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Area covered by each raster cell — cellSize","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/cellSize.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Area covered by each raster cell — cellSize","text":"","code":"# SpatRaster  r <- rast(nrows=18, ncols=36) v <- 1:ncell(r) v[200:400] <- NA values(r) <- v  # size of each raster cell a <- cellSize(r)  # illustration of distortion r <- rast(ncols=90, nrows=45, ymin=-80, ymax=80) m <- project(r, \"+proj=merc\")  bad <- init(m, prod(res(m)) / 1000000, names=\"naive\") good <- cellSize(m, unit=\"km\", names=\"corrected\") plot(c(good, bad), nc=1, mar=c(2,2,1,6))"},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":null,"dir":"Reference","previous_headings":"","what":"Get cell numbers — cells","title":"Get cell numbers — cells","text":"Get cell numbers covered SpatVector SpatExtent. match values vector; non NA values.","code":""},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get cell numbers — cells","text":"","code":"# S4 method for SpatRaster,missing cells(x, y)  # S4 method for SpatRaster,numeric cells(x, y, pairs=FALSE)  # S4 method for SpatRaster,SpatVector cells(x, y, method=\"simple\", weights=FALSE, exact=FALSE,          touches=is.lines(y), small=TRUE)  # S4 method for SpatRaster,SpatExtent cells(x, y)"},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get cell numbers — cells","text":"x SpatRaster y SpatVector, SpatExtent, 2-column matrix representing points, numeric representing values match, missing method character. Method getting cell numbers points. default \"simple\", alternative \"bilinear\". \"bilinear\", four nearest cells weights returned weights logical. TRUE y polygons, approximate fraction cell covered returned well pairs logical. TRUE cell values matched area also returned exact logical. TRUE y polygons, exact fraction cell covered returned well touches logical. TRUE, values cells touched lines polygons extracted, just line render path, whose center point within polygon. relevant points small logical. TRUE, values cells touched polygons extracted none cells center points within polygon; even touches=FALSE","code":""},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get cell numbers — cells","text":"numeric vector matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/cells.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get cell numbers — cells","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) r[c(1:25, 31:100)] <- NA r <- ifel(r > 28, r + 10, r)  # all cell numbers of cells that are not NA cells(r) #> [1] 26 27 28 29 30  # cell numbers that match values x <- cells(r, c(28,38)) x$lyr.1 #> [1] 28  # cells for points m <- cbind(x=c(0,10,-30), y=c(40,-10,20)) cellFromXY(r, m) #> [1] 26 56 35  v <- vect(m) cells(r, v) #>      ID cell #> [1,]  1   26 #> [2,]  2   56 #> [3,]  3   35 cells(r, v, method=\"bilinear\") #>      ID c1 c2 c3 c4  w1  w2  w3  w4 #> [1,]  1 25 26 35 36   0   1   0   0 #> [2,]  2 55 56 65 66 NaN NaN NaN NaN #> [3,]  3 34 35 44 45 NaN NaN NaN NaN  # cells for polygons f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) r <- rast(v) cv <- cells(r, v)"},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":null,"dir":"Reference","previous_headings":"","what":"Centroids — centroids","title":"Centroids — centroids","text":"Get centroids polygons lines, centroid-like points guaranteed inside polygons lines.","code":""},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Centroids — centroids","text":"","code":"# S4 method for SpatVector centroids(x, inside=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Centroids — centroids","text":"x SpatVector inside logical. TRUE points returned guaranteed inside polygons lines, true centroids. True centroids may outside polygon, example polygon \"bean shaped\", unlikely line","code":""},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Centroids — centroids","text":"SpatVector points","code":""},{"path":"https://rspatial.github.io/terra/reference/centroids.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Centroids — centroids","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) x <- centroids(v) y <- centroids(v, TRUE)"},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":null,"dir":"Reference","previous_headings":"","what":"Clamp values — clamp","title":"Clamp values — clamp","text":"Clamp values minimum maximum value. , values lower threshold value upper threshold value become either NA, , values=TRUE, become threshold value","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clamp values — clamp","text":"","code":"# S4 method for SpatRaster clamp(x, lower=-Inf, upper=Inf, values=TRUE, filename=\"\", ...)  # S4 method for numeric clamp(x, lower=-Inf, upper=Inf, values=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clamp values — clamp","text":"x SpatRaster lower numeric lowest acceptable value (can specify different value layer). SpatRaster single layer number layers x upper numeric highest acceptable value (can specify different value layer). SpatRaster single layer number layers x values logical. FALSE values outside clamping range become NA, TRUE, get extreme values filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Clamp values — clamp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/clamp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Clamp values — clamp","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) rc <- clamp(r, 25, 75)  rc #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   :    25  #> max value   :    75"},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":null,"dir":"Reference","previous_headings":"","what":"clamp time series data — clamp_ts","title":"clamp time series data — clamp_ts","text":"clamp time-series datat S shaped. value layers minimum value cell can set minimum value, value layers maximum value cell can set maximum value.","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"clamp time series data — clamp_ts","text":"","code":"# S4 method for SpatRaster clamp_ts(x, min=FALSE, max=TRUE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"clamp time series data — clamp_ts","text":"x SpatRaster min logical. TRUE time-series clamped minimum value max logical. TRUE time-series clamped maximum value filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"clamp time series data — clamp_ts","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/clamp_ts.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"clamp time series data — clamp_ts","text":"","code":"sigm <- function(x) { .8 / (1 + exp(-(x-10))) + runif(length(x))/4 } r <- rast(ncols=10, nrows=10, nlyr=50) s <- seq(5.2, 15,.2) set.seed(1) values(r) <- t(replicate(100, sigm(s)))  x <- clamp_ts(r, TRUE, TRUE)   plot(unlist(r[4])) lines(unlist(x[4]))"},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":null,"dir":"Reference","previous_headings":"","what":"Classify (or reclassify) cell values — classify","title":"Classify (or reclassify) cell values — classify","text":"Classify values SpatRaster. function (re-)classifies groups values values. classification done based argument rcl. can classify ranges specifying three-column matrix \"--becomes\" change specific values using two-column matrix \"-becomes\". can also supply vector \"cuts\" \"number cuts\". \"--becomes\" \"-becomes\" classification done row order matrix. Thus, overlapping ranges values, first time number within range determines reclassification value. \"cuts\" values sorted, order provided matter.","code":""},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Classify (or reclassify) cell values — classify","text":"","code":"# S4 method for SpatRaster classify(x, rcl, include.lowest=FALSE, right=TRUE,       others=NULL, brackets=TRUE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Classify (or reclassify) cell values — classify","text":"x SpatRaster rcl matrix classification. matrix must 1, 2 3 columns. three columns, first two columns \"\" \"\" input values, third column \"becomes\" new value range. two column matrix (\"\", \"becomes\") can useful classifying integer values. case, arguments right include.lowest ignored. single column matrix (vector) interpreted set cuts one value. case values classified based location -cut-values. single number provided, used make number cuts, equal intervals lowest highest values SpatRaster. include.lowest logical, indicating value equal lowest value rcl (highest value second column, right=FALSE) included. right logical. TRUE, intervals closed right (open left). FALSE open right closed left. \"open\" means extreme value ** included interval. Thus, right-closed left open (0,1] = {x | 0 < x <= 1}. can also close sides right=NA, meaningful \"--becomes\" classification integers. example classify 1-5 -> 1, 6-10 -> 2, 11-15 -> 3. may easier read write equivalent 1-5 -> 1, 5-10 -> 2, 10-15 -> 3 right=TRUE include.lowest=TRUE others numeric. NULL values matched set value. Otherwise retain original value. brackets logical. TRUE, intervals parenthesis brackets around indicate whether open closed. applies rcl vector (single column matrix) filename character. Output filename ... Additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Classify (or reclassify) cell values — classify","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Classify (or reclassify) cell values — classify","text":"classify works \"raw\" values categorical rasters, ignoring levels (labels, categories). change labels categorical rasters, use subst instead. model-based classification see predict","code":""},{"path":"https://rspatial.github.io/terra/reference/classify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Classify (or reclassify) cell values — classify","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- (0:99)/99  ## from-to-becomes # classify the values into three groups  # all values >= 0 and <= 0.25 become 1, etc. m <- c(0, 0.25, 1,        0.25, 0.5, 2,        0.5, 1, 3) rclmat <- matrix(m, ncol=3, byrow=TRUE) rc1 <- classify(r, rclmat, include.lowest=TRUE)  ## cuts # equivalent to the above, but now a categorical SpatRaster is returned  rc2 <- classify(r, c(0, 0.25, 0.5, 1), include.lowest=TRUE, brackets=TRUE) freq(rc2) #>   layer      value count #> 1     1   [0–0.25]    25 #> 2     1 (0.25–0.5]    25 #> 3     1    (0.5–1]    50  ## is-becomes  x <- round(r*3) unique(x) #>   lyr.1 #> 1     0 #> 2     1 #> 3     2 #> 4     3 # replace 0 with NA y <- classify(x, cbind(0, NA)) unique(y) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3  # multiple replacements m <- rbind(c(2, 200), c(3, 300)) m #>      [,1] [,2] #> [1,]    2  200 #> [2,]    3  300  rcx1 <- classify(x, m) unique(rcx1) #>   lyr.1 #> 1     0 #> 2     1 #> 3   200 #> 4   300  rcx2 <- classify(x, m, others=NA) unique(rcx2) #>   lyr.1 #> 1   200 #> 2   300"},{"path":"https://rspatial.github.io/terra/reference/click.html","id":null,"dir":"Reference","previous_headings":"","what":"Query by clicking on a map — click","title":"Query by clicking on a map — click","text":"Click map (plot) get coordinates values SpatRaster SpatVector location. SpatRaster can also get coordinates cell number location. work well default RStudio plotting device. work around , can first run dev.new(noRStudioGD = TRUE) create separate window plotting, use plot() followed click() click map.","code":""},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query by clicking on a map — click","text":"","code":"# S4 method for SpatRaster click(x, n=10, id=FALSE, xy=FALSE, cell=FALSE, type=\"p\", show=TRUE, ...)  # S4 method for SpatVector click(x,  n=10, id=FALSE, xy=FALSE, type=\"p\", show=TRUE, ...)  # S4 method for missing click(x, n=10, id=FALSE, type=\"p\", show=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query by clicking on a map — click","text":"x SpatRaster SpatVector, missing n number clicks plot (map) id logical. TRUE, numeric ID shown map corresponds row number output xy logical. TRUE, xy coordinates included output cell logical. TRUE, cell numbers included output type one \"n\", \"p\", \"l\" \"o\". \"p\" \"o\" points plotted; \"l\" \"o\" joined lines. See locator show logical. Print values click? ... additional graphics parameters used type != \"n\" plotting locations. See locator","code":""},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query by clicking on a map — click","text":"value(s) x point(s) clicked (touched box drawn). data.frame value(s) layers SpatRaster x cell(s) clicked ; attributes geometries SpatVector x intersect box drawn).","code":""},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Query by clicking on a map — click","text":"plot provides coordinates spatial query, values read SpatRaster SpatVector passed argument. Thus, can extract values object plotted, long spatially overlaps extent plot. Unless process terminated prematurely values n positions determined. identification process can terminated, depending interact R, hitting Esc, clicking right mouse button selecting \"Stop\" menu, \"Stop\" menu graphics window.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/click.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query by clicking on a map — click","text":"","code":"if (FALSE) { r <-rast(system.file(\"ex/elev.tif\", package=\"terra\")) plot(r) click(r, n=1) ## now click on the plot (map) }"},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":null,"dir":"Reference","previous_headings":"","what":"Coercion to vector, matrix or array — coerce","title":"Coercion to vector, matrix or array — coerce","text":"Coercion SpatRaster vector, matrix array. coerce SpatExtent vector matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coercion to vector, matrix or array — coerce","text":"","code":"# S4 method for SpatRaster as.vector(x, mode='any')  # S4 method for SpatRaster as.matrix(x, wide=FALSE, ...)  # S4 method for SpatRaster as.array(x)  # S4 method for SpatExtent as.vector(x, mode='any')  # S4 method for SpatExtent as.matrix(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coercion to vector, matrix or array — coerce","text":"x SpatRaster SpatVector wide logical. FALSE layer SpatRaster becomes column matrix cell SpatRaster becomes row. TRUE row SpatRaster becomes row matrix column SpatRaster becomes column matrix mode argument ignored ... additional arguments (none implemented)","code":""},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coercion to vector, matrix or array — coerce","text":"vector, matrix, array","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/coerce.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coercion to vector, matrix or array — coerce","text":"","code":"r <- rast(ncols=2, nrows=2) values(r) <- 1:ncell(r)  as.vector(r) #> [1] 1 2 3 4 as.matrix(r) #>      lyr.1 #> [1,]     1 #> [2,]     2 #> [3,]     3 #> [4,]     4 as.matrix(r, wide=TRUE) #>      [,1] [,2] #> [1,]    1    2 #> [2,]    3    4 as.data.frame(r, xy=TRUE) #>     x   y lyr.1 #> 1 -90  45     1 #> 2  90  45     2 #> 3 -90 -45     3 #> 4  90 -45     4 as.array(r) #> , , 1 #>  #>      [,1] [,2] #> [1,]    1    2 #> [2,]    3    4 #>   as.vector(ext(r)) #> xmin xmax ymin ymax  #> -180  180  -90   90  as.matrix(ext(r)) #>       min max #> [1,] -180 180 #> [2,]  -90  90"},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":null,"dir":"Reference","previous_headings":"","what":"tighten SpatRaster or SpatRasterDataset objects — tighten","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"Combines data sources within SpatRaster (memory, file) allow faster processing. combine sub-datasets SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"","code":"# S4 method for SpatRaster tighten(x)  # S4 method for SpatRasterDataset tighten(x)"},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"x SpatRaster SpatRasterDataset","code":""},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/collapse.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"tighten SpatRaster or SpatRasterDataset objects — tighten","text":"","code":"r <- rast(nrow=5, ncol=9, vals=1:45) x <- c(r, r*2, r*3) x #> class       : SpatRaster  #> dimensions  : 5, 9, 3  (nrow, ncol, nlyr) #> resolution  : 40, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     1,     2,     3  #> max values  :    45,    90,   135  tighten(x) #> class       : SpatRaster  #> dimensions  : 5, 9, 3  (nrow, ncol, nlyr) #> resolution  : 40, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1, lyr.1  #> min values  :     1,     2,     3  #> max values  :    45,    90,   135"},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":null,"dir":"Reference","previous_headings":"","what":"Color table — colors","title":"Color table — colors","text":"Get set color table(s) associated SpatRaster. Color tables used associating colors values, use mapping (plot).","code":""},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Color table — colors","text":"","code":"# S4 method for SpatRaster coltab(x)  # S4 method for SpatRaster coltab(x, ..., layer=1)<-value  # S4 method for SpatRaster has.colors(x)"},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Color table — colors","text":"x SpatRaster layer positive integer, layer number name value two-column data.frame (first column cell value, second column color);    vector colors (first one color value 0 ); four (value,red,green,blue) five (including alpha) column data.frame also 0 n; NULL remove color table. can also supply list data.frames set color table layers ... additional arguments (none implemented)","code":""},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Color table — colors","text":"data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/colors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Color table — colors","text":"","code":"r <- rast(ncols=3, nrows=2, vals=1:6) coltb <- data.frame(value=1:6, col=rainbow(6, end=.9)) coltb #>   value     col #> 1     1 #FF0000 #> 2     2 #EBFF00 #> 3     3 #00FF29 #> 4     4 #00C2FF #> 5     5 #5200FF #> 6     6 #FF0099  plot(r)   has.colors(r) #> [1] FALSE coltab(r) <- coltb plot(r)  has.colors(r) #> [1] TRUE  tb <- coltab(r) class(tb) #> [1] \"list\" dim(tb[[1]]) #> [1] 6 5"},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine geometries — combineGeoms","title":"Combine geometries — combineGeoms","text":"Combine geometries one SpatVector another. Geometries can combined based overlap, shared boundaries distance (order operation). typical use-case method editing geometries number small polygons one SpatVector part geometries another SpatVector; perhaps small holes inbetween borders two SpatVectors. append SpatVectors use `rbind` see methods like intersect union \"normal\" polygons combinations.","code":""},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine geometries — combineGeoms","text":"","code":"# S4 method for SpatVector,SpatVector combineGeoms(x, y, overlap=TRUE, boundary=TRUE, distance=TRUE,   append=TRUE, minover=0.1, maxdist=Inf, dissolve=TRUE, erase=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine geometries — combineGeoms","text":"x SpatVector polygons y SpatVector polygons geometries combined x overlap logical. TRUE, geometry combined geometry overlap , overlap minover boundary logical. TRUE, geometry combined geometry shared border distance logical. TRUE, geometry combined geometry nearest append logical. remaining geometries appended output? relevant distance=TRUE minover numeric. fraction geometry y overlaps geometry x. threshold, geometries considered overlapping maxdist numeric. Geometries away distance (meters) combined dissolve logical. internal boundaries dissolved? erase logical. TRUE new overlapping areas created","code":""},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine geometries — combineGeoms","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/combineGeoms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Combine geometries — combineGeoms","text":"","code":"x1 <- vect(\"POLYGON ((0 0, 8 0, 8 9, 0 9, 0 0))\") x2 <- vect(\"POLYGON ((10 4, 12 4, 12 7, 11 7, 11 6, 10 6, 10 4))\")  y1 <- vect(\"POLYGON ((5 6, 15 6, 15 15, 5 15, 5 6))\") y2 <- vect(\"POLYGON ((8 2, 9 2, 9 3, 8 3, 8 2))\") y3 <- vect(\"POLYGON ((2 6, 3 6, 3 8, 2 8, 2 6))\") y4 <- vect(\"POLYGON ((2 12, 3 12, 3 13, 2 13, 2 12))\")  x <- rbind(x1, x2) values(x) <- data.frame(xid=1:2) crs(x) <- \"+proj=utm +zone=1\"  y <- rbind(y1, y2, y3, y4) values(y) <- data.frame(yid=letters[1:4]) crs(y) <- \"+proj=utm +zone=1\"  plot(rbind(x, y), border=c(rep(\"red\",2), rep(\"blue\", 4)), lwd=2) text(x, \"xid\") text(y, \"yid\")   v <- combineGeoms(x, y) plot(v, col=c(\"red\", \"blue\"))   v <- combineGeoms(x, y, boundary=FALSE, maxdist=1, minover=.05) plot(v, col=rainbow(4))"},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare and logical methods — Compare-methods","title":"Compare and logical methods — Compare-methods","text":"Standard comparison logical operators computations SpatRasters. Computations local (applied cell cell basis). multiple SpatRasters used, must geometry (extent resolution). operators implemented: Logical: !, &, |, isTRUE, isFALSE Compare:  ==, !=, >, <,  <=, >=, .na, .nan, .finite, .infinite See .na inverse .na, noNA detect cells missing value across layers. compare logic methods implement operators method can return NA istead FALSE allows setting output filename. terra package distinguish NA (available) NaN (number). cases state represented NaN. use SpatRaster vector multiple numbers, element vector considered layer (constant value). use SpatRaster matrix, number columns matrix must match number layers SpatRaster. rows used match cells. , two rows, match cells 1 2, recycled 3 4, etc. following method implemented (SpatExtent, SpatExtent): ==","code":""},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare and logical methods — Compare-methods","text":"","code":"# S4 method for SpatRaster compare(x, y, oper, falseNA=FALSE, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatRaster logic(x, oper, falseNA=FALSE, filename=\"\", overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare and logical methods — Compare-methods","text":"x SpatRaster y SpatRaster numeric oper character. Operator name. compare can one \"==\", \"!=\", \">\", \"<\", \">=\", \"<=\" logic can one \"!\", \".na\", \"allNA\", \"noNA\", \".infinite\", \".finite\", \"iSTRUE\", \"isFALSE\" falseNA logical. result TRUE, NA instead TRUE, FALSE? filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare and logical methods — Compare-methods","text":"SpatRaster SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/compare-generics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare and logical methods — Compare-methods","text":"","code":"r1 <- rast(ncols=10, nrows=10) values(r1) <- runif(ncell(r1)) r1[10:20] <- NA r2 <- rast(r1) values(r2) <- 1:ncell(r2) / ncell(r2)  x <- is.na(r1) !x #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   : FALSE  #> max value   :  TRUE  r1 == r2  #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   : FALSE  #> max value   : FALSE  compare(r1, r2, \"==\") #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   : FALSE  #> max value   : FALSE  compare(r1, r2, \"==\", TRUE) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr.1  #> min value   :  TRUE  #> max value   :  TRUE"},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare geometries of SpatRasters — compareGeom","title":"Compare geometries of SpatRasters — compareGeom","text":"Evaluate whether two SpatRasters extent, number rows columns, projection, resolution, origin (subset comparisons). evaluate whether two SpatVectors geometries, whether SpatVector duplicated geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare geometries of SpatRasters — compareGeom","text":"","code":"# S4 method for SpatRaster,SpatRaster compareGeom(x, y, ..., lyrs=FALSE, crs=TRUE, warncrs=FALSE, ext=TRUE,   rowcol=TRUE, res=FALSE, stopOnError=TRUE, messages=FALSE)  # S4 method for SpatVector,SpatVector compareGeom(x, y, tolerance=0)  # S4 method for SpatVector,missing compareGeom(x, y, tolerance=0)"},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare geometries of SpatRasters — compareGeom","text":"x SpatRaster SpatVector y x. x SpatRaster, y can also list SpatRasters. x SpatVector, y can missing ... Additional SpatRasters lyrs logical. TRUE, number layers compared crs logical. TRUE, coordinate reference systems compared warncrs logical. TRUE, warning given crs different (instead error) ext logical. TRUE, bounding boxes compared rowcol logical. TRUE, number rows columns objects compared res logical. TRUE, resolutions compared (redundant checking extent rowcol) stopOnError logical. TRUE, code execution stops raster match messages logical. TRUE, warning/error messages printed even stopOnError=FALSE tolerance numeric","code":""},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare geometries of SpatRasters — compareGeom","text":"logical (SpatRaster) matrix logical (SpatVector)","code":""},{"path":"https://rspatial.github.io/terra/reference/compareGeom.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare geometries of SpatRasters — compareGeom","text":"","code":"r1 <- rast() r2 <- rast() r3 <- rast() compareGeom(r1, r2, r3) #> [1] TRUE nrow(r3) <- 10   if (FALSE) { compareGeom(r1, r3) }"},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":null,"dir":"Reference","previous_headings":"","what":"Concatenate categorical rasters — concats","title":"Concatenate categorical rasters — concats","text":"Combine two categorical rasters concatenating levels.","code":""},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Concatenate categorical rasters — concats","text":"","code":"# S4 method for SpatRaster concats(x, y, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Concatenate categorical rasters — concats","text":"x SpatRaster (single, categorical, layer) y SpatRaster (single, categorical, layer) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Concatenate categorical rasters — concats","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/concats.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Concatenate categorical rasters — concats","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) levels(r) <- data.frame(id=1:3, cover=c(\"forest\", \"water\", \"urban\"))  rr <- rast(r) values(rr) <- sample(1:3, ncell(rr), replace=TRUE) levels(rr) <- data.frame(id=c(1:3), color=c(\"red\", \"green\", \"blue\"))  x <- concats(r, rr) x #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : cover_color  #> name        : cover_color  #> min value   :  forest_red  #> max value   :  urban_blue  levels(x)[[1]] #>   ID  cover_color #> 1  0   forest_red #> 2  1 forest_green #> 3  2  forest_blue #> 4  3    water_red #> 5  4  water_green #> 6  5   water_blue #> 7  6    urban_red #> 8  7  urban_green #> 9  8   urban_blue"},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":null,"dir":"Reference","previous_headings":"","what":"Contour plot — contour","title":"Contour plot — contour","text":"Contour lines (isolines) SpatRaster. Use add=TRUE add lines current plot.  See graphics::contour details. filled=TRUE, new filled contour plot made. See graphics::filled.contour details. .contour returns contour lines SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Contour plot — contour","text":"","code":"# S4 method for SpatRaster contour(x, maxcells=100000, filled=FALSE, ...)  # S4 method for SpatRaster as.contour(x, maxcells=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Contour plot — contour","text":"x SpatRaster. first layer used maxcells maximum number pixels used create contours filled logical. TRUE, filled.contour plot made ... argument can passed contour  filled.contour (graphics package)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/contour.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Contour plot — contour","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) plot(r) contour(r, add=TRUE)   v <- as.contour(r) plot(r) lines(v)   contour(r, filled=TRUE, nlevels=5)   ## if you want a SpatVector with contour lines template <- disagg(rast(r), 10) rr <- resample(r, template) rr <- floor(rr/100) * 100 v <- as.polygons(rr) plot(v, 1, col=terrain.colors(7))"},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":null,"dir":"Reference","previous_headings":"","what":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"Get convex hull, minimal bounding rotated rectangle, minimal bounding circle SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"","code":"# S4 method for SpatVector convHull(x, by=\"\")  # S4 method for SpatVector minRect(x, by=\"\")  # S4 method for SpatVector minCircle(x, by=\"\")"},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"x SpatVector character (variable name), get new geometry groups input geometries","code":""},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/convhull.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Convex hull, minimal bounding rotated rectangle, and minimal bounding circle — convHull","text":"","code":"p <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) h <- convHull(p)  hh <- convHull(p, \"NAME_1\") rr <- minRect(p, \"NAME_1\")  plot(rr, lwd=5, border=\"gray\") plot(hh, \"NAME_1\", col=rainbow(10, alpha=.5), lwd=3, add=TRUE, plg=list(x=\"topright\")) lines(aggregate(p, \"NAME_1\"), col=\"blue\", lty=2, lwd=2)"},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":null,"dir":"Reference","previous_headings":"","what":"Cost-distance — costDist","title":"Cost-distance — costDist","text":"Use friction (cost) surface compute cost-distance cell border one target cells. Distances computed summing local distances cells, connected neighbors 8 directions, assuming path go centers one neighboring raster cells. Distances multiplied friction, thus get cost-distance, friction surface must express cost per unit distance (speed) travel.","code":""},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cost-distance — costDist","text":"","code":"# S4 method for SpatRaster costDist(x, target=0, scale=1, maxiter=50, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cost-distance — costDist","text":"x SpatRaster target numeric. value target cells (compute cost-distance ) scale numeric. Scale factor. cost distance divided number maxiter numeric. maximum number iterations. Increase number get warning costDistance converge filename character. output filename (optional) ... additional arguments writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cost-distance — costDist","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/costDist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cost-distance — costDist","text":"","code":"r <- rast(ncols=5, nrows=5, crs=\"+proj=utm +zone=1 +datum=WGS84\",      xmin=0, xmax=5, ymin=0, ymax=5, vals=1) r[13] <- 0 d <- costDist(r) plot(d) text(d, digits=1)   r <- rast(ncols=10, nrows=10,  xmin=0, xmax=10, ymin=0, ymax=10,         vals=10, crs=\"+proj=utm +zone=1 +datum=WGS84\") r[5, 1] <- -10 r[2:3, 1] <- r[1, 2:4] <- r[2, 5] <- 0 r[3, 6] <- r[2, 7] <- r[1, 8:9] <- 0 r[6, 6:10] <- NA r[6:9, 6] <- NA  d <- costDist(r, -10) plot(d) text(d, digits=1, cex=.8)"},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace values with values from another object — cover","title":"Replace values with values from another object — cover","text":"Replace NA values SpatRaster x values SpatRaster y polygons: areas x overlap y replaced y , identity=TRUE intersected y.","code":""},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace values with values from another object — cover","text":"","code":"# S4 method for SpatRaster,SpatRaster cover(x, y, values=NA, filename=\"\", ...)  # S4 method for SpatVector,SpatVector cover(x, y, identity=FALSE, expand=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace values with values from another object — cover","text":"x SpatRaster SpatVector y x values numeric. cell values x replaced values y filename character. Output filename ... additional arguments writing files writeRaster identity logical. TRUE overlapping areas intersected rather replaced expand logical. parts y outside x included?","code":""},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace values with values from another object — cover","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/cover.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace values with values from another object — cover","text":"","code":"r1 <- r2 <- rast(ncols=36, nrows=18) values(r1) <- 1:ncell(r1) values(r2) <- runif(ncell(r2)) r2 <- classify(r2, cbind(-Inf, 0.5, NA)) r3 <- cover(r2, r1)   p <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) e <- as.polygons(ext(6, 6.4, 49.75, 50)) values(e) <- data.frame(y=10)  cv <- cover(p, e) plot(cv, col=rainbow(12)) ci <- cover(p, e, identity=TRUE) lines(e, lwd=3)   plot(ci, col=rainbow(12)) lines(e, lwd=3)"},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"Get coordinates SpatVector SpatRaster cells. matrix data.frame x (longitude) y (latitude) coordinates returned.","code":""},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"","code":"# S4 method for SpatVector crds(x, df=FALSE, list=FALSE)  # S4 method for SpatRaster crds(x, df=FALSE, na.rm=TRUE, na.all=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"x SpatRaster SpatVector df logical. TRUE data.frame returned instead matrix list logical. TRUE list returned instead matrix na.rm logical. TRUE cells NA excluded. Ignored SpatRaster template associated cell values na.logical. TRUE cells ignored na.rm=TRUE value NA layers instead layer","code":""},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"matrix data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/crds.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the coordinates of SpatVector geometries or SpatRaster cells — crds","text":"","code":"x1 <- rbind(c(-175,-20), c(-140,55), c(10, 0), c(-140,-60)) x2 <- rbind(c(-125,0), c(0,60), c(40,5), c(15,-45)) x3 <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) x4 <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13)) z <- rbind(cbind(object=1, part=1, x1), cbind(object=2, part=1, x2),             cbind(object=3, part=1, x3), cbind(object=3, part=2, x4)) colnames(z)[3:4] <- c('x', 'y') z <- cbind(z, hole=0) z[(z[, \"object\"]==3 & z[,\"part\"]==2), \"hole\"] <- 1  p <- vect(z, \"polygons\") crds(p) #>          x   y #>  [1,] -175 -20 #>  [2,] -140  55 #>  [3,]   10   0 #>  [4,] -140 -60 #>  [5,] -175 -20 #>  [6,] -125   0 #>  [7,]    0  60 #>  [8,]   40   5 #>  [9,]   15 -45 #> [10,] -125   0 #> [11,]  -10   0 #> [12,]  140  60 #> [13,]  160   0 #> [14,]  140 -55 #> [15,]  -10   0 #> [16,]   80   0 #> [17,]  105  13 #> [18,]  120   2 #> [19,]  105 -13 #> [20,]   80   0  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) g <- crds(v) head(g) #>             x        y #> [1,] 6.026519 50.17767 #> [2,] 6.031361 50.16563 #> [3,] 6.035646 50.16410 #> [4,] 6.042747 50.16157 #> [5,] 6.043894 50.16116 #> [6,] 6.048243 50.16008"},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":null,"dir":"Reference","previous_headings":"","what":"Cut out a geographic subset — crop","title":"Cut out a geographic subset — crop","text":"Cut part SpatRaster SpatVector. can crop SpatRaster SpatExtent, another object extent can obtained. Note SpatRaster returned may exactly extent SpatExtent supplied can select entire cells (rows columns), add new areas. See methods like resample disagg force SpatRasters align extend add rows /columns. can crop rectangular areas SpatRaster, see argument mask=TRUE setting cell values within SpatRaster NA; use mask method crop additional masking options. can crop SpatVector another SpatVector. polygons, minimum convex hull used. Unlike intersect geometries attributes y transferred output. can also crop SpatVector rectangle (SpatRaster, SpatExtent).","code":""},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cut out a geographic subset — crop","text":"","code":"# S4 method for SpatRaster crop(x, y, snap=\"near\", mask=FALSE, touches=TRUE, extend=FALSE, filename=\"\", ...)  # S4 method for SpatRasterDataset crop(x, y, snap=\"near\", extend=FALSE)  # S4 method for SpatRasterCollection crop(x, y, snap=\"near\", extend=FALSE)  # S4 method for SpatVector crop(x, y, ext=FALSE)  # S4 method for SpatGraticule crop(x, y)"},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cut out a geographic subset — crop","text":"x SpatRaster SpatVector y SpatRaster, SpatVector, SpatExtent, object SpatExtent (ext returns SpatExtent) snap character. One \"near\", \"\", \"\". Used align y geometry x mask logical. y used mask? used y SpatVector, SpatRaster sf touches logical. TRUE mask=TRUE, cells touched lines polygons masked, just line render path, whose center point within polygon extend logical. rows /columns added y beyond extent x? Also see extend filename character. Output filename ... additional arguments writing files writeRaster ext logical. Use extent y instead y. also changes behavior y extent two ways: (1) points extent boundary removed (2) lon/lat extents go beyond -180 180 degrees longitude wrapped around earth include areas end dateline","code":""},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cut out a geographic subset — crop","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/crop.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cut out a geographic subset — crop","text":"","code":"r <- rast(xmin=0, xmax=10, ymin=0, ymax=10, nrows=25, ncols=25) values(r) <- 1:ncell(r) e <- ext(-5, 5, -5, 5) rc <- crop(r, e)  # crop and mask f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) cm <- crop(r, v[9:12,], mask=TRUE) plot(cm) lines(v)   # crop vector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) e <- ext(6.15, 6.3, 49.7, 49.8) x <- crop(v, e) plot(x, \"NAME_1\")"},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":null,"dir":"Reference","previous_headings":"","what":"Cross-tabulate — crosstab","title":"Cross-tabulate — crosstab","text":"Cross-tabulate layers SpatRaster create contingency table.","code":""},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cross-tabulate — crosstab","text":"","code":"# S4 method for SpatRaster,missing crosstab(x, digits=0, long=FALSE, useNA=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cross-tabulate — crosstab","text":"x SpatRaster digits integer. number digits rounding values cross-tabulation long logical. TRUE results returned 'long' format data.frame instead table useNA logical, indicting table includes counts NA values","code":""},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cross-tabulate — crosstab","text":"table data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/crosstab.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cross-tabulate — crosstab","text":"","code":"r <- s <- rast(nc=5, nr=5) set.seed(1) values(r) <- runif(ncell(r)) * 2 values(s) <- runif(ncell(r)) * 3 x <- c(r, s)  crosstab(x) #>      lyr.1.1 #> lyr.1 0 1 2 3 #>     0 1 1 4 0 #>     1 2 5 5 0 #>     2 0 2 4 1  rs <- r/s r[1:5] <- NA s[20:25] <- NA x <- c(r, s, rs) crosstab(x, useNA=TRUE, long=TRUE) #>    lyr.1 lyr.1.1 lyr.1.2 n #> 1      0       2       0 3 #> 2      0      NA       0 1 #> 3      0      NA       6 1 #> 4      1       0       4 1 #> 5      1       1       1 1 #> 6      1       1       2 1 #> 7      1       2       0 3 #> 8      1       2       1 1 #> 9      1      NA       0 1 #> 10     1      NA       1 1 #> 11     2       1       1 2 #> 12     2       2       1 2 #> 13     2      NA       1 2 #> 14    NA       0      19 1 #> 15    NA       1       0 2 #> 16    NA       1       1 1 #> 17    NA       3       1 1"},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":null,"dir":"Reference","previous_headings":"","what":"Get or set a coordinate reference system — crs","title":"Get or set a coordinate reference system — crs","text":"Get set coordinate reference system (CRS), also referred \"projection\", SpatRaster SpatVector. Setting new CRS change data , just changes label. set CRS dataset (come one) **, *like *. See project *transform* object one CRS another.","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get or set a coordinate reference system — crs","text":"","code":"# S4 method for SpatRaster crs(x, proj=FALSE, describe=FALSE, parse=FALSE)  # S4 method for SpatVector crs(x, proj=FALSE, describe=FALSE, parse=FALSE)  # S4 method for character crs(x, proj=FALSE, describe=FALSE, parse=FALSE)  # S4 method for SpatRaster crs(x, warn=FALSE)<-value  # S4 method for SpatVector crs(x, warn=FALSE)<-value"},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get or set a coordinate reference system — crs","text":"x SpatRaster SpatVector proj logical. TRUE crs returned PROJ-string notation describe logical. TRUE name, EPSG code, name extent area use returned known warn logical. TRUE, message printed object already non-empty crs value character string describing coordinate reference system. can WKT format, <authority:number> code \"EPSG:4326\", PROJ-string format \"+proj=utm +zone=12\" (see Note) parse logical. TRUE, wkt parts parsed vector (line becomes element)","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Get or set a coordinate reference system — crs","text":"Projections handled PROJ/GDAL libraries. PROJ developers suggest define CRS WKT2 <authority>:<code> notation. practical define one's custom CRS WKT2, <authority>:<code> system covers handful (commonly used) CRSs. work around problem still possible use deprecated PROJ-string notation (+proj=...) one major caveat: datum WGS84 (equivalent NAD83) -- want transform data coordinate reference system different datum. Thus long use WGS84, ellipsoid instead datum, can safely use PROJ-strings represent CRS; including define custom CRS. can also set crs \"local\" get informal coordinate system arbitrary Euclidean (Cartesian) plane units meter.","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get or set a coordinate reference system — crs","text":"character modified SpatRaster/Vector","code":""},{"path":"https://rspatial.github.io/terra/reference/crs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get or set a coordinate reference system — crs","text":"","code":"r <- rast() crs(r) #> [1] \"GEOGCRS[\\\"WGS 84 (CRS84)\\\",\\n    DATUM[\\\"World Geodetic System 1984\\\",\\n        ELLIPSOID[\\\"WGS 84\\\",6378137,298.257223563,\\n            LENGTHUNIT[\\\"metre\\\",1]]],\\n    PRIMEM[\\\"Greenwich\\\",0,\\n        ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\\n    CS[ellipsoidal,2],\\n        AXIS[\\\"geodetic longitude (Lon)\\\",east,\\n            ORDER[1],\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\\n        AXIS[\\\"geodetic latitude (Lat)\\\",north,\\n            ORDER[2],\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\\n    USAGE[\\n        SCOPE[\\\"unknown\\\"],\\n        AREA[\\\"World\\\"],\\n        BBOX[-90,-180,90,180]],\\n    ID[\\\"OGC\\\",\\\"CRS84\\\"]]\" crs(r, describe=TRUE, proj=TRUE) #>             name authority  code  area             extent #> 1 WGS 84 (CRS84)       OGC CRS84 World -180, 180, -90, 90 #>                                  proj #> 1 +proj=longlat +datum=WGS84 +no_defs  crs(r) <- \"+proj=lcc +lat_1=48 +lat_2=33 +lon_0=-100 +ellps=WGS84\" crs(r) #> [1] \"PROJCRS[\\\"unknown\\\",\\n    BASEGEOGCRS[\\\"unknown\\\",\\n        DATUM[\\\"Unknown based on WGS 84 ellipsoid\\\",\\n            ELLIPSOID[\\\"WGS 84\\\",6378137,298.257223563,\\n                LENGTHUNIT[\\\"metre\\\",1],\\n                ID[\\\"EPSG\\\",7030]]],\\n        PRIMEM[\\\"Greenwich\\\",0,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8901]]],\\n    CONVERSION[\\\"unknown\\\",\\n        METHOD[\\\"Lambert Conic Conformal (2SP)\\\",\\n            ID[\\\"EPSG\\\",9802]],\\n        PARAMETER[\\\"Latitude of false origin\\\",0,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8821]],\\n        PARAMETER[\\\"Longitude of false origin\\\",-100,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8822]],\\n        PARAMETER[\\\"Latitude of 1st standard parallel\\\",48,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8823]],\\n        PARAMETER[\\\"Latitude of 2nd standard parallel\\\",33,\\n            ANGLEUNIT[\\\"degree\\\",0.0174532925199433],\\n            ID[\\\"EPSG\\\",8824]],\\n        PARAMETER[\\\"Easting at false origin\\\",0,\\n            LENGTHUNIT[\\\"metre\\\",1],\\n            ID[\\\"EPSG\\\",8826]],\\n        PARAMETER[\\\"Northing at false origin\\\",0,\\n            LENGTHUNIT[\\\"metre\\\",1],\\n            ID[\\\"EPSG\\\",8827]]],\\n    CS[Cartesian,2],\\n        AXIS[\\\"(E)\\\",east,\\n            ORDER[1],\\n            LENGTHUNIT[\\\"metre\\\",1,\\n                ID[\\\"EPSG\\\",9001]]],\\n        AXIS[\\\"(N)\\\",north,\\n            ORDER[2],\\n            LENGTHUNIT[\\\"metre\\\",1,\\n                ID[\\\"EPSG\\\",9001]]]]\"  # You can use epsg codes crs(r)  <- \"epsg:25831\" crs(r, describe=TRUE)$area #> [1] \"Europe between 0°E and 6°E: Andorra; Belgium - onshore and offshore; Denmark - offshore; Germany - offshore; Jan Mayen - offshore; Norway including Svalbard - onshore and offshore; Spain - onshore and offshore\"  crs(\"epsg:25831\", describe=TRUE) #>                    name authority  code #> 1 ETRS89 / UTM zone 31N      EPSG 25831 #>                                                                                                                                                                                                                area #> 1 Europe between 0°E and 6°E: Andorra; Belgium - onshore and offshore; Denmark - offshore; Germany - offshore; Jan Mayen - offshore; Norway including Svalbard - onshore and offshore; Spain - onshore and offshore #>                     extent #> 1 0.00, 6.01, 37.00, 82.45"},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":null,"dir":"Reference","previous_headings":"","what":"Data type of a SpatRaster or SpatVector — datatype","title":"Data type of a SpatRaster or SpatVector — datatype","text":"Get data types fields (attributes, variables) SpatVector file(s) associated SpatRaster. (layer ) SpatRaster datatype values, values memory.","code":""},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data type of a SpatRaster or SpatVector — datatype","text":"","code":"# S4 method for SpatRaster datatype(x, bylyr=TRUE)  # S4 method for SpatVector datatype(x)"},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Data type of a SpatRaster or SpatVector — datatype","text":"x SpatRaster SpatVector bylyr logical. TRUE value returned layer. Otherwise, value returned data source (file)","code":""},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Data type of a SpatRaster or SpatVector — datatype","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/datatype.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data type of a SpatRaster or SpatVector — datatype","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) datatype(v) #> [1] \"double\" \"string\" \"double\" \"string\" \"double\" \"long\"    f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) datatype(r) #> [1] \"INT2S\"  # no data type datatype(rast())  #> [1] \"\""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":null,"dir":"Reference","previous_headings":"","what":"Deep copy — deepcopy","title":"Deep copy — deepcopy","text":"Make deep copy SpatRaster SpatVector. occasionally useful wanting use replacement function shallow copy. copy created like : x <- y. use replacement function change object, shallow copies also change.","code":""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deep copy — deepcopy","text":"","code":"# S4 method for SpatRaster deepcopy(x)  # S4 method for SpatVector deepcopy(x)"},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Deep copy — deepcopy","text":"x SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Deep copy — deepcopy","text":"x","code":""},{"path":"https://rspatial.github.io/terra/reference/deepcopy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Deep copy — deepcopy","text":"","code":"r <- rast(ncols=10, nrows=10, nl=3) tm <- as.Date(\"2001-05-03\") + 1:3 time(r) <- tm time(r) #> [1] \"2001-05-04\" \"2001-05-05\" \"2001-05-06\" x <- r time(x) <- tm + 365 time(x) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\" time(r) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\"  y <- deepcopy(r) time(y) <- tm - 365 time(y) #> [1] \"2000-05-04\" \"2000-05-05\" \"2000-05-06\" time(r) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\"  # or make a new object like this z <- rast(r) time(z) <- tm time(z) #> [1] \"2001-05-04\" \"2001-05-05\" \"2001-05-06\" time(r) #> [1] \"2002-05-04\" \"2002-05-05\" \"2002-05-06\""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":null,"dir":"Reference","previous_headings":"","what":"Add additional nodes to lines or polygons — densify","title":"Add additional nodes to lines or polygons — densify","text":"Add additional nodes lines polygons. can useful prior using project path change much.","code":""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add additional nodes to lines or polygons — densify","text":"","code":"# S4 method for SpatVector densify(x, interval, equalize=TRUE, flat=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add additional nodes to lines or polygons — densify","text":"x SpatVector interval positive number, specifying desired minimum distance nodes. unit meter lonlat data, linear unit crs planar data equalize logical. TRUE, new nodes spread equal intervals old nodes flat logical. TRUE, earth's curvature ignored lonlat data, distance unit degrees, meter","code":""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add additional nodes to lines or polygons — densify","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/densify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add additional nodes to lines or polygons — densify","text":"","code":"v <- vect(rbind(c(-120,-20), c(-80,5), c(-40,-60), c(-120,-20)),    type=\"polygons\", crs=\"+proj=longlat\") vd <- densify(v, 200000)  p <- project(v, \"+proj=robin\") pd <- project(vd, \"+proj=robin\")  # good  plot(pd, col=\"gray\", border=\"red\", lwd=10) points(pd, col=\"gray\")  # bad lines(p, col=\"blue\", lwd=3) points(p, col=\"blue\", cex=2) plot(p, col=\"blue\", alpha=.1, add=TRUE) legend(\"topright\", c(\"good\", \"bad\"), col=c(\"red\", \"blue\"), lty=1, lwd=3)   ## the other way around does not work ## unless the original data was truly planar (e.g. derived from a map) x <- densify(p, 250000) y <- project(x, \"+proj=longlat\") # bad plot(y) # good lines(vd, col=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/density.html","id":null,"dir":"Reference","previous_headings":"","what":"Density plot — density","title":"Density plot — density","text":"Create density plots cell values SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Density plot — density","text":"","code":"# S4 method for SpatRaster density(x, maxcells=100000, plot=TRUE, main, ...)"},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Density plot — density","text":"x SpatRaster maxcells maximum number (randomly sampled) cells used creating plot plot TRUE produce plot, else return density object main character. Caption plot(s) ... additional arguments passed plot","code":""},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Density plot — density","text":"density plot (density object, returned invisibly plot=TRUE)","code":""},{"path":"https://rspatial.github.io/terra/reference/density.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Density plot — density","text":"","code":"logo <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) density(logo)"},{"path":"https://rspatial.github.io/terra/reference/deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"deprecated methods — deprecated","title":"deprecated methods — deprecated","text":"methods deprecated removed future versions","code":""},{"path":"https://rspatial.github.io/terra/reference/deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"deprecated methods — deprecated","text":"","code":"# S4 method for SpatRaster setCats(x, ...)  # S4 method for SpatRaster area(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/deprecated.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"deprecated methods — deprecated","text":"x object ... additional arguments","code":""},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":null,"dir":"Reference","previous_headings":"","what":"depth of SpatRaster layers — depth","title":"depth of SpatRaster layers — depth","text":"Get set depth layers SpatRaster. Experimental.","code":""},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"depth of SpatRaster layers — depth","text":"","code":"# S4 method for SpatRaster depth(x)  # S4 method for SpatRaster depth(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"depth of SpatRaster layers — depth","text":"x SpatRaster value numeric vector","code":""},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"depth of SpatRaster layers — depth","text":"numeric","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/depth.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"depth of SpatRaster layers — depth","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     depth(s) <- 1:3 depth(s) #> [1] 1 2 3"},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":null,"dir":"Reference","previous_headings":"","what":"describe — describe","title":"describe — describe","text":"Describe properties spatial data file generated \"GDALinfo\" tool.","code":""},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"describe — describe","text":"","code":"# S4 method for character describe(x, sds=FALSE, meta=FALSE, parse=FALSE, options=\"\", print=FALSE, open_opt=\"\")"},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"describe — describe","text":"x character. name file spatial data. fully specified subdataset within file \"NETCDF:\\\"AVHRR.nc\\\":NDVI\" sds logical. TRUE description metadata subdatasets returned (available) meta logical. Get file level metadata instead parse logical. TRUE, metadata subdatasets parsed components (meta=TRUE) options character. vector valid options (meta=FALSE) including \"json\", \"mm\", \"stats\", \"hist\", \"nogcp\", \"nomd\", \"norat\", \"noct\", \"nofl\", \"checksum\", \"proj4\", \"listmdd\", \"mdd <value>\" <value> specifies domain '', \"wkt_format <value>\" value one 'WKT1', 'WKT2', 'WKT2_2015', 'WKT2_2018', \"sd <subdataset>\" <subdataset> name identifier sub-dataset. See https://gdal.org/programs/gdalinfo.html. Ignored sds=TRUE print logical. TRUE, print results open_opt character. Driver specific open options","code":""},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"describe — describe","text":"character (invisibly, print=FALSE)","code":""},{"path":"https://rspatial.github.io/terra/reference/describe.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"describe — describe","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") describe(f) #>  [1] \"Driver: GTiff/GeoTIFF\"                                                     #>  [2] \"Files: /Users/runner/work/_temp/Library/terra/ex/elev.tif\"                 #>  [3] \"Size is 95, 90\"                                                            #>  [4] \"Coordinate System is:\"                                                     #>  [5] \"GEOGCRS[\\\"WGS 84\\\",\"                                                       #>  [6] \"    ENSEMBLE[\\\"World Geodetic System 1984 ensemble\\\",\"                     #>  [7] \"        MEMBER[\\\"World Geodetic System 1984 (Transit)\\\"],\"                 #>  [8] \"        MEMBER[\\\"World Geodetic System 1984 (G730)\\\"],\"                    #>  [9] \"        MEMBER[\\\"World Geodetic System 1984 (G873)\\\"],\"                    #> [10] \"        MEMBER[\\\"World Geodetic System 1984 (G1150)\\\"],\"                   #> [11] \"        MEMBER[\\\"World Geodetic System 1984 (G1674)\\\"],\"                   #> [12] \"        MEMBER[\\\"World Geodetic System 1984 (G1762)\\\"],\"                   #> [13] \"        MEMBER[\\\"World Geodetic System 1984 (G2139)\\\"],\"                   #> [14] \"        ELLIPSOID[\\\"WGS 84\\\",6378137,298.257223563,\"                       #> [15] \"            LENGTHUNIT[\\\"metre\\\",1]],\"                                     #> [16] \"        ENSEMBLEACCURACY[2.0]],\"                                           #> [17] \"    PRIMEM[\\\"Greenwich\\\",0,\"                                               #> [18] \"        ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\"                        #> [19] \"    CS[ellipsoidal,2],\"                                                    #> [20] \"        AXIS[\\\"geodetic latitude (Lat)\\\",north,\"                           #> [21] \"            ORDER[1],\"                                                     #> [22] \"            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\"                    #> [23] \"        AXIS[\\\"geodetic longitude (Lon)\\\",east,\"                           #> [24] \"            ORDER[2],\"                                                     #> [25] \"            ANGLEUNIT[\\\"degree\\\",0.0174532925199433]],\"                    #> [26] \"    USAGE[\"                                                                #> [27] \"        SCOPE[\\\"Horizontal component of 3D system.\\\"],\"                    #> [28] \"        AREA[\\\"World.\\\"],\"                                                 #> [29] \"        BBOX[-90,-180,90,180]],\"                                           #> [30] \"    ID[\\\"EPSG\\\",4326]]\"                                                    #> [31] \"Data axis to CRS axis mapping: 2,1\"                                        #> [32] \"Origin = (5.741666666666666,50.191666666666663)\"                           #> [33] \"Pixel Size = (0.008333333333333,-0.008333333333333)\"                       #> [34] \"Metadata:\"                                                                 #> [35] \"  AREA_OR_POINT=Area\"                                                      #> [36] \"Image Structure Metadata:\"                                                 #> [37] \"  COMPRESSION=LZW\"                                                         #> [38] \"  INTERLEAVE=BAND\"                                                         #> [39] \"Corner Coordinates:\"                                                       #> [40] \"Upper Left  (   5.7416667,  50.1916667) (  5d44'30.00\\\"E, 50d11'30.00\\\"N)\" #> [41] \"Lower Left  (   5.7416667,  49.4416667) (  5d44'30.00\\\"E, 49d26'30.00\\\"N)\" #> [42] \"Upper Right (   6.5333333,  50.1916667) (  6d32' 0.00\\\"E, 50d11'30.00\\\"N)\" #> [43] \"Lower Right (   6.5333333,  49.4416667) (  6d32' 0.00\\\"E, 49d26'30.00\\\"N)\" #> [44] \"Center      (   6.1375000,  49.8166667) (  6d 8'15.00\\\"E, 49d49' 0.00\\\"N)\" #> [45] \"Band 1 Block=95x43 Type=Int16, ColorInterp=Gray\"                           #> [46] \"  Description = elevation\"                                                 #> [47] \"  Min=141.000 Max=547.000 \"                                                #> [48] \"  Minimum=141.000, Maximum=547.000, Mean=-9999.000, StdDev=-9999.000\"      #> [49] \"  NoData Value=-32768\"                                                     #> [50] \"  Metadata:\"                                                               #> [51] \"    STATISTICS_MAXIMUM=547\"                                                #> [52] \"    STATISTICS_MEAN=-9999\"                                                 #> [53] \"    STATISTICS_MINIMUM=141\"                                                #> [54] \"    STATISTICS_STDDEV=-9999\"                                               describe(f, meta=TRUE) #> [1] \"AREA_OR_POINT=Area\" #g <- describe(f, options=c(\"json\", \"nomd\", \"proj4\")) #head(g)"},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":null,"dir":"Reference","previous_headings":"","what":"Lagged differences — diff","title":"Lagged differences — diff","text":"Compute difference consecutive layers SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Lagged differences — diff","text":"","code":"# S4 method for SpatRaster diff(x, lag=1, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Lagged differences — diff","text":"x SpatRaster lag positive integer indicating lag use filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Lagged differences — diff","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/diff.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Lagged differences — diff","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    d <- diff(s)"},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":null,"dir":"Reference","previous_headings":"","what":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"Get number rows (nrow), columns (ncol), cells (ncell), layers (nlyr), sources (nsrc), size size (nlyr(x)*ncell(x)), spatial resolution SpatRaster. length returns number sub-datasets SpatRasterDataset SpatVectorCollection. SpatVector length(x) nrow(x). can also set number rows columns layers. setting dimensions, cell values dropped.","code":""},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"","code":"# S4 method for SpatRaster ncol(x)  # S4 method for SpatRaster nrow(x)  # S4 method for SpatRaster nlyr(x)  # S4 method for SpatRaster ncell(x)  # S4 method for SpatRaster nsrc(x)  # S4 method for SpatRaster,numeric ncol(x)<-value  # S4 method for SpatRaster,numeric nrow(x)<-value  # S4 method for SpatRaster,numeric nlyr(x)<-value  # S4 method for SpatRaster res(x)  # S4 method for SpatRaster,numeric res(x)<-value  # S4 method for SpatRaster xres(x)  # S4 method for SpatRaster yres(x)  # S4 method for SpatVector ncol(x)  # S4 method for SpatVector nrow(x)  # S4 method for SpatVector length(x)"},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"x SpatRaster SpatVector related objects value ncol nrow: positive integer. res: one two positive numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"integer","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/dimensions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Dimensions of a SpatRaster or SpatVector and related objects — dimensions","text":"","code":"r <- rast() ncol(r) #> [1] 360 nrow(r) #> [1] 180 nlyr(r) #> [1] 1 dim(r) #> [1] 180 360   1 nsrc(r) #> [1] 1 ncell(r) #> [1] 64800  rr  <- c(r,r) nlyr(rr) #> [1] 2 nsrc(rr) #> [1] 2 ncell(rr) #> [1] 64800  nrow(r) <- 18 ncol(r) <- 36 # equivalent to dim(r) <- c(18, 36)   dim(r) #> [1] 18 36  1 dim(r) <- c(10, 10, 5) dim(r) #> [1] 10 10  5  xres(r) #> [1] 36 yres(r) #> [1] 18 res(r) #> [1] 36 18  res(r) <- 1/120 # different xres and yres res(r) <- c(1/120, 1/60)"},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":null,"dir":"Reference","previous_headings":"","what":"Direction — direction","title":"Direction — direction","text":"direction (azimuth) nearest cell NA. direction expressed radians, unless use argument degrees=TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Direction — direction","text":"","code":"# S4 method for SpatRaster direction(x, from=FALSE, degrees=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Direction — direction","text":"x SpatRaster filename Character. Output filename (optional) degrees Logical. FALSE (default) unit direction radians. Logical. Default FALSE. TRUE, direction (instead )  nearest cell NA returned ... Additional arguments writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Direction — direction","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/direction.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Direction — direction","text":"","code":"r <- rast(ncol=36,nrow=18, crs=\"+proj=merc\") values(r) <- NA r[306] <- 1 b <- direction(r, degrees=TRUE)  plot(b)   crs(r) <- \"+proj=longlat\" b <- direction(r)  plot(b)"},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":null,"dir":"Reference","previous_headings":"","what":"Disaggregate raster cells or vector geometries — disagg","title":"Disaggregate raster cells or vector geometries — disagg","text":"SpatRaster: Create SpatRaster higher resolution (smaller cells). values new SpatRaster larger original cells. SpatVector: Separate multi-objects (points, lines, polygons) single objects; segments (lines polygons).","code":""},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Disaggregate raster cells or vector geometries — disagg","text":"","code":"# S4 method for SpatRaster disagg(x, fact, method=\"near\", filename=\"\", ...)  # S4 method for SpatVector disagg(x, segments=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Disaggregate raster cells or vector geometries — disagg","text":"x SpatRaster SpatVector fact positive integer. Aggregation factor expressed number cells direction (horizontally vertically). two integers (horizontal vertical aggregation factor) three integers (also aggregating layers) method character. Either \"near\" nearest \"bilinear\" bilinear interpolation segments logical. (poly-)lines polygons disaggregated line-segments? filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Disaggregate raster cells or vector geometries — disagg","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/disaggregate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Disaggregate raster cells or vector geometries — disagg","text":"","code":"r <- rast(ncols=10, nrows=10) rd <- disagg(r, fact=c(10, 2)) ncol(rd) #> [1] 20 nrow(rd) #> [1] 100 values(r) <- 1:ncell(r) rd <- disagg(r, fact=c(4, 2))"},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":null,"dir":"Reference","previous_headings":"","what":"Geographic distance — distance","title":"Geographic distance — distance","text":"x SpatRaster: y missing method computes distance, cells NA SpatRaster x nearest cell NA (values, see arguments \"target\" \"exclude\"). y numeric value, cells value ignored. , distance cells computed (grid=FALSE). y SpatVector, distance SpatVector computed cells. lines polygons done rasterization; overlapping areas vector raster considered (now). distance always expressed meter coordinate reference system longitude/latitude, map units otherwise. Map units typically meter, inspect crs(x) doubt. Results precise, sometimes much precise, using longitude/latitude rather planar coordinate reference system, distort distance. x SpatVector: y missing, distance matrix objects x computed. distance matrix object class \"dist\" returned. y SpatVector geographic distance objects computed (matrix returned). sets number points, pairwise=TRUE, distance pair objects computed, vector returned. distance always expressed meter, except coordinate reference system longitude/latitude one SpatVector(s) consists lines polygons. case distance degrees, thus useful (fixed soon). Otherwise, results precise, sometimes much precise, using longitude/latitude rather planar coordinate reference system, distort distance. x matrix: x consist two columns, first \"x\" (longitude) second \"y\" coordinates (latitude). y also matrix, distance points x points y computed, unless pairwise=TRUE y missing, distance points x points x computed, unless sequential=TRUE","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Geographic distance — distance","text":"","code":"# S4 method for SpatRaster,missing distance(x, y, target=NA, exclude=NULL, unit=\"m\", haversine=TRUE, filename=\"\", ...)  # S4 method for SpatRaster,SpatVector distance(x, y, unit=\"m\", rasterize=FALSE, haversine=TRUE, filename=\"\", ...)  # S4 method for SpatVector,ANY distance(x, y, sequential=FALSE, pairs=FALSE, symmetrical=TRUE, unit=\"m\")  # S4 method for SpatVector,SpatVector distance(x, y, pairwise=FALSE, unit=\"m\")  # S4 method for matrix,matrix distance(x, y, lonlat, pairwise=FALSE, unit=\"m\")  # S4 method for matrix,missing distance(x, y, lonlat, sequential=FALSE, pairs=FALSE, symmetrical=TRUE, unit=\"m\")"},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Geographic distance — distance","text":"x SpatRaster, SpatVector, two-column matrix coordinates (x,y) (lon,lat) y missing, numeric, SpatVector, two-column matrix target numeric. value cells distances cells NA computed exclude numeric. value cells considered computing distances unit character. Can either \"m\" \"km\" haversine logical. Use haversine formula lon/lat data use haversine formula? FALSE, precise slower method Karney (2003) used rasterize logical. TRUE distance computed cells covered geometries rasterization. can much faster cases filename character. Output filename ... additional arguments writing files writeRaster sequential logical. TRUE, distance sequential geometries returned pairwise logical. TRUE x y size (number rows), pairwise distances returned instead distances elements lonlat logical. TRUE coordinates interpreted angular (longitude/latitude). FALSE interpreted planar pairs logical. TRUE \"\", \"\", \"distance\" matrix returned symmetrical logical. TRUE pairs=TRUE, distance pair included . distance geometry 1 3 included, () distance 3 1 ","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Geographic distance — distance","text":"SpatRaster numeric matrix distance matrix (object class \"dist\")","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Geographic distance — distance","text":"distance matrix can coerced regular matrix .matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Geographic distance — distance","text":"Karney, C.F.F., 2013. Algorithms geodesics, J. Geodesy 87: 43-55. doi:10.1007/s00190-012-0578-z.","code":""},{"path":"https://rspatial.github.io/terra/reference/distance.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Geographic distance — distance","text":"","code":"#lonlat r <- rast(ncols=36, nrows=18, crs=\"+proj=longlat +datum=WGS84\") r[500] <- 1 d <- distance(r)  #>  |---------|---------|---------|---------| =========================================                                            plot(d / 100000)   #planar rr <- rast(ncols=36, nrows=18, crs=\"+proj=utm +zone=1 +datum=WGS84\") rr[500] <- 1 d <- distance(rr)   rr[3:10, 3:10] <- 99 e <- distance(rr, exclude=99)   p1 <- vect(rbind(c(0,0), c(90,30), c(-90,-30)), crs=\"+proj=longlat +datum=WGS84\") dp <- distance(r, p1)  #>  |---------|---------|---------|---------| =========================================                                             d <- distance(p1) d #>          1        2 #> 2 10014577          #> 3 10014577 20003931 as.matrix(d) #>          1        2        3 #> 1        0 10014577 10014577 #> 2 10014577        0 20003931 #> 3 10014577 20003931        0  p2 <- vect(rbind(c(30,-30), c(25,40), c(-9,-3)), crs=\"+proj=longlat +datum=WGS84\") dd <- distance(p1, p2) dd #>          [,1]     [,2]     [,3] #> [1,]  4596223  5104507  1054933 #> [2,]  9192445  5905838 11048088 #> [3,] 10825924 14117180  8981037 pd <- distance(p1, p2, pairwise=TRUE) pd #> [1] 4596223 5905838 8981037 pd == diag(dd) #> [1] TRUE TRUE TRUE   # polygons, lines crs <- \"+proj=utm +zone=1\" p1 <- vect(\"POLYGON ((0 0, 8 0, 8 9, 0 9, 0 0))\", crs=crs) p2 <- vect(\"POLYGON ((5 6, 15 6, 15 15, 5 15, 5 6))\", crs=crs) p3 <- vect(\"POLYGON ((2 12, 3 12, 3 13, 2 13, 2 12))\", crs=crs) p <- rbind(p1, p2, p3) L1 <- vect(\"LINESTRING(1 11, 4 6, 10 6)\", crs=crs) L2 <- vect(\"LINESTRING(8 14, 12 10)\", crs=crs) L3 <- vect(\"LINESTRING(1 8, 12 14)\", crs=crs) lns <- rbind(L1, L2, L3) pts <- vect(cbind(c(7,10,10), c(3,5,6)), crs=crs)  distance(p1,p3) #>      [,1] #> [1,]    3 distance(p) #>   1 2 #> 2 0   #> 3 3 2 distance(p,pts) #>          [,1]     [,2]     [,3] #> [1,] 0.000000 2.000000 2.000000 #> [2,] 3.000000 1.000000 0.000000 #> [3,] 9.848858 9.899495 9.219544 distance(p,lns) #>          [,1]     [,2]     [,3] #> [1,] 0.000000 3.535534 0.000000 #> [2,] 0.000000 0.000000 0.000000 #> [3,] 1.414214 5.099020 2.553878 distance(pts,lns) #>      [,1]     [,2]     [,3] #> [1,]    3 8.602325 7.262591 #> [2,]    1 5.385165 6.943356 #> [3,]    0 4.472136 6.065460"},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":null,"dir":"Reference","previous_headings":"","what":"Make a dot-density map — dots","title":"Make a dot-density map — dots","text":"Create dots dot-density map add current map. Dot-density maps made display count data. example population counts, dot represents n persons. dots returned SpatVector. active graphics device, dots added points.","code":""},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make a dot-density map — dots","text":"","code":"# S4 method for SpatVector dots(x, field, size,  ...)"},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make a dot-density map — dots","text":"x SpatVector field character numeric indicating field name. numeric vector length x size positive number indicating number cases associated dot ... graphical arguments passed points","code":""},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make a dot-density map — dots","text":"SpatVector (invisibly)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/dots.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make a dot-density map — dots","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$population <- 1000*(1:12)^2 plot(v, lwd=3, col=\"light gray\", border=\"white\") d <- dots(v, \"population\", 1000, col=\"red\", cex=.75) lines(v)  d #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 650, 7  (geometries, attributes) #>  extent      : 5.774251, 6.515615, 49.45477, 50.03893  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP population #>  type        : <num>    <chr> <num>    <chr> <num> <int>      <num> #>  values      :     1 Diekirch     1 Clervaux   312 18081       1000 #>                    1 Diekirch     2 Diekirch   218 32543       4000 #>                    1 Diekirch     2 Diekirch   218 32543       4000"},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":null,"dir":"Reference","previous_headings":"","what":"Draw a polygon, line, extent, or points — draw","title":"Draw a polygon, line, extent, or points — draw","text":"Draw plot (map) get SpatVector SpatExtent object later use. calling function, start clicking map. done, press ESC. can also preset maximum number clicks. work well default RStudio plotting device. work around , can first run dev.new(noRStudioGD = TRUE) create separate window plotting, use plot() followed click() click map.","code":""},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Draw a polygon, line, extent, or points — draw","text":"","code":"# S4 method for character draw(x=\"extent\", col=\"red\", lwd=2, id=FALSE, n=1000, xpd=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Draw a polygon, line, extent, or points — draw","text":"x character. type object draw. One \"extent\", \"polygon\", \"line\", \"points\" col color used lwd width lines drawn id logical. TRUE, numeric ID shown map n maximum number clicks (apply x==\"extent\" case n always 2) xpd logical. TRUE, can draw outside current plotting area ... additional graphics arguments drawing","code":""},{"path":"https://rspatial.github.io/terra/reference/draw.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Draw a polygon, line, extent, or points — draw","text":"SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":null,"dir":"Reference","previous_headings":"","what":"elongate lines — elongate","title":"elongate lines — elongate","text":"Elongate SpatVector lines","code":""},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"elongate lines — elongate","text":"","code":"# S4 method for SpatVector elongate(x, length=1, flat=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"elongate lines — elongate","text":"x SpatVector length positive number indicating much lines elongated end. unit meter crs lonlat linear unit crs cases (also meter cases) flat logical. TRUE, earth's curvature ignored lonlat data, distance unit degrees, meter","code":""},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"elongate lines — elongate","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/elongate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"elongate lines — elongate","text":"","code":"v <- vect(cbind(c(0,1,2), c(0,0,2)), \"lines\", crs=\"lonlat\") e <- elongate(v, 100000) plot(e) points(e)  geom(e) #>      geom part          x        y hole #> [1,]    1    1 -0.8983153 0.000000    0 #> [2,]    1    1  1.0000000 0.000000    0 #> [3,]    1    1  2.4044661 2.807681    0"},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":null,"dir":"Reference","previous_headings":"","what":"Erase parts of a SpatVector object — erase","title":"Erase parts of a SpatVector object — erase","text":"Erase parts SpatVector another SpatVector SpatExtent. can also erase (parts ) polygons polygons SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Erase parts of a SpatVector object — erase","text":"","code":"# S4 method for SpatVector,SpatVector erase(x, y)  # S4 method for SpatVector,missing erase(x, sequential=TRUE)  # S4 method for SpatVector,SpatExtent erase(x, y)"},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Erase parts of a SpatVector object — erase","text":"x SpatVector y SpatVector SpatExtent sequential logical. areas erased sequentially? See Details","code":""},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Erase parts of a SpatVector object — erase","text":"SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Erase parts of a SpatVector object — erase","text":"polygons erased sequentially, everything covered first polygon removed polygons, everything covered (remaining ) second polygon removed, etc. polygons erased sequentially, overlapping areas erased areas covered single geometry returned.","code":""},{"path":"https://rspatial.github.io/terra/reference/erase.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Erase parts of a SpatVector object — erase","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  # polygons with polygons or extent  e <- ext(5.6, 6, 49.55, 49.7) x <- erase(v, e)  p <- vect(\"POLYGON ((5.8 49.8, 6 49.9, 6.15 49.8, 6 49.6, 5.8 49.8))\") y <- erase(v, p)  # lines with polygons lns <- as.lines(rast(v, ncol=10, nrow=10))[12:22] eln <- erase(lns, v) plot(v) lines(lns, col='blue', lwd=4, lty=3) lines(eln, col='red', lwd=2)    ## self-erase h <- convHull(v[-12], \"NAME_1\") he <- erase(h) plot(h, lwd=2, border=\"red\", lty=2) lines(he, col=\"gray\", lwd=3)"},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"Compute area covered polygons raster cells NA. method computes areas longitude/latitude rasters, size cells constant degrees, square meters. can also important coordinate reference system planar, equal-area. vector data, best way compute area use longitude/latitude CRS. contrary (erroneous) popular belief suggest use planar coordinate reference system. done automatically, transform=TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"","code":"# S4 method for SpatRaster expanse(x, unit=\"m\", transform=TRUE, byValue=FALSE,       zones=NULL, wide=FALSE, usenames=FALSE)  # S4 method for SpatVector expanse(x, unit=\"m\", transform=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"x SpatRaster SpatVector unit character. Output unit area. One \"m\", \"km\", \"ha\" transform logical. TRUE, planar CRS transformed lon/lat accuracy byValue logical. TRUE, area unique cell value returned zones NULL SpatRaster geometry identifying zones x wide logical. results \"wide\" rather \"long\" format? usenames logical. TRUE layers identified names instead numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"SpatRaster: data.frame least two columns (\"layer\" \"area\") possibly also \"value\" (byValue TRUE), \"zone\" (zones TRUE). x values, total area cells returned. Otherwise, area cells NA returned. SpatVector: numeric (one value (multi-) polygon geometry.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/expanse.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the expanse (area) of individual polygons or for all (summed) raster cells — expanse","text":"","code":"### SpatRaster  r <- rast(nrows=18, ncols=36) v <- 1:ncell(r) v[200:400] <- NA values(r) <- v  # summed area in km2 expanse(r, unit=\"km\") #>   layer      area #> 1     1 273986501  # all cells  expanse(rast(r), unit=\"km\") #>   layer      area #> 1     1 510065622  r <- rast(ncols=90, nrows=45, ymin=-80, ymax=80) m <- project(r, \"+proj=merc\")  expanse(m, unit=\"km\") #>   layer      area #> 1     1 498751903 expanse(m, unit=\"km\", transform=FALSE) #>   layer       area #> 1     1 1241591858  m2 <- c(m, m) values(m2) <- cbind(c(1,2,NA,NA), c(11:14)) #> Warning: [setValues] values were recycled expanse(m2, unit=\"km\", byValue=TRUE, wide=TRUE) #>   layer        1        2       11       12       13       14 #> 1     1 10182145 10182145        0        0        0        0 #> 3     2        0        0 10182145 10182145 10182145 10182145   v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) r <- round((r-50)/100) levels(r) <- data.frame(id=1:5, name=c(\"forest\", \"water\", \"urban\", \"crops\", \"grass\")) expanse(r, byValue=TRUE) #>   layer  value       area #> 1     1 forest   50778375 #> 2     1  water  715780779 #> 3     1  urban 1118216460 #> 4     1  crops  617965652 #> 5     1  grass   60868836  g <- rasterize(v, r, \"NAME_1\") expanse(r, byValue=TRUE, zones=g, wide=TRUE) #>   layer         zone   forest     water     urban     crops    grass #> 1     1     Diekirch  1110530 146734320 332045014 584531527 58106847 #> 2     1 Grevenmacher 46327739 247619382 219364571   1670053        0 #> 5     1   Luxembourg        0 315854211 555664543  25106417        0   ### SpatVector v <- vect(system.file(\"ex/lux.shp\", package=\"terra\"))  a <- expanse(v) a #>  [1] 312283206 218674025 259454806  76200409 263174257 188282143 128991500 #>  [8] 210354494 185630770 251322021 237113004 233329960 sum(a) #> [1] 2564810595"},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":null,"dir":"Reference","previous_headings":"","what":"Create, get or set a SpatExtent — ext","title":"Create, get or set a SpatExtent — ext","text":"Get SpatExtent SpatRaster, SpatVector, spatial objects. create SpatExtent vector (length=4; order=xmin, xmax, ymin, ymax) can set extent SpatRaster, set extent SpatVector (see rescale ). See set.ext set extent place.","code":""},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create, get or set a SpatExtent — ext","text":"","code":"# S4 method for SpatRaster ext(x, cells=NULL)  # S4 method for SpatVector ext(x)  # S4 method for numeric ext(x, ..., xy=FALSE)  # S4 method for SpatRaster,SpatExtent ext(x)<-value  # S4 method for SpatRaster,numeric ext(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create, get or set a SpatExtent — ext","text":"x SpatRaster cells positive integer (cell) numbers subset extent area covered cells value SpatExtent, numeric vector length four (xmin, xmax, ymin, ymax) ... x single numeric value, additional numeric values xmax, ymin, ymax xy logical. Set TRUE indicate coordinates (xmin, ymin, xmax, ymax) order, instead terra standard order (xmin, xmax, ymin, ymax)","code":""},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create, get or set a SpatExtent — ext","text":"SpatExtent object.","code":""},{"path":"https://rspatial.github.io/terra/reference/ext.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create, get or set a SpatExtent — ext","text":"","code":"r <- rast() e <- ext(r) as.vector(e) #> xmin xmax ymin ymax  #> -180  180  -90   90  as.character(e) #> [1] \"ext(-180, 180, -90, 90)\"  ext(r) <- c(0, 2.5, 0, 1.5) r #> class       : SpatRaster  #> dimensions  : 180, 360, 1  (nrow, ncol, nlyr) #> resolution  : 0.006944444, 0.008333333  (x, y) #> extent      : 0, 2.5, 0, 1.5  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  er <- ext(r)  round(er) #> SpatExtent : 0, 3, 0, 2 (xmin, xmax, ymin, ymax) # go \"in\" floor(er) #> SpatExtent : 0, 3, 0, 2 (xmin, xmax, ymin, ymax) # go \"out\" ceiling(er) #> SpatExtent : 0, 2, 0, 1 (xmin, xmax, ymin, ymax)  ext(r) <- e"},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":null,"dir":"Reference","previous_headings":"","what":"Extend — extend","title":"Extend — extend","text":"Enlarge spatial extent SpatRaster. See crop (also) want remove rows columns. Note can enlarge SpatRasters entire rows columns. Therefore, extent output SpatRaster may exactly requested. Depending argument snap may bit smaller larger. can also enlarge SpatExtent method, algebraic notation (see examples)","code":""},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extend — extend","text":"","code":"# S4 method for SpatRaster extend(x, y, snap=\"near\", fill=NA, filename=\"\", overwrite=FALSE, ...)   # S4 method for SpatExtent extend(x, y)"},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extend — extend","text":"x SpatRaster SpatExtent y x SpatRaster, y SpatExtent, object can extracted (SpatRaster SpatVector objects). Alternatively, can provide one, two four non-negative integers indicating number rows columns need added side (single positive integer number rows columns added equal; 2 number (columns, rows), four (left column, right column, bottom row, top row).   x SpatExtent, y likewise numeric vector 1, 2, 4 elements snap character. One \"near\", \"\", \"\". Used align y geometry x fill numeric. value used new raster cells filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extend — extend","text":"SpatRaster SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extend.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extend — extend","text":"","code":"r <- rast(xmin=-150, xmax=-120, ymin=30, ymax=60, ncols=36, nrows=18) values(r) <- 1:ncell(r) e <- ext(-180, -100, 40, 70) re <- extend(r, e)  # extend with a number of rows and columns (at each side) re2 <- extend(r, c(2,10))  # SpatExtent e <- ext(r) e #> SpatExtent : -150, -120, 30, 60 (xmin, xmax, ymin, ymax) extend(e, 10) #> SpatExtent : -160, -110, 20, 70 (xmin, xmax, ymin, ymax) extend(e, c(10, -10, 0, 20)) #> SpatExtent : -160, -110, 30, 80 (xmin, xmax, ymin, ymax)   # add 10 columns / rows on all sides e + 10 #> SpatExtent : -160, -110, 20, 70 (xmin, xmax, ymin, ymax) # double extent e * 2 #> SpatExtent : -165, -105, 15, 75 (xmin, xmax, ymin, ymax) # increase extent by 25% e * 1.25 #> SpatExtent : -153.75, -116.25, 26.25, 63.75 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract values from a SpatRaster — extract","title":"Extract values from a SpatRaster — extract","text":"Extract values SpatRaster set locations. locations can SpatVector (points, lines, polygons), data.frame matrix (x, y) (longitude, latitude -- order!) coordinates, vector cell numbers. argument y SpatVector first column ID (record number) SpatVector used (unless set ID=FALSE). Alternatively, can use zonal using rasterize SpatVector (may efficient cases).","code":""},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract values from a SpatRaster — extract","text":"","code":"# S4 method for SpatRaster,SpatVector extract(x, y, fun=NULL, method=\"simple\", cells=FALSE, xy=FALSE,     ID=TRUE, weights=FALSE, exact=FALSE, touches=is.lines(y), small=TRUE,   layer=NULL, bind=FALSE, raw=FALSE, ...)  # S4 method for SpatRaster,SpatExtent extract(x, y, cells=FALSE, xy=FALSE)  # S4 method for SpatRaster,matrix extract(x, y, cells=FALSE, method=\"simple\")  # S4 method for SpatRaster,numeric extract(x, y, xy=FALSE, raw=FALSE)  # S4 method for SpatVector,SpatVector extract(x, y)"},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract values from a SpatRaster — extract","text":"x SpatRaster SpatVector polygons y SpatVector (points, lines, polygons). Alternatively, points, 2-column matrix data.frame (x, y) (lon, lat). vector cell numbers fun function summarize extracted data line polygon geometry. can use fun=table tabulate raster values line polygon geometry. weights=TRUE exact=TRUE mean, sum, min, max table accepted). Ignored y point geometry method character. method extracting values points (\"simple\" \"bilinear\"). \"simple\" values cell point falls returned. \"bilinear\" returned values interpolated values four nearest raster cells cells logical. TRUE cell numbers also returned, unless fun NULL. Also see cells xy logical. TRUE coordinates cells also returned, unless fun NULL. See xyFromCell ID logical. ID column added? , first column returned IDs (record numbers) y weights logical. TRUE y polygons, approximate fraction cell covered returned well, example compute weighted mean exact logical. TRUE y polygons, exact fraction cell covered returned well, example compute weighted mean touches logical. TRUE, values cells touched lines polygons extracted, just line render path, whose center point within polygon. relevant points; always considered TRUE weights=TRUE exact=TRUE small logical. TRUE, values cells touched polygons extracted none cells center points within polygon; even touches=FALSE layer character numeric select layer extract geometry. layer character can name y vector layer names. numeric, must integer values 1 nlyr(x) bind logical. TRUE, SpatVector returned consisting input SpatVector y cbind-ed extracted values raw logical. TRUE, matrix returned \"raw\" numeric cell values. FALSE, data.frame returned cell values transformed factor, logical, integer values, appropriate ... additional arguments fun y SpatVector. example na.rm=TRUE. arguments passed SpatRaster,SpatVector method y matrix (method cells arguments)","code":""},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract values from a SpatRaster — extract","text":"data.frame, matrix SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extract.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract values from a SpatRaster — extract","text":"","code":"r <- rast(ncols=5, nrows=5, xmin=0, xmax=5, ymin=0, ymax=5) values(r) <- 1:25 xy <- rbind(c(0.5,0.5), c(2.5,2.5)) p <- vect(xy, crs=\"+proj=longlat +datum=WGS84\")  extract(r, xy) #>   lyr.1 #> 1    21 #> 2    13 extract(r, p) #>   ID lyr.1 #> 1  1    21 #> 2  2    13  r[1,] #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 #> 5     5 r[5] #>   lyr.1 #> 1     5 r[,5] #>   lyr.1 #> 1     5 #> 2    10 #> 3    15 #> 4    20 #> 5    25  r[c(0:2, 99:101)] #>   lyr.1 #> 1     1 #> 2     2 #> 3    NA #> 4    NA #> 5    NA  f <- system.file(\"ex/meuse.tif\", package=\"terra\") r <- rast(f)  xy <- cbind(179000, 330000) xy <- rbind(xy-100, xy, xy+1000) extract(r, xy) #>   meuse #> 1   378 #> 2   251 #> 3   208  p <- vect(xy) g <- geom(p) g #>      geom part      x      y hole #> [1,]    1    1 178900 329900    0 #> [2,]    2    1 179000 330000    0 #> [3,]    3    1 180000 331000    0  extract(r, p) #>   ID meuse #> 1  1   378 #> 2  2   251 #> 3  3   208  x <- r + 10 extract(x, p) #>   ID meuse #> 1  1   388 #> 2  2   261 #> 3  3   218  i <- cellFromXY(r, xy) x[i] #>   meuse #> 1   388 #> 2   261 #> 3   218 r[i] #>   meuse #> 1   378 #> 2   251 #> 3   208  y <- c(x,x*2,x*3) y[i] #>   meuse meuse meuse #> 1   388   776  1164 #> 2   261   522   783 #> 3   218   436   654  ## extract with a polygon f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v <- v[1:2,]  rf <- system.file(\"ex/elev.tif\", package=\"terra\") x <- rast(rf) extract(x, v, mean, na.rm=TRUE) #>   ID elevation #> 1  1  467.1052 #> 2  2  333.8629  z <- rast(v, resolution=.1, names=\"test\") values(z) <- 1:ncell(z) e <- extract(z, v, ID=TRUE) e #>   ID test #> 1  1    2 #> 2  1    3 #> 3  1    6 #> 4  1    7 #> 5  1    8 #> 6  2   13 #> 7  2   17 #> 8  2   18 #> 9  2   19 tapply(e[,2], e[,1], mean, na.rm=TRUE) #>     1     2  #>  5.20 16.75   x <- c(z, z*2, z/3) names(x) <- letters[1:3]  e <- extract(x, v, ID=TRUE) de <- data.frame(e) aggregate(de[,2:4], de[,1,drop=FALSE], mean) #>   ID     a    b        c #> 1  1  5.20 10.4 1.733333 #> 2  2 16.75 33.5 5.583333"},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":null,"dir":"Reference","previous_headings":"","what":"extract values along lines — extractAlong","title":"extract values along lines — extractAlong","text":"Extract raster values along line. , returned values ordered along line. case extract","code":""},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"extract values along lines — extractAlong","text":"","code":"extractAlong(x, y, ID=TRUE, cells=FALSE, xy=FALSE, online=FALSE, bilinear=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"extract values along lines — extractAlong","text":"x SpatRaster y SpatVector lines geometry ID logical. ID column added? , first column returned IDs (record numbers) input SpatVector y cells logical. TRUE cell numbers also returned xy logical. TRUE coordinates cells traversed y also returned. See xyFromCell online logical. TRUE returned coordinates snapped y bilinear logical. TRUE returned raster values computed bilinear interpolation nearest four cells. relevant online=TRUE","code":""},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"extract values along lines — extractAlong","text":"data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extractAlong.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"extract values along lines — extractAlong","text":"","code":"r <- rast(ncols=36, nrows=18, vals=1:(18*36)) cds1 <- rbind(c(-50,0), c(0,60), c(40,5), c(15,-45), c(-10,-25)) cds2 <- rbind(c(80,20), c(140,60), c(160,0), c(140,-55)) lines <- vect(list(cds1, cds2), \"lines\")  extractAlong(r, lines) #>    ID lyr.1 #> 1   1   337 #> 2   1   302 #> 3   1   266 #> 4   1   267 #> 5   1   231 #> 6   1   232 #> 7   1   196 #> 8   1   197 #> 9   1   161 #> 10  1   162 #> 11  1   126 #> 12  1    91 #> 13  1   127 #> 14  1   163 #> 15  1   164 #> 16  1   200 #> 17  1   201 #> 18  1   237 #> 19  1   273 #> 20  1   274 #> 21  1   310 #> 22  1   310 #> 23  1   346 #> 24  1   382 #> 25  1   381 #> 26  1   417 #> 27  1   453 #> 28  1   452 #> 29  1   488 #> 30  1   488 #> 31  1   487 #> 32  1   451 #> 33  1   450 #> 34  1   414 #> 35  2   279 #> 36  2   243 #> 37  2   244 #> 38  2   208 #> 39  2   209 #> 40  2   210 #> 41  2   174 #> 42  2   175 #> 43  2   139 #> 44  2   140 #> 45  2   105 #> 46  2   141 #> 47  2   177 #> 48  2   213 #> 49  2   214 #> 50  2   250 #> 51  2   286 #> 52  2   322 #> 53  2   323 #> 54  2   358 #> 55  2   394 #> 56  2   430 #> 57  2   429 #> 58  2   465 #> 59  2   501 #> 60  2   537"},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract values for a range of layers from a SpatRaster — extractRange","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"Extract values SpatRaster set locations range layers. extract values single layers, use extract","code":""},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"","code":"# S4 method for SpatRaster extractRange(x, y, first, last, lyr_fun=NULL,      geom_fun=NULL, ID=FALSE, na.rm=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"x SpatRaster y SpatVector (points, lines, polygons). Alternatively, points, 2-column matrix data.frame (x, y) (lon, lat). vector cell numbers first layer name number, indicating first layer range layers considered last layer name number, indicating last layer range considered lyr_fun function summarize extracted data across layers geom_fun function summarize extracted data line polygon geometry. Ignored y point geometry ID logical. ID column added? , first column returned IDs (record numbers) y na.rm logical. missing values ignored? ... additional arguments passed extract","code":""},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"numeric data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/extractRange.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract values for a range of layers from a SpatRaster — extractRange","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    xy <- data.frame(c(50,80), c(30, 60)) extract(r, xy) #>   ID red green blue #> 1  1 149   158  215 #> 2  2  68    67   63 extract(r, xy, layer=c(\"red\", \"green\")) #>   ID layer value #> 1  1   red   149 #> 2  2 green    67 extractRange(r, xy, first=1:2, last=3:2, lyr_fun=sum) #> [1] 522  67"},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":null,"dir":"Reference","previous_headings":"","what":"Categorical rasters — factors","title":"Categorical rasters — factors","text":"SpatRaster layer can represent categorical variable (factor). Like factors, SpatRaster categories stored integers associated label. categories can inspected levels cats. represented data.frame must two columns, first one identifying (integer) cell values column(s) providing category labels. multiple columns categories, can set \"active\" category choose one want use. cats returns entire data.frame, whereas levels return two columns: index active category. set categories first layer SpatRaster, can provide levels<- data.frame list data.frame. set categories multiple layers can provide levels<- list one element (either data.frame NULL) layer. Use categories set categories specific layer specific layers. droplevels removes categories used (declared present values raster) levels=NULL. addCats adds additional categories layer already categorical. adds new variables, new levels existing categorical variable.","code":""},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Categorical rasters — factors","text":"","code":"# S4 method for SpatRaster levels(x)  # S4 method for SpatRaster levels(x)<-value  # S4 method for SpatRaster cats(x, layer)  # S4 method for SpatRaster categories(x, layer=1, value, active=1, ...)  # S4 method for SpatRaster droplevels(x, level=NULL, layer=1)  # S4 method for SpatRaster addCats(x, value, merge=FALSE, layer=1)"},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Categorical rasters — factors","text":"x SpatRaster layer layer name number (positive integer); 0 layers value data.frame (ID, category) define categories. NULL remove active positive integer, indicating column value used active category (zero based skip first column cell values; 1 second column value) level categories remove layer specified layer merge logical. TRUE, categories combined merge using first column value ID. FALSE categories combined cbind ... additional arguments (none)","code":""},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Categorical rasters — factors","text":"list data.frames (levels, cats) logical (.factor)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/factors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Categorical rasters — factors","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10) values(r) <- sample(3, ncell(r), replace=TRUE) is.factor(r) #> [1] FALSE  cls <- data.frame(id=1:3, cover=c(\"forest\", \"water\", \"urban\")) levels(r) <- cls is.factor(r) #> [1] TRUE r #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : cover  #> name        :  cover  #> min value   : forest  #> max value   :  urban   plot(r, col=c(\"green\", \"blue\", \"light gray\")) text(r, digits=3, cex=.75, halo=TRUE)   # raster starts at 3 x <- r + 2 is.factor(x) #> [1] FALSE  # Multiple categories d <- data.frame(id=3:5, cover=cls[,2], letters=letters[1:3], value=10:12) levels(x) <- d x #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : cover, letters, value  #> name        :  cover  #> min value   : forest  #> max value   :  urban   # get current index activeCat(x) #> [1] 1 # set index  activeCat(x) <- 3 activeCat(x) #> [1] 3 activeCat(x) <- \"letters\" plot(x, col=c(\"green\", \"blue\", \"light gray\")) text(x, digits=3, cex=.75, halo=TRUE)   r <- as.numeric(x) r #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : cover  #> min value   :     1  #> max value   :     3   p <- as.polygons(x) plot(p, \"letters\", col=c(\"green\", \"blue\", \"light gray\"))"},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":null,"dir":"Reference","previous_headings":"","what":"Remove holes from polygons — fillHoles","title":"Remove holes from polygons — fillHoles","text":"Remove holes SpatVector polygons. inverse=TRUE holes returned (polygons).","code":""},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Remove holes from polygons — fillHoles","text":"","code":"# S4 method for SpatVector fillHoles(x, inverse=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Remove holes from polygons — fillHoles","text":"x SpatVector inverse logical. TRUE holes returned polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Remove holes from polygons — fillHoles","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/fill.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Remove holes from polygons — fillHoles","text":"","code":"x <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) hole <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13))  z <- rbind(cbind(object=1, part=1, x, hole=0),         cbind(object=1, part=1, hole, hole=1)) colnames(z)[3:4] <- c('x', 'y') p <- vect(z, \"polygons\", atts=data.frame(id=1)) p #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 1, 1  (geometries, attributes) #>  extent      : -10, 160, -55, 60  (xmin, xmax, ymin, ymax) #>  coord. ref. :   #>  names       :    id #>  type        : <num> #>  values      :     1  f <- fillHoles(p) g <- fillHoles(p, inverse=TRUE)  plot(p, lwd=16, border=\"gray\", col=\"light yellow\") polys(f, border=\"blue\", lwd=3, density=4, col=\"orange\") polys(g, col=\"white\", lwd=3)"},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":null,"dir":"Reference","previous_headings":"","what":"Fill time gaps in a SpatRaster — fillTime","title":"Fill time gaps in a SpatRaster — fillTime","text":"Add empty layers existing layers time step layer .  See approximate estimate values layer (missing values)","code":""},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fill time gaps in a SpatRaster — fillTime","text":"","code":"# S4 method for SpatRaster fillTime(x, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fill time gaps in a SpatRaster — fillTime","text":"x SpatRaster filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fill time gaps in a SpatRaster — fillTime","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/fillTime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Fill time gaps in a SpatRaster — fillTime","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s <- c(r, r) time(s) <- as.Date(\"2001-01-01\") + c(0:2, 5:7) time(s) #> [1] \"2001-01-01\" \"2001-01-02\" \"2001-01-03\" \"2001-01-06\" \"2001-01-07\" #> [6] \"2001-01-08\" ss <- fillTime(s) time(ss) #> [1] \"2001-01-01\" \"2001-01-02\" \"2001-01-03\" \"2001-01-04\" \"2001-01-05\" #> [6] \"2001-01-06\" \"2001-01-07\" \"2001-01-08\"  a <- approximate(ss)"},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":null,"dir":"Reference","previous_headings":"","what":"Flip or reverse a raster — flip","title":"Flip or reverse a raster — flip","text":"Flip values SpatRaster inverting order rows (vertical=TRUE) columns (vertical=FALSE). rev horizontal ** vertical flip.","code":""},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Flip or reverse a raster — flip","text":"","code":"# S4 method for SpatRaster flip(x, direction=\"vertical\", filename=\"\", ...)  # S4 method for SpatVector flip(x, direction=\"vertical\")  # S4 method for SpatRaster rev(x)"},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Flip or reverse a raster — flip","text":"x SpatRaster SpatVector direction character. (partially) match \"vertical\" flip rows, \"horizontal\" flip columns filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Flip or reverse a raster — flip","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/flip.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Flip or reverse a raster — flip","text":"","code":"r <- rast(nrow=18, ncol=36) m <- matrix(1:ncell(r), nrow=18) values(r) <- as.vector(t(m)) rx <- flip(r, direction=\"h\")  values(r) <- as.vector(m) ry <- flip(r, direction=\"v\")  v <- rev(r)"},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal values — focal","title":"Focal values — focal","text":"Calculate focal (\"moving window\") values cell.","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal values — focal","text":"","code":"# S4 method for SpatRaster focal(x, w=3, fun=\"sum\", ..., na.policy=\"all\", fillvalue=NA,      expand=FALSE, silent=TRUE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal values — focal","text":"x SpatRaster w window. window can defined one (square) two numbers (row, col); odd-sized weights matrix. See Details. fun function takes multiple numbers, returns numeric vector (one multiple numbers). example mean, modal, min max ... additional arguments passed fun na.rm na.policy character. Can used determine cells x focal values computed. Must one \"\" (compute cells), \"\" (cells NA) \"omit\" (skip cells NA). Note value argument affect cells around focal cell included computations (use na.rm=TRUE ignore cells NA ) fillvalue numeric. value cells virtual rows columns outside raster expand logical. TRUE value cells virtual rows columns outside raster set value border. available \"build-\" funs mean, sum, min max silent logical. TRUE error messages printed may occur trying fun determine length returned value. can useful debugging fun work filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Focal values — focal","text":"focal  window used must odd dimensions. need even sides, can use matrix add column row NA's mask values. Window values typically 1 NA indicate whether value used ignored computations, respectively. NA values w can useful creating non-rectangular (e.g. circular) windows. weights matrix numeric values can also supplied w. case weights matrix, cells NA weights ignored, rest values focal window multiplied corresponding weight prior `fun` applied. Note, na.rm need TRUE w contains NA values cells ignored computations. \"mean\" function special case, supplying weights w instead calculate weighted mean. \"sum\" function returns NA focal cells NA na.rm=TRUE. R normally return zero cases. See difference focal(x, fun=sum, na.rm=TRUE) focal(x, fun=\\() sum(, na.rm=TRUE)) Example weight matrices Laplacian filter: filter=matrix(c(0,1,0,1,-4,1,0,1,0), nrow=3) Sobel filters (edge detection): fx=matrix(c(-1,-2,-1,0,0,0,1,2,1), nrow=3) fy=matrix(c(1,0,-1,2,0,-2,1,0,-1), nrow=3)","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Focal values — focal","text":"using global lon/lat rasters, focal window \"wraps around\" date-line.","code":""},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal values — focal","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal values — focal","text":"","code":"r <- rast(ncols=10, nrows=10, ext(0, 10, 0, 10)) values(r) <- 1:ncell(r)  f <- focal(r, w=3, fun=function(x, ...) quantile(x, c(.25, .5, .75), ...), na.rm=TRUE)   f <- focal(r, w=3, fun=\"mean\")   # the following two statements are equivalent: a <- focal(r, w=matrix(1/9, nc=3, nr=3)) b <- focal(r, w=3, fun=mean, na.rm=FALSE)  # but this is different d <- focal(r, w=3, fun=mean, na.rm=TRUE)  ## illustrating the effect of different  ## combinations of na.rm and na.policy v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) r[45:50, 45:50] <- NA  # also try \"mean\" or \"min\" f <- \"sum\"  # na.rm=FALSE plot(focal(r, 5, f) , fun=lines(v))   # na.rm=TRUE plot(focal(r, 5, f, na.rm=TRUE), fun=lines(v))   # only change cells that are NA plot(focal(r, 5, f, na.policy=\"only\", na.rm=TRUE), fun=lines(v))   # do not change cells that are NA plot(focal(r, 5, f, na.policy=\"omit\", na.rm=TRUE), fun=lines(v))   # does not do anything # focal(r, 5, f, na.policy=\"only\", na.rm=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":null,"dir":"Reference","previous_headings":"","what":"Three-dimensional focal values — focal3D","title":"Three-dimensional focal values — focal3D","text":"Calculate focal (\"moving window\") values three-dimensional neighborhood (window) focal cells. See focal two-dimensional focal computation.","code":""},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Three-dimensional focal values — focal3D","text":"","code":"# S4 method for SpatRaster focal3D(x, w=3, fun=mean, ..., na.policy=\"all\", fillvalue=NA, pad=FALSE,    padvalue=fillvalue, expand=FALSE, silent=TRUE,    filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Three-dimensional focal values — focal3D","text":"x SpatRaster w window. rectangular prism (cuboid) defined three numbers three-dimensional array. values used weights, usually zero, one, NA, fractions. window used must odd dimensions. desire use even sides, can use array, pad values rows /columns contain NAs. fun function takes multiple numbers, returns one multiple numbers focal area. example mean, modal, min max ... additional arguments passed fun na.rm na.policy character. Can used determine cells x, central layer, focal values computed. Must one \"\" (compute cells), \"\" (cells NA) \"omit\" (skip cells NA). Note value argument affect cells around focal cell included computations (use na.rm=TRUE ignore cells NA computation focal value) fillvalue numeric. value cells virtual rows columns outside raster pad logical. Add virtual layers first last layer padvalue numeric. value cells virtual layers expand logical. Add virtual layers first last layer first last layers. TRUE, arguments pad padvalue ignored silent logical. TRUE error messages printed may occur trying fun determine length returned value. can useful debugging function passed fun work filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Three-dimensional focal values — focal3D","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focal3D.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Three-dimensional focal values — focal3D","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- focal3D(r, c(5,5,3), na.rm=TRUE)  a <- array(c(0,1,0,1,1,1,0,1,0, rep(1,9), 0,1,0,1,1,1,0,1,0), c(3,3,3)) a[a==0] <- NA z <- focal3D(r, a, na.rm=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute focal values with an iterating C++ function — focalCpp","title":"Compute focal values with an iterating C++ function — focalCpp","text":"Calculate focal values C++ function iterates cells speed computations avoiding R loop (apply). See focal easier use method.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute focal values with an iterating C++ function — focalCpp","text":"","code":"# S4 method for SpatRaster focalCpp(x, w=3, fun, ..., fillvalue=NA,      silent=TRUE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute focal values with an iterating C++ function — focalCpp","text":"x SpatRaster w window. window can defined one (square) two numbers (row, col); odd-sized weights matrix. See Details section focal fun cppFunction iterates cells. C++ functions operate single focal window, R functions use focal instead. function must least three arguments. first argument can name, must Rcpp::NumericVector, Rcpp::IntegerVector std::vector<double>. container receives focal values. two arguments ni wi must type size_t. ni represents number cells nw represents size (number elements ) window ... additional arguments fun fillvalue numeric. value cells virtual rows columns outside raster silent logical. TRUE error messages printed may occur trying fun determine length returned value. can useful debugging fun work filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute focal values with an iterating C++ function — focalCpp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focalCpp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute focal values with an iterating C++ function — focalCpp","text":"","code":"if (FALSE) { library(Rcpp) cppFunction(    'NumericVector sum_and_multiply(NumericVector x, double m, size_t ni, size_t nw) {     NumericVector out(ni);     // loop over cells     size_t start = 0;     for (size_t i=0; i<ni; i++) {       size_t end = start + nw;       // compute something for a window       double v = 0;       // loop over the values of a window       for (size_t j=start; j<end; j++) {         v += x[j];       }       out[i] = v * m;       start = end;     }     return out;   }' )  nr <- nc <- 10 r <- rast(ncols=nc, nrows=nr, ext= c(0, nc, 0, nr)) values(r) <- 1:ncell(r)  raw <- focalCpp(r, w=3, fun=sum_and_multiply, fillvalue=0, m=10)  # same as f1 <- focal(r, w=3, fun=sum, fillvalue=0) *10 all(values(f1) == values(raw))  # and as ffun <- function(x, m) { sum(x) * m } f2 <- focal(r, w=3, fun=ffun, fillvalue=0, m=10)   # You can also use an R function with focalCpp but this # is not recommended   R_sm_iter <- function(x, m, ni, nw) {   out <- NULL   for (i in 1:ni) {     start <- (i-1) * nw + 1     out[i] <- sum(x[start:(start+nw-1)]) * m   }   out }  fr <- focalCpp(r, w=3, fun=R_sm_iter, fillvalue=0, m=10)  }"},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal weights matrix — focalMat","title":"Focal weights matrix — focalMat","text":"Make focal (\"moving window\") weight matrix use focal function. sum values adds one.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal weights matrix — focalMat","text":"","code":"focalMat(x, d, type=c('circle', 'Gauss', 'rectangle'), fillNA=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal weights matrix — focalMat","text":"x SpatRaster d numeric. type=circle, radius circle (units crs). type=rectangle dimension rectangle (one two numbers). type=Gauss size sigma, optionally another number determine size matrix returned (default 3*sigma) type character indicating type filter returned fillNA logical. TRUE, zeros set NA ignored computations. applies type=\"circle\"","code":""},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal weights matrix — focalMat","text":"matrix can used focal","code":""},{"path":"https://rspatial.github.io/terra/reference/focalMat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal weights matrix — focalMat","text":"","code":"r <- rast(ncols=180, nrows=180, xmin=0) focalMat(r, 2, \"circle\") #>            [,1]       [,2]       [,3]       [,4]       [,5] #> [1,] 0.00000000 0.00000000 0.07692308 0.00000000 0.00000000 #> [2,] 0.00000000 0.07692308 0.07692308 0.07692308 0.00000000 #> [3,] 0.07692308 0.07692308 0.07692308 0.07692308 0.07692308 #> [4,] 0.00000000 0.07692308 0.07692308 0.07692308 0.00000000 #> [5,] 0.00000000 0.00000000 0.07692308 0.00000000 0.00000000  focalMat(r, c(2,3), \"rect\") #>            [,1]       [,2]       [,3]       [,4]       [,5] #> [1,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [2,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [3,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [4,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [5,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [6,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143 #> [7,] 0.02857143 0.02857143 0.02857143 0.02857143 0.02857143  # Gaussian filter for square cells gf <- focalMat(r, 1, \"Gauss\")"},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal function across two layers — focalPairs","title":"Focal function across two layers — focalPairs","text":"Calculate values correlation coefficient focal regions two neighboring layers. function applied first second layer, second third layer, etc.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal function across two layers — focalPairs","text":"","code":"# S4 method for SpatRaster focalPairs(x, w=3, fun, ..., fillvalue=NA,      filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal function across two layers — focalPairs","text":"x SpatRaster least two layers w numeric matrix define focal window. window defined one (square) two numbers (row, col); odd-sized weights matrix. See Details section focal. Note matrix numbers zero one used, values used weights. work, fun must argument weights fun function least two arguments (one layer). built-function \"pearson\" (weighted unweighted Pearson correlation coefficient. function additional argument na.rm=FALSE ... additional arguments fun fillvalue numeric. value cells virtual rows columns outside raster filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal function across two layers — focalPairs","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focalPairs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal function across two layers — focalPairs","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) set.seed(0) r[[1]] <- flip(r[[1]], \"horizontal\") r[[2]] <- flip(r[[2]], \"vertical\") + init(rast(r,1), runif) r[[3]] <- init(rast(r,1), runif)  x <- focalPairs(r, w=5, \"pearson\", na.rm=TRUE) plot(x)    # suppress warning \"the standard deviation is zero\" suppressWarnings(x <- focalPairs(r, w=5, \"pearson\", use=\"complete.obs\"))  z <- focalPairs(r, w=9, function(x, y) mean(x) + mean(y))"},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":null,"dir":"Reference","previous_headings":"","what":"Focal regression — focalReg","title":"Focal regression — focalReg","text":"Calculate values moving-window comparing value one layers values one many layers. typical case computation coefficients focal linear regression model.","code":""},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Focal regression — focalReg","text":"","code":"# S4 method for SpatRaster focalReg(x, w=3, fun=\"ols\", ..., fillvalue=NA, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Focal regression — focalReg","text":"x SpatRaster least two layers. first \"Y\" (dependent) variable remainder \"X\" (independent) variables w numeric matrix define focal window. window defined one (square) two numbers (row, col); odd-sized weights matrix. See Details section focal. Note matrix numbers zero one used, values used weights. work, fun must argument weights fun function least two arguments (one layer). built-function \"ols\" weighted unweighted Ordinary Least Square regression. function additional argument na.rm=FALSE intercept=TRUE ... additional arguments fun fillvalue numeric. value cells virtual rows columns outside raster filename character. Output filename overwrite logical. TRUE, filename overwritten wopt additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Focal regression — focalReg","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/focalReg.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Focal regression — focalReg","text":"","code":"r <- rast(ncols=10, nrows=10, ext(0, 10, 0, 10)) values(r) <- 1:ncell(r) x <- c(r, init(r, runif) * r) f <- focalReg(x, 3)"},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":null,"dir":"Reference","previous_headings":"","what":"Get focal values — focalValues","title":"Get focal values — focalValues","text":"Get matrix row focal values cell. values cell rectangular window around .","code":""},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get focal values — focalValues","text":"","code":"# S4 method for SpatRaster focalValues(x, w=3, row=1, nrows=nrow(x), fill=NA)"},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get focal values — focalValues","text":"x SpatRaster SpatVector w window. window can defined one (square) two odd numbers (row, col); odd sized matrix row positive integer. Row number start , 1 nrow(x) nrows positive integer. many rows? fill numeric used values imaginary cells outside raster","code":""},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get focal values — focalValues","text":"matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/focalValues.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get focal values — focalValues","text":"","code":"r <- rast(ncol=4, nrow=4, crs=\"+proj=utm +zone=1 +datum=WGS84\") values(r) <- 1:ncell(r) focalValues(r) #>       [,1] [,2] [,3] [,4] [,5] [,6] [,7] [,8] [,9] #>  [1,]   NA   NA   NA   NA    1    2   NA    5    6 #>  [2,]   NA   NA   NA    1    2    3    5    6    7 #>  [3,]   NA   NA   NA    2    3    4    6    7    8 #>  [4,]   NA   NA   NA    3    4   NA    7    8   NA #>  [5,]   NA    1    2   NA    5    6   NA    9   10 #>  [6,]    1    2    3    5    6    7    9   10   11 #>  [7,]    2    3    4    6    7    8   10   11   12 #>  [8,]    3    4   NA    7    8   NA   11   12   NA #>  [9,]   NA    5    6   NA    9   10   NA   13   14 #> [10,]    5    6    7    9   10   11   13   14   15 #> [11,]    6    7    8   10   11   12   14   15   16 #> [12,]    7    8   NA   11   12   NA   15   16   NA #> [13,]   NA    9   10   NA   13   14   NA   NA   NA #> [14,]    9   10   11   13   14   15   NA   NA   NA #> [15,]   10   11   12   14   15   16   NA   NA   NA #> [16,]   11   12   NA   15   16   NA   NA   NA   NA"},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":null,"dir":"Reference","previous_headings":"","what":"force counter-clockwise polygons — forceCCW","title":"force counter-clockwise polygons — forceCCW","text":"Assure nodes outer rings polygons counter-clockwise order.","code":""},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"force counter-clockwise polygons — forceCCW","text":"","code":"# S4 method for SpatVector forceCCW(x)"},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"force counter-clockwise polygons — forceCCW","text":"x SpatVector polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"force counter-clockwise polygons — forceCCW","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/forceCCW.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"force counter-clockwise polygons — forceCCW","text":"","code":"p <- vect(\"POLYGON ((2 45, 2 55, 18 55, 18 45, 2 45))\") pcc <- forceCCW(p) geom(pcc, wkt=TRUE) #> [1] \"POLYGON ((2 45, 18 45, 18 55, 2 55, 2 45))\""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":null,"dir":"Reference","previous_headings":"","what":"Frequency table — freq","title":"Frequency table — freq","text":"Frequency table values SpatRaster. NAs counted unless value=NA. can provide SpatVector additional SpatRaster define zones tabulations.","code":""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Frequency table — freq","text":"","code":"# S4 method for SpatRaster freq(x, digits=0, value=NULL, bylayer=TRUE, usenames=FALSE, zones=NULL, wide=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Frequency table — freq","text":"x SpatRaster digits integer. Used rounding values tabulation. Ignored NA value numeric. optional single value count number cells value. value can NA bylayer logical. TRUE tabulation done layer usenames logical. TRUE layers identified names instead numbers relevant bylayer TRUE zones SpatRaster SpatVector define zones tabulation done wide logical. results \"wide\" instead \"long\"?","code":""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Frequency table — freq","text":"data.frame 3 columns (layer, value, count) unless bylayer=FALSE case adata.frame two columns returned (value, count).","code":""},{"path":"https://rspatial.github.io/terra/reference/freq.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Frequency table — freq","text":"","code":"r <- rast(nrows=10, ncols=10) set.seed(2) values(r) <- sample(5, ncell(r), replace=TRUE)  freq(r) #>   layer value count #> 1     1     1    27 #> 2     1     2    15 #> 3     1     3    17 #> 4     1     4    17 #> 5     1     5    24  x <- c(r, r/3) freq(x, bylayer=FALSE) #>   value count #> 1     0    27 #> 2     1    76 #> 3     2    39 #> 4     3    17 #> 5     4    17 #> 6     5    24 freq(x) #>   layer value count #> 1     1     1    27 #> 2     1     2    15 #> 3     1     3    17 #> 4     1     4    17 #> 5     1     5    24 #> 6     2     0    27 #> 7     2     1    49 #> 8     2     2    24  freq(x, digits=1) #>    layer value count #> 1      1   1.0    27 #> 2      1   2.0    15 #> 3      1   3.0    17 #> 4      1   4.0    17 #> 5      1   5.0    24 #> 6      2   0.3    27 #> 7      2   0.7    15 #> 8      2   1.0    17 #> 9      2   1.3    17 #> 10     2   1.7    24 freq(x, digits=-1) #>   layer value count #> 1     1     0    76 #> 2     1    10    24 #> 3     2     0   100  freq(x, value=5) #>   layer value count #> 1     1     5    24 #> 2     2     5     0"},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":null,"dir":"Reference","previous_headings":"","what":"Find gaps between polygons — gaps","title":"Find gaps between polygons — gaps","text":"Get gaps polygons SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find gaps between polygons — gaps","text":"","code":"# S4 method for SpatVector gaps(x)"},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find gaps between polygons — gaps","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find gaps between polygons — gaps","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/gaps.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Find gaps between polygons — gaps","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) h <- convHull(v[-12], \"NAME_1\") g <- gaps(h)"},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":null,"dir":"Reference","previous_headings":"","what":"GDAL version, supported file formats, and cache size — gdal","title":"GDAL version, supported file formats, and cache size — gdal","text":"Set GDAL warning level get data.frame available GDAL drivers (file formats), , warn=NA drivers=FALSE, get version numbers one GDAL, PROJ GEOS libraries. GDAL software library terra builds read write spatial data raster data processing. PROJ used transformation coordinates (\"projection\") GEOS used geometric operations vector data.","code":""},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"GDAL version, supported file formats, and cache size — gdal","text":"","code":"gdal(warn=NA, drivers=FALSE, lib=\"gdal\") gdalCache(size=NA) setGDALconfig(option, value=\"\") getGDALconfig(option)"},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"GDAL version, supported file formats, and cache size — gdal","text":"warn NA drivers=FALSE, version library specified lib returned. Otherwise, value integer 1 4 representing level GDAL warnings errors passed R. 1 = warnings errors; 2 = errors (recoverable errors warning); 3 = irrecoverable errors ; 4 = ignore errors warnings. default setting 3 drivers logical. TRUE data.frame raster vector data formats available. lib character. \"gdal\", \"proj\", \"geos\", value get versions numbers three size numeric. new cache size MB option character. GDAL configuration option name, \"name=value\" string (case value argument ignored value character. value GDAL configuration option. Use \"\" reset default value","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"GDAL version, supported file formats, and cache size — gdal","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/gdal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"GDAL version, supported file formats, and cache size — gdal","text":"","code":"gdal() #> [1] \"3.9.0\" gdal(2) head(gdal(drivers=TRUE)) #>      name raster vector        can  vsi                     long.name #> 1 AAIGrid   TRUE  FALSE read/write TRUE           Arc/Info ASCII Grid #> 2    ACE2   TRUE  FALSE       read TRUE                          ACE2 #> 3    ADRG   TRUE  FALSE read/write TRUE ARC Digitized Raster Graphics #> 4     AIG   TRUE  FALSE       read TRUE          Arc/Info Binary Grid #> 5  AVCBin  FALSE   TRUE       read TRUE      Arc/Info Binary Coverage #> 6  AVCE00  FALSE   TRUE       read TRUE Arc/Info E00 (ASCII) Coverage"},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the geometry (coordinates) of a SpatVector — geom","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"Get geometry SpatVector. wkt=FALSE, five-column matrix data.frame: vector object ID, IDs parts object (e.g. five polygons together one spatial object), x (longitude) y (latitude) coordinates, flag indicating whether part \"hole\" (relevant polygons). wkt=TRUE, \"well-known text\" representation returned character vector.","code":""},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"","code":"# S4 method for SpatVector geom(x, wkt=FALSE, hex=FALSE, df=FALSE, list=FALSE, xnm=\"x\", ynm=\"y\")"},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"x SpatVector wkt logical. TRUE WKT geometry returned (unless hex also TRUE) hex logical. TRUE hexadecimal geometry returned df logical. TRUE data.frame returned instead matrix (wkt=FALSE, hex=FALSE, list=FALSE) list logical. TRUE nested list returned data.frames coordinates xnm character. list=TRUE \"x\" column name coordinates data.frame ynm character. list=TRUE \"y\" column name coordinates data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"matrix, vector, data.frame, list","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/geometry.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get the geometry (coordinates) of a SpatVector — geom","text":"","code":"x1 <- rbind(c(-175,-20), c(-140,55), c(10, 0), c(-140,-60)) x2 <- rbind(c(-125,0), c(0,60), c(40,5), c(15,-45)) x3 <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) x4 <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13)) z <- rbind(cbind(object=1, part=1, x1), cbind(object=2, part=1, x2),             cbind(object=3, part=1, x3), cbind(object=3, part=2,  x4)) colnames(z)[3:4] <- c('x', 'y') z <- cbind(z, hole=0) z[(z[, \"object\"]==3 & z[,\"part\"]==2), \"hole\"] <- 1  p <- vect(z, \"polygons\") geom(p) #>       geom part    x   y hole #>  [1,]    1    1 -175 -20    0 #>  [2,]    1    1 -140  55    0 #>  [3,]    1    1   10   0    0 #>  [4,]    1    1 -140 -60    0 #>  [5,]    1    1 -175 -20    0 #>  [6,]    2    1 -125   0    0 #>  [7,]    2    1    0  60    0 #>  [8,]    2    1   40   5    0 #>  [9,]    2    1   15 -45    0 #> [10,]    2    1 -125   0    0 #> [11,]    3    1  -10   0    0 #> [12,]    3    1  140  60    0 #> [13,]    3    1  160   0    0 #> [14,]    3    1  140 -55    0 #> [15,]    3    1  -10   0    0 #> [16,]    3    1   80   0    1 #> [17,]    3    1  105  13    1 #> [18,]    3    1  120   2    1 #> [19,]    3    1  105 -13    1 #> [20,]    3    1   80   0    1  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) g <- geom(v) head(g) #>      geom part        x        y hole #> [1,]    1    1 6.026519 50.17767    0 #> [2,]    1    1 6.031361 50.16563    0 #> [3,]    1    1 6.035646 50.16410    0 #> [4,]    1    1 6.042747 50.16157    0 #> [5,]    1    1 6.043894 50.16116    0 #> [6,]    1    1 6.048243 50.16008    0  w <- geom(v, wkt=TRUE) substr(w, 1, 60) #>  [1] \"POLYGON ((6.026519 50.17767, 6.031361 50.165627, 6.035646 50\" #>  [2] \"POLYGON ((6.178368 49.876823, 6.185479 49.870525, 6.189417 4\" #>  [3] \"POLYGON ((5.881378 49.870148, 5.881672 49.868866, 5.886637 4\" #>  [4] \"POLYGON ((6.131309 49.972565, 6.134291 49.972382, 6.139316 4\" #>  [5] \"POLYGON ((5.977929 50.026016, 5.982312 50.022949, 5.981743 5\" #>  [6] \"POLYGON ((6.385532 49.837029, 6.3886 49.833683, 6.390184 49.\" #>  [7] \"POLYGON ((6.316665 49.623375, 6.31835 49.623157, 6.320131 49\" #>  [8] \"POLYGON ((6.425158 49.731644, 6.42657 49.73082, 6.427332 49.\" #>  [9] \"POLYGON ((5.998312 49.699924, 5.998632 49.698559, 5.998956 4\" #> [10] \"POLYGON ((6.039474 49.448261, 6.036906 49.448696, 6.036822 4\" #> [11] \"POLYGON ((6.155963 49.685047, 6.159284 49.685036, 6.161457 4\" #> [12] \"POLYGON ((6.067982 49.828465, 6.071922 49.825478, 6.073236 4\""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":null,"dir":"Reference","previous_headings":"","what":"Geometry type of a SpatVector — geomtype","title":"Geometry type of a SpatVector — geomtype","text":"Get geometry type (points, lines, polygons) SpatVector. See datatype data types fields (attributes, variables) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Geometry type of a SpatVector — geomtype","text":"","code":"# S4 method for SpatVector geomtype(x)  # S4 method for SpatVector is.points(x)  # S4 method for SpatVector is.lines(x)  # S4 method for SpatVector is.polygons(x)"},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Geometry type of a SpatVector — geomtype","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Geometry type of a SpatVector — geomtype","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/geomtype.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Geometry type of a SpatVector — geomtype","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  geomtype(v) #> [1] \"polygons\" is.polygons(v) #> [1] TRUE is.lines(v) #> [1] FALSE is.points(v) #> [1] FALSE  names(v) #> [1] \"ID_1\"   \"NAME_1\" \"ID_2\"   \"NAME_2\" \"AREA\"   \"POP\"    datatype(v) #> [1] \"double\" \"string\" \"double\" \"string\" \"double\" \"long\""},{"path":"https://rspatial.github.io/terra/reference/global.html","id":null,"dir":"Reference","previous_headings":"","what":"global statistics — global","title":"global statistics — global","text":"Compute global statistics, summarized values entire SpatRaster. x large global can fail, except fun one built-functions \"mean\", \"min\", \"max\", \"sum\", \"prod\", \"range\" (min max), \"rms\" (root mean square), \"sd\" (sample standard deviation), \"std\" (population standard deviation), \"isNA\" (number cells NA), \"notNA\" (number cells NA). reason can fail large raster custom function values need loaded memory. circumvent problem can run global sample cells. can compute weighted mean sum providing SpatRaster weights.","code":""},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"global statistics — global","text":"","code":"# S4 method for SpatRaster global(x, fun=\"mean\", weights=NULL, maxcell=Inf, ...)"},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"global statistics — global","text":"x SpatRaster fun function applied summarize values zone. Either one built-character values: \"max\", \"min\", \"mean\", \"sum\", \"range\", \"rms\" (root mean square), \"sd\", \"std\" (population sd, using n rather n-1), \"isNA\", \"notNA\"; proper R function (may fail large SpatRasters unless specify maxcell) ... additional arguments passed fun weights NULL SpatRaster maxcell positive integer used take regular sample x. Ignored built-functions.","code":""},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"global statistics — global","text":"data.frame row layer","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/global.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"global statistics — global","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) global(r, \"sum\") #>        sum #> lyr.1 5050 global(r, \"mean\", na.rm=TRUE) #>       mean #> lyr.1 50.5 x <- c(r, r/10) global(x, c(\"sum\", \"mean\", \"sd\"), na.rm=TRUE) #>          sum  mean        sd #> lyr.1   5050 50.50 29.011492 #> lyr.1.1  505  5.05  2.901149  global(x, function(i) min(i) / max(i)) #>         global #> lyr.1     0.01 #> lyr.1.1   0.01"},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a graticule — graticule","title":"Create a graticule — graticule","text":"Create graticule. , grid lon/lat lines can used projected map. object returned, SpatGraticule, can plotted plot lines. also crop method.","code":""},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a graticule — graticule","text":"","code":"graticule(lon=30, lat=30, crs=\"\")"},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a graticule — graticule","text":"lon numeric. Either single number (interval longitudes), vector longitudes lat numeric. Either single number (interval latitudes), vector latitudes crs character. coordinate reference system use","code":""},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a graticule — graticule","text":"SpatGraticule","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/graticule.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a graticule — graticule","text":"","code":"g <- graticule(60, 30, crs=\"+proj=robin\") g #> class       : SpatGraticule  #> lon         : -180 -120 -60 0 60 120 180  #> lat         : -90 -60 -30 0 30 60 90  #> coord. ref. : +proj=robin +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs  #> extent      : -17005833, 17005833, -8625155, 8625155  (xmin, xmax, ymin, ymax)  graticule(90, c(-90, -60, -23.5, 0, 23.5, 60, 90), crs=\"+proj=robin\") #> class       : SpatGraticule  #> lon         : -180 -90 0 90 180  #> lat         : -90 -60 -23.5 0 23.5 60 90  #> coord. ref. : +proj=robin +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs  #> extent      : -17005833, 17005833, -8625155, 8625155  (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":null,"dir":"Reference","previous_headings":"","what":"add a grid to a map made with terra — add_grid","title":"add a grid to a map made with terra — add_grid","text":"Adaptation grid allows adding grid map. function place legend locations within mapped area delineated axes. Also see graticule","code":""},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"add a grid to a map made with terra — add_grid","text":"","code":"add_grid(nx=NULL, ny=nx, col=\"lightgray\", lty=\"dotted\", lwd=1)"},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"add a grid to a map made with terra — add_grid","text":"nx, ny number cells grid x y direction. NULL, per default, grid aligns tick marks corresponding default axis (.e., tickmarks computed axTicks). NA, grid lines drawn corresponding direction col character (integer) numeric; color grid lines lty character (integer) numeric; line type grid lines lwd non-negative numeric giving line width grid lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/grid.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"add a grid to a map made with terra — add_grid","text":"","code":"v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) plot(v) add_grid()"},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":null,"dir":"Reference","previous_headings":"","what":"Distance on a grid — gridDistance","title":"Distance on a grid — gridDistance","text":"function calculates distance cells SpatRaster path go centers eight neighboring raster cells. default distance (scale=1, meters coordinate reference system (CRS) SpatRaster longitude/latitude (+proj=longlat) linear units CRS (typically meters) cases. Distances computed summing local distances cells, connected neighbors 8 directions. shortest distance cells target value computed cells NA. Cells NA traversed ignored, unless target NA, case distance nearest cell NA computed cells NA.","code":""},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Distance on a grid — gridDistance","text":"","code":"# S4 method for SpatRaster gridDist(x, target=0, scale=1, maxiter=50, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Distance on a grid — gridDistance","text":"x SpatRaster target numeric. value target cells (compute distance ) scale numeric. Scale factor. longitude/latitude data 1 = \"m\" 1000 = \"km\". planar data also case distance unit crs \"m\" maxiter numeric. maximum number iterations. Increase number get warning costDistance converge. relevant target NA filename character. output filename (optional) ... additional arguments writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Distance on a grid — gridDistance","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/gridDist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Distance on a grid — gridDistance","text":"","code":"# global lon/lat raster r <- rast(ncol=10,nrow=10, vals=1) r[48] <- 0 r[66:68] <- NA d <- gridDist(r)  plot(d)    # planar crs(r) <- \"+proj=utm +zone=15 +ellps=GRS80 +datum=NAD83 +units=m +no_defs\" d <- gridDist(r)  plot(d)   # distance to cells that are not NA  rr <- classify(r, cbind(1, NA)) dd <- gridDist(rr, NA)"},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":null,"dir":"Reference","previous_headings":"","what":"Add halo-ed text to a plot — halo","title":"Add halo-ed text to a plot — halo","text":"Add text plot \"halo\". , buffer around enhance visibility.","code":""},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add halo-ed text to a plot — halo","text":"","code":"halo(x, y=NULL, labels, col=\"black\", hc=\"white\", hw=0.1, ...)"},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add halo-ed text to a plot — halo","text":"x,y numeric. coordinates text labels written labels character. text written col character. main color used hc character. halo color hw numeric. halo width ... additional arguments pass text","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/halo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add halo-ed text to a plot — halo","text":"","code":"r <- rast(nrows=4, ncols=4) values(r) <- 1:ncell(r) plot(r, col=\"blue\", legend=FALSE)  text(-100, 20, \"hello\", cex=2) halo(50, 20, \"hello\", cex=2)  halo(0, -20, \"world\", font=3, hc=\"light blue\", cex=2, hw=.2) halo(0, 90, \"world\", font=2, cex=2, hw=.2, xpd=TRUE, pos=2) halo(0, 90, \"world\", col=\"white\", font=2, hc=\"blue\", cex=2, hw=.2, xpd=TRUE, pos=4)"},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":null,"dir":"Reference","previous_headings":"","what":"head and tail of a SpatRaster or SpatVector — headtail","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"Show head (first values) tail (last values) SpatRaster attributes SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"","code":"head(x, ...)  tail(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"x SpatRaster SpatVector ... additional arguments passed methods","code":""},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"matrix (SpatRaster) data.frame (SpatVector)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/headtail.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"head and tail of a SpatRaster or SpatVector — headtail","text":"","code":"r <- rast(nrows=25, ncols=25) values(r) <- 1:ncell(r) head(r) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 #> 5     5 #> 6     6 tail(r) #>   lyr.1 #> 1   620 #> 2   621 #> 3   622 #> 4   623 #> 5   624 #> 6   625"},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":null,"dir":"Reference","previous_headings":"","what":"Histogram — hist","title":"Histogram — hist","text":"Create histogram values SpatRaster. large datasets sample maxcell used.","code":""},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Histogram — hist","text":"","code":"# S4 method for SpatRaster hist(x, layer, maxcell=1000000, plot=TRUE, maxnl=16, main, ...)"},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Histogram — hist","text":"x SpatRaster layer positive integer character indicate layer numbers (names). missing, layers maxnl used maxcell integer. regularly sample large objects plot logical. Plot histogram return histogram values maxnl positive integer. maximum number layers use. Ignored layer missing main character. Main title(s) plot. Default value names ... additional arguments. See hist","code":""},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Histogram — hist","text":"function principally used plotting histogram, also returns object class \"histogram\" (invisibly plot=TRUE).","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/hist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Histogram — hist","text":"","code":"r1 <- r2 <- rast(nrows=50, ncols=50) values(r1) <- runif(ncell(r1)) values(r2) <- runif(ncell(r1)) rs <- r1 + r2 rp <- r1 * r2  opar <- par(no.readonly =TRUE) par(mfrow=c(2,2)) plot(rs, main='sum') plot(rp, main='product') hist(rs) a <- hist(rp)  a #> $breaks #>  [1] 0.0 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0 #>  #> $counts #>  [1] 816 483 352 250 188 159 117  76  42  17 #>  #> $density #>  [1] 3.264 1.932 1.408 1.000 0.752 0.636 0.468 0.304 0.168 0.068 #>  #> $mids #>  [1] 0.05 0.15 0.25 0.35 0.45 0.55 0.65 0.75 0.85 0.95 #>  #> $xname #> [1] \"lyr.1\" #>  #> $equidist #> [1] TRUE #>  #> attr(,\"class\") #> [1] \"histogram\" x <- c(rs, rp, sqrt(rs)) hist(x) par(opar)"},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare two SpatRasters for equality — identical","title":"Compare two SpatRasters for equality — identical","text":"Compare two SpatRasters equality. First attributes objects compared. , raster cells compared well. can time consuming, may prefer use sample instead .equal","code":""},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare two SpatRasters for equality — identical","text":"","code":"# S4 method for SpatRaster,SpatRaster identical(x, y)"},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare two SpatRasters for equality — identical","text":"x SpatRaster y SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare two SpatRasters for equality — identical","text":"single logical value","code":""},{"path":"https://rspatial.github.io/terra/reference/identical.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare two SpatRasters for equality — identical","text":"","code":"x <- sqrt(1:100) mat <- matrix(x, 10, 10) r1 <- rast(nrows=10, ncols=10, xmin=0, vals = x) r2 <- rast(nrows=10, ncols=10, xmin=0, vals = t(mat))  identical(r1, r2) #> [1] TRUE identical(r1, r1*1) #> [1] TRUE identical(rast(r1), rast(r2)) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":null,"dir":"Reference","previous_headings":"","what":"ifelse for SpatRasters — ifel","title":"ifelse for SpatRasters — ifel","text":"Implementation ifelse SpatRasters. method allows concise expression can otherwise achieved combination classify, mask, cover. ifel R equivalent Con method ArcGIS (arcpy).","code":""},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"ifelse for SpatRasters — ifel","text":"","code":"# S4 method for SpatRaster ifel(test, yes, no, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"ifelse for SpatRasters — ifel","text":"test SpatRaster logical (TRUE/FALSE) values yes SpatRaster numeric SpatRaster numeric filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"ifelse for SpatRasters — ifel","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/ifelse.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"ifelse for SpatRasters — ifel","text":"","code":"r <- rast(nrows=5, ncols=5, xmin=0, xmax=1, ymin=0, ymax=1) values(r) <- c(-10:0, NA, NA, NA, 0:10)  x <- ifel(r > 1, 1, r) # same as  a <- classify(r, cbind(1, Inf, 1)) # or b <- app(r, fun=function(i) {i[i > 1] <- 1; i}) # or  d <- clamp(r, -Inf, 1) # or (not recommended for large datasets) e <- r e[e>1] <- 1  ## other examples f <- ifel(is.na(r), 100, r)  z <- ifel(r > -2 & r < 2, 100, 0)  # nested expressions y <- ifel(r > 1, 1, ifel(r < -1, -1, r))  k <- ifel(r > 0, r+10, ifel(r < 0, r-10, 3))"},{"path":"https://rspatial.github.io/terra/reference/image.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster image method — image","title":"SpatRaster image method — image","text":"Plot (make map ) values SpatRaster via image. See plot need fancy options legend.","code":""},{"path":"https://rspatial.github.io/terra/reference/image.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster image method — image","text":"","code":"# S4 method for SpatRaster image(x, y=1, maxcell=500000, ...)"},{"path":"https://rspatial.github.io/terra/reference/image.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster image method — image","text":"x SpatRaster y positive integer indicating layer plotted, character indicating name layer maxcell positive integer. Maximum number cells use plot ... additional arguments graphics::image","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/image.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster image method — image","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\")  r <- rast(f) image(r)  image(r, col=rainbow(24))"},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":null,"dir":"Reference","previous_headings":"","what":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"Warp members SpatRasterCollection match geometry SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"","code":"# S4 method for SpatRasterCollection impose(x, y, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"x SpatRasterCollection y SpatRaster filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/impose.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Impose the geometry of a SpatRaster to those in a SpatRasterCollection. — impose","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/init.html","id":null,"dir":"Reference","previous_headings":"","what":"Initialize a SpatRaster with values — initialize","title":"Initialize a SpatRaster with values — initialize","text":"Create SpatRaster values reflecting cell property: \"x\", \"y\", \"col\", \"row\", \"cell\" \"chess\". Alternatively, function can used. case, cell values initialized without reference pre-existing values. E.g., initialize random number (fun=runif). direct ways achieving small objects (see examples) vector values can created memory, init function also work SpatRasters many cells.","code":""},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Initialize a SpatRaster with values — initialize","text":"","code":"# S4 method for SpatRaster init(x, fun, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Initialize a SpatRaster with values — initialize","text":"x SpatRaster fun function applied. must either single number, multiple numbers, function, one set known character values. function must take number cells single argument return vector values length equal number cells, fun=runif. Allowed character values \"x\", \"y\", \"row\", \"col\", \"cell\", \"chess\" get x y coordinate, row, col cell number chessboard pattern (alternating 0 1 values) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Initialize a SpatRaster with values — initialize","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/init.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Initialize a SpatRaster with values — initialize","text":"","code":"r <- rast(ncols=10, nrows=5, xmin=0, xmax=10, ymin=0, ymax=5) x <- init(r, fun=\"cell\") y <- init(r, fun=runif)  # initialize with a single value  z <- init(r, fun=8)"},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":null,"dir":"Reference","previous_headings":"","what":"Change values in-place — inplace","title":"Change values in-place — inplace","text":"\"-place\" replacement methods assign new value object without making copy. efficient, copy object made standard assignment (e.g. y <- x), copy also changed. set.names -place replacement version names<-. set.ext -place replacement version ext<- set.values -place replacement version [<-. set.cats -place replacement version categories set.crs -place replacement version crs<-","code":""},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Change values in-place — inplace","text":"","code":"# S4 method for SpatRaster set.names(x, value, index=1:nlyr(x), validate=FALSE) # S4 method for SpatRasterDataset set.names(x, value, index=1:length(x), validate=FALSE) # S4 method for SpatVector set.names(x, value, index=1:ncol(x), validate=FALSE)  # S4 method for SpatRaster set.ext(x, value) # S4 method for SpatVector set.ext(x, value)  # S4 method for SpatRaster set.crs(x, value) # S4 method for SpatVector set.crs(x, value)  # S4 method for SpatRaster set.values(x, cells, values, layer=0)  # S4 method for SpatRaster set.cats(x, layer=1, value, active=1)  # S4 method for SpatRaster set.RGB(x, value, type=\"rgb\")"},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Change values in-place — inplace","text":"x SpatRaster value character set.names. set.cats: data.frame columns (value, category) vector category names. set.RGB 3 4 numbers indicating RGB() layers index positive integer indicating layer(s) assign name validate logical. Make names valid /unique? cells cell numbers missing values replacement values missing load values memory layer positive integer(s) indicating layer(s) want assign categories want set values. number < 1 indicates \"layers\" active positive integer indicating active category (column number value, counting first column type character. color space. One \"rgb\" \"hsv\", \"hsi\" \"hsl\"","code":""},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Change values in-place — inplace","text":"logical (invisibly)","code":""},{"path":"https://rspatial.github.io/terra/reference/inplace.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Change values in-place — inplace","text":"","code":"s <- rast(ncols=5, nrows=5, nlyrs=3) x <- s names(s) #> [1] \"lyr.1\" \"lyr.2\" \"lyr.3\" names(s) <- c(\"a\", \"b\", \"c\") names(s) #> [1] \"a\" \"b\" \"c\" names(x) #> [1] \"lyr.1\" \"lyr.2\" \"lyr.3\"  x <- s set.names(s, c(\"e\", \"f\", \"g\")) names(s) #> [1] \"e\" \"f\" \"g\" names(x) #> [1] \"e\" \"f\" \"g\"  set.ext(x, c(0,180,0,90))  f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f)  #values from file to memory set.values(r)  # change values set.values(r, 1:1000, 900)"},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":null,"dir":"Reference","previous_headings":"","what":"Make an inset map — inset","title":"Make an inset map — inset","text":"Make inset map scale extent SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make an inset map — inset","text":"","code":"# S4 method for SpatVector inset(x, e, loc=\"\", scale=0.2, background=\"white\",    perimeter=TRUE, box=NULL, pper, pbox, offset=0.1, add=TRUE, ...)  # S4 method for SpatRaster inset(x, e, loc=\"\", scale=0.2, background=\"white\",    perimeter=TRUE, box=NULL, pper, pbox, offset=0.1, add=TRUE, ...)  # S4 method for SpatVector inext(x, e, y=NULL, gap=0)"},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make an inset map — inset","text":"x SpatVector, SpatRaster e SpatExtent set size location inset. missing loc character. One \"bottomright\", \"bottom\", \"bottomleft\", \"left\", \"topleft\", \"top\", \"topright\", \"right\", \"center\" scale numeric. relative size inset, used x missing background color background inset. Use NA background color perimeter logical. TRUE perimeter (border) drawn around inset box SpatExtent missing, draw box inset, e.g. show map located larger area pper list graphical parameters (arguments) col lwd perimeter line pbox list graphical parameters (arguments) col lwd box (line) offset numeric. Value 0.1 1 indicate relative distance mapped bounding box add logical. Add inset map? ... additional arguments passed plot drawing x y SpatVector. NULL, y scaled based parameters x. useful, example, x represent boundaries, y points within boundaries gap numeric add space SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make an inset map — inset","text":"scaled shifted SpatVector SpatRaster (returned invisibly)","code":""},{"path":"https://rspatial.github.io/terra/reference/inset.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make an inset map — inset","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) x <- v[v$NAME_2 == \"Diekirch\", ]  plot(x, density=10, col=\"blue\") inset(v)   # more elaborate plot(x, density=10, col=\"blue\") inset(v, col = \"brown\", border=\"lightgrey\", perimeter=TRUE,      pper=list(col=\"orange\", lwd=3, lty=2),      box=ext(x), pbox=list(col=\"blue\", lwd=2))  cols <- rep(\"light grey\", 12) cols[2] <- \"red\" e <- ext(c(6.2, 6.3, 49.9, 50)) b <- ext(x)+0.02 inset(v, e=e, col=cols, box=b)   # with a SpatRaster ff <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(ff) r <- crop(r, ext(x) + .01) plot(r, type=\"int\", mar=c(2,2,2,2), plg=list(x=\"topright\")) lines(v, lwd=1.5) lines(x, lwd=2.5) inset(v, col=cols, loc=\"topleft\", scale=0.15)   # a more complex one plot(r, plg=list(title=\"meter\\n\", shrink=.2, cex=.8)) lines(v, lwd=4, col=\"white\") lines(v, lwd=1.5) lines(x, lwd=2.5) text(x, \"NAME_2\", cex=1.5, halo=TRUE) sbar(6, c(6.04, 49.785), type=\"bar\", below=\"km\", label=c(0,3,6), cex=.8) s <- inset(v, col=cols, box=b, scale=.2, loc=\"topright\", background=\"light yellow\",   pbox=list(lwd=2, lty=5, col=\"blue\"))  # note the returned inset SpatVector s #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 6.255333, 6.321333, 49.9348, 49.99657  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 lines(s, col=\"orange\")"},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":null,"dir":"Reference","previous_headings":"","what":"Interpolate points using a moving window — interpIDW","title":"Interpolate points using a moving window — interpIDW","text":"Interpolate points within moving window using inverse distance weighting. maximum number points used can restricted, optionally selecting nearest points.","code":""},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Interpolate points using a moving window — interpIDW","text":"","code":"# S4 method for SpatRaster,SpatVector interpIDW(x, y, field, radius, power=2, smooth=0,        maxPoints=Inf, minPoints=1, near=TRUE, fill=NA, filename=\"\", ...)  # S4 method for SpatRaster,matrix interpIDW(x, y, radius, power=2, smooth=0,         maxPoints=Inf, minPoints=1, near=TRUE, fill=NA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Interpolate points using a moving window — interpIDW","text":"x SpatRaster y SpatVector matrix three columns (x,y,z) field character. field name SpatVector y radius numeric. radius circle (single number). near=FALSE, also possible use two three numbers. Two numbers interpreted radii ellipse (x y-axis). third number indicated desired, counter clockwise, rotation ellipse (degrees) power numeric. Weighting power smooth numeric. Smoothing parameter minPoints numeric. minimum number points use. fewer points found search ellipse considered empty fill value returned maxPoints numeric. maximum number points consider search area. Additional points ignored. fewer points found, fill value returned near logical. nearest points within neighborhood used maxPoints reached? fill numeric. value use fill empty cells filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Interpolate points using a moving window — interpIDW","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/interpIDW.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Interpolate points using a moving window — interpIDW","text":"","code":"r <- rast(ncol=100, nrow=100, crs=\"local\", xmin=0, xmax=50, ymin=0, ymax=50) set.seed(100) x <- runif(25, 5, 45) y <- runif(25, 5, 45) z <- sample(25) xyz <- cbind(x,y,z)  x <- interpIDW(r, xyz, radius=5, power=1, smooth=1, maxPoints=5)"},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":null,"dir":"Reference","previous_headings":"","what":"Nearest neighbor interpolation — interpNear","title":"Nearest neighbor interpolation — interpNear","text":"Nearest neighbor interpolation points, using moving window","code":""},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Nearest neighbor interpolation — interpNear","text":"","code":"# S4 method for SpatRaster,SpatVector interpNear(x, y, field, radius, interpolate=FALSE, fill=NA, filename=\"\", ...)  # S4 method for SpatRaster,matrix interpNear(x, y, radius, interpolate=FALSE, fill=NA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Nearest neighbor interpolation — interpNear","text":"x SpatRaster y SpatVector matrix three columns (x,y,z) field character. field name SpatVector y radius numeric. radius circle (single number). interpolate=FALSE also possible use two three numbers. Two numbers interpreted radii ellipse (x y-axis). third number indicated desired, counter clockwise, rotation ellipse (degrees) interpolate logical. nearest neighbor values linearly interpolated points? fill numeric. value use fill empty cells filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Nearest neighbor interpolation — interpNear","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/interpNear.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Nearest neighbor interpolation — interpNear","text":"","code":"r <- rast(ncol=100, nrow=100, crs=\"local\", xmin=0, xmax=50, ymin=0, ymax=50) set.seed(100) x <- runif(25, 5, 45) y <- runif(25, 5, 45) z <- sample(25) xyz <- cbind(x,y,z)  x <- interpNear(r, xyz, radius=5)  p <- vect(data.frame(xyz), geom=c(\"x\", \"y\"))  v <- voronoi(p)  plot(x, col=rainbow(25)) lines(v)   # plot(v, col=rainbow(25)); points(p)"},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial interpolation — interpolation","title":"Spatial interpolation — interpolation","text":"Make SpatRaster interpolated values using fitted model object classes \"gstat\" (gstat package) \"Krige\" (fields package), model location (e.g., \"x\" \"y\", \"longitude\" \"latitude\") predictors (independent variables). x y predictors, efficient provide empty (associated data memory file) SpatRaster want predictions. spatial predictor variables, provide SpatRaster first argument function. x y locations implicit predictors model use predict instead.","code":""},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial interpolation — interpolation","text":"","code":"# S4 method for SpatRaster interpolate(object, model, fun=predict, ..., xyNames=c(\"x\", \"y\"),         factors=NULL, const=NULL, index = NULL, cores=1, cpkgs=NULL,       na.rm=FALSE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial interpolation — interpolation","text":"object SpatRaster model model object fun function. Default value \"predict\", can replaced e.g. \"predict.se\" (depending class model), custom function (see examples) ... additional arguments passed fun xyNames character. variable names model uses spatial coordinates. E.g., c(\"longitude\", \"latitude\") factors list levels factor variables. list elements named names correspond names object can matched. argument may omitted models levels can extracted model object const data.frame. Can used add constant SpatRaster model predictions. particularly useful constant character-like factor value index positive integer NULL. Allows selecting variable returned model returns multiple variables cores positive integer. cores > 1, 'parallel' package cluster many cores created used cpkgs character. package(s) need loaded nodes able run model.predict function (see examples predict) na.rm logical. TRUE, cells NA values predictors removed computation. option prevents errors models handle NA values. cases affect output. exception predicting model returns predicted values even (!) variables NA filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial interpolation — interpolation","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/interpolate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial interpolation — interpolation","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) ra <- aggregate(r, 10) xy <- data.frame(xyFromCell(ra, 1:ncell(ra))) v <- values(ra) i <- !is.na(v) xy <- xy[i,] v <- v[i]  if (FALSE) { library(fields)  tps <- Tps(xy, v) p <- rast(r)  # use model to predict values at all locations p <- interpolate(p, tps) p <- mask(p, r) plot(p)  ### change \"fun\" from predict to fields::predictSE to get the TPS standard error ## need to use \"rast(p)\" to remove the values se <- interpolate(rast(p), tps, fun=predictSE) se <- mask(se, r) plot(se)  ### another predictor variable, \"e\" e <- (init(r, \"x\") * init(r, \"y\")) / 100000000 names(e) <- \"e\"  z <- as.matrix(extract(e, xy)[,-1])  ## add as another independent variable xyz <- cbind(xy, z) tps2 <- Tps(xyz, v) p2 <- interpolate(e, tps2, xyOnly=FALSE)  ## as a linear covariate tps3 <- Tps(xy, v, Z=z)  ## Z is a separate argument in Krig.predict, so we need a new function ## Internally (in interpolate) a matrix is formed of x, y, and elev (Z)  pfun <- function(model, x, ...) {    predict(model, x[,1:2], Z=x[,3], ...) } p3 <- interpolate(e, tps3, fun=pfun)   #### gstat examples library(gstat) library(sp) data(meuse)  ### inverse distance weighted (IDW) r <- rast(system.file(\"ex/meuse.tif\", package=\"terra\")) mg <- gstat(id = \"zinc\", formula = zinc~1, locations = ~x+y, data=meuse,              nmax=7, set=list(idp = .5)) z <- interpolate(r, mg, debug.level=0, index=1) z <- mask(z, r)  ## with a model built with an `sf` object you need to provide custom function  library(sf) sfmeuse <- st_as_sf(meuse, coords = c(\"x\", \"y\"), crs=crs(r)) mgsf <- gstat(id = \"zinc\", formula = zinc~1, data=sfmeuse,  nmax=7, set=list(idp = .5))  interpolate_gstat <- function(model, x, crs, ...) {   v <- st_as_sf(x, coords=c(\"x\", \"y\"), crs=crs)   p <- predict(model, v, ...)   as.data.frame(p)[,1:2] }  zsf <- interpolate(r, mgsf, debug.level=0, fun=interpolate_gstat, crs=crs(r), index=1) zsf <- mask(zsf, r)  ### kriging  ### ordinary kriging v <- variogram(log(zinc)~1, ~x+y, data=meuse) mv <- fit.variogram(v, vgm(1, \"Sph\", 300, 1)) gOK <- gstat(NULL, \"log.zinc\", log(zinc)~1, meuse, locations=~x+y, model=mv) OK <- interpolate(r, gOK, debug.level=0)  ## universal kriging vu <- variogram(log(zinc)~elev, ~x+y, data=meuse) mu <- fit.variogram(vu, vgm(1, \"Sph\", 300, 1)) gUK <- gstat(NULL, \"log.zinc\", log(zinc)~elev, meuse, locations=~x+y, model=mu) names(r) <- \"elev\" UK <- interpolate(r, gUK, debug.level=0)  ## co-kriging gCoK <- gstat(NULL, 'log.zinc', log(zinc)~1, meuse, locations=~x+y) gCoK <- gstat(gCoK, 'elev', elev~1, meuse, locations=~x+y) gCoK <- gstat(gCoK, 'cadmium', cadmium~1, meuse, locations=~x+y) gCoK <- gstat(gCoK, 'copper', copper~1, meuse, locations=~x+y) coV <- variogram(gCoK) plot(coV, type='b', main='Co-variogram') coV.fit <- fit.lmc(coV, gCoK, vgm(model='Sph', range=1000)) coV.fit plot(coV, coV.fit, main='Fitted Co-variogram') coK <- interpolate(r, coV.fit, debug.level=0) plot(coK) }"},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":null,"dir":"Reference","previous_headings":"","what":"Intersection — intersect","title":"Intersection — intersect","text":"can intersect SpatVectors SpatExtent. Intersecting points points uses extent y get intersection. Intersecting points lines supported numerical inaccuracies . can use buffer, create polygons lines use intersect. can also intersect two SpatExtents. intersecting two SpatRasters need aligned (origin spatial resolution). values returned SpatRaster TRUE input rasters values, FALSE one values, NA cells. intersecting SpatExtent SpatRaster, SpatExtent first aligned raster cell boundaries. See crop intersection SpatRaster SpatExtent (extent SpatRaster SpatVector) want SpatRaster (SpatExtent) output. See .related(x, y, \"intersects\") find geometries SpatVector intersect. can spatially subset SpatVector another one x[y].","code":""},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Intersection — intersect","text":"","code":"# S4 method for SpatVector,SpatVector intersect(x, y)  # S4 method for SpatVector,SpatExtent intersect(x, y)  # S4 method for SpatExtent,SpatVector intersect(x, y)  # S4 method for SpatExtent,SpatExtent intersect(x, y)  # S4 method for SpatRaster,SpatRaster intersect(x, y)  # S4 method for SpatRaster,SpatExtent intersect(x, y)  # S4 method for SpatExtent,SpatRaster intersect(x, y)"},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Intersection — intersect","text":"x SpatVector, SpatExtent, SpatRaster y SpatVector, SpatExtent, SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Intersection — intersect","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/intersect.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Intersection — intersect","text":"","code":"e1 <- ext(-10, 10, -20, 20) e2 <- ext(0, 20, -40, 5) intersect(e1, e2) #> SpatExtent : 0, 10, -20, 5 (xmin, xmax, ymin, ymax)  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) e <- ext(5.6, 6, 49.55, 49.7) x <- intersect(v, e)  p <- vect(c(\"POLYGON ((5.8 49.8, 6 49.9, 6.15 49.8, 6 49.6, 5.8 49.8))\",  \"POLYGON ((6.3 49.9, 6.2 49.7, 6.3 49.6, 6.5 49.8, 6.3 49.9))\"), crs=crs(v)) values(p) <- data.frame(pid=1:2, area=expanse(p))  y <- intersect(v, p)  r <- s <- rast(ncol=5, nrow=5, xmin=1, xmax=5, ymin=1, ymax=5) r[5:20] <- 5:20 s[11:20] <- 11:20 rs <- intersect(r, s)  u <- shift(r, .8) us <- intersect(u, s)"},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":null,"dir":"Reference","previous_headings":"","what":"Raster value types — is.bool","title":"Raster value types — is.bool","text":"values SpatRaster layer default numeric, can also set logical (Boolean), integer, categorical (factor). SpatRaster, .logical isTRUE equivalent .bool. isFALSE equivalent !.bool, .integer .int. .bool .int force values correct range (e.g. whole integers) -memory cell values still stored numeric. behave like assigned types, though, written files data type (file type supports ). See levels cats create categorical layers setting labels.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Raster value types — is.bool","text":"","code":"# S4 method for SpatRaster is.bool(x)  # S4 method for SpatRaster as.bool(x, filename, ...)  # S4 method for SpatRaster is.int(x)  # S4 method for SpatRaster as.int(x, filename, ...)  # S4 method for SpatRaster is.factor(x)  # S4 method for SpatRaster as.factor(x)"},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Raster value types — is.bool","text":"x SpatRaster filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Raster value types — is.bool","text":".* methods return new SpatRaster, whereas .* methods return logical value layer x.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.bool.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Raster value types — is.bool","text":"","code":"r <- rast(nrows=10, ncols=10, vals=1:100) is.bool(r) #> [1] FALSE z <- as.bool(r) is.bool(z) #> [1] TRUE  x <- r > 25 is.bool(x) #> [1] TRUE  rr <- r/2 is.int(rr) #> [1] FALSE is.int(round(rr)) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if a SpatExtent or SpatVector is empty — is.empty","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"empty SpatExtent area empty SpatVector geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"","code":"# S4 method for SpatExtent is.empty(x)  # S4 method for SpatVector is.empty(x)"},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"x SpatVector SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"logical","code":""},{"path":"https://rspatial.github.io/terra/reference/is.empty.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check if a SpatExtent or SpatVector is empty — is.empty","text":"","code":"e <- ext(0,0,0,0) is.valid(e) #> [1] TRUE is.empty(e) #> [1] TRUE  v <- vect() is.valid(v) #> logical(0) is.empty(v) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":null,"dir":"Reference","previous_headings":"","what":"Check for longitude/latitude crs — is.lonlat","title":"Check for longitude/latitude crs — is.lonlat","text":"Test whether SpatRaster SpatVector longitude/latitude coordinate reference system (CRS), perhaps one. , CRS unknown (\"\") x coordinates within -181 181 y coordinates within -90.1 90.1. SpatRaster can also test longitude/latitude CRS \"global\" (covers longitudes). warning given CRS missing specified longitude/latitude coordinates match .","code":""},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check for longitude/latitude crs — is.lonlat","text":"","code":"# S4 method for SpatRaster is.lonlat(x, perhaps=FALSE, warn=TRUE, global=FALSE)  # S4 method for SpatVector is.lonlat(x, perhaps=FALSE, warn=TRUE)  # S4 method for character is.lonlat(x, perhaps=FALSE, warn=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check for longitude/latitude crs — is.lonlat","text":"x SpatRaster SpatVector perhaps logical. TRUE CRS unknown, method returns TRUE coordinates plausible longitude/latitude warn logical. TRUE, warning given CRS unknown assumed lon/lat  perhaps=TRUE global logical. TRUE, method tests raster covers longitudes (-180 180 degrees) extreme columns fact adjacent","code":""},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check for longitude/latitude crs — is.lonlat","text":"logical NA","code":""},{"path":"https://rspatial.github.io/terra/reference/is.lonlat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check for longitude/latitude crs — is.lonlat","text":"","code":"r <- rast() is.lonlat(r) #> [1] TRUE is.lonlat(r, global=TRUE) #> [1] TRUE  crs(r) <- \"\" is.lonlat(r) #> Warning: [is.lonlat] unknown crs #> [1] NA is.lonlat(r, perhaps=TRUE, warn=FALSE) #> [1] TRUE  crs(r) <- \"+proj=lcc +lat_1=48 +lat_2=33 +lon_0=-100 +ellps=WGS84\" is.lonlat(r) #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":null,"dir":"Reference","previous_headings":"","what":"Check for rotation — is.rotated","title":"Check for rotation — is.rotated","text":"Check SpatRaster \"rotated\" needs rectified can used See rectify","code":""},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check for rotation — is.rotated","text":"","code":"# S4 method for SpatRaster is.rotated(x)"},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check for rotation — is.rotated","text":"x SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check for rotation — is.rotated","text":"logical. One value raster data *source*","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/is.rotated.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check for rotation — is.rotated","text":"","code":"r <- rast(nrows=10, ncols=10, vals=1:100) is.rotated(r) #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":null,"dir":"Reference","previous_headings":"","what":"Check or fix polygon or extent validity — is.valid","title":"Check or fix polygon or extent validity — is.valid","text":"Check validity polygons attempt fix . check validity SpatExtent.","code":""},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check or fix polygon or extent validity — is.valid","text":"","code":"# S4 method for SpatVector is.valid(x, messages=FALSE, as.points=FALSE)  # S4 method for SpatVector makeValid(x)  # S4 method for SpatExtent is.valid(x)"},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check or fix polygon or extent validity — is.valid","text":"x SpatVector SpatExtent messages logical. TRUE error messages returned .points logical. TRUE, attempted return locations polygons invalid SpatVector points","code":""},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check or fix polygon or extent validity — is.valid","text":"logical","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/is.valid.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check or fix polygon or extent validity — is.valid","text":"","code":"w <- vect(\"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\") is.valid(w) #> [1] TRUE  w <- vect(\"POLYGON ((0 -5, 10 0, 10 -10, 4 -2, 0 -5))\") is.valid(w) #> [1] FALSE is.valid(w, TRUE) #>   valid                                                reason #> 1 FALSE Self-intersection[4.54545454545454 -2.72727272727273]  plot(w) points(cbind(4.54, -2.72), cex=2, col=\"red\")    e <- ext(0, 1, 0, 1) is.valid(e) #> [1] TRUE  ee <- ext(0, 0, 0, 0) is.valid(ee) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":null,"dir":"Reference","previous_headings":"","what":"k_means — k_means","title":"k_means — k_means","text":"Compute k-means clusters SpatRaster. large SpatRasters (ncell(x) > maxcell) done two steps. First sample cells used compute cluster centers. cell assigned cluster computing distance centers.","code":""},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"k_means — k_means","text":"","code":"# S4 method for SpatRaster k_means(x, centers=3, ..., maxcell=1000000, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"k_means — k_means","text":"x SpatRaster centers either number clusters, set initial (distinct) cluster centres. number, random set (distinct) cells x chosen initial centres ... additional arguments passed kmeans maxcell positive integer. size regular sample used smaller ncell(x) filename character. Output filename (ignored .raster=FALSE) overwrite logical. TRUE, filename overwritten wopt list additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"k_means — k_means","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/k_means.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"k_means — k_means","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f) km <- k_means(r, centers=5) km #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> name        : lyr1  #> min value   :    1  #> max value   :    5"},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"Apply function SpatRaster, using layers arguments. number arguments function fun must match number layers SpatRaster (number sub-datasets SpatRasterDataset). example, want multiply two layers, use function: fun=function(x,y){return(x*y)} percentage: fun=function(x,y){return(100 * x / y)}. combine three layers use fun=function(x,y,z){return((x + y) * z)} use function, test make sure vectorized. , work vectors longer one, single numbers. input SpatRaster(s) multiple layers, work matrix (multiple cells) input data (matrices case SpatRasterDataSet). function must return number elements input vectors, multiples . Also make sure function NA-proof: returns number values input values NA. function must return vector matrix, data.frame. test , run .call(fun, data) (see examples). Use app summarize functions sum, take number arguments; tapp groups layers.","code":""},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"","code":"# S4 method for SpatRaster lapp(x, fun, ..., usenames=FALSE, cores=1, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterDataset lapp(x, fun, ..., usenames=FALSE, recycle=FALSE,      filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"x SpatRaster SpatRasterDataset fun function takes vector can applied cell x ... additional arguments passed fun usenames logical. Use layer names (dataset names x SpatRasterDataset) match function arguments? FALSE, argument matching position cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object recycle logical. Recycle layers match subdataset largest number layers filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"Use sapp lapply apply function takes SpatRaster argument layer SpatRaster (rarely necessary).","code":""},{"path":"https://rspatial.github.io/terra/reference/lapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to layers of a SpatRaster, or sub-datasets of a SpatRasterDataset — lapp","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) + 1   ss <- s[[2:1]]  fvi <- function(x, y){ (x - y ) / (x + y) }  # test the function data <- list(c(1:5,NA), 6:1) do.call(fvi, data) #> [1] -0.7142857 -0.4285714 -0.1428571  0.1428571  0.4285714         NA  x <- lapp(ss, fun=fvi )  # which is the same as supplying the layers to \"fun\" # in some cases this will be much faster  y <- fvi(s[[2]], s[[1]])  f2 <- function(x, y, z){ (z - y + 1) / (x + y + 1) }  p1 <- lapp(s, fun=f2 )  p2 <- lapp(s[[1:2]], f2, z=200)  # the usenames argument  fvi2 <- function(red, green){ (red - green ) / (red + green) }  names(s) #> [1] \"red\"   \"green\" \"blue\"  x1 <- lapp(s[[1:2]], fvi2, usenames=TRUE) x2 <- lapp(s[[2:1]], fvi2, usenames=TRUE) # x1 and x2 are the same, despite the change in the order of the layers # x4 is also the same, but x3 is not x3 <- lapp(s[[2:1]], fvi2, usenames=FALSE) x4 <- lapp(s, fvi2, usenames=TRUE)  # while this would fail because  # there are too many layers in s # x5 <- lapp(s, fvi2, usenames=FALSE)  pairs(c(x1, x2, x3, x4))   ## SpatRasterDataset x <- sds(s, s[[1]]+50) fun <- function(x, y) { x/y }  # test \"fun\" data <- list(matrix(1:9, ncol=3), matrix(9:1, ncol=3)) do.call(fun, data) #>           [,1]      [,2]     [,3] #> [1,] 0.1111111 0.6666667 2.333333 #> [2,] 0.2500000 1.0000000 4.000000 #> [3,] 0.4285714 1.5000000 9.000000  lapp(x, fun, recycle=TRUE) #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> names       :      lyr.1,      lyr.2,      lyr.3  #> min values  : 0.01960784, 0.01851852, 0.01694915  #> max values  : 0.83660131, 0.88571429, 1.12359551   # the same, more concisely z <- s / (s[[1]]+50)"},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":null,"dir":"Reference","previous_headings":"","what":"Correlation and (weighted) covariance — layerCor","title":"Correlation and (weighted) covariance — layerCor","text":"Compute correlation, (weighted) covariance, similar summary statistics compare values pairs layers SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Correlation and (weighted) covariance — layerCor","text":"","code":"# S4 method for SpatRaster layerCor(x, fun, w, asSample=TRUE, use=\"everything\", maxcell=Inf, ...)"},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Correlation and (weighted) covariance — layerCor","text":"x SpatRaster fun character. statistic compute: either \"cov\" (covariance), \"weighted.cov\" (weighted covariance), \"cor\" (pearson correlation coefficient) function takes two vectors argument compute single number w SpatRaster weights  compute weighted covariance. single layer geometry x asSample logical. TRUE, statistic sample (denominator n-1) computed, rather population (denominator n). standard functions use character. decide handle missing values. must (abbreviation ) one \"everything\", \"complete.obs\", \"pairwise.complete.obs\", \"masked.complete\". \"pairwise.complete.obs\", value pair layers computed cells NA pair. Therefore, may (number ) cells used varies pairs. benefit approach available data used. Use \"complete.obs\", want use values cells NA layers. using \"masked.complete\" indicate layers NA values cells maxcell positive integer. maximum number cells used. smaller ncell(x), regular sample x used ... additional arguments fun (proper function)","code":""},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Correlation and (weighted) covariance — layerCor","text":"fun one three standard statistics, get list three items:  correlation (weighted) covariance matrix, (weighted) means, number data cells  comparison. means also matrix may depend combination layers  different cells missing values excluded computation. rows  mean matrix represent layer whose (weighted) mean calculated columns  represent layer paired . cells non-missing observations  layers used calculation (weighted) mean. diagonals mean n  matrices set missing. fun function, get single matrix.","code":""},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Correlation and (weighted) covariance — layerCor","text":"weighted covariance: Canty, M.J. .. Nielsen, 2008. Automatic radiometric normalization multitemporal satellite imagery iteratively re-weighted MAD transformation. Remote Sensing Environment 112:1025-1036. Nielsen, .., 2007. regularized iteratively reweighted MAD method change detection multi- hyperspectral data. IEEE Transactions Image Processing 16(2):463-478.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/layerCor.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Correlation and (weighted) covariance — layerCor","text":"","code":"b <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    layerCor(b, \"pearson\") #> $correlation #>             red     green      blue #> red   1.0000000 0.9980961 0.9501633 #> green 0.9980961 1.0000000 0.9658011 #> blue  0.9501633 0.9658011 1.0000000 #>  #> $mean #>            red    green     blue #> red        NaN 182.2855 182.2855 #> green 185.3509      NaN 185.3509 #> blue  192.8046 192.8046      NaN #>  #> $n #>        red green blue #> red    NaN  7777 7777 #> green 7777   NaN 7777 #> blue  7777  7777  NaN #>   layerCor(b, \"cov\") #> $covariance #>            red    green     blue #> red   5564.371 5443.405 4993.165 #> green 5443.405 5345.403 4974.478 #> blue  4993.165 4974.478 4962.942 #>  #> $mean #>            red    green     blue #> red   182.2855 182.2855 182.2855 #> green 185.3509 185.3509 185.3509 #> blue  192.8046 192.8046 192.8046 #>  #> $n #>      [,1] [,2] [,3] #> [1,] 7777 7777 7777 #> [2,] 7777 7777 7777 #> [3,] 7777 7777 7777 #>   # weigh by column number w <- init(b, fun=\"col\") layerCor(b, \"weighted.cov\", w=w) #> $weighted_covariance #>            red    green     blue #> red   5670.750 5536.351 5009.851 #> green 5536.351 5427.161 4987.092 #> blue  5009.851 4987.092 4937.007 #>  #> $weighted_mean #>            red    green     blue #> red   177.5983 177.5983 177.5983 #> green 181.3521 181.3521 181.3521 #> blue  191.5236 191.5236 191.5236 #>"},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":null,"dir":"Reference","previous_headings":"","what":"add a custom legend — add_legend","title":"add a custom legend — add_legend","text":"Wrapper around legend allows adding custom legend map using keyword \"topleft\" \"bottomright\". function place legend locations within mapped area delineated axes.","code":""},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"add a custom legend — add_legend","text":"","code":"add_legend(x, y, ...)"},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"add a custom legend — add_legend","text":"x keyword used position legend (x coordinate) y y coordinate used position legend (x also coordinate) ... arguments passed legend","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/legend.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"add a custom legend — add_legend","text":"","code":"v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) plot(v) points(centroids(v), col=\"red\") legend(\"topleft\", legend = \"centroids\", pch = 20, xpd=NA, bg=\"white\", col=\"red\") add_legend(\"topright\", legend = \"centroids\", pch = 20, col=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":null,"dir":"Reference","previous_headings":"","what":"Linear units of the coordinate reference system — linearUnits","title":"Linear units of the coordinate reference system — linearUnits","text":"Get linear units coordinate reference system (crs) SpatRaster SpatVector expressed m. value returned used internally transform area perimeter measures meters. value returned longitude/latitude crs zero.","code":""},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Linear units of the coordinate reference system — linearUnits","text":"","code":"# S4 method for SpatRaster linearUnits(x)  # S4 method for SpatVector linearUnits(x)"},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Linear units of the coordinate reference system — linearUnits","text":"x SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Linear units of the coordinate reference system — linearUnits","text":"numeric (meter)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/linearUnits.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Linear units of the coordinate reference system — linearUnits","text":"","code":"x <- rast() crs(x) <- \"\" linearUnits(x) #> [1] NaN  crs(x) <- \"+proj=longlat +datum=WGS84\" linearUnits(x) #> [1] 0  crs(x) <- \"+proj=utm +zone=1 +units=cm\" linearUnits(x) #> [1] 0.01  crs(x) <- \"+proj=utm +zone=1 +units=km\" linearUnits(x) #> [1] 1000  crs(x) <- \"+proj=utm +zone=1 +units=us-ft\" linearUnits(x) #> [1] 0.3048006"},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":null,"dir":"Reference","previous_headings":"","what":"Add points, lines, or polygons to a map — lines","title":"Add points, lines, or polygons to a map — lines","text":"Add vector geometries plot (map) points, lines, polys. simpler alternatives plot(x, add=TRUE) methods also work small(!) SpatRaster. cells NA first layer used.","code":""},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add points, lines, or polygons to a map — lines","text":"","code":"# S4 method for SpatVector points(x, col, cex=0.7, pch=16, alpha=1, ...)  # S4 method for SpatVector lines(x, y=NULL, col, lwd=1, lty=1, arrows=FALSE, alpha=1, ...)  # S4 method for SpatVector polys(x, col, border=\"black\", lwd=1, lty=1, alpha=1, ...)  # S4 method for SpatRaster points(x, ...)  # S4 method for SpatRaster lines(x, mx=10000, ...)  # S4 method for SpatRaster polys(x, mx=10000, dissolve=TRUE, ...)  # S4 method for SpatExtent points(x, col=\"black\", alpha=1, ...)  # S4 method for SpatExtent lines(x, col=\"black\", alpha=1, ...)  # S4 method for SpatExtent polys(x, col, alpha=1, ...)"},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add points, lines, or polygons to a map — lines","text":"x SpatVector SpatExtent y missing SpatVector. x y point geometry number rows, lines drawn pairs points col character. Colors border character. color(s) polygon borders. Use NULL NA draw border cex numeric. point size magnifier. See par pch positive integer, point type. See points. (linux) devices, default symbol \"16\" smooth circle. can use \"20\" instead (takes bit longer draw) \"1\" open circle alpha number 0 1 set transparency lwd numeric, line-width. See par lty positive integer, line type. See par arrows logical. TRUE y SpatVector, arrows drawn intead lines. See ?arrows additional arguments mx positive number. number cells SpatRaster x higher, method fail error message dissolve logical. boundaries cells value removed? ... additional graphical arguments lwd, cex pch","code":""},{"path":"https://rspatial.github.io/terra/reference/lines.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add points, lines, or polygons to a map — lines","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  r <- rast(v) values(r) <- 1:ncell(r) plot(r) lines(v) points(v)"},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":null,"dir":"Reference","previous_headings":"","what":"Make tiles or get their extents — makeTiles","title":"Make tiles or get their extents — makeTiles","text":"Divide SpatRaster \"tiles\". cells another SpatRaster (normally much lower resolution) SpatVector polygon geometry can used define tiles. can also provide one two numbers indicate number rows columns per tile. getTileExtents returns extents (virtual) tiles, makeTiles creates files tiles returns filenames.","code":""},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make tiles or get their extents — makeTiles","text":"","code":"# S4 method for SpatRaster makeTiles(x, y, filename=\"tile_.tif\", extend=FALSE,     na.rm=FALSE, buffer=0, overwrite=FALSE, ...)  # S4 method for SpatRaster getTileExtents(x, y, extend=FALSE, buffer=0)"},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make tiles or get their extents — makeTiles","text":"x SpatRaster y SpatRaster SpatVector defining zones; numeric specifying number rows columns zone (1 2 numbers number rows columns ) filename character. Output filename template. Filenames altered adding tile number tile extend logical. TRUE, extent y expanded assure covers x na.rm logical. TRUE, tiles missing values ignored buffer integer. number additional rows columns added tile. Can single number, two numbers specify separate number rows columns. allows creating overlapping tiles can used computing spatial context dependent values e.g. focal. expansion inside x, rows columns outside x added overwrite logical. TRUE, existing tiles overwritten; otherwise skipped (without error warning) ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make tiles or get their extents — makeTiles","text":"character (filenames) matrix (extents)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/makeTiles.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make tiles or get their extents — makeTiles","text":"","code":"r <- rast(ncols=100, nrows=100) values(r) <- 1:ncell(r) x <- rast(ncols=2, nrows=2)  getTileExtents(r, x) #>               xmin         xmax          ymin         ymax #> [1,] -1.800000e+02 4.440892e-15 -2.220446e-15 9.000000e+01 #> [2,]  4.440892e-15 1.800000e+02 -2.220446e-15 9.000000e+01 #> [3,] -1.800000e+02 4.440892e-15 -9.000000e+01 2.220446e-15 #> [4,]  4.440892e-15 1.800000e+02 -9.000000e+01 2.220446e-15 getTileExtents(r, x, buffer=3) #>        xmin  xmax  ymin ymax #> [1,] -180.0  10.8  -5.4 90.0 #> [2,]  -10.8 180.0  -5.4 90.0 #> [3,] -180.0  10.8 -90.0  5.4 #> [4,]  -10.8 180.0 -90.0  5.4   filename <- paste0(tempfile(), \"_.tif\") ff <- makeTiles(r, x, filename) ff #> [1] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_1.tif\" #> [2] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_2.tif\" #> [3] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_3.tif\" #> [4] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa40d2d82_4.tif\"  vrt(ff) #> class       : SpatRaster  #> dimensions  : 100, 100, 1  (nrow, ncol, nlyr) #> resolution  : 3.6, 1.8  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : spat_34aa77ebb8f7_13482.vrt  #> name        : spat_34aa77ebb8f7_13482  #> min value   :                       1  #> max value   :                   10000"},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":null,"dir":"Reference","previous_headings":"","what":"Make a VRT header file — makeVRT","title":"Make a VRT header file — makeVRT","text":"Create VRT header file \"flat binary\" raster file needs header file able read , .","code":""},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make a VRT header file — makeVRT","text":"","code":"makeVRT(filename, nrow, ncol, nlyr=1, extent, xmin, ymin, xres, yres=xres, xycenter=TRUE,    crs=\"+proj=longlat\", lyrnms=\"\", datatype, NAflag=NA, bandorder=\"BIL\", byteorder=\"LSB\",    toptobottom=TRUE, offset=0, scale=1)"},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make a VRT header file — makeVRT","text":"filename character. raster filename (without \".vrt\" extension) nrow positive integer, number rows ncol positive integer, number columns nlyr positive integer, number layers extent SpatExtent missing xmin numeric. minimum x coordinate (used extent missing) ymin numeric. minimum y coordinate (used extent missing) xres positive number. x resolution yres positive number. y resolution) xycenter logical. TRUE, xmin xmax represent coordinates center extreme cell, stead coordinates outside corner. used extent missing crs character. Coordinate reference system description lyrnms character. Layer names datatype character. One \"INT2S\", \"INT4S\", \"INT1U\", \"INT2U\", \"INT4U\", \"FLT4S\", \"FLT8S\". missing, guessed file size (INT1U 1 byte per value, INT2S 2 bytes FLT4S 4 bytes per value). may wrong , example, 2 bytes per value may fact INT2U (U unsigned) values NAflag numeric. value used \"NA flag\" bandorder character. One \"BIL\", \"BIP\", \"BSQ\". Band Interleaved Line, Pixel, Band SeQuential byteorder character. One \"LSB\", \"MSB\". \"MSB\" common files generated Linux systems, whereas \"LSB\" common files generated windows toptobottom logical. FALSE, values read bottom top offset numeric. offset applied scale numeric. scale applied","code":""},{"path":"https://rspatial.github.io/terra/reference/makeVRT.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make a VRT header file — makeVRT","text":"character (.VRT filename)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":null,"dir":"Reference","previous_headings":"","what":"map.pal arrow — map.pal","title":"map.pal arrow — map.pal","text":"Get color palette mapping. palettes copied GRASS.","code":""},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"map.pal arrow — map.pal","text":"","code":"map.pal(name, n=50, ...)"},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"map.pal arrow — map.pal","text":"name character (name palette, see Details), missing (get available names) n numeric. number colors ... additional arguments passed colorRamp","code":""},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"map.pal arrow — map.pal","text":"none","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mappal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"map.pal arrow — map.pal","text":"","code":"map.pal(\"elevation\", 10) #>  [1] \"#00BFBF\" \"#00E254\" \"#1CFF00\" \"#A9FF00\" \"#FFE200\" \"#FF9B00\" \"#E97F14\" #>  [8] \"#C67F37\" \"#C39F7B\" \"#C8C8C8\"  r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) plot(r, col=map.pal(\"elevation\"))   map.pal() #>  [1] \"aspect\"      \"bcyr\"        \"bgyr\"        \"blues\"       \"byg\"         #>  [6] \"byr\"         \"curvature\"   \"differences\" \"elevation\"   \"grass\"       #> [11] \"greens\"      \"grey\"        \"gyr\"         \"haxby\"       \"inferno\"     #> [16] \"magma\"       \"oranges\"     \"plasma\"      \"rainbow\"     \"ramp\"        #> [21] \"reds\"        \"roygbiv\"     \"rstcurv\"     \"ryb\"         \"ryg\"         #> [26] \"sepia\"       \"viridis\"     \"water\"       \"wave\""},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Mask values in a SpatRaster or SpatVector — mask","title":"Mask values in a SpatRaster or SpatVector — mask","text":"x SpatRaster:  Create new SpatRaster values SpatRaster x, except cells NA (maskvalue) another SpatRaster ('mask'), cells covered SpatVector SpatExtent. cells become NA (another updatevalue). x SpatVector SpatExtent:  Select geometries x intersect, intersect, geometries y.","code":""},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mask values in a SpatRaster or SpatVector — mask","text":"","code":"# S4 method for SpatRaster,SpatRaster mask(x, mask, inverse=FALSE, maskvalues=NA,     updatevalue=NA, filename=\"\", ...)     # S4 method for SpatRaster,SpatVector mask(x, mask, inverse=FALSE, updatevalue=NA,   touches=TRUE, filename=\"\", ...)  # S4 method for SpatRaster,SpatExtent mask(x, mask, inverse=FALSE, updatevalue=NA,   touches=TRUE, filename=\"\", ...)  # S4 method for SpatVector,SpatVector mask(x, mask, inverse=FALSE)  # S4 method for SpatVector,SpatExtent mask(x, mask, inverse=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mask values in a SpatRaster or SpatVector — mask","text":"x SpatRaster SpatVector mask SpatRaster SpatVector inverse logical. TRUE, areas mask _not_ maskvalue masked maskvalues numeric. value(s) mask indicate cells x masked (change value updatevalue (default = NA)) updatevalue numeric. value masked cells become (NA) touches logical. TRUE, cells touched lines polygons masked, just line render path, whose center point within polygon filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Mask values in a SpatRaster or SpatVector — mask","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mask.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Mask values in a SpatRaster or SpatVector — mask","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) msk <- ifel(r < 400, NA, 1)  m <- mask(r, msk)  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)[1,]  mv1 <- mask(r, v) mv2 <- crop(r, v, mask=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/match.html","id":null,"dir":"Reference","previous_headings":"","what":"Value matching for SpatRasters — match","title":"Value matching for SpatRasters — match","text":"match returns SpatRaster position matched values. cell values index table argument. %% returns 0/1 (FALSE/TRUE) SpatRaster indicating cells values matched .","code":""},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Value matching for SpatRasters — match","text":"","code":"match(x, table, nomatch = NA_integer_, incomparables = NULL)  x %in% table"},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Value matching for SpatRasters — match","text":"x SpatRaster table vector values matched nomatch value returned case match found. Note coerced integer incomparables vector values matched. value x matching value vector assigned nomatch value. historical reasons, FALSE equivalent NULL","code":""},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Value matching for SpatRasters — match","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/match.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Value matching for SpatRasters — match","text":"","code":"r <- rast(nrows=10, ncols=10) values(r) <- 1:100 m <- match(r, c(5:10, 50:55)) n <- r %in% c(5:10, 50:55)"},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":null,"dir":"Reference","previous_headings":"","what":"General mathematical methods — Math-methods","title":"General mathematical methods — Math-methods","text":"Standard mathematical methods computations SpatRasters. Computations local (applied cell cell basis). multiple SpatRasters used, must extent resolution. implemented: abs, sign, sqrt, ceiling, floor, trunc,  cummax, cummin, cumprod, cumsum, log, log10, log2, log1p, acos, acosh, asin, asinh, atan, atanh, exp, expm1, cos, cosh, sin, sinh, tan, tanh, round, signif Instead directly calling methods, can also provide name math method. useful want provide output filename. following methods implemented SpatExtent: round, floor, ceiling round also implemented SpatVector, round coordinates geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"General mathematical methods — Math-methods","text":"","code":"# S4 method for SpatRaster sqrt(x)  # S4 method for SpatRaster log(x, base=exp(1))  # S4 method for SpatRaster round(x, digits=0)  # S4 method for SpatRaster math(x, fun, digits=0, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatVector round(x, digits=4)  # S4 method for SpatRaster cumsum(x)"},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"General mathematical methods — Math-methods","text":"x SpatRaster base positive complex number: base respect logarithms computed digits Number digits rounding fun character. Math function name filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"General mathematical methods — Math-methods","text":"SpatRaster SpatExtent","code":""},{"path":"https://rspatial.github.io/terra/reference/math-generics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"General mathematical methods — Math-methods","text":"","code":"r1 <- rast(ncols=10, nrows=10) v <- runif(ncell(r1)) v[10:20] <- NA values(r1) <- v r2 <- rast(r1) values(r2) <- 1:ncell(r2) / ncell(r2) r <- c(r1, r2)  s <- sqrt(r) # same as  math(r, \"sqrt\") #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :     lyr.1, lyr.1  #> min values  : 0.1074500,   0.1  #> max values  : 0.9975409,   1.0   round(s, 1) #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.1  #> min values  :   0.1,   0.1  #> max values  :   1.0,   1.0   cumsum(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :     lyr.1,      lyr.1  #> min values  : 0.0115455, 0.07105275  #> max values  : 0.9950879, 1.90387150"},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":null,"dir":"Reference","previous_headings":"","what":"Memory available and needed — mem","title":"Memory available and needed — mem","text":"mem_info prints amount RAM required available process SpatRaster. free_RAM returns amount RAM available","code":""},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Memory available and needed — mem","text":"","code":"mem_info(x, n=1)  free_RAM()"},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Memory available and needed — mem","text":"x SpatRaster n positive integer. number copies x needed","code":""},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Memory available and needed — mem","text":"free_RAM returns amount available RAM kilobytes","code":""},{"path":"https://rspatial.github.io/terra/reference/mem.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Memory available and needed — mem","text":"","code":"mem_info(rast()) #>  #> ------------------------ #> Memory (GB)  #> ------------------------ #> check threshold : 1 (memmin) #> available       : 3.18 #> allowed (60%)   : 1.91 #> needed (n=1)    : 0 #> ------------------------ #> proc in memory  : TRUE #> nr chunks       : 1 #> ------------------------  free_RAM() #> [1] 3337328"},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"Merge multiple SpatRasters create new SpatRaster larger spatial extent. SpatRasters must origin spatial resolution. areas SpatRasters overlap, values SpatRaster first sequence arguments (SpatRasterCollection) retained (unless first=FALSE). Cells NA ignored unless na.rm=FALSE also method merging SpatVector data.frame; , join data.frame attribute table SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"","code":"# S4 method for SpatRaster,SpatRaster merge(x, y, ..., first=TRUE, na.rm=TRUE, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterCollection,missing merge(x, first=TRUE, na.rm=TRUE, filename=\"\", ...)  # S4 method for SpatVector,data.frame merge(x, y, ...)"},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"x SpatRaster, SpatRasterCollection, SpatVector y missing x SpatRasterCollection. SpatRaster x SpatRaster. data.frame x SpatVector ... x SpatRaster: additional objects class x. x SpatRasterCollection: options writing files writeRaster. x SpatVector, arguments merge first logical. TRUE, areas rasters overlap, first value used. Otherwise last value used na.rm logical. TRUE values NA ignored filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"SpatRaster SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/merge.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Merge SpatRasters, or merge a SpatVector with a data.frame — merge","text":"","code":"x <- rast(xmin=-110, xmax=-80, ymin=40, ymax=70, res=1, vals=1) y <- rast(xmin=-85, xmax=-55, ymax=60, ymin=30, res=1, vals=2) z <- rast(xmin=-60, xmax=-30, ymax=50, ymin=20, res=1, vals=3)  m1 <- merge(x, y, z) m2 <- merge(z, y, x) m3 <- merge(y, x, z)  # if you have many SpatRasters, it may be convenient # to make a SpatRasterCollection rlist <- list(x, y, z) rsrc <- sprc(rlist)  m <- merge(rsrc)   ## SpatVector with data.frame f <- system.file(\"ex/lux.shp\", package=\"terra\") p <- vect(f) dfr <- data.frame(District=p$NAME_1, Canton=p$NAME_2, Value=round(runif(length(p), 100, 1000))) dfr <- dfr[1:5, ] pm <- merge(p, dfr, all.x=TRUE, by.x=c('NAME_1', 'NAME_2'), by.y=c('District', 'Canton')) pm #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 7  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2  ID_1  ID_2  AREA   POP Value #>  type        :    <chr>    <chr> <num> <num> <num> <int> <num> #>  values      : Diekirch Clervaux     1     1   312 18081   433 #>                Diekirch Diekirch     1     2   218 32543   961 #>                Diekirch  Redange     1     3   259 18664   922 values(pm) #>          NAME_1           NAME_2 ID_1 ID_2 AREA    POP Value #> 1      Diekirch         Clervaux    1    1  312  18081   433 #> 2      Diekirch         Diekirch    1    2  218  32543   961 #> 3      Diekirch          Redange    1    3  259  18664   922 #> 4      Diekirch          Vianden    1    4   76   5163   841 #> 5      Diekirch            Wiltz    1    5  263  16735   388 #> 6  Grevenmacher       Echternach    2    6  188  18899    NA #> 7  Grevenmacher           Remich    2    7  129  22366    NA #> 8  Grevenmacher     Grevenmacher    2   12  210  29828    NA #> 9    Luxembourg         Capellen    3    8  185  48187    NA #> 10   Luxembourg Esch-sur-Alzette    3    9  251 176820    NA #> 11   Luxembourg       Luxembourg    3   10  237 182607    NA #> 12   Luxembourg           Mersch    3   11  233  32112    NA"},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":null,"dir":"Reference","previous_headings":"","what":"merge SpatRasters by timelines to create a single timeseries — mergeTime","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"Combine SpatRasters partly overlapping time-stamps create single time series. overlap SpatRasters point using function (use c instead). Also note time gaps filled. can use fillTime .","code":""},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"","code":"# S4 method for SpatRasterDataset mergeTime(x, fun=mean, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"x SpatRasterDataset fun function reduces vector single number, mean min filename character. Output filename ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mergeTime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"merge SpatRasters by timelines to create a single timeseries — mergeTime","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s1 <- c(r, r) time(s1) <- as.Date(\"2001-01-01\") + 0:5 s1 <- s1/10 time(s1) <- as.Date(\"2001-01-07\") + 0:5 s2 <- s1*10 time(s2) <- as.Date(\"2001-01-05\") + 0:5 x <- sds(s1, s1, s2)  m <- mergeTime(x, mean)"},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":null,"dir":"Reference","previous_headings":"","what":"meta — meta","title":"meta — meta","text":"Get metadata associated sources layers SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"meta — meta","text":"","code":"# S4 method for SpatRaster meta(x, layers=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"meta — meta","text":"x SpatRaster layers logical. layer level metadata returned?","code":""},{"path":"https://rspatial.github.io/terra/reference/meta.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"meta — meta","text":"list","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":null,"dir":"Reference","previous_headings":"","what":"Set or get metadata — metags","title":"Set or get metadata — metags","text":"can set arbitrary metadata SpatRaster using \"name=value\" tags.","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set or get metadata — metags","text":"","code":"# S4 method for SpatRaster metags(x, layer=NULL)<-value  # S4 method for SpatRaster metags(x, layer=NULL, name=NULL)"},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set or get metadata — metags","text":"x SpatRaster layer NULL positive integer. value NULL, tags assigned returned SpatRaster. Otherwise layer number(s) name character value character \"name=value\" two-column matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set or get metadata — metags","text":"SpatRaster (metags<-), named character (metags)","code":""},{"path":"https://rspatial.github.io/terra/reference/metags.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set or get metadata — metags","text":"","code":"r <- rast(ncol=5, nrow=5) m <- cbind(c(\"one\", \"two\", \"three\"), c(\"ABC\", \"123\", \"hello\")) metags(r) <- m metags(r) #>     one   three     two  #>   \"ABC\" \"hello\"   \"123\"   metags(r) <- c(\"another_tag=another_value\", \"one more=this value\") metags(r) #>     another_tag             one        one more           three             two  #> \"another_value\"           \"ABC\"    \"this value\"         \"hello\"           \"123\"   metags(r) <- c(another_tag=\"44\", `one more`=\"that value\") metags(r) #>  another_tag          one     one more        three          two  #>         \"44\"        \"ABC\" \"that value\"      \"hello\"        \"123\"    metags(r, name=\"two\") #>   two  #> \"123\"   # remove a tag metags(r) <- cbind(\"one\", \"\") metags(r) <- \"two=\" metags(r) #>  another_tag     one more        three  #>         \"44\" \"that value\"      \"hello\"   # remove all metags metags(r) <- NULL metags(r) #> named character(0)"},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":null,"dir":"Reference","previous_headings":"","what":"Get or compute the minimum and maximum cell values — extremes","title":"Get or compute the minimum and maximum cell values — extremes","text":"minimum maximum value SpatRaster returned computed (file disk necessary) stored object.","code":""},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get or compute the minimum and maximum cell values — extremes","text":"","code":"# S4 method for SpatRaster minmax(x, compute=FALSE) # S4 method for SpatRaster hasMinMax(x) # S4 method for SpatRaster setMinMax(x, force=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get or compute the minimum and maximum cell values — extremes","text":"x SpatRaster compute logical. TRUE min max values computed available force logical. TRUE min max values recomputed even already available","code":""},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get or compute the minimum and maximum cell values — extremes","text":"minmax: numeric matrix minimum maximum cell values layer hasMinMax: logical indicating whether min max values available. setMinMax: nothing. Used side-effect computing minimum maximum values SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/minmax.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get or compute the minimum and maximum cell values — extremes","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) minmax(r) #>     elevation #> min       141 #> max       547"},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":null,"dir":"Reference","previous_headings":"","what":"modal value — modal","title":"modal value — modal","text":"Compute mode cell across layers SpatRaster. mode, modal value, frequent value set values.","code":""},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"modal value — modal","text":"","code":"# S4 method for SpatRaster modal(x, ..., ties=\"first\", na.rm=FALSE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"modal value — modal","text":"x SpatRaster ... additional argument type x numeric ties character. Indicates treat ties. Either \"random\", \"lowest\", \"highest\", \"first\", \"NA\" na.rm logical. TRUE, NA values ignored. FALSE, NA returned x NA values filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"modal value — modal","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/modal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"modal value — modal","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    r <- c(r/2, r, r*2) m <- modal(r)"},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":null,"dir":"Reference","previous_headings":"","what":"mosaic SpatRasters — mosaic","title":"mosaic SpatRasters — mosaic","text":"Combine adjacent (partly) overlapping SpatRasters form single new SpatRaster. Values overlapping cells averaged (default) can computed another function. SpatRasters must origin spatial resolution. method similar simpler, much faster, merge method.","code":""},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"mosaic SpatRasters — mosaic","text":"","code":"# S4 method for SpatRaster,SpatRaster mosaic(x, y, ..., fun=\"mean\", filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterCollection,missing mosaic(x, fun=\"mean\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"mosaic SpatRasters — mosaic","text":"x SpatRaster y object class x ... additional SpatRasters fun character. One \"mean\", \"median\", \"min\", \"max\", \"modal\", \"sum\", \"first\", \"last\" filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"mosaic SpatRasters — mosaic","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/mosaic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"mosaic SpatRasters — mosaic","text":"","code":"x <- rast(xmin=-110, xmax=-60, ymin=40, ymax=70, res=1, vals=1) y <- rast(xmin=-95, xmax=-45, ymax=60, ymin=30, res=1, vals=2) z <- rast(xmin=-80, xmax=-30, ymax=50, ymin=20, res=1, vals=3)  m1 <- mosaic(x, y, z)  m2 <- mosaic(z, y, x)  # with many SpatRasters, make a SpatRasterCollection from a list rlist <- list(x, y, z) rsrc <- sprc(rlist)  m <- mosaic(rsrc)"},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":null,"dir":"Reference","previous_headings":"","what":"Find and remove geometries that are NA — na.omit","title":"Find and remove geometries that are NA — na.omit","text":"Find geometries NA; remove geometries /records NA.","code":""},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find and remove geometries that are NA — na.omit","text":"","code":"# S4 method for SpatVector is.na(x)  # S4 method for SpatVector na.omit(object, field=NA, geom=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find and remove geometries that are NA — na.omit","text":"x SpatVector object SpatVector field character NA. NA, missing values attributes ignored. values either one field (variable) names, \"\" consider fields geom logical. TRUE empty geometries removed","code":""},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find and remove geometries that are NA — na.omit","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/na.omit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Find and remove geometries that are NA — na.omit","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$test <- c(1,2,NA) nrow(v) #> [1] 12 x <- na.omit(v, \"test\") nrow(x) #> [1] 8"},{"path":"https://rspatial.github.io/terra/reference/names.html","id":null,"dir":"Reference","previous_headings":"","what":"Names of Spat* objects — names","title":"Names of Spat* objects — names","text":"Get set names layers SpatRaster attributes SpatVector. See set.names -place setting names.","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Names of Spat* objects — names","text":"","code":"# S4 method for SpatRaster names(x)  # S4 method for SpatRaster names(x)<-value  # S4 method for SpatRasterDataset names(x)  # S4 method for SpatRasterDataset names(x)<-value  # S4 method for SpatVector names(x)  # S4 method for SpatVector names(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Names of Spat* objects — names","text":"x SpatRaster, SpatRasterDataset, SpatVector value character (vector)","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Names of Spat* objects — names","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Names of Spat* objects — names","text":"terra enforces neither unique valid names. See make.unique create unique names make.names make syntactically valid names.","code":""},{"path":"https://rspatial.github.io/terra/reference/names.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Names of Spat* objects — names","text":"","code":"s <- rast(ncols=5, nrows=5, nlyrs=3) nlyr(s) #> [1] 3 names(s) #> [1] \"lyr.1\" \"lyr.2\" \"lyr.3\" names(s) <- c(\"a\", \"b\", \"c\") names(s) #> [1] \"a\" \"b\" \"c\"  # SpatVector names f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) names(v) #> [1] \"ID_1\"   \"NAME_1\" \"ID_2\"   \"NAME_2\" \"AREA\"   \"POP\"    names(v) <- paste0(substr(names(v), 1, 2), \"_\", 1:ncol(v)) names(v) #> [1] \"ID_1\" \"NA_2\" \"ID_3\" \"NA_4\" \"AR_5\" \"PO_6\""},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":null,"dir":"Reference","previous_headings":"","what":"nearby geometries — nearest","title":"nearby geometries — nearest","text":"Identify geometries near . Either get index geometries within certain distance, k nearest neighbors, (nearest) get nearest points two geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"nearby geometries — nearest","text":"","code":"# S4 method for SpatVector nearby(x, y=NULL, distance=0, k=1, centroids=TRUE, symmetrical=TRUE)  # S4 method for SpatVector nearest(x, y, pairs=FALSE, centroids=TRUE, lines=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"nearby geometries — nearest","text":"x SpatVector y SpatVector NULL distance numeric. maximum distance k positive integer. number neighbors. Ignored distance > 0 centroids logical. centroids polygons used? symmetrical logical. TRUE, near pair included . , geometry 1 near geometry 3, implied nearness 3 1 reported. Ignored k neighbors returned pairs logical. TRUE pairwise nearest points returned (relevant using least one SpatVector lines polygons lines logical. TRUE lines nearest points instead (nearest) points","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"nearby geometries — nearest","text":"matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/nearby.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"nearby geometries — nearest","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) nearby(v, distance=12000) #>      from to #> [1,]    2  4 #> [2,]    6  8"},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":null,"dir":"Reference","previous_headings":"","what":"normalize vector data that crosses the dateline — normalize.longitude","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"Normalize longitude geometries, move outside -180 180 degrees range.","code":""},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"","code":"# S4 method for SpatVector normalize.longitude(x)"},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/normalize.longitude.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"normalize vector data that crosses the dateline — normalize.longitude","text":"","code":"p <- vect(\"POLYGON ((120 10, 230 75, 230 -75, 120 10))\") normalize.longitude(p) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 1, 0  (geometries, attributes) #>  extent      : -180, 180, -75, 75  (xmin, xmax, ymin, ymax) #>  coord. ref. :"},{"path":"https://rspatial.github.io/terra/reference/north.html","id":null,"dir":"Reference","previous_headings":"","what":"North arrow — north","title":"North arrow — north","text":"Add (North) arrow map","code":""},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"North arrow — north","text":"","code":"north(xy=NULL, type=1, label=\"N\", angle=0, d, head=0.1, xpd=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"North arrow — north","text":"xy numeric. x y coordinate place arrow. can also one following character values: \"bottomleft\", \"bottom\", \"bottomright\", topleft\", \"top\", \"topright\", \"left\", \"right\", NULL type integer 1 12, character (unicode) representation right pointing arrow \"\\u27A9\" label character, printed near arrow angle numeric. angle arrow degrees d numeric. Distance covered arrow plot coordinates. applies type=1 head numeric. size arrow \"head\", type=1 xpd logical. TRUE, scale bar arrow can outside plot area ... graphical arguments passed methods","code":""},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"North arrow — north","text":"none","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/north.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"North arrow — north","text":"","code":"f <- system.file(\"ex/meuse.tif\", package=\"terra\") r <- rast(f) plot(r) north() north(c(178550, 332500), d=250)   if (FALSE) { f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) plot(r, type=\"interval\") sbar(15, c(6.3, 50), type=\"bar\", below=\"km\", label=c(0,7.5,15), cex=.8) north(type=3, cex=.8) north(xy=c(6.7, 49.9), type=2, angle=45, label=\"NE\") north(xy=c(6.6, 49.7), type=5, cex=1.25) north(xy=c(5.5, 49.6), type=9) north(d=.05, xy=c(5.5, 50), angle=180, label=\"S\", lwd=2, col=\"blue\")   ## all arrows r <- rast(res=10) values(r) <- 1 plot(r, col=\"white\", axes=FALSE, legend=FALSE, mar=c(0,0,0,0), reset=TRUE) for (i in 1:12) {   x = -200+i*30   north(xy=cbind(x,30), type=i)   text(x, -20, i, xpd=TRUE) }  }"},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":null,"dir":"Reference","previous_headings":"","what":"is not NA — not.na","title":"is not NA — not.na","text":"Shortcut method avoid two-step !.na(x)","code":""},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"is not NA — not.na","text":"","code":"# S4 method for SpatRaster not.na(x, falseNA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"is not NA — not.na","text":"x SpatRaster falseNA logical. result TRUE, NA instead TRUE, FALSE? filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"is not NA — not.na","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/not.na.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"is not NA — not.na","text":"","code":"r <- rast(ncols=10, nrows=10, vals=1) r[10:20] <- NA x <- not.na(r)"},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":null,"dir":"Reference","previous_headings":"","what":"Origin — origin","title":"Origin — origin","text":"Get set coordinates point origin SpatRaster. point closest (0, 0) get moved towards point steps x y resolution.","code":""},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Origin — origin","text":"","code":"# S4 method for SpatRaster origin(x)  # S4 method for SpatRaster origin(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Origin — origin","text":"x SpatRaster value numeric vector length 1 2","code":""},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Origin — origin","text":"vector two numbers (x y coordinates)","code":""},{"path":"https://rspatial.github.io/terra/reference/origin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Origin — origin","text":"","code":"r <- rast(xmin=-0.5, xmax = 9.5, ncols=10) origin(r) #> [1] 0.5 0.0 origin(r) <- c(0,0) r #> class       : SpatRaster  #> dimensions  : 180, 10, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 10, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)"},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":null,"dir":"Reference","previous_headings":"","what":"Pairs plot (matrix of scatterplots) — pairs","title":"Pairs plot (matrix of scatterplots) — pairs","text":"Pair plots layers SpatRaster. wrapper around graphics function pairs.","code":""},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Pairs plot (matrix of scatterplots) — pairs","text":"","code":"# S4 method for SpatRaster pairs(x, hist=TRUE, cor=TRUE, use=\"pairwise.complete.obs\", maxcells=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Pairs plot (matrix of scatterplots) — pairs","text":"x SpatRaster hist logical. TRUE histogram values shown diagonal cor logical. TRUE correlation coefficient shown upper panels use argument passed cor function maxcells integer. Number pixels sample layer large SpatRaster ... additional arguments (graphical parameters)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/pairs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Pairs plot (matrix of scatterplots) — pairs","text":"","code":"r <-rast(system.file(\"ex/elev.tif\", package=\"terra\")) s <- c(r, 1/r, sqrt(r)) names(s) <- c(\"elevation\", \"inverse\", \"sqrt\")  pairs(s)   # to make indvidual histograms: hist(r)  # or scatter plots: plot(s[[1]], s[[2]])"},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":null,"dir":"Reference","previous_headings":"","what":"Map panel — panel","title":"Map panel — panel","text":"Show multiple maps share single legend.","code":""},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Map panel — panel","text":"","code":"# S4 method for SpatRaster panel(x, main, loc.main=\"topleft\", nc, nr, maxnl=16,    maxcell=500000, box=FALSE, pax=list(), plg=list(), range=NULL, ...)"},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Map panel — panel","text":"x SpatRaster main character. Main plot titles (one layer plotted). can use arguments cex.main, font.main, col.main change appearance loc.main numeric character set location main title. Either two coordinates, character value \"topleft\") nc positive integer. Optional. number columns divide plotting device (plotting multiple layers) nr positive integer. Optional. number rows divide plotting device (plotting multiple layers) maxnl positive integer. Maximum number layers plot (multi-layer object) maxcell positive integer. Maximum number cells use plot box logical. box drawn around map? plg see plot pax see plot range numeric. minimum maximum values used continuous legend ... arguments passed plot(\"SpatRaster\", \"numeric\") additional graphical arguments","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/panel.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Map panel — panel","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) x <- c(r, r/2, r*2, r) names(x) <- paste0(\"(\", LETTERS[1:4], \")\") panel(x)  panel(x, fun=\\()lines(v), loc.main=\"topright\")"},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":null,"dir":"Reference","previous_headings":"","what":"Detect patches (clumps) of cells — patches","title":"Detect patches (clumps) of cells — patches","text":"Detect patches (clumps). Patches groups cells surrounded cells NA. Set zeroAsNA TRUE also identify patches separated cells values zero.","code":""},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Detect patches (clumps) of cells — patches","text":"","code":"# S4 method for SpatRaster patches(x, directions=4, zeroAsNA=FALSE, allowGaps=TRUE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Detect patches (clumps) of cells — patches","text":"x SpatRaster directions integer indicating cells considered adjacent. 8 (Queen's case) 4 (Rook's case) zeroAsNA logical. TRUE treat cells zero NA allowGaps logical. TRUE may gaps patch IDs (e.g. may patch IDs 1, 2, 3 5, 4). FALSE, numbers recoded 1 number patches (4 example) filename character. Output filename ... options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Detect patches (clumps) of cells — patches","text":"SpatRaster. Cell values patch numbers","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/patches.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Detect patches (clumps) of cells — patches","text":"","code":"r <- rast(nrows=18, ncols=36, xmin=0) r[1:2, 5:8] <- 1 r[5:8, 2:6] <- 1 r[7:12, 22:36] <- 1 r[15:16, 18:29] <- 1 p <- patches(r)  # zero as background instead of NA r <- rast(nrows=10, ncols=10, xmin=0, vals=0) r[3, 3] <- 10 r[4, 4] <- 10 r[5, 5:8] <- 12 r[6, 6:9] <- 12  # treat zeros as NA  p4 <- patches(r, zeroAsNA=TRUE) p8 <- patches(r, 8, zeroAsNA=TRUE)  ### patches for different values # remove zeros manually rr <- classify(r, cbind(0, NA))  # make layers for each value s <- segregate(rr, keep=TRUE, other=NA) p <- patches(s)   ### patch ID values are not guaranteed to be consecutive r <- rast(nrows=5, ncols=10, xmin=0) set.seed(0) values(r)<- round(runif(ncell(r))*0.7) rp <- patches(r, directions=8, zeroAsNA=TRUE)  plot(rp, type=\"classes\"); text(rp)   ## unless you set allowGaps=FALSE rp <- patches(r, directions=8, zeroAsNA=TRUE, allowGaps=FALSE)  plot(rp, type=\"classes\"); text(rp)   ### use zonal to remove small patches  f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- classify(r, cbind(-Inf, 400, NA)) y <- patches(x) # remove patches smaller than 100 ha rz <- zonal(cellSize(y, unit=\"ha\"), y, sum, as.raster=TRUE) s <- ifel(rz < 250, NA, y)"},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":null,"dir":"Reference","previous_headings":"","what":"Perimeter or length — perim","title":"Perimeter or length — perim","text":"method returns length lines perimeter polygons. crs longitude/latitude, may get accurate results first unprojecting SpatVector (can use project transform crs longitude/latitude)","code":""},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Perimeter or length — perim","text":"","code":"# S4 method for SpatVector perim(x)"},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Perimeter or length — perim","text":"x SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Perimeter or length — perim","text":"numeric (m)","code":""},{"path":"https://rspatial.github.io/terra/reference/perim.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Perimeter or length — perim","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) perim(v) #>  [1] 117100.12  93477.28  84502.45  44919.14  85032.61  74708.05  57991.42 #>  [8]  81203.93  74443.82  95564.74  80618.76  70810.67"},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":null,"dir":"Reference","previous_headings":"","what":"Perspective plot — persp","title":"Perspective plot — persp","text":"Perspective plot SpatRaster. implementation generic function graphics package.","code":""},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Perspective plot — persp","text":"","code":"# S4 method for SpatRaster persp(x, maxcells=100000, ...)"},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Perspective plot — persp","text":"x SpatRaster. first layer used maxcells integer > 0. Maximum number cells use plot. maxpixels < ncell(x), spatSample(method=\"regular\") used plotting ... argument can passed persp (graphics package)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/persp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Perspective plot — persp","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) persp(r)"},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot with leaflet — plet","title":"Plot with leaflet — plet","text":"Plot values SpatRaster SpatVector make interactive leaflet map displayed browser.","code":""},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot with leaflet — plet","text":"","code":"# S4 method for SpatRaster plet(x, y=1, col, alpha=0.8, main=names(x),    tiles=c(\"Streets\", \"Esri.WorldImagery\", \"OpenTopoMap\"),    wrap=TRUE, maxcell=500000, legend=\"bottomright\",    shared=FALSE, panel=FALSE, collapse=TRUE, map=NULL)    # S4 method for SpatVector plet(x, y=\"\", col,fill=0.2, main=y, cex=1, lwd=2,    border=\"black\", alpha=1, popup=TRUE, label=FALSE, split=FALSE,   tiles=c(\"Streets\", \"Esri.WorldImagery\", \"OpenTopoMap\"),    wrap=TRUE, legend=\"bottomright\", collapse=FALSE, type=NULL, breaks=NULL,   breakby=\"eqint\", sort=TRUE, decreasing=FALSE, map=NULL, ...)   # S4 method for SpatVectorCollection plet(x, col, fill=0, cex=1, lwd=2, border=\"black\", alpha=1, popup=TRUE,     label=FALSE, tiles=c(\"Streets\", \"Esri.WorldImagery\", \"OpenTopoMap\"), wrap=TRUE,    legend=\"bottomright\", collapse=FALSE, map=NULL)   # S4 method for leaflet lines(x, y, col, lwd=2, alpha=1, ...)  # S4 method for leaflet points(x, y, col, cex=1, alpha=1, popup=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot with leaflet — plet","text":"x SpatRaster, SpatVector, leaflet object y missing, positive integer, character (variable layer name) indicating layer(s) plotted. x SpatRater, can select multiple layers col character. Vector colors color generating function alpha Number 0 1 set transparency lines (0 transparent, 1 opaque) fill Number 0 1 set transparency polygon areas (0 transparent, 1 opaque) tiles character NULL. Names background tile providers wrap logical. TRUE, tiles wrap around maxcell positive integer. Maximum number cells use plot legend character indicate legend position (\"bottomleft\", \"bottomright\", \"topleft\" \"topright\") NULL suppress legend main character. Title legend. length 1 x SpatVector length nlyr(x) x SpatVector shared logical. legend rasters (multiple layers SpatRaster x mapped) map leaflet object ... additional arguments drawing points, lines, polygons passed relevant leaflet function border character. Color polygon borders collapse logical. layers \"control\" panel collapsed? split logical. TRUE check-box created toggle value y (x SpatVector) cex numeric. point size magnifier. See par lwd numeric, line-width. See par popup logical. pop-ups created? label logical. mouse-labels added? panel logical. SpatRaster layers shown panel\" type character. Type map/legend. One \"classes\", \"interval\". specified, type chosen based data. Use \"\" suppress legend breaks numeric. Either single number indicate number breaks desired, actual breaks. providing argument, default legend becomes \"interval\" breakby character function. Either \"eqint\" equal interval breaks, \"cases\" equal quantile breaks. function supplied take single argument (vector values) create groups sort logical. TRUE legends character values sorted. can also supply vector unique values, order want appear legend decreasing logical. TRUE, legends sorted decreasing order","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plet.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot with leaflet — plet","text":"","code":"if (FALSE) { if (require(leaflet) && (packageVersion(\"leaflet\") > \"2.1.1\")) {  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) p <- spatSample(as.polygons(v, ext=T), 30) values(p) = data.frame(id=11:40, name=letters[1:30])  m <- plet(v, \"NAME_1\", tiles=\"\", border=\"blue\") m <- points(m, p, col=\"red\", cex=2, popup=T) lines(m, v, lwd=1, col=\"white\")  plet(v, \"NAME_1\", split=TRUE, alpha=.2) |>    points(p, col=\"gray\", cex=2, popup=TRUE,     clusterOptions = markerClusterOptions())  s <- svc(v, p) names(s) <- c(\"the polys\", \"set of points\") plet(s, col=c(\"red\", \"blue\"), lwd=1)   r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) plet(r, main=\"Hi\\nthere\", tiles=NULL) |> lines(v, lwd=1)  plet(r, tiles=\"OpenTopoMap\") |> lines(v, lwd=2, col=\"blue\")  x <- c(r, 50*classify(r, 5)) names(x) <- c(\"first\", \"second\")  # each their own legend plet(x, 1:2, collapse=FALSE) |> lines(v, lwd=2, col=\"blue\")  # shared legend plet(x, 1:2, shared=TRUE, collapse=FALSE) |> lines(v, lwd=2, col=\"blue\")  }}"},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Make a map — plot","title":"Make a map — plot","text":"Plot values SpatRaster SpatVector make map. See points, lines polys add SpatVector existing map (use argument add=TRUE). separate help file plotting SpatGraticule SpatExtent.","code":""},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make a map — plot","text":"","code":"# S4 method for SpatRaster,numeric plot(x, y=1, col, type=NULL, mar=NULL, legend=TRUE, axes=!add, plg=list(), pax=list(),      maxcell=500000, smooth=FALSE, range=NULL, levels=NULL, all_levels=FALSE,   breaks=NULL, breakby=\"eqint\", fun=NULL, colNA=NULL, alpha=NULL, sort=FALSE,    decreasing=FALSE, grid=FALSE, ext=NULL, reset=FALSE, add=FALSE, buffer=FALSE,    background=NULL, box=axes, clip=TRUE, ...)  # S4 method for SpatRaster,missing plot(x, y, main, mar=NULL, nc, nr, maxnl=16, maxcell=500000, add=FALSE, ...)  # S4 method for SpatRaster,character plot(x, y, ...)  # S4 method for SpatVector,character plot(x, y, col=NULL, type=NULL, mar=NULL, add=FALSE, legend=TRUE, axes=!add,      main=\"\", buffer=TRUE, background=NULL, grid=FALSE, ext=NULL, sort=TRUE,    decreasing=FALSE, plg=list(), pax=list(), nr, nc, colNA=NA, alpha=NULL,    box=axes, clip=TRUE, ...)  # S4 method for SpatVector,numeric plot(x, y, ...)  # S4 method for SpatVector,missing plot(x, y, values=NULL, ...)"},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make a map — plot","text":"x SpatRaster SpatVector y missing positive integer name indicating layer(s) plotted col character vector specify colors use. default map.pal(\"viridis\", 100). default can changed terra.pal option. example: options(terra.pal=terrain.colors(10)). x SpatRaster, can also data.frame two columns (value, color) get \"classes\" type legend three columns (, , color) get \"interval\" type legend type character. Type map/legend. One \"continuous\", \"classes\", \"interval\". specified, type chosen based data mar numeric vector length 4 set margins plot (make space legend). default (3.1, 3.1, 2.1, 7.1) single plot legend (3.1, 3.1, 2.1, 2.1) otherwise. default RGB raster 0. Use mar=NA set margins legend logical character. FALSE legend drawn. character value can used indicate legend drawn. example \"topright\" \"bottomleft\". Use plg refined placement. supported continuous legends (default raster data) axes logical. Draw axes? buffer logical. TRUE plotting area made slightly larger extent x background background color. Default color (white) box logical. box drawn around map? clip logical. axes clipped extent x? plg list parameters drawing legend. classes interval type legend see arguments legend. example x y can used place legend. can also use keywords \"topleft\" \"bottomright\" place legend locations inside map rectangle. apply continuous legend, behave little differently. example, placement keywords \"left\", \"right\", \"top\", \"bottom\" recognized; using keywords, legend placed outside map rectangle. Additional parameters continuous legends include:  digits set number digits print decimal point. size change height /width; defaults c(1,1), negative values size flip order legend. set location tic-marks tic One partially matched values: \"\", \"\", \"\", \"none\", choose tic-mark placement/length different default \"\".  pax list parameters drawing axes. See arguments axis. Arguments side, tick lab can used indicate four axes draw line (side), tick-mark, /tick-mark labels. default c(1:4) side 1:2 two. side changed two default value. Logical argument retro can used use sexagesimal notation labels (degrees/minutes/hemisphere) instead standard decimal notation maxcell positive integer. Maximum number cells use plot smooth logical. TRUE cell values smoothed (continuous legend used) range numeric. minimum maximum values used continuous legend levels character. labels legend type=\"classes\" all_levels logical. TRUE, legend shows levels categorical raster, even present data breaks numeric. Either single number indicate number breaks desired, actual breaks. providing argument, default legend becomes \"interval\" breakby character function. Either \"eqint\" equal interval breaks, \"cases\" equal quantile breaks. function supplied, take single argument (vector values) create groups fun function called plotting SpatRaster layer add something map (text, legend, lines). example, SpatVector v, fun=function() lines(v). function may one argument, representing layer plotted (1 number layers) colNA character. color NA values alpha Either single numeric 0 1 set transparency colors (0 transparent, 1 opaque) SpatRaster values 0 1 set transparency cell. set transparency given color, set colors directly sort logical. TRUE legends categorical values sorted. x SpatVector can also supply vector unique values, order want appear legend decreasing logical. TRUE, legends sorted decreasing order grid logical. TRUE grid lines drawn. properties type color can set pax argument nc positive integer. Optional. number columns divide plotting device (plotting multiple layers) nr positive integer. Optional. number rows divide plotting device (plotting multiple layers) main character. Main plot titles (one layer plotted). can use arguments cex.main, font.main, col.main change appearance; loc.main change location main title (either two coordinates, character value \"topleft\") maxnl positive integer. Maximum number layers plot (multi-layer object) add logical. TRUE add object current plot ext SpatExtent. Can use instead xlim ylim set extent plot reset logical. TRUE add margins (see argument mar) reset calling plot; may affect display additional objects added map (e.g.  lines) values Either vector values used plotting two-column data.frame, first column matches variable x second column values plotted ... arguments passed plot(\"SpatRaster\", \"numeric\") additional graphical arguments","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make a map — plot","text":"","code":"## SpatRaster f <- system.file(\"ex/elev.tif\", package=\"terra\")  r <- rast(f) plot(r)   plot(r, type=\"interval\")   e <- c(6.37, 6.41, 49.9, 50.1) plot(r, plg=list(ext=e, title=\"Legend\\nTitle\", title.cex=0.9),      pax=list(side=1:4, retro=TRUE)) north(cbind(5.8, 50.1))     d <- classify(r, c(100,200,300,400,500,600)) plot(d, type=\"classes\")   plot(d, type=\"interval\", breaks=1:5)   plot(d, type=\"interval\", breaks=c(1,4,5), plg=list(legend=c(\"1-4\", \"4-5\")))   plot(d, type=\"classes\", xlim=c(5.6, 6.6),    plg=list(legend=c(\"Mr\", \"Xx\", \"As\", \"Zx\", \"Bb\"), x=\"bottomleft\"))    x <- trunc(r/200) levels(x) <- data.frame(id=0:2, element=c(\"earth\", \"wind\", \"fire\")) plot(x, plg=list(x=\"topright\"),mar=c(2,2,2,2))   oldpar <- par(no.readonly=TRUE)  # two plots with the same legend dev.new(width=6, height=4, noRStudioGD = TRUE) par(mfrow=c(1,2)) plot(r, range=c(50,600), mar=c(1,1,1,4)) plot(r/2, range=c(50,600), mar=c(1,1,1,4))  # as we only need one legend: par(mfrow=c(1,2)) plot(r, range=c(50,600), mar=c(2, 2, 2, 2), plg=list(size=0.9, cex=.8),    pax=list(side=1:2, cex.axis=.6), box=FALSE) #text(182500, 335000, \"Two maps, one plot\", xpd=NA) plot(r/2, range=c(50,600), mar=c(2, 2, 2, 2), legend=FALSE,    pax=list(side=c(1,4), cex.axis=.6), box=FALSE)  par(oldpar)  # multi-layer with RGB s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  plot(s) # remove RGB plot(s*1) # or use layers plot(s, 1) plot(s, 1:3)  # fix legend by linking values and colors  x = rast(nrows = 2, ncols = 2, vals=1) y = rast(nrows = 2, ncols = 2, vals=c(1,2,2,1)) cols = data.frame(id=1:2, col=c(\"red\", \"blue\")) plot(c(x,y), col=cols)  r  = rast(nrows=10, ncols=10, vals=1:100) dr = data.frame(from=c(5,33,66,150), to=c(33, 66, 95,200), col=rainbow(4)) plot(r, col=dr)  ### SpatVector   f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  plot(v)  plot(v, \"NAME_2\", col=rainbow(12), border=c(\"gray\", \"blue\"), lwd=3)  plot(v, 2, pax=list(side=1:2), plg=list(x=6.16, y=50.17, cex=.8), xlim=c(5.7, 6.7))  plot(v, 4, pax=list(side=1:2), plg=list(x=6.2, y=50.2, ncol=2), main=\"\", box=FALSE)   plot(v, 1, plg=list(x=5.8, y=49.37, horiz=TRUE, cex=1.1), main=\"\", mar=c(5,2,0.5,0.5))  plot(v, density=1:12, angle=seq(18, 360, 20), col=rainbow(12))   plot(v, \"AREA\", type=\"interval\", breaks=3, mar=c(3.1, 3.1, 2.1, 3.1),   plg=list(x=\"topright\"), main=\"\")  plot(v, \"AREA\", type=\"interval\", breaks=c(0,200,250,350),    mar=c(2,2,2,2), xlim=c(5.7, 6.75),   plg=list(legend=c(\"<200\", \"200-250\", \">250\"), cex=1, bty=\"o\",    x=6.3, y=50.15, box.lwd=2, bg=\"light yellow\", title=\"My legend\"))"},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":null,"dir":"Reference","previous_headings":"","what":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"Make Red-Green-Blue plot based three layers SpatRaster. layers (sometimes referred \"bands\" may represent different bandwidths electromagnetic spectrum) combined represent red, green blue channel. function can used make \"true\" (\"false\") color images Landsat multi-spectral satellite images. Note margins plot set zero (axes titles visible) can set mar argument. alternative way plot RGB images first use colorize create single layer SpatRaster color-table use plot.","code":""},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"","code":"# S4 method for SpatRaster plotRGB(x, r=1, g=2, b=3, a=NULL, scale=NULL, mar=0,      stretch=NULL, smooth=TRUE, colNA=\"white\", alpha=NULL, bgalpha=NULL,      zlim=NULL, zcol=FALSE, axes=FALSE ,...)"},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"x SpatRaster r integer 1 nlyr(x). Layer use Red channel g integer 1 nlyr(x). Layer use Green channel b integer 1 nlyr(x). Layer use Blue channel NULL integer 1 nlyr(x). Layer use alpha (transparency) channel. NULL, argument alpha ignored scale integer. Maximum (possible) value three channels. Defaults 255 maximum value x known larger 255 mar numeric vector recycled length 4 set margins plot. Use mar=NULL mar=NA set margins stretch character. Option stretch values increase contrast: \"lin\" (linear) \"hist\" (histogram). linear stretch uses stretch arguments minq=0.02 maxq=0.98 smooth logical. TRUE, smooth image drawing get appearance higher spatial resolution colNA color. color used cells NA values alpha transparency. Integer 0 (transparent) 255 (opaque) bgalpha Background transparency. Integer 0 (transparent) 255 (opaque) zlim numeric vector length 2. Range values plot (optional). set, stretch=\"lin\" used, values stretched within range zlim. allows creating consistent coloring SpatRasters different cell-value ranges, even stretching colors improved contrast zcol logical. TRUE values outside range zlim get color extremes range. Otherwise, values outside zlim range get color NA values (see argument \"colNA\") axes logical. TRUE axes drawn (arguments main=\"title\" honored) ... graphical parameters plot<SpatRaster-method>","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plotRGB.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Red-Green-Blue plot of a multi-layered SpatRaster — plotRGB","text":"","code":"b <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    plotRGB(b) plotRGB(b, mar=2)  plotRGB(b, 3, 2, 1)   b[1000:2000] <- NA plotRGB(b, 3, 2, 1, stretch=\"hist\")"},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot a SpatExtent — plot_extent","title":"Plot a SpatExtent — plot_extent","text":"Plot SpatExtent. Use lines add SpatExtent existing map. See plot plotting object types.","code":""},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot a SpatExtent — plot_extent","text":"","code":"# S4 method for SpatExtent,missing plot(x, y, ...)"},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot a SpatExtent — plot_extent","text":"x SpatExtent y missing ... additional graphical arguments lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plot_extent.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot a SpatExtent — plot_extent","text":"","code":"r <- rast() plot(ext(r))"},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot a graticule — plot_graticule","title":"Plot a graticule — plot_graticule","text":"Plot SpatGraticule. can create SpatGraticule graticule.","code":""},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot a graticule — plot_graticule","text":"","code":"# S4 method for SpatGraticule,missing plot(x, y, background=NULL, col=\"black\", mar=NULL, labels=TRUE,   retro=FALSE, lab.loc=c(1,1), lab.lon=NULL, lab.lat=NULL, lab.cex=0.65,    lab.col=\"black\", off.lat=0.25, off.lon=0.25, box=FALSE, box.col=\"black\",   add=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plot a graticule — plot_graticule","text":"x SpatRaster SpatVector y missing positive integer name indicating layer(s) plotted background background color. NULL, background drawn mar numeric vector length 4 set margins plot. make space legend may use something like c(3.1, 3.1, 2.1, 7.1). fill plotting canvas, can use c(0,0,0,0. Use NA set margins col character. Color graticule lines labels logical. TRUE, show graticule labels retro logical. TRUE, show \"retro\" instead decimal labels graticule lab.loc numeric. first number indicates longitude graticule labels drawn (1=bottom, 2=top, NA=drawn, number=top bottom). second number indicates latitude graticule labels drawn (1=left, 2=right, NA=drawn, number=left right) lab.lon positive integers 1 number labels, indicating longitude graticule labels included lab.lat positive integers 1 number labels, indicating latitude graticule labels included lab.cex double. size label font lab.col character. color labels .lon numeric. longitude labels offset .lat numeric. latitude labels offset box logical. TRUE, outer lines graticule drawn top sold line lty=1 box.col character. color outer lines graticule box=TRUE add logical. Add graticule current plot? ... additional graphical arguments passed lines","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/plot_graticule.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot a graticule — plot_graticule","text":"","code":"g <- graticule(60, 30, crs=\"+proj=robin\")  plot(g, background=\"azure\", col=\"red\", lty=2, box=TRUE)  plot(g, background=\"azure\", col=\"light gray\", lab.loc=c(1,2),      lab.lon=c(2,4,6), lab.lat=3:5, lty=3, retro=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster PCA with prcomp — prcomp","title":"SpatRaster PCA with prcomp — prcomp","text":"Compute principal components SpatRaster layers. method may preferred princomp greater numerical accuracy. However, slower large rasters can done sample. may good enough see princomp want use values. Unlike princomp, method sample variances used n-1 denominator.","code":""},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster PCA with prcomp — prcomp","text":"","code":"# S4 method for SpatRaster prcomp(x, retx=TRUE, center=TRUE, scale.=FALSE,      tol=NULL, rank.=NULL, maxcell=Inf)"},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster PCA with prcomp — prcomp","text":"x SpatRaster retx logical value indicating whether rotated variables returned center logical value indicating whether variables shifted zero centered. Alternately, vector length equal number columns x can supplied. value passed scale scale. logical value indicating whether variables scaled unit variance analysis takes place. default FALSE consistency S, general scaling advisable. Alternatively, vector length equal number columns x can supplied. value passed scale tol value indicating magnitude components omitted. (Components omitted standard deviations less equal tol times standard deviation first component.) default null setting, components omitted (unless rank. specified less min(dim(x))). settings tol tol = 0 tol = sqrt(.Machine$double.eps), omit essentially constant components rank. optionally, number specifying maximal rank, .e., maximal number principal components used. Can set alternative addition tol, useful notably desired rank considerably smaller dimensions matrix maxcell positive integer. maximum number cells used. smaller ncell(x), regular sample x used","code":""},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster PCA with prcomp — prcomp","text":"prcomp object","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/prcomp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster PCA with prcomp — prcomp","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f) pca <- prcomp(r) x <- predict(r, pca)  # use \"index\" to get a subset of the components p <- predict(r, pca, index=1:2)"},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial model predictions — predict","title":"Spatial model predictions — predict","text":"Make SpatRaster predictions fitted model object (example, obtained glm randomForest). first argument SpatRaster object predictor variables. names SpatRaster exactly match expected model. regression like model predict method implemented (can implemented) can used. method work model's predict function returns vector, matrix data.frame (list can coerced data.frame). cases may necessary provide custom \"predict\" function wraps model's predict function return values required form. See examples. approach using model predictions commonly used remote sensing (classification satellite images) ecology, species distribution modeling.","code":""},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial model predictions — predict","text":"","code":"# S4 method for SpatRaster predict(object, model, fun=predict, ..., const=NULL, na.rm=FALSE,           index=NULL, cores=1, cpkgs=NULL, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial model predictions — predict","text":"object SpatRaster model fitted model class \"predict\" method (can supply similar method fun argument. E.g. glm, gam, randomForest fun function. predict function takes model first argument. default value predict, can replaced e.g. predict.se (depending type model), custom function ... additional arguments fun const data.frame. Can used add constant value predictor variable need make SpatRaster layer na.rm logical. TRUE, cells NA values layers x removed computation (even NA cell layer used variable model). option prevents errors models handle NA values makeing predictions. cases affect output. However, models return predicted values even () variables NA index integer character. Can used select subset model output variables cores positive integer. cores > 1, 'parallel' package cluster many cores created used cpkgs character. package(s) need loaded nodes able run model.predict function (see examples) filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial model predictions — predict","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/predict.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial model predictions — predict","text":"","code":"logo <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    names(logo) <- c(\"red\", \"green\", \"blue\") p <- matrix(c(48, 48, 48, 53, 50, 46, 54, 70, 84, 85, 74, 84, 95, 85,     66, 42, 26, 4, 19, 17, 7, 14, 26, 29, 39, 45, 51, 56, 46, 38, 31,     22, 34, 60, 70, 73, 63, 46, 43, 28), ncol=2)  a <- matrix(c(22, 33, 64, 85, 92, 94, 59, 27, 30, 64, 60, 33, 31, 9,    99, 67, 15, 5, 4, 30, 8, 37, 42, 27, 19, 69, 60, 73, 3, 5, 21,    37, 52, 70, 74, 9, 13, 4, 17, 47), ncol=2)  xy <- rbind(cbind(1, p), cbind(0, a))  # extract predictor values for points e <- extract(logo, xy[,2:3])  # combine with response (excluding the ID column) v <- data.frame(cbind(pa=xy[,1], e))  #build a model, here with glm  model <- glm(formula=pa~., data=v)  #predict to a raster r1 <- predict(logo, model)  plot(r1) points(p, bg='blue', pch=21) points(a, bg='red', pch=21)   # logistic regression model <- glm(formula=pa~., data=v, family=\"binomial\") #> Warning: glm.fit: algorithm did not converge #> Warning: glm.fit: fitted probabilities numerically 0 or 1 occurred r1log <- predict(logo, model, type=\"response\")  # to get the probability and standard error r1se <- predict(logo, model, se.fit=TRUE)  # or provide a custom predict function  predfun <- function(model, data) {   v <- predict(model, data, se.fit=TRUE)   cbind(p=as.vector(v$fit), se=as.vector(v$se.fit)) }  r2 <- predict(logo, model, fun=predfun)  ### principal components of a SpatRaster pca <- prcomp(logo)  # or use sampling if you have a large raster  # and cannot process all cell values sr <- spatSample(logo, 100000, \"regular\") pca <- prcomp(sr)  x <- predict(logo, pca) plot(x)   ## parallelization if (FALSE) { ## simple case with GLM  model <- glm(formula=pa~., data=v) p <- predict(logo, model, cores=2)  ## The above does not work with a model from a contributed ## package, as the package needs to be loaded in each core.  ## Below are three approaches to deal with that   library(randomForest) rfm <- randomForest(formula=pa~., data=v)  ## approach 0 (not parallel)  rp0 <- predict(logo, rfm)  ## approach 1, use the \"cpkgs\" argument  rp1 <- predict(logo, rfm, cores=2, cpkgs=\"randomForest\")  ## approach 2, write a custom predict function that loads the package rfun <- function(mod, dat, ...) {   library(randomForest)   predict(mod, dat, ...) } rp2 <- predict(logo, rfm, fun=rfun, cores=2)  ## approach 3, write a parallelized custom predict function  rfun <- function(mod, dat, ...) {   ncls <- length(cls)   nr <- nrow(dat)   s <- split(dat, rep(1:ncls, each=ceiling(nr/ncls), length.out=nr))   unlist(  parallel::clusterApply(cls, s, function(x, ...) predict(mod, x, ...))  ) }  library(parallel) cls <- parallel::makeCluster(2) parallel::clusterExport(cls, c(\"rfm\", \"rfun\", \"randomForest\")) rp3 <- predict(logo, rfm, fun=rfun) parallel::stopCluster(cls)  plot(c(rp0, rp1, rp2, rp3))   ### with two output variables (probabilities for each class) v$pa <- as.factor(v$pa) rfm2 <- randomForest(formula=pa~., data=v) rfp <- predict(logo, rfm2, cores=2, type=\"prob\", cpkgs=\"randomForest\") }"},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster PCA with princomp — princomp","title":"SpatRaster PCA with princomp — princomp","text":"Compute principal components SpatRaster layers. method can use values compute principal components, even large rasters. computes covariance matrix processing data chunks, necessary, using layerCor. population covariance used (sample, n-1 denominator, covariance). Alternatively, can specify maxcell sample raster values data.frame speed calculations large rasters (see examples ). See prcomp alternative method higher numerical accuracy, slower, large rasters can accomplished sample since values must read memory.","code":""},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster PCA with princomp — princomp","text":"","code":"# S4 method for SpatRaster princomp(x, cor=FALSE, fix_sign=TRUE, use=\"pairwise.complete.obs\", maxcell=Inf)"},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster PCA with princomp — princomp","text":"x SpatRaster cor logical. FALSE, covariance matrix used. Otherwise correlation matrix used fix_sign logical.  TRUE, signs loadings scores chosen first element loading non-negative use character. decide handle missing values. must (abbreviation ) one strings \"everything\", \"complete.obs\", \"pairwise.complete.obs\", \"masked.complete\". \"pairwise.complete.obs\", covariance pair layers computed cells NA pair. Therefore, may (number ) cells used varies pairs. benefit approach available data used. Use \"complete.obs\", want use values cells NA layers. using \"masked.complete\" indicate layers NA values cells maxcell positive integer. maximum number cells used. smaller ncell(x), regular sample x used","code":""},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster PCA with princomp — princomp","text":"princomp object","code":""},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"SpatRaster PCA with princomp — princomp","text":"Alex Ilich Robert Hijmans, based similar method Benjamin Leutner","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/princomp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster PCA with princomp — princomp","text":"","code":"f <- system.file(\"ex/logo.tif\", package = \"terra\") r <- rast(f) pca <- princomp(r) x <- predict(r, pca)  # use \"index\" to get a subset of the components p <- predict(r, pca, index=1:2)  ### use princomp directly pca2 <- princomp(values(r),  fix_sign = TRUE) p2 <- predict(r, pca2)  ### may need to use sampling with a large raster  ### here with prcomp instead of princomp sr <- spatSample(r, 100000, \"regular\") pca3 <- prcomp(sr) p3 <- predict(r, pca3)"},{"path":"https://rspatial.github.io/terra/reference/project.html","id":null,"dir":"Reference","previous_headings":"","what":"Change the coordinate reference system — project","title":"Change the coordinate reference system — project","text":"Change coordinate reference system (\"project\") SpatVector, SpatRaster matrix coordinates.","code":""},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Change the coordinate reference system — project","text":"","code":"# S4 method for SpatVector project(x, y, partial = FALSE)  # S4 method for SpatRaster project(x, y, method, mask=FALSE, align_only=FALSE, res=NULL,    origin=NULL, threads=FALSE, filename=\"\", ..., use_gdal=TRUE, by_util = FALSE)  # S4 method for SpatExtent project(x, from, to)  # S4 method for matrix project(x, from, to)"},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Change the coordinate reference system — project","text":"x SpatRaster, SpatVector, SpatExtent matrix (x y columns) whose coordinates project y (x SpatRaster, preferred approach y SpatRaster well, serving template geometry (extent resolution) output SpatRaster. Alternatively, can provide coordinate reference system (CRS) description. can use following formats define coordinate reference systems: WKT,  PROJ.4 (e.g., +proj=longlat +datum=WGS84), EPSG code (e.g., \"epsg:4326\"). note PROJ.4 notation deprecated, can use WGS84/NAD83 NAD27 datums. datums silently ignored. x SpatVector, can provide crs definition discussed , object crs can extracted crs partial logical. TRUE, geometries can partially represented output crs included output method character. Method used estimating new cell values SpatRaster. One : near: nearest neighbor. method fast, can preferred method cell values represent classes. good choice continuous values. used default first layer x categorical. bilinear: bilinear interpolation. default first layer x numeric (categorical). cubic: cubic interpolation. cubicspline: cubic spline interpolation. lanczos: Lanczos windowed sinc resampling. sum: weighted sum non-NA contributing grid cells. min, q1, med, q3, max, average, mode, rms: minimum, first quartile, median, third quartile, maximum, mean, mode, root-mean-square value non-NA contributing grid cells. mask logical. TRUE, mask areas outside input extent. example avoid data wrapping around date-line (see example Robinson projection). remove cells NA y (y SpatRaster) can use mask method calling project (function) align_only logical. TRUE, y SpatRaster, template used spatial resolution origin, extent set extent x included res numeric. Can used set resolution output raster y CRS origin numeric. Can used set origin output raster y CRS threads logical. TRUE multiple threads used (faster large files) filename character. Output filename ... additional arguments writing files writeRaster use_gdal logical. TRUE GDAL-warp algorithm used. Otherwise slower internal algorithm used may accurate much variation cell sizes output raster. near bilinear algorithms available internal algorithm by_util logical. TRUE gdal=TRUE, GDAL warp utility used character. Coordinate reference system x character. Output coordinate reference system","code":""},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Change the coordinate reference system — project","text":"SpatVector SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Change the coordinate reference system — project","text":"PROJ.4 notation coordinate reference systems partly deprecated GDAL/PROJ library used function. can still use notation, ** WGS84 datum. datums silently ignored. Transforming (projecting) raster data fundamentally different transforming vector data. Vector data can transformed back-transformed without loss precision without changes values. case raster data. transformation values new cells estimated fashion. Therefore, need match raster vector data analysis, generally transform vector data. using method SpatRaster, preferable approach provide template SpatRaster argument y. template another raster dataset want data align . template begin , can project(rast(x), crs) manipulate output get template want. example, possible use whole numbers extent resolution worry small differences future. can use commands like dim(z) = c(180, 360) res(z) <- 100000. output resolution generally similar input resolution, \"correct\" resolution raster transformation. obvious resolution using lon/lat data spans large North-South extent.","code":""},{"path":"https://rspatial.github.io/terra/reference/project.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Change the coordinate reference system — project","text":"","code":"## SpatRaster a <- rast(ncols=40, nrows=40, xmin=-110, xmax=-90, ymin=40, ymax=60,            crs=\"+proj=longlat +datum=WGS84\") values(a) <- 1:ncell(a) newcrs=\"+proj=lcc +lat_1=48 +lat_2=33 +lon_0=-100 +datum=WGS84\" b <- rast(ncols=94, nrows=124, xmin=-944881, xmax=935118, ymin=4664377, ymax=7144377, crs=newcrs) w <- project(a, b)   ## SpatVector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) crs(v, proj=TRUE) #> [1] \"+proj=longlat +datum=WGS84 +no_defs\" cat(crs(v), \"\\n\") #> GEOGCRS[\"WGS 84\", #>     DATUM[\"World Geodetic System 1984\", #>         ELLIPSOID[\"WGS 84\",6378137,298.257223563, #>             LENGTHUNIT[\"metre\",1]]], #>     PRIMEM[\"Greenwich\",0, #>         ANGLEUNIT[\"degree\",0.0174532925199433]], #>     CS[ellipsoidal,2], #>         AXIS[\"geodetic latitude (Lat)\",north, #>             ORDER[1], #>             ANGLEUNIT[\"degree\",0.0174532925199433]], #>         AXIS[\"geodetic longitude (Lon)\",east, #>             ORDER[2], #>             ANGLEUNIT[\"degree\",0.0174532925199433]], #>     ID[\"EPSG\",4326]]   project(v, \"+proj=moll\") #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 437476.4, 497805.3, 5815524, 5892478  (xmin, xmax, ymin, ymax) #>  coord. ref. : +proj=moll +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664   project(v, \"EPSG:2169\") #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 49540.31, 105922, 57009.53, 138631.1  (xmin, xmax, ymin, ymax) #>  coord. ref. : LUREF / Luxembourg TM (EPSG:2169)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664"},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":null,"dir":"Reference","previous_headings":"","what":"Quantiles of spatial data — quantile","title":"Quantiles of spatial data — quantile","text":"Compute quantiles cell across layers SpatRaster. can use use global(x, fun=quantile) instead compute quantiles across cells layer. can also use method compute quantiles numeric variables SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Quantiles of spatial data — quantile","text":"","code":"# S4 method for SpatRaster quantile(x, probs=seq(0, 1, 0.25), na.rm=FALSE, filename=\"\", ...)   # S4 method for SpatVector quantile(x, probs=seq(0, 1, 0.25), ...)"},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Quantiles of spatial data — quantile","text":"x SpatRaster SpatVector probs numeric vector probabilities values [0,1] na.rm logical. TRUE, NA's removed x quantiles computed filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Quantiles of spatial data — quantile","text":"SpatRaster layers representing quantiles","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/quantile.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Quantiles of spatial data — quantile","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    rr <- c(r/2, r, r*2) qr <- quantile(rr) qr #> class       : SpatRaster  #> dimensions  : 77, 101, 5  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> names       :    q0, q0.25, q0.5, q0.75,  q1  #> min values  :   0.0,   0.0,    0,     0,   0  #> max values  : 127.5, 127.5,  255,   510, 510   if (FALSE) { # same but slower qa <- app(rr, quantile) }  #quantile by layer instead of by cell qg <- global(r, quantile)"},{"path":"https://rspatial.github.io/terra/reference/query.html","id":null,"dir":"Reference","previous_headings":"","what":"Query a SpatVectorProxy object — query","title":"Query a SpatVectorProxy object — query","text":"Query SpatVectorProxy extract subset","code":""},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query a SpatVectorProxy object — query","text":"","code":"# S4 method for SpatVectorProxy query(x, start=1, n=nrow(x), vars=NULL, where=NULL,      extent=NULL, filter=NULL, sql=NULL, what=\"\")"},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query a SpatVectorProxy object — query","text":"x SpatVectorProxy start positive integer. record start reading n positive integer. number records requested vars character. Variable names. Must subset names(x) character. expression like \"NAME_1='California' ID > 3\" , subset records. Note start n applied executing statement extent Spat* object. extent object used spatial filter select geometries read. Ignored filter NULL filter SpatVector. Used spatial filter select geometries read (convex hull used lines points) sql character. Arbitrary SQL statement. used, arguments \"start\", \"n\", \"vars\" \"\" ignored character indicating read. Either \"\" geometries attributes, \"geoms\" read geometries, \"attributes\" read attributes (returned data.frame)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query a SpatVectorProxy object — query","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/query.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query a SpatVectorProxy object — query","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f, proxy=TRUE) v #>  class       : SpatVectorProxy #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1 NAME_1  ID_2 NAME_2  AREA   POP #>  type        : <num>  <chr> <num>  <chr> <num> <int>  x <- query(v, vars=c(\"ID_2\", \"NAME_2\"), start=5, n=2) x #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.72324, 50.03632  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_2     NAME_2 #>  type        : <num>      <chr> #>  values      :     5      Wiltz #>                    6 Echternach  query(v, vars=c(\"ID_2\", \"NAME_1\", \"NAME_2\"), where=\"NAME_1='Grevenmacher' AND ID_2 > 6\") #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 3  (geometries, attributes) #>  extent      : 6.169137, 6.516485, 49.46498, 49.75016  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_2       NAME_1       NAME_2 #>  type        : <num>        <chr>        <chr> #>  values      :     7 Grevenmacher       Remich #>                   12 Grevenmacher Grevenmacher  ## with an extent e <- ext(5.9, 6.3, 49.9, 50)  x <- query(v, extent=e)  ## with polygons p <- as.polygons(e) x <- query(v, filter=p) x #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 4, 6  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     4  Vianden    76  5163"},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":null,"dir":"Reference","previous_headings":"","what":"Fill layers with a range — rangeFill","title":"Fill layers with a range — rangeFill","text":"Fill layers cell-varying ranges defined start end SpatRaster. range must start 1 end user-defined maximum. Output values either zero (range) one (range). example, cell start=3, end=5 limit=8, output cell 0,0,1,1,1,0,0,0","code":""},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fill layers with a range — rangeFill","text":"","code":"# S4 method for SpatRaster rangeFill(x, limit, circular=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fill layers with a range — rangeFill","text":"x SpatRaster two layers. cell values first layer indicate start range (1 based); cell values indicate end range limit numeric > 1. range size circular logical. TRUE values considered circular, days year. case, first > last layers used c(first:limit, 1:last). Otherwise, circular=FALSE, range considered invalid NA used filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fill layers with a range — rangeFill","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rangeFill.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Fill layers with a range — rangeFill","text":"","code":"x <- y <- rast(ncol=2, nrow=2) values(x) <- c(NA, 1:3) values(y) <- c(NA, 4:6)  r <- rangeFill(c(x, y), 8)"},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Range-apply — rapp","title":"Range-apply — rapp","text":"Apply function range layers SpatRaster varies cell. range specified cell one two SpatRasters (arguments first last). either first last can use single number instead. use single numbers first last case use app Summary-methods, perhaps subsetting layers SpatRaster. See selectRange create new SpatRaster extracting one values starting cell-varying layer.","code":""},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Range-apply — rapp","text":"","code":"# S4 method for SpatRaster rapp(x, first, last, fun, ..., allyrs=FALSE, fill=NA,          clamp=FALSE, circular=FALSE, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Range-apply — rapp","text":"x SpatRaster first SpatRaster positive integer 1 nlyr(x), indicating first layer range layers considered last SpatRaster positive integer 1 nlyr(x), indicating last layer range considered fun function applied ... additional arguments passed fun allyrs logical. TRUE, values layers passed fun values outside range set fill fill numeric. fill value values outside range, allyrs=TRUE clamp logical. FALSE specified range outside 1:nlyr(x) cells considered NA. Otherwise, invalid part range ignored circular logical. TRUE values considered circular, days year. case, first > last layers used c(first:nlyr(x), 1:last). Otherwise, range considered invalid NA returned filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Range-apply — rapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Range-apply — rapp","text":"","code":"r <- rast(ncols=9, nrows=9) values(r) <- 1:ncell(r) s <- c(r, r, r, r, r, r) s <- s * 1:6 s[1:2] <- NA start <- end <- rast(r) start[] <- 1:3 end[]   <- 4:6 a <- rapp(s, start, end, fun=\"mean\") b <- rapp(s, start, 2, fun=\"mean\")  # cumsum from start to nlyr(x). return all layers r <- rapp(s, start, nlyr(s), cumsum, allyrs=TRUE, fill=0) # return only the final value rr <- rapp(s, start, nlyr(s), function(i) max(cumsum(i)))"},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatRaster — rast","title":"Create a SpatRaster — rast","text":"Methods create SpatRaster. objects can created scratch, filename, another object. SpatRaster represents spatially referenced surface divided three dimensional cells (rows, columns, layers). SpatRaster created file, load cell (pixel) values memory (RAM). reads parameters describe geometry SpatRaster, number rows columns coordinate reference system. actual values read needed.","code":""},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatRaster — rast","text":"","code":"# S4 method for character rast(x, subds=0, lyrs=NULL, drivers=NULL, opts=NULL,        win=NULL, snap=\"near\", vsi=FALSE, raw=FALSE)  # S4 method for missing rast(x, nrows=180, ncols=360, nlyrs=1, xmin=-180, xmax=180,            ymin=-90, ymax=90, crs, extent, resolution, vals, names, time, units)  # S4 method for SpatRaster rast(x, nlyrs=nlyr(x), names, vals, keeptime=TRUE,        keepunits=FALSE, props=FALSE, tags=FALSE)   # S4 method for matrix rast(x, type=\"\", crs=\"\", digits=6, extent=NULL)  # S4 method for data.frame rast(x, type=\"xyz\", crs=\"\", digits=6, extent=NULL)  # S4 method for array rast(x, crs=\"\", extent=NULL)  # S4 method for list rast(x, warn=TRUE)  # S4 method for SpatRasterDataset rast(x)  # S4 method for SpatVector rast(x, ...)                      # S4 method for SpatExtent rast(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatRaster — rast","text":"x filename (character), missing, SpatRaster, SpatRasterDataset, SpatExtent, SpatVector, matrix, array, list SpatRasters. types attempted create SpatRaster via (`(x, \"SpatRaster\")` subds positive integer character select sub-dataset. zero \"\", sub-datasets returned (possible) lyrs positive integer character select subset layers (.k.. \"bands\") drivers character. GDAL drivers consider opts character. GDAL dataset open options win SpatExtent set window (area interest) snap character. One \"near\", \"\", \"\", indicate extent window \"snapped\" x vsi logical. TRUE, \"\\vsicurl\\\" prepended filenames start \"http\" raw logical. TRUE, scale offset values ignored nrows positive integer. Number rows ncols positive integer. Number columns nlyrs positive integer. Number layers xmin minimum x coordinate (left border) xmax maximum x coordinate (right border) ymin minimum y coordinate (bottom border) ymax maximum y coordinate (top border) crs character. Description Coordinate Reference System (map projection) PROJ.4, WKT authority:code notation. See crs. argument missing, x coordinates within -360 .. 360 y coordinates within -90 .. 90, longitude/latitude assigned keeptime logical. FALSE time stamps discarded keepunits logical. FALSE layer units discarded props logical. TRUE properties (categories color-table) kept tags logical. TRUE user specified metadata tags kept (see metags). extent object class SpatExtent. present, arguments xmin, xmax, ymin ymax ignored resolution numeric vector length 1 2 set spatial resolution (see res). argument used, arguments ncols nrows ignored vals numeric. optional vector cell values (fewer values provided, recycled reach number cells) names character. optional vector layer names (must match number layers) time time date stamps layer units character. units layer type character. value \"xyz\", matrix data.frame x must least two columns, first x (longitude) second y (latitude) coordinates represent centers raster cells. additional columns values associated raster cells. value \"xylz\", x must four columns third representing layer fourth cell values. value \"\", resulting SpatRaster number rows columns x. digits integer set precision detecting whether points regular grid (low number digits low precision). used type=\"xyz\" warn logical. TRUE, warnings empty rasters may emitted ... additional arguments passed rast,missing-method","code":""},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatRaster — rast","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create a SpatRaster — rast","text":"Files read GDAL library. GDAL guesses file format name, /tries reading different \"drivers\" (see gdal) succeeds. cases may cause file opened wrong driver, information may lost. example, netCDF file opened HDF5 driver. can avoid using argument rast(\"filename.ncdf\", drivers=\"NETCDF\") classes hold C++ pointer data \"reference class\" creates limitations. recovered saved R session either directly passed nodes computer cluster. Generally, use writeRaster save SpatRaster objects disk (pass filename cell values ot cluster nodes). Also see wrap.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rast.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatRaster — rast","text":"","code":"# Create a SpatRaster from scratch x <- rast(nrows=108, ncols=21, xmin=0, xmax=10)  # Create a SpatRaster from a file f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f)  s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     # Create a skeleton with no associated cell values rast(s) #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)   # from a matrix  m <- matrix(1:25, nrow=5, ncol=5) rm <- rast(m)  # from a \"xyz\" data.frame d <- as.data.frame(rm, xy=TRUE) head(d) #>     x   y lyr.1 #> 1 0.5 4.5     1 #> 2 1.5 4.5     6 #> 3 2.5 4.5    11 #> 4 3.5 4.5    16 #> 5 4.5 4.5    21 #> 6 0.5 3.5     2 rast(d, type=\"xyz\") #> class       : SpatRaster  #> dimensions  : 5, 5, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 5, 0, 5  (xmin, xmax, ymin, ymax) #> coord. ref. :   #> source(s)   : memory #> name        : lyr.1  #> min value   :     1  #> max value   :    25"},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":null,"dir":"Reference","previous_headings":"","what":"Rasterize vector data — rasterize","title":"Rasterize vector data — rasterize","text":"Transfer values associated geometries vector data raster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rasterize vector data — rasterize","text":"","code":"# S4 method for SpatVector,SpatRaster rasterize(x, y, field=\"\", fun, ..., background=NA, touches=FALSE, update=FALSE,    cover=FALSE, by=NULL, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for matrix,SpatRaster rasterize(x, y, values=1, fun, ..., background=NA, update=FALSE,    by=NULL, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rasterize vector data — rasterize","text":"x SpatVector two-column matrix (point coordinates) y SpatRaster field character numeric. field character, variable name x. field numeric typically single number vector length nrow(x). values recycled nrow(x) values typically numeric vector length 1 nrow(x). length nrow(x) values recycled nrow(x). used x matrix. Can also matrix data.frame fun summarizing function multiple geometries one cell. lines polygons can use  \"min\", \"max\", \"mean\", \"count\" \"sum\"   points can use function returns single number; example mean, length (get count), min max ... additional arguments passed fun background numeric. Value put cells covered features x. Default NA touches logical. TRUE, cells touched lines polygons affected, just line render path, whose center point within polygon. touches=TRUE, add TRUE update logical. TRUE, values input SpatRaster updated cover logical. TRUE geometry x polygons, fraction cell covered polygons returned. estimated determining presence/absence polygon least 100 sub-cells (cells) character numeric value(s) split x multiple groups. separate layer group returned. x SpatVector, can column number name. x matrix, vector identifies group membership row x filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rasterize vector data — rasterize","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterize.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rasterize vector data — rasterize","text":"","code":"r <- rast(xmin=0, ncols=18, nrows=18)  # generate points set.seed(1) p <- spatSample(r, 1000, xy=TRUE, replace=TRUE)  # rasterize points as a matrix x <- rasterize(p, r, fun=sum) y <- rasterize(p, r, value=1:nrow(p), fun=max)  # rasterize points as a SpatVector pv <- vect(p) xv <- rasterize(pv, r, fun=sum)  # Polygons f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) r <- rast(v, ncols=75, nrows=100) z <- rasterize(v, r, \"NAME_2\") plot(z) lines(v)"},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":null,"dir":"Reference","previous_headings":"","what":"Rasterize geometric properties of vector data — rasterizeGeom","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"Rasterization geometric properties vector data. can get count number geometries cell; area covered polygons; length lines; number lines cross boundary cell. See rasterize standard rasterization (attribute values associated geometries). area polygons intended summing area polygons relatively small relative raster cells, may multiple polygons per cell. See rasterize(fun=\"sum\") counting large polygons rasterize(cover=TRUE) get fraction covered larger polygons.","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"","code":"# S4 method for SpatVector,SpatRaster rasterizeGeom(x, y, fun=\"count\", unit=\"m\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"x SpatVector y SpatRaster fun character. \"count\", \"area\", \"length\", \"crosses\" unit character. \"m\" \"km\" filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeGeom.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rasterize geometric properties of vector data — rasterizeGeom","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) r <- rast(v, res=.1)  # length of lines lns <- as.lines(v) x <- rasterizeGeom(lns, r, fun=\"length\", \"km\")  # count of points set.seed(44) pts <- spatSample(v, 100) y <- rasterizeGeom(pts, r)  # area of polygons pols <- buffer(pts, 1000) z <- rasterizeGeom(pols, r, fun=\"area\")"},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":null,"dir":"Reference","previous_headings":"","what":"Rasterize points with a moving window — rasterizeWin","title":"Rasterize points with a moving window — rasterizeWin","text":"Rasterize points using circle (ellipse) moving window. raster cell, points (x, y) fall within window centered cell considered. function used compute summary value (e.g. \"mean\") values (z) associated points. can result much smoother results compared standard rasterize method.","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rasterize points with a moving window — rasterizeWin","text":"","code":"# S4 method for SpatVector,SpatRaster rasterizeWin(x, y, field, win=\"circle\", pars, fun, ..., cvars=FALSE,          minPoints=1, fill=NA, filename=\"\", wopt=list())  # S4 method for data.frame,SpatRaster rasterizeWin(x, y, win=\"circle\", pars, fun, ..., cvars=FALSE,            minPoints=1, fill=NA, filename=\"\", wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rasterize points with a moving window — rasterizeWin","text":"x SpatVector matrix least three columns ((x, y) coordinates variable rasterized) y SpatRaster field character. field name SpatVector x values rasterize win character choose window type. Can \"circle\", \"ellipse\", \"rectangle\", \"buffer\" pars parameters define window. win=\"circle\" win=\"buffer\", single number set radius circle width buffer. win=\"ellipse\", either two numbers (x y-axis) three numbers axes rotation (degrees). win=\"rectangle\", either two (width, height) three (width, height) rotation degrees. unit radius/width/height/axis parameters coordinate reference system (expressed cells). , lon/lat crs, conversion degrees meters vice-versa. fun function summarize values cell. cvars=FALSE, functions must take numeric vector return (cases) one numbers. cvars=TRUE, multiple variables used, function must take single argument (data.frame names variables).      win=\"circle\" win=\"ellipse\" two additional character values can used: \"distto\" (average distance points center cell) \"distbetween\" (average distance points inside window) ... additional named arguments passed fun minPoints numeric. minimum number points use. fewer points found search ellipse considered empty fill value returned fill numeric. value use fill cells empty search areas cvars logical. using multiple fields, fun operate ? , fun applied variable separately filename character. Output filename wopt list additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rasterize points with a moving window — rasterizeWin","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rasterizeWin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rasterize points with a moving window — rasterizeWin","text":"","code":"r <- rast(ncol=100, nrow=100, crs=\"local\", xmin=0, xmax=50, ymin=0, ymax=50) set.seed(100) x <- runif(50, 5, 45) y <- runif(50, 5, 45) z <- sample(50) xyz <- data.frame(x,y,z)  r <- rasterizeWin(xyz, r, fun=\"count\", pars=5)  rfuns <- c(\"count\", \"min\", \"max\", \"mean\") x <- lapply(rfuns, function(f) rasterizeWin(xyz, r, fun=f, pars=5)) names(x) <- rfuns  x <- rast(x) #plot(x)"},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":null,"dir":"Reference","previous_headings":"","what":"Combine row, column, and layer numbers — rcl","title":"Combine row, column, and layer numbers — rcl","text":"Get matrix combination row, column, layer numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Combine row, column, and layer numbers — rcl","text":"","code":"# S4 method for SpatRaster rcl(x, row=NULL, col=NULL, lyr=NULL)"},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Combine row, column, and layer numbers — rcl","text":"x SpatRaster row positive integer row number(s), list thereof, NULL rows col columns lyr layers","code":""},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Combine row, column, and layer numbers — rcl","text":"list used least one row, col lyr, evaluated parallel. combinations made list element, across list elements. , case another argument list either length 1 (used cases) length (longest) list, case value coerced list .list multiple arguments list different lengths, theyare recycled longest list.","code":""},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Combine row, column, and layer numbers — rcl","text":"matrix","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rcl.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Combine row, column, and layer numbers — rcl","text":"","code":"x <- rast(ncol=5, nrow=5, nlyr=2) values(x) <- 1:size(x)  rcl(x, 1, 2:3, 1:2) #>      row col lyr #> [1,]   1   2   1 #> [2,]   1   3   1 #> [3,]   1   2   2 #> [4,]   1   3   2  i <- rcl(x, 1, list(1:2, 3:4), 1:2) i #>      row col lyr #> [1,]   1   1   1 #> [2,]   1   2   1 #> [3,]   1   3   2 #> [4,]   1   4   2  # get the values for these cells x[i] #> [1]  1  2 28 29"},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":null,"dir":"Reference","previous_headings":"","what":"Read from, or write to, file — readwrite","title":"Read from, or write to, file — readwrite","text":"Methods read write chunks values file. low level methods programmers. Use writeRaster want save entire SpatRaster file one step. much easier use. write chunks, begin opening file writeStart, write values chunks using list returned writeStart. writing done, close file writeStop. blocks returns chunk size information. can useful reading, writing, raster data.","code":""},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Read from, or write to, file — readwrite","text":"","code":"# S4 method for SpatRaster readStart(x)  # S4 method for SpatRaster readStop(x)  # S4 method for SpatRaster readValues(x, row=1, nrows=nrow(x), col=1, ncols=ncol(x), mat=FALSE, dataframe=FALSE, ...)  # S4 method for SpatRaster,character writeStart(x, filename=\"\", overwrite=FALSE, n=4, sources=\"\", ...)  # S4 method for SpatRaster writeStop(x)  # S4 method for SpatRaster,vector writeValues(x, v, start, nrows)  # S4 method for SpatRaster blocks(x, n=4)  fileBlocksize(x)"},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Read from, or write to, file — readwrite","text":"x SpatRaster filename character. Output filename v vector cell values written start integer. Row number (counting starts 1) start writing v row positive integer. Row number start , 1 nrow(x) nrows positive integer. many rows? col positive integer. Column number start , 1 ncol(x) ncols positive integer. many columns? Default number columns left start column mat logical. TRUE, values returned numeric matrix instead vector, except dataframe=TRUE. layers x factor, level index returned, label. Use dataframe=TRUE get labels dataframe logical. TRUE, values returned data.frame instead vector (also matrix TRUE) overwrite logical. TRUE, filename overwritten n positive integer indicating many copies data may memory point time. used determine many blocks (large) datasets need read sources character. Filenames may overwritten used input function. Can obtained sources(x) ... writeStart: additional arguments writing files writeRaster readValues: additional arguments data.frame (thus relevant dataframe=TRUE)","code":""},{"path":"https://rspatial.github.io/terra/reference/readwrite.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Read from, or write to, file — readwrite","text":"readValues returns vector, matrix, data.frame writeStart returns list can used processing file chunks. methods invisibly return logical value indicating whether successful . purpose side-effect opening closing files.","code":""},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":null,"dir":"Reference","previous_headings":"","what":"Rectify a SpatRaster — rectify","title":"Rectify a SpatRaster — rectify","text":"Rectify rotated SpatRaster non-rotated object","code":""},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rectify a SpatRaster — rectify","text":"","code":"# S4 method for SpatRaster rectify(x, method=\"bilinear\", aoi=NULL, snap=TRUE,          filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rectify a SpatRaster — rectify","text":"x SpatRaster rectified method character. Method used resampling. See resample aoi SpatExtent SpatRaster crop x smaller area interest; Using SpatRaster allowing set exact output extent output resolution snap logical. TRUE, origin resolution output case aoi = NULL. relevant aoi SpatExtent filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rectify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rectify a SpatRaster — rectify","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":null,"dir":"Reference","previous_headings":"","what":"Cell level regression — regress","title":"Cell level regression — regress","text":"Run regression model cell SpatRaster. independent variable can either defined vector, another SpatRaster make spatially variable.","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cell level regression — regress","text":"","code":"# S4 method for SpatRaster,numeric regress(y, x, formula=y~x, na.rm=FALSE, cores=1, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatRaster,SpatRaster regress(y, x, formula=y~x, na.rm=FALSE, cores=1, filename=\"\", overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cell level regression — regress","text":"y SpatRaster x SpatRaster numeric (length nlyr(x) formula regression formula general form y ~ x. can add additional terms (x^2) na.rm logical. Remove NA values? cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object. filename character. Output filename overwrite logical. TRUE, filename overwritten ... list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cell level regression — regress","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/regress.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cell level regression — regress","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- regress(s, 1:nlyr(s))"},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial relationships between geometries — relate","title":"Spatial relationships between geometries — relate","text":"relate returns logical matrix indicating presence absence specific spatial relationships geometries x y. .related returns logical vector indicating presence absence specific spatial relationships x geometries y","code":""},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial relationships between geometries — relate","text":"","code":"# S4 method for SpatVector,SpatVector relate(x, y, relation, pairs=FALSE, na.rm=TRUE)  # S4 method for SpatVector,missing relate(x, y, relation, pairs=FALSE, na.rm=TRUE)  # S4 method for SpatVector,SpatVector is.related(x, y, relation)"},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial relationships between geometries — relate","text":"x SpatVector SpatExtent y missing x relation character. One \"intersects\", \"touches\", \"crosses\", \"overlaps\", \"within\", \"contains\", \"covers\", \"coveredby\", \"disjoint\". \"DE-9IM\" string \"FF*FF****\". See wikipedia geotools doc pairs logical. TRUE two-column matrix returned indices cases requested relation TRUE. especially helpful dealing many geometries returned value generally much smaller na.rm logical. TRUE pairs=TRUE, geometries x related geometry y omitted","code":""},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial relationships between geometries — relate","text":"matrix (relate) vector (.related)","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/relate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial relationships between geometries — relate","text":"","code":"# polygons p1 <- vect(\"POLYGON ((0 0, 8 0, 8 9, 0 9, 0 0))\") p2 <- vect(\"POLYGON ((5 6, 15 6, 15 15, 5 15, 5 6))\") p3 <- vect(\"POLYGON ((8 2, 9 2, 9 3, 8 3, 8 2))\") p4 <- vect(\"POLYGON ((2 6, 3 6, 3 8, 2 8, 2 6))\") p5 <- vect(\"POLYGON ((2 12, 3 12, 3 13, 2 13, 2 12))\") p6 <- vect(\"POLYGON ((10 4, 12 4, 12 7, 11 7, 11 6, 10 6, 10 4))\")  p <- rbind(p1, p2, p3, p4, p5, p6) plot(p, col=rainbow(6, alpha=.5)) lines(p, lwd=2) text(p)   ## relate SpatVectors relate(p1, p2, \"intersects\") #>      [,1] #> [1,] TRUE relate(p1, p3, \"touches\") #>      [,1] #> [1,] TRUE relate(p1, p5, \"disjoint\") #>      [,1] #> [1,] TRUE relate(rbind(p1, p2), p4, \"disjoint\") #>       [,1] #> [1,] FALSE #> [2,]  TRUE  ## relate geometries within SpatVectors # which are completely separated? relate(p, relation=\"disjoint\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,] FALSE FALSE FALSE FALSE  TRUE  TRUE #> [2,] FALSE FALSE  TRUE  TRUE  TRUE FALSE #> [3,] FALSE  TRUE FALSE  TRUE  TRUE  TRUE #> [4,] FALSE  TRUE  TRUE FALSE  TRUE  TRUE #> [5,]  TRUE  TRUE  TRUE  TRUE FALSE  TRUE #> [6,]  TRUE FALSE  TRUE  TRUE  TRUE FALSE  # which touch (not overlap or within)? relate(p, relation=\"touches\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,] FALSE FALSE  TRUE FALSE FALSE FALSE #> [2,] FALSE FALSE FALSE FALSE FALSE FALSE #> [3,]  TRUE FALSE FALSE FALSE FALSE FALSE #> [4,] FALSE FALSE FALSE FALSE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE FALSE FALSE #> [6,] FALSE FALSE FALSE FALSE FALSE FALSE # which overlap (not merely touch, and not within)? relate(p, relation=\"overlaps\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,] FALSE  TRUE FALSE FALSE FALSE FALSE #> [2,]  TRUE FALSE FALSE FALSE FALSE  TRUE #> [3,] FALSE FALSE FALSE FALSE FALSE FALSE #> [4,] FALSE FALSE FALSE FALSE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE FALSE FALSE #> [6,] FALSE  TRUE FALSE FALSE FALSE FALSE # which are within (not merely overlap)? relate(p, relation=\"within\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,]  TRUE FALSE FALSE FALSE FALSE FALSE #> [2,] FALSE  TRUE FALSE FALSE FALSE FALSE #> [3,] FALSE FALSE  TRUE FALSE FALSE FALSE #> [4,]  TRUE FALSE FALSE  TRUE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE  TRUE FALSE #> [6,] FALSE FALSE FALSE FALSE FALSE  TRUE  # do they touch or overlap or are within? relate(p, relation=\"intersects\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,]  TRUE  TRUE  TRUE  TRUE FALSE FALSE #> [2,]  TRUE  TRUE FALSE FALSE FALSE  TRUE #> [3,]  TRUE FALSE  TRUE FALSE FALSE FALSE #> [4,]  TRUE FALSE FALSE  TRUE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE  TRUE FALSE #> [6,] FALSE  TRUE FALSE FALSE FALSE  TRUE  all(relate(p, relation=\"intersects\") ==    (relate(p, relation=\"overlaps\") |     relate(p, relation=\"touches\") |    relate(p, relation=\"within\"))) #> [1] FALSE  #for polygons, \"coveredby\" is \"within\" relate(p, relation=\"coveredby\") #>       [,1]  [,2]  [,3]  [,4]  [,5]  [,6] #> [1,]  TRUE FALSE FALSE FALSE FALSE FALSE #> [2,] FALSE  TRUE FALSE FALSE FALSE FALSE #> [3,] FALSE FALSE  TRUE FALSE FALSE FALSE #> [4,]  TRUE FALSE FALSE  TRUE FALSE FALSE #> [5,] FALSE FALSE FALSE FALSE  TRUE FALSE #> [6,] FALSE FALSE FALSE FALSE FALSE  TRUE  # polygons, lines, and points   pp <- rbind(p1, p2) L1 <- vect(\"LINESTRING(1 11, 4 6, 10 6)\") L2 <- vect(\"LINESTRING(8 14, 12 10)\") L3 <- vect(\"LINESTRING(1 8, 12 14)\") lns <- rbind(L1, L2, L3) pts <- vect(cbind(c(7,10,10), c(3,5,6)))  plot(pp, col=rainbow(2, alpha=.5)) text(pp, paste0(\"POL\", 1:2), halo=TRUE) lines(pp, lwd=2) lines(lns, col=rainbow(3), lwd=4) text(lns, paste0(\"L\", 1:3), halo=TRUE) points(pts, cex=1.5) text(pts, paste0(\"PT\", 1:3), halo=TRUE, pos=4)    relate(lns, relation=\"crosses\") #>       [,1]  [,2]  [,3] #> [1,] FALSE FALSE  TRUE #> [2,] FALSE FALSE  TRUE #> [3,]  TRUE  TRUE FALSE relate(lns, pp, relation=\"crosses\")  #>       [,1]  [,2] #> [1,]  TRUE FALSE #> [2,] FALSE FALSE #> [3,]  TRUE  TRUE relate(lns, pp, relation=\"touches\")  #>       [,1]  [,2] #> [1,] FALSE  TRUE #> [2,] FALSE FALSE #> [3,] FALSE FALSE relate(lns, pp, relation=\"intersects\")  #>       [,1] [,2] #> [1,]  TRUE TRUE #> [2,] FALSE TRUE #> [3,]  TRUE TRUE  relate(lns, pp, relation=\"within\") #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE  TRUE #> [3,] FALSE FALSE # polygons can contain lines or points, not the other way around relate(lns, pp, relation=\"contains\")  #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE FALSE #> [3,] FALSE FALSE relate(pp, lns, relation=\"contains\")  #>       [,1]  [,2]  [,3] #> [1,] FALSE FALSE FALSE #> [2,] FALSE  TRUE FALSE # points and lines can be covered by polygons relate(lns, pp, relation=\"coveredby\") #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE  TRUE #> [3,] FALSE FALSE  relate(pts, pp, \"within\") #>       [,1]  [,2] #> [1,]  TRUE FALSE #> [2,] FALSE FALSE #> [3,] FALSE FALSE relate(pts, pp, \"touches\") #>       [,1]  [,2] #> [1,] FALSE FALSE #> [2,] FALSE FALSE #> [3,] FALSE  TRUE relate(pts, lns, \"touches\") #>       [,1]  [,2]  [,3] #> [1,] FALSE FALSE FALSE #> [2,] FALSE FALSE FALSE #> [3,]  TRUE FALSE FALSE"},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":null,"dir":"Reference","previous_headings":"","what":"Replicate layers — rep","title":"Replicate layers — rep","text":"Replicate layers SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replicate layers — rep","text":"","code":"# S4 method for SpatRaster rep(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replicate layers — rep","text":"x SpatRaster ... arguments rep","code":""},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replicate layers — rep","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/rep.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replicate layers — rep","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- rep(s, 2) nlyr(x) #> [1] 6 names(x) #> [1] \"red\"   \"green\" \"blue\"  \"red\"   \"green\" \"blue\"  x #> class       : SpatRaster  #> dimensions  : 77, 101, 6  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green, blue, red, green, blue  #> min values  :   0,     0,    0,   0,     0,    0  #> max values  : 255,   255,  255, 255,   255,  255"},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace with $<- — replace_dollar","title":"Replace with $<- — replace_dollar","text":"Replace layer SpatRaster, attribute variable SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace with $<- — replace_dollar","text":"","code":"# S4 method for SpatRaster $(x, name) <- value  # S4 method for SpatVector $(x, name)<-value  # S4 method for SpatExtent $(x, name) <- value"},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace with $<- — replace_dollar","text":"x SpatRaster, SpatVector SpatExtent name character. x SpatRaster: layer name. x SpatVector: variable name. x SpatExtent: \"xmin\", \"xmax\". \"ymin\" \"ymax\" value x SpatRaster, SpatRaster TRUE: nlyr(value) == length(); x SpatVector, vector new values; x SpatExtent single number","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace with $<- — replace_dollar","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/replace_dollar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace with $<- — replace_dollar","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v$ID_1 <- LETTERS[1:12] v$new <- sample(12) values(v) #>    ID_1       NAME_1 ID_2           NAME_2 AREA    POP new #> 1     A     Diekirch    1         Clervaux  312  18081  12 #> 2     B     Diekirch    2         Diekirch  218  32543   5 #> 3     C     Diekirch    3          Redange  259  18664  10 #> 4     D     Diekirch    4          Vianden   76   5163   4 #> 5     E     Diekirch    5            Wiltz  263  16735   9 #> 6     F Grevenmacher    6       Echternach  188  18899   1 #> 7     G Grevenmacher    7           Remich  129  22366   2 #> 8     H Grevenmacher   12     Grevenmacher  210  29828   3 #> 9     I   Luxembourg    8         Capellen  185  48187  11 #> 10    J   Luxembourg    9 Esch-sur-Alzette  251 176820   6 #> 11    K   Luxembourg   10       Luxembourg  237 182607   7 #> 12    L   Luxembourg   11           Mersch  233  32112   8"},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace layers or variables — replace_layers","title":"Replace layers or variables — replace_layers","text":"Replace layers SpatRaster (layers ) another SpatRaster replace variables SpatVector. can also create new layers/variables methods.","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace layers or variables — replace_layers","text":"","code":"# S4 method for SpatRaster,numeric [[(x, i) <- value  # S4 method for SpatRaster,character [[(x, i) <- value  # S4 method for SpatVector,numeric [[(x, i) <- value  # S4 method for SpatVector,character [[(x, i) <- value"},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace layers or variables — replace_layers","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace layers or variables — replace_layers","text":"x SpatRaster SpatVector x SpatRaster: layer number(s) name(s). x SpatVector: variable  number(s) name(s) (column attributes) value x SpatRaster: SpatRaster TRUE: nlyr(value) == length(). x SpatVector: vector data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/replace_layers.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace layers or variables — replace_layers","text":"","code":"# raster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s[[\"red\"]] <- mean(s) s[[2]] <- sqrt(s[[1]])  # vector v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[[\"ID_1\"]] <- 12:1"},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace values of a SpatRaster — replace_values","title":"Replace values of a SpatRaster — replace_values","text":"Replace values SpatRaster. convenience functions smaller objects . larger rasters see link{classify} subst","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace values of a SpatRaster — replace_values","text":"","code":"# S4 method for SpatRaster,ANY,ANY,ANY [(x, i, j, k) <- value  # S4 method for SpatVector,ANY,ANY [(x, i, j) <- value  # S4 method for SpatExtent,numeric,missing [(x, i, j) <- value"},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace values of a SpatRaster — replace_values","text":"x SpatRaster row numbers. numeric, logical, missing rows. Can also SpatRaster SpatVector j column numbers. numeric, logical missing columns k layer number. numeric, logical missing layers value numeric, matrix, data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace values of a SpatRaster — replace_values","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/replace_values.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace values of a SpatRaster — replace_values","text":"","code":"## SpatRaster r <- rast(ncols=5, nrows=5, xmin=0, xmax=5, ymin=0, ymax=5) r[] <- 1:25 r[1,] <- 5 r[,2] <- 10 r[r>10] <- NA  ## SpatVector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) v[2,2] <- \"hello\" v[1,] <- v[10,] v[,3] <- v[,1] v[2, \"NAME_2\"] <- \"terra\" head(v, 3) #>   ID_1     NAME_1 ID_2           NAME_2 AREA    POP #> 1    3 Luxembourg    3 Esch-sur-Alzette  251 176820 #> 2    1      hello    1            terra  218  32543 #> 3    1   Diekirch    1          Redange  259  18664"},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":null,"dir":"Reference","previous_headings":"","what":"Transfer values of a SpatRaster to another one with a different geometry — resample","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"resample transfers values SpatRaster objects align (different origin /resolution). See project change coordinate reference system (crs). origin extent input output , consider using functions instead: aggregate, disagg, extend crop.","code":""},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"","code":"# S4 method for SpatRaster,SpatRaster resample(x, y, method, threads=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"x SpatRaster resampled y SpatRaster geometry x resampled method character. Method used estimating new cell values. One : near: nearest neighbor. method fast, can preferred method cell values represent classes. good choice continuous values. used default first layer x categorical. bilinear: bilinear interpolation. default first layer x numeric (categorical). cubic: cubic interpolation. cubicspline: cubic spline interpolation. lanczos: Lanczos windowed sinc resampling. sum: weighted sum non-NA contributing grid cells. min, q1, med, q3, max, average, mode, rms: minimum, first quartile, median, third quartile, maximum, mean, mode, root-mean-square value non-NA contributing grid cells.  threads logical. TRUE multiple threads used (faster large files) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/resample.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transfer values of a SpatRaster to another one with a different geometry — resample","text":"","code":"r <- rast(nrows=3, ncols=3, xmin=0, xmax=10, ymin=0, ymax=10) values(r) <- 1:ncell(r) s <- rast(nrows=25, ncols=30, xmin=1, xmax=11, ymin=-1, ymax=11) x <- resample(r, s, method=\"bilinear\")  opar <- par(no.readonly =TRUE) par(mfrow=c(1,2)) plot(r) plot(x)  par(opar)"},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":null,"dir":"Reference","previous_headings":"","what":"rescale — rescale","title":"rescale — rescale","text":"Rescale SpatVector SpatRaster. may useful make small inset maps georeferencing.","code":""},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rescale — rescale","text":"","code":"# S4 method for SpatRaster rescale(x, fx=0.5, fy=fx, x0, y0)  # S4 method for SpatVector rescale(x, fx=0.5, fy=fx, x0, y0)"},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rescale — rescale","text":"x SpatVector SpatRaster fx numeric > 0. horizontal scaling factor fy numeric > 0. vertical scaling factor x0 numeric. x-coordinate center rescaling. missing, center extent x used y0 numeric. y-coordinate center rescaling. missing, center extent x used","code":""},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rescale — rescale","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rescale.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"rescale — rescale","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- rescale(v, 0.2) plot(v) lines(w, col=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":null,"dir":"Reference","previous_headings":"","what":"Rolling (moving) functions — roll","title":"Rolling (moving) functions — roll","text":"Compute \"rolling\" \"moving\" values, \"rolling average\" cell SpatRaster. See focal spatially moving averages similar computations. see cumsum cum* functions compute cumulate values.","code":""},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rolling (moving) functions — roll","text":"","code":"# S4 method for SpatRaster roll(x, n, fun=mean, type=\"around\", circular=FALSE,       na.rm=FALSE, filename=\"\", ..., wopt=list())   # S4 method for numeric roll(x, n, fun=mean, type=\"around\", circular=FALSE, na.rm=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rolling (moving) functions — roll","text":"x SpatRaster numeric n integer > 1. size \"window\", , number sequential cells use fun fun function like mean, min, max, sum type character. One \"around\", \"\", \"\". choice indicates values used computation. focal cell always used. type \"around\", (n-1)/2 focal cell also included. type = \"\", n-1 cells focal cell included. type = \"\", n-1 cells focal cell included. example, using n=3 element 5 vector; \"around\" used elements 4,5,6; \"\" used elements 3,4,5, \"\" uses elements 5,6,7 circular logical. TRUE, data considered circular nature (e.g. days months year), missing values first last value. na.rm logical. TRUE, NA values ignored (fun) filename character. Output filename ... additional arguments fun wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rolling (moving) functions — roll","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/roll.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rolling (moving) functions — roll","text":"","code":"## numeric roll(1:12, 3, mean) #>  [1] NA  2  3  4  5  6  7  8  9 10 11 NA roll(1:12, 3, mean, \"to\") #>  [1] NA NA  2  3  4  5  6  7  8  9 10 11 roll(1:12, 3, mean, circular=TRUE) #>  [1]  5  2  3  4  5  6  7  8  9 10 11  8  ## SpatRaster r <- rast(ncol=2, nrow=2, nlyr=10, vals=1) r[1,2] = 2 r[2,2] = 4  roll(r, n=3, \"sum\", \"from\", na.rm=FALSE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3   NaN    NaN #> [2,]     6     6     6     6     6     6     6     6   NaN    NaN #> [3,]     3     3     3     3     3     3     3     3   NaN    NaN #> [4,]    12    12    12    12    12    12    12    12   NaN    NaN roll(r, n=3, \"sum\", \"from\", na.rm=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3     2      1 #> [2,]     6     6     6     6     6     6     6     6     4      2 #> [3,]     3     3     3     3     3     3     3     3     2      1 #> [4,]    12    12    12    12    12    12    12    12     8      4 roll(r, n=3, \"sum\", \"from\", circular=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3     3      3 #> [2,]     6     6     6     6     6     6     6     6     6      6 #> [3,]     3     3     3     3     3     3     3     3     3      3 #> [4,]    12    12    12    12    12    12    12    12    12     12  roll(r, n=3, \"sum\", \"to\", na.rm=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     1     2     3     3     3     3     3     3     3      3 #> [2,]     2     4     6     6     6     6     6     6     6      6 #> [3,]     1     2     3     3     3     3     3     3     3      3 #> [4,]     4     8    12    12    12    12    12    12    12     12  roll(r, n=3, \"sum\", \"around\", circular=TRUE) |> values() #>      lyr.1 lyr.2 lyr.3 lyr.4 lyr.5 lyr.6 lyr.7 lyr.8 lyr.9 lyr.10 #> [1,]     3     3     3     3     3     3     3     3     3      3 #> [2,]     6     6     6     6     6     6     6     6     6      6 #> [3,]     3     3     3     3     3     3     3     3     3      3 #> [4,]    12    12    12    12    12    12    12    12    12     12"},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":null,"dir":"Reference","previous_headings":"","what":"Rotate data along longitude — rotate","title":"Rotate data along longitude — rotate","text":"Rotate SpatRaster longitude coordinates 0 360, standard coordinates -180 180 degrees (vice-versa). Longitude 0 360 frequently used global climate models. Rotate SpatVector SpatRaster split=TRUE, correct coordinates connected across date line (end \"side\" longitude scale) reconnected.","code":""},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rotate data along longitude — rotate","text":"","code":"# S4 method for SpatRaster rotate(x, left=TRUE, filename=\"\", ...)  # S4 method for SpatVector rotate(x, longitude=0, split=FALSE, left=TRUE, normalize=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rotate data along longitude — rotate","text":"x SpatRaster SpatVector left logical. TRUE, rotate left, else right filename character. Output filename ... additional arguments writing files writeRaster longitude numeric. longitude around rotate split logical. geometries split longitude? normalize logical. output normalized longitudes -180 180? See normalize.longitude","code":""},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Rotate data along longitude — rotate","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/rotate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Rotate data along longitude — rotate","text":"","code":"x <- rast(nrows=9, ncols=18, nl=3, xmin=0, xmax=360) v <- rep(as.vector(t(matrix(1:ncell(x), nrow=9, ncol=18))), 3) values(x) <- v z <- rotate(x)  if (FALSE) { #SpatVector p <- rbind(c(3847903, 1983584 ), c(3847903, 5801864), c(8301883, 5801864), c(8301883, 1983584 )) p <- vect(p, \"polygons\", crs=\"+init=EPSG:3347\") d <- densify(p, 100000) g <- project(d, \"+proj=longlat\")  x <- rotate(g, 50) plot(g) lines(x, col=\"red\") }  ## rotate countries to 0-360 longitude #w <- geodata::world(path=\".\") #x <- rotate(w, long=0, split=TRUE, left=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":null,"dir":"Reference","previous_headings":"","what":"Compare coordinate reference systems — same.crs","title":"Compare coordinate reference systems — same.crs","text":"function takes two coordinate reference system descriptions compares equality.","code":""},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compare coordinate reference systems — same.crs","text":"","code":"same.crs(x, y)"},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compare coordinate reference systems — same.crs","text":"x character, SpatRaster, SpatVector, CRS, object returns something intelligible withcrs(x) y types x","code":""},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compare coordinate reference systems — same.crs","text":"logical","code":""},{"path":"https://rspatial.github.io/terra/reference/same.crs.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compare coordinate reference systems — same.crs","text":"","code":"r <- rast() same.crs(r, \"+proj=longlat\") #> [1] TRUE  same.crs(r, \"+proj=utm +zone=1\") #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":null,"dir":"Reference","previous_headings":"","what":"Take a regular sample — spatSample","title":"Take a regular sample — spatSample","text":"Take spatial sample SpatRaster, SpatVector SpatExtent. Sampling SpatVector SpatExtent always returns SpatVector points. SpatRaster, can get cell values, cell numbers (cells=TRUE), coordinates (xy=TRUE) (method=\"regular\" .raster=TRUE) get new SpatRaster extent, fewer cells. order assure regularity requesting regular sample, number cells points returned may exactly size requested.","code":""},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Take a regular sample — spatSample","text":"","code":"# S4 method for SpatRaster spatSample(x, size, method=\"random\", replace=FALSE, na.rm=FALSE,      as.raster=FALSE, as.df=TRUE, as.points=FALSE, values=TRUE, cells=FALSE,      xy=FALSE, ext=NULL, warn=TRUE, weights=NULL, exp=5, exhaustive=FALSE)  # S4 method for SpatVector spatSample(x, size, method=\"random\", strata=NULL, chess=\"\")  # S4 method for SpatExtent spatSample(x, size, method=\"random\", lonlat, as.points=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Take a regular sample — spatSample","text":"x SpatRaster, SpatVector SpatExtent size numeric. sample size. x SpatVector, can also provide vector length x case sampling done separately geometry. x SpatRaster, using method=\"regular\" can specify size two numbers (number rows columns) method character. \"regular\" \"random\", x SpatRaster, can also \"stratified\" (value x stratum) \"weights\" (value x probability weight) replace logical. TRUE, sampling replacement (method=\"random\") na.rm logical. TRUE, NAs removed. used random sampling cell values. method=\"random\", .raster=FALSE, cells=FALSE .raster logical. TRUE, SpatRaster returned .df logical. TRUE, data.frame returned instead matrix .points logical. TRUE, SpatVector points returned values logical. TRUE raster cell values returned cells logical. TRUE, cell numbers returned. method=\"stratified\" always set TRUE xy=FALSE xy logical. TRUE, cell coordinates returned ext SpatExtent NULL restrict sampling subset area x warn logical. Give warning sample size returned smaller requested weights SpatRaster. Used provide weights method=\"stratified\" strata NULL, stratified random sampling done, taking size samples stratum. x polygon geometry, strata must field name (index) x. x point geometry, strata can SpatVector polygons SpatRaster chess character. One \"\", \"white\", \"black\". stratified sampling strata SpatRaster. \"\", samples taken alternate cells, organized like \"white\" \"black\" fields chessboard lonlat logical. TRUE, sampling SpatExtent weighted cos(latitude). SpatRaster SpatVector done based crs, ignored .raster=TRUE exp numeric >= 1. \"Expansion factor\" multiplied size get initial sample used stratified samples random samples na.rm=TRUE try get least size samples exhaustive logical. TRUE na.rm=TRUE first cells NA determined sample taked cells. useful dealing large raster sparse (cells NA). Otherwise, default approach may find enough samples. used cases, especially large rasters mostly values","code":""},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Take a regular sample — spatSample","text":"numeric matrix, data.frame, SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/sample.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Take a regular sample — spatSample","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) s <- spatSample(r, 10, as.raster=TRUE) spatSample(r, 5) #>   elevation #> 1       288 #> 2        NA #> 3       497 #> 4        NA #> 5        NA spatSample(r, 5, na.rm=TRUE) #>   elevation #> 1       458 #> 2       269 #> 3       271 #> 4       142 #> 5       202 spatSample(r, 5, \"regular\") #>   elevation #> 1       479 #> 2       NaN #> 3       NaN #> 4       419 #> 5       290 #> 6       306 #> 7       281 #> 8       286 #> 9       NaN  ## if you require cell numbers and/or coordinates size <- 6 spatSample(r, 6, \"random\", cells=TRUE, xy=TRUE, values=FALSE) #>      cell        x        y #> [1,] 5800 5.779167 49.67917 #> [2,] 7874 6.437500 49.50417 #> [3,]  843 6.429167 50.12083 #> [4,]  426 6.120833 50.15417 #> [5,] 2775 5.904167 49.94583 #> [6,] 2267 6.420833 49.99583  # regular, with values  spatSample(r, 6, \"regular\", cells=TRUE, xy=TRUE) #>   cell        x        y elevation #> 1 7458 6.137500 49.53750       264 #> 2 7505 6.529167 49.53750        NA #> 3 7411 5.745833 49.53750        NA #> 4 5368 6.137500 49.72083       289 #> 5 5415 6.529167 49.72083        NA #> 6 5321 5.745833 49.72083        NA #> 7 3183 6.137500 49.91250       322 #> 8 1093 6.137500 50.09583        NA  # stratified rr <- rast(ncol=10, nrow=10, names=\"stratum\") set.seed(1) values(rr) <- round(runif(ncell(rr), 1, 3)) spatSample(rr, 2, \"stratified\", xy=TRUE) #>      x   y stratum #> 1 -126  63       1 #> 2  126 -27       1 #> 3  126  27       2 #> 4 -162  81       2 #> 5   18 -45       3 #> 6  -18  27       3  s <- spatSample(rr, 5, \"stratified\", as.points=TRUE) plot(rr, plg=list(title=\"raster\")) plot(s, 1, add=TRUE, plg=list(x=185, y=1, title=\"points\"))    ## SpatExtent  e <- ext(r) spatSample(e, 10, \"random\", lonlat=TRUE) #>              x        y #>  [1,] 6.362453 49.60080 #>  [2,] 6.214008 50.07085 #>  [3,] 5.841767 49.53690 #>  [4,] 5.832523 50.14225 #>  [5,] 6.160047 49.56096 #>  [6,] 6.504415 49.51819 #>  [7,] 6.188561 49.58855 #>  [8,] 6.299401 49.90880 #>  [9,] 6.361697 49.46779 #> [10,] 6.250035 49.81599  ## SpatVector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)  # sample the geometries  i <- sample(v, 3)  # sample points in geometries p <- spatSample(v, 3)"},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"Apply layers SpatRaster function takes single layer SpatRaster returns SpatRaster (rare). cases can also use lapply sapply . apply method sub-dataset (SpatRaster) SpatRasterDataset","code":""},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"","code":"# S4 method for SpatRaster sapp(x, fun, ..., filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRasterDataset sapp(x, fun, ..., filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"x SpatRaster SpatRasterDataset fun x SpatRaster: function takes SpatRaster argument can applied layer x (e.g. terrain.    x SpatRasterDataset: function applied layers SpatRasters x (e.g. mean ... additional arguments passed fun filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a terra function that takes only a single layer and returns a SpatRaster to all layers of a SpatRaster — sapp","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\")) + 1    #SpatRasterDataset sd <- sds(s*2, s/2) y <- sapp(sd, mean) z <- sapp(sd, \\(i) 2 * mean(i))"},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":null,"dir":"Reference","previous_headings":"","what":"scale bar — sbar","title":"scale bar — sbar","text":"Add scale bar map","code":""},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"scale bar — sbar","text":"","code":"sbar(d, xy=NULL, type=\"line\", divs=2, below=\"\", lonlat=NULL, labels,   adj=c(0.5, -1), lwd=2, xpd=TRUE, ticks=FALSE, scaleby=1, halo=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"scale bar — sbar","text":"d numeric. Distance covered scale bar. scale bar, units coordinates plot (map), km angular (longitude/latitude) data; see argument lonlat. can also missing xy numeric. x y coordinate place scale bar. can also one following character values: \"bottomleft\", \"bottom\", \"bottomright\", topleft\", \"top\", \"topright\", \"left\", \"right\", NULL type sbar: \"line\" \"bar\" divs number divisions bar: 2 4 character. Text go scale bar (e.g., \"kilometers\") lonlat logical NULL. logical, TRUE indicates plot using longitude/latitude coordinates. NULL guessed plot's coordinates labels vector three numbers label scale bar (beginning, midpoint, end) adj adjustment text placement lwd line width \"line\" type scale bar xpd logical. TRUE, scale bar can outside plotting area ticks logical numeric. FALSE, tick marks added \"line\" scale bar. length tick marks can specified scaleby numeric. labels provided. labels divided number. example, use 1000 go m km halo logical. TRUE \"line\" type scale bar gets white background ... graphical arguments passed methods","code":""},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"scale bar — sbar","text":"none","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sbar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"scale bar — sbar","text":"","code":"f <- system.file(\"ex/meuse.tif\", package=\"terra\") r <- rast(f) plot(r) sbar() sbar(1000, xy=c(178500, 333500), type=\"bar\", divs=4, cex=.8) sbar(1000, xy=\"bottomright\", divs=3, cex=.8, ticks=TRUE) north(d=250, c(178550, 332500))    f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) plot(r, type=\"interval\") sbar(20, c(6.2, 50.1), type=\"bar\", cex=.8, divs=4) sbar(15, c(6.3, 50), type=\"bar\", below=\"km\", label=c(0,7.5,15), cex=.8) sbar(15, c(6.65, 49.8), cex=.8, label=c(0,\"km\",15)) north(type=2) sbar(15, c(6.65, 49.7), cex=.8, label=\"15 kilometer\", lwd=5) sbar(15, c(6.65, 49.6), divs=4, cex=.8, below=\"km\")"},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":null,"dir":"Reference","previous_headings":"","what":"Scale values — scale","title":"Scale values — scale","text":"Center /scale raster data. details see scale","code":""},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scale values — scale","text":"","code":"# S4 method for SpatRaster scale(x, center=TRUE, scale=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scale values — scale","text":"x SpatRaster center logical numeric. TRUE, centering done subtracting layer means (omitting NAs), FALSE, centering done. center numeric vector (recycled nlyr(x)), layer x corresponding value center subtracted . scale logical numeric. TRUE, scaling done dividing (centered) layers x standard deviations center TRUE, root mean square otherwise. scale FALSE, scaling done. scale numeric vector (recycled nlyr(x)), layer x divided corresponding value. Scaling done centering.","code":""},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Scale values — scale","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/scale.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Scale values — scale","text":"","code":"r <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s <- scale(r)  ## the equivalent, computed in steps m <- global(r, \"mean\") rr <- r - m[,1] rms <- global(rr, \"rms\") ss <- rr / rms[,1]"},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":null,"dir":"Reference","previous_headings":"","what":"Scatterplot of two SpatRaster layers — scatterplot","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"Scatterplot values two SpatRaster layers","code":""},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"","code":"# S4 method for SpatRaster,SpatRaster plot(x, y, maxcell=100000, warn=TRUE, nc, nr,     maxnl=16, smooth=FALSE, gridded=FALSE, ncol=25, nrow=25, ...)"},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"x SpatRaster y SpatRaster maxcell positive integer. Maximum number cells use plot nc positive integer. Optional. number columns divide plotting device (plotting multiple layers) nr positive integer. Optional. number rows divide plotting device (plotting multiple layers) maxnl positive integer. Maximum number layers plot (multi-layer objects) smooth logical. TRUE show smooth scatterplot gridded logical. TRUE scatterplot gridded (counts cells) warn boolean. Show warning sample pixels used (scatterplot ) ncol positive integer. Number columns gridding nrow positive integer. Number rows gridding ... additional graphical arguments","code":""},{"path":"https://rspatial.github.io/terra/reference/scatter.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Scatterplot of two SpatRaster layers — scatterplot","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    plot(s[[1]], s[[2]])  plot(s, sqrt(s[[3:1]]))"},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":null,"dir":"Reference","previous_headings":"","what":"Scale (gain) and offset — scoff","title":"Scale (gain) and offset — scoff","text":"functions can used get set scale (gain) offset parameters used transform values reading raster data file. parameters applied raw values using formula : value <- value * scale + offset default value scale 1 offset 0. 'scale' sometimes referred 'gain'. Note setting scale /offset intended used values stored file. values memory, assigning scale offset values lead immediate computation new values; cases clearer use Arith-methods.","code":""},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Scale (gain) and offset — scoff","text":"","code":"# S4 method for SpatRaster scoff(x)  # S4 method for SpatRaster scoff(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Scale (gain) and offset — scoff","text":"x SpatRaster value two-column matrix scale (first column) offset (second column) layer. NULL remove scale offset values","code":""},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Scale (gain) and offset — scoff","text":"matrix changed SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/scoff.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Scale (gain) and offset — scoff","text":"","code":"r <- rast(system.file(\"ex/elev.tif\", package=\"terra\")) minmax(r) #>     elevation #> min       141 #> max       547 scoff(r) #>      scale offset #> [1,]     1      0 r[4603] #>   elevation #> 1       279  scoff(r) <- cbind(10, 5) minmax(r) #>     elevation #> min      1415 #> max      5475 scoff(r) #>      scale offset #> [1,]    10      5 r[4603] #>   elevation #> 1      2795"},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatRasterDataset — sds","title":"Create a SpatRasterDataset — sds","text":"Methods create SpatRasterDataset. object hold \"sub-datasets\", SpatRaster cases multiple layers. See describe getting information sub-datasets present file.","code":""},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatRasterDataset — sds","text":"","code":"# S4 method for missing sds(x)   # S4 method for character sds(x, ids=0, opts=NULL, raw=FALSE)  # S4 method for SpatRaster sds(x, ...)   # S4 method for list sds(x)   # S4 method for array sds(x, crs=\"\", extent=NULL)"},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatRasterDataset — sds","text":"x character (filename), SpatRaster, list SpatRasters, missing. multiple filenames provided, attempted make SpatRasters , combine SpatRasterDataset ids optional. vector integer subdataset ids. Ignored first value positive integer opts character. GDAL dataset open options raw logical. TRUE, scale offset values ignored crs character. Description Coordinate Reference System (map projection) PROJ.4, WKT authority:code notation. argument missing, x coordinates within -360 .. 360 y coordinates within -90 .. 90, longitude/latitude assigned extent SpatExtent ... additional SpatRaster objects","code":""},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatRasterDataset — sds","text":"SpatRasterDataset","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sds.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatRasterDataset — sds","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- sds(s, s/2) names(x) <- c(\"first\", \"second\") x #> class       : SpatRasterDataset  #> subdatasets : 2  #> dimensions  : 77, 101 (nrow, ncol) #> nlyr        : 3, 3  #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : logo.tif, memory  #> names       : first, second  length(x) #> [1] 2  # extract the second SpatRaster x[2] #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : memory #> varname     : logo  #> names       :   red, green,  blue  #> min values  :   0.0,   0.0,   0.0  #> max values  : 127.5, 127.5, 127.5   a <- array(1:9, c(3,3,3,3)) sds(a) #> class       : SpatRasterDataset  #> subdatasets : 3  #> dimensions  : 3, 3 (nrow, ncol) #> nlyr        : 3, 3, 3  #> resolution  : 1, 1  (x, y) #> extent      : 0, 3, 0, 3  (xmin, xmax, ymin, ymax) #> coord. ref. :   #> source(s)   : memory"},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":null,"dir":"Reference","previous_headings":"","what":"segregate — segregate","title":"segregate — segregate","text":"Create SpatRaster layer class (value, subset values) input SpatRaster. example, input vegetation types, function create layer (presence/absence; dummy variable) classes. called \"one-hot encoding\" \"dummy encoding\" (dummy encoding scheme can remove () one output layers redundant).","code":""},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"segregate — segregate","text":"","code":"# S4 method for SpatRaster segregate(x, classes=NULL, keep=FALSE, other=0, round=FALSE, digits=0, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"segregate — segregate","text":"x SpatRaster classes numeric. values (classes) layers made. NULL classes used keep logical. TRUE, cells class represented layer get value, rather value 1 numeric. Value assign cells class represented layer round logical. values rounded first? digits integer. Number digits round values filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"segregate — segregate","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/segregate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"segregate — segregate","text":"","code":"r <- rast(nrows=5, ncols=5) values(r) <- rep(c(1:4, NA), each=5) b <- segregate(r) bb <- segregate(r, keep=TRUE, other=NA)"},{"path":"https://rspatial.github.io/terra/reference/select.html","id":null,"dir":"Reference","previous_headings":"","what":"Spatial selection — sel","title":"Spatial selection — sel","text":"Geometrically subset SpatRaster SpatVector (done) drawing plot (map).","code":""},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Spatial selection — sel","text":"","code":"# S4 method for SpatRaster sel(x, ...)  # S4 method for SpatVector sel(x, use=\"rec\", show=TRUE, col=\"cyan\", draw=TRUE, ...)"},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Spatial selection — sel","text":"x SpatRaster SpatVector use character indicating draw. One \"rec\" (rectangle) \"pol\" (polygon) show logical. TRUE selected geometries shown map col color used drawing draw=TRUE draw logical. TRUE area drawn select geometries shown map ... additional graphics arguments drawing selected geometries","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Spatial selection — sel","text":"SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/select.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Spatial selection — sel","text":"","code":"if (FALSE) { # select a subset of a SpatRaster r <- rast(nrows=10, ncols=10) values(r) <- 1:ncell(r) plot(r) s <- sel(r) # now click on the map twice  # plot the selection on a new canvas: x11() plot(s)  # vector f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) plot(v) x <- sel(v) # now click on the map twice x }"},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":null,"dir":"Reference","previous_headings":"","what":"select cells with high or low values — selectHighest","title":"select cells with high or low values — selectHighest","text":"Identify n cells highest lowest values first layer SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"select cells with high or low values — selectHighest","text":"","code":"# S4 method for SpatRaster selectHighest(x, n, low=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"select cells with high or low values — selectHighest","text":"x SpatRaster. first layer processed n number cells select low logical. TRUE, lowest values selected instead highest values","code":""},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"select cells with high or low values — selectHighest","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/selectHigh.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"select cells with high or low values — selectHighest","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- selectHighest(r, 1000) y <- selectHighest(r, 1000, TRUE)  m <- merge(y-1, x) levels(m) <- data.frame(id=0:1, elevation=c(\"low\", \"high\")) plot(m)"},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":null,"dir":"Reference","previous_headings":"","what":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"Use single layer SpatRaster select cell values different layers multi-layer SpatRaster. values SpatRaster select layers (y) whole numbers 1 nlyr(x) (values outside range ignored). See rapp applying function range variable size. See extract extraction values cell, point, otherwise.","code":""},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"","code":"# S4 method for SpatRaster selectRange(x, y, z=1, repint=0, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"x SpatRaster y SpatRaster. Cell values must positive integers. indicate first layer select cell z positive integer. number layers select repint integer > 1 < nlyr(x) allowing repeated selection fixed interval. example, x 36 layers, value cell y=2 repint = 12, values layers 2, 14 26 returned filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/selectRange.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Select the values of a range of layers, as specified by cell values in another SpatRaster — selectRange","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1 s <- c(r, r+2, r+5) s <- c(s, s) set.seed(1) values(r) <- sample(3, ncell(r), replace=TRUE) x <- selectRange(s, r)  x <- selectRange(s, r, 3)"},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":null,"dir":"Reference","previous_headings":"","what":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"serialize saveRDS SpatVector, SpatRaster, SpatRasterDataset SpatRasterCollection. Note objects first \"packed\" wrap, unserialize/readRDS need unpacked rast vect. Extensive use functions recommended. Especially SpatRaster generally much efficient use writeRaster write, e.g., GTiff file.","code":""},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"","code":"# S4 method for SpatRaster saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatRasterDataset saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatRasterCollection saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatVector saveRDS(object, file=\"\", ascii = FALSE, version = NULL, compress=TRUE, refhook = NULL)  # S4 method for SpatRaster serialize(object, connection, ascii = FALSE, xdr = TRUE, version = NULL, refhook = NULL)  # S4 method for SpatVector serialize(object, connection, ascii = FALSE, xdr = TRUE, version = NULL, refhook = NULL)"},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"object SpatVector, SpatRaster, SpatRasterDataset SpatRasterCollection file file name save object connection see serialize ascii see serialize saveRDS version see serialize saveRDS compress see serialize saveRDS refhook see serialize saveRDS xdr see serialize saveRDS","code":""},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"Packed* object","code":""},{"path":"https://rspatial.github.io/terra/reference/serialize.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"saveRDS and serialize for SpatVector and SpatRaster* — serialize","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) p <- serialize(v, NULL) head(p) #> [1] 58 0a 00 00 00 03 x <- unserialize(p) x #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664"},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":null,"dir":"Reference","previous_headings":"","what":"Set the values of raster cells or of geometry attributes — setValues","title":"Set the values of raster cells or of geometry attributes — setValues","text":"Set cell values SpatRaster attributes SpatVector. large SpatRasters use init instead set values.","code":""},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set the values of raster cells or of geometry attributes — setValues","text":"","code":"# S4 method for SpatRaster,ANY values(x)<-value  # S4 method for SpatRaster,ANY setValues(x, values, keeptime=TRUE, keepunits=TRUE, keepnames=FALSE, props=FALSE)  # S4 method for SpatVector,ANY values(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set the values of raster cells or of geometry attributes — setValues","text":"x SpatRaster SpatVector value SpatRaster: numeric, matrix data.frame. length numeric values must match total number cells (ncell(x) * nlyr(x)), single value. number columns matrix data.frame must match number layers x, number rows must match number cells x. also possible use matrix number rows x number columns matches ncol(x) * nlyr(x). SpatVector: data.frame, matrix, vector, NULL values value keeptime logical. TRUE time stamps kept keepunits logical. FALSE units discarded keepnames logical. FALSE layer names replaced column names y (present) props logical. TRUE properties (categories color-table) kept","code":""},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set the values of raster cells or of geometry attributes — setValues","text":"object type x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/setValues.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set the values of raster cells or of geometry attributes — setValues","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- setValues(r, 1:ncell(r)) x #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> name        : elevation  #> min value   :         1  #> max value   :      8550  values(x) <- runif(ncell(x)) x #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> name        :    elevation  #> min value   : 0.0001064336  #> max value   : 0.9999305937  head(x) #>    elevation #> 1 0.20754511 #> 2 0.22865814 #> 3 0.59571200 #> 4 0.57487220 #> 5 0.07706438 #> 6 0.03554058  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) values(v) <- data.frame(ID=1:12, name=letters[1:12]) head(v) #>   ID name #> 1  1    a #> 2  2    b #> 3  3    c #> 4  4    d #> 5  5    e #> 6  6    f"},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":null,"dir":"Reference","previous_headings":"","what":"Hill shading — shade","title":"Hill shading — shade","text":"Compute hill shade slope aspect layers (radians). Slope aspect can computed function terrain. hill shade layer often used backdrop top another, semi-transparent, layer drawn.","code":""},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Hill shading — shade","text":"","code":"shade(slope, aspect, angle=45, direction=0, normalize=FALSE,    filename=\"\", overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Hill shading — shade","text":"slope SpatRasterwith slope values (radians) aspect SpatRaster aspect values (radians) angle elevation angle(s) light source (sun), degrees direction direction (azimuth) angle(s) light source (sun), degrees normalize Logical. TRUE, values zero set zero results multiplied 255 filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Hill shading — shade","text":"Horn, B.K.P., 1981. Hill shading reflectance map. Proceedings IEEE 69(1):14-47","code":""},{"path":"https://rspatial.github.io/terra/reference/shade.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Hill shading — shade","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) alt <- disagg(r, 10, method=\"bilinear\") slope <- terrain(alt, \"slope\", unit=\"radians\") aspect <- terrain(alt, \"aspect\", unit=\"radians\") hill <- shade(slope, aspect, 40, 270) plot(hill, col=grey(0:100/100), legend=FALSE, mar=c(2,2,1,4)) plot(alt, col=rainbow(25, alpha=0.35), add=TRUE)   # A better hill shade may be achieved by combining  # different angles and directions. For example  h <- shade(slope, aspect, angle = c(45, 45, 45, 80), direction = c(225, 270, 315, 135)) h <- Reduce(mean, h)"},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":null,"dir":"Reference","previous_headings":"","what":"Shared paths — sharedPaths","title":"Shared paths — sharedPaths","text":"Get shared paths line polygon geometries. can geometries single SpatVector, two SpatVectors","code":""},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Shared paths — sharedPaths","text":"","code":"# S4 method for SpatVector sharedPaths(x, y=NULL)"},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Shared paths — sharedPaths","text":"x SpatVector lines polygons y missing SpatVector lines polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Shared paths — sharedPaths","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sharedPaths.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Shared paths — sharedPaths","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) plot(v, col=\"light gray\") text(v, halo=TRUE)  x <- sharedPaths(v) lines(x, col=\"red\", lwd=2) text(x, col=\"blue\", halo=TRUE, cex=0.8)  head(x) #>   id1 id2 #> 1   1   2 #> 2   1   4 #> 3   1   5 #> 4   2   3 #> 5   2   4 #> 6   2   5  z <- sharedPaths(v[3,], v[12,])"},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":null,"dir":"Reference","previous_headings":"","what":"Shift — shift","title":"Shift — shift","text":"Shift SpatRaster, SpatVector SpatExtent another location.","code":""},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Shift — shift","text":"","code":"# S4 method for SpatRaster shift(x, dx=0, dy=0, filename=\"\", ...)  # S4 method for SpatVector shift(x, dx=0, dy=0)  # S4 method for SpatExtent shift(x, dx=0, dy=0)"},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Shift — shift","text":"x SpatRaster, SpatVector SpatExtent dx numeric. shift horizontal direction dy numeric. shift vertical direction filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Shift — shift","text":"x","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/shift.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Shift — shift","text":"","code":"r <- rast(xmin=0, xmax=1, ymin=0, ymax=1) r <- shift(r, dx=1, dy=-1)  e <- ext(r) shift(e, 5, 5) #> SpatExtent : 6, 7, 4, 5 (xmin, xmax, ymin, ymax)"},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":null,"dir":"Reference","previous_headings":"","what":"Sieve filter — sieve","title":"Sieve filter — sieve","text":"Apply sieve filter. , remove \"noise\", changing small clumps cells value different surrounding cells, value largest neighboring clump. Note input raster data rounded integers.","code":""},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sieve filter — sieve","text":"","code":"# S4 method for SpatRaster sieve(x, threshold, directions=8, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sieve filter — sieve","text":"x SpatRaster, single layer elevation values. Values unit map units threshold positive integer. clumps smaller threshold removed directions numeric indicate cells connected. Either 4 consider horizontal vertical neighbors (\"rook\"), 8 consider vertical, horizontal diagonal neighbors filename character. Output filename ... Options writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sieve.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Sieve filter — sieve","text":"","code":"r <- rast(nrows=18, ncols=18, xmin=0, vals=0, crs=\"local\") r[2, 5] <- 1 r[5:8, 2:3] <- 2 r[7:12, 10:15] <- 3 r[15:16, 15:18] <- 4 freq(r, bylayer=FALSE) #>   value count #> 1     0   271 #> 2     1     1 #> 3     2     8 #> 4     3    36 #> 5     4     8  x <- sieve(r, 8) y <- sieve(r, 9)"},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":null,"dir":"Reference","previous_headings":"","what":"simplifyGeom geometries — simplifyGeom","title":"simplifyGeom geometries — simplifyGeom","text":"Reduce number nodes used represent geometries.","code":""},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"simplifyGeom geometries — simplifyGeom","text":"","code":"# S4 method for SpatVector simplifyGeom(x, tolerance=0.1, preserveTopology=TRUE, makeValid=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"simplifyGeom geometries — simplifyGeom","text":"x SpatVector lines polygons tolerance numeric. minimum distance nodes units crs (.e. degrees long/lat) preserveTopology logical. TRUE topology output geometries preserved makeValid logical. TRUE, makeValid run simplification assure output polygons valid","code":""},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"simplifyGeom geometries — simplifyGeom","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/simplify.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"simplifyGeom geometries — simplifyGeom","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- simplifyGeom(v, .02, makeValid=FALSE) e <- erase(w) g <- gaps(e) plot(e, lwd=5, border=\"light gray\") polys(g, col=\"red\", border=\"red\")"},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":null,"dir":"Reference","previous_headings":"","what":"Sort a SpatRaster or SpatVector — sort","title":"Sort a SpatRaster or SpatVector — sort","text":"Sort cell values SpatRaster across layers. can also compute sorting order. sort records SpatVector (data.frame) specifying column number(s) names(s) sort .","code":""},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sort a SpatRaster or SpatVector — sort","text":"","code":"# S4 method for SpatRaster sort(x, decreasing=FALSE, order=FALSE, filename=\"\", ...)  # S4 method for SpatVector sort(x, v, decreasing=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sort a SpatRaster or SpatVector — sort","text":"x SpatRaster decreasing logical. TRUE, sorting decreasing order order logical. TRUE sorting order returned instead sorted values filename character. Output filename ... additional arguments writing files writeRaster v character numeric indicating column(s) sort ","code":""},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sort a SpatRaster or SpatVector — sort","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/sort.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Sort a SpatRaster or SpatVector — sort","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) r <- c(r, r/2, r*2) sort(r) #> class       : SpatRaster  #> dimensions  : 90, 95, 3  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> names       : elevation, elevation, elevation  #> min values  :      70.5,       141,       282  #> max values  :     273.5,       547,      1094   ord <- sort(r, order=TRUE) # these two are the same  ord[[1]] #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> varname     : elev  #> name        : elevation  #> min value   :         0  #> max value   :         1  which.min(r) #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : memory #> name        : which.min  #> min value   :         2  #> max value   :         2"},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":null,"dir":"Reference","previous_headings":"","what":"Data sources of a SpatRaster — sources","title":"Data sources of a SpatRaster — sources","text":"Get data sources SpatRaster SpatVector related object. Sources either files (similar resources) \"\", meaning memory. can use hasValues check -memory layers actually cell values.","code":""},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data sources of a SpatRaster — sources","text":"","code":"# S4 method for SpatRaster sources(x, nlyr=FALSE, bands=FALSE)  # S4 method for SpatVector sources(x)  # S4 method for SpatRaster hasValues(x)  # S4 method for SpatRaster inMemory(x, bylayer=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Data sources of a SpatRaster — sources","text":"x SpatRaster, SpatRasterCollection, SpatVector SpatVectorProxy nlyr logical. TRUE source, number layers returned bands logical. TRUE source, \"bands\" used, , layer number source file, returned bylayer logical. TRUE value returned layer instead source","code":""},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Data sources of a SpatRaster — sources","text":"vector filenames, \"\" filename, nlyr bands FALSE. Otherwise data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/sources.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data sources of a SpatRaster — sources","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) s <- rast(r) values(s) <- 1:ncell(s) rs <- c(r,r,s,r) sources(rs) #> [1] \"/Users/runner/work/_temp/Library/terra/ex/elev.tif\" #> [2] \"/Users/runner/work/_temp/Library/terra/ex/elev.tif\" #> [3] \"\"                                                   #> [4] \"/Users/runner/work/_temp/Library/terra/ex/elev.tif\" hasValues(r) #> [1] TRUE x <- rast() hasValues(x) #> [1] FALSE"},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":null,"dir":"Reference","previous_headings":"","what":"spin a SpatVector — spin","title":"spin a SpatVector — spin","text":"Spin (rotate) geometry SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"spin a SpatVector — spin","text":"","code":"# S4 method for SpatVector spin(x, angle, x0, y0)"},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"spin a SpatVector — spin","text":"x SpatVector angle numeric. Angle rotation degrees x0 numeric. x-coordinate center rotation. missing, center extent x used y0 numeric. y-coordinate center rotation. missing, center extent x used","code":""},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"spin a SpatVector — spin","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/spin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"spin a SpatVector — spin","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) w <- spin(v, 180) plot(v) lines(w, col=\"red\")   # lower-right corner as center e <- as.vector(ext(v)) x <- spin(v, 45, e[1], e[3])"},{"path":"https://rspatial.github.io/terra/reference/split.html","id":null,"dir":"Reference","previous_headings":"","what":"Split — split","title":"Split — split","text":"Split SpatRaster layer, SpatVector attributes. can also split geometry polygon SpatVector another SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split — split","text":"","code":"# S4 method for SpatRaster,ANY split(x, f)  # S4 method for SpatVector,ANY split(x, f)  # S4 method for SpatVector,SpatVector split(x, f)"},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split — split","text":"x SpatRaster SpatVector f x SpatRaster: vector length nlyr(x). x SpatVector: field (variable) name vector length x; , x SpatVector polygons, SpatVector lines polygons split polygon geometries","code":""},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Split — split","text":"list SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/split.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split — split","text":"","code":"## split layers s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    y <- split(s, c(1,2,1)) sds(y) #> class       : SpatRasterDataset  #> subdatasets : 2  #> dimensions  : 77, 101 (nrow, ncol) #> nlyr        : 2, 1  #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source(s)   : logo.tif   ## split attributes v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) x <- split(v, \"NAME_1\")  ## split geometries v <- v[1:5,] line <- vect(matrix(c(5.79, 6.22, 5.75, 6.1, 5.8,    50.14, 50.05, 49.88, 49.85, 49.71), ncol=2), \"line\") s <- split(v, line)"},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatRasterCollection — sprc","title":"Create a SpatRasterCollection — sprc","text":"Methods create SpatRasterCollection. object hold collection (list) SpatRasters. restrictions similarity SpatRaster geometry. can used combine several SpatRasters used merge mosaic can create SpatRasterCollection file subdatasets.","code":""},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatRasterCollection — sprc","text":"","code":"# S4 method for character sprc(x, ids=0, opts=NULL, raw=FALSE)   # S4 method for SpatRaster sprc(x, ...)   # S4 method for list sprc(x)   # S4 method for missing sprc(x)"},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatRasterCollection — sprc","text":"x SpatRaster, list SpatRasters, missing, filename ids optional. vector integer subdataset ids. Ignored first value positive integer opts character. GDAL dataset open options raw logical. TRUE, scale offset values ignored ... additional SpatRasters","code":""},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatRasterCollection — sprc","text":"SpatRasterCollection","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/sprc.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatRasterCollection — sprc","text":"","code":"x <- rast(xmin=-110, xmax=-50, ymin=40, ymax=70, ncols=60, nrows=30) y <- rast(xmin=-80, xmax=-20, ymax=60, ymin=30) res(y) <- res(x) values(x) <- 1:ncell(x) values(y) <- 1:ncell(y)  z <- sprc(x, y) z #> class       : SpatRasterCollection  #> length      : 2  #> nrow        : 30, 30  #> ncol        : 60, 60  #> nlyr        :  1,  1  #> extent      : -110, -20, 30, 70  (xmin, xmax, ymin, ymax) #> crs (first) : lon/lat WGS 84 (CRS84) (OGC:CRS84)"},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":null,"dir":"Reference","previous_headings":"","what":"Stretch — stretch","title":"Stretch — stretch","text":"Linear histogram equalization stretch values SpatRaster. linear stretch, provide desired output range (minv maxv) lower upper bounds original data, either quantiles (minq maxq, cell values (smin smax). smin smax NA, minq maxq ignored. histogram equalization, arguments ignored, can provide desired scale output maximum number cells used compute histogram (empirical cumulative distribution function).","code":""},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Stretch — stretch","text":"","code":"# S4 method for SpatRaster stretch(x, minv=0, maxv=255, minq=0, maxq=1, smin=NA, smax=NA,     histeq=FALSE, scale=1, maxcell=500000, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Stretch — stretch","text":"x SpatRaster minv numeric >= 0 smaller maxv. lower bound stretched value maxv numeric <= 255 larger maxv. upper bound stretched value minq numeric >= 0 smaller maxq. lower quantile bound original value. Ignored smin supplied maxq numeric <= 1 larger minq. upper quantile bound original value. Ignored smax supplied smin numeric < smax. user supplied lower value layers, used instead quantile computed function smax numeric > smin. user supplied upper value layers, used instead quantile computed function histeq logical. TRUE histogram equalization used instead linear stretch scale numeric. scale (maximum value) output histeq=TRUE maxcell positive integer. size regular sample used compute histogram filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Stretch — stretch","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/stretch.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Stretch — stretch","text":"","code":"r <- rast(nc=10, nr=10) values(r) <- rep(1:25, 4) rs <- stretch(r) s <- c(r, r*2) sr <- stretch(s)"},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":null,"dir":"Reference","previous_headings":"","what":"Subset a SpatRaster or a SpatVector — subset","title":"Subset a SpatRaster or a SpatVector — subset","text":"Select subset layers SpatRaster select subset records (row) /variables (columns) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Subset a SpatRaster or a SpatVector — subset","text":"","code":"# S4 method for SpatRaster subset(x, subset, negate=FALSE, NSE=FALSE, filename=\"\", overwrite=FALSE, ...)  # S4 method for SpatVector subset(x, subset, select, drop=FALSE, NSE=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Subset a SpatRaster or a SpatVector — subset","text":"x SpatRaster SpatVector subset x SpatRaster: integer character select layers x SpatVector: logical expression indicating rows keep (missing values taken FALSE) select expression, indicating columns select negate logical. TRUE layers subset selected NSE logical. TRUE, non-standard evaluation (use unquoted variable names) allowed. Set FALSE calling subset function drop logical. TRUE, geometries dropped, data.frame returned filename character. Output filename overwrite logical. TRUE, filename overwritten ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Subset a SpatRaster or a SpatVector — subset","text":"x SpatRaster: SpatRaster x SpatVector: SpatVector , drop=TRUE, data.frame.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Subset a SpatRaster or a SpatVector — subset","text":"","code":"### SpatRaster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    subset(s, 2:3) #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : green, blue  #> min values  :     0,    0  #> max values  :   255,  255  subset(s, c(3,2,3,1)) #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255   #equivalent to  s[[ c(3,2,3,1) ]] #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255   s[[c(\"red\", \"green\")]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s$red #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # expression based (partial) matching of names with single brackets s[\"re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s[\"^re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # not with double brackets # s[[\"re\"]]   ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\"))  subset(v, v$NAME_1 == \"Diekirch\", c(\"NAME_1\", \"NAME_2\")) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange  subset(v, NAME_1 == \"Diekirch\", c(NAME_1, NAME_2), NSE=TRUE) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange  # or like this v[2:3,] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 6  (geometries, attributes) #>  extent      : 5.746118, 6.315773, 49.69933, 49.98745  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 v[1:2, 2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2 v[1:2, c(\"NAME_1\", \"NAME_2\")] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch"},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":null,"dir":"Reference","previous_headings":"","what":"Subset a SpatRaster or a SpatVector — subset_dollar","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"Select subset layers SpatRaster select subset records (row) /variables (columns) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"","code":"# S4 method for SpatExtent $(x, name)"},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"x SpatRaster, SpatVector SpatExtent name character. x SpatRaster: layer name. x SpatVector: variable name. x SpatExtent: xmin, xmax, ymin ymax","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"x SpatRaster: SpatRaster x SpatVector: SpatVector , drop=TRUE, data.frame.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subset_dollar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Subset a SpatRaster or a SpatVector — subset_dollar","text":"","code":"### SpatRaster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    subset(s, 2:3) #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : green, blue  #> min values  :     0,    0  #> max values  :   255,  255  subset(s, c(3,2,3,1)) #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255  #equivalent to  s[[ c(3,2,3,1) ]] #> class       : SpatRaster  #> dimensions  : 77, 101, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : blue, green, blue, red  #> min values  :    0,     0,    0,   0  #> max values  :  255,   255,  255, 255   s[[c(\"red\", \"green\")]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s$red #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # expression based (partial) matching of names with single brackets s[\"re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s[\"^re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # not with double brackets # s[[\"re\"]]   ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[2:3,] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 6  (geometries, attributes) #>  extent      : 5.746118, 6.315773, 49.69933, 49.98745  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 v[1:2, 2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2  subset(v, v$NAME_1 == \"Diekirch\", c(\"NAME_1\", \"NAME_2\")) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange  subset(v, NAME_1 == \"Diekirch\", c(NAME_1, NAME_2), NSE=TRUE) #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : 5.74414, 6.315773, 49.69933, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1   NAME_2 #>  type        :    <chr>    <chr> #>  values      : Diekirch Clervaux #>                Diekirch Diekirch #>                Diekirch  Redange"},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":null,"dir":"Reference","previous_headings":"","what":"Subset a SpatRaster or a SpatVector — subset_double","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"Select subset layers SpatRaster select subset records (row) /variables (columns) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"","code":"# S4 method for SpatRaster,numeric,missing [[(x, i, j)  # S4 method for SpatRasterDataset,ANY,ANY [[(x, i, j, drop=TRUE)  # S4 method for SpatVector,numeric,missing [[(x, i, j, drop=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"x SpatRaster SpatVector x SpatRaster: integer, logical, character select layers x SpatVector: integer, logical, character select variables j missing, , SpatRasterDataset , numeric drop logical. TRUE, geometries dropped, data.frame returned","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"x SpatRaster SpatRasterDataset: SpatRaster x SpatVector: data.frame.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subset_double.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Subset a SpatRaster or a SpatVector — subset_double","text":"","code":"### SpatRaster s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    s[[ 1:2 ]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255   s[[c(\"red\", \"green\")]] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255   # expression based (partial) matching of names with single brackets s[\"re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 2  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> names       : red, green  #> min values  :   0,     0  #> max values  : 255,   255  s[\"^re\"] #> class       : SpatRaster  #> dimensions  : 77, 101, 1  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> name        : red  #> min value   :   0  #> max value   : 255   # does not with double brackets # s[[\"re\"]]   ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[[2:3]] #>          NAME_1 ID_2 #> 1      Diekirch    1 #> 2      Diekirch    2 #> 3      Diekirch    3 #> 4      Diekirch    4 #> 5      Diekirch    5 #> 6  Grevenmacher    6 #> 7  Grevenmacher    7 #> 8  Grevenmacher   12 #> 9    Luxembourg    8 #> 10   Luxembourg    9 #> 11   Luxembourg   10 #> 12   Luxembourg   11  # to keep the geometry use v[,2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 2  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2 #>                Diekirch     3"},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"Extract values SpatRaster; subset records (row) /variables (columns) SpatVector; number SpatExtent. can use indices (row, column, layer cell numbers) extract. can also use Spat* objects.","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"","code":"# S4 method for SpatRaster,ANY,ANY,ANY [(x, i, j, k)  # S4 method for SpatVector,numeric,numeric [(x, i, j, drop=FALSE)  # S4 method for SpatVector,SpatVector,missing [(x, i, j)  # S4 method for SpatExtent,numeric,missing [(x, i, j)"},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"x SpatRaster, SpatVector SpatExtent x SpatRaster: numeric, logical missing select rows , j missing, select cells numbers. x SpatVector: numeric missing select rows.    another SpatVector: get new SpatVector geometries intersect. x SpatExtent: integer 1 4. j numeric, logical, missing select columns k numeric, character, missing select layers drop logical. FALSE object class x returned","code":""},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"numeric x SpatExtent.  x drop=FALSE. Otherwise data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subset_single.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract values from a SpatRaster, SpatVector or SpatExtent — subset_single","text":"","code":"### SpatRaster f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) r[3638] #>   elevation #> 1       473 rowColFromCell(r, 2638) #>      [,1] [,2] #> [1,]   28   73 r[39, 28] #>   elevation #> 1       473 x <- r[39:40, 28:29, drop=FALSE]  as.matrix(x, wide=TRUE) #>      [,1] [,2] #> [1,]  473  429 #> [2,]  430  436  ### SpatVector  v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v[2:3,] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 6  (geometries, attributes) #>  extent      : 5.746118, 6.315773, 49.69933, 49.98745  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664 v[1:2, 2:3] #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 2, 2  (geometries, attributes) #>  extent      : 5.826232, 6.315773, 49.78479, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :   NAME_1  ID_2 #>  type        :    <chr> <num> #>  values      : Diekirch     1 #>                Diekirch     2 v[1:2, 2:3, drop=TRUE] #>     NAME_1 ID_2 #> 1 Diekirch    1 #> 2 Diekirch    2"},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":null,"dir":"Reference","previous_headings":"","what":"replace cell values — subst","title":"replace cell values — subst","text":"Substitute(replace) cell values SpatRaster new value. See classify complex/flexible replacement.","code":""},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"replace cell values — subst","text":"","code":"# S4 method for SpatRaster subst(x, from, to, others=NULL, raw=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"replace cell values — subst","text":"x SpatRaster numeric value(s). Normally vector length ``. x multiple layers, can also matrix numeric value(s) nrow(x) == length(). case output single layer, values based combination values input layers numeric value(s). Normally vector length ``. x single layer, can also matrix numeric value(s) nrow(x) == length(). case output multiple layers, one column others numeric. NULL values matched set value. Otherwise retain original value. raw logical. TRUE, values raw cell values, categorical labels. relevant .factor(x) filename character. Output filename ... Additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"replace cell values — subst","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/subst.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"replace cell values — subst","text":"","code":"r <- rast(ncols=5, nrows=5, xmin=0, xmax=1, ymin=0, ymax=1, crs=\"\") r <- init(r, 1:6) x <- subst(r, 3, 7) x <- subst(r, 2:3, NA) x <- subst(x, NA, 10)  # multiple output layers z <- subst(r, 2:3, cbind(20,30))  # multiple input layers rr <- c(r, r+1, r+2) m <- rbind(c(1:3), c(3:5)) zz <- subst(rr, m, c(100, 200))"},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize — summarize","title":"Summarize — summarize","text":"Compute summary statistics cells, either across layers layers (parallel summary). following summary methods available SpatRaster: , anyNA, , allNA, max, min, mean, median, prod, range, stdev, sum, .min, .max. See modal compute mode app compute summary statistics included . generic functions used, method applied chosen based first argument: \"x\". means r SpatRaster, mean(r, 5) work, mean(5, r) work. mean method argument \"trim\" ignored. pop=TRUE stdev computes population standard deviation, computed : f <- function(x) sqrt(sum((x-mean(x))^2) / length(x)) different sample standard deviation returned sd (uses n-1 denominator).","code":""},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize — summarize","text":"","code":"# S4 method for SpatRaster min(x, ..., na.rm=FALSE)  # S4 method for SpatRaster max(x, ..., na.rm=FALSE)  # S4 method for SpatRaster range(x, ..., na.rm=FALSE)  # S4 method for SpatRaster prod(x, ..., na.rm=FALSE)  # S4 method for SpatRaster sum(x, ..., na.rm=FALSE)  # S4 method for SpatRaster any(x, ..., na.rm=FALSE)  # S4 method for SpatRaster all(x, ..., na.rm=FALSE)  # S4 method for SpatRaster range(x, ..., na.rm=FALSE)  # S4 method for SpatRaster which.min(x)  # S4 method for SpatRaster which.max(x)  # S4 method for SpatRaster stdev(x, ..., pop=TRUE, na.rm=FALSE)  # S4 method for SpatRaster mean(x, ..., trim=NA, na.rm=FALSE)  # S4 method for SpatRaster median(x, na.rm=FALSE, ...)  # S4 method for SpatRaster anyNA(x)  # S4 method for SpatRaster countNA(x, n=0)  # S4 method for SpatRaster noNA(x, falseNA=FALSE)  # S4 method for SpatRaster allNA(x, falseNA=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize — summarize","text":"x SpatRaster ... additional SpatRasters numeric values; arguments par parallel summarization (see Details), filename, overwrite wopt writeRaster na.rm logical. TRUE, NA values ignored. FALSE, NA returned x NA values trim ignored pop logical. TRUE, population standard deviation computed. Otherwise sample standard deviation computed falseNA logical. TRUE, cells otherwise FALSE set NA n integer. n > 0, cell values TRUE least n layers NA","code":""},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize — summarize","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Summarize — summarize","text":"Additional argument par can used \"parallel\" summarizing SpatRaster numeric logical value. SpatRaster x three layers, max(x, 5) return single layer (number five treated layer cells value five). contrast max(x, 5, par=TRUE) returns three layers (number five treated another SpatRaster single layer cells value five.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/summarize-generics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Summarize — summarize","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10, nlyrs=3) values(r) <- runif(ncell(r) * nlyr(r))  x <- mean(r) # note how this returns one layer x <- sum(c(r, r[[2]]), 5)  # and this returns three layers y <- sum(r, r[[2]], 5)  max(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :       max  #> min value   : 0.1808664  #> max value   : 0.9926841   ## when adding a number, do you want 1 layer or all layers? # 1 layer max(r, 0.5) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :       max  #> min value   : 0.5000000  #> max value   : 0.9926841   # all layers max(r, 0.5, par=TRUE) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :     lyr.1,     lyr.2,     lyr.3  #> min values  : 0.5000000, 0.5000000, 0.5000000  #> max values  : 0.9919061, 0.9926841, 0.9815635   y <- stdev(r) # not the same as  yy <- app(r, sd)  z <- stdev(r, r*2)  x <- mean(r, filename=paste0(tempfile(), \".tif\"))   v <- values(r) set.seed(3) v[sample(length(v), 50)] <- NA values(r) <- v is.na(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       : lyr.1, lyr.2, lyr.3  #> min values  : FALSE, FALSE, FALSE  #> max values  :  TRUE,  TRUE,  TRUE  anyNA(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :  lyr1  #> min value   : FALSE  #> max value   :  TRUE  allNA(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :  lyr1  #> min value   : FALSE  #> max value   :  TRUE  countNA(r) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        : lyr1  #> min value   :    0  #> max value   :    3  countNA(r, 2) #> class       : SpatRaster  #> dimensions  : 10, 10, 1  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> name        :  lyr1  #> min value   : FALSE  #> max value   :  TRUE"},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":null,"dir":"Reference","previous_headings":"","what":"summary — summary","title":"summary — summary","text":"Compute summary statistics (min, max, mean, quartiles) SpatRaster using base summary method. sample used large files. single statistics see Summary-methods, global, quantile","code":""},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"summary — summary","text":"","code":"# S4 method for SpatRaster summary(object, size=100000, warn=TRUE, ...)  # S4 method for SpatVector summary(object, ...)"},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"summary — summary","text":"object SpatRaster SpatVector size positive integer. Size regular sample used large datasets (see spatSample) warn logical. TRUE warning given sample used ... additional arguments passed base summary method","code":""},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"summary — summary","text":"matrix (estimate ) median, minimum maximum values, first third quartiles, number cells NA values","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/summary.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"summary — summary","text":"","code":"set.seed(0) r <- rast(nrows=10, ncols=10, nlyrs=3) values(r) <- runif(nlyr(r)*ncell(r)) summary(r) #>      lyr.1             lyr.2             lyr.3         #>  Min.   :0.01339   Min.   :0.01308   Min.   :0.02779   #>  1st Qu.:0.32308   1st Qu.:0.28440   1st Qu.:0.18947   #>  Median :0.48781   Median :0.51860   Median :0.37810   #>  Mean   :0.52076   Mean   :0.51569   Mean   :0.43403   #>  3rd Qu.:0.77171   3rd Qu.:0.72570   3rd Qu.:0.63596   #>  Max.   :0.99191   Max.   :0.99268   Max.   :0.98156"},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a SpatVectorCollection — svc","title":"Create a SpatVectorCollection — svc","text":"Methods create SpatVectorCollection. object hold \"sub-datasets\", SpatVector, perhaps different geometry type.","code":""},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a SpatVectorCollection — svc","text":"","code":"# S4 method for missing svc(x)   # S4 method for SpatVector svc(x, ...)   # S4 method for list svc(x)   # S4 method for character svc(x, layer=\"\", query=\"\", extent=NULL, filter=NULL)"},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a SpatVectorCollection — svc","text":"x SpatVector, character (filename), list SpatVectors, missing ... Additional SpatVectors layer character. layer name select layer file (database) multiple layers query character. query subset dataset OGR-SQL dialect extent Spat* object. extent object used spatial filter select geometries read. Ignored filter NULL filter SpatVector. Used spatial filter select geometries read (convex hull used lines points). guaranteed features overlap extent filter returned. can happen additional geometries returned","code":""},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a SpatVectorCollection — svc","text":"SpatVectorCollection","code":""},{"path":"https://rspatial.github.io/terra/reference/svc.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a SpatVectorCollection — svc","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) x <- svc() x <- svc(v, v[1:3,], as.lines(v[3:5,]), as.points(v)) length(x) #> [1] 4 x #>  class       : SpatVectorCollection  #>  length      : 4  #>  geometry    : polygons (12) #>                polygons (3) #>                lines (3) #>                points (3983) #>  crs (first) : lon/lat WGS 84 (EPSG:4326)  #>  names       : , , ,    # extract x[3] #>  class       : SpatVector  #>  geometry    : lines  #>  dimensions  : 3, 6  (geometries, attributes) #>  extent      : 5.74414, 6.239243, 49.69933, 50.03632  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2  NAME_2  AREA   POP #>  type        : <num>    <chr> <num>   <chr> <num> <int> #>  values      :     1 Diekirch     3 Redange   259 18664 #>                    1 Diekirch     4 Vianden    76  5163 #>                    1 Diekirch     5   Wiltz   263 16735  # replace x[2] <- as.lines(v[1,])"},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":null,"dir":"Reference","previous_headings":"","what":"Symmetrical difference — symdif","title":"Symmetrical difference — symdif","text":"Symmetrical difference polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Symmetrical difference — symdif","text":"","code":"# S4 method for SpatVector,SpatVector symdif(x, y)"},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Symmetrical difference — symdif","text":"x SpatVector y SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Symmetrical difference — symdif","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/symdif.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Symmetrical difference — symdif","text":"","code":"p <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) b <- as.polygons(ext(6, 6.4, 49.75, 50)) #sd <- symdif(p, b) #plot(sd, col=rainbow(12))"},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to subsets of layers of a SpatRaster — tapp","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"Apply function subsets layers SpatRaster (similar tapply aggregate). layers combined based index. number layers output SpatRaster equals number unique values index times number values supplied function returns single vector numbers. example, SpatRaster 6 layers, can use index=c(1,1,1,2,2,2) fun=sum. return SpatRaster two layers. first layer sum first three layers input SpatRaster, second layer sum last three layers input SpatRaster. Indices recycled index=c(1,2) also return SpatRaster two layers (one based odd layers (1,3,5), based even layers (2,4,6)). index can also one following values group time period (x appropriate time values): \"years\", \"months\", \"yearmonths\", \"week\" (ISO 8601 week number, see Details), \"yearweeks\", \"days\", \"doy\" (day year), \"7days\" (seven-day periods starting Jan 1 year), \"10days\", \"15days\". can also function makes groups time values. See app Summary-methods want use efficient function returns multiple layers based layers SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"","code":"# S4 method for SpatRaster tapp(x, index, fun, ..., cores=1, filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"x SpatRaster index factor numeric (integer). Vector length nlyr(x) (shorter vectors recycled) grouping input layers. can also one following values: \"years\", \"months\", \"yearmonths\", \"days\", \"week\" (ISO 8601 week number), \"doy\" (day year) fun function applied. following functions re-implemented C++ speed: \"sum\", \"mean\", \"median\", \"modal\", \"\", \".min\", \".max\", \"min\", \"max\", \"prod\", \"\", \"\", \"sd\", \"std\", \"first\". use base-R function say, \"min\", use something like fun = \\() min() ... additional arguments passed fun cores positive integer. cores > 1, 'parallel' package cluster many cores created used. can also supply cluster object. Ignored functions implemented terra C++ (see fun) filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"\"week\" follows ISO 8601 definition. Weeks start Monday. week containing 1 January four days new year, considered week \"01\". Otherwise, last week previous year (week \"52\" \"53\", next week week 1.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/tapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to subsets of layers of a SpatRaster — tapp","text":"","code":"r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) s <- c(r, r, r, r, r, r) s <- s * 1:6 b1 <- tapp(s, index=c(1,1,1,2,2,2), fun=sum) b1 #> class       : SpatRaster  #> dimensions  : 10, 10, 2  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :  X1,   X2  #> min values  :   6,   15  #> max values  : 600, 1500  b2 <- tapp(s, c(1,2,3,1,2,3), fun=sum) b2 #> class       : SpatRaster  #> dimensions  : 10, 10, 3  (nrow, ncol, nlyr) #> resolution  : 36, 18  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> names       :  X1,  X2,  X3  #> min values  :   5,   7,   9  #> max values  : 500, 700, 900"},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":null,"dir":"Reference","previous_headings":"","what":"Description of the methods in the terra package — terra-package","title":"Description of the methods in the terra package — terra-package","text":"terra provides methods manipulate geographic (spatial) data \"raster\" \"vector\" form. Raster data divide space rectangular grid cells commonly used represent spatially continuous phenomena, elevation weather. Satellite images also data structure, context grid cells often referred pixels. contrast, \"vector\" spatial data (points, lines, polygons) typically used represent discrete spatial entities, road, country, bus stop. package implements two main classes (data types): SpatRaster SpatVector. SpatRaster supports handling large raster files loaded memory; local, focal, zonal, global raster operations; polygon, line point raster conversion; integration modeling methods make spatial predictions; . SpatVector supports types geometric operations intersections. Additional classes include SpatExtent, used define spatial extent (bounding box); SpatRasterDataset, represents collection sub-datasets area. sub-dataset SpatRaster possibly many layers, may, example, represent different weather variables; SpatRasterCollection SpatVectorCollection equivalent lists SpatRaster SpatVector objects. also SpatGraticule class assist adding longitude/latitude lines labels map another coordinate reference system. classes hold C++ pointer data \"reference class\" creates limitations. recovered saved R session either directly passed nodes computer cluster. Generally, use writeRaster save SpatRaster objects disk (pass filename cell values cluster nodes). Also see wrap. Also, package developers directly access pointer, user-interface stable. terra package conceived replacement raster package. terra similar, simpler, interface, faster raster. bottom page table shows differences methods two packages. list important methods grouped theme. ---------------------------------------------------------------------------------------------------------------------","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"spatraster","dir":"Reference","previous_headings":"","what":"SpatRaster","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"ii-changing-the-spatial-extent-or-resolution","dir":"Reference","previous_headings":"","what":"II. Changing the spatial extent or resolution","title":"Description of the methods in the terra package — terra-package","text":"Also see methods section VIII","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"vii-accessing-cell-values","dir":"Reference","previous_headings":"","what":"VII. Accessing cell values","title":"Description of the methods in the terra package — terra-package","text":"Apart function listed , can also use indexing [ cell numbers, row /column numbers","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"viii-getting-and-setting-dimensions-","dir":"Reference","previous_headings":"","what":"VIII. Getting and setting dimensions","title":"Description of the methods in the terra package — terra-package","text":"Get set basic parameters SpatRasters. values associated SpatRaster (either memory via link file) lost change number columns rows resolution. case extent changed (number columns rows affected). Similarly, crs can set coordinate reference system, transform data (see project ).","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"ix-computing-row-column-cell-numbers-and-coordinates","dir":"Reference","previous_headings":"","what":"IX. Computing row, column, cell numbers and coordinates","title":"Description of the methods in the terra package — terra-package","text":"Cell numbers start 1 upper-left corner. increase within rows, left right, row row top bottom. Likewise, row numbers start 1 top raster, column numbers start 1 left side raster.","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xiv-spatrasterdataset","dir":"Reference","previous_headings":"","what":"XIV. SpatRasterDataset","title":"Description of the methods in the terra package — terra-package","text":"SpatRasterDataset contains SpatRasters represent sub-datasets area. extent resolution.","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xv-spatrastercollections","dir":"Reference","previous_headings":"","what":"XV. SpatRasterCollections","title":"Description of the methods in the terra package — terra-package","text":"SpatRasterCollection vector SpatRaster objects. Unlike SpatRasterDataset, extent resolution SpatRasters need match .","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"spatvector","dir":"Reference","previous_headings":"","what":"SpatVector","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xx-spatvector-attributes","dir":"Reference","previous_headings":"","what":"XX. SpatVector attributes","title":"Description of the methods in the terra package — terra-package","text":"use term \"attributes\" tabular data (data.frame) associated vector geometries.","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxiii-spatvectorcollections","dir":"Reference","previous_headings":"","what":"XXIII. SpatVectorCollections","title":"Description of the methods in the terra package — terra-package","text":"SpatVectorCollection vector SpatVector objects.","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"other-classes","dir":"Reference","previous_headings":"","what":"Other classes","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"general-methods","dir":"Reference","previous_headings":"","what":"General methods","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxvi-conversion-between-spatial-data-objects-from-different-packages","dir":"Reference","previous_headings":"","what":"XXVI. Conversion between spatial data objects from different packages","title":"Description of the methods in the terra package — terra-package","text":"can coerce SpatRasters Raster* objects, loading raster package, (object, \"Raster\"), raster(object) brick(object) stack(object)","code":""},{"path":[]},{"path":[]},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"comparison-with-the-raster-package","dir":"Reference","previous_headings":"","what":"Comparison with the raster package","title":"Description of the methods in the terra package — terra-package","text":"---------------------------------------------------------------------------------------------------------------------","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxviii-new-method-names","dir":"Reference","previous_headings":"","what":"XXVIII. New method names","title":"Description of the methods in the terra package — terra-package","text":"terra single class SpatRaster raster three (RasterLayer, RasterStack, RasterBrick). Likewise single class vector data SpatVector replaces six Spatial* classes. method names , note following important differences methods names raster package","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"xxix-changed-behavior","dir":"Reference","previous_headings":"","what":"XXIX. Changed behavior","title":"Description of the methods in the terra package — terra-package","text":"Also note even function names terra raster, output can different. cases done get consistency returned values (thus fewer errors downstream code uses ). cases simply seemed better. examples:","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"authors","dir":"Reference","previous_headings":"","what":"Authors","title":"Description of the methods in the terra package — terra-package","text":"Except indicated otherwise, methods functions package written Robert Hijmans. configuration scripts written Roger Bivand. code using GEOS library adapted code Edzer Pebesma sf. Michael Sumner contributed various bits pieces.","code":""},{"path":"https://rspatial.github.io/terra/reference/terra-package.html","id":"acknowledgments","dir":"Reference","previous_headings":"","what":"Acknowledgments","title":"Description of the methods in the terra package — terra-package","text":"package attempt climb shoulders giants (GDAL, PROJ, GEOS, NCDF, GeographicLib, Rcpp, R). Many people contributed asking questions raising issues. Feedback suggestions Márcia Barbosa, Kendon Bell, Andrew Gene Brown, Jean-Luc Dupouey, Krzysztof Dyba, Sarah Endicott, Derek Friend, Alex Ilich, Gerald Nelson, Jakub Nowosad, Monika Tomaszewska especially helpful.","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":null,"dir":"Reference","previous_headings":"","what":"Options — options","title":"Options — options","text":"Get set general options.","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Options — options","text":"","code":"terraOptions(..., print=TRUE)"},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Options — options","text":"... option names values (see Details). missing, get show current options print logical. TRUE option names values printed","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Options — options","text":"following options available. memfrac - value 0 0.9 (larger values give warning). fraction RAM may used program. memmin - memory required threshold (GB), memory assumed available. Otherwise, terra checks available. memmax - maximum amount RAM (GB) terra allowed use processing raster dataset. less detected (see mem_info), higher values ignored. Set negative number NA set option. terraOptions shows value memmax set. tempdir - directory temporary files written. default returned tempdir(). datatype - default data type. See writeRaster todisk - logical. TRUE write raster data disk (temp file file name specified). debugging. progress - non-negative integer. progress bar shown number chunks data processed larger number. progress bar shown value zero verbose - logical. TRUE debugging info printed functions","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Options — options","text":"possible set default options \"etc/.Rprofile.site\" R installation like options(terra_default=list(tempdir=\"d:/temp\", memfrac=.4)) may good practice. clearer set favorite options beginning script.","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Options — options","text":"list. Invisibly print=TRUE","code":""},{"path":"https://rspatial.github.io/terra/reference/terraOptions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Options — options","text":"","code":"terraOptions() #> memfrac   : 0.6 #> tolerance : 0.1 #> verbose   : FALSE #> todisk    : FALSE #> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpUrLSv3 #> datatype  : FLT4S #> memmin    : 1 #> progress  : 3 terraOptions(memfrac=0.5, tempdir = \"c:/temp\") #> Warning: [options] you cannot set the tempdir to a path that does not exist terraOptions(progress=10) terraOptions() #> memfrac   : 0.5 #> tolerance : 0.1 #> verbose   : FALSE #> todisk    : FALSE #> tempdir   : /private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpUrLSv3 #> datatype  : FLT4S #> memmin    : 1 #> progress  : 10"},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":null,"dir":"Reference","previous_headings":"","what":"terrain characteristics — terrain","title":"terrain characteristics — terrain","text":"Compute terrain characteristics elevation data. elevation values units map units (typically meter) projected (planar) raster data. meter coordinate reference system longitude/latitude. accuracy, always compute values original data (first change projection). Distances (needed slope aspect) longitude/latitude data computed WGS84 ellipsoid Karney's algorithm.","code":""},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"terrain characteristics — terrain","text":"","code":"# S4 method for SpatRaster terrain(x, v=\"slope\", neighbors=8, unit=\"degrees\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"terrain characteristics — terrain","text":"x SpatRaster, single layer elevation values. Values unit map units, meters crs longitude/latitude v character. One options: slope, aspect, TPI, TRI, TRIriley, TRIrmsd, roughness, flowdir (see Details) unit character. \"degrees\" \"radians\" output \"slope\" \"aspect\" neighbors integer. Indicating many neighboring cells use compute slope aspect . Either 8 (queen case) 4 (rook case) filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"terrain characteristics — terrain","text":"neighbors=4, slope aspect computed according Fleming Hoffer (1979) Ritter (1987). neighbors=8, slope aspect computed according Horn (1981). Horn algorithm may best rough surfaces, Fleming Hoffer algorithm may better smoother surfaces (Jones, 1997; Burrough McDonnell, 1998). slope = 0, aspect set 0.5*pi radians (90 degrees unit=\"degrees\"). computing slope aspect, coordinate reference system x must known algorithm differentiate planar longitude/latitude data. terrain vectorized \"neighbors\" \"unit\" -- first value used. flowdir returns \"flow direction\" (water), direction greatest drop elevation (smallest rise neighbors higher). encoded powers 2 (0 7). cell right focal cell 1, one 2, : Cells without lower neighboring cells encoded zero. two cells drop elevation, random cell picked. ideal may prevent creation connected flow networks. ArcGIS implements approach Greenlee (1987) might adopt future. terrain indices according Wilson et al. (2007), gdaldem. TRI (Terrain Ruggedness Index) mean absolute differences value cell 8 surrounding cells. TPI (Topographic Position Index) difference value cell mean value 8 surrounding cells. Roughness difference maximum minimum value cell 8 surrounding cells. TRIriley (TRI according Riley et al., 2007) returns square root summed squared differences value cell 8 surrounding cells. TRIrmsd computes square root mean squared differences cells. measures can also computed focal functions: TRI <- focal(x, w=3, fun=\\(x) sum(abs(x[-5]-x[5]))/8) TPI <- focal(x, w=3, fun=\\(x) x[5] - mean(x[-5])) rough <- focal(x, w=3, fun=\\(x) max(x) - min(x))","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"terrain characteristics — terrain","text":"Burrough, P., R.. McDonnell, 1998. Principles Geographical Information Systems. Oxford University Press. Fleming, M.D. Hoffer, R.M., 1979. Machine processing Landsat MSS data DMA topographic data forest cover type mapping. LARS Technical Report 062879. Laboratory Applications Remote Sensing, Purdue University, West Lafayette, Indiana. Horn, B.K.P., 1981. Hill shading reflectance map. Proceedings IEEE 69:14-47 Jones, K.H., 1998. comparison algorithms used compute hill slope property DEM. Computers & Geosciences 24: 315-323 Karney, C.F.F., 2013. Algorithms geodesics, J. Geodesy 87: 43-55. doi:10.1007/s00190-012-0578-z. Riley, S.J., De Gloria, S.D., Elliot, R. (1999): Terrain Ruggedness Quantifies Topographic Heterogeneity. Intermountain Journal Science 5: 23-27. Ritter, P., 1987. vector-based terrain aspect generation algorithm. Photogrammetric Engineering Remote Sensing 53: 1109-1111 Wilson et al 2007, Multiscale Terrain Analysis Multibeam Bathymetry Data Habitat Mapping Continental Slope. Marine Geodesy 30:3-35","code":""},{"path":"https://rspatial.github.io/terra/reference/terrain.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"terrain characteristics — terrain","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) x <- terrain(r, \"slope\")"},{"path":"https://rspatial.github.io/terra/reference/text.html","id":null,"dir":"Reference","previous_headings":"","what":"Add labels to a map — text","title":"Add labels to a map — text","text":"Plots labels, textual (rather color) representation values, top existing plot (map).","code":""},{"path":"https://rspatial.github.io/terra/reference/text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add labels to a map — text","text":"","code":"# S4 method for SpatRaster text(x, labels, digits=0, halo=FALSE, ...)  # S4 method for SpatVector text(x, labels, halo=FALSE, inside=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add labels to a map — text","text":"x SpatRaster SpatVector labels character. Optional. Vector labels length(x) variable name names(x) digits integer. many digits used? halo logical. TRUE \"halo\" printed around text. TRUE, additional arguments hc=\"white\" hw=0.1 can modified set color width halo inside logical. text always placed inside one sub-geometries? ... additional arguments pass graphics function text","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add labels to a map — text","text":"","code":"r <- rast(nrows=4, ncols=4) values(r) <- 1:ncell(r) plot(r) text(r)   plot(r) text(r, halo=TRUE, hc=\"blue\", col=\"white\", hw=0.2)   plot(r, col=rainbow(16)) text(r, col=c(\"black\", \"white\"), vfont=c(\"sans serif\", \"bold\"), cex=2)"},{"path":"https://rspatial.github.io/terra/reference/time.html","id":null,"dir":"Reference","previous_headings":"","what":"time of SpatRaster layers — time","title":"time of SpatRaster layers — time","text":"Get set time layers SpatRaster. Time can stored POSIXlt (date time,  resolution seconds, time zone), Date, \"months\", \"years\", \"yearmonths\". timeInfo .time helper functions understand time data SpatRaster .","code":""},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"time of SpatRaster layers — time","text":"","code":"# S4 method for SpatRaster has.time(x)  # S4 method for SpatRaster time(x, format=\"\")  # S4 method for SpatRaster time(x, tstep=\"\")<-value  # S4 method for SpatRaster timeInfo(x)"},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"time of SpatRaster layers — time","text":"x SpatRaster SpatRasterDataset format One \"\", \"seconds\" (POSIXlt), \"days\" (Date), \"yearmonths\" (decimal years), \"years\", \"months\". \"\", returned format (based ) format used set time value Date, POSIXt, yearmon (defined package zoo), numeric tstep One \"years\", \"months\", \"yearmonths\". Used value numeric. Ignored value type Date, POSIXt, yearmon","code":""},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"time of SpatRaster layers — time","text":"time: POSIXlt, Date, numeric timeInfo: data.frame time step time zone information (available) .time: logical","code":""},{"path":"https://rspatial.github.io/terra/reference/time.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"time of SpatRaster layers — time","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     # Date\" d <- as.Date(\"2001-05-04\") + 0:2 time(s) <- d time(s) #> [1] \"2001-05-04\" \"2001-05-05\" \"2001-05-06\"  # POSIX (date/time with a resolution of seconds) time(s) <- as.POSIXlt(d) time(s) #> [1] \"2001-05-04 UTC\" \"2001-05-05 UTC\" \"2001-05-06 UTC\"  # with time zone time(s) <- as.POSIXlt(Sys.time(), \"America/New_York\") + 0:2 time(s) #> [1] \"2024-05-24 06:59:47 EDT\" \"2024-05-24 06:59:48 EDT\" #> [3] \"2024-05-24 06:59:49 EDT\" timeInfo(s) #>   time    step             zone #> 1 TRUE seconds America/New_York  # years time(s, tstep=\"years\") <- 2000 + 0:2 s #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  #> time (years): 2000 to 2002   time(s, tstep=\"months\") <- 1:3 s  #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  #> time (mnts) : Jan to Mar"},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":null,"dir":"Reference","previous_headings":"","what":"Temporary files — tmpFiles","title":"Temporary files — tmpFiles","text":"List optionally remove temporary files created terra package. files created output SpatRaster may large store memory (RAM). can happen filename provided function using functions provide filename. Temporary files automatically removed end R session ends normally. can use tmpFiles see files current sessions, including orphaned (connect SpatRaster object ) (perhaps old) sessions, remove temporary files.","code":""},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Temporary files — tmpFiles","text":"","code":"tmpFiles(current=TRUE, orphan=FALSE, old=FALSE, remove=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Temporary files — tmpFiles","text":"current logical. TRUE, temporary files current R session included orphan logical. TRUE, temporary files current R session longer associated SpatRaster (current TRUE also included) old logical. TRUE, temporary files \"R\" sessions. Unless running multiple instances R time, old (possibly crashed) R  sessions removed remove logical. TRUE, temporary files removed","code":""},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Temporary files — tmpFiles","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/tmpFile.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Temporary files — tmpFiles","text":"","code":"tmpFiles() #> [1] \"/private/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T/RtmpUrLSv3/spat_34aa77ebb8f7_13482.vrt\""},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":null,"dir":"Reference","previous_headings":"","what":"Vector topology methods — topology","title":"Vector topology methods — topology","text":"makeNodes create nodes lines mergeLines connect lines form polygons removeDupNodes removes duplicate nodes geometries optionally rounds coordinates emptyGeoms returns indices empty (null) geometries. .na also checks coordinates NA. snap makes boundaries geometries identical close .","code":""},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Vector topology methods — topology","text":"","code":"# S4 method for SpatVector mergeLines(x) # S4 method for SpatVector snap(x, y=NULL, tolerance) # S4 method for SpatVector removeDupNodes(x, digits = -1) # S4 method for SpatVector makeNodes(x)"},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Vector topology methods — topology","text":"x SpatVector lines polygons y SpatVector lines polygons snap . NULL snapping geometries x tolerance numeric. Snapping tolerance (distance geometries) digits numeric. Number digits used rounding. Ignored < 0","code":""},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Vector topology methods — topology","text":"SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/topology.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Vector topology methods — topology","text":"","code":"p1 <- as.polygons(ext(0,1,0,1)) p2 <- as.polygons(ext(1.1,2,0,1))  p <- rbind(p1, p2)  y <- snap(p, tol=.15) plot(p, lwd=3, col=\"light gray\") lines(y, col=\"red\", lwd=2)"},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":null,"dir":"Reference","previous_headings":"","what":"Transpose — transpose","title":"Transpose — transpose","text":"Transpose SpatRaster SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transpose — transpose","text":"","code":"# S4 method for SpatRaster t(x)  # S4 method for SpatVector t(x)  # S4 method for SpatRaster trans(x, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transpose — transpose","text":"x SpatRaster SpatVector filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transpose — transpose","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/transpose.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transpose — transpose","text":"","code":"r <- rast(nrows=18, ncols=36) values(r) <- 1:ncell(r) tr1 <- t(r) tr2 <- trans(r) ttr <- trans(tr2)"},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":null,"dir":"Reference","previous_headings":"","what":"Trim a SpatRaster — trim","title":"Trim a SpatRaster — trim","text":"Trim (shrink) SpatRaster removing outer rows columns NA another value.","code":""},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Trim a SpatRaster — trim","text":"","code":"# S4 method for SpatRaster trim(x, padding=0, value=NA, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Trim a SpatRaster — trim","text":"x SpatRaster padding integer. Number outer rows/columns keep value numeric. value outer rows columns removed filename character. Output filename ... additional arguments writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Trim a SpatRaster — trim","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/trim.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Trim a SpatRaster — trim","text":"","code":"r <- rast(ncols=10, nrows=10, xmin=0,xmax=10,ymin=0,ymax=10) v <- rep(NA, ncell(r)) v[c(12,34,69)] <- 1:3 values(r) <- v s <- trim(r)"},{"path":"https://rspatial.github.io/terra/reference/union.html","id":null,"dir":"Reference","previous_headings":"","what":"Union SpatVector or SpatExtent objects — union","title":"Union SpatVector or SpatExtent objects — union","text":"Overlapping polygons (, within, objects) intersected. Union lines points simply combines two data sets; without geometric intersections. equivalent c. Attributes joined. See c want combine polygons without intersection. x y different geometry type, SpatVectorCollection returned. single SpatVector supplied, overlapping polygons intersected. Original attributes lost. New attributes allow determining many, , polygons overlapped. SpatExtent: Objects combined union; equivalent +.","code":""},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Union SpatVector or SpatExtent objects — union","text":"","code":"# S4 method for SpatVector,SpatVector union(x, y)  # S4 method for SpatVector,missing union(x, y)  # S4 method for SpatExtent,SpatExtent union(x, y)"},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Union SpatVector or SpatExtent objects — union","text":"x SpatVector SpatExtent y x missing","code":""},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Union SpatVector or SpatExtent objects — union","text":"SpatVector SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/union.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Union SpatVector or SpatExtent objects — union","text":"","code":"e1 <- ext(-10, 10, -20, 20) e2 <- ext(0, 20, -40, 5) union(e1, e2) #> SpatExtent : -10, 20, -40, 20 (xmin, xmax, ymin, ymax)  #SpatVector v <- vect(system.file(\"ex/lux.shp\", package=\"terra\")) v <- v[,3:4] p <- vect(c(\"POLYGON ((5.8 49.8, 6 49.9, 6.15 49.8, 6 49.65, 5.8 49.8))\",  \"POLYGON ((6.3 49.9, 6.2 49.7, 6.3 49.6, 6.5 49.8, 6.3 49.9))\"), crs=crs(v)) values(p) <- data.frame(pid=1:2, value=expanse(p)) u <- union(v, p) plot(u, \"pid\")   b <- buffer(v, 1000)  u <- union(b) u$sum <- rowSums(as.data.frame(u)) plot(u, \"sum\")"},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":null,"dir":"Reference","previous_headings":"","what":"Unique values — unique","title":"Unique values — unique","text":"method returns unique values SpatRaster, removes duplicates records (geometry attributes) SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Unique values — unique","text":"","code":"# S4 method for SpatRaster unique(x, incomparables=FALSE, digits=NA, na.rm=TRUE, as.raster=FALSE)   # S4 method for SpatVector unique(x, incomparables=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Unique values — unique","text":"x SpatRaster SpatVector incomparables logical. FALSE x SpatRaster: unique values determined layers together, result matrix. TRUE, layer evaluated separately, list returned. x SpatVector argument data.frame digits integer. number digits rounding values finding unique values. Use NA means rounding na.rm logical. TRUE, NaN included missing values .raster logical. TRUE, single-layer categorical SpatRaster unique values returned ... additional arguments passed unique","code":""},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Unique values — unique","text":"x SpatRaster: data.frame list (incomparables=FALSE) x SpatVector: SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/unique.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Unique values — unique","text":"","code":"r <- rast(ncols=5, nrows=5) values(r) <- rep(1:5, each=5) unique(r) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 #> 5     5 s <- c(r, round(r/3)) unique(s) #>   lyr.1 lyr.1 #> 1     1     0 #> 2     2     1 #> 3     3     1 #> 4     4     1 #> 5     5     2 unique(s,TRUE) #> [[1]] #> [1] 1 2 3 4 5 #>  #> [[2]] #> [1] 0 1 2 #>   unique(s, as.raster=TRUE) #> class       : SpatRaster  #> dimensions  : 5, 5, 1  (nrow, ncol, nlyr) #> resolution  : 72, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory #> categories  : label, lyr.1, lyr.1.1  #> name        : label  #> min value   :   1_0  #> max value   :   5_2    v <- vect(cbind(x=c(1:5,1:5), y=c(5:1,5:1)),      crs=\"+proj=utm +zone=1 +datum=WGS84\") nrow(v) #> [1] 10 u <- unique(v) nrow(u) #> [1] 5  values(v) <- c(1:5, 1:3, 5:4) unique(v) #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 7, 1  (geometries, attributes) #>  extent      : 1, 5, 1, 5  (xmin, xmax, ymin, ymax) #>  coord. ref. : +proj=utm +zone=1 +datum=WGS84 +units=m +no_defs  #>  names       : value #>  type        : <int> #>  values      :     1 #>                    2 #>                    3"},{"path":"https://rspatial.github.io/terra/reference/units.html","id":null,"dir":"Reference","previous_headings":"","what":"units of SpatRaster or SpatRasterDataSet — units","title":"units of SpatRaster or SpatRasterDataSet — units","text":"Get set units layers SpatRaster datasets SpatRasterDataSet.","code":""},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"units of SpatRaster or SpatRasterDataSet — units","text":"","code":"# S4 method for SpatRaster units(x)  # S4 method for SpatRaster units(x)<-value  # S4 method for SpatRasterDataset units(x)  # S4 method for SpatRasterDataset units(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"units of SpatRaster or SpatRasterDataSet — units","text":"x SpatRaster value character","code":""},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"units of SpatRaster or SpatRasterDataSet — units","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/units.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"units of SpatRaster or SpatRasterDataSet — units","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     units(s) <- c(\"m/s\", \"kg\", \"ha\") units(s) #> [1] \"m/s\" \"kg\"  \"ha\"  s #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : 0, 101, 0, 77  (xmin, xmax, ymin, ymax) #> coord. ref. : Cartesian (Meter)  #> source      : logo.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255  #> unit        : m/s,    kg,   ha   units(s) <- \"kg\" units(s) #> [1] \"kg\" \"kg\" \"kg\""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":null,"dir":"Reference","previous_headings":"","what":"Change values in a file — update","title":"Change values in a file — update","text":"Change contents file data source SpatRaster. CAREFUL overwriting values existing file.","code":""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Change values in a file — update","text":"","code":"# S4 method for SpatRaster update(object, names=FALSE, crs=FALSE, extent=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Change values in a file — update","text":"object SpatRaster names logical. names updated? crs logical. coordinate reference system updated? extent logical. extent updated?","code":""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Change values in a file — update","text":"SpatRaster (invisibly)","code":""},{"path":"https://rspatial.github.io/terra/reference/update.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Change values in a file — update","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    fname <- paste0(tempfile(), \".tif\") x <- writeRaster(s, fname) names(x) <- c(\"A\", \"B\", \"C\") ext(x) <- ext(x) + 1 crs(x) <- \"+proj=utm +zone=1\"  update(x, names=TRUE, crs=TRUE, extent=TRUE)  rast(fname) #> class       : SpatRaster  #> dimensions  : 77, 101, 3  (nrow, ncol, nlyr) #> resolution  : 1.019802, 1.025974  (x, y) #> extent      : -1, 102, -1, 78  (xmin, xmax, ymin, ymax) #> coord. ref. : WGS 84 / UTM zone 1N (EPSG:32601)  #> source      : file34aa1b475c6.tif  #> colors RGB  : 1, 2, 3  #> names       : red, green, blue  #> min values  :   0,     0,    0  #> max values  : 255,   255,  255"},{"path":"https://rspatial.github.io/terra/reference/values.html","id":null,"dir":"Reference","previous_headings":"","what":"Cell values and geometry attributes — values","title":"Cell values and geometry attributes — values","text":"Get cell values SpatRaster attributes SpatVector. default values returned numeric. vector matrix can store one data type, SpatRaster may consist multiple data types. However, layers integer logical values, returned values also datatype. Note values(x, dataframe=TRUE) .data.frame(x) values returned match type layer, can mix numeric, logical, integer, factor.","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Cell values and geometry attributes — values","text":"","code":"# S4 method for SpatRaster values(x, mat=TRUE, dataframe=FALSE, row=1,      nrows=nrow(x), col=1, ncols=ncol(x), na.rm=FALSE, ...)  # S4 method for SpatVector values(x, ...)"},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Cell values and geometry attributes — values","text":"x SpatRaster SpatVector mat logical. TRUE, values returned matrix instead vector, except dataframe TRUE dataframe logical. TRUE, values returned data.frame instead vector (also matrix TRUE) row positive integer. Row number start , 1 nrow(x) nrows positive integer. many rows? col positive integer. Column number start , 1 ncol(x) ncols positive integer. many columns? Default number columns left start column na.rm logical. Remove NAs? ... additional arguments passed data.frame","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Cell values and geometry attributes — values","text":"x SpatRaster, mat=FALSE, values returned vector. cell-order layer. mat=TRUE, matrix returned values layer represented column (ncell(x) rows). values per layer cell-order, , top-left, top-right row. Use .matrix(x, wide=TRUE) alternative matrix representation number rows columns matches x.","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Cell values and geometry attributes — values","text":"raster values NA (missing) represented NaN (--number) unless argument dataframe TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Cell values and geometry attributes — values","text":"matrix data.frame","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/values.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Cell values and geometry attributes — values","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) r #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : elev.tif  #> name        : elevation  #> min value   :       141  #> max value   :       547  x <- values(r) x[3650:3655, ] #> [1] 349 287 334 319 271 228 r[3650:3655] #>   elevation #> 1       349 #> 2       287 #> 3       334 #> 4       319 #> 5       271 #> 6       228   ff <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(ff) y <- values(v) head(y) #>   ID_1       NAME_1 ID_2     NAME_2 AREA   POP #> 1    1     Diekirch    1   Clervaux  312 18081 #> 2    1     Diekirch    2   Diekirch  218 32543 #> 3    1     Diekirch    3    Redange  259 18664 #> 4    1     Diekirch    4    Vianden   76  5163 #> 5    1     Diekirch    5      Wiltz  263 16735 #> 6    2 Grevenmacher    6 Echternach  188 18899"},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":null,"dir":"Reference","previous_headings":"","what":"variable and long variable names — varnames","title":"variable and long variable names — varnames","text":"Set get names dataset (variable) SpatRasterDataset. SpatRaster _data source_ can also variable name long variable name. set reading file possibly multiple sub-datasets (e.g. netcdf hdf5 format) single SpatRaster. sub-datset seperate \"data-source\" SpatRaster. Note newly created derived SpatRasters always single variable (data source), therefore variable names lost processing multi-variable SpatRaster. Thus variable names mostly useful understand SpatRaster created files managing SpatRasterDatasets. See link{names} commonly used _layer_ names.","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"variable and long variable names — varnames","text":"","code":"# S4 method for SpatRaster varnames(x)  # S4 method for SpatRaster varnames(x)<-value  # S4 method for SpatRaster longnames(x)  # S4 method for SpatRaster longnames(x)<-value  # S4 method for SpatRasterDataset varnames(x)  # S4 method for SpatRasterDataset varnames(x)<-value  # S4 method for SpatRasterDataset longnames(x)  # S4 method for SpatRasterDataset longnames(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"variable and long variable names — varnames","text":"x SpatRaster, SpatRasterDataset value character (vector)","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"variable and long variable names — varnames","text":"character","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"variable and long variable names — varnames","text":"terra enforces neither unique valid names. See make.unique create unique names {make.names} make syntactically valid names.","code":""},{"path":"https://rspatial.github.io/terra/reference/varnames.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"variable and long variable names — varnames","text":"","code":"s <- rast(ncols=5, nrows=5, nlyrs=3) names(s) <- c(\"a\", \"b\", \"c\") x <- sds(s, s) varnames(x) <- c(\"one\", \"two\") x #> class       : SpatRasterDataset  #> subdatasets : 2  #> dimensions  : 5, 5 (nrow, ncol) #> nlyr        : 3, 3  #> resolution  : 72, 36  (x, y) #> extent      : -180, 180, -90, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (CRS84) (OGC:CRS84)  #> source(s)   : memory  #> names       : one, two"},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":null,"dir":"Reference","previous_headings":"","what":"Create SpatVector objects — vect","title":"Create SpatVector objects — vect","text":"Methods create SpatVector filename R object. filename can shapefile spatial file format. can use data.frame make SpatVector points; \"geom\" matrix make SpatVector supported geometry (see examples geom). can supply list SpatVectors append single SpatVector. SpatVectors can also created \"Well Known Text\", spatial vector data objects defined sf sp packages.","code":""},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create SpatVector objects — vect","text":"","code":"# S4 method for character vect(x, layer=\"\", query=\"\", extent=NULL, filter=NULL,      crs=\"\", proxy=FALSE, what=\"\", opts=NULL)  # S4 method for matrix vect(x, type=\"points\", atts=NULL, crs=\"\")  # S4 method for data.frame vect(x, geom=c(\"lon\", \"lat\"), crs=\"\", keepgeom=FALSE)  # S4 method for list vect(x, type=\"points\", crs=\"\")  # S4 method for SpatExtent vect(x, crs=\"\")  # S4 method for SpatVectorCollection vect(x)  # S4 method for sf vect(x)"},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create SpatVector objects — vect","text":"x character. filename; \"Well Known Text\" string; SpatExtent, data.frame (make SpatVector points); \"geom\" matrix make SpatVector supported geometry (see examples geom); spatial vector data object defined sf sp packages; list matrices coordinates layer character. layer name select layer file (database) multiple layers query character. query subset dataset OGR-SQL dialect extent Spat* object. extent object used spatial filter select geometries read. Ignored filter NULL filter SpatVector. Used spatial filter select geometries read (convex hull used lines points). guaranteed features overlap extent filter returned. can happen additional geometries returned type character. Geometry type. Must \"points\", \"lines\", \"polygons\" atts data.frame attributes. number rows must match number geometrical elements crs character. coordinate reference system one following formats: WKT/WKT2, <authority>:<code>, PROJ-string notation (see crs) proxy logical. TRUE SpatVectorProxy returned character indicating read. Either \"\" geometries attributes, \"geoms\" read geometries, \"attributes\" read attributes (returned data.frame) opts character. GDAL dataset open options geom character. field name(s) geometry data. Either two names x y coordinates points, single name single column WKT geometries keepgeom logical. TRUE geom variable(s) () also included attributes","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create SpatVector objects — vect","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/vect.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create SpatVector objects — vect","text":"","code":"### SpatVector from file f <- system.file(\"ex/lux.shp\", package=\"terra\") f #> [1] \"/Users/runner/work/_temp/Library/terra/ex/lux.shp\" v <- vect(f) v #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  source      : lux.shp #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664  ## subsetting (large) files ## with attribute query  v <- vect(f, query=\"SELECT NAME_1, NAME_2, ID_2 FROM lux WHERE ID_2 < 4\")  ## with an extent e <- ext(5.9, 6.3, 49.9, 50)  v <- vect(f, extent=e)  ## with polygons p <- as.polygons(e) v <- vect(f, filter=p)   ### SpatVector from a geom matrix x1 <- rbind(c(-180,-20), c(-140,55), c(10, 0), c(-140,-60)) x2 <- rbind(c(-10,0), c(140,60), c(160,0), c(140,-55)) x3 <- rbind(c(-125,0), c(0,60), c(40,5), c(15,-45)) hole <- rbind(c(80,0), c(105,13), c(120,2), c(105,-13)) z <- rbind(cbind(object=1, part=1, x1, hole=0), cbind(object=2, part=1, x3, hole=0),       cbind(object=3, part=1, x2, hole=0), cbind(object=3, part=1, hole, hole=1)) colnames(z)[3:4] <- c('x', 'y')  p <- vect(z, \"polygons\") p #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 3, 0  (geometries, attributes) #>  extent      : -180, 160, -60, 60  (xmin, xmax, ymin, ymax) #>  coord. ref. :    z[z[, \"hole\"]==1, \"object\"] <- 4 lns <- vect(z[,1:4], \"lines\") plot(p) lines(lns, col=\"red\", lwd=2)   ### from wkt v <- vect(\"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\")  wkt <- c(\"MULTIPOLYGON ( ((40 40, 20 45, 45 30, 40 40)),  ((20 35, 10 30, 10 10, 30 5, 45 20, 20 35),(30 20, 20 15, 20 25, 30 20)))\",  \"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\") w <- vect(wkt)  # combine two SpatVectors  vw <- rbind(w, v)  # add a data.frame d <- data.frame(id=1:2, name=c(\"a\", \"b\")) values(w) <- d  # add data.frame on creation, here from a geom matrix g <- geom(w) d <- data.frame(id=1:2, name=c(\"a\", \"b\")) m <- vect(g, \"polygons\", atts=d, crs=\"+proj=longlat +datum=WGS84\")  ### SpatVector from a data.frame d$wkt <- wkt x <- vect(d, geom=\"wkt\")  d$wkt <- NULL d$lon <- c(0,10) d$lat <- c(0,10) x <- vect(d, geom=c(\"lon\", \"lat\"))  # SpatVector to sf #sf::st_as_sf(x)"},{"path":"https://rspatial.github.io/terra/reference/vector_layers.html","id":null,"dir":"Reference","previous_headings":"","what":"List or remove layers from a vector file — vector_layers","title":"List or remove layers from a vector file — vector_layers","text":"List remove layers vector file supports layers GPGK","code":""},{"path":"https://rspatial.github.io/terra/reference/vector_layers.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"List or remove layers from a vector file — vector_layers","text":"","code":"vector_layers(filename, delete=\"\", return_error=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/vector_layers.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"List or remove layers from a vector file — vector_layers","text":"filename character. filename delete character. layers deleted (ignored value \"\" return_error logical. TRUE, error occurs layers deleted. Otherwise warning given","code":""},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute a viewshed — viewshed","title":"Compute a viewshed — viewshed","text":"Use elevation data compute locations can seen, much higher seen, certain position. raster data coordinate reference system must planar (lon/lat), elevation values unit distance unit coordinate reference system.","code":""},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute a viewshed — viewshed","text":"","code":"# S4 method for SpatRaster viewshed(x, loc, observer=1.80, target=0, curvcoef=6/7, output=\"yes/no\", filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute a viewshed — viewshed","text":"x SpatRaster, single layer elevation values. Values unit map units loc location (x y coordinates) cell number observer numeric. height elevation data observer target numeric. height elevation data targets curvcoef numeric. Coefficient consider effect curvature earth refraction atmosphere. elevation values corrected : elevation = elevation - curvcoeff * (distance)^2 / (earth_diameter). means default value 0.85714, lose sight 1 meter elevation 385 m planar distance output character. Can \"yes/\" get binary (logical) output showing areas visible; \"land\" get height current elevation visible; \"sea\" elevation sea level visible filename character. Output filename ... Options writing files writeRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Compute a viewshed — viewshed","text":"algorithm used Wang et al.: https://www.asprs.org/wp-content/uploads/pers/2000journal/january/2000_jan_87-90.pdf.","code":""},{"path":"https://rspatial.github.io/terra/reference/viewshed.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute a viewshed — viewshed","text":"","code":"if (gdal() >= 3.1) {   f <- system.file(\"ex/elev.tif\", package=\"terra\")   r <- rast(f)   x <- project(r, \"EPSG:2169\")   p <- cbind(70300, 96982)   v <- viewshed(x, p, 0, 0, 0.85714) }"},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":null,"dir":"Reference","previous_headings":"","what":"Voronoi diagram and Delaunay triangles — voronoi","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"Get Voronoi diagram Delaunay triangles points, nodes lines polygons","code":""},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"","code":"# S4 method for SpatVector voronoi(x, bnd=NULL, tolerance=0, as.lines=FALSE, deldir=FALSE)   # S4 method for SpatVector delaunay(x, tolerance=0, as.lines=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"x SpatVector bnd SpatVector set outer boundary voronoi diagram tolerance numeric >= 0, snapping tolerance (0 snapping) .lines logical. TRUE, lines returned without outer boundary deldir logical. TRUE, deldir used instead GEOS C++ library method. reported deldir choke large data sets","code":""},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"SpatVector","code":""},{"path":"https://rspatial.github.io/terra/reference/voronoi.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Voronoi diagram and Delaunay triangles — voronoi","text":"","code":"wkt <- c(\"MULTIPOLYGON ( ((40 40, 20 45, 45 30, 40 40)),    ((20 35, 10 30, 10 10, 30 5, 45 20, 20 35),(30 20, 20 15, 20 25, 30 20)))\",    \"POLYGON ((0 -5, 10 0, 10 -10, 0 -5))\") x <- vect(wkt) v <- voronoi(x) v #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 14, 0  (geometries, attributes) #>  extent      : -55, 100, -65, 100  (xmin, xmax, ymin, ymax) #>  coord. ref. :    d <- delaunay(x) d #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 18, 0  (geometries, attributes) #>  extent      : 0, 45, -10, 45  (xmin, xmax, ymin, ymax) #>  coord. ref. :    plot(v, lwd=2, col=rainbow(15)) lines(x, col=\"gray\", lwd=2) points(x)"},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":null,"dir":"Reference","previous_headings":"","what":"Virtual Raster Dataset — vrt","title":"Virtual Raster Dataset — vrt","text":"Create Virtual Raster Dataset (VRT) collection file-based raster datasets (tiles). See  gdalbuildvrt details.","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Virtual Raster Dataset — vrt","text":"","code":"# S4 method for character vrt(x, filename=\"\", options=NULL, overwrite=FALSE, set_names=FALSE, return_filename=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Virtual Raster Dataset — vrt","text":"x character. Filenames raster \"tiles\". , files data , typically non-overlapping, sub-regions raster. See makeTiles filename character. output VRT filename options character. arguments separate vector elements. Options gdalbuildvrt overwrite logical. filename overwritten exists? set_names logical. Add layer names first tile vrt? return_filename logical. TRUE filename returned, otherwise SpatRaster returned","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Virtual Raster Dataset — vrt","text":"SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Virtual Raster Dataset — vrt","text":"VRT can reference many datasets. opened time. default open 100 files. increase performance, maximum limit can increased setting GDAL_MAX_DATASET_POOL_SIZE configuration option bigger value setGDALconfig. Note typical user process Linux limited 1024 simultaneously opened files.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/vrt.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Virtual Raster Dataset — vrt","text":"","code":"r <- rast(ncols=100, nrows=100) values(r) <- 1:ncell(r) x <- rast(ncols=2, nrows=2) filename <- paste0(tempfile(), \"_.tif\") ff <- makeTiles(r, x, filename) ff #> [1] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_1.tif\" #> [2] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_2.tif\" #> [3] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_3.tif\" #> [4] \"/var/folders/2f/8t5k6yr535sdw0s4glnpxrzm0000gn/T//RtmpUrLSv3/file34aa15b2b20a_4.tif\"  #vrtfile <- paste0(tempfile(), \".vrt\") #v <- vrt(ff, vrtfile)   ## output in lower resolution #vrtfile <- paste0(tempfile(), \".vrt\") #v <- vrt(ff, vrtfile, options = c(\"-tr\", 5, 5)) #head(readLines(vrtfile)) #v"},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":null,"dir":"Reference","previous_headings":"","what":"filenames of VRT tiles — vrt_tiles","title":"filenames of VRT tiles — vrt_tiles","text":"Get filenames tiles Virtual Raster Dataset (VRT)","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"filenames of VRT tiles — vrt_tiles","text":"","code":"vrt_tiles(x)"},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"filenames of VRT tiles — vrt_tiles","text":"x character (filename) SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/vrt_tiles.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"filenames of VRT tiles — vrt_tiles","text":"character","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":null,"dir":"Reference","previous_headings":"","what":"Weighted mean of layers — weighted.mean","title":"Weighted mean of layers — weighted.mean","text":"Compute weighted mean cell layers SpatRaster. weights can spatially variable .","code":""},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Weighted mean of layers — weighted.mean","text":"","code":"# S4 method for SpatRaster,numeric weighted.mean(x, w, na.rm=FALSE, filename=\"\", ...)  # S4 method for SpatRaster,SpatRaster weighted.mean(x, w, na.rm=FALSE, filename=\"\", ...)"},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Weighted mean of layers — weighted.mean","text":"x SpatRaster w vector weights (one number layer), spatially variable weights, SpatRaster weights (extent, resolution number layers x) na.rm Logical. missing values removed? filename character. Output filename ... options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Weighted mean of layers — weighted.mean","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/weighted.mean.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Weighted mean of layers — weighted.mean","text":"","code":"b <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))     # give least weight to first layer, most to last layer wm1 <- weighted.mean(b, w=1:3)  # spatially varying weights # weigh by column number w1 <- init(b, \"col\")  # weigh by row number w2 <- init(b, \"row\") w <- c(w1, w2, w2)  wm2 <- weighted.mean(b, w=w)"},{"path":"https://rspatial.github.io/terra/reference/where.html","id":null,"dir":"Reference","previous_headings":"","what":"Where are the cells with the min or max values? — where","title":"Where are the cells with the min or max values? — where","text":"method returns cell numbers cells min max values layer SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Where are the cells with the min or max values? — where","text":"","code":"# S4 method for SpatRaster where.min(x, values=TRUE, list=FALSE)  # S4 method for SpatRaster where.max(x, values=TRUE, list=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Where are the cells with the min or max values? — where","text":"x SpatRaster values logical. TRUE min max values also returned list logical. TRUE list returned instead matrix","code":""},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Where are the cells with the min or max values? — where","text":"matrix list","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/where.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Where are the cells with the min or max values? — where","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) where.min(r) #>      layer cell value #> [1,]     1 7770   141 #> [2,]     1 8055   141"},{"path":"https://rspatial.github.io/terra/reference/which.html","id":null,"dir":"Reference","previous_headings":"","what":"Which cells are TRUE? — which.lyr","title":"Which cells are TRUE? — which.lyr","text":"method returns single layer SpatRaster cell values indicating first layer input TRUE. numbers zero (FALSE), considered TRUE.","code":""},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Which cells are TRUE? — which.lyr","text":"","code":"# S4 method for SpatRaster which.lyr(x)"},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Which cells are TRUE? — which.lyr","text":"x SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Which cells are TRUE? — which.lyr","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/which.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Which cells are TRUE? — which.lyr","text":"","code":"s <- rast(system.file(\"ex/logo.tif\", package=\"terra\"))    x <- which.lyr(s > 100)"},{"path":"https://rspatial.github.io/terra/reference/width.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatVector geometric properties — width","title":"SpatVector geometric properties — width","text":"width returns minimum diameter geometry, defined smallest band contains geometry, band strip plane defined two parallel lines. can thought smallest hole geometry can moved , single rotation. clearance returns minimum clearance geometry. minimum clearance smallest amount vertex moved produce invalid polygon, non-simple linestring, multipoint repeated points. geometry minimum clearance 'mc', can said : two distinct vertices geometry separated less 'mc' vertex closer 'mc' line segment endpoint. minimum clearance defined geometry (single point, multipoint whose points identical, NA returned.","code":""},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatVector geometric properties — width","text":"","code":"# S4 method for SpatVector width(x, as.lines=FALSE) # S4 method for SpatVector clearance(x, as.lines=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatVector geometric properties — width","text":"x SpatVector lines polygons .lines logical. TRUE lines returned define width clearance","code":""},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatVector geometric properties — width","text":"numeric SpatVector","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/width.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatVector geometric properties — width","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) width(v) #>  [1] 25511.501 20333.498 19019.103  9255.223 20141.189 14308.518 15475.916 #>  [8] 18111.001 17435.502 15750.096 18936.122 15692.522 clearance(v) #>  [1] 24.349993 50.070894 31.878312 51.390103 13.517168 15.960117  2.871879 #>  [8] 17.584083  9.023613  4.239727  8.231322 60.918397"},{"path":"https://rspatial.github.io/terra/reference/window.html","id":null,"dir":"Reference","previous_headings":"","what":"Set a window — window","title":"Set a window — window","text":"Assign window (area interest) SpatRaster SpatExtent, set NULL remove window. similar crop without actually creating new dataset. window intersect extent SpatRaster. envisioned future version, window may also go outside boundaries.","code":""},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set a window — window","text":"","code":"# S4 method for SpatRaster window(x)<-value  # S4 method for SpatRaster window(x)"},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set a window — window","text":"x SpatRaster value SpatExtent","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set a window — window","text":"none window<- logical window","code":""},{"path":"https://rspatial.github.io/terra/reference/window.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Set a window — window","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\")  r <- rast(f) global(r, \"mean\", na.rm=TRUE) #>               mean #> elevation 348.3366 e <- ext(c(5.9, 6,49.95, 50))  window(r) <- e global(r, \"mean\", na.rm=TRUE) #>               mean #> elevation 396.4167 r #> class       : SpatRaster  #> dimensions  : 6, 12, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> window      : 5.9, 6, 49.95, 50  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : elev.tif  #> name        : elevation  #> min value   :      >141  #> max value   :      547<   x <- rast(f) xe <- crop(x, e) global(xe, \"mean\", na.rm=TRUE) #>               mean #> elevation 396.4167  b <- c(xe, r) window(b) #> [1] FALSE  TRUE b #> class       : SpatRaster  #> dimensions  : 6, 12, 2  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent (win): 5.9, 6, 49.95, 50  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> sources     : memory   #>               elev.tif   #> varnames    : elev  #>               elev  #> names       : elevation, elevation  #> min values  :       323,      >141  #> max values  :       492,      547<   window(r) <- NULL r #> class       : SpatRaster  #> dimensions  : 90, 95, 1  (nrow, ncol, nlyr) #> resolution  : 0.008333333, 0.008333333  (x, y) #> extent      : 5.741667, 6.533333, 49.44167, 50.19167  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source      : elev.tif  #> name        : elevation  #> min value   :       141  #> max value   :       547"},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":null,"dir":"Reference","previous_headings":"","what":"wrap and unwrap — wrap","title":"wrap and unwrap — wrap","text":"Use wrap pack SpatVector SpatRaster* create Packed* object. Packed objects can passed connection serializes (e.g. nodes computer cluster). receiving end need unpacked unwrap.","code":""},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"wrap and unwrap — wrap","text":"","code":"# S4 method for SpatRaster wrap(x, proxy=FALSE)  # S4 method for SpatRasterDataset wrap(x, proxy=FALSE)  # S4 method for SpatRasterCollection wrap(x, proxy=FALSE)  # S4 method for SpatVector wrap(x)  # S4 method for ANY unwrap(x)"},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"wrap and unwrap — wrap","text":"x SpatVector, SpatRaster, SpatRasterDataset SpatRasterCollection proxy logical. FALSE raster cell values forced memory possible. TRUE, reference source filenames stored data sources memory","code":""},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"wrap and unwrap — wrap","text":"wrap: Packed* object unwrap: SpatVector, SpatRaster, SpatRasterCollection, SpatRasterDataset","code":""},{"path":"https://rspatial.github.io/terra/reference/wrap.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"wrap and unwrap — wrap","text":"","code":"f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) p <- wrap(v) p #> [1] \"This is a PackedSpatVector object. Use 'terra::unwrap()' to unpack it\" vv <- vect(p) vv #>  class       : SpatVector  #>  geometry    : polygons  #>  dimensions  : 12, 6  (geometries, attributes) #>  extent      : 5.74414, 6.528252, 49.44781, 50.18162  (xmin, xmax, ymin, ymax) #>  coord. ref. : lon/lat WGS 84 (EPSG:4326)  #>  names       :  ID_1   NAME_1  ID_2   NAME_2  AREA   POP #>  type        : <num>    <chr> <num>    <chr> <num> <int> #>  values      :     1 Diekirch     1 Clervaux   312 18081 #>                    1 Diekirch     2 Diekirch   218 32543 #>                    1 Diekirch     3  Redange   259 18664"},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":null,"dir":"Reference","previous_headings":"","what":"SpatRaster wrap with caching options — wrapCache","title":"SpatRaster wrap with caching options — wrapCache","text":"Use wrap pack SpatRaster caching options. See wrap general approach easier better use cases. method allows specifying folder, filenames, cache sources SpatRaster specific location (disk).","code":""},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SpatRaster wrap with caching options — wrapCache","text":"","code":"# S4 method for SpatRaster wrapCache(x, filename=NULL, path=NULL, overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SpatRaster wrap with caching options — wrapCache","text":"x SpatRaster filename character. single filename, one filename per SpatRaster data source. NULL, raster sources saved files path character. NULL, path raster sources saved. Ignored filenames NULL overwrite existing files overwritten files path NULL? value TRUE FALSE, files exist created ... Additional arguments writeRaster. used raster sources memory, sources cached copying files","code":""},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SpatRaster wrap with caching options — wrapCache","text":"PackedSpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/wrapCache.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SpatRaster wrap with caching options — wrapCache","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f)  x <- wrapCache(r, path=tempdir()) x #> [1] \"This is a PackedSpatRaster object. Use 'terra::unwrap()' to unpack it\""},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":null,"dir":"Reference","previous_headings":"","what":"Write raster data to a NetCDF file — writeCDF","title":"Write raster data to a NetCDF file — writeCDF","text":"Write SpatRaster SpatRasterDataset NetCDF file. using SpatRasterDataset, varname, longname, unit set object (see examples). Always use \".nc\" \".cdf\" file extension assure file can properly read GDAL","code":""},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write raster data to a NetCDF file — writeCDF","text":"","code":"# S4 method for SpatRaster writeCDF(x, filename, varname, longname=\"\", unit=\"\", split=FALSE, ...)  # S4 method for SpatRasterDataset writeCDF(x, filename, overwrite=FALSE, zname=\"time\", atts=\"\",      gridmap=\"\", prec=\"float\", compression=NA, missval, ...)"},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write raster data to a NetCDF file — writeCDF","text":"x SpatRaster SpatRasterDataset filename character. Output filename varname character. Name dataset longname character. Long name dataset unit character. Unit data split logical. TRUE layer x treated sub-dataset atts character. vector additional global attributes write. must formatted like c(\"x=value\", \"y=abc\") gridmap character. crs always writting file standard formats. argument can also write format commonly used netcdf files. Something like c(\"grid_mapping_name=lambert_azimuthal_equal_area\", \"longitude_of_projection_origin=10\", \"latitude_of_projection_origin=52\", \"false_easting=4321000\", \"false_northing=3210000\") overwrite logical. TRUE, filename overwritten zname character. name \"time\" dimension prec character. One \"double\", \"float\", \"integer\", \"short\", \"byte\" \"char\" compression Can set integer 1 (least compression) 9 (compression) missval numeric, number used indicate missing values ... additional arguments passed SpatRasterDataset method, possibly ncvar_def","code":""},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Write raster data to a NetCDF file — writeCDF","text":"SpatRaster SpatDataSet","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/writeCDF.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write raster data to a NetCDF file — writeCDF","text":"","code":"f <- system.file(\"ex/elev.tif\", package=\"terra\") r <- rast(f) fname <- paste0(tempfile(), \".nc\") rr <- writeCDF(r, fname, overwrite=TRUE, varname=\"alt\",        longname=\"elevation in m above sea level\", unit=\"m\")  a <- rast(ncols=5, nrows=5, nl=50) values(a) <- 1:prod(dim(a)) time(a) <- as.Date(\"2020-12-31\") + 1:nlyr(a) aa <- writeCDF(a, fname, overwrite=TRUE, varname=\"power\",        longname=\"my nice data\", unit=\"U/Pa\")  b <- sqrt(a) s <- sds(a, b) names(s) <- c(\"temp\", \"prec\") longnames(s) <- c(\"temperature (C)\", \"precipitation (mm)\") units(s) <- c(\"°C\", \"mm\") ss <- writeCDF(s, fname, overwrite=TRUE)  # for CRAN file.remove(fname) #> [1] TRUE"},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":null,"dir":"Reference","previous_headings":"","what":"Write raster data to a file — writeRaster","title":"Write raster data to a file — writeRaster","text":"Write SpatRaster file.","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write raster data to a file — writeRaster","text":"","code":"# S4 method for SpatRaster,character writeRaster(x, filename, overwrite=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write raster data to a file — writeRaster","text":"x SpatRaster filename character. Output filename. Can single filename, many filenames nlyr(x) write file layer overwrite logical. TRUE, filename overwritten ... additional arguments writing files. See Details","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Write raster data to a file — writeRaster","text":"SpatRaster. function used side-effect writing values file.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Write raster data to a file — writeRaster","text":"writeRaster, methods generate SpatRasters, options writing raster files disk can provided additional arguments , cases, wopt argument (named list) additional arguments already used different purpose. See terraOptions get set default values. following options available:","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Write raster data to a file — writeRaster","text":"GeoTiff files , default, written LZW compression. want compression, use gdal=\"COMPRESS=NONE\". writing integer values lowest available value (given datatype) used represent NA signed types, highest value used unsigned values. can problem byte data (0 255) value 255 reserved NA. keep value 255, need set another value NAflag, set NAflag (NAflag=NA)","code":""},{"path":"https://rspatial.github.io/terra/reference/writeRaster.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write raster data to a file — writeRaster","text":"","code":"r <- rast(nrows=5, ncols=5, vals=1:25)  # create a temporary filename for the example f <- file.path(tempdir(), \"test.tif\")  writeRaster(r, f, overwrite=TRUE)  writeRaster(r, f, overwrite=TRUE, gdal=c(\"COMPRESS=NONE\", \"TFW=YES\"), datatype='INT1U')  ## Or with a wopt argument:  writeRaster(r, f, overwrite=TRUE, wopt= list(gdal=c(\"COMPRESS=NONE\"), datatype='INT1U'))  ## remove the file unlink(f)"},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":null,"dir":"Reference","previous_headings":"","what":"Write SpatVector data to a file — writeVector","title":"Write SpatVector data to a file — writeVector","text":"Write SpatVector file. can choose one many file formats.","code":""},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Write SpatVector data to a file — writeVector","text":"","code":"# S4 method for SpatVector,character writeVector(x, filename, filetype=NULL, layer=NULL, insert=FALSE,     overwrite=FALSE, options=\"ENCODING=UTF-8\")"},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Write SpatVector data to a file — writeVector","text":"x SpatVector filename character. Output filename filetype character. file format associated GDAL \"driver\" \"ESRI Shapefile\". See gdal(drivers=TRUE) GDAL docs. NULL attempted guess filetype filename extension layer character. Output layer name. NULL filename used insert logical. TRUE, new layer inserted file, format allows (e.g. GPKG allows ). See vector_layers remove layer overwrite logical. TRUE, filename overwritten options character. Format specific GDAL options \"ENCODING=UTF-8\". Use NULL \"\" use options","code":""},{"path":"https://rspatial.github.io/terra/reference/writeVector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Write SpatVector data to a file — writeVector","text":"","code":"v <- vect(cbind(1:5,1:5)) crs(v) <- \"+proj=longlat +datum=WGS84\" v$id <- 1:length(v) v$name <- letters[1:length(v)] tmpf1 <- paste0(tempfile(), \".gpkg\") writeVector(v, tmpf1, overwrite=TRUE) x <- vect(tmpf1)  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f) tmpf2 <- paste0(tempfile(), \".gpkg\") writeVector(v, tmpf2, overwrite=TRUE) y <- vect(tmpf2)"},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply a function to the cells of a two SpatRasters — xapp","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"Apply function values cell two (multilayer) SpatRasters.","code":""},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"","code":"# S4 method for SpatRaster,SpatRaster xapp(x, y, fun, ..., filename=\"\", overwrite=FALSE, wopt=list())"},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"x SpatRaster y SpatRaster geometry x fun function operates two vectors ... additional arguments fun. typically numerical constants. *never* another SpatRaster filename character. Output filename overwrite logical. TRUE, filename overwritten wopt list named options writing files writeRaster","code":""},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"SpatRaster","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/xapp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply a function to the cells of a two SpatRasters — xapp","text":"","code":"r <- rast(ncols=10, nrows=10, nlyr=5) set.seed(1) r <- init(r, runif) s <- init(r, runif) x <- xapp(r, s, fun=cor)"},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":null,"dir":"Reference","previous_headings":"","what":"Get or set single values of an extent — xmin","title":"Get or set single values of an extent — xmin","text":"Get set single values extent. Values can set SpatExtent SpatRaster, SpatVector)","code":""},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get or set single values of an extent — xmin","text":"","code":"# S4 method for SpatExtent xmin(x)  # S4 method for SpatExtent xmax(x)  # S4 method for SpatExtent ymin(x)  # S4 method for SpatExtent ymax(x)  # S4 method for SpatRaster xmin(x)  # S4 method for SpatRaster xmax(x)  # S4 method for SpatRaster ymin(x)  # S4 method for SpatRaster ymax(x)  # S4 method for SpatVector xmin(x)  # S4 method for SpatVector xmax(x)  # S4 method for SpatVector ymin(x)  # S4 method for SpatVector ymax(x)  # S4 method for SpatRaster,numeric xmin(x)<-value  # S4 method for SpatRaster,numeric xmax(x)<-value  # S4 method for SpatRaster,numeric ymin(x)<-value  # S4 method for SpatRaster,numeric ymax(x)<-value"},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get or set single values of an extent — xmin","text":"x SpatRaster, SpatExtent, SpatVector value numeric","code":""},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get or set single values of an extent — xmin","text":"SpatExtent numeric coordinate","code":""},{"path":"https://rspatial.github.io/terra/reference/xmin.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get or set single values of an extent — xmin","text":"","code":"r <- rast() ext(r) #> SpatExtent : -180, 180, -90, 90 (xmin, xmax, ymin, ymax) ext(c(0, 20, 0, 20)) #> SpatExtent : 0, 20, 0, 20 (xmin, xmax, ymin, ymax)  xmin(r) #> [1] -180 xmin(r) <- 0 xmin(r) #> [1] 0"},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":null,"dir":"Reference","previous_headings":"","what":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"Get coordinates center raster cells row, column, cell number SpatRaster. get row, column, cell numbers coordinates . Cell numbers start 1 upper left corner, increase left right, top bottom. last cell number equals number cells SpatRaster. row numbers start 1 top, column numbers start 1 left.","code":""},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"","code":"# S4 method for SpatRaster,numeric xFromCol(object, col)  # S4 method for SpatRaster,numeric yFromRow(object, row)  # S4 method for SpatRaster,numeric xyFromCell(object, cell)  # S4 method for SpatRaster,numeric xFromCell(object, cell)  # S4 method for SpatRaster,numeric yFromCell(object, cell)  # S4 method for SpatRaster,numeric colFromX(object, x)  # S4 method for SpatRaster,numeric rowFromY(object, y)  # S4 method for SpatRaster,numeric,numeric cellFromRowCol(object, row, col)  # S4 method for SpatRaster,numeric,numeric cellFromRowColCombine(object, row, col)  # S4 method for SpatRaster,numeric,numeric rowColCombine(object, row, col)  # S4 method for SpatRaster,numeric rowFromCell(object, cell)  # S4 method for SpatRaster,numeric colFromCell(object, cell)  # S4 method for SpatRaster,numeric rowColFromCell(object, cell)  # S4 method for SpatRaster,matrix cellFromXY(object, xy)"},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"object SpatRaster cell integer. cell number(s) col integer. column number(s) missing (equivalent columns) row integer. row number(s) missing (equivalent rows) x x coordinate(s) y y coordinate(s) xy matrix x y coordinates","code":""},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"Cell numbers start 1 upper left corner, increase left right, top bottom. last cell number equals number cells SpatRaster (see ncell).","code":""},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"xFromCol, yFromCol, xFromCell, yFromCell: vector x y coordinates xyFromCell: matrix(x,y) coordinate pairs colFromX, rowFromY, cellFromXY, cellFromRowCol, rowFromCell, colFromCell: vector row, column, cell numbers rowColFromCell, rowColCombine: matrix row column numbers","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/xyCellFrom.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Coordinates from a row, column or cell number and vice versa — xyRowColCell","text":"","code":"r <- rast()  xFromCol(r, c(1, 120, 180)) #> [1] -179.5  -60.5   -0.5 yFromRow(r, 90) #> [1] 0.5 xyFromCell(r, 10000) #>         x    y #> [1,] 99.5 62.5 xyFromCell(r, c(0, 1, 32581, ncell(r), ncell(r)+1)) #>           x     y #> [1,]    NaN   NaN #> [2,] -179.5  89.5 #> [3,]    0.5  -0.5 #> [4,]  179.5 -89.5 #> [5,]    NaN   NaN  cellFromRowCol(r, 5, 5) #> [1] 1445 cellFromRowCol(r, 1:2, 1:2) #> [1]   1 362 cellFromRowCol(r, 1, 1:3) #> [1] 1 2 3  # all combinations cellFromRowColCombine(r, 1:2, 1:2) #> [1]   1   2 361 362  colFromX(r, 10) #> [1] 191 rowFromY(r, 10) #> [1] 81 xy <- cbind(lon=c(10,5), lat=c(15, 88)) cellFromXY(r, xy) #> [1] 27191   906  # if no row/col specified all are returned range(xFromCol(r)) #> [1] -179.5  179.5 length(yFromRow(r)) #> [1] 180"},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":null,"dir":"Reference","previous_headings":"","what":"Zonal statistics — zonal","title":"Zonal statistics — zonal","text":"Compute zonal statistics, summarize values SpatRaster \"zone\" defined another SpatRaster, SpatVector polygon geometry. fun true R function, <SpatRaster,SpatRaster> method may fail using large SpatRasters, except functions (\"mean\", \"min\", \"max\", \"sum\", \"isNA\", \"notNA\"). can also summarize values SpatVector polygon (zone) defined another SpatVector.","code":""},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Zonal statistics — zonal","text":"","code":"# S4 method for SpatRaster,SpatRaster zonal(x, z, fun=\"mean\", ..., w=NULL, wide=TRUE,     as.raster=FALSE, filename=\"\", overwrite=FALSE, wopt=list())  # S4 method for SpatRaster,SpatVector zonal(x, z, fun=\"mean\", na.rm=FALSE, w=NULL, weights=FALSE,     exact=FALSE, touches=FALSE, small=TRUE, as.raster=FALSE,     as.polygons=FALSE, wide=TRUE, filename=\"\", wopt=list())  # S4 method for SpatVector,SpatVector zonal(x, z, fun=mean, ..., weighted=FALSE, as.polygons=FALSE)"},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Zonal statistics — zonal","text":"x SpatRaster SpatVector z SpatRaster cell-values representing zones SpatVector polygon geometry representing zone. z can multiple layers define intersecting zones fun function applied summarize values zone. Either character: \"mean\", \"min\", \"max\", \"sum\", \"isNA\", \"notNA\" , relatively small SpatRasters, proper function ... additional arguments passed fun, na.rm=TRUE w SpatRaster weights. single-layer non-negative values wide logical. values returned wide format? SpatRaster, SpatRaster method affects results nlyr(z) == 2. SpatRaster, SpatVector method affects results fun=table .raster logical. TRUE, SpatRaster returned zonal statistic zone filename character. Output filename (ignored .raster=FALSE overwrite logical. TRUE, filename overwritten wopt list additional arguments writing files writeRaster weights logical. TRUE y polygons, approximate fraction cell covered returned well, example compute weighted mean exact logical. TRUE y polygons, exact fraction cell covered returned well, example compute weighted mean touches logical. TRUE, values cells touched lines polygons extracted, just line render path, whose center point within polygon. relevant points; always considered TRUE weights=TRUE exact=TRUE small logical. TRUE, values cells touched polygons extracted none cells center points within polygon; even touches=FALSE weighted logical. TRUE, weighted.mean computed fun ignored. Weights based length lines area polygons x intersect z. argument ignored x SpatVector points .polygons logical. zonal statistics combined geometry z? na.rm logical. TRUE, NAs removed","code":""},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Zonal statistics — zonal","text":"data.frame value zone, SpatRaster, SpatVector polygons.","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/reference/zonal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Zonal statistics — zonal","text":"","code":"### SpatRaster, SpatRaster r <- rast(ncols=10, nrows=10) values(r) <- 1:ncell(r) z <- rast(r) values(z) <- rep(c(1:2, NA, 3:4), each=20) names(z) <- \"zone\" zonal(r, z, \"sum\", na.rm=TRUE) #>   zone lyr.1 #> 1    1   210 #> 2    2   610 #> 3    3  1410 #> 4    4  1810  # with weights  w <- init(r, \"col\") zonal(r, z, w=w, \"mean\", na.rm=TRUE) #>   zone lyr.1 #> 1    1    12 #> 2    2    32 #> 3    3    72 #> 4    4    92  # multiple layers r <- rast(system.file(\"ex/logo.tif\", package = \"terra\"))  # zonal layer  z <- rast(r, 1) names(z) <- \"zone\" values(z) <- rep(c(1:2, NA, c(3:4)), each=ncell(r)/5, length.out=ncell(r))  zonal(r, z, \"mean\", na.rm = TRUE) #>   zone      red    green     blue #> 1    1 197.9486 198.0103 193.5556 #> 2    2 173.2219 176.7717 185.2585 #> 3    3 168.2952 172.6232 184.6939 #> 4    4 193.5859 197.0019 206.5717  # raster of zonal values zr <- zonal(r, z, \"mean\", na.rm = TRUE, as.raster=TRUE)   ### SpatRaster, SpatVector x <- rast(ncol=2,nrow=2, vals=1:4, xmin=0, xmax=1, ymin=0, ymax=1, crs=\"+proj=utm +zone=1\") p <- as.polygons(x) pp <- shift(p, .2) r <- disagg(x, 4)  zonal(r, p) #>   lyr.1 #> 1     1 #> 2     2 #> 3     3 #> 4     4 zonal(r, p, sum) #>   lyr.1 #> 1    16 #> 2    32 #> 3    48 #> 4    64 zonal(x, pp, exact=TRUE) #>   lyr.1 #> 1   1.4 #> 2   2.0 #> 3   3.4 #> 4   4.0 zonal(c(x, x*10), pp, w=x) #>   lyr.1 lyr.1 #> 1     1    10 #> 2     2    20 #> 3     3    30 #> 4     4    40   ### SpatVector, SpatVector  f <- system.file(\"ex/lux.shp\", package=\"terra\") v <- vect(f)[,c(2,4)]  p <- spatSample(v, 100) values(p) <- data.frame(b2=1:100, ssep1=100:1)  zonal(p, v, mean) #>    zone       b2    ssep1 #> 1     1 45.60000 55.40000 #> 2     2 45.66667 55.33333 #> 3     3 49.00000 52.00000 #> 4     4 66.66667 34.33333 #> 5     5 50.66667 50.33333 #> 6     6 59.33333 41.66667 #> 7     7 59.16667 41.83333 #> 8     8 48.88889 52.11111 #> 9     9 55.40000 45.60000 #> 10   10 49.42857 51.57143 #> 11   11 40.85714 60.14286 #> 12   12 48.16667 52.83333"},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":null,"dir":"Reference","previous_headings":"","what":"Zoom in on a map — zoom","title":"Zoom in on a map — zoom","text":"Zoom map (plot) providing new extent, default done clicking twice map.","code":""},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Zoom in on a map — zoom","text":"","code":"# S4 method for SpatRaster zoom(x, e=draw(), maxcell=100000, layer=1, new=FALSE, ...)  # S4 method for SpatVector zoom(x, e=draw(), new=FALSE, ...)"},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Zoom in on a map — zoom","text":"x SpatRaster e SpatExtent maxcell positive integer. Maximum number cells used map layer positive integer select layer used new logical. TRUE, zoomed map appear new device (window) ... additional arguments passed plot","code":""},{"path":"https://rspatial.github.io/terra/reference/zoom.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Zoom in on a map — zoom","text":"SpatExtent (invisibly)","code":""},{"path":[]},{"path":[]},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-79","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-79","text":"flip(direction=\"vertical\") failed cases #1518 Ed Carnell zonal(.raster=TRUE) failed zonal raster categorical 1514 Jessi L Brown","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-79","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-79","text":".list<SpatRasterDataset> sets names list #1513 SpatVectorCollection can now subsetted names; made list takes names list. 1515 jedgroev","code":""},{"path":[]},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-78","dir":"Changelog","previous_headings":"","what":"version 1.7-78","title":"version 1.7-78","text":"CRAN release: 2024-05-22 Released 2023-05-22","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-78","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-78","text":"writeVector readVector better handle empty geopackage layers #1426 Andrew Gene Brown. writeCDF wrote global variables one #1443 Daniel Schlaepfer rasterize “” returned odd layernames #1435 Philippe Massicotte convHull, minCircle minRect zero-row SpatVector crashed R #1445 Andrew Gene Brown rangeFill argument circular=TRUE work properly #1460 Alice crs(describe = TRUE) returned mis-ordered extent #1485 Dimitri Falk tapp custom function index like “yearmonths” shift time considering time zone. #1483 Finn Roberts plot<SpatRaster> fail multiple values small differences #1491 srfall .data.frame<SpatRaster> “xy=TRUE” “wide=FALSE” fail coordinates similar #1476 Pascal Oettli rasterizeGeom now returns correct layer name #1472 HRodenhizer cellSize “mask=TRUE” failed output written temp file #1496 Pascal Sauer ext<SpatVectorProxy> return full extent #1501 erkent-carb","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-78","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-78","text":"extract new argument “small=TRUE” allow strict use “touches=FALSE” #1419 Floris Vanderhaeghe. .list<SpatRaster> new argument “geom=NULL” rast<list> now recognizes (x, y, z) base R “image” structures stackoverflow Ignacio Marzan. inset new arguments “offset” “add” #1422 Armand-CT expanse<SpatRaster> argument usenames #1446 Bappa Das default color palette now terra::map.pal(\"viridis\") instead terrain.colors. default can changes options(terra.pal=...) #1474 Derek Friend .list<SpatRasterDataset> now returns named list. #1513 Eric R. Scott","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-78","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-78","text":"bestMatch<SpatRaster> method argument “pairs=TRUE” cells https://github.com/rspatial/terra/issues/1487 Floris Vanderhaeghe add_grid add grid map","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-71","dir":"Changelog","previous_headings":"","what":"version 1.7-71","title":"version 1.7-71","text":"CRAN release: 2024-01-31 Released 2023-01-31","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-71","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-71","text":"k_means work NAs #1314 Jakub Nowosad layerCor custom function work anymore #1387 Jakub Nowosad plet broke using “panel=TRUE” #1384 Elise Hellwig using /vis3/ open SpatRaster work #1382 Mike Koontz plot<SpatRaster>(add=TRUE) sampled raster data without considering extent map. #1394 Márcia Barbosa plot<SpatRaster>(add=TRUE) now considers first layer multi-layer SpatRaster 1395 Márcia Barbosa set.cats failed tibble used instead data.frame #1406 Mike Koontz polys argument “alpha” ignored single color used. #1413 Derek Friend query ignore “vars” argument rows selected. #1398 erkent-carb. spatSample ignored “replace=TRUE” random sampling, na.rm=TRUE, sample size larger non NA cells. #1411 Babak Naimi spatSample sometimes returned fewer values requested available lonlat rasters. #1396 Márcia Barbosa.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-71","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-71","text":"vect<character> now argument “opts” GDAL open options, e.g. declare file encoding. #1389 Mats Blomqvist plot(plg=list(tic=\"\")) now allows choosing alternative continuous legend tic-mark styles (“”, “”, “” “none”) makeTiles new argument “buffer” #1408 Joy Flowers.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-71","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-71","text":"prcomp<SpatRaster> method #1361 Jakub Nowosad add_box add box around map. box drawn axes , around plotting region. getTileExtents provides extents tiles. may used parallelization. See #1391 Alex Ilich.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-65","dir":"Changelog","previous_headings":"","what":"version 1.7-65","title":"version 1.7-65","text":"CRAN release: 2023-12-15 Released 2023-12-15","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-65","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-65","text":"flip argument direction=\"vertical\" filed cases large rasters processed chunks 0b714b0 Dulci stackoveflow SpatRaster now correctly handles NA & FALSE NA | TRUE #1316 John Baums set.names wasn’t working properly SpatRasterDataset SpatRasterCollection #1333 Derek Friend extract argument “layer” NULL shifted layers #1332 Ewan Wakefield terraOptions capture “memmin” stackoverflow dww rasterize points built-function crash field used #1369 anjelinejeline","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-65","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-65","text":"mosaic can now use fun=\"modal\" rast<matrix> rast<data.frame> now option ’type=“xylz” #1318 Agustin Lobo extract<SpatRaster,SpatVector> can now use multiple summarizing functions #1335 Derek Friend disagg focal optimistic memory requirement estimation #1334 Mikko Kuronen","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-65","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-65","text":"k_means<SpatRaster> method #1314 Agustin Lobo princomp<SpatRaster> method #1361 Alex Ilich .time<SpatRaster> method new argument “raw=FALSE” rast, sds, sprc allow ignoring scale offset 1354 Insang Song","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-55","dir":"Changelog","previous_headings":"","what":"version 1.7-55","title":"version 1.7-55","text":"CRAN release: 2023-10-13 Released 2023-10-14","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-55","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-55","text":"mosaic ignored filename argument SpatRasterCollection single SpatRaster #1267 Michael Mahoney Attempting use extract raster file deleted crashed R. #1268 Derek Friend split<SpatVector,SpatVector> work well cases. #1256 Derek Corcoran Barrios intersect two SpatVectors crashed R date/time variable #1273 Dave Dixon “values=FALSE” ignored spatSample<SpatRaster>(method=\"weights\") #1275 François Rousseu coltab<- works list value #1280 Diego Hernangómez stretch histogram equalization memory-safe #1305 Evan Hersh plot now resets “mar” parameter #1297 Márcia Barbosa plotRGB ignored “smooth” argument #1307 Timothée Giraud","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-55","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-55","text":"argument “gdal” project renamed “use_gdal” #1269 Stuart Brown. SpatVector attributes can now stored ordered factor #1277 Ben Notkin plot<SpatVector> now uses “interval” legend breaks supplied #1303 Gonzalo Rizzo crop<SpatRaster> now keeps metadata, including variable names #1302 rhgof extract(fun=\"table\") now returns easier use data.frame #1294 Fernando Aramburu.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-55","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-55","text":"metags<- metags set arbitrary SpatRaster/file level metadata #1304 Francesco Chianucci","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-46","dir":"Changelog","previous_headings":"","what":"version 1.7-46","title":"version 1.7-46","text":"CRAN release: 2023-09-06 Released 2023-09-06","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-46","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-46","text":"plot<SpatVector> used wrong main label cases #1210 Márcia Barbosa plotRGB failed “ext=” argument #1228 Dave Edge rast<array> failed badly array less three dimensions. #1254 andreimirt. .equal SpatRaster multiple layers #1236 Sarah Endicott zonal(wide=FALSE) give wrong results zonal SpatRaster “layer” layername. #1251 Jeff Hanson panel now support argument “range” #141 Jakub Nowosad rasterize = returned wrong layernames field sorted #1266 Sebastian Dunnett mosaic multiple layers correct #1262 Jean-Romain","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-46","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-46","text":"wrap<SpatRaster> now stores color tables #1215 Patrick Brown global now “maxcell” argument #1213 Alex Ilich layerCor fun=‘pearson’ now returns output layer names #1206 vrt now argument “set_names” #1244 sam--levy vrt now argument “return_filename” #1258 Krzysztof Dyba project<SpatRaster> new argument “by_util” exposing GDAL warp utility #1222 Michael Sumner.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-46","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-46","text":"compareGeom list SpatRasterCollection #1207 Sarah Endicott .rotated<SpatRaster> method #1229 Andy Lyons forceCCW<SpatVector> method force counter-clockwise orientation polygons #1249 srfall. vrt_tiles returns filenames tiles vrt file #1261 Derek Friend extractAlong extract raster cell values line ordered along line. #1257 adamkc.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-39","dir":"Changelog","previous_headings":"","what":"version 1.7-39","title":"version 1.7-39","text":"CRAN release: 2023-06-23 Released 2023-06-23","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-39","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-39","text":"tempdir option use path.expand. #1195 Alex Ilich layer names returned predict inconsistent using argument “index”. #1194 Michael Mahoney compilation failed older compilers use std::filesystem #1191 Small changes RGB<- coltab<- terra can installed R-devel (bug fix https://bugs.r-project.org/show_bug.cgi?id=18538)","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-37","dir":"Changelog","previous_headings":"","what":"version 1.7-37","title":"version 1.7-37","text":"CRAN release: 2023-06-18 Released 2023-06-18","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-37","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-37","text":"rasterize points custom function work large rasters. #1127 Skip Woolley crop<SpatRaster, SpatVector> “mask=TRUE” work well raster scale/offset #1128 Monika Anna Tomaszewska zonal<SpatRaster> custom function always removed NAs. #1133 Matthias Weigand wrap<SpatRaster> lost changed layer names source disk; information time-step cases. #1144 Pascal Führlich global(fun=\"isNA\") correct SpatRaster multiple layers #1141 Robin Freeman interpIDW near=TRUE work properly (near=TRUE now default). #1186 Hugh Graham “YYYY-1-1” sometimes encoded “YYYY-13-1”. #1168 Colin Brust","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-37","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-37","text":"panel categorical SpatRasters. #1143 Jason Flower argument “ext” plot<SpatRaster> can now also expand plot. #1136 Jakub Nowosad. argument overwrite=FALSE makeTiles. #1167 Gray Martin. legend options <plet,SpatVector>. #1177 Agustin Lobo. better handling mixed geometry type vector data vect svc. #1160 Mike Sumner. new argument sql query<SpatVectorProxy>. #1157 Carl Boettiger support writing raster data vitual file system #1209 Carl Boettiger","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-37","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-37","text":"wrap<SpatRasterDataset> wrap<SpatRasterCollection> methods. #954 James Camac","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-29","dir":"Changelog","previous_headings":"","what":"version 1.7-29","title":"version 1.7-29","text":"CRAN release: 2023-04-21 Released 2023-04-22","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-29","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-29","text":"regress<SpatRaster,numeric> get regression model coefficients cell, fixed “X”. regress<SpatRaster,SpatRaster> get regression model coefficients cell.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-29","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-29","text":"lapp<SpatRasterDataset> now flexible can now also use functions vectorized cell, chunk. See #1029 project<SpatVector> new argument “partial=FALSE” can used keep geometries can partially included output crs. extracting SpatVector column non-existing variable name now returns NULL (data.frame ) instead throwing error. #1118 Derek Friend.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-29","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-29","text":"problem reading empty categories .img files created buggy SpatRasters global fun=“notNA” wrong #111 Jeffrey Hanson extract<SpatRaster,SpatVector> “bind=TRUE” work extract<SpatRaster,SpatVector> point geometries “fun” returned values wrong order plot<SpatRaster> argument “colNA” work “alpha” also set #1102 Márcia Barbosa crop<SpatRaster> “extend=TRUE” extend SpatRaster input cell values. #1114 Jasper van Doninck setting factor date/time variable SpatVector work #1117 MK Schneider focalMat work well using terraOptions(todisk=T) #1116","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-23","dir":"Changelog","previous_headings":"","what":"version 1.7-23","title":"version 1.7-23","text":"CRAN release: 2023-04-08 Released 2023-04-08","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-23","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-23","text":"halo function adding halo-ed text plots now exposed add_legend allow using keyword “topleft” position custom legend. #1053 Márcia Barbosa .crs function now exported countNA<SpatRaster> method split<SpatVector,SpatVector> split polygons lines","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-23","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-23","text":"better support color spaces RGB #1060 Dominic Royé path expansion writeVector #1055 Andrew Gene Brown. clamp<SpatRaster> now also accepts SpatRasters set lower upper boundaries. freq new arguments “zones=NULL” “wide=FALSE”, allow tabulation values zone. expanse<SpatRaster> new arguments “zones=NULL” “wide=FALSE”, allow tabulation values zone. unique<SpatRaster> new argument “digits=NA” rasterize<SpatRaster,SpatVector> now accepts fun=“table” tabulate cells cell value rast<character> new argument “snap” snap window . #1094 Derek Friend plot new argument “clip=TRUE” can set FALSE avoid clipping axes mapped area #1080 Márcia Barbosa better error message coercing sf object fully formed #1098 Brandon McNellis writeCDF<SpatRaster> new argument “split” allowing treat layer subdataset #1077 Andrea Manica global now accepts multiple summarizing functions","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-23","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-23","text":"SpatRaster RGB layers forced INT1U writing #1051 Cesar Aybar files multiple vector layers, crs first layer always used; ignoring crs different layers #1052 Andrew Gene Brown sieve able write file #1061 leo rasterize work sf objects #1054 Jakub Nowosad query work hyphenated layer names #1058 Robbie Price focal3D na.policy work #1057 Flávio Mota layerCor na.rm=TRUE failed SpatRaster 2 layers #1056 Alex Ilich. inset keyword positioning work well #1053 Márcia Barbosa yearmonths time stamps read file years <1970 >2037 #1062 Colin Brust compareGeom work multiple SpatRasters #1063 viewshed handle filename argument. #1100 kamistick","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-18","dir":"Changelog","previous_headings":"","what":"version 1.7-18","title":"version 1.7-18","text":"CRAN release: 2023-03-06 Released 2023-03-06","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-18","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-18","text":"argument order=FALSE sort<SpatRaster> sort<SpatVector> (<data.frame> method argument =NULL rasterize> #986 Sam Weber meta<SpatRaster> method get metadata compare<SpatRaster> logic<SpatRaster> methods vect<SpatExtent> method panel<SpatRaster> “panel” plots (multiple layers, single legend)","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-7-18","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.7-18","text":"now possible save terra options across sessions #995 Guillaume Patoine. better warnings .lonlat #1006 Andrew Gene Brown argument na.rm merge<SpatRaster> axes maps created plot now snug around mapped area, instead limits graphics figure region. C++ cleaning avoid warnings clang-tidy (e.g. now using .empty() instead .size()==0). [#1013-1017] Michael Chirico rasterize lines polygons can now use “fun” argument (min, max, mean, sum) #1041 Bart Huntley","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-18","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-18","text":"legend created plet always correct. #983 Simon Rolph spatSample<SpatRaster>(regular=TRUE) failed providing two numbers (row, col) sample size. #991 srfall merge<SpatRaster> ignore NAs #1002 jmmonnet. writeCDF failed using argument force_v4 #1009 R. Kyle Bocinsky predict better handling rasters many NAs #988 Lucas Johnson layerCor handle NAs well different cells across layers #1034 François Rousseu.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-17-3","dir":"Changelog","previous_headings":"","what":"version 1.7-3","title":"version 1.7-3","text":"CRAN release: 2023-01-24 Released 2023-01-24","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-7-3","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.7-3","text":"argument w zonal<SpatRaster,SpatRaster> compute weighted means zonal<SpatRaster,SpatVector> method clamp_ts method","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-7-3","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.7-3","text":"previous version, bug introduced order operation arithmetic operations SpatRasters ignored. #978 Andrew Marx Fixed split<SpatVector>. #979 srfall spatSample .df=FALSE returned data.frame instead matrix #982 Alex Ilich","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-53","dir":"Changelog","previous_headings":"","what":"version 1.6-53","title":"version 1.6-53","text":"CRAN release: 2023-01-17 Released 2023-01-17","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-53","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-53","text":"arithmetic logical operations SpatRaster matrix, allow using cell-varying cell/layer-varying scalars. layer-varying scalars already supported via vectors.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-53","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-53","text":"shade now vectorized arguments angle direction facilitate generating multiple hillshades can combined better result #948 Jürgen Niedballa sharedPaths now uses spatial indices #960 Jeff Hanson predict better support models ranger return anything missing values #968 Alex Ilich","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-53","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-53","text":"writeCDF now supports writing yearly time steps #926 Andrea Manica .contour now works single level #966 Johannes Signer subsetting SpatRaster window returned SpatRaster dimensions non-windowed raster, thus changing resolution. #964 Derek Friend removing factor variable SpatVector crashed R. #969 Andrew Gene Brown median always return correct number SpatRaster 3 layers #970 MatteaE","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-47","dir":"Changelog","previous_headings":"","what":"version 1.6-47","title":"version 1.6-47","text":"CRAN release: 2022-12-02 Released 2022-12-02","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-47","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-47","text":"roll<SpatRaster> method rolling (moving) average rolling functions noNA<SpatRaster> method identify cells NA (across layers) rangeFill<SpatRaster> method","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-47","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-47","text":"argument exhaustive spatSample<SpatRaster> large sparse rasters. [#905] PetiteTong. focalPairs focalReg can now use values custom windows weights. [#907] Fabian Fischer. focalReg now additional argument “intercept=TRUE”. [#916] Jordan Adamson crs(x, warn=TRUE)<- now emits warning difference transforming setting crs x already crs. [#897] Márcia Barbosa. now possible write scale offset writeRaster [#900] Kyle David crosstab now shows labels names categorical SpatRaster. [895] Derek Corcoran Barrios makeTiles can now take SpatVector define tiles. [920] Tristan Goodbody","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-47","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-47","text":"focalPairs focalReg now work custom windows [#907] Fabian Fischer argument “alpha” plot<SpatVector> working properly. [#906] Márcia Barbosa. time<- time-step “years” handle negative years. [#911] Andrea Manica wrap/unwrap (extension saveRDS/readRDS) handle categorical rasters well [#912] Christine Anderson. interpIDW failed GDAL 3.6 [#910] Roger Bivand spatSample strata bug fix “unable find inherited method function ‘trim’” [#919] Alfredo Ascanio possible slice SpatRaster SpatExtent [#914] Jakub Nowosad. merge/mosaic handle NAs using two layers [#913] Joao Carreiras.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-6-47","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.6-47","text":"focalCor -> focalPairs reflect possible use beyond correlation","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-41","dir":"Changelog","previous_headings":"","what":"version 1.6-41","title":"version 1.6-41","text":"CRAN release: 2022-11-18 Released 2022-11-18","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-41","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-41","text":"[ [<- SpatRaster now third index k subsetting assigning values layer anyNA allNA SpatRaster unwrap restore PackedSpatVector PackedSpatRaster rasterizeWin method rasterization moving window (circle, ellipse, rectangle, buffer) interpIDW method inverse-distance-weighted interpolation points moving window interpNear method nearest neighbor interpolation points moving window viewshed method SpatRaster update method SpatRaster write new names new extent crs existing raster file. sieve filter SpatRaster argument segments=FALSE disagg<SpatRaster> sprc<character> method create SpatRasterCollection file subdatasets graticule function create SpatGraticule related methods plot<SpatGraticule> crop<SpatGraticule> elongate method SpatVector lines","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-41","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-41","text":"faster mosaic merge<SpatRaster> [#577] Jean-Romain wrap<SpatRaster> now uses file references data deemed large load memory. [#801] Jean-Romain readRDS unserialize now return SpatRaster SpatVector (instead PackedSpat*) better support “local” arbitrary Euclidean crs [#797] Agustin Lobo clamp can now take low high values layer pax argument plot now provides control draw axis via parameters side, tick lab pax argument plot now argument retro use sexagesimal notation degrees extend new argument fill=NA warning now given combining SpatRasters different CRSs. [#818] Andrew Marx plotRGB now accounts value zlim stretching; allowing use coloring scheme across SpatRasters [#810] Agustin Lobo. center rotation spin now vectorized","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-41","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-41","text":"annoying garbage collection messages Error x$.self$finalize() : attempt apply non-function now suppressed cases. [#218] Charlie Joey Hadley. problem go away altogether new version “Rcpp” released (ETA Jan 2023) thanks fix Kevin Ushey [#30] spatSample na.rm SpatRasters multiple layers work. [#800] Andrea Manica adjacent<SpatRaster> pairs=TRUE, include=TRUE ignored include=TRUE [#808] Joseph Lewis rasterize accept “NA” value updating [#809] Márcia Barbosa extract perfectly vertical horizontal line failed cases [#823] Dimitri Falk wrap<SpatVector> failed single point geometry [#815] Patrick Schaefer extract<SpatRaster> weights=TRUE return values [#814] Jean-Luc Dupouey. x[[\"newname\"]] <- r SpatRasters x r work [#795] Jim Shady fixed support non-conventional netCDF files [#869] Mike Sumner, [#864] eleanorecc, [#851] Philippe Massicotte.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-6-41","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.6-41","text":"costDistance -> costDist avoid conflict {gdistance} gridDistance -> gridDist consistency","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-17","dir":"Changelog","previous_headings":"","what":"version 1.6-17","title":"version 1.6-17","text":"CRAN release: 2022-09-10 Released 2022-09-10","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-17","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-17","text":"droplevels SpatRaster. [#757] Rodolfo Jaffe. normalize.longitude SpatVector. scoff get scoff<- set scale (gain) offset SpatRaster.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-17","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-17","text":"new argument raw=FALSE extract<SpatRaster> [#776] Thomas Roh. .data.frame now takes na.rm=NA remove rows NA layers. default value changed TRUE NA. [#792] Ed Carnell faster plotting SpatVector data [#774] Krzysztof Dyba distance<SpatRaster> new arguments “target” “exclude”. [#560] Bernardo Brandão Niebuhr new argument sparse=FALSE `relate<SpatVector,SpatVector>. new argument usenames=FALSE lapp<SpatRasterDataset> [#793] Colin Brust. vect<character> now reports file non-existent [#784] John Baums faster relate [#716] Krzysztof Dyba focal3D now checks window’s dimensions odd [#772] Neander Marcel Heming","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-17","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-17","text":".equal bug [#756] fixed John Baums extract<\"SpatRaster\",\"sf\"> ignored ID argument. [#755] Dainius Masiliūnas. now (cases) check avoid overwriting (one ) input file(s) writing raster file [#760] John Baums vrt longer constrained maximum number files can opened [#780] 8Ginette8 weighted.mean crashed numeric weights na.rm=TRUE [#777] David Holstius project<SpatRaster> consider extent set user [#775] Philippe Massicotte focalCor failed large rasters [#607] John Clark focal expand=TRUE prone run memory [#610] Nathan Elliott crop<SpatVector> work well second argument points lines [#782] Márcia Barbosa adjacent pairs=TRUE now respects include=TRUE argument [808] Joseph Lewis","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-7","dir":"Changelog","previous_headings":"","what":"version 1.6-7","title":"version 1.6-7","text":"CRAN release: 2022-08-07 Released 2022-08-07","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-7","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-7","text":"method blocks guide reading raster data chunks. [#748] John Baums","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-7","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-7","text":"warning given writing raster values outside limits requested datatype [#752] Jim Shady Arguments extract simplified. [#736] François Rousseu","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-7","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-7","text":"values focal correct input SpatRaster multiple layers “custom” function. [#727] Jean-Luc Dupouey. plot<SpatRaster> honor argument legend=FALSE. [#738] Grzegorz Sapijaszko expanse failed processing chunks [#741] Gareth Davies crop<SpatRaster,SpatExtent> argument snap=\"\" lead crash extent beyond SpatRaster. [#740] Mauricio Zambrano-Bigiarini","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-16-3","dir":"Changelog","previous_headings":"","what":"version 1.6-3","title":"version 1.6-3","text":"CRAN release: 2022-07-25 Released 2022-07-25","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-6-3","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.6-3","text":"subst longer uses values changed earlier . [#639] Paul Smith .points<SpatRaster> return wrong factor labels. [#640] Attilio Benini mask<SpatRaster,SpatVector> crashed results written disk. [#646] Monika Anna Tomaszewska extract<SpatRaster,SpatVector(points)>(xy=TRUE) returned locations points, xy-coordinates cells. [#650] Ward Fonteyn wrap<SpatRaster> return correct labels categorical rasters. [#652] Jakub Nowosad better support non-latin characters legend [#658] Krzysztof Dyba holes small lon/lat polygons now properly buffered [#689] David Hofmann","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-6-3","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.6-3","text":"subst can now substitute values multiple input layers single output value (layer) subset<SpatVector> now behaves like subset<data.frame> [#648] Andrew Gene Brown setting category labels vector names now deprecated. data.frame least two columns used. first column cell values (IDs). now possible “drop” layer SpatRaster setting NULL [#664] Daniel Valentins freq now provides labels factors, even bylayer=FALSE. now always returns data.frame (used return matrix cases. [#687] Rodolfo Jaffé disagg aggregate now return warning instead error using (dis)aggregation factor 1.[#684] Justin Fain. project crashed erroneously projecting raster data one celestial body another [#688] Mike Sumner can now set color table two column (value, ID) data.frame categorical rasters can now updated easily [#667] Alex Ilich control matching values colors using plot. [#673] Jakub Nowosad. SpatVector attributes can now also factor, date, POSIXct. [#697] Grant Williamson improved handling missing values extract(method=\"bilinear\"). [#693] swooping-magpie","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-6-3","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.6-3","text":"argument .raster unique<SpatRaster> create categorical raster unique combinations layers input raster. default argument na.rm changed FALSE sort<SpatRaster> sort cell values across layers. .colors .RGB SpatRaster cover can now combine categorical rasters concats combine levels two SpatRaster new categories [#663] Alex Ilich zonal<SpatVector,SpatVector> method aggregate SpatVector attributes polygons","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-34","dir":"Changelog","previous_headings":"","what":"version 1.5-34","title":"version 1.5-34","text":"CRAN release: 2022-06-09 Released 2022-06-09","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-5-34","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.5-34","text":"“flipped” rasters always handled well. [#546] Dan Baston better reading GTiff subdatsets. [#601] Kyle Doherty better handling multi-layer categorical rasters extract. [#580] André M. Bellvé weighted.mean adjust weights NAs values. [#574] Lars Dalby bug masking. [#552] reported Márcia Barbosa [565] Jakub Nowosad. fixed stretch option plotRGB [#550] Agustin Lobo unwrap SpatRaster failed crs including “’”. [#602] Jean Romain. spatSample cells=TRUE failed planar data [#544] Benjamin Misiuk compareGeom(x, y, stopOnError=FALSE) remove error messages stored x leading unexpected warnings later . [#568] David Hofmann.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-34","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-34","text":"Using & | SpatRasters now returns boolean SpatRaster. [#594] Dan Baston SpatVector now supports logical values. [#593] Derek Friend Attempt create SpatRaster invalid number rows now gives error. [#544] Dan Baston layerCor create temp files anymore. [#551] Christine Anderson using iterator symbols nested loops avoid warnings Intel compiler. [#573] Gareth Davies.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-5-34","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.5-34","text":"new arguments res origin project<SpatRaster> method. [#596] Alex Ilich new argument inside=TRUE centroids get centroid-like point guaranteed geometry (“point surface”). [#588] Márcia Barbosa new argument keepgeom=FALSE vect<data.frame> allows setting (keeping) geometry attribute. [#586] Márcia Barbosa saveRDS serialize methods SpatRaster SpatVector. [#549] Andrei Mîrț xFromCol yFromCol now <SpatRaster,missing> method. [#583] Michael Sumner. svc<sf> method deal GeometryCollection types. [#585] Sarah Endicott .points<SpatRaster> .polygons<SpatRaster> new argument na.=FALSE affects interpretation na.rm. [#548] Jean-Luc Dupouey. setGDALconfig getGDALconfig set GDAL configuration options. [#608] Erik Bolch. new argument circular rapp allow start end (layers represent days year) new method costDistance<SpatRaster> new methods .min .max SpatRaster get cell numbers extreme values SpatRaster. new method emptyGeoms<SpatVector> get indices empty (null) geometries new method rasterizeGeom rasterize geometry count area (small) polygons length lines. new method .na SpatRaster shortcut !.na(x). .list implemented <SpatRasterDataset>. sources implemented <SpatRasterDataset>, <SpatVector> <SpatVectorProxy> [#638] Andrew Gene Brown","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-5-34","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.5-34","text":"delauny -> delaunay [#627] Derek Friend","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-21","dir":"Changelog","previous_headings":"","what":"version 1.5-21","title":"version 1.5-21","text":"CRAN release: 2022-02-16 Released 2022-02-17 writeVector vect now work GPGK path non-ascii characters [#518] results predict cores > 1 one output variable garbled zonal dropped category names using external (R) function [#527] Jakub Nowosad focal/focalCpp showed strange patterns window size larger block size [#519] Alex Ilich using xy=TRUE .data.frame normalized names [#538] Kodi Arfer new argument options vrt [#629] Monika Tomaszewska.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-21","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-21","text":"makeTiles new arguments extend na.rm [#520] L. Dalby project<SpatRaster> now uses nearest neighbor default method RGB rasters new argument na.rm=TRUE unique. [#561] Matthieu Stigler","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-17","dir":"Changelog","previous_headings":"","what":"version 1.5-17","title":"version 1.5-17","text":"CRAN release: 2022-01-30 Released 2022-01-30","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-5-17","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.5-17","text":"app<SpatRasterDataset> ignored filename. [#498] jszhao vect<data.frame> failed silently xy coordinates integers [#496] Márcia Barbosa output aggregate<SpatRaster> malformed nrow(x) %% fact != 0. [#492] Jean-François Bourdon Integer NAs SpatVector attributes recognized Windows [#491] Márcia Barbosa plot<SpatVector> failed using character variable many unique values. [#489] Márcia Barbosa rotate failed large files. Reported Ujjawal Singh writing raster files color table lead crash [#501] Kodi Arfer crds replicated coordinates [#504] Murray Efford .data.frame<SpatRaster> returned integers file stored values integers, even scale/offset creates decimal numbers [#509] Kodi Arfer project opened input raster file read/write mode instead read mode. work files updated.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-17","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-17","text":"distance, gridDistance, direction patches now process layers input SpatRaster. [#503] Chris Haak consistent copy--modify behavior ()<- methods. -place updating available set. methods set.names set.values. [#493] Jean Romain [#511] Bryan Fuentes much faster writing GPGK vector data using single transaction (following sf) [#460] Krzysztof Dyba aggregate<SpatRaster> now accepts functions return one value per aggregated cell writeVector new argument insert add layer existing file (e.g. GPKG).","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-5-17","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.5-17","text":"new option method=\"weights\" spatSample<SpatRaster> new mask<SpatVector,SpatVector> method select intersecting geometries new method .related values<SpatRaster> new option na.rm=TRUE. [#490] Henk Harmsen new class SpatVectorProxy provide access large vector databases read memory entirety. new argument proxy=FALSE vect create SpatVectorProxy object new method query<SpatVectorProxy> extract parts SpatVectorProxy new method vector_layers returns, can delete, vector format layers database/file GPKG","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-5-17","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.5-17","text":"avoid name clashes tidyverse arrow -> north src -> sprc simplify -> simplifyGeom consistency setCats -> set.cats","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-15-12","dir":"Changelog","previous_headings":"","what":"version 1.5-12","title":"version 1.5-12","text":"CRAN release: 2022-01-13 Released 2022-01-13","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-5-12","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.5-12","text":"setValues init failed (even crashed R) using single value largish raster. [#414] conversion sfc SpatVector lost crs. [#415] Jean-Luc Dupouey buffer SpatRaster values caused crash [#416] Sebastian Brinkmann writeVector now assumes “traditional GIS order” (long/lat) CRS specifies lat/long. [#333]( Agustin Lobo argument main ignored density using single layer SpatRaster [#424] dvictori Summary type math functions min mean, used multiple SpatRasters numbers, ignored additional SpatRasters [#426] Zhuonan Wang names now conserved creating SpatRaster RasterStack points file(s) [#430] Dan Baston classify right=FALSE ignored include.lowest=TRUE [#442] Alex Ilich patches now combines patches connect across data line [#366] Hirscht patches(directions=8) now connects NE/SW direction [#451] Jean-François Bourdon. centroids now considers cases SpatVector parts nearest crossing date line instead zero-meridian [#366] Hirscht terrain created empty (NA) rows chunks used processing large rasters. [#453] Robert Ritson. inset draw “box” correctly. [#457] Márcia Barbosa .lines now works points SpatVector [#464] Márcia Barbosa","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-5-12","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.5-12","text":"values(x)<- now accepts (hex coded) colors values focal now wraps around dateline like raster::focal [#242] Alexander Marbler aggregate now show progress bar cases [#249] Lachlan .data.frame<SpatRaster> <SpatVector> now also implemented S3 methods assure correct dispatch S3 methods data.table::.data.table. See [#284] Patrick Schratz crs now shows correct authority EPSG. [#419] Matthew Williamson now possible add SpatRaster empty SpatRaster (values), even different geometry, ignoring empty SpatRaster [#421] Alex Ilich. rast<filename> new argument lyrs subset layers open file one step. rast<array> now crs extent argument. [#439] RS-eco type=\"xyz\" now default rast<data.frame>. [#438] RS-eco classify new argument brackets show side interval open closed. support categorical data freq .data.frame. [#441] ngould7 speed processing multi-layer memory data. [#437] Krzysztof Dyba vect<matrix> vect<data.frame> now much faster. [#413] BastienFR extract points provided matrix cell numbers much faster. [#341] focal new argument na.policy can set one “” (default), “” “omit”. argument na.removed, can now use na.policy=\"\" inset argument border changed perimeter allow passing border plot<Spat*>. [#456] Márcia Barbosa compile-time run-time versions GEOS now compared warning given . [#459] Edzer Pebesma now possible add sub-datasets GPKG GTiff files. [#300] gtitov general option memfrac can now set zero (stead lower 0.1). [#476] Matt Strimas-Mackey new argument allowGaps patches disallow gaps patch IDs. See [#478] Dunbar Carpenter.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-5-12","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.5-12","text":"timestamps units now saved auxiliary file (filename.aux.json) raster formats except NetCDF using writeCDF (case stored netcdf file) new method mergeTime combine multiple rasters, perhaps partly overlapping time, single time series new method fillTime can add empty layers existing layers assure time step layers constant new method approximate fill missing values cell across layers new methods .bool .bool SpatRaster explicit recognition Boolean raster data various places (e.g., extract, plot) new methods .int .int SpatRaster. assigning integer values SpatRaster, reading integer file, corresponding layers now classified integer type [#446] L. Dalby new method layerCor (like raster::layerStats). [#420] Alex Ilich new method focalCor (like raster::corLocal). [#427] Zhuonan Wang new method .equal SpatRaster. See [#428] Dongdong Kong new method math SpatRaster implements Math-generic methods accepts filename new method sds<array> new method rasterize<matrix>, see [#413] BastienFR new method colorize transform color representations new method arrow draw (North) arrow map. [#461] Márcia Barbosa new method densify insert nodes existing nodes line polygon SpatVector new method direction SpatRaster. [#462] Márcia Barbosa new method focal3D compute focal values three-dimensional (row, column, layer) window new function makeVRT create vrt file file needs header read. new option method=\"stratified\" spatSample<SpatRaster>. [#470] Michael Mahoney new general option memmax cap amount RAM terra can used raster processing [#476] Matt Strimas-Mackey new method gridDistance compute distances traversing raster, perhaps obstacles. [#477] Márcia Barbosa","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-22","dir":"Changelog","previous_headings":"","what":"version 1.4-22","title":"version 1.4-22","text":"CRAN release: 2021-11-24 Released 2021-11-24","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"changes-1-4-22","dir":"Changelog","previous_headings":"","what":"changes","title":"version 1.4-22","text":"focal now ellipses (...) allow providing additional arguments fun. reason na.rm argument anymore can supplied via ellipses. practice means default na.rm=FALSE standard functions mean sum.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-22","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-22","text":"app grossly overestimated RAM needed, slowing . Reported Jerry Nelson terra now installs, , older versions GEOS [#406] fparyani terra install Clang CRAN/OSX due using C++13 idiom.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-22","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-22","text":"lapp tapp now cores argument (app predict). Suggested Dongdong Kong [#365] focal now also works function returns multiple values. See [#318] Alex Ilich. focal can now process multiple layers one step. expanded support conversion stars objects [#220] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-4-22","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.4-22","text":"focalCpp takes C++ function iterates cells speed computation avoiding apply (see [#318] Alex Ilich). focalReg focal OLS regression models layers","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-20","dir":"Changelog","previous_headings":"","what":"version 1.4-20","title":"version 1.4-20","text":"CRAN release: 2021-11-16 Released 2021-11-16","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-20","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-20","text":"terra install versions GDAL 3 [#402] Alex Ilich. distance two SpatVectors matrices pairwise=FALSE returned matrix filled column instead row [#403] Paul Smith","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-19","dir":"Changelog","previous_headings":"","what":"version 1.4-19","title":"version 1.4-19","text":"CRAN release: 2021-11-15 Released 2021-11-15","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-19","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-19","text":"rast NetCDF files failed bad parsing dates. [#361] Juan Carlos Zamora-Pereira distance<SpatRaster> lon/lat data correct. [#368] Greg Schmidt .polygons<SpatRaster> failed SpatRaster categorical layer first layer. [#370] Patrick Schratz filename argument rasterize ignored, also causing errors writing temporary files. [#377] Robbie Price rast<character> crashed sds empty character string. [#381] Dan Baston plot<SpatVector> now responds range argument [#385] Márcia Barbosa zonal failed user-defined functions. [#393] mqueinnec","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-4-19","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.4-19","text":"new method selectHighest select n cell values highest lowest values. new method vect<list> append SpatVectors (faster .call(rbind, x)) new argument align=FALSE project align template SpatRaster ignore resolution new method gdalCache set GDAL cache size, contributed Dan Baston [#387] new method fileBlocksize new argument options writeVector pass layer creation options GDAL new SpatVector topology methods mergeLines, snap, makeNodes, removeDupNodes, gaps, simplify new SpatVector characterization methods width clearance","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-19","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-19","text":"terra now installs older versions GEOS [#363] terra now installs CentOS 7 GDAL 2.1.4 C++ compiler support std::regexp. [#384] Ariel Paulson","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-11","dir":"Changelog","previous_headings":"","what":"version 1.4-11","title":"version 1.4-11","text":"CRAN release: 2021-10-11 Released 2021-10-11","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-11","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-11","text":"definition setValues now two arguments (x values), just like raster ; avoid reverse dependency problems raster","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-9","dir":"Changelog","previous_headings":"","what":"version 1.4-9","title":"version 1.4-9","text":"CRAN release: 2021-10-07 Released 2021-10-07","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-4-9","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.4-9","text":"avoid name conflicts sp (via raster) disaggregate now called disagg bbox,SpatRaster bbox<SpatVector> removed (resurrected raster another name).","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-9","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-9","text":"project resample now choose resampling method based first layer, using “near” categorical data. Thanks Matthew Lewis [#355]","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-9","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-9","text":"hist failed small samples. Issue [#356] Martin Queinnec","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-14-7","dir":"Changelog","previous_headings":"","what":"version 1.4-7","title":"version 1.4-7","text":"CRAN release: 2021-10-05 Released 2021-10-05","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"note-1-4-7","dir":"Changelog","previous_headings":"","what":"note","title":"version 1.4-7","text":"terra longer depends raster. avoid name clashes two packages, allow replacing methods rgeos rgdal raster, raster now depends terra instead.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-4-7","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.4-7","text":"freq new argument usenames. See issue [#309] Bappa Das rast<character> new argument opts can used pass GDAL open options. See issue [#314] rast<SpatRaster> now takes arguments names vals. See issue [#323] Dongdong Kong crs<- now warns unsupported datum used. See issue [#317] spatSample now returns factor values SpatRaster layer .factor except using .df=FALSE new method origin<- set origin SpatRaster. See issue [#326] Jakub Nowosad crs new argument parse. See [#344] plot<SpatRaster,missing> new argument reset=FALSE allows resetting par()$mar parameters plotting. See issue [#340] Derek Friend crds new argument na.rm. See [#338] Kodi Arfer show(Spat*) now prints name EPSG code crs available. See [#317] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-4-7","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.4-7","text":"plotRGB failed NAs. Issue [#308] Jakub Nowosad writeVector crashed R used SpatVector geometries. Reported Timothy White issue [#319] summary<SpatRaster> now returns counts classes (instead numerical summary indices) [#324] Jakub Nowosad tapp character index now returns SpatRaster correct names [#345] Stuart Brown rasterize character variable now adds ID column categories [#337] Tate Brasel cellSize now masks values cases (requested mask=TRUE). Issue [#339] Jean-Luc Dupouey buffer<SpatVector> longer treats lines like polygons [#332] Márcia Barbosa plot now passes layer index fun [#310] Ben Tupper to_id nearest sometimes wrong. See [#328] Shawn Ligocki better support ESRI value attribute tables (VAT). See question focal reset initial values NA cells processing chunks. [#312] Jeffrey Evans focal run memory using large window user-defined function, inexact chunk boundary [#347] zonal .raster=TRUE failed categorical SpatRasters [#348] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-13-22","dir":"Changelog","previous_headings":"","what":"version 1.3-22","title":"version 1.3-22","text":"CRAN release: 2021-08-20 Released 2021-08-20","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-3-22","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.3-22","text":"time(x) <- d set Date class object, time(x) now returns Date object instead POSIXct object. Issue [#256] Mauricio Zambrano-Bigiarini UTF-8 encoding character attributes SpatVector now declared display correctly R. See issue [#258] AGeographer. Also implemented names SpatVector SpatRaster rast<data.frame> method avoid confusion matrix list methods response question Stackbeans extreme values used represent NA intended (one two lower) INT2U INT4U. Reported Jean-Luc Dupouey stackoverflow writeCDF now also writes time dimensions one time-step. See question vect<character> (filename) now argument layer select layer multi-layer file / database, arguments query, extent filter reading subset subst can now create multiple output layers See [issue 276] Agustin Lobo classify can now create different multiple output layers See [issue 276] Agustin Lobo Argument alpha plot<SpatRaster> can now SpatRaster. See question James McCarthy","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-3-22","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.3-22","text":"filename overwrite arguments ignored rasterize gdal options now also honored create-copy drivers [#260] buffer lonlat now works better world’s “edges” [#261] scale/offset ignored project. Reported Fabian Fischer rasterize<SpatRaster,SpatVector> inverse=TRUE crashed R session. Issue [#264] Jean-Luc Dupouey output merge mosaic correct large rasters (first rows used). Reported Zavud Baghirov [#271] .points,SpatRaster remove NA’s correctly shifted values. Issues [#269] [#273] Julian Hagenauer rast<matrix> rotated values using equal-sided matrix [#274] Jakub Nowosad number rows columns reversed using project crs argument. [#283] Timothée Giraud classify, argument right TRUE FALSE reversed. terrain edge effects [#303] Andrew Gene Brown. terrain can now compute multiple variables [#286] Žan Kuralt wrap<SpatRaster> changed factors numeric [#302] Patrick Schratz writeVector failed “FlatGeobuf” (probably formats well) using proper MultiPolygon [#299] L Dalby regular sampling polygons spatSample now much regular [#289] Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-13-4","dir":"Changelog","previous_headings":"","what":"version 1.3-4","title":"version 1.3-4","text":"CRAN release: 2021-06-20 Released 2021-06-20","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-3-4","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.3-4","text":"na.omit<SpatVector> remove empty geometries /attribute records NA new method src create SpatRasterCollection (loose collection tiles). merge mosaic now methods SpatRasterCollection. avoid (inefficient) use .call. #210 Matthew Talluto. activeCat activeCat<- get set “active” category multiple categories (raster attributes) .numeric catalyze transfer categories numeric cell values summarize methods range mean (attributes ) SpatVector new method shade, compute hill shading","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-3-4","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.3-4","text":"additional arguments (na.rm) now used rasterize point geometries. #209 Jakub Nowosad improved handling (documentation) gstat models interpolate. #208 Jakub Nowosad new argument cpkgs predict list packages need exported cores argument cores larger one. ?predict now shows different approaches parallelize predict (based examples issue. #178 Matthew Coghill. freq now returns labels categorical layers adjacent now pairs argument. #239 Kenneth Blake Vernon adjacent now also takes matrix specify adjacent cells mean summarize methods now take filename argument disallow non-recognized named arguments. #238 Jessica Nephin raster attribute table ESRI-GRID integer data, ESRI vat.dbf file now ignored counts values. #234 Jullee time attributes longer lost raster operations. #246 Mauricio Zambrano-Bigiarini resample (project) longer ignore gdal=\"\" write options use BIGTIFF necessary (suggested Ani Ghosh) new argument layer extract-SpatRaster,SpatVector method extract values single layers specified geometry (see question).","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-3-4","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.3-4","text":"better handling paths non-ASCII characters (e.g., Chinese) GeoTiff still fails NetCDF. [#233] Dongdong Kong extract points cells=TRUE xy=TRUE gave garbled output .character<SpatRaster> (called wrap) capture layer names. [#213] Pascal Title focal mirrored weight matrix, thus affecting results using asymmetrical weight matrix. Reported Sebastiano Trevisani terra::terraOptions now works without attaching package. [#229] Karl Dunkle Werner app ncores > 0 function returns multiple layers now works. [#240] BastienFR. autocor (local) can now handle NA values. [#245] Jakub Nowosad . mask SpatVector large (memory) multi-layer SpatRaster worked first layer. Reported Monika Tomaszewska.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-12-10","dir":"Changelog","previous_headings":"","what":"version 1.2-10","title":"version 1.2-10","text":"CRAN release: 2021-05-13 Released 2021-05-13","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-2-10","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.2-10","text":".lines method SpatRaster .polygons method SpatVector lines autocor<numeric> new methods mean, compute local mean, locmor, local Moran’s sharedPaths method SpatVector (lines polygons) RGB2col method reduce three-layer RGB SpatRaster single layer SpatRaster color-table (<= 256 colors) split methods SpatVector SpatRaster","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"enhancements-1-2-10","dir":"Changelog","previous_headings":"","what":"enhancements","title":"version 1.2-10","text":"rast<Raster*> now takes crs Raster object, file may point . [#200] Floris Vanderhaeghe convhull new argument =\"\" make convex hulls sub-sets SpatVector. faster processing large memory rasters. See issue [#206] Krzysztof Dyba.","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-2-10","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.2-10","text":"extract multiple layers return data.frame values correct order (row instead column) crop works sf objects. [#201] Sebastian Brinkmann vect<sf> now also works lines, faster vect<character> crashed R file empty geometries. [#202] consumere extract(points, bilinear=TRUE, cells=TRUE) now works. [#203] fab4app zonal now works min max. [#207] Reported Jakub Nowosad","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-2-10","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.2-10","text":"avoid name conflicts spatstat package area,SpatRaster-method(x, sum=FALSE) -> cellSize(x) area,SpatRaster/SpatVector-method(x, sum=TRUE) -> expanse(x) convexhull -> convHull perimeter -> perim tiles -> makeTiles coords -> crds","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-12-5","dir":"Changelog","previous_headings":"","what":"version 1.2-5","title":"version 1.2-5","text":"CRAN release: 2021-04-30 Released 2021-04-30","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"new-1-2-5","dir":"Changelog","previous_headings":"","what":"new","title":"version 1.2-5","text":"trim new argument value allows trimming rows columns values default NA rapp new argument clamp allows clamping start end values 1:nlyr(x), avoiding values considered NA spatSample<SpatRaster> new arguments .points values. Getting values, cells coordinates longer mutually exclusive. response [#191] Agustin Lobo area<SpatRaster> new argument mask=FALSE classify can now take single number request many cuts mosaic merge now warn resample rasters aligned extract new argument exact get fraction covered cell","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"bug-fixes-1-2-5","dir":"Changelog","previous_headings":"","what":"bug fixes","title":"version 1.2-5","text":"flip(x, direction=\"vertical\") longer reverses order layers extract work horizontal vertical lines extent considered invalid. Reported Monika Tomaszewska autocor handle NA values [#192] Laurence Hawker nearest now works angular coordinates unit slope terrain correct (tangent returned instead slope), [#196] Sven Alder quantile now works rasters cells NA. Reported Jerry Nelson","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"name-changes-1-2-5","dir":"Changelog","previous_headings":"","what":"name changes","title":"version 1.2-5","text":"avoid name conflicts tidyverse deprecation warning: separate -> segregate expand -> extend near -> nearby pack -> wrap without deprecation warning: transpose -> trans collapse -> tighten fill -> fillHoles select -> sel","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-11-17","dir":"Changelog","previous_headings":"","what":"version 1.1-17","title":"version 1.1-17","text":"CRAN release: 2021-04-14 Released 2021-04-14","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"major-changes-1-1-17","dir":"Changelog","previous_headings":"","what":"major changes","title":"version 1.1-17","text":"c<SpatVector> now returns list. rbind used append SpatVector objects overhaul handling factors. rats removed, levels cats changed","code":""},{"path":"https://rspatial.github.io/terra/news/index.html","id":"version-11-4","dir":"Changelog","previous_headings":"","what":"version 1.1-4","title":"version 1.1-4","text":"CRAN release: 2021-03-09 news recorded earlier versions","code":""}]