cut.im
From spatstat v1.23-2
by Adrian Baddeley
Convert Pixel Image from Numeric to Factor
Transform the values of a pixel image from numeric values into a factor.
Usage
## S3 method for class 'im':
cut(x, \dots)
Arguments
- x
- A pixel image.
An object of class
"im"
. - ...
- Arguments passed to
cut.default
. They determine the breakpoints for the mapping from numerical values to factor values. Seecut.default
.
Details
This simple function applies the generic cut
operation
to the pixel values of the image x
. The range of pixel values
is divided into several intervals, and each
interval is associated with a level of a factor.
The result is another pixel image,
with the same window and pixel grid as
x
, but with the numeric value of each pixel discretised
by replacing it by the factor level.
This function is a convenient way to inspect an image and to obtain summary statistics. See the examples.
To select a subset of an image, use the subset operator
[.im
instead.
Value
- A pixel image (object of class
"im"
) with pixel values that are a factor. Seeim.object
.
See Also
Examples
# artificial image data
Z <- setcov(square(1))
Y <- cut(Z, 3)
Y <- cut(Z, breaks=seq(0,1,length=5))
# cut at the quartiles
# (divides the image into 4 equal areas)
Y <- cut(Z, quantile(Z))
Community examples
Looks like there are no examples yet.