Colored map in which the proportion or amount of missing/imputed values in
each region is coded according to a continuous or discrete color scheme.
The sequential color palette may thereby be computed in the *HCL* or
the *RGB* color space.

```
colormapMiss(
x,
region,
map,
imp_index = NULL,
prop = TRUE,
polysRegion = 1:length(x),
range = NULL,
n = NULL,
col = c("red", "orange"),
gamma = 2.2,
fixup = TRUE,
coords = NULL,
numbers = TRUE,
digits = 2,
cex.numbers = 0.8,
col.numbers = par("fg"),
legend = TRUE,
interactive = TRUE,
...
)
colormapMissLegend(
xleft,
ybottom,
xright,
ytop,
cmap,
n = 1000,
horizontal = TRUE,
digits = 2,
cex.numbers = 0.8,
col.numbers = par("fg"),
...
)
```

- x
a numeric vector.

- region
a vector or factor of the same length as

`x`

giving the regions.- map
an object of any class that contains polygons and provides its own plot method (e.g.,

`"SpatialPolygons"`

from package`sp`

).- imp_index
a logical-vector indicating which values of ‘x’ have been imputed. If given, it is used for highlighting and the colors are adjusted according to the given colors for imputed variables (see

`col`

).- prop
a logical indicating whether the proportion of missing/imputed values should be used rather than the total amount.

- polysRegion
a numeric vector specifying the region that each polygon belongs to.

- range
a numeric vector of length two specifying the range (minimum and maximum) of the proportion or amount of missing/imputed values to be used for the color scheme.

- n
for

`colormapMiss`

, the number of equally spaced cut-off points for a discretized color scheme. If this is not a positive integer, a continuous color scheme is used (the default). In the latter case, the number of rectangles to be drawn in the legend can be specified in`colormapMissLegend`

. A reasonably large number makes it appear continuously.- col
the color range (start end end) to be used. RGB colors may be specified as character strings or as objects of class "

`colorspace::RGB()`

". HCL colors need to be specified as objects of class "`colorspace::polarLUV()`

". If only one color is supplied, it is used as end color, while the start color is taken to be transparent for RGB or white for HCL.- gamma
numeric; the display

*gamma*value (see`colorspace::hex()`

).- fixup
a logical indicating whether the colors should be corrected to valid RGB values (see

`colorspace::hex()`

).- coords
a matrix or

`data.frame`

with two columns giving the coordinates for the labels.- numbers
a logical indicating whether the corresponding proportions or numbers of missing/imputed values should be used as labels for the regions.

- digits
the number of digits to be used in the labels (in case of proportions).

- cex.numbers
the character expansion factor to be used for the labels.

- col.numbers
the color to be used for the labels.

- legend
a logical indicating whether a legend should be plotted.

- interactive
a logical indicating whether more detailed information about missing/imputed values should be displayed interactively (see ‘Details’).

- ...
further arguments to be passed to

`plot`

.- xleft
left

*x*position of the legend.- ybottom
bottom

*y*position of the legend.- xright
right

*x*position of the legend.- ytop
top

*y*position of the legend.- cmap
a list as returned by

`colormapMiss`

that contains the required information for the legend.- horizontal
a logical indicating whether the legend should be drawn horizontally or vertically.

`colormapMiss`

returns a list with the following components:

nmiss a numeric vector containing the number of missing/imputed values in each region.

nobs a numeric vector containing the number of observations in each region.

pmiss a numeric vector containing the proportion of missing values in each region.

prop a logical indicating whether the proportion of missing/imputed values have been used rather than the total amount.

range the range of the proportion or amount of missing/imputed values corresponding to the color range.

n either a positive integer giving the number of equally spaced cut-off points for a discretized color scheme, or

`NULL`

for a continuous color scheme.start the start color of the color scheme.

end the end color of the color scheme.

space a character string giving the color space (either

`"rgb"`

for RGB colors or`"hcl"`

for HCL colors).gamma numeric; the display

*gamma*value (see`colorspace::hex()`

).fixup a logical indicating whether the colors have been corrected to valid RGB values (see

`colorspace::hex()`

).

The proportion or amount of missing/imputed values in `x`

of each
region is coded according to a continuous or discrete color scheme in the
color range defined by `col`

. In addition, the proportions or numbers
can be shown as labels in the regions.

If `interactive`

is `TRUE`

, clicking in a region displays more
detailed information about missing/imputed values on the console. Clicking
outside the borders quits the interactive session.

Some of the argument names and positions have changed with versions
1.3 and 1.4 due to extended functionality and for more consistency with
other plot functions in `VIM`

. For back compatibility, the arguments
`cex.text`

and `col.text`

can still be supplied to `...{}`

and are handled correctly. Nevertheless, they are deprecated and no longer
documented. Use `cex.numbers`

and `col.numbers`

instead.

M. Templ, A. Alfons, P. Filzmoser (2012) Exploring incomplete
data using visualization tools. *Journal of Advances in Data Analysis
and Classification*, Online first. DOI: 10.1007/s11634-011-0102-y.