# smoothScatter

##### Scatterplots with Smoothed Densities Color Representation

`smoothScatter`

produces a smoothed color density
representation of a scatterplot, obtained through a (2D) kernel
density estimate.

- Keywords
- hplot

##### Usage

```
smoothScatter(x, y = NULL, nbin = 128, bandwidth,
colramp = colorRampPalette(c("white", blues9)),
nrpoints = 100, ret.selection = FALSE,
pch = ".", cex = 1, col = "black",
transformation = function(x) x^.25,
postPlotHook = box,
xlab = NULL, ylab = NULL, xlim, ylim,
xaxs = par("xaxs"), yaxs = par("yaxs"), ...)
```

##### Arguments

- x, y
the

`x`

and`y`

arguments provide the x and y coordinates for the plot. Any reasonable way of defining the coordinates is acceptable. See the function`xy.coords`

for details. If supplied separately, they must be of the same length.- nbin
numeric vector of length one (for both directions) or two (for x and y separately) specifying the number of equally spaced grid points for the density estimation; directly used as

`gridsize`

in`bkde2D()`

.- bandwidth
numeric vector (length 1 or 2) of smoothing bandwidth(s). If missing, a more or less useful default is used.

`bandwidth`

is subsequently passed to function`bkde2D`

.- colramp
function accepting an integer

`n`

as an argument and returning`n`

colors.- nrpoints
number of points to be superimposed on the density image. The first

`nrpoints`

points from those areas of lowest regional densities will be plotted. Adding points to the plot allows for the identification of outliers. If all points are to be plotted, choose`nrpoints = Inf`

.- ret.selection
`logical`

indicating to return the ordered indices of “low density” points if`nrpoints > 0`

.- pch, cex, col
arguments passed to

`points`

, when`nrpoints > 0`

: point symbol, character expansion factor and color, see also`par`

.- transformation
function mapping the density scale to the color scale.

- postPlotHook
either

`NULL`

or a function which will be called (with no arguments) after`image`

.- xlab, ylab
character strings to be used as axis labels, passed to

`image`

.- xlim, ylim
numeric vectors of length 2 specifying axis limits.

- xaxs, yaxs, …
further arguments passed to

`image`

, e.g.,`add=TRUE`

or`useRaster=TRUE`

.

##### Details

`smoothScatter`

produces a smoothed version of a scatter plot.
Two dimensional (kernel density) smoothing is performed by
`bkde2D`

from package KernSmooth.
See the examples for how to use this function together with
`pairs`

.

##### Value

If `ret.selection`

is true, a vector of integers of length
`nrpoints`

(or smaller, if there are less finite points inside
`xlim`

and `ylim`

) with the indices of the low-density
points drawn, ordered with lowest density first.

##### See Also

`bkde2D`

from package KernSmooth;
`densCols`

which uses the same smoothing computations and
`blues9`

in package grDevices.

`scatter.smooth`

adds a `loess`

regression smoother to a scatter plot.

*Documentation reproduced from package graphics, version 3.4.0, License: Part of R 3.4.0*