Difference between revisions of "Marker Sets"

(Marker Sets (Context))
 
(73 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{TutorialsTopNav}}
 
{{TutorialsTopNav}}
  
==Overview==
+
==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.
+
The Markers/Arrays component, located at lower left in the geWorkbench graphical interface, allows the user to define and use sets of arrays and markers for a number of purposes.
  
This section discusses the use of subsets of markers. Please see the chapter [[Data_Subsets_-_Arrays | Data Subsets - Arrays]] for a discussion of the use of Array sets.
+
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.
  
In geWorkbench, term marker, includes genes, probes/probesets, and individual sequences, depending on the type of data loadedSets of markers can be returned as the results of various analysis routines.
+
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 takengeWorkbench uses the terms "Case" and "Control" to categorize these, but in biological setting the equivalent would be "Experimental" vs "Control".
  
 +
This chapter discusses the use of sets of markers.  Please see the chapter [[Array_Sets | Array_Sets]] for a discussion of the use of Array sets.
  
==Section under construction==
+
The figure below shows the Markers component located below the [[Workspace]] component in geWorkbench.  The [[Array_Sets|Arrays]] component is located in the same space, under the adjacent tab.
  
[[Image:T_Markers_basic_withProj.png]]
 
  
[[Image:T_Markers_basic.png]]
+
[[Image:Markers_Sets_Bcell-100.png]]
  
[[Image:T_Arrays_basic.png]]
+
==Common Principles of Operation of Marker and Array Sets==
  
[[Image:T_Arrays_basic_withProj.png]]
+
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.
  
[[Image:T_Marker_SelectionSet.png]]
+
===Activating Sets of Markers and Arrays===
 +
In the Markers and the Arrays components, sets of markers and arrays can be defined by the user.  Such sets are also created as the outcome of various analysis methods.  Adjacent to each set in the graphical interface is a checkbox.  Checking this box '''activates''' the subset. 
 +
 
 +
* '''Activating''' a set restricts many geWorkbench components to using as input only the markers or arrays that are in one or more such activated sets.
 +
 
 +
* '''Marker Sets'''
 +
** If no Marker set is active, all Markers are used.
 +
** If at least one Marker set is activated, affected components will only use markers that are in activated sets.
 +
* '''Array Sets'''
 +
** If no Array set is active, all Arrays are used.
 +
** If at least one Array set is activated, affected components will only use arrays that are in activated sets.
 +
 
 +
* '''Selection''' set - this is a special, default set.  One is present in both the Markers component and the Arrays component.  The "Selection" set has the following properties:
 +
** Double-clicking on a marker or array entry in the upper pane list will add that entry to the default "Selection" set.  Double-clicking the same entry again will remove it from the default set.
 +
** The "Selection" set cannot be deleted.
 +
 
 +
===Number of members displayed===
 +
The number of members in a set is given inside square brackets just to the right of the set name.
 +
 
 +
 
 +
==Upper Pane Controls==
 +
 
 +
[[Image:Markers_Upper_RightClickMenu.png]]
 +
 
 +
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===
 +
Search for markers by typing a portion of a gene name or descriptive term into the Search box. As each character is typed, the list is dynamically updated to contain only entries containing matches to the query so far.  The match can occur anywhere in the name or description.
 +
 
 +
For example, here "dod" has been entered, and only the two markers containing "dod" either in their gene symbol or description are displayed.
 +
 
 +
 
 +
[[Image:Markers_Search_example.png]]
 +
 
 +
===Light Bulb icon===
 +
[[Image:T_Arrays_lightbulb.png]] - when activated [[Image:T_Markers_lightbulb_active.png]], enables "hover text" display of marker information including marker id, plus gene name and description if available (from annotation file).
 +
 
 +
===Double-click action===
 +
* Double-clicking with the mouse on a marker name will add that marker to the default "Selection" set. 
 +
* Double-clicking on the same entry again will remove it from the "Selection" set. 
 +
* More generally, for any marker in the "Selection" set, double-clicking on its entry in the upper list will remove it from the set.
 +
 
 +
 
 +
[[Image:Marker_SelectionSet.png]]
 +
 
 +
===Right-click menu===
 +
Selecting one or more markers in the list and then right-clicking gives the following choices in a pop-up menu:
 +
 
 +
====Add to Set====
 +
Selected markers can be added to a new or to an existing set.
 +
 
 +
 
 +
[[Image:Markers_AddToSet.png]]
 +
 
 +
 
 +
A shortcut for adding markers to an existing set is covered in the next section.
 +
 
 +
When "Add to Set" is clicked, a dialog box will appear asking for the name of the set.  Enter the name of a new or existing set.
  
[[Image:T_Marker_SelectionSet.png]]
 
  
 
[[Image:T_Markers_Set_Label.png]]
 
[[Image:T_Markers_Set_Label.png]]
  
[[Image:T_Markers_RightClickMenu.png]]
 
  
[[Image:T_Markers_RightClickMenu_Marker.png]]
+
The markers are copied to the new set. Here we used the name "Custom":
 +
 
 +
 
 +
[[Image:Markers_AddToSetCustom.png]]
 +
 
 +
====Add to Set (Existing)====
 +
You can add markers to an existing set by either
 +
* entering the name of the existing set in the popup dialog box, or
 +
* before right-clicking on the selected markers, first highlight the desired marker set in the lower list.  Its name will then be pre-entered into the Add to Set dialog.
 +
 
 +
 
 +
[[Image:Markers_AddToSetAgain.png]]
 +
 
 +
====Clear Selection====
 +
Clear the contents of the default "Selection" marker set.
 +
 
 +
 
 +
====Sort Markers====
 +
Markers are by default displayed in the same order as the appear in the file from which they were loaded.
 +
 
 +
The list of markers can be sorted by:
 +
* '''gene name'''
 +
* '''probeset id'''
 +
* '''into the original order''' - the order of the markers as loaded from the original data file.
 +
 
 +
==Lower Pane Controls==
 +
 
 +
===Marker Sets (Context)===
 +
 
 +
[[Image:Marker_Sets_new_context.png]]
 +
 
 +
 
 +
* '''Pulldown menu''' - A list of marker set contexts.  Each context can contain different sets of markers.  All components will make use of the currently selected context.  If an analysis returns a marker set as a result, it is returned to the current marker set context.  Different contexts can be used to organize markers at different levels of detail, or different types of analyses.
 +
* '''New''' - This button will create a new, empty marker set context.
 +
 
 +
 
 +
A popup will ask for a name for the new context:
 +
 
  
 
[[Image:T_Markers_New_Marker_Set.png]]
 
[[Image:T_Markers_New_Marker_Set.png]]
  
[[Image:T_Marker_Sets_Avail.png]]
+
 
 +
 
 +
The new context will appear in the menu, with only the default "Selection" set as a member.
 +
 
 +
 
 +
[[Image:Marker_Sets_New_List.png]]
 +
 
 +
===Load Set===
 +
Load a list of marker ids (probeset ids) from a file on disk. The file should contain a single marker id per line.  The list of marker ids will be saved to a new marker set, with the same name as the file from which it was loaded.
 +
 
 +
===Load by Symbols===
 +
Load a list of gene symbols from a file on disk, with each line containing a entry.  If an annotation file has been loaded which maps gene symbols to marker ids, this mapping will be used to convert the gene symbols into a standard set of marker ids.  The list of marker ids will be saved to a new set, with the same name as the file from which it was loaded.
 +
 
 +
===Right-click menu===
 +
If you right-click on a set, a menu with the choices described in the following section appears:
 +
 
 +
 
 +
[[Image:Marker_Sets_Right_Click_menu.png]]
 +
 
 +
 
 +
====Rename====
 +
Rename the selected set.
 +
 
 +
====Copy====
 +
Make a copy of the selected set.
 +
 
 +
====Activate====
 +
Activate the selected set (see explanation [[Marker_Sets#Activating_Sets_of_Markers_and_Arrays | above]]).  This will set the check-box in front of the set name to checked.
 +
 
 +
Activating a set can also be done directly by checking the check box before its name.
 +
 
 +
 
 +
[[Image:Marker_Sets_set_activated.png]]
 +
 
 +
====Deactivate====
 +
Deactivate the selected set (see explanation [[Marker_Sets#Activating_Sets_of_Markers_and_Arrays | above]]).  Deactivating a set can also be done directly by unchecking the check box before its name.
 +
 
 +
 
 +
====New Set====
 +
Create a new empty marker set.
 +
 
 +
====Delete====
 +
Delete the selected set.
 +
 
 +
 
 +
====Combine====
 +
Combine two or more selected sets into a new set.  Methods are:
 +
* '''Union''' - Include all markers that appear in one or more of the selected sets.
 +
* '''Intersection ''' - Include only markers that are present in each of the selected sets.
 +
* '''XOR''' - Include markers that are present in one and only one of the selected sets.  Note that this usage differs from the logic gate XOR function.
 +
 
 +
====Print====
 +
Print the names of the markers contained in the selected set(s) to a printer.
 +
 
 +
====Visual Properties====
 +
Change the color and shape of points representing markers in graphical components, e.g. in the Scatter Plot.
 +
 
 +
Selecting the "Visual Properties" menu item, causes a properties editor to appear. In it, the shape and color of points representing markers in various geWorkbench graphical components can be globally altered.
 +
 
 +
[[Image:Arrays_Change_visual_properties.png]]
 +
 
 +
 
 +
The color chooser:
 +
 
 +
[[Image:Arrays_Change_visual_properties_choose_color.png]]
 +
 
 +
 
 +
The shape chooser:
 +
 
 +
[[Image:Arrays_Change_visual_properties_choose_shape.png]]
 +
 
 +
 
 +
Chooser showing selection of a green "plus" shape to represent the marker set.
 +
 
 +
[[Image:Markers_Change_visual_properties_blue_oval.png]]
 +
 
 +
 
 +
After the visual properties of a marker set have been altered, we can view the markers appearance in, for example, the Scatter Plot component. 
 +
 
 +
 
 +
[[Image:Markers_Change_visual_properties_scatter_plot.png]]
 +
 
 +
====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 are present in the Cytoscape network display will be highlighted yellow.
 +
 
 +
 
 +
====Save====
 +
Save the chosen set of markers as a simple list (CSV format, one marker per line) to a file on disk. 
 +
 
 +
If more than one marker set is highlighted, two choices are offered:
 +
* '''Merge into one set''' - The markers in all highlighted sets are merged into a single list and written out to a file.  A file browser window appears that allows the user to specify the location and name of the new file.
 +
* '''Save as multiple sets''' - Each highlighted marker set will be saved to a separate file, using the set name as the new file name.  A file browser will appear which will allow the user to specify where to save the new files.
 +
 
 +
 
 +
[[Image:Marker_Sets_Save_Multiple.png]]
 +
 
 +
===Removing a marker from a set===
 +
 
 +
One or more markers can be removed from a set by highlighting them and then right-clicking.  A menu will appear with option "Remove from Set". 
 +
 
 +
 
 +
[[Image:T_Markers_RightClickMenu_Marker.png]]

Latest revision as of 14:58, 23 April 2014

Home | Quick Start | Basics | Menu Bar | Preferences | Component Configuration Manager | Workspace | Information Panel | Local Data Files | File Formats | caArray | Array Sets | Marker Sets | Microarray Dataset Viewers | Filtering | Normalization | Tutorial Data | geWorkbench-web Tutorials

Analysis Framework | ANOVA | ARACNe | BLAST | Cellular Networks KnowledgeBase | CeRNA/Hermes Query | Classification (KNN, WV) | Color Mosaic | Consensus Clustering | Cytoscape | Cupid | DeMAND | Expression Value Distribution | Fold-Change | Gene Ontology Term Analysis | Gene Ontology Viewer | GenomeSpace | genSpace | Grid Services | GSEA | Hierarchical Clustering | IDEA | Jmol | K-Means Clustering | LINCS Query | Marker Annotations | MarkUs | Master Regulator Analysis | (MRA-FET Method) | (MRA-MARINa Method) | MatrixREDUCE | MINDy | Pattern Discovery | PCA | Promoter Analysis | Pudge | SAM | Sequence Retriever | SkyBase | SkyLine | SOM | SVM | T-Test | Viper Analysis | Volcano Plot


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 sets 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 terms "Case" and "Control" to categorize these, but in biological setting the equivalent would be "Experimental" vs "Control".

This chapter discusses the use of sets of markers. Please see the chapter Array_Sets for a discussion of the use of Array sets.

The figure below shows the Markers component located below the Workspace component in geWorkbench. The Arrays component is located in the same space, under the adjacent tab.


Markers Sets Bcell-100.png

Common Principles of Operation of Marker and Array Sets

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 Sets of Markers and Arrays

In the Markers and the Arrays components, sets of markers and arrays can be defined by the user. Such sets are also created as the outcome of various analysis methods. Adjacent to each set in the graphical interface is a checkbox. Checking this box activates the subset.

  • Activating a set restricts many geWorkbench components to using as input only the markers or arrays that are in one or more such activated sets.
  • Marker Sets
    • If no Marker set is active, all Markers are used.
    • If at least one Marker set is activated, affected components will only use markers that are in activated sets.
  • Array Sets
    • If no Array set is active, all Arrays are used.
    • If at least one Array set is activated, affected components will only use arrays that are in activated sets.
  • Selection set - this is a special, default set. One is present in both the Markers component and the Arrays component. The "Selection" set has the following properties:
    • Double-clicking on a marker or array entry in the upper pane list will add that entry to the default "Selection" set. Double-clicking the same entry again will remove it from the default set.
    • The "Selection" set cannot be deleted.

Number of members displayed

The number of members in a set is given inside square brackets just to the right of the set name.


Upper Pane Controls

Markers Upper RightClickMenu.png

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

Search for markers by typing a portion of a gene name or descriptive term into the Search box. As each character is typed, the list is dynamically updated to contain only entries containing matches to the query so far. The match can occur anywhere in the name or description.

For example, here "dod" has been entered, and only the two markers containing "dod" either in their gene symbol or description are displayed.


Markers Search example.png

Light Bulb icon

T Arrays lightbulb.png - when activated T Markers lightbulb active.png, enables "hover text" display of marker information including marker id, plus gene name and description if available (from annotation file).

Double-click action

  • Double-clicking with the mouse on a marker name will add that marker to the default "Selection" set.
  • Double-clicking on the same entry again will remove it from the "Selection" set.
  • More generally, for any marker in the "Selection" set, double-clicking on its entry in the upper list will remove it from the set.


Marker SelectionSet.png

Right-click menu

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

Add to Set

Selected markers can be added to a new or to an existing set.


Markers AddToSet.png


A shortcut for adding markers to an existing set is covered in the next section.

When "Add to Set" is clicked, a dialog box will appear asking for the name of the set. Enter the name of a new or existing set.


T Markers Set Label.png


The markers are copied to the new set. Here we used the name "Custom":


Markers AddToSetCustom.png

Add to Set (Existing)

You can add markers to an existing set by either

  • entering the name of the existing set in the popup dialog box, or
  • before right-clicking on the selected markers, first highlight the desired marker set in the lower list. Its name will then be pre-entered into the Add to Set dialog.


Markers AddToSetAgain.png

Clear Selection

Clear the contents of the default "Selection" marker set.


Sort Markers

Markers are by default displayed in the same order as the appear in the file from which they were loaded.

The list of markers can be sorted by:

  • gene name
  • probeset id
  • into the original order - the order of the markers as loaded from the original data file.

Lower Pane Controls

Marker Sets (Context)

Marker Sets new context.png


  • Pulldown menu - A list of marker set contexts. Each context can contain different sets of markers. All components will make use of the currently selected context. If an analysis returns a marker set as a result, it is returned to the current marker set context. Different contexts can be used to organize markers at different levels of detail, or different types of analyses.
  • New - This button will create a new, empty marker set context.


A popup will ask for a name for the new context:


T Markers New Marker Set.png


The new context will appear in the menu, with only the default "Selection" set as a member.


Marker Sets New List.png

Load Set

Load a list of marker ids (probeset ids) from a file on disk. The file should contain a single marker id per line. The list of marker ids will be saved to a new marker set, with the same name as the file from which it was loaded.

Load by Symbols

Load a list of gene symbols from a file on disk, with each line containing a entry. If an annotation file has been loaded which maps gene symbols to marker ids, this mapping will be used to convert the gene symbols into a standard set of marker ids. The list of marker ids will be saved to a new set, with the same name as the file from which it was loaded.

Right-click menu

If you right-click on a set, a menu with the choices described in the following section appears:


Marker Sets Right Click menu.png


Rename

Rename the selected set.

Copy

Make a copy of the selected set.

Activate

Activate the selected set (see explanation above). This will set the check-box in front of the set name to checked.

Activating a set can also be done directly by checking the check box before its name.


Marker Sets set activated.png

Deactivate

Deactivate the selected set (see explanation above). Deactivating a set can also be done directly by unchecking the check box before its name.


New Set

Create a new empty marker set.

Delete

Delete the selected set.


Combine

Combine two or more selected sets into a new set. Methods are:

  • Union - Include all markers that appear in one or more of the selected sets.
  • Intersection - Include only markers that are present in each of the selected sets.
  • XOR - Include markers that are present in one and only one of the selected sets. Note that this usage differs from the logic gate XOR function.

Print

Print the names of the markers contained in the selected set(s) to a printer.

Visual Properties

Change the color and shape of points representing markers in graphical components, e.g. in the Scatter Plot.

Selecting the "Visual Properties" menu item, causes a properties editor to appear. In it, the shape and color of points representing markers in various geWorkbench graphical components can be globally altered.

Arrays Change visual properties.png


The color chooser:

Arrays Change visual properties choose color.png


The shape chooser:

Arrays Change visual properties choose shape.png


Chooser showing selection of a green "plus" shape to represent the marker set.

Markers Change visual properties blue oval.png


After the visual properties of a marker set have been altered, we can view the markers appearance in, for example, the Scatter Plot component.


Markers Change visual properties scatter plot.png

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 are present in the Cytoscape network display will be highlighted yellow.


Save

Save the chosen set of markers as a simple list (CSV format, one marker per line) to a file on disk.

If more than one marker set is highlighted, two choices are offered:

  • Merge into one set - The markers in all highlighted sets are merged into a single list and written out to a file. A file browser window appears that allows the user to specify the location and name of the new file.
  • Save as multiple sets - Each highlighted marker set will be saved to a separate file, using the set name as the new file name. A file browser will appear which will allow the user to specify where to save the new files.


Marker Sets Save Multiple.png

Removing a marker from a set

One or more markers can be removed from a set by highlighting them and then right-clicking. A menu will appear with option "Remove from Set".


T Markers RightClickMenu Marker.png