shift.im {spatstat}R Documentation

Apply Vector Translation To Pixel Image

Description

Applies a vector shift to a pixel image

Usage

 ## S3 method for class 'im'
shift(X, vec=c(0,0), ..., origin=NULL)

Arguments

X

Pixel image (object of class "im").

vec

Vector of length 2 representing a translation.

...

Ignored

origin

Character string determining a location that will be shifted to the origin. Options are "centroid", "midpoint" and "bottomleft". Partially matched.

Details

The spatial location of each pixel in the image is translated by the vector vec. This is a method for the generic function shift.

If origin is given, then it should be one of the character strings "centroid", "midpoint" or "bottomleft". The argument vec will be ignored; instead the shift will be performed so that the specified geometric location is shifted to the origin. If origin="centroid" then the centroid of the image window will be shifted to the origin. If origin="midpoint" then the centre of the bounding rectangle of the image will be shifted to the origin. If origin="bottomleft" then the bottom left corner of the bounding rectangle of the image will be shifted to the origin.

Value

Another pixel image (of class "im") representing the result of applying the vector shift.

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

shift

Examples

 # make up an image
 X <- setcov(unit.square())
 plot(X)

 Y <- shift(X, c(10,10))
 plot(Y)
 # no discernible difference except coordinates are different

 shift(X, origin="mid")

[Package spatstat version 1.25-3 Index]