vecplot function

VEC plot function (to use in conjunction with Importance function).

vecplot(I, graph = "VEC", leg = NULL, xval = 1, sort = FALSE, data = NULL, 
digits = c(1, 1), TC = 1, intbar = NULL, lty = 1, pch = 19, col = NULL, 
datacol = NULL, main = "", main2 = "", Grid = 0, 
xlab = "", ylab = "", zlab = "", 
levels = NULL, levels2 = NULL, showlevels = FALSE, 
screen = list(z = 40, x = -60), zoom = 1, cex = 1)

Arguments

• I: the output list of the Importance function.

• graph: type of VEC graph:

  • VEC -- 1-D VEC curve;
  • VECB -- 1-D VEC curve with box plots (only valid for SA methods: "DSA", "MSA");
  • VEC3 -- 2-D VEC surface;
  • VECC -- 2-D VEC contour;

• leg: see mgraph

• xval: the attribute input index (e.g. 1), only used if graph="VEC" or (graph="VEC3" or "VECC"

  and length(interactions)=1, see Importance). if a vector, then several VEC curves are plotted (in this case, x-axis is scaled).

• sort: if factor inputs are sorted:

  • increasing -- sorts the first attribute (if factor) according to the response values, increasing order;
  • decreasing -- similar to increasing but uses reverse order;
  • TRUE -- similar to increasing;
  • increasing2 -- sorts the second attribute (for graph="VEC3" or "VECC", if factor, according to the response values), increasing order;
  • decreasing2 -- similar to increasing2 but uses reverse order;
  • FALSE -- no sort is used;

• data: see mgraph

• digits: see mgraph

• TC: see mgraph

• intbar: see mgraph

• lty: see mgraph

• pch: point type for the graph="VEC" curve, can be a vector if there are several VEC curve plots

• col: color (e.g. "black", "grayrange", "white")

• datacol: color of the data histogram for graph="VEC"

• main: see mgraph

• main2: key title for graph="VECC"

• Grid: see mgraph

• xlab: x-axis label

• ylab: y-axis label

• zlab: z-axis label

• levels: if x1 is factor you can choose the order of the levels to this argument

• levels2: if x2 is factor you can choose the order of the levels to this argument

• showlevels: if you want to show the factor levels in x1 or x2 axis in graph="VEC3":

  • FALSE or TRUE -- do not (do) show the levels in x1, x2 and z axis for factor variables;
  • vector with 3 logical values -- if you want to show the levels in each of the x1, x2 or z axis for factor variables (e.g. c(FALSE,FALSE,TRUE) only shows for z-axis).

• screen: select the perspective angle of the VEC3 graph:

  • x -- assumes list(z=0,x=-90,y=0);
  • X -- assumes list(x=-75);
  • y -- assumes list(z=0,x=-90,y=-90);
  • Y -- assumes list(z=10,x=-90,y=-90);
  • z -- assumes list(z=0,x=0,y=0);
  • xy -- assumes list(z=10,x=-90,y=-45);
  • else you need to specify a list with z, x an y angles, see wireframe

• zoom: zoom of the wireframe (graph="VEC3")

• cex: label font size

Details

For examples and references check: Importance

Returns

A VEC curve/surface/contour plot.

Author(s)

Paulo Cortez http://www3.dsi.uminho.pt/pcortez/

See Also

Importance

References

• To cite the Importance function or sensitivity analysis method, please use:

  P. Cortez and M.J. Embrechts.

  Using Sensitivity Analysis and Visualization Techniques to Open Black Box Data Mining Models.

  In Information Sciences, Elsevier, 225:1-17, March 2013.

  tools:::Rd_expr_doi("10.1016/j.ins.2012.10.039")