rMIDAS is an R package for accurate and efficient multiple imputation using deep learning methods. The package provides a simplified workflow for imputing and then analyzing data:
convert()
carries out all necessary preprocessing stepstrain()
constructs and trains a MIDAS imputation modelcomplete()
generates multiple completed datasets from the trained modelcombine()
runs regression analysis across the complete data, following Rubinâs combination rulesrMIDAS is based on the Python package MIDASpy.
Efficient handling of large datarMIDAS also incorporates several features to streamline and improve the the efficiency of multiple imputation analysis:
data.table
and mltools
packagesglm
(applying Rubinâs combination rules)For more information on MIDAS, the method underlying the software, see:
Lall, Ranjit, and Thomas Robinson. 2022. âThe MIDAS Touch: Accurate and Scalable Missing-Data Imputation with Deep Learning.â Political Analysis 30, no. 2: 179-196. Published version. Accepted version.
Lall, Ranjit, and Thomas Robinson. 2023. âEfficient Multiple Imputation for Diverse Data in Python and R: MIDASpy and rMIDAS.â Journal of Statistical Software. Accepted version (in press).
InstallationrMIDAS is available on CRAN. To install the package in R, you can use the following code:
install.packages("rMIDAS")
To install the latest development version, use the following code:
# install.packages("devtools")
devtools::install_github("MIDASverse/rMIDAS")
Note that rMIDAS uses the reticulate package to interface with Python. When the package is first loaded, it will prompt the user on whether to set up a Python environment and its dependencies automatically. Users that choose to set up the environment and dependencies manually, or who use rMIDAS in headless mode can specify a Python binary using set_python_env()
(examples below). Currently, Python versions from 3.6 to 3.10 are supported. For a custom Python environment the following dependencies are also required:
Setting a custom Python install must be performed before training or imputing data occurs. To manually set up a Python environment:
library(rMIDAS)
# Decline the automatic setup
# Point to a Python binary
set_python_env(x = "path/to/python/binary")
# Or point to a virtualenv binary
set_python_env(x = "virtual_env", type = "virtualenv")
# Or point to a conda environment
set_python_env(x = "conda_env", type = "conda")
# Now run rMIDAS::train() and rMIDAS::complete()...
You can also download the rmidas-env.yml
conda environment file from this repository to set up all dependencies in a new conda environment. To do so, download the .yml file, navigate to the download directory in your console and run:
conda env create -f rmidas-env.yml
Then, prior to training a MIDAS model, make sure to load this environment in R:
# First load the rMIDAS package
library(rMIDAS)
# Decline the automatic setup
set_python_env(x = "rmidas", type = "conda")
Note: reticulate only allows you to set a Python binary once per R session, so if you wish to switch to a different Python binary, or have already run train()
or convert()
, you will need to restart or terminate R prior to using set_python_env()
.
rMIDAS is packaged with three vignettes:
vignette("imputation_demo", "rMIDAS")
demonstrates the basic workflow and capacities of rMIDASvignette("custom_python_versions", "rMIDAS")
provides detailed guidance on configuring Python binaries and environments, including some troubleshooting tipsvignette("use_server", "rMIDAS")
provides guidance for running rMIDAS in headless modeAn additional example that showcases rMIDAS core functionalities can be found here.
Contributing to rMIDASInterested in contributing to rMIDAS? We are looking to hire a research assistant to work part-time (flexibly) to help us build out new features and integrate our software with existing machine learning pipelines. You would be paid the standard research assistant rate at the University of Oxford. To apply, please send your CV (or a summary of relevant skills/experience) to ranjit.lall@sjc.ox.ac.uk.
Getting helprMIDAS is still in development, and we may not have caught all bugs. If you come across any difficulties, or have any suggestions for improvements, please raise an issue here.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4