make.all.the.plots: Make output plots

View source: R/plot.output.R

make.all.the.plotsR Documentation

Make output plots

Description

make.all.the.plots makes figures from the output from a conStruct analysis.

Usage

make.all.the.plots(conStruct.results, data.block, prefix, layer.colors = NULL)

Arguments

conStruct.results

The list output by a conStruct run.

data.block

A data.block list saved during a conStruct run.

prefix

A character vector to be prepended to all figures.

layer.colors

A vector of colors to be used in plotting results for different layers. Users must specify one color per layer. If NULL, plots will use a pre-specified vector of colors.

Details

This function takes the output from a conStruct analysis and generates a number of plots for visualizing results and diagnosing MCMC performance.

This function produces a variety of plots that can be useful for visualizing results or diagnosing MCMC performance. The plots made are by no means exhaustive, and users are encouraged to make further plots, or customize these plots as they see fit. For each plot, one file is generated for each MCMC chain (specified with the n.chains argument in the function conStruct. The plots generated (as .pdf files) are:

  • Structure plot - STRUCTURE-style plot, where each sample is represented as a stacked bar plot, and the length of the bar plot segments of each color represent that sample's admixture proportion in that layer. Described further in the help page for make.structure.plot.

  • Admixture pie plot - A map of samples in which each sample's location is denoted with a pie chart, and the proportion of a pie chart of each color represents that sample's admixture in each layer. Described further in the help page for make.admix.pie.plot

  • model.fit.CIs - A plot of the sample allelic covariance shown with the 95% credible interval of the parametric covariance for each entry in the matrix.

  • layer.covariances - A plot of the layer-specific covariances overlain unto the sample allelic covariance.

  • Trace plots - Plots of parameter values over the MCMC.

    • lpd - A plot of the log posterior probability over the MCMC.

    • nuggets - A plot of estimates of the nugget parameters over the MCMC.

    • gamma - A plot of estimates of the gamma parameter over the MCMC.

    • layer.cov.params - Plots of estimates of the layer-specific parameters over the MCMC.

    • admix.props - A plot of estimates of the admixture proportions over the MCMC.

Value

This function has only invisible return values.


conStruct documentation built on March 31, 2023, 10:13 p.m.