ErrBar {statVisual}

Compare Groups Based on dotplots Across Time

Description

This function is to compare groups using dotplots at each time point. In addition, line segments are used to connect the mean/median of each dotplot of the same group across time to show the differences between the mean trajectories. Also, for each dotplot the barplot of mean +/- standard error will be plot.

Usage

ErrBar(
    data, 
    x = NULL, 
    y, 
    group = NULL,
    semFlag = TRUE,
    xFlag = FALSE,
    bar.width = 0.5, 
    dodge.width = 0.8, 
    jitter = TRUE, 
    jitter.alpha = 0.7, 
    jitter.width = 0.1, 
    line = "mean", 
    line.color = "black", 
    xlab = x, 
    ylab = line, 
    theme_classic = TRUE, 
    group.lab = group, 
    title = "Dot plots", 
    xLevel = NULL,
    addThemeFlag = TRUE,
    ...)

Arguments

data

A data frame. Rows are subjects; Columns are variables describing the subjects.

x

character. The column name of data that indicates the first grouping variable

y

character. The column name of data that indicates the variable on y axis

group

character. The column name of data that indicates the subject groups. The dotplots will be drawn for each of the subject group within each category of x.

semFlag

logical. Indicate if sem or se should be used to draw error bar

xFlag

logical. Indicate if x should be treated as continuous (xFlag=TRUE)

bar.width

numeric. error bar width

dodge.width

numeric. dodge width for error bar and jitter (prevent overlapping)

jitter

logical, plot jitter or not, default TRUE

jitter.alpha

numeric. jitter transparency

jitter.width

numeric. jitter width in error bar

line

character. line connect error bar, default uses mean, can be set as 'median', NULL (no line)

line.color

character. connection line color, only available when group = NULL

xlab

character. x axis label

ylab

character. y axis label

theme_classic

logical. Use classic background without grids (default: TRUE).

group.lab

character. label of group variable

title

character. title of plot

xLevel

character. A character vector indicating the order of the elements of x to be shown on x-axis if is.null(x)==FALSE.

addThemeFlag

logical. Indicates if light blue background and white grid should be added to the figure.

...

other input parameters for facet & theme

Value

A list of the following 9 elements: “data”, “layers”, “scales”, “mapping”, “theme”, “coordinates”, “facet”, “plot_env”, “labels”.

Author(s)

Wenfei Zhang <[e-mail]>, Weiliang Qiu <[e-mail]>, Xuan Lin <[e-mail]>, Donghui Zhang <[e-mail]>

Examples

data(longDat)

print(dim(longDat))
print(longDat[1:3,])

print(table(longDat$time, useNA = "ifany"))
print(table(longDat$grp, useNA = "ifany"))
print(table(longDat$sid, useNA = "ifany"))

print(table(longDat$time, longDat$grp))

statVisual(type = 'ErrBar', 
  data = longDat, 
  x = 'time', 
  y = 'y', 
  group = 'grp',
  title = "Dot plots across time") 


ErrBar(
  data = longDat, 
  x = 'time', 
  y = 'y', 
  group = 'grp',
  title = "Dot plots across time")