rescale.im {spatstat}R Documentation

Convert Pixel Image to Another Unit of Length

Description

Converts a pixel image to another unit of length.

Usage

 ## S3 method for class 'im'
rescale(X, s)

Arguments

X

Pixel image (object of class "im").

s

Conversion factor: the new units are s times the old units.

Details

This is a method for the generic function rescale.

The spatial coordinates of the pixels in X will be re-expressed in terms of a new unit of length that is s times the current unit of length given in X. (Thus, the coordinate values are divided by s, while the unit value is multiplied by s).

The result is a pixel image representing the same data but re-expressed in a different unit.

Pixel values are unchanged.

Value

Another pixel image (of class "im"), containing the same pixel values, but with pixel coordinates expressed in the new units.

Author(s)

Adrian Baddeley Adrian.Baddeley@csiro.au http://www.maths.uwa.edu.au/~adrian/ and Rolf Turner r.turner@auckland.ac.nz

See Also

im, rescale, unitname, eval.im

Examples

# Bramble Canes data: 1 unit = 9 metres
  data(bramblecanes)
# distance transform
  Z <- distmap(bramblecanes)
# convert to metres
# first alter the pixel values
  Zm <- eval.im(9 * Z)
# now rescale the pixel coordinates
  Zm <- rescale(Zm, 1/9)

[Package spatstat version 1.25-3 Index]