Floodlight Multicategorical by Continuous
Conduct a floodlight analysis for a Multicategorical IV x Continuous Moderator design.
floodlight_multi_by_continuous( data = NULL, iv_name = NULL, dv_name = NULL, mod_name = NULL, coding = "indicator", baseline_category = NULL, covariate_name = NULL, interaction_p_include = TRUE, iv_category_order = NULL, heteroskedasticity_consistent_se = "HC4", round_r_squared = 3, round_f = 2, sigfigs = 2, jn_points_disregard_threshold = NULL, print_floodlight_plots = TRUE, output = "all", jitter_x_percent = 0, jitter_y_percent = 0, dot_alpha = 0.5, dot_size = 4, interaction_p_value_font_size = 8, jn_point_font_size = 8, jn_point_label_hjust = NULL, interaction_p_vjust = -3, plot_margin = ggplot2::unit(c(75, 7, 7, 7), "pt"), legend_position = "right", line_of_fit_types = c("solid", "dashed"), line_of_fit_thickness = 1.5, jn_line_types = c("solid", "solid"), jn_line_thickness = 1.5, colors_for_iv = c("red", "blue"), sig_region_color = "green", sig_region_alpha = 0.08, nonsig_region_color = "gray", nonsig_region_alpha = 0.08, x_axis_title = NULL, y_axis_title = NULL, legend_title = NULL, round_decimals_int_p_value = 3, round_jn_point_labels = 2 )
data: a data object (a data frame or a data.table)
iv_name: name of the multicategorical independent variable; this variable must have three or more categories.
dv_name: name of the dependent variable
mod_name: name of the continuous moderator variable
coding: name of the coding scheme to use; the current version of the function allows only the "indicator" coding scheme. By default, coding = "indicator"
baseline_category: value of the independent variable that will be the reference value against which other values of the independent variable will be compared
covariate_name: name of the variables to control for
interaction_p_include: logical. Should the plot include a p-value for the interaction term?
iv_category_order: order of levels in the independent variable for legend. By default, it will be set as levels of the independent variable ordered using R's base function sort.
heteroskedasticity_consistent_se: which kind of heteroskedasticity-consistent (robust) standard errors should be calculated? (default = "HC4")
round_r_squared: number of decimal places to which to round r-squared values (default = 3)
round_f: number of decimal places to which to round the f statistic for model comparison (default = 2)
sigfigs: number of significant digits to round to (for values in the regression tables, except for p values). By default sigfigs = 2
jn_points_disregard_threshold: the Minimum Distance in the unit of the moderator variable that will be used for various purposes, such as (1) to disregard the second Johnson-Neyman point that is different from the first Johnson-Neyman (JN) point by less than the Minimum Distance; (2) to determine regions of significance, which will calculate the p-value of the IV's effect (the focal dummy variable's effect) on DV at a candidate JN point + / - the Minimum Distance. This input is hard to explain, but a user can enter a really low value for this argument (e.g., jn_points_disregard_threshold = 0.1
for a moderator measured on a 100-point scale) or use the default. By default, jn_points_disregard_threshold = range of the moderator / 10000
For example, if the observed moderator values range from 1 to 7 (because it is a 7-point scale), then jn_points_disregard_threshold = (7 - 1) / 10000 = 0.0006
print_floodlight_plots: If print_floodlight_plots = TRUE, a floodlight plot for each dummy variable will be printed. By default, print_floodlight_plots = TRUE
output: output of the function (default = "all"). Possible inputs: "reg_models", "reg_tables", "reg_tables_rounded", "all"
jitter_x_percent: horizontally jitter dots by a percentage of the range of x values
jitter_y_percent: vertically jitter dots by a percentage of the range of y values
dot_alpha: opacity of the dots (0 = completely transparent, 1 = completely opaque). By default, dot_alpha = 0.5
dot_size: size of the dots (default = 4)
interaction_p_value_font_size: font size for the interaction p value (default = 8)
jn_point_font_size: font size for Johnson-Neyman point labels (default = 8)
jn_point_label_hjust: a vector of hjust values for Johnson-Neyman point labels. By default, the hjust value will be 0.5 for all the points.
interaction_p_vjust: By how much should the label for the interaction p-value be adjusted vertically? By default, interaction_p_vjust = -3)
plot_margin: margin for the plot By default plot_margin = ggplot2::unit(c(75, 7, 7, 7), "pt")
legend_position: position of the legend (default = "right"). If legend_position = "none", the legend will be removed.
line_of_fit_types: types of the lines of fit for the two levels of the independent variable. By default, line_of_fit_types = c("solid", "dashed")
line_of_fit_thickness: thickness of the lines of fit (default = 1.5)
jn_line_types: types of the lines for Johnson-Neyman points. By default, jn_line_types = c("solid", "solid")
jn_line_thickness: thickness of the lines at Johnson-Neyman points (default = 1.5)
colors_for_iv: colors for the two values of the independent variable (default = c("red", "blue"))
sig_region_color: color of the significant region, i.e., range(s) of the moderator variable for which simple effect of the independent variable on the dependent variable is statistically significant.
sig_region_alpha: opacity for sig_region_color. (0 = completely transparent, 1 = completely opaque). By default, sig_region_alpha = 0.08
nonsig_region_color: color of the non-significant region, i.e., range(s) of the moderator variable for which simple effect of the independent variable on the dependent variable is not statistically significant.
nonsig_region_alpha: opacity for nonsig_region_color. (0 = completely transparent, 1 = completely opaque). By default, nonsig_region_alpha = 0.08
x_axis_title: title of the x axis. By default, it will be set as input for mod_name. If x_axis_title = FALSE, it will be removed.
y_axis_title: title of the y axis. By default, it will be set as input for dv_name. If y_axis_title = FALSE, it will be removed.
legend_title: title of the legend. By default, it will be set as input for iv_name. If legend_title = FALSE, it will be removed.
round_decimals_int_p_value: To how many digits after the decimal point should the p value for the interaction term be rounded? (default = 3)
round_jn_point_labels: To how many digits after the decimal point should the jn point labels be rounded? (default = 2)
See the following reference: Hayes & Montoya (2017) tools:::Rd_expr_doi("10.1080/19312458.2016.1271116")
Williams (2004) on r-squared values when calculating robust standard errors https://web.archive.org/web/20230627025457/https://www.stata.com/statalist/archive/2004-05/msg00107.html
## Not run: # typical example floodlight_multi_by_continuous( data = mtcars, iv_name = "cyl", dv_name = "mpg", mod_name = "qsec") ## End(Not run)
Useful links