Skip to content

jointVIP

Prioritize Variables with Joint Variable Importance Plot in Observational Study Design

v1.0.1 · Sep 12, 2025 · MIT + file LICENSE

Description

In the observational study design stage, matching/weighting methods are conducted. However, when many background variables are present, the decision as to which variables to prioritize for matching/weighting is not trivial. Thus, the joint treatment-outcome variable importance plots are created to guide variable selection. The joint variable importance plots enhance variable comparisons via unadjusted bias curves derived under the omitted variable bias framework. The plots translate variable importance into recommended values for tuning parameters in existing methods. Post-matching and/or weighting plots can also be used to visualize and assess the quality of the observational study design. The method motivation and derivation is presented in "Prioritizing Variables for Observational Study Design using the Joint Variable Importance Plot" by Liao et al. (2024) <doi:10.1080/00031305.2024.2303419>. See the package paper by Liao and Pimentel (2024) <doi:10.21105/joss.06093> for a beginner friendly user introduction.

Downloads

505

Last 30 days

8003rd

1.5K

Last 90 days

5.4K

Last year

Trend: +5.4% (30d vs prior 30d)

CRAN Check Status

13 OK
Show all 13 flavors
Flavor Status
r-devel-linux-x86_64-debian-clang OK
r-devel-linux-x86_64-debian-gcc OK
r-devel-linux-x86_64-fedora-clang OK
r-devel-linux-x86_64-fedora-gcc OK
r-devel-windows-x86_64 OK
r-oldrel-macos-arm64 OK
r-oldrel-macos-x86_64 OK
r-oldrel-windows-x86_64 OK
r-patched-linux-x86_64 OK
r-release-linux-x86_64 OK
r-release-macos-arm64 OK
r-release-macos-x86_64 OK
r-release-windows-x86_64 OK

Check History

OK 14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE Apr 10, 2026
ERROR 13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE Apr 9, 2026
ERROR r-devel-linux-x86_64-debian-gcc

re-building of vignette outputs

Error(s) in re-building vignettes:
  ...
--- re-building ‘additional_options.Rmd’ using rmarkdown

Quitting from additional_options.Rmd:22-79 [data_cleaning]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/rlan
...[truncated]...
.Rmd' failed with diagnostics:
there is no package called 'MatchIt'
--- failed re-building ‘jointVIP.Rmd’

SUMMARY: processing the following files failed:
  ‘additional_options.Rmd’ ‘jointVIP.Rmd’

Error: Vignette re-building failed.
Execution halted
OK 14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE Mar 10, 2026

Dependency Network

Dependencies Reverse dependencies ggrepel ggplot2 jointVIP

Version History

6 tracked
new 1.0.1 Mar 10, 2026
updated 1.0.1 ← 1.0.0 diff Sep 12, 2025
updated 1.0.0 ← 0.1.2 diff Nov 21, 2024
updated 0.1.2 ← 0.1.1 diff Mar 7, 2023
updated 0.1.1 ← 0.1.0 diff Jan 25, 2023
new 0.1.0 Dec 20, 2022