brainGraph (version 3.1.1)

plot_global: 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"
)

Value

Either a trellis or ggplot object

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

Author

Christopher G. Watson,

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.