Differences between revisions 5 and 15 (spanning 10 versions)
← Revision 5 as of 2009-08-03 10:01:26 →
Size: 7824
Editor: asp
Comment:
← Revision 15 as of 2009-09-02 19:35:27 →
Size: 4539
Editor: asp
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
[UNDER CONSTRUCTION] <<TableOfContents(4)>>
Line 3: Line 3:
<<TableOfContents(4)>> == Plugin availability ==
 * From plugin manager: in category ''Network and Attribute I/O''.
 * Source code: http://chianti.ucsd.edu/svn/csplugins/trunk/soc/jgao/IDMapping/
 * Tutorial: http://www.cytoscape.org/cgi-bin/moin.cgi/CyThesaurus_Plugin/ID_Mapping_Examples
Line 15: Line 18:
==== Delimited text file ====
 File format (e.g. http://tinyurl.com/mergesvn/testData/yeast_id_mapping.txt):
  * Each column for one ID type
  * Each row except the first one represents IDs of different types mapping to each other
  * First row contains ID types
  * Multiple IDs are allowed to be contained in one cell (One to many mapping, or IDs of the same type maps to each other). Use special character (e.g., ';', '/', etc, or user defined) to separate IDs. 		 * Delimited text file
  * File format (e.g. http://tinyurl.com/mergesvn/testData/yeast_id_mapping.txt):
   * Each column for one ID type
   * Each row except the first one represents IDs of different types mapping to each other
   * First row contains ID types
  * Multiple IDs are allowed to be contained in one cell (One to many mapping, or IDs of the same type maps to each other). Use special character (e.g., ';', '/', etc, or user defined) to separate IDs.
Line 23: Line 26:
==== PGDB file ====
 * Gene database schema: http://www.bridgedb.org/wiki/GeneDatabaseLayout
 * Gene databases are available at http://bridgedb.org/data/gene_database/ 		 * PGDB file is supported
  * Gene database schema: http://www.bridgedb.org/wiki/GeneDatabaseLayout
  * Gene databases are available at http://bridgedb.org/data/gene_database/
Line 28: Line 31:
==== BioMart web service ====
[[http://www.biomart.org|BioMart]] web service has been utilized to provide ID mapping service in this plugin. 		 * [[http://www.biomart.org|BioMart]] web service has been utilized to provide ID mapping service in this plugin.
Line 31: Line 33:
==== BridgeDb web service ====
Being developed. 		 * [[http://www.bridgedb.org|BridgeDb]] web service is being developed.
Line 34: Line 35:
==== PICR web service ====
Being developed. 		 * [[http://www.ebi.ac.uk/Tools/picr/|PICR - Protein Identifier Cross-Reference Service]] has been integrated.

 * [[http://llama.med.harvard.edu/synergizer/translate/|Synergizer web service]] has been integrated.
Line 41: Line 44:
An inter-plugin communication module was developed to support !CyThesaurus plugin providing ID mapping services to other plugins. It is recommended that other plugins, who need to request ID mapping services from !CyThesaurus, include the package cytoscape-plugins-comm ([[http://chianti.ucsd.edu/svn/csplugins/trunk/soc/jgao/IDMapping/lib/cytoscape-plugins-comm.jar|.jar]], [[http://web.missouri.edu/~jg722/GSoC/cytoscape-plugins-comm-javadoc/|javadoc]], [[http://chianti.ucsd.edu/svn/csplugins/trunk/soc/jgao/PluginsCommunication/|src]]). The following services are supported.
=== Test request ===
Test if the services are available.
{{{
#!java
  String receiver = "CyThesaurus"; // plugin name when passing messages
  String msgType = Message.MSG_TYPE_TEST; // indicate what this message requests for
  String msgId = receiver + System.currentTimeMillis();
  Message msg = new Message(msgId , pluginName, receiver, msgType , null);
  List<ResponseMessage> response = PluginsCommunicationSupport.sendMessageAndGetResponses(msg);
  if (!response.isempty()) {
      // the ID mapping services are available
  }
}}}
=== ID mapping request ===
Request to mapping the IDs of source ID types in one attribute to the target ID types and save in the target attribute
{{{
#!java
  String receiver = "CyThesaurus";
  String msgType = "REQUEST_MAPPING"; // request for ID mapping service
  String msgId = receiver + System.currentTimeMillis();
  Map content = new HashMap();
  content.add("NETWORK_ID", new String[]{"net1", "net2"});
  // or content.add("NETWORK_ID", "net1");
  content.add("SOURCE_ATTR", new String[]{"Attr1", "Attr2"});
  // or content.add("SOURCE_ATTR", "ID");
  content.add("SOURCE_ID_TYPE", new String[]{"Type1","Type2"});
  // or content.add("SOURCE_ID_TYPE", "Type1");
  content.add("TARGET_ATTR", "tgtAttr");
  content.add("TARGET_ID_TYPE", "tgtType");
  
  Message msg = new Message(msgId , pluginName, receiver, msgType , content);
  List<ResponseMessage> response = PluginsCommunicationSupport.sendMessageAndGetResponses(msg);
  if (!response.isempty()) {
      Map content = (Map)response.getContent();
      boolean succ = (Boolean) content.get("SUCCESS");
      String report = (String) content.get("REPORT");
      if (succ) {
          // successfully mapped
          // report contains statistics
      } else {
          // failed
          // report contains error message
      }
  } else {
      // the ID mapping services are unavailable
  }
}}}
=== ID mapping dialog request ===
Request to bring out the ID mapping main dialog
{{{
#!java
  String receiver = "CyThesaurus";
  String msgType = "MAPPING_DIALOG"; // request for ID mapping main dialog
  String msgId = receiver + System.currentTimeMillis();
  Message msg = new Message(msgId , pluginName, receiver, msgType , null);
  List<ResponseMessage> response = PluginsCommunicationSupport.sendMessageAndGetResponses(msg);
  if (!response.isempty()) {
      Map content = (Map)response.getContent();
      boolean succ = (Boolean) content.get("SUCCESS");
      if (succ) {
          // ID mapping was performed successfully
      } else {
          // ID mapping was not performed or failed
      }
  } else {
      // the ID mapping services are unavailable
  }
}}}
=== ID mapping source config dialog request ===
Request to bring out the ID mapping source configuration dialog
{{{
#!java
  String receiver = "CyThesaurus";
  String msgType = "MAPPING_SRC_CONFIG_DIALOG"; // request for ID mapping source configuration dialog
  String msgId = receiver + System.currentTimeMillis();
  Message msg = new Message(msgId , pluginName, receiver, msgType , null);
  List<ResponseMessage> response = PluginsCommunicationSupport.sendMessageAndGetResponses(msg);
  if (!response.isempty()) {
      Map content = (Map)response.getContent();
      boolean succ = (Boolean) content.get("SUCCESS");
      if (succ) {
          // ID mapping sources were configured successfully
      } else {
          // ID mapping sources were not configured or failed
      }
  } else {
      // the ID mapping services are unavailable
  }
}}}
=== ID mapping supported ID types fetching request ===
Request to fetch the supported source and target ID types
{{{
#!java
  String receiver = "CyThesaurus";
  String msgType = "REQUEST_SUPPORTED_ID_TYPE"; // request for fetching supported ID types
  String msgId = receiver + System.currentTimeMillis();
  Message msg = new Message(msgId , pluginName, receiver, msgType , null);
  List<ResponseMessage> response = PluginsCommunicationSupport.sendMessageAndGetResponses(msg);
  if (!response.isempty()) {
      Map content = (Map)response.getContent();
      boolean succ = (Boolean) content.get("SUCCESS");
      String report = (String) content.get("REPORT");
      if (succ) {
          // successfully fetched
          // report contains statistics 		An inter-plugin communication module was developed to support !CyThesaurus plugin providing ID mapping services to other plugins. A inter-plugin communication package cytoscape-plugins-comm was developed. ( [[attachment:cytoscape-plugins-comm.jar]], [[http://web.missouri.edu/~jg722/GSoC/cytoscape-plugins-comm-javadoc/|javadoc]], [[http://chianti.ucsd.edu/svn/csplugins/trunk/soc/jgao/PluginsCommunication/|src]]). It is recommended that other plugins, who need to request ID mapping services from !CyThesaurus, include the [[http://chianti.ucsd.edu/svn/csplugins/trunk/soc/jgao/IDMappingService/CyThesaurusService.jar|CyThesaurusService]], which wraps up the messages in a class.
Line 148: Line 46:
          String[] supportedSrcIDTypes = (String[]) content.get("SRC_ID_TYPE");
          String[] supportedTgtIDTypes = (String[]) content.get("Tgt_ID_TYPE");
          // do more things here ...
      } else {
          // failed
          // report contains error message
      }
  } else {
      // the ID mapping services are unavailable
  }
}}} 		=== Demo plugin to consume ID mapping services ===
 * A demo plugin, who consumes ID mapping services provided by !CyThesaurus, is available for downloading ([[attachment:CyThesaurusServiceTester.jar]], [[attachment:TestCyThesurrusService.java]]).

 * To run the demo plugin, install !CyThesaurus plugin and place [[attachment:CyThesaurusServiceTester.jar]] in the plugin folder of Cytoscape, then start Cytoscape. You will see a menu of ''Test !CyThesaurus Service'' in the ''Plugins'' menu. Click on the sub menus to request different services.

 * To request ''ID mapping service example'', you need to import the falFiltered.sif and load the ''!BioMart ID Mapping Service'' with the dataset of ''Saccharomyces cerevisiae genes (SGD1.01)''. You can achieve this by going through [[http://www.cytoscape.org/cgi-bin/moin.cgi/CyThesaurus_Plugin/ID_Mapping_Examples#BioMart_based|Webservice-based identifier mapping tutorial]].

Contents

  1. Plugin availability
  2. Introduction
  3. Use Cases
  4. Supported ID Mapping Resources
    1. File- based
    2. RDB based
    3. Web service based
  5. Code Base
  6. ID mapping service for other plugin
    1. Demo plugin to consume ID mapping services

Plugin availability

Introduction

CyThesaurus is a Cytoscape plugin providing identifier mapping services based on various resources. Currently the plugin support ID mapping resources from delimited text, PGDB file and BioMart web service. This plugin utilized BridgeDb API.

Use Cases

5 related use cases have been identified on Bader Lab ID Mapping page. 2 of them are closely related to this project:

  • Unification during dataset merging: During a merge operation e.g. of two protein-protein interaction datasets from independently created databases, it is vital to recognize that two protein objects, one from each data source, represent the same protein molecule, even if the protein objects don’t share any database accession numbers. Unification requires knowledge of record type e.g. you cannot reliably use a gene ID to unify proteins (mostly because splice variants exist).

  • Identifier translation: Some analysis methods require specific translations from one set of identifiers to another. For instance, our 'activity centers' analysis requires translation from protein or gene identifiers in a pathway database to Affymetrix probe set identifiers or other gene expression array platform identifiers.

Supported ID Mapping Resources

File- based

  • Delimited text file

    • File format (e.g. http://tinyurl.com/mergesvn/testData/yeast_id_mapping.txt):

      • Each column for one ID type
      • Each row except the first one represents IDs of different types mapping to each other
      • First row contains ID types
      • Multiple IDs are allowed to be contained in one cell (One to many mapping, or IDs of the same type maps to each other). Use special character (e.g., ';', '/', etc, or user defined) to separate IDs.

RDB based

Web service based

Code Base

Currently the plugin is based on Cytoscape 2.6. Porting to Cytoscape 3.0 is in plan.

ID mapping service for other plugin

An inter-plugin communication module was developed to support CyThesaurus plugin providing ID mapping services to other plugins. A inter-plugin communication package cytoscape-plugins-comm was developed. ( cytoscape-plugins-comm.jar, javadoc, src). It is recommended that other plugins, who need to request ID mapping services from CyThesaurus, include the CyThesaurusService, which wraps up the messages in a class.

Demo plugin to consume ID mapping services

  • A demo plugin, who consumes ID mapping services provided by CyThesaurus, is available for downloading (CyThesaurusServiceTester.jar, TestCyThesurrusService.java).

  • To run the demo plugin, install CyThesaurus plugin and place CyThesaurusServiceTester.jar in the plugin folder of Cytoscape, then start Cytoscape. You will see a menu of Test CyThesaurus Service in the Plugins menu. Click on the sub menus to request different services.

  • To request ID mapping service example, you need to import the falFiltered.sif and load the BioMart ID Mapping Service with the dataset of Saccharomyces cerevisiae genes (SGD1.01). You can achieve this by going through Webservice-based identifier mapping tutorial.

CyThesaurus_Plugin (last edited 2011-03-29 16:03:58 by asp)

Funding for Cytoscape is provided by a federal grant from the U.S. National Institute of General Medical Sciences (NIGMS) of the Na tional Institutes of Health (NIH) under award number GM070743-01. Corporate funding is provided through a contract from Unilever PLC.

MoinMoin Appliance - Powered by TurnKey Linux