HotDeckImputation (version 0.1.0)

impute.NN_HD: The Nearest Neighbor Hot Deck Algorithms

Description

A comprehensive function that performs nearest neighbor hot deck imputation. Aspects such as variable weighting, distance types, and donor limiting are implemented. New concepts such as the optimal distribution of donors are also available.

Usage

impute.NN_HD(data = NULL, distance = "man", weights = "range", attributes = "sim",
 comp = "rw_dist", donor_limit = Inf, optimal_donor = "no",
 list_donors_recipients = NULL)

Arguments

data

Data containing missing values.

distance

Distance type to use when searching for the nearest neighbor. See the details section for options.

weights

Weights by which the variables should be scaled. See the details section for options.

attributes

Determines how attributes should be handled. Currently only "sim", meaning donor and recipient pools are disjoint, is implemented.

comp

Defines the compensation of missing values for distance calculation. See the details section for options.

donor_limit

Limits how often a donor may function as such. See the details section for options.

optimal_donor

Defines how the optimal donor is found when a donor limit is used. See the details section for options.

list_donors_recipients

Option for manually specifying the donor and recipient pools via a list with components "donors" and "recipients".

Value

• An imputed data matrix the same size as the input data.

Details

argument: distance can be defined as:

• numeric matrix, donors x recipients distance matrix
• numeric length = 1, Minkovski parameter
• string length = 1, distance metric to be used:
  • "man", Manhattan distance
  • "eukl", Euclidean distance
  • "tscheb", Chebyshev distance (not implemented)
  • "mahal", Mahalanobis distance (not implemented)

argument: weights can be defined as:

• string length = 1, reweighting type "range", "sd", "var", or "none"
• numeric length = 1, one numeric weight for all variables
• string vector, like option 1, only different type for each variable (not implemented)
• numeric vector, like option 2, only different numeric weight for each variable
• list, mixture of options 3 and 4 (not implemented)

argument: comp can be defined as:

• "rw_dist", total distance is reweighted by number of distances that may be computed
• "mean", mean imputation is performed before distance calculation
• "rseq", random hot deck imputation, each variable sequentially (not implemented)
• "rsim", random hot deck imputation, each variable simultaneously (not implemented)

argument: donor_limit is a single number interpreted by its range:

• (0,1), dynamic donor limit, i.e., .5 means any 1 donor may serve up to 50\% of all recipients, rounded up if fractional
• [1,Inf), static donor limit, i.e., 2 means any 1 donor may serve up to 2 recipients, fractional parts discarded
• Inf, no donor limit

argument: optimal_donor is a single string interpreted by its value:

• "no", donor-recipient matching is performed in order by which the recipients appear in the data
• "rand", donor-recipient matching is performed in a random recipient-order
• "mmin", donor-recipient matching is performed by the matrix minimum method (sequence independent)
• "modifvam", donor-recipient matching is performed by a modified (only columns considered) Vogel's approximation method (sequence independent)
• "vam", donor-recipient matching is performed by the Vogel's approximation method (sequence independent)
• "modi", donor-recipient matching is performed modified distribution method (sequence independent, not implemented)

References

Andridge, R.R. and Little, R.J.A. (2010) A Review of Hot Deck Imputation for Survey Non-response. International Statistical Review. 78, 40--64. Bankhofer, U. and Joenssen, D.W. (2013) On limiting donor usage for imputation of missing data via hot deck methods. In: M. Spiliopoulou, L. Schmidt-Thieme, and R. Jannings (Eds.): Data Analysis, Machine Learning and Knowledge Discovery. Studies in Classification, Data Analysis and Knowledge Organization, 3--10. Berlin/Heidelberg: Springer. (forthcoming) Domschke, W. (1995) Logistik: Transport. Munich: Oldenbourg. [in German] Ford, B. (1983) An Overview of Hot Deck Procedures. In: W. Madow, H. Nisselson and I. Olkin (Eds.): Incomplete Data in Sample Surveys. New York: Academic Press, 185--207. Kalton, G. and Kasprzyk, D. (1986) The Treatment of Missing Survey Data. Survey Methodology. 12, 1--16. Sande, I. (1983) Hot-Deck Imputation Procedures. In: W. Madow, H. Nisselson and I. Olkin (Eds.): Incomplete Data in Sample Surveys. New York: Academic Press, 339--349.

See Also

impute.mean, match.d_r_vam, reweight.data

Examples

#Set the random seed to an arbitrary number
set.seed(421)

#Generate random integer matrix size 10x4
Y<-matrix(sample(x=1:100,size=10*4),nrow=10)

#remove 5 values, ensuring one complete covariate and 5 donors
Y[-c(1:5),-1][sample(1:15,size=5)]<-NA

#Impute using various different (arbitrarily chosen) settings
impute.NN_HD(data=Y,distance="man",weights="var")

impute.NN_HD(data=Y,distance=2,weights=rep(.5,4),donor_limit=2,optimal_donor="mmin")

impute.NN_HD(data=Y,distance="eukl",weights=.25,comp="mean",donor_limit=.2,
 optimal_donor="vam")