Window: Extract or Change the Window of a Spatial Object

In spatstat: Spatial Point Pattern Analysis, Model-Fitting, Simulation, Tests

Description

Given a spatial object (such as a point pattern or pixel image) in two dimensions, these functions extract or change the window in which the object is defined.

Usage

   Window(X, ...)

   Window(X, ...) <- value

   ## S3 method for class 'ppp'
Window(X, ...)

   ## S3 replacement method for class 'ppp'
Window(X, ...) <- value

   ## S3 method for class 'psp'
Window(X, ...)

   ## S3 replacement method for class 'psp'
Window(X, ...) <- value

   ## S3 method for class 'im'
Window(X, ...)

   ## S3 replacement method for class 'im'
Window(X, ...) <- value

Arguments

X	A spatial object such as a point pattern, line segment pattern or pixel image.
...	Extra arguments. They are ignored by all the methods listed here.
value	Another window (object of class "owin") to be used as the window for X.

Details

The functions Window and Window<- are generic.

Window(X) extracts the spatial window in which X is defined.

Window(X) <- W changes the window in which X is defined to the new window W, and discards any data outside W. In particular:

• If X is a point pattern (object of class "ppp") then Window(X) <- W discards any points of X which fall outside W.

• If X is a line segment pattern (object of class "psp") then Window(X) <- W clips the segments of X to the boundaries of W.

• If X is a pixel image (object of class "im") then Window(X) <- W has the effect that pixels lying outside W are retained but their pixel values are set to NA.

Many other classes of spatial object have a method for Window, but not Window<-. See Window.ppm.

Value

The result of Window is a window (object of class "owin").

The result of Window<- is the updated object X, of the same class as X.

Author(s)

\adrian \rolf

and \ege

See Also

Window.ppm

Examples

   ## point patterns
   Window(cells)
   X <- demopat
   Window(X)
   Window(X) <- as.rectangle(Window(X))

   ## line segment patterns
   X <- psp(runif(10), runif(10), runif(10), runif(10), window=owin())
   Window(X)
   Window(X) <- square(0.5)

   ## images
   Z <- setcov(owin())
   Window(Z)
   Window(Z) <- square(0.5)

Example output

Loading required package: nlme
Loading required package: rpart

spatstat 1.52-1       (nickname: 'Apophenia') 
For an introduction to spatstat, type 'beginner' 


Note: spatstat version 1.52-1 is out of date by more than 3 months; we recommend upgrading to the latest version.
window: rectangle = [0, 1] x [0, 1] units
window: polygonal boundary
enclosing rectangle: [525, 10575] x [450, 7125] furlongs
window: rectangle = [0, 1] x [0, 1] units
window: binary image mask
257 x 257 pixel array (ny, nx)
enclosing rectangle: [-1, 1] x [-1, 1] units

spatstat documentation built on March 26, 2020, 8:04 p.m.