ErrBar {statVisual} | R Documentation |
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 |
y |
character. The column name of |
group |
character. The column name of |
semFlag |
logical. Indicate if sem or se should be used to draw error bar |
xFlag |
logical. Indicate if |
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 |
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 <Wenfei.Zhang@sanofi.com>, Weiliang Qiu <Weiliang.Qiu@sanofi.com>, Xuan Lin <Xuan.Lin@sanofi.com>, Donghui Zhang <Donghui.Zhang@sanofi.com>
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")