1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
\name{getValuesBlock}
\alias{getValuesBlock}
\alias{getValuesBlock,RasterLayer-method}
\alias{getValuesBlock,RasterLayerSparse-method}
\alias{getValuesBlock,RasterStack-method}
\alias{getValuesBlock,RasterBrick-method}
\title{Get a block of raster cell values}
\description{
getValuesBlock returns values for a block (rectangular area) of values of a Raster* object.
}
\usage{
\S4method{getValuesBlock}{RasterLayer}(x, row=1, nrows=1, col=1, ncols=(ncol(x)-col+1), format='', ...)
\S4method{getValuesBlock}{RasterBrick}(x, row=1, nrows=1, col=1, ncols=(ncol(x)-col+1), lyrs, ...)
\S4method{getValuesBlock}{RasterStack}(x, row=1, nrows=1, col=1, ncols=(ncol(x)-col+1), lyrs, ...)
}
\arguments{
\item{x}{Raster* object}
\item{row}{positive integer. Row number to start from, should be between 1 and nrow(x)}
\item{nrows}{positive integer. How many rows? Default is 1}
\item{col}{positive integer. Column number to start from, should be between 1 and ncol(x)}
\item{ncols}{positive integer. How many columns? Default is the number of columns left after the start column}
\item{format}{character. When \code{x} is a \code{RasterLayer}, if \code{format='matrix'} or \code{format='m'}, a matrix is returned instead of a vector. If \code{format='matrix'}, it is a nrow x ncol matrix. If \code{format='m'} it is a 1 column matrix (the benefit is that the type of output is now the same for all Raster objects)}
\item{lyrs}{integer (vector). Which layers? Default is all layers (\code{1:nlayers(x)})}
\item{...}{additional arguments (none implemented)}
}
\value{
matrix or vector (if \code{(x=RasterLayer)}, unless \code{format='matrix'})
}
\seealso{ \code{\link{getValues}} }
\examples{
r <- raster(system.file("external/test.grd", package="raster"))
b <- getValuesBlock(r, row=100, nrows=3, col=10, ncols=5)
b
b <- matrix(b, nrow=3, ncol=5, byrow=TRUE)
b
logo <- brick(system.file("external/rlogo.grd", package="raster"))
getValuesBlock(logo, row=35, nrows=3, col=50, ncols=3, lyrs=2:3)
}
\keyword{spatial}
\keyword{methods}
|
