View source: R/constrained_indices.R
| dg_lpsi | R Documentation |
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.
dg_lpsi(
pmat,
gmat,
d,
return_implied_weights = TRUE,
check_feasibility = TRUE,
selection_intensity = 2.063
)
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) |
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.
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
Pesek, J., & Baker, R. J. (1969). Desired improvement in relation to selection indices. Canadian Journal of Plant Science, 49(6), 803-804.
# 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)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.