mbend

mbend transforms symmetric non-positive-definite (non-PD) matrices into positive-definite (PD) matrices to enable analyses that require PD covariance or correlation matrices, such as multi-trait best linear unbiased prediction (BLUP).


Key Features:

  • Unweighted bending (LRS14): Replaces negative eigenvalues with small positive values in descending order following the LRS14 approach.
  • Precision-based weighted bending (HJ03): Replaces smaller eigenvalues with a custom small positive value (ε) while weighting adjustments by element precision to relax low-precision elements and minimize changes in high-precision elements.
  • Weighted LRS14: Implements a weighted version of the LRS14 method combining weighting and the LRS14 eigenvalue replacement strategy.
  • Unweighted HJ03: Provides an unweighted variant of HJ03 for cases where precision information is unavailable.
  • DB88 (correlation-focused) method: Implements an unweighted DB88 approach that replaces eigenvalues less than ε with 100×ε, originally intended for correlation matrices and tested to perform best with lower ε values.
  • Evaluation metrics and test matrices: Computes weighted distance statistics and tests methods on a 5×5 covariance matrix (V), its correlation matrix equivalent (C), and an ill-conditioned 1000×1000 genomic relationship matrix (G).

Scientific Applications:

  • Covariance matrices: Ensures covariance matrices are positive-definite for use in multi-trait BLUP and other multivariate analyses.
  • Correlation matrices: Restores positive-definiteness to correlation matrices used in statistical inference and modeling.
  • Genomic relationship matrices: Corrects ill-conditioned genomic relationship matrices (e.g., 1000×1000 G) to enable genomic prediction and related analyses.

Methodology:

Methods include eigenvalue modification by replacing negative or small eigenvalues with a small positive value (ε) or 100×ε (DB88), application of precision-based weighting to scale eigenvalue adjustments (HJ03), a weighted variant of LRS14, and evaluation via weighted distance statistics on matrices V (5×5 covariance), C (correlation), and G (1000×1000 genomic relationship), with method variants tested at ε values such as 10^-4 and 10^-2.

Topics

Details

License:
GPL-3.0
Tool Type:
library
Added:
1/18/2021
Last Updated:
2/20/2021

Operations

Publications

Nilforooshan MA. mbend: an R package for bending non-positive-definite symmetric matrices to positive-definite. BMC Genetics. 2020;21(1). doi:10.1186/s12863-020-00881-z. PMID:32883199. PMCID:PMC7469428.