as.matrix.im {spatstat.geom}

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.

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.

Value

A matrix or array.

Author(s)

Adrian Baddeley [e-mail]

and Rolf Turner [e-mail]

See Also

as.matrix.owin

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