spatstat (version 1.23-2)

pairs.im: Scatterplot Matrix for Pixel Images

Description

Produces a scatterplot matrix of the pixel values in two or more pixel images.

Usage

## S3 method for class 'im':
pairs(..., plot=TRUE)

Arguments

...

Any number of arguments, each of which is either a pixel image (object of class "im") or a named argument to be passed to pairs.default.

plot

Logical. If TRUE, the scatterplot matrix is plotted.

Value

• Invisible. A data.frame containing the corresponding pixel values for each image. The return value also belongs to the class plotpairsim which has a plot method, so that it can be re-plotted.

Details

This is a method for the generic function pairs for the class of pixel images. It produces a square array of plot panels, in which each panel shows a scatterplot of the pixel values of one image against the corresponding pixel values of another image.

At least two of the arguments ... should be pixel images (objects of class "im"). Their spatial domains must overlap, but need not have the same pixel dimensions.

First the pixel image domains are intersected, and converted to a common pixel resolution. Then the corresponding pixel values of each image are extracted. Then pairs.default is called to plot the scatterplot matrix.

Any arguments in ... which are not pixel images will be passed to pairs.default to control the plot.

See Also

pairs, pairs.default, plot.im, im, par

Examples

X <- density(rpoispp(30))
  Y <- density(rpoispp(40))
  Z <- density(rpoispp(30))
  pairs(X,Y,Z)