spatstat.geom (version 2.1-0)

as.matrix.im: Convert Pixel Image to Matrix or Array

Description

Converts a pixel image to a matrix or an array.

Usage

# S3 method for im
as.matrix(x, ...)
  # S3 method for im
as.array(x, ...)

Arguments

x

A pixel image (object of class "im").

See below.

Value

A matrix or array.

Details

The function as.matrix.im converts the pixel image x into a matrix containing the pixel values. It is handy when you want to extract a summary of the pixel values. See the Examples.

The function as.array.im converts the pixel image to an array. By default this is a three-dimensional array of dimension \(n\) by \(m\) by \(1\). If the extra arguments are given, they will be passed to array, and they may change the dimensions of the array.

See Also

as.matrix.owin

Examples

# NOT RUN {
   # artificial image
   Z <- setcov(square(1))

   M <- as.matrix(Z)

   median(M)
   
   # plot the cumulative distribution function of pixel values
   # plot(ecdf(as.matrix(Z)))
# }