Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

sampleRegular

Regular sample

Description

Take a systematic sample from a Raster* object.

Usage

## S4 method for signature 'Raster'
sampleRegular(x, size, ext=NULL, cells=FALSE, xy=FALSE, asRaster=FALSE, 
            sp=FALSE, useGDAL=FALSE, ...)

Arguments

x

Raster object
size

positive integer giving the number of items to choose.
ext

Extent. To limit regular sampling to the area within that box
cells

logical. Also return sampled cell numbers (if asRaster=FALSE)

xy

logical. If TRUE, coordinates of sampled cells are also returned
asRaster

logical. If TRUE, a RasterLayer or RasterBrick is returned, rather than the sampled values
sp

logical. If TRUE, a SpatialPointsDataFrame is returned
useGDAL

logical. If TRUE, GDAL is used to sample in some cases. This is quicker, but can result in values for a different set of cells than when useGDAL=FALSE. Only for rasters that are accessed via rgdal, and are not rotated. When TRUE arguments cells, xy, and sp are ignored (i.e., FALSE

...

additional arguments. None implemented

Value

A vector (single layer object), matrix (multi-layered object; or if cells=TRUE, or xy=TRUE), Raster* object (if asRaster=TRUE), or SpatialPointsDataFrame (if sp=TRUE)

See Also

Examples

r <- raster(system.file("external/test.grd", package="raster"))
 v <- sampleRegular(r, size=100)
 x <- sampleRegular(r, size=100, asRaster=TRUE)
raster

Geographic Data Analysis and Modeling

v3.4-10
GPL (>= 3)
Authors
Robert J. Hijmans [cre, aut] (<https://orcid.org/0000-0001-5872-2872>), Jacob van Etten [ctb], Michael Sumner [ctb], Joe Cheng [ctb], Dan Baston [ctb], Andrew Bevan [ctb], Roger Bivand [ctb], Lorenzo Busetto [ctb], Mort Canty [ctb], Ben Fasoli [ctb], David Forrest [ctb], Aniruddha Ghosh [ctb], Duncan Golicher [ctb], Josh Gray [ctb], Jonathan A. Greenberg [ctb], Paul Hiemstra [ctb], Kassel Hingee [ctb], Institute for Mathematics Applied Geosciences [cph], Charles Karney [ctb], Matteo Mattiuzzi [ctb], Steven Mosher [ctb], Babak Naimi [ctb], Jakub Nowosad [ctb], Edzer Pebesma [ctb], Oscar Perpinan Lamigueiro [ctb], Etienne B. Racine [ctb], Barry Rowlingson [ctb], Ashton Shortridge [ctb], Bill Venables [ctb], Rafael Wueest [ctb]
Initial release
2021-05-02

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.