Revision as of 12:53, 17 June 2010

Overview of Marker and Array Sets

The Markers/Arrays component, located at lower left in the geWorkbench graphical interface, allows the user to define and use subsets of arrays and markers for a number of purposes.

As used in geWorkbench, the term "marker" includes genes, probes/probesets, and individual sequences, depending on the type of data loaded. Sets of markers can be returned by various analysis routines. For example the t-test returns a list of markers showing significant differential expression, and after hierarchical clustering, the markers in a subtree of the resulting dendrogram can be saved to a list.

Sets of microarrays can be used to group arrays in a meaningful fashion for statistical analysis. For example, two such phenotypes might be the diseased and normal states of a tissue from which samples have been taken. geWorkbench uses the clinical terms "Case" and "Control" to categorize these, but in a biological setting the equivalent would be "Experimental" vs "Control".

This chapter discusses the use of subsets of markers. Please see the chapter Data Subsets - Arrays for a discussion of the use of Array sets.

Further examples of working with sets of markers can be found in Tutorial_-_Differential_Expression and Tutorial_-_Clustering.

The figure below shows the Markers component located below the Project Folders component in geWorkbench. The Arrays component is located in the same space, under a separate tab.

Common Principles of Operation of Marker and Array Subsets

Rather than using all arrays or all markers in a data set for a particular analysis or visualization, the user may wish to restrict those used to only some subset.

Activating Subsets of Markers and Arrays

In the Markers and Arrays components, subsets of markers and arrays can be defined by the user, and also are created as the outcome of some analyses. Beside each such subset in the graphical interface is a checkbox. Marking this box "checked" activates the subset.

• Activating a subset restricts many geWorkbench components to using as input only the markers or arrays that are in such activated subsets.

• Marker Subsets
  • If no Marker subset is active, all Markers are used.
  • If at least one Marker subset is activated, affected components will only use markers in activated sets.
• Array Subsets
  • If no Array subset is active, all Arrays are used.
  • If at least one Array subset is activated, affected components will only use arrays in activated sets.

Controls

Upper Pane

The list in upper pane of the Markers component shows the markers loaded in the current data set.

The upper pane of the Markers component has the following controls:

• Search text field - Search for arrays by typing in a name or portion of a name. As one types, the first array matching the entry so far will be highlighted. In some cases however, the Find Next button must be pushed to find a match. If the typed entry matches no arrays, it will be displayed in red.
• Find Next button - find the next array matching the typed entry.

• Light Bulb icon - when activated , enables "hover text" display of marker names in this component.

Selecting one or more markers in the list and then right-clicking gives the following choices in a pop-up menu:

• Add to Set - Add the selected markers to a new or existing subset.
• Clear Selection - unhighlights the selected markers.

Lower Pane

The lower pane of the Markers component has the following controls:

• Marker Sets menu - Select which named set of markers to display. Each can contain a different arrangement of markers into subsets.
• New button - Create a new marker set.

If you right-click on a subset, a menu with the following choices appears:

• Rename - Rename the selected subset.
• Copy - Make a copy of the selected subset.
• Activate - Activate the selected subset. This can also be done directly by checking the check box before its entry.
• Deactivate - Deactivate the selected subset. This can also be done directly by unchecking the check box before its entry.
• New Set - Create a new empty marker subset.
• Delete - Delete the selected subset.
• Combine - Combine the selected subsets into a new subset. Methods are:
  • Union - add all arrays from all selected sets.
  • Intersection - add arrays that are in each selected set.
  • XOR - add arrays that are in only one of the selected sets.
• Print - Print the selected subset of arrays.
• Visual Properties - not implemented.
• Save - not implemented.
• Tag for visualization - This feature allows a set of markers to be intersected with a network displayed in the Cytoscape component. Any markers that are in the "tagged" set and which also appear in the Cytoscape display will be highlighted yellow.

Examples (Section under construction)

Add a marker to the default set by double-clicking

Double-clicking a marker in the upper list adds it to the default "Selection" subset.

Adding markers to a new or existing subset

If one or more markers are selected in the upper list, and then right-clicked on, a menu will appear with option "Add to Set".

Choosing "Add to Set" will bring up a dialog box in which the name of a new or existing subset can be input. Here we type the name of a new marker subset "Custom" into the dialog box.

The markers are copied to the new subset with name "Custom":

Adding markers to an existing subset - shortcut

If you wish to add new markers to an existing subset, you can avoid having to type in its name again in the dialog box by first selecting the target subset in the lower pane. Then right-click on a selection of markers above. The name of the existing subset will appear in the "Add to Set" dialog.

Subset manipulations

Right-clicking on a subset brings up a menu with options described above in the lower-pane controls section.

Individual markers can also be selected and removed from a subset by a right-click menu.

Create a new set

The New button creates a new set (group), which in turn can be used to contain a different arrangement of subsets.

Here the Set pulldown menu shows the newly created new Set.