dg_lpsi: Desired Gains Index (DG-LPSI)

View source: R/constrained_indices.R

dg_lpsiR Documentation

Desired Gains Index (DG-LPSI)

Description

Implements the Pesek & Baker (1969) Desired Gains Index where breeders specify target genetic gains instead of economic weights. This enhanced version includes calculation of implied economic weights and feasibility checking.

Usage

dg_lpsi(
  pmat,
  gmat,
  d,
  return_implied_weights = TRUE,
  check_feasibility = TRUE,
  selection_intensity = 2.063
)

Arguments

pmat

Phenotypic variance-covariance matrix (n_traits x n_traits)

gmat

Genotypic variance-covariance matrix (n_traits x n_traits)

d

Vector of desired genetic gains (length n_traits). Example: d = c(1.5, 0.8, -0.2) means gain +1.5 in trait 1, +0.8 in trait 2, -0.2 in trait 3.

return_implied_weights

Logical - calculate implied economic weights? (default: TRUE)

check_feasibility

Logical - warn if desired gains are unrealistic? (default: TRUE)

selection_intensity

Selection intensity i (default: 2.063)

Details

Mathematical Formulation:

1. Index coefficients: \mathbf{b} = \mathbf{G}^{-1}\mathbf{d}

2. Expected response: \Delta \mathbf{G} = (i/\sigma_I) \mathbf{G}\mathbf{b}

CRITICAL: Scale Invariance Property

The achieved gains \Delta\mathbf{G} are determined by selection intensity (i), genetic variance (G), and phenotypic variance (P), NOT by scaling \mathbf{b}. If you multiply \mathbf{b} by constant c, \sigma_I also scales by c, causing complete cancellation in \Delta\mathbf{G} = (i/(c\sigma_I))\mathbf{G}(c\mathbf{b}) = (i/\sigma_I)\mathbf{G}\mathbf{b}.

What DG-LPSI Actually Achieves:

- Proportional gains matching the RATIOS in d (not absolute magnitudes) - Achieved magnitude depends on biological/genetic constraints - Use feasibility checking to verify if desired gains are realistic

3. Implied economic weights (Section 1.4 of Chapter 4):

\hat{\mathbf{w}} = \mathbf{G}^{-1} \mathbf{P} \mathbf{b}

The implied weights represent the economic values that would have been needed in a Smith-Hazel index to achieve the desired gain PROPORTIONS. Large implied weights indicate traits that are "expensive" to improve (low heritability or unfavorable correlations), while small weights indicate traits that are "cheap" to improve.

Feasibility Checking:

The function estimates maximum possible gains as approximately 3.0 * sqrt(G_ii) (assuming very intense selection with i ~ 3.0) and warns if desired gains exceed 80% of these theoretical maxima.

Value

List with:

  • summary - Data frame with coefficients, metrics, and implied weights

  • b - Vector of selection index coefficients

  • Delta_G - Named vector of achieved genetic gains per trait

  • desired_gains - Named vector of desired gains (input d)

  • gain_errors - Difference between desired and achieved gains

  • implied_weights - Economic weights that would achieve these gains in Smith-Hazel LPSI

  • implied_weights_normalized - Normalized implied weights (max absolute = 1)

  • feasibility - Data frame with feasibility analysis per trait

  • hI2 - Index heritability

  • rHI - Index accuracy

References

Pesek, J., & Baker, R. J. (1969). Desired improvement in relation to selection indices. Canadian Journal of Plant Science, 49(6), 803-804.

Examples

# Load data
gmat <- gen_varcov(seldata[, 3:9], seldata[, 2], seldata[, 1])
pmat <- phen_varcov(seldata[, 3:9], seldata[, 2], seldata[, 1])

# Specify desired gains (e.g., increase each trait by 1 unit)
desired_gains <- rep(1, ncol(gmat))

# Calculate Desired Gains Index with all enhancements
result <- dg_lpsi(pmat, gmat, d = desired_gains)

# View summary
print(result$summary)

# Extract implied weights to understand relative "cost" of gains
print(result$implied_weights_normalized)

# Check feasibility
print(result$feasibility)

selection.index documentation built on March 9, 2026, 1:06 a.m.