Operations field

In the Operations Field (D in the figure described in the section organization of genexplain platform ) a number of essential functions to operate the geneXplain platform are provided on a number of tabs. How many and which tabs are shown depends very much on the context.

Please note that not all tabs are always visible due to space constraints. In these cases, double arrowheads left and right of the tabs indicate that there are additional ones, reachable by clicking on these double arrowheads

_images/image006.png

The function of the individual tabs will be explained in more detail in those sections where their effect is part of a certain operation. In general, the icon _images/fc66a907dd4b019161a894cdb645178e.jpg initiates the corresponding activity within the Operations Field, whereas _images/3e53735d232abf5ba7b39eb6bcde6a8f.jpg applies to the results generated in the Operations Field of the Work Space.

Changing the table structure in the Operations Field

Having opened a table in the Work Space, e.g. by double clicking on its name in the Tree Area, it is possible to edit its structure in the Operations Field under the tab Columns. For instance, if you have opened a table with data about Enrichment GO Molecular Mechanism (resulting from having run a GSEA), this field may look like this

_images/image007.png

Recognizably, you can change the column headers, the data type in the column, or its (usually hidden) descriptions. You may add an Expression, which may be a mathematical formula, formulated in Java script; you find detailed explanations for this when you press the Edit key next to this field. In the last column, you can specify which columns are visible or shall be hidden (unmarking a column here does NOT delete it, it hides it from the currently displayed table).

If you hide a column by unmarking it, you have to refresh the Work Space by pressing the Refresh button in the control panel right on top of the Operations Field. Here, you can also add new (_images/034fae9358d6455d89ae62fd4b1b04bd.jpg) columns. Before removing a column with the button _images/381ac2058d3640e12b44bfaef9665e4d.jpg, you have to mark it by clicking somewhere in the background of the line specifying this column; the selected item will be highlighted in blue.

But be careful: Deleting it from the table will irrevocably erase the column including all its contents!

Changing the layout

Under the Layout tab, you can change the layout of the diagram. First, you can select one of the following layout schemes:

  • Hierarchical layout (default)
  • Orthogonal layout
  • Force directed layout
  • Cross cost grid layout
  • Grid layout

When you have selected another layout type, you have to press the “Prepare layout” button (_images/5b7a46bddb8c68dbe4093ccda986e4e2.emf), showing the new layout at the right of the same window in the Operation Field. Pressing “Apply layout” transfer the new layout to the Work Space.

Here are examples how the different layouts look like; the example is the Caspase 12 pathway and has been taken from the database Integrated models (Int_casp12_module12): _images/image008.pngHierarchical layout _images/image009.png _images/image010.png _images/image011.png _images/image012.png

Some of the re-layouting options may take considerable time. If you want to interrupt the process, press the “Stop layout” button.

The layout that has been applied to the Work Space can be further edited manually. A single click on a node (component or reaction node) highlights it; it can be shifted now by mouse movement, or can be deleted (right mouse button click opens a context menu with the option “Remove”). The results of this manual editing can be saved to the Operation Field so that they will be retained for the following work.

Please, be careful: changes in your own diagrams are automatically saved! You can even close the diagram in the Work Space, but still can undo your last changes with the Undo button (_images/15c815409342eea72cc3dcc2b4a3a729.jpg). After logout, all your changes will be automatically fixed.

Further editing of the layout schemes can be done by parameter settings in the Operation Field, Layout tab.

Expression Mapping

This function enables highlighting of up-regulated and down-regulated genes in the network diagrams.

The Expression mapping tab can be found in the Operations Field after having a network diagram opened in the work area. Initially, the expression mapping form is empty as shown in the figure below.

_images/15a02272b80c55241969f933009aa852.png

First, drag and drop the table with expression data from the Tree Area over the diagram. You might be interested to use the table with identified differentially expressed genes and calculated fold change values for expression mapping.

Important note. The format of the table with expression data that can be used depends on the format of the diagram. If the diagram was constructed based on the TRANSPATH® database, the format of the table to drag and drop should be “Proteins: Transpath peptides”, and the table should have the symbol _images/89c7830ace79b222186c5cf0821d31c2.jpg

If the diagram was constructed based on the GeneWays database, the format of the table to drag and drop should be “Genes: Entrez”, and the table should have the symbol _images/f72f0003eb6573163575aa494c050331.jpg

Please check the format of the table with expression data before dragging and dropping it over the diagram, and if necessary, convert it to the required format with the function “Convert table” that can be found at the analyses/Methods/Data manipulation/Convert table.

After the table with expression data is dragged and dropped, the up- and down-regulated genes are automatically highlighted, and the expression mapping tab looks as shown below:

_images/fa48c514e6b40bc7c27e9330ade289ee.png

Let’s consider the main options/fields of the expression mapping form.

The default type of mapping is “outside fill”, and the corresponding check-box is checked, highlighted by the red oval below.

_images/1735141da2b7a8991bfa736bc5abb7e3.png

If the selected table contains a column LogFoldChange, this column is automatically chosen in the field “Columns”, highlighted by the green oval above. Other numerical columns in the selected table are available under the drop-down menu, and can be chosen instead of the default column to be applied for mapping expression data.

The fields Minimum value and Maximum value display the corresponding values of the selected column with expression data, (see highlighted red ovals in the figure below). These values are used to calculate the intensity of the colors for expression.

_images/2a88f4687076ff72c2fba946e13467cc.png

You can select colors to indicate up- and down-regulation by mouse click over the colored boxes, and the following toolbox will be displayed.

_images/9d6af9fbba84e3cbdc3a0bdbcf62cb18.png

The expression values can be inferred by the color gradation. A more intensive color corresponds to a bigger fold change value whereas the lighter shade corresponds to a smaller fold change value. In this example all the up-regulated genes are shown with a color gradient from white to red whereas down-regulated genes are shown in with a color gradient from white to blue.

Check-in the box Use inside fill and check-out the box Use outside fill result in the following picture.

_images/1b9963f9f9cd803fcf3f06befe2f9ea5.png