Learn R Programming
VIM (version 3.0.2)

colormapMiss: Colored map with information about missing/imputed values

Description

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.

Usage

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"), ...)

Arguments

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
col
the color range (start end end) to be used. RGB colors may be specified as character strings or as objects of class "RGB". HCL colors need to be specified as objects of class "<
gamma
numeric; the display gamma value (see hex).
fixup
a logical indicating whether the colors should be corrected to valid RGB values (see 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).
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.
...
further arguments to be passed to plot.

Value

  • colormapMiss returns a list with the following components:
  • nmissa numeric vector containing the number of missing/imputed values in each region.
  • nobsa numeric vector containing the number of observations in each region.
  • pmissa numeric vector containing the proportion of missing values in each region.
  • propa logical indicating whether the proportion of missing/imputed values have been used rather than the total amount.
  • rangethe range of the proportion or amount of missing/imputed values corresponding to the color range.
  • neither a positive integer giving the number of equally spaced cut-off points for a discretized color scheme, or NULL for a continuous color scheme.
  • startthe start color of the color scheme.
  • endthe end color of the color scheme.
  • spacea character string giving the color space (either "rgb" for RGB colors or "hcl" for HCL colors).
  • gammanumeric; the display gamma value (see hex).
  • fixupa logical indicating whether the colors have been corrected to valid RGB values (see hex).

Details

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 Rconsole. Clicking outside the borders quits the interactive session.

References

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.

See Also

colSequence, growdotMiss, mapMiss