R: Plot a Texture Map

plot.texturemap {spatstat} | R Documentation

## Plot a Texture Map

### Description

Plot a representation of a texture map, similar to a plot legend.

### Usage

     ## S3 method for class 'texturemap'
    plot(x, ..., main, xlim = NULL, ylim = NULL,
                               vertical = FALSE, axis = TRUE,
                               labelmap = NULL, gap = 0.25,
                               spacing = NULL, add = FALSE)

### Arguments

`x` | Texture map object (class `"texturemap"`).
`...` | Additional graphics arguments passed to `add.texture` or `axis.default`.
`main` | Main title for plot.
`xlim,ylim` | Optional vectors of length 2 giving the x and y limits of the plot.
`vertical` | Logical value indicating whether to arrange the texture boxes in a vertical column (`vertical=TRUE` or a horizontal row (`vertical=FALSE`, the default).
`axis` | Logical value indicating whether to plot an axis line joining the texture boxes.
`labelmap` | Optional. A `function` which will be applied to the data values (the inputs of the texture map) before they are displayed on the plot.
`gap` | Separation between texture boxes, as a fraction of the width or height of a box.
`spacing` | Argument passed to `add.texture` controlling the density of lines in a texture. Expressed in spatial coordinate units.
`add` | Logical value indicating whether to add the graphics to an existing plot (`add=TRUE`) or to initialise a new plot (`add=FALSE`, the default).

### Details

A texture map is an association between data values and graphical textures. An object of class `"texturemap"` represents a texture map. Such objects are returned from the plotting function `textureplot`, and can be created directly by the function `texturemap`.

This function `plot.texturemap` is a method for the generic `plot` for the class `"texturemap"`. It displays a sample of each of the textures in the texture map, in a separate box, annotated by the data value which is mapped to that texture.

The arrangement and position of the boxes is controlled by the arguments `vertical`, `xlim`, `ylim` and `gap`.

### Value

Null.

### Author(s)

Adrian Baddeley Adrian.Baddeley@curtin.edu.au

Rolf Turner r.turner@auckland.ac.nz

and Ege Rubak rubak@math.aau.dk

### See Also

`texturemap`, `textureplot`, `add.texture`.

### Examples

       tm <- texturemap(c("First", "Second", "Third"), 2:4, col=2:4)
       plot(tm, vertical=FALSE)
       ## abbreviate the labels
       plot(tm, labelmap=function(x) substr(x, 1, 2))

[Package spatstat version 1.54-0 Index]