Package org.biopax.paxtools.io.gsea

Class GSEAConverter

java.lang.Object
org.biopax.paxtools.io.gsea.GSEAConverter
public class GSEAConverter extends Object
Converts a BioPAX model to the GMT format (used by GSEA software). It creates GSEA entries from sequence entity reference xrefs in the BioPAX model as follows: Each entry (row) consists of three columns (tab separated): name (we use pathway URI), description (e.g. "name: Apoptosis; datasource: reactome; organism: 9606 idtype: uniprot"), and the list of identifiers (of the same type). For participants not associated with any pathway, "other" is used for the pathway name and uri. The list may have one or more IDs of the same type per entity reference, e.g., UniProt IDs or HGNC Symbols; entity references that do not have any xref of given db/id type are ignored. Optionally, if there are less than three protein references per entry, it will not be printed. Notes: - to effectively enforce the cross-species checks, 'organism' property of pathways and participants must be set to a BioSource element with valid ncbitaxon (taxonomy) unification xref; - this assumes that the BioPAX Level3 model was validated and normalized (with BioPAX Validator and Normalizer);

  • Constructor Details

    • GSEAConverter

      public GSEAConverter()
      Constructor.

    • GSEAConverter

      public GSEAConverter(String idType, boolean crossSpeciesCheckEnabled)
      Constructor. See class declaration for more information.
      Parameters:
      idType - - identifier collection/type name, prefix - either the string value of the most of EntityReference's xref.db property values in the BioPAX data, e.g., "hgnc.symbol", or "HGNC Symbol", "NCBI Gene", "RefSeq", "UniProt", - or the namespace/prefix part of the normalized EntityReference URIs, such as 'chebi' in identifiers.org/chebi:ID or bioregistry.io/chebi:ID (it depends on actual data; so check/verify before using here).
      crossSpeciesCheckEnabled - - if true, enforces no cross species participants in output

    • GSEAConverter

      public GSEAConverter(String idType, boolean crossSpeciesCheckEnabled, boolean skipSubPathways)
      Constructor. See class declaration for more information.
      Parameters:
      idType - - identifier collection/type name, prefix - either the string value of the most of EntityReference's xref.db property values in the BioPAX data, e.g., "hgnc.symbol", or "HGNC Symbol", "NCBI Gene", "RefSeq", "UniProt", - or the namespace/prefix part of the normalized EntityReference URIs, such as 'chebi' in identifiers.org/chebi:ID or bioregistry.io/chebi:ID (it depends on actual data; so check/verify before using here).
      crossSpeciesCheckEnabled - - if true, enforces no cross species participants in output
      skipSubPathways - - if true, do not traverse into any sub-pathways to collect entity references (useful when a model, such as converted to BioPAX KEGG data, has lots of sub-pathways, loops.)

    • GSEAConverter

      public GSEAConverter(String idType, boolean crossSpeciesCheckEnabled, Collection<Provenance> skipSubPathwaysOf)
      Constructor. See class declaration for more information.
      Parameters:
      idType - identifier collection/type name, prefix - either the string value of the most of EntityReference's xref.db property values in the BioPAX data, e.g., "hgnc.symbol", or "HGNC Symbol", "NCBI Gene", "RefSeq", "UniProt", - or the namespace/prefix part of the normalized EntityReference URIs, such as 'chebi' in identifiers.org/chebi:ID or bioregistry.io/chebi:ID (it depends on actual data; so check/verify before using here).
      crossSpeciesCheckEnabled - - if true, enforces no cross species participants in output
      skipSubPathwaysOf - - do not look inside sub-pathways of pathways of given data sources to collect entity references (useful when a model, such as converted to BioPAX KEGG data, has lots of sub-pathways, loops.)

  • Method Details

    • getIdType

      public String getIdType()

    • setIdType

      public void setIdType(String idType)

    • isSkipOutsidePathways

      public boolean isSkipOutsidePathways()
      If true, then only GSEA entries that (genes) correspond to a Pathway are printed to the output.
      Returns:
      true/false

    • setSkipOutsidePathways

      public void setSkipOutsidePathways(boolean skipOutsidePathways)

    • getAllowedOrganisms

      public Collection<String> getAllowedOrganisms()

    • setAllowedOrganisms

      public void setAllowedOrganisms(Set<String> allowedOrganisms)

    • getMinNumOfGenesPerEntry

      public int getMinNumOfGenesPerEntry()
      If this value is greater than 0, and the number of proteins/genes in a gene set is less than that value, then this gene set is to skip (no GSEA entry is written).
      Returns:
      the min. value

    • setMinNumOfGenesPerEntry

      public void setMinNumOfGenesPerEntry(int minNumOfGenesPerEntry)

    • writeToGSEA

      public void writeToGSEA(Model model, OutputStream out) throws IOException
      Converts model to GSEA (GMT) and writes to out. See class declaration for more information.
      Parameters:
      model - Model
      out - output stream to write the result to
      Throws:
      IOException - when there's an output stream error

    • convert

      public Collection<org.biopax.paxtools.io.gsea.GMTEntry> convert(Model model)
      Creates GSEA entries from the pathways contained in the model.
      Parameters:
      model - Model
      Returns:
      a set of GSEA entries