Difference between revisions of "Knowledgebase tutorial"

From phenoscape
(Getting started with the Phenoscape Knowledgebase)
m
 
(52 intermediate revisions by 3 users not shown)
Line 1: Line 1:
UNDER CONSTRUCTION
+
{{StatusBox|This tutorial was developed for and describes usage of version 1 of the Phenoscape Knowledgebase, which continues to be available at http://fish.phenoscape.org. All links in this tutorial should be functional, but go to this legacy version of the KB, and not to the current version at http://kb.phenoscape.org. Most (though not all) of the functionality described here is also available in the current version, but at different URLs, and with different user-interfaces. The current KB version also has additional functionality not available in version 1, and thus not described here, such as OntoTrace and semantic similarity searches.}}
  
 
==Getting started with the Phenoscape Knowledgebase==
 
==Getting started with the Phenoscape Knowledgebase==
Line 5: Line 5:
 
[[Image:KB_homepage.png|thumb|The Phenoscape Knowledgebase homepage.|left|350px]]
 
[[Image:KB_homepage.png|thumb|The Phenoscape Knowledgebase homepage.|left|350px]]
  
This tutorial is designed to introduce users to exploring phenotypic data in the [http://kb.phenoscape.org/ Phenoscape Knowledgebase] (KB). The current release includes data from over 50 comparative publications, describing mainly [http://en.wikipedia.org/wiki/Ostariophysi ostariophysan fishes] (for example, catfish, minnows, loaches, characins, and knifefishes), as well as developmental genetic data imported from [http://zfin.org/ ZFIN].
+
This tutorial is designed to introduce users to exploring phenotypic data in the [http://fish.phenoscape.org/ Phenoscape Knowledgebase] (KB). The current release includes data from over 50 comparative publications, describing mainly [http://en.wikipedia.org/wiki/Ostariophysi ostariophysan fishes] (for example, catfish, minnows, loaches, characins, and knifefishes), as well as developmental genetic data imported from [http://zfin.org/ ZFIN].
  
[[Image:KB_term_search_field.png|thumb|The term search field.|left|350px]]
+
<br style="clear: both">
  
The [http://kb.phenoscape.org/ homepage] provides several different entry points into the KB. We’ll start by using the '''term search field''' to find data related to a structure of interest, such as the “basihyal bone”. The KB consists of structured data in the form of related ontology terms. So the search field is used to find a specific term from the vocabulary known to the KB. An autocomplete menu will pop up once you have typed 3 characters. Enter “basihyal bone” into the search field and click on it once it appears in the popup menu.
+
[[Image:KB_term_search_field.png|thumb|The term search field.|right|250px]]
  
Pressing the Search button will take you to the '''term page''' entry for this structure: you can view the placement of this term within the anatomy ontology hierarchy, metadata such as synonym labels and a textual definition, semantic information such as logical relationships to other concepts, and links to data pages in the KB focused on the basihyal bone. To get an overview of the data in the KB about the basihyal bone, we’ll follow the link [http://kb.phenoscape.org/phenotypes/facets?facet_paths%5Bentity%5D=TAO%3A0000316 Browse phenotypes (faceted view)].
+
The [http://fish.phenoscape.org/ homepage] provides several different entry points into the KB. We’ll start by using the '''term search field''' to find data related to a structure of interest, such as the “basihyal bone”. The KB consists of structured data in the form of related ontology terms. So the search field is used to find a specific term from the vocabulary known to the KB. An autocomplete menu will pop up once you have typed 3 characters. Enter “basihyal bone” into the search field and click on it once it appears in the popup menu.
  
This takes us to a '''faceted browsing''' page—faceted browsing lists phenotypes which have been used in annotations within the KB, filtered by the facets on the left side of the page: entity, quality, taxon, or gene. The entity facet is already restricted to basihyal bone. By looking at the quality facet, we can see the categories of qualities associated with basihyal bone in the KB, and the number of different phenotypes for each. Click on [http://kb.phenoscape.org/phenotypes/facets?facet_paths%5Bentity%5D=TAO%3A0000316&facet_paths%5Bquality%5D=PATO%3A0000051 morphology] in the quality facet to further limit the data to phenotypes about basihyal bone morphology. The results table lists phenotypes which have been used in annotations of taxonomic characters or genes. To explore basihyal bone morphology in more detail, click the link above the facets panel which says [http://kb.phenoscape.org/phenotypes?&&filter%5Bdesc%5D=false&filter%5Bindex%5D=0&filter%5Blimit%5D=20&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=false&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bsortby%5D=entity View these results as a phenotypes query].
+
<br style="clear: both">
  
'''Query pages''' have a query panel on the left and result table to the right. After following the previous link, the query panel will be pre-filled with a phenotype consisting of the entity “basihyal bone” and the quality “morphology”. The type of result we are querying for can be changed using the dropdown menu at the top of the query panel. It should currently display '''Phenotypes'''; change it to '''Taxa''' to view [http://kb.phenoscape.org/taxa?filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bpublications_match_type%5D=any taxa with data for basihyal bone morphology] in the KB. In order to further refine the search, click ''Add'' next to the Taxon section of the query panel. In the resulting dialog, you can enter any taxon (try “Gymnotiformes”) to see only [http://kb.phenoscape.org/taxa?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bpublications_match_type%5D=any taxa within that group]. Again using the dropdown menu, you can change the query type to '''Phenotype annotations to taxa''' to view [http://kb.phenoscape.org/taxon_annotations?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bpublications_match_type%5D=any specific phenotypic annotations]. The '''Source''' column provides a link to the original character state descriptions which have been annotated with this phenotype.
+
[[Image:KB_term_info.png|thumb|Term detail page for basihyal bone.|left|350px]]
  
In addition to viewing comparative data, we can also view related developmental genetic annotations from zebrafish. Using the ''Query for:'' dropdown menu, change the query type to '''Phenotype annotations to genes'''. The resulting table will display ZFIN annotations for [http://kb.phenoscape.org/gene_annotations?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true genes affecting basihyal bone morphology]. Some of these genes have multiple annotations matching the search criteria. To get a list of [http://kb.phenoscape.org/gene_annotations?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true unique genes affecting basihyal morphology], change the result-type dropdown to '''Genes'''. The query panel allows us to add multiple criteria to the search: click ''Add'' within the Phenotype section and enter “Meckel’s cartilage” as the entity in the '''Choose Phenotype''' dialog. Initially the query will show [http://kb.phenoscape.org/genes?filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bphenotypes%5D%5B1%5D%5Bentity%5D=TAO%3A0001205 genes that affect either Meckel’s cartilage or basihyal], but if you change ''any'' to ''all'' in the phenotype section, you will see only [http://kb.phenoscape.org/genes?filter%5Bphenotypes_match_type%5D=all&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0001205&filter%5Bphenotypes%5D%5B1%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B1%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B1%5D%5Bincluding_parts%5D=true genes that affect both structures]. ''Note: depending on the query type, intersections (“all”) are not always available. Try changing the query type to see what options are available.''
+
Pressing the ''Search'' button will take you to the '''term page''' [http://fish.phenoscape.org/term/entity/TAO:0000316 entry for this structure]: you can view the placement of this term within the anatomy ontology hierarchy, metadata such as synonym labels and a textual definition, semantic information such as logical relationships to other concepts, and links to data pages in the KB focused on the basihyal bone. To get an overview of the data in the KB about the basihyal bone, we’ll follow the link [http://fish.phenoscape.org/phenotypes/facets?facet_paths%5Bentity%5D=TAO%3A0000316 Browse phenotypes (faceted view)].
  
Using the '''Workspace''', it is possible to save results obtained via queries to be used as input to further queries. For example, we can learn more about the genes affecting both Meckel’s cartilage and the basihyal bone: in the upper left corner of the result table, click the green + icon to add them all to the Workspace. Then click ''Workspace'' near the top of the page to [http://kb.phenoscape.org/workspace use your saved items]. At first the genes we saved are grayed out, since they aren’t useful for the initially selected query. Using the ''Send selections to:'' dropdown menu, change the query type to '''Phenotype annotations to genes'''. Then check the box next to each gene and press the ''Perform Query'' button. You’ll now be able to view [http://kb.phenoscape.org/gene_annotations?filter%5Bgenes%5D%5B7%5D=ZFIN%3AZDB-GENE-040426-731&filter%5Bgenes%5D%5B8%5D=ZFIN%3AZDB-GENE-021022-3&filter%5Bgenes%5D%5B9%5D=ZFIN%3AZDB-GENE-020919-3 the annotations for all of these genes].
+
<br style="clear: both">
  
The KB contains information about the phylogenetic publications which have been annotated by Phenoscape. We can use the Workspace to navigate to some of interest. Within the previous results table, we can see that the ''brpf1'' gene affects Meckel’s cartilage shape. Click the + icon in the far left column of that result row to add that phenotype to the Workspace (the icon appears when your mouse hovers over the cell). Return to the [http://kb.phenoscape.org/workspace workspace page] and change the query type to ''Comparative publications'' using the dropdown menu. Check the box next to “Meckel’s cartilage shape” in the ''Phenotypes'' section, then press the ''Perform Query'' button to see [http://kb.phenoscape.org/publications?filter%5Bphenotypes%5D%5B8%5D%5Bquality%5D=PATO%3A0000052&filter%5Bphenotypes%5D%5B8%5D%5Bentity%5D=TAO%3A0001205&filter%5Btaxa_match_type%5D=any&filter%5Bphenotypes_match_type%5D=any all the publications in the KB containing characters relating to the shape of Meckel’s cartilage]. You can click on one of the publication names, such as “de Pinna 1993”, to see a popup with its full citation. Follow the ''View details for de Pinna 1993'' link to see [http://kb.phenoscape.org/term/publication/PSPUB:0000022 the detail page for this publication], including the abstract, original character matrix, and a list of examined specimens.
+
[[Image:KB_quality_facet.png|thumb|Quality facet for basihyal bone.|right|250px]]
 +
 
 +
This takes us to a '''faceted browsing''' page—faceted browsing lists phenotypes that have been used in annotations within the KB, filtered by the facets on the left side of the page: entity, quality, taxon, or gene. The entity facet is already restricted to basihyal bone. By looking at the quality facet, we can see the categories of qualities associated with basihyal bone in the KB, and the number of different phenotypes for each. Click on [http://fish.phenoscape.org/phenotypes/facets?facet_paths%5Bentity%5D=TAO%3A0000316&facet_paths%5Bquality%5D=PATO%3A0000051 morphology] in the quality facet to further limit the data to phenotypes about basihyal bone morphology. The results table lists phenotypes that have been used in annotations of taxonomic characters or genes. [[Image:KB_view_as_phenotypes_query.png|thumb|Link to phenotypes query from faceted browsing.|left|150px]] To explore basihyal bone morphology in more detail, click the link above the facets panel which says [http://fish.phenoscape.org/phenotypes?&&filter%5Bdesc%5D=false&filter%5Bindex%5D=0&filter%5Blimit%5D=20&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=false&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bsortby%5D=entity View these results as a phenotypes query].
 +
 
 +
<br style="clear: both">
 +
 
 +
[[Image:KB_change_query_type.png|thumb|Changing the query result type.|left|350px]]
 +
 
 +
'''Query pages''' have a query panel on the left and results table to the right. After following the previous link, the query panel will be pre-filled with a phenotype consisting of the entity “basihyal bone” and the quality “morphology”. The type of result we are querying for can be changed using the dropdown menu at the top of the query panel. It should currently display '''Phenotypes'''; change it to '''Taxa''' to view [http://fish.phenoscape.org/taxa?filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bpublications_match_type%5D=any taxa with data for basihyal bone morphology] in the KB. In order to further refine the search, click ''Add'' next to the Taxon section of the query panel. In the resulting dialog, you can enter any taxon (try “Gymnotiformes”) to see only [http://fish.phenoscape.org/taxa?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bpublications_match_type%5D=any taxa within that group]. Again using the drop down menu at the top of the query panel, you can change the query type to '''Phenotype annotations to taxa''' to view [http://fish.phenoscape.org/taxon_annotations?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bpublications_match_type%5D=any specific phenotypic annotations]. The '''Source''' column provides a link to the original character state descriptions that have been annotated with this phenotype.
 +
 
 +
[[Image:KB_any_all.png|thumb|Changing query to "match all" instead of "match any".|right|150px]]
 +
 
 +
In addition to viewing comparative data, we can also view related developmental genetic annotations from zebrafish. Using the ''Query for:'' dropdown menu, change the query type to '''Phenotype annotations to genes'''. The resulting table will display ZFIN annotations for [http://fish.phenoscape.org/gene_annotations?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true genes affecting basihyal bone morphology]. Source
 +
information for the zebrafish phenotype can be obtained from ZFIN by clicking the icon in the '''Source''' column and following the link. Some of these genes have multiple annotations matching the search criteria. To get a list of [http://fish.phenoscape.org/gene_annotations?filter%5Btaxa%5D%5B0%5D=TTO%3A1390&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true unique genes affecting basihyal morphology], change the result-type dropdown to '''Genes'''. The query panel allows us to add multiple criteria to the search: click ''Add'' within the Phenotype section and enter “Meckel’s cartilage” as the entity in the '''Choose Phenotype''' dialog. Initially the query will show [http://fish.phenoscape.org/genes?filter%5Bphenotypes_match_type%5D=any&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B0%5D%5Bincluding_parts%5D=true&filter%5Bphenotypes%5D%5B1%5D%5Bentity%5D=TAO%3A0001205 genes that affect either Meckel’s cartilage or basihyal], but if you change ''any'' to ''all'' in the phenotype section, you will see only [http://fish.phenoscape.org/genes?filter%5Bphenotypes_match_type%5D=all&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0001205&filter%5Bphenotypes%5D%5B1%5D%5Bentity%5D=TAO%3A0000316&filter%5Bphenotypes%5D%5B1%5D%5Bquality%5D=PATO%3A0000051&filter%5Bphenotypes%5D%5B1%5D%5Bincluding_parts%5D=true genes that affect both structures]. ''Note: depending on the query type, intersections (“all”) are not always available. Try changing the query result type, using the drop down menu, to see what options are available.''
 +
 
 +
<br style="clear: both">
 +
 
 +
[[Image:KB_add_all_workspace.png|thumb|Click the green + to add the results to the workspace.|left|250px]]
 +
 
 +
Using the '''Workspace''', it is possible to save results obtained via queries to be used as input to further queries. For example, we can learn more about the genes affecting both Meckel’s cartilage and the basihyal bone: in the upper left corner of the results table, click the green + icon to add them all to the Workspace. Then click ''Workspace'' near the top of the page to [http://fish.phenoscape.org/workspace use your saved items]. At first the genes we saved are grayed out, since they aren’t useful for the initially selected query. [[Image:KB_change_workspace_query.png|thumb|Change the workspace query type.|right|250px]] Using the ''Send selections to:'' dropdown menu, change the query type to '''Phenotype annotations to genes'''. Then check the box next to each gene and press the ''Perform Query'' button. You’ll now be able to view [http://fish.phenoscape.org/gene_annotations?filter%5Bgenes%5D%5B7%5D=ZFIN%3AZDB-GENE-040426-731&filter%5Bgenes%5D%5B8%5D=ZFIN%3AZDB-GENE-021022-3&filter%5Bgenes%5D%5B9%5D=ZFIN%3AZDB-GENE-020919-3 the annotations for all of these genes].
 +
 
 +
<br style="clear: both">
 +
 
 +
[[Image:KB_add_one_workspace.png|thumb|Click the green + to add a single result row to the workspace.|left|350px]]
 +
 
 +
The KB contains information about the phylogenetic publications which have been annotated by Phenoscape. We can use the Workspace to navigate to some of interest. Within the [http://fish.phenoscape.org/gene_annotations?filter%5Bgenes%5D%5B7%5D=ZFIN%3AZDB-GENE-040426-731&filter%5Bgenes%5D%5B8%5D=ZFIN%3AZDB-GENE-021022-3&filter%5Bgenes%5D%5B9%5D=ZFIN%3AZDB-GENE-020919-3 previous results table], we can see that the ''brpf1'' gene affects Meckel’s cartilage shape. Click the + icon in the far left column of that result row to add that phenotype to the Workspace (the icon appears when your mouse hovers over the cell). Return to the [http://fish.phenoscape.org/workspace workspace page] and change the query type to ''Comparative publications'' using the dropdown menu. [[Image:KB_pub_popup.png|thumb|Publication info popup.|right|150px]] Check the box next to “Meckel’s cartilage shape” in the ''Phenotypes'' section, then press the ''Perform Query'' button to see [http://fish.phenoscape.org/publications?filter%5Bphenotypes%5D%5B8%5D%5Bquality%5D=PATO%3A0000052&filter%5Bphenotypes%5D%5B8%5D%5Bentity%5D=TAO%3A0001205&filter%5Btaxa_match_type%5D=any&filter%5Bphenotypes_match_type%5D=any all the publications in the KB containing characters relating to the shape of Meckel’s cartilage]. You can click on one of the publication names, such as “de Pinna 1993”, to see a popup with its full citation. Follow the ''View details for de Pinna 1993'' link to see [http://fish.phenoscape.org/term/publication/PSPUB:0000022 the detail page for this publication], including the abstract, original character matrix, and a list of examined specimens.
 +
 
 +
<br style="clear: both">
  
 
==Visualizing data on the taxonomy==
 
==Visualizing data on the taxonomy==
  
Two of the more experimental interfaces to the KB use the organismal taxonomy to display and browse phenotypic annotations. Both can be accessed from the '''Visualize data''' panel on the [http://kb.phenoscape.org/ homepage]. The '''Phenotypic profile tree''' allows you to enter multiple phenotypes, and then browse the taxonomy for branches in which some or all of the phenotypes co-occur. For example, we can find browse for [http://kb.phenoscape.org/phenotypes/profile_tree?filter%5Bphenotypes%5D%5B1%5D%5Bentity%5D=TAO%3A0000251&filter%5Bphenotypes%5D%5B1%5D%5Bquality%5D=PATO%3A0000462&filter%5Bphenotypes%5D%5B2%5D%5Bentity%5D=TAO%3A0001173&filter%5Bphenotypes%5D%5B2%5D%5Bquality%5D=PATO%3A0000462&filter%5Bphenotypes%5D%5B3%5D%5Bentity%5D=TAO%3A0001058&filter%5Bphenotypes%5D%5B3%5D%5Bquality%5D=PATO%3A0000462 taxa which are missing the adipose fin, dorsal fin, and caudal fin]. The '''Phenotypic variation tree''' allows you to see the taxonomic distribution of all phenotypes matching a specification, such as [http://kb.phenoscape.org/phenotypes/variation_tree/TAO:0000191?filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000052&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000191&filter%5Btaxa%5D%5B0%5D= dentary bone shape]. Hover over a taxon in the tree to see which phenotypes in the table to the left occur there, and hover over a phenotype to see in which taxa the phenotype occurs.
+
Two of the more experimental interfaces to the KB use the organismal taxonomy to display and browse phenotypic annotations. Both can be accessed from the '''Visualize data''' panel on the [http://fish.phenoscape.org/ homepage]. The '''Phenotypic profile tree''' allows you to enter multiple phenotypes, and then browse the taxonomy for branches in which some or all of the phenotypes co-occur. For example, we can find browse for [http://fish.phenoscape.org/phenotypes/profile_tree?filter%5Bphenotypes%5D%5B1%5D%5Bentity%5D=TAO%3A0000251&filter%5Bphenotypes%5D%5B1%5D%5Bquality%5D=PATO%3A0000462&filter%5Bphenotypes%5D%5B2%5D%5Bentity%5D=TAO%3A0001173&filter%5Bphenotypes%5D%5B2%5D%5Bquality%5D=PATO%3A0000462&filter%5Bphenotypes%5D%5B3%5D%5Bentity%5D=TAO%3A0001058&filter%5Bphenotypes%5D%5B3%5D%5Bquality%5D=PATO%3A0000462 taxa which are missing the adipose fin, dorsal fin, and caudal fin]. The '''Phenotypic variation tree''' allows you to see the taxonomic distribution of all phenotypes matching a specification, such as [http://fish.phenoscape.org/phenotypes/variation_tree/TAO:0000191?filter%5Bphenotypes%5D%5B0%5D%5Bquality%5D=PATO%3A0000052&filter%5Bphenotypes%5D%5B0%5D%5Bentity%5D=TAO%3A0000191&filter%5Btaxa%5D%5B0%5D= dentary bone shape]. Hover over a taxon in the tree to see which phenotypes in the table to the left occur there, and hover over a phenotype to see in which taxa the phenotype occurs.
 +
 
 +
[[Image:KB_profile_tree.png|thumb|Phenotypic profile tree.|left|350px]] [[Image:KB_variation_tree.png|thumb|Phenotypic variation tree.|right|350px]]
 +
<br style="clear: both">
 +
 
 +
==Downloading data==
 +
[[Image:KB_download_data.png|thumb|Links to download bulk data.|right|250px]]
 +
Knowledgebase data can be downloaded in bulk—look for the '''Download''' links following data tables on each page. JSON is a structured text format useful to programmers. The plain-text output is tab-delimited and can be viewed within Microsoft Excel. Please contact us if you are interested in a different format (such as RDF) or would like a dump of all the data.
 +
<br style="clear: both">
 +
 
 +
==Providing feedback==
 +
Please contact us with suggestions on how to make this interface work better for you. At the top of each page of the KB, there is a prominent '''Feedback''' button. You can also send an email to [mailto:help@phenoscape.org help@phenoscape.org].

Latest revision as of 19:06, 29 June 2016

Status: This tutorial was developed for and describes usage of version 1 of the Phenoscape Knowledgebase, which continues to be available at http://fish.phenoscape.org. All links in this tutorial should be functional, but go to this legacy version of the KB, and not to the current version at http://kb.phenoscape.org. Most (though not all) of the functionality described here is also available in the current version, but at different URLs, and with different user-interfaces. The current KB version also has additional functionality not available in version 1, and thus not described here, such as OntoTrace and semantic similarity searches.

Getting started with the Phenoscape Knowledgebase

The Phenoscape Knowledgebase homepage.

This tutorial is designed to introduce users to exploring phenotypic data in the Phenoscape Knowledgebase (KB). The current release includes data from over 50 comparative publications, describing mainly ostariophysan fishes (for example, catfish, minnows, loaches, characins, and knifefishes), as well as developmental genetic data imported from ZFIN.


The term search field.

The homepage provides several different entry points into the KB. We’ll start by using the term search field to find data related to a structure of interest, such as the “basihyal bone”. The KB consists of structured data in the form of related ontology terms. So the search field is used to find a specific term from the vocabulary known to the KB. An autocomplete menu will pop up once you have typed 3 characters. Enter “basihyal bone” into the search field and click on it once it appears in the popup menu.


Term detail page for basihyal bone.

Pressing the Search button will take you to the term page entry for this structure: you can view the placement of this term within the anatomy ontology hierarchy, metadata such as synonym labels and a textual definition, semantic information such as logical relationships to other concepts, and links to data pages in the KB focused on the basihyal bone. To get an overview of the data in the KB about the basihyal bone, we’ll follow the link Browse phenotypes (faceted view).


Quality facet for basihyal bone.

This takes us to a faceted browsing page—faceted browsing lists phenotypes that have been used in annotations within the KB, filtered by the facets on the left side of the page: entity, quality, taxon, or gene. The entity facet is already restricted to basihyal bone. By looking at the quality facet, we can see the categories of qualities associated with basihyal bone in the KB, and the number of different phenotypes for each. Click on morphology in the quality facet to further limit the data to phenotypes about basihyal bone morphology. The results table lists phenotypes that have been used in annotations of taxonomic characters or genes.

Link to phenotypes query from faceted browsing.

To explore basihyal bone morphology in more detail, click the link above the facets panel which says View these results as a phenotypes query.


Changing the query result type.

Query pages have a query panel on the left and results table to the right. After following the previous link, the query panel will be pre-filled with a phenotype consisting of the entity “basihyal bone” and the quality “morphology”. The type of result we are querying for can be changed using the dropdown menu at the top of the query panel. It should currently display Phenotypes; change it to Taxa to view taxa with data for basihyal bone morphology in the KB. In order to further refine the search, click Add next to the Taxon section of the query panel. In the resulting dialog, you can enter any taxon (try “Gymnotiformes”) to see only taxa within that group. Again using the drop down menu at the top of the query panel, you can change the query type to Phenotype annotations to taxa to view specific phenotypic annotations. The Source column provides a link to the original character state descriptions that have been annotated with this phenotype.

Changing query to "match all" instead of "match any".

In addition to viewing comparative data, we can also view related developmental genetic annotations from zebrafish. Using the Query for: dropdown menu, change the query type to Phenotype annotations to genes. The resulting table will display ZFIN annotations for genes affecting basihyal bone morphology. Source information for the zebrafish phenotype can be obtained from ZFIN by clicking the icon in the Source column and following the link. Some of these genes have multiple annotations matching the search criteria. To get a list of unique genes affecting basihyal morphology, change the result-type dropdown to Genes. The query panel allows us to add multiple criteria to the search: click Add within the Phenotype section and enter “Meckel’s cartilage” as the entity in the Choose Phenotype dialog. Initially the query will show genes that affect either Meckel’s cartilage or basihyal, but if you change any to all in the phenotype section, you will see only genes that affect both structures. Note: depending on the query type, intersections (“all”) are not always available. Try changing the query result type, using the drop down menu, to see what options are available.


Click the green + to add the results to the workspace.

Using the Workspace, it is possible to save results obtained via queries to be used as input to further queries. For example, we can learn more about the genes affecting both Meckel’s cartilage and the basihyal bone: in the upper left corner of the results table, click the green + icon to add them all to the Workspace. Then click Workspace near the top of the page to use your saved items. At first the genes we saved are grayed out, since they aren’t useful for the initially selected query.

Change the workspace query type.

Using the Send selections to: dropdown menu, change the query type to Phenotype annotations to genes. Then check the box next to each gene and press the Perform Query button. You’ll now be able to view the annotations for all of these genes.


Click the green + to add a single result row to the workspace.

The KB contains information about the phylogenetic publications which have been annotated by Phenoscape. We can use the Workspace to navigate to some of interest. Within the previous results table, we can see that the brpf1 gene affects Meckel’s cartilage shape. Click the + icon in the far left column of that result row to add that phenotype to the Workspace (the icon appears when your mouse hovers over the cell). Return to the workspace page and change the query type to Comparative publications using the dropdown menu.

Publication info popup.

Check the box next to “Meckel’s cartilage shape” in the Phenotypes section, then press the Perform Query button to see all the publications in the KB containing characters relating to the shape of Meckel’s cartilage. You can click on one of the publication names, such as “de Pinna 1993”, to see a popup with its full citation. Follow the View details for de Pinna 1993 link to see the detail page for this publication, including the abstract, original character matrix, and a list of examined specimens.


Visualizing data on the taxonomy

Two of the more experimental interfaces to the KB use the organismal taxonomy to display and browse phenotypic annotations. Both can be accessed from the Visualize data panel on the homepage. The Phenotypic profile tree allows you to enter multiple phenotypes, and then browse the taxonomy for branches in which some or all of the phenotypes co-occur. For example, we can find browse for taxa which are missing the adipose fin, dorsal fin, and caudal fin. The Phenotypic variation tree allows you to see the taxonomic distribution of all phenotypes matching a specification, such as dentary bone shape. Hover over a taxon in the tree to see which phenotypes in the table to the left occur there, and hover over a phenotype to see in which taxa the phenotype occurs.

Phenotypic profile tree.
Phenotypic variation tree.


Downloading data

Links to download bulk data.

Knowledgebase data can be downloaded in bulk—look for the Download links following data tables on each page. JSON is a structured text format useful to programmers. The plain-text output is tab-delimited and can be viewed within Microsoft Excel. Please contact us if you are interested in a different format (such as RDF) or would like a dump of all the data.

Providing feedback

Please contact us with suggestions on how to make this interface work better for you. At the top of each page of the KB, there is a prominent Feedback button. You can also send an email to help@phenoscape.org.