BiAxisErrBar: Compare Patterns of Two Outcomes in One Scatter Plot
In statVisual: Statistical Visualization Tools

Description Usage Arguments Value Author(s) Examples

Compare patterns of two outcomes with different scales across the range of the common predictor using error bar plots. Each bar plot displays mean +/- standard error.

BiAxisErrBar(dat, 
	     group, 
	     y.left, 
	     y.right, 
	     title = "Bi-Axis Error Bar Plot",
	     xlab = group, 
	     ylab.left = y.left, 
	     ylab.right = y.right, 
	     legendLabel = "y axis variables",
	     delta = NULL, 
	     cvThresh = 0.01, 
             Ntick = 5,
             semFlag = TRUE, #semFlag = FALSE if SE is required
	     GroupLevel = NULL,
	     addThemeFlag = FALSE
	     )

`dat`	A data frame. Rows are subjects; Columns are variables describing the subjects.
`group`	character. A categorical variable in `data` that indicates the predictor.
`y.left`	character. The column name of `data` that indicates the first outcome variable, the error bar plot of which will be drawn on the left side.
`y.right`	character. The column name of `data` that indicates the second outcome variable, the error bar plot of which will be drawn on the right side.
`title`	character. title of the plot.
`xlab`	character. Label for the x-axis.
`ylab.left`	character. Label for the left-side y-axis.
`ylab.right`	character. Label for the right-side y-axis.
`legendLabel`	character. Legend label.
`delta`	numeric. A small number so that the second error bar plot will shift `delta` distance from the first error bar plot.
`cvThresh`	numeric. A small positive number. If the coefficient of variation (CV) is smaller than `cvThresh`, then the scaling factor will be set to one.
`Ntick`	integer. Number of ticks on the two y-axes.
`semFlag`	logical. Indicating if standard error of the mean (`semFlag = TRUE`) or standard error (`semFlag = FALSE`) will be used to construct the error bars.
`GroupLevel`	A vector of unique values of `group` indicating the order of `group` shown in x-axis.
`addThemeFlag`	logical. Indicates if light blue background and white grid should be added to the figure.

A list with 9 elements. data, layers, scales, mapping, theme, coordinates, facet, plot_env, and 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>

library(tidyverse)
library(ggplot2)

print(head(mtcars))

print(table(mtcars$gear, useNA="ifany"))

statVisual(type = "BiAxisErrBar",
  dat= mtcars,
  group = "gear",
  y.left = "mpg",
  y.right = "wt")



BiAxisErrBar(
  dat = mtcars,
  group = "gear",
  y.left = "mpg",
  y.right = "wt")