RowTable-class: The RowTable class

In csoneson/iSEE: Interactive SummarizedExperiment Explorer

The RowTable class

Description

The RowTable is a virtual class where each row in the SummarizedExperiment is represented by no more than one row in a datatable widget. In panels of this class, single and multiple selections can only be transmitted on the features.

Slot overview

No new slots are added. All slots provided in the Table parent class are available.

Supported methods

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

For setting up data values:

• .refineParameters(x, se) replaces NA values in Selected with the first row name of se. This will also call the equivalent Table 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 column selection parameters ("ColumnSelectionSource" and "ColumnSelectionRestrict"), otherwise it dispatches to the Panel method.

For monitoring reactive expressions:

• .createObservers(x, se, input, session, pObjects, rObjects) sets up observers to propagate changes in the Selected to linked plots. This will also call the equivalent Table 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 rendering output:

• .showSelectionDetails(x) returns a HTML element containing details about the selected row. This requires a function to be registered by registerAppOptions under the option name "RowTable.select.details". The function should take a string containing the name of a feature (i.e., the current selection in the RowTable) and returns a HTML element. If no function is registered, NULL is returned.

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

Subclass expectations

Subclasses are expected to implement methods for:

• .generateTable

• .fullName

• .panelColor

The method for .generateTable should create a tab data.frame where each row corresponds to a row in the SummarizedExperiment object.

Author(s)

Aaron Lun

See Also

Table, for the immediate parent class that contains the actual slot definitions.

csoneson/iSEE documentation built on Oct. 12, 2024, 5:41 p.m.