ena.plot.points: Plot points on an ENAplot

In rENA: Epistemic Network Analysis

Plot points on an ENAplot

Description

Plot all or a subset of the points of an ENAplot using the plotly plotting library

Usage

ena.plot.points(
  enaplot,
  points = NULL,
  point.size = enaplot$point$size,
  labels = NULL,
  label.offset = "top left",
  label.group = NULL,
  label.font.size = NULL,
  label.font.color = NULL,
  label.font.family = NULL,
  shape = "circle",
  colors = NULL,
  confidence.interval.values = NULL,
  confidence.interval = c("none", "crosshairs", "box"),
  outlier.interval.values = NULL,
  outlier.interval = c("none", "crosshairs", "box"),
  show.legend = T,
  legend.name = "Points",
  texts = NULL,
  ...
)

Arguments

enaplot	ENAplot object to use for plotting
points	A dataframe of matrix where the first two column are X and Y coordinates
point.size	A data.frame or matrix where the first two column are X and Y coordinates of points to plot in a projected ENA space defined in ENAplot
labels	A character vector of point labels, length nrow(points); default: NULL
label.offset	character: top left (default), top center, top right, middle left, middle center, middle right, bottom left, bottom center, bottom right
label.group	A string used to group the labels in the legend. Items plotted with the same label.group will show/hide together when clicked within the legend.
label.font.size	An integer which determines the font size for point labels, default: enaplot$font.size
label.font.color	A character which determines the color of label font, default: enaplot$font.color
label.font.family	A character which determines label font type, choices: Arial, Courier New, Times New Roman, default: enaplot$font.family
shape	A character which determines the shape of point markers, choices: square, triangle, diamond, circle, default: circle
colors	A character vector of the point marker colors; if one given it is used for all, otherwise must be same length as points; default: black
confidence.interval.values	A matrix/dataframe where columns are CI x and y values for each point
confidence.interval	A character determining markings to use for confidence intervals, choices: none, box, crosshair, default: none
outlier.interval.values	A matrix/dataframe where columns are OI x and y values for each point
outlier.interval	A character determining markings to use for outlier interval, choices: none, box, crosshair, default: none
show.legend	Logical indicating whether to show the point labels in the in legend
legend.name	Character indicating the name to show above the plot legend
texts	[TBD]
...	additional parameters addressed in inner function

Value

ENAplot The ENAplot provided to the function, with its plot updated to include the new points.

See Also

ena.plot, ENAplot, ena.plot.group

Examples

data(RS.data)

codeNames = c('Data','Technical.Constraints','Performance.Parameters',
  'Client.and.Consultant.Requests','Design.Reasoning','Collaboration');

accum = ena.accumulate.data(
  units = RS.data[,c("UserName","Condition")],
  conversation = RS.data[,c("Condition","GroupName")],
  metadata = RS.data[,c("CONFIDENCE.Change","CONFIDENCE.Pre","CONFIDENCE.Post")],
  codes = RS.data[,codeNames],
  window.size.back = 4
)

set = ena.make.set(
  enadata = accum,
  rotation.by = ena.rotate.by.mean,
  rotation.params = list(
      accum$meta.data$Condition=="FirstGame",
      accum$meta.data$Condition=="SecondGame"
  )
)

plot = ena.plot(set)

group1.points = set$points[set$meta.data$Condition == "FirstGame",]
group2.points = set$points[set$meta.data$Condition == "SecondGame",]
plot = ena.plot.points(plot, points = group1.points);
plot = ena.plot.points(plot, points = group2.points);
print(plot);

rENA documentation built on March 26, 2022, 1:10 a.m.