Difference between revisions of "iRefScape plugin menu"

From irefindex
m (moved README Cytoscape plugin menu to iRefScape plugin menu: Using the actual name of the plugin. This makes it easier to find the page in the category, too.)
 
(24 intermediate revisions by 2 users not shown)
Line 17: Line 17:
 
This option resets the i.alive_degree of nodes.  i.alive_degree provides how many nodes with a certain attribute type is connected to each node (set using filters).  
 
This option resets the i.alive_degree of nodes.  i.alive_degree provides how many nodes with a certain attribute type is connected to each node (set using filters).  
  
==Loading user variables (this section is being edited)==
+
===Load user variables===
User variables can be attached to nodes and be browsed using the attribute browser. This file can not be used as a searchable index (can not be used as a search type). please see section XXX  for details on searchable indices.   
+
 
 +
{{Note|
 +
This section is being updated.
 +
}}
 +
 
 +
User variables can be attached to nodes and be browsed using the attribute browser. This file can not be used as a searchable index (can not be used as a search type). Please see section [[#iRefScape_user_searchable_index|iRefScape user searchable index]] for details on searchable indices.   
  
 
There are three ways to load own variables for the user.  
 
There are three ways to load own variables for the user.  
#Use the  Cytoscape attribute loading feature ([http://cytoscape.org/manual/Cytoscape2_8Manual.html#Node%20and%20Edge%20Attributes '''Cytoscape manual'''])
+
#Use the  Cytoscape attribute loading feature ([http://cytoscape.org/manual/Cytoscape2_8Manual.html#Node%20and%20Edge%20Attributes Cytoscape manual])
 
#Use a use attribute file with iRefScape (described in this section)
 
#Use a use attribute file with iRefScape (described in this section)
#Include the attribute with the batch search file.(described in XXX).
+
#Include the attribute with the batch search file. (Described in the section [[#Attribute_batch_file|Attribute batch file]].)
  
The iRefScape user attribute loader is provided as a complementing feature to the Cytoscape node attribute loading ([http://cytoscape.org/manual/Cytoscape2_8Manual.html#Node%20and%20Edge%20Attributes '''Cytoscape manual''']). For most of the attribute loading operations the Cytoscape node attribute loader is sufficient and easier to use. However, when the iRefScape node attribute file is used, this can be used by just using the menu entry XXX. In addition the file will be available for subsequent operations.
+
The iRefScape user attribute loader is provided as a complementing feature to the Cytoscape node attribute loading ([http://cytoscape.org/manual/Cytoscape2_8Manual.html#Node%20and%20Edge%20Attributes Cytoscape manual]). For most of the attribute loading operations the Cytoscape node attribute loader is sufficient and easier to use. However, when the iRefScape node attribute file is used, this can be used by using the menu entry iRefScape-> Search tools > Load user variables. In addition the file will be available for subsequent operations.
  
===iRefScape user variable file format===
+
====iRefScape user variable file format====
 
The first line of the file provides instructions and this line is compulsory.
 
The first line of the file provides instructions and this line is compulsory.
 
  Example.  
 
  Example.  
 
  #i.rog New_attribute
 
  #i.rog New_attribute
 
  
 
The first line always starts with a hash ("#") and immediately followed by the iReFscape  variable name. This iRefScape variable name is used to locate the nodes via the new attribute will be attached. Then a tab is used as a column separator, followed by the name of the user attribute name.This user attribute name should be unique( not already used). In the above example the user attribute to use is the i.rog and the user attribute name is "New_attribute".
 
The first line always starts with a hash ("#") and immediately followed by the iReFscape  variable name. This iRefScape variable name is used to locate the nodes via the new attribute will be attached. Then a tab is used as a column separator, followed by the name of the user attribute name.This user attribute name should be unique( not already used). In the above example the user attribute to use is the i.rog and the user attribute name is "New_attribute".
Line 54: Line 58:
 
  561552 TENC1|UniProtKB:Q63HR2-4|
 
  561552 TENC1|UniProtKB:Q63HR2-4|
 
  534065 GFI1B_MOUSE|UniProtKB:O70237|
 
  534065 GFI1B_MOUSE|UniProtKB:O70237|
 
==iRefScape search with batch file==
 
When there are many search queries, it is convenient to construct a batch file and load this to iRefScape. There are 3 type of batch files;
 
#Simple batch file (recommended for users just wanting to search for a list of things)
 
#Attribute batch file (Attach additional attributes)
 
#User index batch file (please refer XXX)
 
 
=== Simple batch file ===
 
 
Example file content:
 
#geneID:3702
 
814707
 
814714
 
814714
 
817659
 
818662
 
 
*The first line starts with a hash ("#") and this line is compulsory.
 
*Immediately after the hash (no space in between) the iRefScape attribute name should be provided. Please see below for accepted list of identifier with the corresponding label.
 
 
{| {{table}}
 
| align="center" style="background:#f0f0f0;"|'''Label to use in the batch file'''
 
| align="center" style="background:#f0f0f0;"|'''Description'''
 
| align="center" style="background:#f0f0f0;"|''''''
 
| align="center" style="background:#f0f0f0;"|''''''
 
| align="center" style="background:#f0f0f0;"|''''''
 
|-
 
| rog||iROGID, the integer reference redundant object group identifier([http://irefindex.uio.no/wiki/Protein_identifier_mapping \'\'\'details of mapper files to locate the iRGOID can be found here)\'\'\']||||||
 
|-
 
| geneID||NCBI Gene ID, this is always an integer||||||
 
|-
 
| UniProt_Ac||UniProt/KB accession||||||
 
|-
 
| RefSeq_Ac||RefSeq Accession||||||
 
|-
 
| UniProt_ID||UniProt identifier||||||
 
|-
 
| geneSymbol||NCBI Gene symbol||||||
 
|-
 
| PMID||PubMed identifier ||||||
 
|-
 
| src_intxn_id||Interaction identifiers used by source databases||||||
 
|-
 
| omim||OMIM identifier ([http://www.ncbi.nlm.nih.gov/omim \'\'\'OMIM home page\'\'\'])||||||
 
|-
 
| digid||diseases group identifier ([http://irefindex.uio.no/wiki/DiG:_Disease_groups \'\'\'DiG home page\'\'\'])||||||
 
|-
 
|
 
|}
 
 
<!--
 
==Only variables==
 
Users can load there own variables for proteins which are mapped to a ROGID. The file should follow the format given below;
 
#Should be a plain text file with exactly two columns and each line ending with a new line character (pressing enter).
 
#First column should contain the ROGID
 
#Second column should contain the user attribute/variable.
 
#The file name should have the format _rog_'''USER_VARIABLE_NAME'''.iruv (The text in bold is supplied by the user.  e.g., _rog_myAttribute.iruv ).
 
 
<pre>
 
e.g
 
#rog USER_VARIABLE
 
j4H4IZH/ecTvEDjCel+eLTCmFyE9606 1
 
j4H4IZH/ecTvEDjCel+eLTCmFyE9606 1
 
q6/pRFyay7gQ6bb2rzvKYgfkeaE9606 2
 
8sODZSppCsuEgRmhSHp3UjwOf2M9606 3
 
obze7v7i2yTIIcJjd7laIriNFg89606 4
 
Ty0OLkmhoUPjUuLQQv5ykN057oM9606 5
 
4bhW4sEt1YhYwHnHCyDNV3vvThs9606 6
 
Al8M+JdB4H+QnwITh8KcicdI2x49606 6
 
rkL/SGL1Enj6KoFkPbbcoJ5vKJE9606 6
 
 
</pre>
 
-->
 
 
== iRefScape user searchable index ==
 
Users can construct their own indices to be used as search type. The easiest way to include a index is to use the advanced batch file mode. This process will;
 
#Find the iROGID for the user variable
 
#Construct searchable index.
 
 
The example shown below constructs an index, where the user can perfume search using the Noonan syndrom type.
 
Example indexable batch file
 
#geneSymbol:9606:NOONAN_SYNDROME_TYPE
 
PTPN11 NS1
 
SHOC2 NS2
 
KRAS NS3
 
SOS1 NS4
 
RAF1 NS5
 
NRAS NS6
 
NF1 NFNS
 
 
#The first line is compulsory and contains controlling information. the fist value after the hash ('#') is the iRefindex attribute type to be used(please see xxx for attribute types). The second value is the NCBI taxonomy identifier ([http://www.ncbi.nlm.nih.gov/Taxonomy/taxonomyhome.html/ '''NCBI taxonomy browser''']). The third value is the name of the user attribute. All three values are seperated by a colon ":".
 
 
The data rows should always be two columns, where the columns are separated by a tab. The first value in a data row is the search string (what should be used to search iRefIndex). The values in the first column will appear in the search box at the end of the operation. The second column contains the user attribute.
 
 
 
 
The attribute do not appear as a separate attribute, but should instead look in the i.query field.
 
  
 
==View tools==
 
==View tools==
Line 172: Line 79:
 
Some complexes are represented as a set of binary interactions by some sources. This action attempts to highlight such complexes as a single unit by attaching them all to a single pseudonode.  
 
Some complexes are represented as a set of binary interactions by some sources. This action attempts to highlight such complexes as a single unit by attaching them all to a single pseudonode.  
  
 +
== Grouping ==
 +
 +
=== Reset group ===
 +
This action clears any groups created for a pairwise comparison or presentation of nodes.
 +
 +
=== Set group=1 for selection ===
 +
This adds the selected nodes to the first group of nodes in a comparison operation.
 +
 +
=== Set group=2 for selection ===
 +
This adds the selected nodes to the second group of nodes in a comparison operation.
 +
 +
=== Create comparison table ===
 +
With two groups defined using the above operations, this action causes a table to be displayed showing the first group of nodes across the top of the table (as column headings) and the second group of nodes down the side of the table (as row headings). In the body of the table, each cell situated in a particular location (defined in terms of a particular column and row) represents one or more nodes that connect the node featured in the heading for the cell's column with the node featured in the heading for the cell's row.
  
 
==Hide/Un-hide==
 
==Hide/Un-hide==
Line 191: Line 111:
  
 
==Safe mode==
 
==Safe mode==
This option is only available when using JAVA 1.5 and will not appear for Java 1.6 or newer. Selecting this will un-dock the iRefScape window and handles errors and exceptions thrown due to bugs in JAVA 1.5. When this mode is activated not all graphic features will be available.
+
This option is only available when using Java 1.5 and will not appear for Java 1.6 or newer. Selecting this will un-dock the iRefScape window and handles errors and exceptions thrown due to bugs in Java 1.5. When this mode is activated not all graphic features will be available.
 
 
 
 
 
 
 
 
  
 
== All iRefIndex Pages ==
 
== All iRefIndex Pages ==

Latest revision as of 15:45, 6 July 2011

Search tools

Retrieve interactions for the selected nodes

To load all protein-protein interactions and complexes involving one or more selected nodes. This action is the same as performing a iteration=1 search using iRefScape for the selected nodes.

Expand one level

To load all protein-protein interactions and complexes involving at least one of the nodes in the current network. The behaviour is same as performing iteration=1 search using iRefScape for all the nodes.

Load interactions between neighbours

To complete the interactions between the currently loaded nodes. When a search & load operation is performed in iRefScape, the network returned contains all the proteins interacting with the query and the corresponding interactions. This does not return interactions between the neighbours of the query. This operation is the same as performing an iteration=0 search using iRefScape for all the nodes. This action has no effect for networks for which this operation has already been performed using the option presented at the end of the search.

Clear load history (Reload everything next time)

This will clear the iRefScape cache memory containing currently loaded nodes and edges. IRefScape keeps track of what is loaded to avoid reloading and thus increase efficiency. Therefore, if a search is performed twice,the network will not be re-loaded unless the user has requested that results be shown in a new view or they have selected this menu option. If the user wishes to reload the network then this option has to be used. When using other methods of expanding the network like “Expand one level” iRefScape handles the cache clearing automatically.

Reset node degree

This option resets the i.alive_degree of nodes. i.alive_degree provides how many nodes with a certain attribute type is connected to each node (set using filters).

Load user variables

NoteNote

This section is being updated.

User variables can be attached to nodes and be browsed using the attribute browser. This file can not be used as a searchable index (can not be used as a search type). Please see section iRefScape user searchable index for details on searchable indices.

There are three ways to load own variables for the user.

  1. Use the Cytoscape attribute loading feature (Cytoscape manual)
  2. Use a use attribute file with iRefScape (described in this section)
  3. Include the attribute with the batch search file. (Described in the section Attribute batch file.)

The iRefScape user attribute loader is provided as a complementing feature to the Cytoscape node attribute loading (Cytoscape manual). For most of the attribute loading operations the Cytoscape node attribute loader is sufficient and easier to use. However, when the iRefScape node attribute file is used, this can be used by using the menu entry iRefScape-> Search tools > Load user variables. In addition the file will be available for subsequent operations.

iRefScape user variable file format

The first line of the file provides instructions and this line is compulsory.

Example. 
#i.rog	New_attribute

The first line always starts with a hash ("#") and immediately followed by the iReFscape variable name. This iRefScape variable name is used to locate the nodes via the new attribute will be attached. Then a tab is used as a column separator, followed by the name of the user attribute name.This user attribute name should be unique( not already used). In the above example the user attribute to use is the i.rog and the user attribute name is "New_attribute".

From the second line onwards, the attributes with the mapping attribute are provided.

Example 
4399398	TENC1|UniProtKB:Q63HR2|

The first column provides the iRefScape attribute to use and the second column provides the user attribute. Multiple attributes should be separated with a pipe ("|"). The example line shown would locate the node with i.rog=4399398 and attach the "TENC1|UniProtKB:Q63HR2|" value to it with the attribute name "New_attribute"

  • Each column is separated by a TAB.
  • Each line ends with a new line character ("\n")
  • The file should be constructed using a plain text editor (e.g. Kate, notepad) and word processing software like Microsoft word should not be used to construct this file.
  • The file extension is ".txt"
  • Sample file "ONE__EXT__ROG_#Name_5_.iruv" can be found in the iRefScape installation directory (iRefIndex directory)
  • The file name should have the format _rog_USER_VARIABLE_NAME.iruv (The text in bold is supplied by the user. e.g., _rog_myAttribute.iruv ).
Sample file
#i.rog	New_name
4399398	TENC1|UniProtKB:Q63HR2|
452957	GFI1B|UniProtKB:Q5VTD9|
561552	TENC1|UniProtKB:Q63HR2-4|
534065	GFI1B_MOUSE|UniProtKB:O70237|

View tools

Toggle selected multi-edges

iRefScape creates multiple edges between nodes to represent multiple evidences. If an interaction between two proteins has evidence from both MINT and IntAct, there will be 2 edges; one for MINT and one for IntAct. Although this provides more information for the user, sometime the user may prefer to collapse these edges to a single edge to facilitate viewing. When this action is performed on a network, all but a randomly selected edge between each node is hidden. The edges which are hidden has the i.flag=1 and the one remaining has i.flag=0. Therefore, while this process is random by default, the user can control which edges to keep and which to hide by editing the i.flag edge attribute before using the toggle multi-edge option.

Zoom to selected

This action brings the selected node(s) to the centre of the screen and makes the nodes as large as possible given that all selected nodes are visible. This action can also be performed manually using Cytoscape's zoom tool.

Select last iRefScape selection

This action shows the last selection performed by an iRefScape operation. This features does not record user selections or selections made by using Cytoscape tools (e.g filters).

Select nodes with different taxid than query node

Some interactions may involve proteins from multiple species. An interaction may truly occur between proteins from two species (e.g. an interaction between a Human protein and a virus protein). In other cases, this may be an artefact of how data was entered by the source database.

Select between nodes

This option highlights (selects) nodes interacting with at least two nodes that have been pre-selected by the user. The node attribute i.alive_degree will be recalculated to reflect the degree of each node with respect to this pre-selection.

Show spoke-represented complexes

Some complexes are represented as a set of binary interactions by some sources. This action attempts to highlight such complexes as a single unit by attaching them all to a single pseudonode.

Grouping

Reset group

This action clears any groups created for a pairwise comparison or presentation of nodes.

Set group=1 for selection

This adds the selected nodes to the first group of nodes in a comparison operation.

Set group=2 for selection

This adds the selected nodes to the second group of nodes in a comparison operation.

Create comparison table

With two groups defined using the above operations, this action causes a table to be displayed showing the first group of nodes across the top of the table (as column headings) and the second group of nodes down the side of the table (as row headings). In the body of the table, each cell situated in a particular location (defined in terms of a particular column and row) represents one or more nodes that connect the node featured in the heading for the cell's column with the node featured in the heading for the cell's row.

Hide/Un-hide

Hide selected nodes

This action hides the selected nodes. This operation is performed in a independent thread and more efficient than hiding using Cytoscape's 'hide node' utility for large networks.

Hide nodes (except pseudonodes)

This action hides all select nodes which represent proteins. This will not hide pseudonodes representing a complex, a collapsed area or a collapsed hub.

Hide nodes not selected

Hides all nodes which are not currently selected

Hide nodes not selected (except pseudonodes)

Hides all nodes which are not currently selected and that represent proteins. This will not hide pseudonodes representing a complex, a collapsed area or a collapsed hub.

Un-hide all

Un-hides all nodes which are hidden by the user.

Safe mode

This option is only available when using Java 1.5 and will not appear for Java 1.6 or newer. Selecting this will un-dock the iRefScape window and handles errors and exceptions thrown due to bugs in Java 1.5. When this mode is activated not all graphic features will be available.

All iRefIndex Pages

Follow this link for a listing of all iRefIndex related pages (archived and current).