plotting.ext: Plot extrema in the response surface along the lines of congruence and incongruence

Description

Plots the response surface of an RSA object along the lines of congruence (LOC) and incongruence (LOIC), while indicating the location of reversal or acceleration points in the surface (when they exist).

Usage

plotting.ext(
  RSA_object,
  model,
  acceleration = c(0, 0),
  n_sample = 100,
  names_xLOC = NULL,
  names_xLOIC = NULL,
  names_z = NULL,
  xlim = NULL,
  zlim = NULL,
  e_label = NULL,
  text_size = 1,
  elabel_size = 5,
  e_size = 3,
  breaks_x = NULL,
  breaks_z = NULL
)

Value

A list of plot of the lines of congruence (LOC) and incongruence (LOIC)

Arguments

RSA_object: An RSA object
model: The model to be probed for extrema (reversal or acceleration points)
acceleration: Rates of accelerations along the LOC and LOIC to be inspected (0< |rate| < 1). Passed on internally to ident.ext
n_sample: Number of random draws to consider to find extrema. This option is used for large samples to increase speed in preliminary analyses, but it is not recommended for published results). Passed on internally to ident.ext
names_xLOC: Label of x axis on the LOC plot.
names_xLOIC: Label of x axis on the LOIC plot.
names_z: Label of z axis (outcome).
xlim: Limits of the x axis
zlim: Limits of the z axis
e_label: If "none", no coordinates are projected. Defaults to NULL.
text_size: Text size for titles and labels.
elabel_size: Text size for extrema coordinates.
e_size: Point size of extrema.
breaks_x: Scale breaks for x axis. Defaults to seq(-10, 10, 0.5).
breaks_z: Scale breaks for z axis. Defaults to seq(-10, 10, 0.5).

Details

The lines of congruence (LOC) and incongruence (LOIC) are fundamental to RSA applications. This function allows plotting the response along the LOC and LOIC, thus offering a more precise visualization of the response surface (as a complement to 3d or 2d projections provided by RSAplot). The location of reversal or acceleration points can be provided with x-y-z coordinales or without them (e_label='none').

Examples

Run this code

######ESTIMATE POLYNOMIAL MODEL FOR RSA
RSA_NSfit  <- RSAmodel(formula= engagement ~ needs*supplies,
data= sim_NSfit, model= c("FM26_PARALLELASYMWEAK"))
######PLOT EXTREMA OVER LOC AND LOIC
EXTsim <- plotting.ext(RSA_NSfit,model="FM26_PARALLELASYMWEAK",
xlim=c(-3,3),zlim=c(-3,3),acceleration=c(0,-0.3),
text_size=0.7,elabel_size=3,e_size=2,breaks_x=seq(-10, 10, 0.5),breaks_z=seq(-10, 10, 0.5))
ggpubr::ggarrange(EXTsim[["LOC"]], EXTsim[["LOIC"]],
labels = c("A. Response over LOC", "B. Response over LOIC"),
nrow=1,ncol=2,font.label = list(size = 11))