# invoke.symbolmap

From spatstat v1.42-2
by Adrian Baddeley

##### Plot Data Using Graphics Symbol Map

Apply a graphics symbol map to a vector of data values and plot the resulting symbols.

##### Usage

```
invoke.symbolmap(map, values, x, y = NULL, ..., add = FALSE,
do.plot = TRUE, started = add && do.plot)
```

##### Arguments

- map
- Graphics symbol map (object of class
`"symbolmap"`

). - values
- Vector of data that can be mapped by the symbol map.
- x,y
- Coordinate vectors for the spatial locations of the symbols to be plotted.
- ...
- Additional graphics parameters.
- add
- Logical value indicating whether to add the symbols to
an existing plot (
`add=TRUE`

) or to initialise a new plot (`add=FALSE`

, the default). - do.plot
- Logical value indicating whether to actually perform the plotting.
- started
- Logical value indicating whether the plot has already been initialised.

##### Details

A symbol map is an association between data values and graphical symbols.

This command applies the symbol map `map`

to the data
`values`

and plots the resulting symbols at the locations
given by `xy.coords(x,y)`

.

##### Value

- (Invisibly) the maximum diameter of the symbols, in user coordinate units.

##### See Also

`plot.symbolmap`

to plot the graphics map itself.
`symbolmap`

to create a graphics map.

##### Examples

```
g <- symbolmap(range=c(-1,1),
shape=function(x) ifelse(x > 0, "circles", "squares"),
size=function(x) sqrt(ifelse(x > 0, x/pi, -x))/15,
bg=function(x) ifelse(x > 0, "green", "red"))
plot(square(1), main="")
a <- invoke.symbolmap(g, runif(10, -1, 1), runifpoint(10), add=TRUE)
a
```

*Documentation reproduced from package spatstat, version 1.42-2, License: GPL (>= 2)*

### Community examples

Looks like there are no examples yet.