plot_global {brainGraph}

Plot global graph measures across densities

Description

Create a faceted line plot of global graph measures across a range of graph densities, calculated from a list of brainGraphList objects. This requires that the variables of interest are graph-level attributes of the input graphs.

Usage

plot_global(g.list, xvar = c("density", "threshold"), vline = NULL,
  level.names = "default", exclude = NULL, perms = NULL,
  alt = "two.sided")

Arguments

g.list

List of brainGraphList objects; the length of this list should equal the number of thresholds/densities in the study

xvar

A character string indicating whether the variable of interest is “density” or “threshold” (e.g. with DTI data)

vline

Numeric of length 1 specifying the x-intercept if you would like to plot a vertical dashed line (e.g., if there is a particular density of interest). Default: NULL

level.names

Character vector of variable names, which are displayed as facet labels. If you do not want to change them, specify NULL. By default, they are changed to pre-set values.

exclude

Character vector of variables to exclude. Default: NULL

perms

A data.table of permutation group differences

alt

Character vector of alternative hypotheses; required if perms is provided, but defaults to “two.sided” for all variables

Details

You can choose to insert a dashed vertical line at a specific density/threshold of interest, rename the variable levels (which become the facet titles), exclude variables, and include a brainGraph_permute object of permutation data to add asterisks indicating significant group differences.

Value

Either a trellis or ggplot object

Author(s)

Christopher G. Watson, [e-mail]