RowDotPlot-class: The RowDotPlot virtual class
In iSEE: Interactive SummarizedExperiment Explorer

Description Slot overview Supported methods Subclass expectations Author(s) See Also

The RowDotPlot is a virtual class where each row in the SummarizedExperiment is represented by no more than one point (i.e., a “dot”) in a brushable ggplot plot. It provides slots and methods to extract rowData fields to control the per-point aesthetics on the plot. This panel will transmit row identities in both its single and multiple selections, and it can receive multiple row selections but not multiple column selections.

The following slots control coloring of the points:

ColorByRowData, a string specifying the rowData field for controlling point color, if ColorBy="Row data" (see the Panel class). Defaults to the first field.
ColorBySampleNameAssay, a string specifying the assay of the SummarizedExperiment object containing values to use for coloring, if ColorBy="Sample name". Defaults to the name of the first assay.
ColorByFeatureNameColor, a string specifying the color to use for coloring an individual sample on the plot, if ColorBy="Feature name". Defaults to "red".

The following slots control other metadata-related aesthetic aspects of the points:

ShapeByRowData, a string specifying the rowData field for controlling point shape, if ShapeBy="Row data" (see the Panel class). The specified field should contain categorical values; defaults to the first such field.
SizeByRowData, a string specifying the rowData field for controlling point size, if SizeBy="Row data" (see the Panel class). The specified field should contain continuous values; defaults to the first such field.

In addition, this class inherits all slots from its parent DotPlot and Panel classes.

In the following code snippets, x is an instance of a RowDotPlot class. Refer to the documentation for each method for more details on the remaining arguments.

For setting up data values:

.cacheCommonInfo(x) adds a "RowDotPlot" entry containing valid.rowData.names, a character vector of valid column data names (i.e., containing atomic values); discrete.rowData.names, a character vector of names for discrete columns; and continuous.rowData.names, a character vector of names of continuous columns. This will also call the equivalent DotPlot method.
.refineParameters(x, se) replaces NA values in ColorByFeatAssay with the first valid assay name in se. This will also call the equivalent DotPlot method.

For defining the interface:

.hideInterface(x, field) returns a logical scalar indicating whether the interface element corresponding to field should be hidden. This returns TRUE for row selection parameters ("RowSelectionSource", "RowSelectionType" and "RowSelectionSaved"), otherwise it dispatches to the Panel method.

For monitoring reactive expressions:

.createObservers(x, se, input, session, pObjects, rObjects) sets up observers for all slots in the RowDotPlot. This will also call the equivalent DotPlot method.

For controlling selections:

.multiSelectionDimension(x) returns "row" to indicate that a row selection is being transmitted.
.singleSelectionDimension(x) returns "feature" to indicate that a feature identity is being transmitted.

For documentation:

.definePanelTour(x) returns an data.frame containing the steps of a tour relevant to subclasses, mostly tuning the more generic descriptions from the same method of the parent DotPlot.

Unless explicitly specialized above, all methods from the parent classes DotPlot and Panel are also available.

Subclasses are expected to implement methods for, at least: