last level

Listing

Contents

  1. Description
  2. Usage by Example
  3. Special Tips
top

Description

This plugin will list user-specified information into a table. For example, in an EST annotation pipeline, users would like to list all suspected EST accessions according to their selection. In Fig. 1, the listed EST accessions are of ESTs with molecular function "hydrolase activity" from Skin. For another example, in a microarray experiment, this plugin could list all necessary information like: probe accessions, expression levels, probe gene accessions, descriptions from chip provider (see Fig. 2).
click to enlarge click to enlarge
Fig. 1 Fig. 2

top

Usage by Example

  1. File -> Load, open the file "eFerret.tree"
  2. Plugins -> Listing. A window called "Information listing" will appear.
    click to enlarge
    Fig. 3

  3. To config what kinds of data to be listed, Config -> Config information. A dialog window called "Config listed information" will appear. In this dialog window, there are two lists -- the left one lists all available kinds of nodes to be selected for listing, and the right one lists all kinds of nodes to be listed. In order to list all selected representative nodes, click on "RP" and click the "Add" button. Then "RP" will be added into the right list. You may also double-click on "RP" for adding it.
    click to enlarge
    Fig. 4

  4. Click "Done" button, then a column with column head "RP" will appear. Drag the edge of "RP" column head, the width will be changed.
    click to enlarge
    Fig. 5

  5. Back to GOBU window, Search -> Search GO tree, enter "hydrolase activity", then click "Find" button. Repeat click "Find" button until the GO term "hydrolase activity" is selected.
    click to enlarge
    Fig. 6

  6. This plugin always lists specified information "available" in the user tree; that is, we have to set "Appearance level" to "Representative" (Fig. 6, red cycle) for listing representative nodes related to GO term "hydrolase activity".
  7. To list all representative nodes of function "hydrolase activity" from Skin, click on "Skin" of the user tree (Fig. 7, red cycle), click right mouse button, then select "Information listing" in the popup menu (Fig. 7, blue cycle).
    click to enlarge
    Fig. 7

  8. In the resulting list, double-click on any item will go to corresponding node in the user tree. For example, double-click "Skin-717-1" (Fig. 8, red cycle), then the representative node "Skin-717-1" appears (Fig. 8, blud cycle).
    click to enlarge
    Fig. 8

  9. Sometimes we have information other than accessions to be listed; for example, in a microarray experiment, we may want to list not only up-regulated probes but also detailed information of these probes, e.g. expression levels and description given by chip provider of each probe.
    To do this, this plugin treat the item listed in the first column as the leading role and the rest columns the supporting roles. In other words, the leading role is "annotated" by the supporting roles; that is, the relationship between a leading role and one of its supporting role is a ancestor-descendant relationship.
  10. For example, in a microarray experiment, we organize microarray data as in Fig. 9. It is obviously that the representative nodes better play the leading roles, and P-nodes of types "expression1st", "expression2nd", "expression3rd", "expressionAvg", "GeneID", "GeneSymbol", and "description" play the supporting roles. To have the demanded table listing, it is necessary to arrange the column heads in an appropriate order. In this example, we select Config -> Config Information. In the "Config listed information" dialog window, clear the right list then add all items from the left list to the right list, then click "Done" button (be sure to let "RP" item be the first item in the right list).
    click to enlarge click to enlarge
    Fig. 9 Fig. 10

  11. Click on somewhere of the user tree, click right mouse button, select "Information listing" in the popup menu, then selected information will be listed in the table. It should be noticed that, every leading role will be listed at most once; that is, items in the first-column items will be distinct. A leading role may occupy multiple rows in the table in order to place multiple supporting annotations of one single type. For example, there are many GO annotations (green arrows) belong to mwgzebrafish#02109 in Fig. 11, and six rows (blue rectangle) were used for listing all information related with mwgzebrafish#02109 in Fig. 12.
    click to enlarge click to enlarge
    Fig. 11 Fig. 12

  12. Other functions include:
    1. "Save" button: Save listed information into files (including Excel format).
    2. "Additive" check-box: Additively listing selected information; that is, previously listed information will not be erased while listing newly selected information.

top

Special Tips

  1. (at least for Windows platform) Click any cell of the listing table, and press <ctrl>-A and <ctrl>-C. Now you have copied whole listing content to the clip board. Pressing <ctrl>-V can paste it to programs like Excel or any text editor.
  2. In the config window, you may double-click on the left list for adding items to the right list, and you may also double-click on the right list for removing items.