corr_rm: Filter Data Frame by Correlation Values
In meantrix/corrP: Compute Correlations Type Analysis in Parallel

View source: R/corr_rm.R

corr_rm

R Documentation

Filter Data Frame by Correlation Values

Description

Remove highly correlated variables from a data frame to reduce pair-wise redundancy and mitigate multicollinearity issues in predictive models. This preprocessing step is especially useful when the goal is prediction rather than interpretation, because hypotheses about each individual predictor are not the primary concern.

For example, in a genomic prediction study the authors removed highly correlated SNPs to avoid redundant information when working with thousands of markers, improving training efficiency and predictive performance (Wimmer et al. 2021).

In the paper "A Proposed Data Analytics Workflow and Example Using the R Caret Package", this filtering step is applied before model training, demonstrating how the core function caret::findCorrelation can be used to identify and remove highly correlated variable pairs.

Note that while high correlation can bias algorithms like clustering algorithms toward redundant variables, it is much less problematic for tree-based learners.

Usage

corr_rm(df, c, ...)

## S3 method for class 'clist'
corr_rm(
  df,
  c,
  col = c("infer.value", "stat.value"),
  isig = TRUE,
  cutoff = 0.75,
  ...
)

## S3 method for class 'list'
corr_rm(
  df,
  c,
  col = c("infer.value", "stat.value"),
  isig = TRUE,
  cutoff = 0.75,
  ...
)

## S3 method for class 'cmatrix'
corr_rm(df, c, cutoff = 0.75, ...)

## S3 method for class 'matrix'
corr_rm(df, c, cutoff = 0.75, ...)

Arguments

`df`	[`data.frame(1)`] The input data frame whose columns will be evaluated and filtered.
`c`	[`clist(1)` \| `cmatrix`] A correlation list (class `clist`) produced by `corrp`, or a correlation matrix (class `cmatrix`) from `corr_matrix`.
`...`	Additional arguments passed to the `corr_rm` methods.
`col`	[`character(1)`] Name of the column in the correlation output to use (e.g., `"infer.value"`).
`isig`	[`logical(1)`] If `TRUE`, non-significant correlations are set to `NA` in the matrix (or `FALSE` in a `clist`); otherwise all values are retained.
`cutoff`	[`numeric(1)`] Absolute correlation threshold above which one of a pair of variables will be dropped. Defaults to `0.75`.

Value

data.frame
A filtered version of df with highly correlated variables removed.

Author(s)

Igor D.S. Siciliani, Paulo H. dos Santos

References

Wimmer, V.; Albrecht, T.; Auinger, H.-J.; Schön, C.-C. (2021). Genomic prediction studies in plants and animals: Removing highly correlated SNPs to reduce redundancy. PLoS Genetics, 17(3), e1009243. URL: https://doi.org/10.3389/fgene.2021.611506

Jones, S.; Ye, Z.; Xie, Z.; Root, C.; Prasutchai, T.; Anderson, J.; Roggenburg, M.; Lanham, M. A. (2018). A Proposed Data Analytics Workflow and Example Using the R Caret Package. Midwest Decision Sciences Institute (MWDSI) Conference. URL: https://www.matthewalanham.com/Students/2018_MWDSI_R%20caret%20paper.pdf

Examples

iris_clist <- corrp(iris)
iris_cmatrix <- corr_matrix(iris_clist)
corr_rm(df = iris, c = iris_clist, cutoff = 0.75, col = "infer.value", isig = FALSE)
corr_rm(df = iris, c = iris_cmatrix, cutoff = 0.75, col = "infer.value", isig = FALSE)

meantrix/corrP documentation built on June 12, 2025, 5:33 p.m.