ErrBar: Compare Groups Based on dotplots Across Time
In statVisual: Statistical Visualization Tools

Description Usage Arguments Value Author(s) Examples

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.

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,
    ...)

`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

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

Wenfei Zhang <Wenfei.Zhang@sanofi.com>, Weiliang Qiu <Weiliang.Qiu@sanofi.com>, Xuan Lin <Xuan.Lin@sanofi.com>, Donghui Zhang <Donghui.Zhang@sanofi.com>

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