rENA (version 0.3.0)

ena.plot.points: 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,
  ...
)

Value

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

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

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);