Skip to contents

bys_interpret() turns a result of bayes_ammi(), bayes_ammi_biplot() or bys_ls_ammi() into a plain-language interpretation: whether the chains have converged, which genotypes and environments differ from the average (main effects whose HPD interval excludes zero), how strong the bilinear terms are, which genotypes and environments interact significantly and in which direction, which are stable, and what to check before acting on the results. Every statement is computed from the numbers of the result.

Usage

bys_interpret(x, higher_better = TRUE, top = 5L, ...)

# Default S3 method
bys_interpret(x, higher_better = TRUE, top = 5L, ...)

# S3 method for class 'bys_interpretation'
print(x, ...)

# S3 method for class 'bys_interpretation'
format(x, style = c("text", "markdown"), width = getOption("width", 80L), ...)

Arguments

x

a result of bayes_ammi(), bayes_ammi_biplot() or bys_ls_ammi().

higher_better

TRUE (default) when larger values of the trait are better.

top

number of genotypes or environments named in lists (default 5).

...

unused.

style

"text" (default) or "markdown".

width

line width of the text (default getOption("width")).

Value

An object of class "bys_interpretation": a list with analysis, title, headline, findings, recommendations and cautions (sentences), facts (the numbers and lists behind the sentences), guide (how the method is read) and sources (the full references of the method; bys_cite() gives them as BibTeX). print() shows the text; format(x, style = "markdown") returns it as Markdown.

Details

The rules:

  • convergence: potential scale reduction factor below 1.1 (two or more chains), effective sample size of at least 400, Raftery-Lewis dependence factor below 5 and the Heidelberger-Welch tests passed (Crossa et al. 2011);

  • main effects: a genotype or environment differs from the average when the HPD interval of its effect excludes zero;

  • bilinear terms: a term whose HPD interval of \(\lambda_k\) reaches down to near zero (lower limit below a tenth of the posterior mean) is weakly supported;

  • interaction: a genotype (environment) interacts significantly on the first term when the HPD interval of its first score excludes zero; genotypes and environments with significant scores of the same sign interact positively (the genotype does better there than its main effect predicts), of opposite sign negatively;

  • stability (bayes_ammi_biplot()): a genotype is stable when its HPD region contains the origin.

References

Crossa, J., Perez-Elizalde, S., Jarquin, D., Cotes, J. M., Viele, K., Liu, G. and Cornelius, P. L. (2011). Bayesian estimation of the additive main effects and multiplicative interaction model. Crop Science, 51(4), 1458–1469. doi:10.2135/cropsci2010.06.0343

Author

Muhammad Yaseen (myaseen208@gmail.com)

Examples

data(cultivo2009)
fm1 <-
  bayes_ammi(
      .data       = cultivo2009
    , .y          = y
    , .gen        = entry
    , .env        = site
    , .rep        = rep
    , .nIter      = 500
    , .prior_data = NULL
    , .n0         = NULL
    , .model      = c("AMMI", "GGE")
    , .k          = 2
    , .burnin     = 100
    , .thin       = 1
    , .chains     = 2
    , .priors     = bys_priors(
          mu_mean     = 0
        , mu_var      = 1e+8
        , tau_mean    = 0
        , tau_var     = 1e+8
        , delta_mean  = 0
        , delta_var   = 1e+8
        , lambda_mean = 0
        , lambda_var  = 1e+8
        , nu          = 1
        , s2          = NULL
        )
    , .level      = 0.95
    , .seed       = 1
    , .align      = TRUE
    , .waic       = TRUE
    )
txt <-
  bys_interpret(
      x             = fm1
    , higher_better = TRUE
    , top           = 5
    )
txt
#> Bayesian AMMI analysis
#> 
#> 2 bilinear term(s): lambda_1 = 4,161, lambda_2 = 2,245; convergence is not
#> yet established.
#> 
#> Findings:
#> - Convergence is not established: effective sample size as small as 52.3.
#> - 15 of 162 Heidelberger-Welch stationarity and half-width tests failed
#>   (about 5% fail by chance at level 0.05).
#> - Overall mean 3,629 (95% HPD 3,572 to 3,676); error variance 709,200, a
#>   coefficient of variation of 23.2%.
#> - Genotypes significantly above average (HPD of the effect excludes zero): 2,
#>   18, 19 and 23; below average: 38, 40 and 42.
#> - Environments with significantly high means: 1, 3, 5, 16, 17 and 4 more;
#>   low: 4, 6, 7, 8, 9 and 7 more.
#> - Singular values with 95% HPD intervals: lambda_1 = 4,161 (2,981 to 5,162);
#>   lambda_2 = 2,245 (167.7 to 3,677).
#> - On the first bilinear term, genotypes with significantly positive scores:
#>   38 and 42; negative: none.
#> - Environments with significantly positive first scores: 6, 7 and 9;
#>   negative: 21.
#> - Genotypes and environments with significant first scores of the same sign
#>   interact positively: the genotype yields more there than its main effect
#>   predicts; of opposite sign, less.
#> 
#> Recommendations:
#> - 2, 18, 19 and 23 are above average and do not interact significantly on the
#>   first term: candidates for wide recommendation.
#> - Recommend the genotypes with significant first scores for the environments
#>   whose scores have the same sign (bayes_ammi_biplot() shows the regions).
#> - Draw bayes_ammi_biplot() to see which genotypes and environments form
#>   homogeneous groups (overlapping HPD regions).
#> 
#> Cautions:
#> - Run longer chains (and two or more chains) before relying on the estimates.
#> - The HPD interval of lambda_2 reaches down to near zero: the term is weakly
#>   supported and its scores are uncertain.
#> 
#> Sources:
#> - Perez-Elizalde, S., Jarquin, D. and Crossa, J. (2012). A general Bayesian
#>   estimation method of linear-bilinear models applied to plant breeding
#>   trials with genotype x environment interaction. Journal of Agricultural,
#>   Biological, and Environmental Statistics, 17(1), 15-37.
#>   doi:10.1007/s13253-011-0063-9
#> - Crossa, J., Perez-Elizalde, S., Jarquin, D., Cotes, J. M., Viele, K., Liu,
#>   G. and Cornelius, P. L. (2011). Bayesian estimation of the additive main
#>   effects and multiplicative interaction model. Crop Science, 51(4),
#>   1458-1469. doi:10.2135/cropsci2010.06.0343
#> - Hoff, P. D. (2009). Simulation of the matrix Bingham-von Mises-Fisher
#>   distribution, with applications to multivariate and relational data.
#>   Journal of Computational and Graphical Statistics, 18(2), 438-456.
#>   doi:10.1198/jcgs.2009.07177
#> - Spiegelhalter, D. J., Best, N. G., Carlin, B. P. and van der Linde, A.
#>   (2002). Bayesian measures of model complexity and fit. Journal of the Royal
#>   Statistical Society B, 64(4), 583-639. doi:10.1111/1467-9868.00353
#> - Watanabe, S. (2010). Asymptotic equivalence of Bayes cross validation and
#>   widely applicable information criterion in singular learning theory.
#>   Journal of Machine Learning Research, 11, 3571-3594.
cat(format(x = txt, style = "markdown"))
#> ## Bayesian AMMI analysis  2 bilinear term(s): lambda_1 = 4,161, lambda_2 = 2,245; convergence is not yet established.  ### Findings - Convergence is not established: effective sample size as small as 52.3. - 15 of 162 Heidelberger-Welch stationarity and half-width tests failed   (about 5% fail by chance at level 0.05). - Overall mean 3,629 (95% HPD 3,572 to 3,676); error variance 709,200, a   coefficient of variation of 23.2%. - Genotypes significantly above average (HPD of the effect excludes zero): 2,   18, 19 and 23; below average: 38, 40 and 42. - Environments with significantly high means: 1, 3, 5, 16, 17 and 4 more;   low: 4, 6, 7, 8, 9 and 7 more. - Singular values with 95% HPD intervals: lambda_1 = 4,161 (2,981 to 5,162);   lambda_2 = 2,245 (167.7 to 3,677). - On the first bilinear term, genotypes with significantly positive scores:   38 and 42; negative: none. - Environments with significantly positive first scores: 6, 7 and 9;   negative: 21. - Genotypes and environments with significant first scores of the same sign   interact positively: the genotype yields more there than its main effect   predicts; of opposite sign, less.  ### Recommendations - 2, 18, 19 and 23 are above average and do not interact significantly on the   first term: candidates for wide recommendation. - Recommend the genotypes with significant first scores for the environments   whose scores have the same sign (bayes_ammi_biplot() shows the regions). - Draw bayes_ammi_biplot() to see which genotypes and environments form   homogeneous groups (overlapping HPD regions).  ### Cautions - Run longer chains (and two or more chains) before relying on the estimates. - The HPD interval of lambda_2 reaches down to near zero: the term is weakly   supported and its scores are uncertain.  ### Sources - Perez-Elizalde, S., Jarquin, D. and Crossa, J. (2012). A general Bayesian   estimation method of linear-bilinear models applied to plant breeding   trials with genotype x environment interaction. Journal of Agricultural,   Biological, and Environmental Statistics, 17(1), 15-37.   doi:10.1007/s13253-011-0063-9 - Crossa, J., Perez-Elizalde, S., Jarquin, D., Cotes, J. M., Viele, K., Liu,   G. and Cornelius, P. L. (2011). Bayesian estimation of the additive main   effects and multiplicative interaction model. Crop Science, 51(4),   1458-1469. doi:10.2135/cropsci2010.06.0343 - Hoff, P. D. (2009). Simulation of the matrix Bingham-von Mises-Fisher   distribution, with applications to multivariate and relational data.   Journal of Computational and Graphical Statistics, 18(2), 438-456.   doi:10.1198/jcgs.2009.07177 - Spiegelhalter, D. J., Best, N. G., Carlin, B. P. and van der Linde, A.   (2002). Bayesian measures of model complexity and fit. Journal of the Royal   Statistical Society B, 64(4), 583-639. doi:10.1111/1467-9868.00353 - Watanabe, S. (2010). Asymptotic equivalence of Bayes cross validation and   widely applicable information criterion in singular learning theory.   Journal of Machine Learning Research, 11, 3571-3594.