README.md
In miceFast: Fast Imputations Using 'Rcpp' and 'Armadillo'

miceFast

Maciej Nasinski

Check the miceFast website for more details

Fast imputations under the object-oriented programming paradigm. Moreover there are offered a few functions built to work with popular R packages such as 'data.table' or 'dplyr'. The biggest improvement in time performance could be achieve for a calculation where a grouping variable have to be used. A single evaluation of a quantitative model for the multiple imputations is another major enhancement. A new major improvement is one of the fastest predictive mean matching in the R world because of presorting and binary search.

Performance benchmarks (check performance_validity.R file at extdata).

Advanced Usage - Vignette

install.packages('miceFast')

# install.packages("devtools")
devtools::install_github("polkas/miceFast")

Recommended to download boosted BLAS library, even x100 faster:

Windows Users recommended to download MRO MKL: https://mran.microsoft.com/download
Linux users recommended to download Optimized BLAS (linear algebra) library: sudo apt-get install libopenblas-dev
Apple vecLib BLAS:

cd /Library/Frameworks/R.framework/Resources/lib
ln -sf /System/Library/Frameworks/Accelerate.framework/Frameworks/vecLib.framework/Versions/Current/libBLAS.dylib libRblas.dylib

library(miceFast)

set.seed(1234)
data(air_miss)

# plot NA structure
upset_NA(air_miss, 6)

naive_fill_NA(air_miss)

# Check out the vignette for an advance usage
# There is required a thorough examination

# Other packages - popular simple solutions
# Hmisc
data.frame(Map(function(x) Hmisc::impute(x, 'random'), air_miss))

#mice
mice::complete(mice::mice(air_miss, printFlag = FALSE))

Quick Reference Table

| Function | Description | |----------------------|----------------------| | new(miceFast) | OOP instance with bunch of methods - check out vignette | | fill_NA() | imputation - lda,lm_pred,lm_bayes,lm_noise | | fill_NA_N() | multiple imputation - pmm,lm_bayes,lm_noise | | VIF() | Variance inflation factor | | naive_fill_NA() | auto imputations | | compare_imp() | comparing imputations | | upset_NA() | visualize NA structure - UpSetR::upset|

Summing up, miceFast offer a relevant reduction of a calculations time for:

Linear Discriminant Analysis around (x5)
where a grouping variable have to be used (around x10 depending on data dimensions and number of groups and even more than x100 although compared to data.table only a few k faster or even the same) because of pre-sorting by grouping variable
multiple imputations is faster around x(a number of multiple imputations) because the core of a model is evaluated only ones.
Variance inflation factors (VIF) (x5) because the unnecessary linear regression is not evaluated - we need only inverse of X'X
Predictive mean matching (PMM) (x3) because of pre-sorting and binary search (mice algorithm was improved too).