plotConnections: Plot the connections to informed individuals against event...

Description Usage Arguments Details See Also

View source: R/plotConnections.R

Description

For each acquisition event, the total connection of each naive individual to informed individuals is plotted for a specified network.

Usage

1
2
3
4
5
6
plotConnections(nbdadata, network = 1, rescale = F, lty = 1,
  lwd = 1, col = 2, pchVector = NULL, symbol = NULL,
  xlab = "Acquisition event", ylab = NULL, title = NULL,
  plotID = NULL, offset = c(0.1, 0), xlim = NULL, ylim = NULL,
  titlePos = c(0, 0), averageLinelty = 2, averageLinecol = 4,
  averageLinelwd = 1, plotConnectLine = T, plotAverageLine = T)

Arguments

nbdadata

an object of class nbdaData.

network

numeric giving the number of the network for which the connections are to be plotted, i.e. corresponding to the third dimension of assMatrix in the nbdaData object.

rescale

logical indicating whether the connections should be rescaled to be plotted relative to the average connection to informed individuals for each event.

lty

numeric or string determining the connecting line type, see (par).

lwd

numeric determining the connecting line width, see (par).

pchVector

an optional vector of plotting symbols to be used for each type of individual as defined by symbol below. See pch in (par).

symbol

an optional vector allowing different symbols to be plotted for each point. e.g. to plot different symbols for learners an non learners, specify symbol=<name of nbdadata>@status. To choose which symbol is used for each category, use symbol, e.g. pchVector = c(3,8). Alternatively, the user could plot points based on a specific ILV, e.g. symbol=<name of nbdadata>@asocILVdata[,1] to the first asoc_ilv.

xlab

passed to the plot function.

ylab

passed to the plot function.

title

an optional string giving a title for the plot.

plotID

an optional vector of names or indentifiers to be plotted next to the symbol for each learner. If idname was provided to the nbdaData function, then this can be done by specifiying plotID = <name of nbdadata>@idname[<name of nbdadata>@orderAcq]

offset

an optional numerical vector of length two, specifying where to plot id relative to its corresponding point.

xlim

passed to the plot function.

ylim

passed to the plot function.

titlePos

an optional numerical vector of length two, specifying where to plot the title.

averageLinelty

numeric or string determining the average line type, see (par).

averageLinecol

numeric or string determining the average line colour, see (par).

averageLinelwd

numeric or string determining the average line colour, see (par).

plotConnectLine

logical specifying whether a connecting line is to be plotted.

plotAverageLine

logical specifying whether an average line is to be plotted.

Details

The individual to learn each event is plotted in red and these are connected by a red line (by default). A dotted line showing the average connection to informed individuals each event is plotted in blue (by default). If the order of acquisition does not follow the network in question, we would expect the red points to be distributed evenly above and below the blue line. The more closely the order of acquisition follows the network, the more points will be above the blue line and the higher they will be above it.

See Also

nbdaData


whoppitt/NBDA documentation built on April 25, 2021, 7:55 a.m.