Difference between revisions of "MSigDB v3.0 Release Notes"

From GeneSetEnrichmentAnalysisWiki
Jump to navigation Jump to search
m
m
Line 86: Line 86:
 
For complete descriptions of all collections or to download the updated  gene sets, go to the <a href="http://www.broad.mit.edu/gsea/msigdb/collections.jsp">Browse  Collections</a> page.
 
For complete descriptions of all collections or to download the updated  gene sets, go to the <a href="http://www.broad.mit.edu/gsea/msigdb/collections.jsp">Browse  Collections</a> page.
 
<h2>Other Updates</h2>
 
<h2>Other Updates</h2>
<h3>XML Format Changes</h3>
+
<h3>Changes in organism annotation</h3>
 +
We applied consistent organism names throughout MSigDB gene sets. For example, 'Human' was renamed to 'Homo sapiens'. Pathways reported as 'Human' which are not present in 'Homo sapiens' were deprecated. We inspected annotations of every gene set and replaced 'Generic' organism name with the appropriate correct organism name. For genes in the C3 collection, we replaced 'Human,Mouse,Rat,Dog' organism name with the more correct 'Homo sapiens' name. While the majority of motifs themselves are conserved across the five species, human genome sequences were used to identify genes containing these and other motifs.
 
We have added new attributes to the XML database file.&nbsp; See <a href="http://www.broadinstitute.org/cancer/software/gsea/wiki/index.php/MSigDB_XML_description">this page</a> for more information.<br />
 
We have added new attributes to the XML database file.&nbsp; See <a href="http://www.broadinstitute.org/cancer/software/gsea/wiki/index.php/MSigDB_XML_description">this page</a> for more information.<br />
 
<h3>More options with GMT files</h3>
 
<h3>More options with GMT files</h3>

Revision as of 10:53, 3 October 2010

<a href="http://www.broadinstitute.org/cancer/software/gsea/wiki/index.php/MSigDB_XML_description">GSEA Home</a> | <a href="http://www.broadinstitute.org/gsea/downloads.jsp">Downloads</a> | <a href="http://www.broadinstitute.org/gsea/msigdb/">Molecular Signatures Database</a> | Documentation | <a href="http://www.broadinstitute.org/gsea/contact.jsp">Contact</a>

Major changes in Release 3.0 of the Molecular Signatures Database (MSigDB) include the following:

  • removed all gene sets with fewer than ten (C1, C2:CP, C3-C5) or five (C2:CGP) human gene symbols
  • C2 collection: extensively reviewed and added many new gene sets as detailed below
  • gene families: updated and added new gene families
  • MSigDB gene sets now support human Entrez Gene IDs
  • enhanced features in the MSigDB XML file format
  • fixed a bug in the Compute Overlaps algorithm
  • archived MSigDB v2.5 files

Gene Sets Update

The following describes the changes made to the gene set collections for MSigDB v3.0.

Size Filtering

All collections have been filtered according to size in the following ways:

  • if a gene set was not in the C2:CGP subcollection, then it was included in the v3.0 release only if it had 10 or more human gene symbols associated with it
  • if a gene set was in the C2:CGP subcollection, then it was included in the v3.0 release only if it had 5 or more human gene symbols associated with it

C1: Positional gene sets (-60)

  • 60 gene sets have been deprecated due to small size (less than 10 human gene symbols).

No other changes were made in the C1 gene sets. For a description of this collection, see the <a href="http://www.broad.mit.edu/gsea/msigdb/collections.jsp">Browse Collections</a> page. 

C2: Curated gene sets (+1,380)

The C2 collection consists of gene sets collected from various sources such as online pathway databases, publications in PubMed, and knowledge of domain experts.  Gene sets in this collection have been extensively revised and expanded.
Note that all the gene set names for C2 have changed.  Many of the names used in v2.5 were confusing or wrong, so these have been clarified or corrected.  For CGP, the new naming convention is that all gene set names begin with the surname of the first author of the source paper.  For CP, the names now begin with the contributor organization.

  • CGP: chemical and genetic perturbations (2,392 gene sets). See <a href="http://www.broadinstitute.org/cancer/software/gsea/wiki/index.php/Msigdb_mapping_v2.5_to_v3">this page</a> for information about MSigDB 2.5 gene sets that have been renamed, retired, recombined, or replaced in the MSigDB 3.0 release.  All these gene sets have been verified against the original sources.  During the reviewing process, we have:
    • renamed gene sets to follow consistent conventions throughout the whole collection
    • wrote new, enhanced, brief descriptions according to consistent conventions throughout the whole collection
    • validated and corrected, if necessary, every attribute for each existing gene set
    • added the exact source of the gene set (e.g., Table 1)
    • added GEO or ArrayExpress ID when available
    • added links to human Entrez Gene entries and PubChem Compound entries as appropriate
    • used the original gene identifiers as reported in the source paper (not all gene sets did this originally)
    • resolved cases of redundant gene sets
    In addition, we made an aggressive effort to identify new gene sets and add them to the database, using the same stringent set of criteria for reviewing these new additions.
  • CP: canonical pathways (880 gene sets).
    • We have deprecated all gene sets:
      • from GenMAPP gene sets because the majority of them in the previous release are based on KEGG or GO information that we already have
      • from GO in this collection because they are already represented by C5
      • based on NetAffx annotations because these are largely based on GO and thus are already represented by C5
      • with untraceable origins
    • We have replaced all existing BioCarta and KEGG gene sets with updated versions from these resources.
    • In collaboration with Reactome, we added 430 new canonical pathway sets
    • To reduce redundancy in canonical pathways from BioCarta, KEGG, and Reactome, we developed and applied the following filters:
      • Source priority: KEGG > Reactome > BioCarta
      • Size priority: keep the set with the smaller size
      • Name length priority: keep the set with the shorter name
      • External ID priority: keep the set with the smaller ID (applied to Reactome sets only)
    • For convenience, we have organized gene sets from BioCarta, KEGG, and Reactome as separate, third-level divisions within C2:CP

C3: Motif gene sets (-1)

  • Thanks to a sharp user, we fixed an error in the description of the gene set "V$NRF2_01".
  • All uncategorized gene sets in this collection have been assigned to the TFT subcollection.
  • One gene set in the MIR subcollection has been deprecated due to small size (less than 10 human gene symbols).

No other changes were made in the C3 gene sets.  For a description of this collection, see the <a href="http://www.broad.mit.edu/gsea/msigdb/collections.jsp">Browse Collections</a> page.

C4: Computational gene sets (-2)

  • Two gene sets in the CM subcollection have been deprecated due to small size (less than 10 human gene symbols).

No other changes were made in the C4 gene sets. For a description of this collection, see the <a href="http://www.broad.mit.edu/gsea/msigdb/collections.jsp">Browse Collections</a> page.

C5: Gene Ontology gene sets

  • Names of 71 gene sets have been changed by removing pairs of consecutive underscore characters ('_').

No other changes were made in the C5 gene sets. For a description of this collection, see the <a href="http://www.broad.mit.edu/gsea/msigdb/collections.jsp">Browse Collections</a> page.

For more information

For complete descriptions of all collections or to download the updated gene sets, go to the <a href="http://www.broad.mit.edu/gsea/msigdb/collections.jsp">Browse Collections</a> page.

Other Updates

Changes in organism annotation

We applied consistent organism names throughout MSigDB gene sets. For example, 'Human' was renamed to 'Homo sapiens'. Pathways reported as 'Human' which are not present in 'Homo sapiens' were deprecated. We inspected annotations of every gene set and replaced 'Generic' organism name with the appropriate correct organism name. For genes in the C3 collection, we replaced 'Human,Mouse,Rat,Dog' organism name with the more correct 'Homo sapiens' name. While the majority of motifs themselves are conserved across the five species, human genome sequences were used to identify genes containing these and other motifs. We have added new attributes to the XML database file.  See <a href="http://www.broadinstitute.org/cancer/software/gsea/wiki/index.php/MSigDB_XML_description">this page</a> for more information.

More options with GMT files

Traditionally, all gene sets in MSigDB use human gene symbols as standard gene identifiers. GMT files with gene sets based on human gene symbols contain the word symbols in their names. For standard GSEA analysis, no change is expected: just continue using *.symbols.gmt files as previously. For the first time, this release contains additional kinds of GMT files, with gene sets using:

  • original gene identifiers: exactly as they appear in the sources of gene sets; these files contain the word orig in their names
    Since original identifiers are from a variety of platforms, we do not recommend using them for routine GSEA analysis. Instead, these files should serve for uses other than standard GSEA analysis.
  • human Entrez Gene IDs; these files contain the word entrez in their names
    Because these files are not identical to the standard *.symbols.gmt files, GSEA done with these files might produce slightly different results compared to the standard *.symbols.gmt files.

For standard GSEA analysis, no change is expected: just continue using .*.symbols.gmt files as previously. Alternatively, you can now choose GMT files with genes rendered as human Entrez Gene IDs.

Compute Overlaps Error Corrected

Several users noted an error in calculations of p-values in the Compute Overlaps tool at the MSigDB web site. Thanks to these reports, we have corrected the error.

MSigDB v2.5 Files

The MSigDB v2.5 files are archived and are still available for download on the <a href="http://www.broadinstitute.org/gsea/downloads.jsp">Downloads</a> page.  To load them into GSEA, see the GSEA 2.0.7 Release Notes.