spatstat.geom: textureplot – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

textureplot

Plot Image or Tessellation Using Texture Fill

Description

For a factor-valued pixel image, this command plots each level of the factor using a different texture. For a tessellation, each tile is plotted using a different texture.

Usage

textureplot(x, ...,
            main, add=FALSE, clipwin=NULL, do.plot = TRUE,
            border=NULL, col = NULL, lwd = NULL, lty = NULL, spacing = NULL,
            textures=1:8,
            legend=TRUE,
            leg.side=c("right", "left", "bottom", "top"),
            legsep=0.1, legwid=0.2)

Arguments

`x`	A tessellation (object of class `"tess"` or something acceptable to `as.tess`) with at most 8 tiles, or a pixel image (object of class `"im"` or something acceptable to `as.im`) whose pixel values are a `factor` with at most 8 levels.
`...`	Other arguments passed to `add.texture`.
`main`	Character string giving a main title for the plot.
`add`	Logical value indicating whether to draw on the current plot (`add=TRUE`) or to initialise a new plot (`add=FALSE`).
`clipwin`	Optional. A window (object of class `"owin"`). Only this subset of the image will be displayed.
`do.plot`	Logical. Whether to actually do the plot.
`border`	Colour for drawing the boundaries between the different regions. The default (`border=NULL`) means to use `par("fg")`. Use `border=NA` to omit borders.
`col`	Numeric value or vector giving the colour or colours in which the textures should be plotted.
`lwd`	Numeric value or vector giving the line width or widths to be used.
`lty`	Numeric value or vector giving the line type or types to be used.
`spacing`	Numeric value or vector giving the `spacing` parameter for the textures.
`textures`	Textures to be used for each level. Either a texture map (object of class `"texturemap"`) or a vector of integer codes (to be interpreted by `add.texture`).
`legend`	Logical. Whether to display an explanatory legend.
`leg.side`	Position of legend relative to main plot.
`legsep`	Separation between legend and main plot, as a fraction of the shortest side length of the main plot.
`legwid`	Width (if vertical) or height (if horizontal) of the legend as a fraction of the shortest side length of the main plot.

Details

If x is a tessellation, then each tile of the tessellation is plotted and filled with a texture using add.texture.

If x is a factor-valued pixel image, then for each level of the factor, the algorithm finds the region where the image takes this value, and fills the region with a texture using add.texture.

Value

(Invisible) A texture map (object of class "texturemap") associating a texture with each level of the factor.

Author(s)

Adrian Baddeley Adrian.Baddeley@curtin.edu.au, Rolf Turner r.turner@auckland.ac.nz and Ege Rubak rubak@math.aau.dk.

Examples

nd <- if(interactive()) 128 else 32
  Z <- setcov(owin(), dimyx=nd)
  Zcut <- cut(Z, 3, labels=c("Lo", "Med", "Hi"))
  textureplot(Zcut)
  textureplot(dirichlet(runifrect(6)))

spatstat.geom

Geometrical Functionality of the 'spatstat' Family

v2.1-0

GPL (>= 2)

Authors

Adrian Baddeley [aut, cre], Rolf Turner [aut], Ege Rubak [aut], Tilman Davies [ctb], Ute Hahn [ctb], Abdollah Jalilian [ctb], Sebastian Meyer [ctb], Suman Rakshit [ctb], Dominic Schuhmacher [ctb], Rasmus Waagepetersen [ctb]

Initial release

2021-04-15