Reference / Help
Metazome help
Nodes, clusters, consensus sequences, keyword search, BLAST, cluster views, alignments, and sequence downloads. This reference documents the Metazome system; the tool pages in this static edition provide release index search and BLAST job preparation.
Nodes, clusters and consensus sequences
Nodes and clusters
Please go to the info page for information on nodes and clustering. The sister project Phytozome applies the same framework to land plant proteomes.
Consensus sequences
A consensus peptide sequence is constructed for each cluster from the MSA (multiple sequence alignment). The consensus is that sequence which maximizes the sum of the pairwise scores with each cluster member's peptide sequence. For Metazome, BLOSUM62 was used as the scoring matrix, with gap opening and extension costs of 11 and 2, respectively. This relatively simple approach produces a cluster consensus sequence that is comparable to more sophisticated profile construction algorithms, in terms of its ability to post facto correctly assign, via BLAST, cluster members to their correct clusters.
Searching for clusters
Keyword search
Gene symbol, identifier, defline and ontology search
Gene clusters can be retrieved by providing keywords that match the symbols, data source identifiers, deflines, and functional annotations (ontologies) that have been assigned either directly to the gene cluster, or to any of its members. There are two types of keyword searches: Symbols, Identifiers, and Deflines, and Ontologies.
Symbols, identifiers, and deflines
This search type allows you to find gene clusters whose members have textual annotations (deflines, symbols, database reference identifiers) matching one or more search terms. For example, if you know the HUGO, EMBL, UniGene, Uniprot, RefSeq, or other identifier for a member of the cluster, you can pull up the entire cluster. Likewise, if you have a defline or description of a gene, you can use all or part of it to find the clusters associated with that gene. See the Search syntax section below for details on how to enter search terms.
Ontologies
This search type allows you to find gene clusters with one or more members whose classification by GO, PFAM, PANTHER, EC, KEGG Orthology, Cluster KEGG Orthology, or KOG matches the search terms. Cluster KEGG Orthology is handled slightly differently. If you select Cluster KEGG Orthology and your search terms match one or more KO classifications, the search will only return clusters that have been specifically classified with those KO terms at the cluster level. This requires that a majority of cluster members share the same KO classification.
The term can either be an ontology ID or the text associated with an ontology ID. For example, “non specific rna polymerase ii transcription factor” is the description of GO ID GO:0016252, so a search term of “non specific rna polymerase” would give the same result as searching with “16252”. Be sure to select at least one ontology type for this type of search, and see the Search syntax section below for details on how to enter ontology identifiers.
| Ontology | Format |
|---|---|
| GO | Remove the GO:000 prefix, for example 16455 rather than GO:00016455. |
| PFAM | PF01000 |
| PANTHER | PTHR19376.SF11 for subfamilies, or PTHR19376 for a family. |
| EC | 2.7.1.121 |
| KEGG Orthology | K03085 |
| Cluster KEGG Orthology | K04354 for a fourth level term, or 00453 for a higher level term. |
| KOG | KOG1354 |
A successful ontology search returns a table of ontology IDs that match the search terms, followed by the search results. Clicking on one of the ontology IDs repeats the search as if you searched for just that specific ID. In this static edition, ontology searches return named families from the release index.
Search syntax
You can enter one or more search terms. By default, these terms are combined with OR, so results are returned when they match at least one of the search terms. To perform an AND search, retrieving results that match all of your search terms, preface each term with a plus sign. To make sure search results do not match a particular term, preface it with a minus sign. Wildcards are allowed anywhere in a term except as the first character. To exactly match a phrase, rather than individual terms, place the phrase in quotes, for example “rna polymerase”. By default, a trailing wildcard is added to each term, except in quoted, exact phrase searches. Do not use wildcards in exact phrase searches. To disable the trailing wildcard, uncheck the box next to the search box.
Search results
Search results are presented in pages displaying 100 clusters each, ordered from the largest to the smallest clusters. Information on each cluster consists of its size (number of members), node, and internal identifier, a defline if available, and the distribution of cluster members by organism. To view detailed information on any particular gene cluster, click on the magnifying glass icon. To view additional pages of search results, use the First, Previous, Next, and Last links at the top and bottom of each page.
This documentation describes the original database. The results page in this static edition returns release index records: ancestral nodes, genome records, and named families. For an example, run a broad transcription search against the release index.
Analysis of search results and composite cluster creation
You can immediately begin analyzing the sequences associated with one or more clusters using the links contained here. Select one or more clusters listed on the Search Results page by checking the box to the left of each cluster row, and then decide whether you wish to view or align the cluster member proteins, coding sequences, or consensus sequences. Note that for consensus sequences, you are working with one sequence per cluster, so viewing and aligning the consensus sequences is typically useful only when you have selected more than one cluster. Go to the section Analyzing cluster sequences to learn more.
As of version 2.0.3, you can also create a composite cluster by selecting two or more clusters from the search results and clicking View selected clusters as a single composite cluster. This will immediately take you to a cluster summary page that contains all the members of the selected clusters, arranged for viewing as a single composite cluster. Note that this option is only available for searches performed at a single node.
Display options for search results
The columns on the right hand side of the Search Results page show a species by species breakdown of the members of each gene family. By unchecking the boxes for a given species in the Display tab, that species column is removed from the display, and the counts for that species are added to the Oth (Other) column. You can make these display options permanent by clicking the Save these Settings button. If these settings are made permanent, they will also affect the display of information on the cluster summary page.
BLAST search
The BLAST search implements NCBI Blast (v2.2.13) to enable sequence similarity searches of both individual organism genomes, as well as cluster consensus sequences defined at each node. Simply paste your sequence, with or without a FASTA header, into the Query Sequence text box. If you are mainly interested in analyzing your sequence in the genomic context of a particular organism, use the Organism Genome target type. To analyze the evolutionary history and possible orthologs of your sequence, select the Node Consensus target type. Note the former is a nucleotide BLAST database, while the latter is a protein database.
The BLAST page in this static edition validates the target, program, query, and parameters, then prepares a job summary. It does not run the alignment in the browser.
BLAST options
The available options are mostly standard NCBI options. These include:
- Allow gapped alignment
- Permit gaps in the alignment between the query and target sequence.
- Comparison matrix
- The scoring matrix that determines the cost of each possible residue mismatch between query and target sequence.
- Word length
- The minimum number of consecutive residues that must match identically between the query and target sequence in order to seed an alignment.
- E threshold
- The maximum expectation value of retained alignments.
- Number of alignments to show
- How many top scoring alignments should be displayed in the result set.
- Filter options
- Whether to remove low complexity regions from the query sequence, using DUST for blastn searches and SEG for all others.
For Node Consensus searches, there is also the option whether to include singletons in the target database. Singletons are clusters of size one whose consensus sequence is simply the single member's protein sequence.
BLAST results
BLAST results are organized into a graphical overview of HSPs (High Scoring Pairs) of query and target sequence, and a hyperlinked text report. The HSPs are color coded to indicate significance, with red being the most significant alignments and blue the least. If you mouse over an HSP, the info box above the graphic will display the significance and score for the hit, as well as a descriptive defline for the corresponding target sequence. Clicking on an HSP will take you to a detailed view of the alignment within the textual report.
The textual report includes a summary of target sequences producing significant alignments. The E values in this summary are each hyperlinked to a detailed alignment view. You can also click on the target name or magnifying glass icon to be taken to a view of the BLAST hit in its genomic context, for genomic BLASTs, or a cluster summary, for BLASTs against the Node Consensus databases.
Analyze BLAST results and create composite clusters
Using the checkboxes to the left of the Significant Alignments list, you can select one or more clusters to analyze within Jalview. Click on Align Member protein sequences to load the cluster peptide sequences into Jalview. Click on Align Member coding sequences to launch Jalview with the cluster coding sequences instead. Finally, click on Align cluster consensus sequences to load the consensus sequences for each cluster, which is only useful if you have selected more than one cluster.
When loading more than one cluster into Jalview, each cluster's sequences will be shaded in the same color so they can be readily distinguished from sequences from other clusters. All alignments, sequences, and trees can be downloaded from Jalview in multiple formats. See the Analyzing cluster sequences section for more information.
As of version 2.0.3, you can also create a composite cluster by selecting two or more clusters from the BLAST results and clicking View selected clusters as a single composite cluster. This will immediately take you to a cluster summary page that contains all the members of the selected clusters, arranged for viewing as a single composite cluster.
Viewing cluster details
The Cluster Summary page provides a detailed picture of a given cluster's constituent genes. This page is accessed by clicking the magnifying glass icon next to the cluster of interest on the Search Results or BLAST Results pages.
Cluster naming and classification
A brief summary and high level classification of the ancestral gene represented by this cluster. The summary includes the node name, the number of crown (extant organism) genes in the cluster, an automatically generated cluster name, and, where possible, both KOG letter and KEGG classification of the cluster, also referred to as Cluster KEGG Orthology.
Names for nonsingleton clusters are either KOG based, when more than 50% of a cluster's member genes are annotated with the same KOG, or SwissProt based, when a cluster is purely orthologous, meaning all organisms at that node have one and only one member in the cluster. In the latter case the cluster is named according to the SwissProt annotation of a prominent, meaning well annotated, member. If neither of these cases applies, then the SwissProt or TrEMBL name of the member that is most similar to the cluster consensus sequence will be used. If this still does not yield a name, then the cluster is named simply Hypothetical Gene. Singleton clusters are named with the definition line of their sole member.
The KOG class assignment follows the same rule as KOG naming, described above. The KEGG Brite classification is done similarly, with the modification that only 50% of the member genes that could possibly have a KO assignment are required to agree. This modification is due to the fact that not all organisms have been analyzed via KO, which is a prerequisite for KEGG Brite classification. The two shallowest levels of the KEGG Brite classification are hyperlinked. Clicking on the links will find all clusters at the current node assigned this KEGG Brite annotation.
Note that for composite clusters, naming and classification information are not provided.
Genes in this cluster
Information on each member gene of this cluster is available in this section. This information includes the species code, the genomic location (chromosome or scaffold, with the start and end coordinates available via mouse hovering), reference identifiers for this gene in other datasets (for example RefSeq, UniGene, Uniprot, Ensembl, JGI), gene symbols, defline, a cartoon of any PFAM domains found on this gene's product, and a cartoon of the upstream and downstream neighbors of this gene. Each of these columns can be hidden or made visible by selecting it in the Display Options panel. If a plus icon is visible next to a row, the row can be expanded to show more information.
The CHROM entry is always hyperlinked to a Gbrowse based local genomic view of the gene model. For some organisms, this view will also include supporting EST evidence, homologous proteins aligned to the genome, and genome to genome synteny information plots. Place the mouse cursor over the CHROM entry, and the gene start and end positions will be visible as well.
The first ID in the DbXREF column is always from the primary source dataset, the dataset from which this gene was obtained, typically Ensembl or JGI. If available in other datasets, their identifiers are listed as well; you will need to expand the row to see these other identifiers. Where possible, all reference identifiers are hyperlinked to an information page provided by their source curators. A two letter code is used to indicate the source database of a given identifier. The codes are:
| Code | Source |
|---|---|
| RS | NCBI RefSeq |
| ST | SwissProt or TrEMBL |
| UG | NCBI UniGene |
| EG | NCBI EntrezGene |
| HU | HUGO Gene Nomenclature Database |
| EM | EMBL |
The Domains tab provides a cartoon view of any PFAM domains called on this gene's peptide. The same PFAM domain in different peptides will be rendered in the same color. Mouse over a domain to see the PFAM ID, description, and domain coordinates displayed in a pop up to the left of the domains. The selected domain will also be highlighted in all rows in which it appears. Click on the domain to see it highlighted in all other rows in which it appears. Note that all peptides in the cluster are scaled to the same length for viewing.
The Synteny tab provides a view of the five upstream and five downstream neighbors of this gene, known as the syntenic block. The anchor gene is always rendered in black, except in the case of composite clusters, where the anchor genes are not necessarily from the same cluster. The syntenic blocks are oriented so that anchor genes are always on the same strand, consistent with their implied descent from a common ancestral gene. Mousing over any syntenic gene will produce an info box displaying the gene's primary ID, and the name and ID of the cluster containing that gene. The box also includes a link to that cluster's summary page. To access the link, click on the syntenic gene, which freezes the info box and highlights all other genes that are members of the same cluster, and move the cursor over to the hyperlink, then click.
Functional analysis
The functional and domain annotations, for example KOG, KEGG, GO, PFAM, and PANTHER, that have been assigned to members of this cluster are displayed here. For each annotation type, the identifier and description are provided, as well as this annotation's phylogenetic fingerprint, meaning how many of the genes in this cluster have been assigned this annotation, broken down by organism.
Multiple sequence alignment
A Multiple Sequence Alignment (MSA) has been precalculated for each gene family. You can view the MSA in this panel, as well as download a conservation colored HTML file of the alignment. Please use the Get Sequences tab if you want the raw CLUSTALW output. Note that any organisms which have been hidden in the Display Options will also be excluded from the MSA, though the MSA will not be recalculated. If you want to recalculate the MSA with certain sequences excluded or modified, you should go to the Align cluster members tab and launch Jalview.
Note that MSAs are not precalculated for composite clusters. If a composite cluster has fewer than 75 members, the Multiple Sequence Alignment tab will be visible, and clicking on it will launch a real time alignment. For composite clusters with greater than 75 members, the MSA tab will not be accessible.
Align cluster members
This tab provides access to the Jalview Multiple Sequence Viewer. Click on Align Member protein sequences to load this cluster's peptide sequences into Jalview. Click on Align Member coding sequences to launch Jalview with the cluster coding sequences instead. For all reasonably sized clusters, the CLUSTALW multiple sequence alignment has been precomputed, and will automatically load when Jalview is launched for protein sequences. Otherwise, you can apply CLUSTALW or MUSCLE, a similar multiple sequence aligner, within Jalview. Once you have an alignment, you can build Neighbor Joining or Maximum Likelihood phylogenetic trees. All alignments, sequences, and trees can be downloaded from Jalview in multiple formats. See the Analyzing cluster sequences section for more information.
Find related clusters
There are several methods available for finding clusters related to the current cluster by descent, sequence similarity, or functional annotation.
- Clusters related by descent
- Click on the View Ancestor link to be taken to the cluster summary page of the parent, the immediate ancestor, of the current cluster. This cluster is guaranteed to contain all the members of the current cluster. If the current cluster is a root, most ancient, node cluster, no ancestor exists. Click on the View descendants link to find the children, the immediate descendants, of the current cluster. The union of these child clusters exactly reconstructs the current cluster. We currently do not include crown nodes, which are nodes consisting solely of a single extant organism. If you are already at a terminal, most modern, node, you will not see a link for descendant clusters. If you are interested in tracing the ancestry of only a particular subset of the members of the current cluster, select them by checkbox and click Find all clusters with selected genes. This will return only those clusters containing all of the selected genes.
- Clusters related by sequence similarity
- Each noncomposite cluster is represented by a consensus peptide sequence, which is based on a residue by residue consensus constructed from the multiple sequence alignment of the cluster members' peptide sequences. One can search for clusters whose consensus sequence is similar to that of the current cluster by clicking the BLAST for similar clusters link. This link will load the BLAST search page with the current node selected. One can use consensus sequences from a different node as the target database by using the node selector on the BLAST page. For composite clusters of fewer than 75 members, an MSA and consensus sequence are calculated on the fly, and the BLAST for similar clusters link functions exactly as for noncomposite clusters. For composite clusters with more than 75 members, however, this link is not available.
- Clusters related by functional annotation
- Use the checkboxes in the Functional Analysis section of the cluster summary to select one or more functional annotations that have been assigned to the current cluster. Click on Find node clusters with selected annotations to find all clusters at the current node which also have been assigned all the selected annotations.
Get sequences
Use this tab to download sequence associated with a given gene family or cluster. You can download the peptide or nucleotide (CDS) sequence for each cluster member, the consensus sequence for the cluster, or the raw CLUSTALW multiple sequence alignment. Choose View to load the FASTA sequence into a browser window, or Download to save it to a file. Note that any species hidden via Display Options will not be included in the Cluster Sequences download, though they will be included in the Raw CLUSTALW alignment. Note that for composite clusters with more than 75 members, neither the Raw CLUSTALW alignment nor the consensus sequence are available.
Display options
Click on columns to select which columns are displayed in the Genes in this cluster section. The Graphical Analyses column refers to the Domain and Synteny views. The synteny color control refers to how many of the displayed and hidden syntenic blocks must contain members of a cluster for that cluster's members to be rendered in color. All members of the same cluster will be rendered in the same nonwhite color. By default this number is 2, but it can be increased or decreased by clicking plus or minus in the column heading.
The Species Visible section of the Display Options allows the user to hide results from particular species. Unchecking a species checkbox will cause information for that organism's genes to be removed from the cluster display. This affects the Genes in this Cluster, Functional Analysis, and Multiple Sequence Alignment tabs. If you wish to make these filter choices permanent, click on the Save Species Setting button.
Click Info
The Click Info tab displays additional information about PFAM domains and syntenic genes when they are selected by mouse click in the Domains or Synteny tabs. For a selected PFAM domain, the PFAM identifier and description are displayed. For a selected syntenic gene, the ID and name of that gene's cluster are displayed, along with a link to the cluster summary page.
Analyzing cluster sequences
Jalview is used for sequence viewing, alignment, and tree building. When you launch Jalview, having selected one or more clusters, the protein or coding sequences of each cluster member are loaded into an alignment panel. If the set of sequences corresponds to a single cluster, the precomputed MSA (multiple sequence alignment) is also retrieved and loaded into another alignment panel. Otherwise, you can launch a CLUSTALW or MUSCLE MSA yourself under the Align menu in Jalview. Sequences are grouped by greatest pairwise similarity after an alignment. Once you have an MSA, you can build a neighbor joining or maximum likelihood tree from the aligned sequences under the Tree menu.
You can always remove a sequence from the set by highlighting the sequence name and choosing Edit and then Delete from the menu. If you would like to add one or more sequences to the set, choose Edit and then Add Sequences. It is important to realign the set after you add or delete sequences.
The Features menu allows you to visualize PFAM domains directly on the sequences in the alignment panels. Simply select Features and then PAC Protein Domains, and a list of PFAM identifiers and descriptions will appear in a panel to the right. Clicking on any one of these entries will highlight in blue that particular PFAM domain on all sequences in the panel.
If you would like to save an MSA or tree, choose the File and then Save As menu item, and specify the desired file format, such as FASTA, CLUSTAL, or MSF. If you would like an image or HTML page of the alignment, choose the File and then Export menu item instead.
More help on Jalview is available at the Jalview website.