Learn R Programming

Amelia (version 1.8.1)

missmap: Missingness Map

Description

Plots a missingness map showing where missingness occurs in the dataset passed to amelia.

Usage

missmap(
  obj,
  vars,
  legend = TRUE,
  col,
  main,
  y.cex = 0.8,
  x.cex = 0.8,
  y.labels,
  y.at,
  csvar = NULL,
  tsvar = NULL,
  rank.order = TRUE,
  margins = c(5, 5),
  gap.xaxis = 1,
  x.las = 2,
  ...
)

Arguments

obj

an object of class "amelia"; typically output from the function amelia, a matrix or a dataframe.

vars

a vector of column numbers or column names of the data to include in the plot. The default is to plot all variables.

legend

should a legend be drawn? (True or False)

col

a vector of length two where the first element specifies the color for missing cells and the second element specifies

main

main title of the plot. Defaults to "Missingness Map".

y.cex

expansion for the variables names on the x-axis.

x.cex

expansion for the unit names on the y-axis.

y.labels

a vector of row labels to print on the y-axis

y.at

a vector of the same length as y.labels with row nmumbers associated with the labels.

csvar

column number or name of the variable corresponding to the unit indicator. Only used when the obj is not of class amelia.

tsvar

column number or name of the variable corresponding to the time indicator. Only used when the obj is not of class amelia.

rank.order

a logical value. If TRUE, the default, then the order of the variables along the the x-axis is sorted by the percent missing (from highest to lowest). If FALSE, it is simply the order of the variables in the data.

margins

a vector of length two that specifies the bottom and left margins of the plot. Useful for when variable names or row names are long.

gap.xaxis

value to pass to the gap.axis argument of the axis function that plots the x-axis. See axis for more details. Ignored on R versions less than 4.0.0.

x.las

value of the las argument to pass to the axis function creating the x-axis.

...

further graphical arguments.

Details

missmap draws a map of the missingness in a dataset using the image function. The columns are reordered to put the most missing variable farthest to the left. The rows are reordered to a unit-period order if the ts and cs arguments were passed to amelia. If not, the rows are not reordered.

The y.labels and y.at commands can be used to associate labels with rows in the data to identify them in the plot. The y-axis is internally inverted so that the first row of the data is associated with the top-most row of the missingness map. The values of y.at should refer to the rows of the data, not to any point on the plotting region.

See Also

compare.density, overimpute, tscsPlot, image, heatmap