plot_posterior_predictive_samples {BEDASSLE}

Plots posterior predictive sampling

Description

This function plots the posterior predictive samples generated by posterior.predictive.sample around the observed data, so that users can evaluate how well the model is able to describe their data.

Usage

plot_posterior_predictive_samples(posterior.predictive.sample.file, save.figure = NULL, 
	figure.name = NULL)

Arguments

posterior.predictive.sample.file

The output file generated by the function posterior.predictive.sample.

save.figure

If save.figure = TRUE, a .png file of the posterior predictive sample plot will be saved, rather than plotted to the default R plotting window. Depending on the posterior.predictive.sample.size specified in posterior.predictive.sample, this figure may be time-intensive to generate, so users may wish to save the figure for future analysis, rather than re-plot it. If save.figure = TRUE, a figure.name must be specified. Default is save.figure = NULL.

figure.name

If save.figure = TRUE, a .png file of the posterior predictive sample plot will be saved under the name figure.name. If save.figure = TRUE, a figure.name must be specified. Default is figure.name = NULL.

Details

This function plots posterior predictive unbiased pairwise F_{ST} around the observed unbiased pairwise F_{ST} values to determine how well the model is able to describe the user's data. Users should examine these plots to make sure that the model is picking up general trends (e.g. the slopes of isolation by geographic distance and isolation by ecological distance), and also to identify specific populations whose relationships with their neighbors are being poorly accommodated by the model.

Author(s)

Gideon Bradburd