spatstat (version 1.23-1)

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 class 'im':
as.matrix(x, ...)
  ## S3 method for class '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.

Examples

# 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)))