Plotting Marginal Effect Estimates

Plotting marginal effect estimates after either the binning estimator or the kernel estimator is applied

Usage

# S3 method for interflex
plot(x, order = NULL, subtitles = NULL, 
  show.subtitles = NULL, CI = NULL, diff.values = NULL, Xdistr = "histogram", 
  main = NULL, Ylabel = NULL, Dlabel = NULL, Xlabel = NULL, xlab = NULL, 
  ylab = NULL, xlim = NULL, ylim = NULL, theme.bw = FALSE, show.grid = TRUE, 
  cex.main = NULL, cex.sub = NULL, cex.lab = NULL, cex.axis = NULL, 
  bin.labs = TRUE, interval = NULL, file = NULL, ncols = NULL, pool = FALSE, 
  legend.title = NULL, color = NULL, show.all = FALSE,
  scale = 1.1, height = 7, width = 10,
  ...)

Arguments

x: an interflex object.
order: a vector of strings that determines the order of treatment arms in the plot when visualizing marginal effects. It should contain all kinds of treatment arms except for the base group or all elements in "to.show".
subtitles: a vector of strings that determines the subtitles of subplots. Its length should be equal to the number of categories of treatment arms minus one.
show.subtitles: a logical flag controlling whether to show subtitles. Default to TRUE when the number of treatment arms is larger than 2.
CI: a logical flag indicating whether the confidence intervals need to be shown.
diff.values: a two-element numeric vector. The treatment effects at corresponding values of the moderator will be marked on the plot.
Xdistr: a string indicating the way the distribution of the moderator will be plotted: "histogram" (or "hist"), "density", or "none". The default is "histogram".
main: a string that controls the title of the plot.
Ylabel: a string that controls the label of the outcome variable Y in the plot.
Dlabel: a string that controls the label of the treatment variable D in the plot.
Xlabel: a string that controls the label of the moderating variable X in the plot.
xlab: a string that specifies the label of the x-axis.
ylab: a string that specifies the label of the y-axis.
xlim: a two-element numeric vector that controls the range of the x-axis to be shown in the plot.
ylim: a two-element numeric vector that controls the range of the y-axis to be shown in the plot (with small adjustments to improve aesthetics).
theme.bw: a logical flag specifying whether to use a black-white theme.
show.grid: a logical flag indicating whether to show grid in the plot.
cex.main: a numeric value that controls the font size of the plot title.
cex.sub: a numeric value that controls the font size of subtitles.
cex.lab: a numeric value that controls the font size of the axis labels.
cex.axis: a numeric value that controls the font size of the axis numbers.
bin.labs: a logical flag indicating whether to show a label for each bin in a binning plot; only meaningful when nbins is 3 or 4. The default is TRUE.
interval: draw two vertical lines to demonstrate the interval used in replicated papers.
file: a string that specifies the filename in which the plot is saved.
ncols: an integer that controls the number of columns in the plot if pool is FALSE.
pool: a logical flag specifying whether to integrate marginal effects for each treatment arm in one plot.
legend.title: a string that specifies the title of the legend when pool is TRUE.
color: a vector of colors that determines the color of lines when pool is TRUE.
show.all: a logical flag specifying whether to return the plots for each kinds of treatment level. If setting to TRUE, the program will return a list of ggplot2 objects.
scale: Multiplicative scaling factor of printed graph.
height: Plot size (Height).
width: Plot size (Width).
...: other argv.

Details

plot.interflex draws a margining effect plot based on a interflex object after either binning model or kernel model is applied. It allows users to flexibly change the look of a plot without re-estimating the model, hence saving time.

Value

graph: stores the graphic output, a ggplot2 object.

Author

Jens Hainmueller; Jonathan Mummolo; Yiqing Xu (Maintainer); Ziyi Liu

References

Jens Hainmueller; Jonathan Mummolo; Yiqing Xu. 2019. "How Much Should We Trust Estimates from Multiplicative Interaction Models? Simple Tools to Improve Empirical Practice." Political Analysis, Vol. 27, Iss. 2, April 2019, pp. 163--192. Available at: https://www.cambridge.org/core/journals/political-analysis/article/how-much-should-we-trust-estimates-from-multiplicative-interaction-models-simple-tools-to-improve-empirical-practice/D8CAACB473F9B1EE256F43B38E458706.