Difference between revisions of "Phenoscape use cases"

From phenoscape
(Map changes of an evolutionary character on a phylogeny (ranked #2 by TJV & PM; see two other similar mapping use cases, also ranked #2))
 
(53 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Identify candidate genes for a particular evolutionary phenotype==
+
= For South Dakota =
 +
 
 +
== UI functionality related to identifying and mapping evolutionary changes based on mutant phenotypes ==
 +
 
 +
=== Identify evolutionary phenotypes that match an input phenotype ===
 +
 
 +
'''Motivation'''
 +
 
 +
'''Example'''
 +
 
 +
'''Input'''
 +
* A phenotype description - e.g. input some entity and/or some quality.
 +
 
 +
'''Output'''
 +
* A list of annotations from the database which match that entity and quality, with taxon.
 +
 
 +
= Full List =
 +
 
 +
==1. Identify zebrafish candidate genes for an evolutionary phenotype (ranked #1 by TJV and PM)==
 
===Motivation===
 
===Motivation===
One focus of developmental biology is to understand how genes regulate development, and therefore examining the phenotypic effects of single gene mutations is a major emphasis in studies of zebrafish and other model organisms.  Genetic change underlies alterations in evolutionary characters as well, but the connection between specific genes and most evolutionary changes has not been made.  Thus, one of the first steps in investigating the developmental basis for a particular evolutionary change in morphology is to hypothesize a relationship between that morphology and a set of candidate genes.
+
To obtain one or more candidate genes for an evolutionary change in phenotype, one would like to know which genes, when perturbed in a model organism, give rise to a "similar" phenotypic difference between wildtype and mutant genotypes.
  
 
===Example===
 
===Example===
Extensive variation in the size, shape, presence and absence of bones characterizes the course of vertebrate evolution, and such variation is commonly used in phylogenetic analysis in fishes.  An evolutionary biologist observes variation in the size of a particular bone, ceratobranchial 5,  among Ostariophysi (Siebert, '87). The person queries the evolutionary phenotype database for matching mutant zebrafish phenotypes by using terms from shared ontologies: Entity = Ceratobranchial 5 [from TAO] and all qualities pertaining to attribute ‘size’ [from the PATO].  The response will be a list of zebrafish mutants and their phenotypes, along with the associated genes, and possibly gene expression imagessox9a is shown to have a role in size reduction in ceratobranchial 5 in the mutant line sox9ahi1134 (Yan et al., '05).  The evolutionary biologist would hypothesize that the regulation or sequence of sox9a  has been altered during evolution to result in the enlargement of this bone in two lineages, and they would  pursue the appropriate developmental genetic work to test this hypothesis.  They might further explore the  function of the gene in other model organisms.
+
User observes evolutionary variation among fishes in the size of the ceratobranchial 5 bone. User queries Phenoscape for matching mutant zebrafish phenotypes using Entity = Ceratobranchial 5 [from TAO] and all qualities pertaining to attribute ‘size’ [from the PATO].  The response is a list of zebrafish mutants and their phenotypes, along with the associated genes, and possibly gene expression images, in this case for genes such as sox9a, since there is a size reduction in ceratobranchial 5 in the mutant line sox9ahi1134.
  
 
===Input===
 
===Input===
A phenotype search specification: entity, quality, etc.  Option to match exactly or to match descendant terms (as in quality "size", above).
+
A phenotype search specification: entity (TAO), quality (PATO).  Option to match exactly or to match descendant terms (as in quality "size", above). [Also, option to match ancestral terms a node or two up will be frequently desired.  E.g. if a search yields no phenotype matches to "ceratobranchial 5 bone", the user may want to search "ceratobranchial bone" (Is_a parent, one node up), "ceratobranchial 5 cartilage" (develops_from relationship), "Pharyngeal arch skeleton (Part_of relationship).  even pharyngeal arch (more nodes up).  User will want to visualize the ontology simultaneously in order to make decisions about what nodes might be informative/how to proceed in a search.  --[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 15:50, 18 August 2008 (EDT)]
  
 
===Output===
 
===Output===
A list of ZFIN mutant identifiers with matching phenotype of each, associated gene, perhaps gene expression images (or links to).
+
A list of ZFIN mutant identifiers with matching phenotype(s) of each, associated gene(s), perhaps gene expression images (or links to). [Needs analysis workshop identified "Downloadable reports of query results (e.g. candidate genes; comparative phenotypic data)" as a priority --[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 18:15, 18 August 2008 (EDT)]
 +
 
 +
== Use cases related to identifying and mapping evolutionary changes based on mutant phenotypes ==
 +
 
 +
=== Identify evolutionary changes that match the phenotype of a zebrafish mutant (ranked #2 by TJV & PM; see two other similar mapping use cases, also ranked #2) ===
 +
 
 +
'''Motivation'''
 +
 
 +
It would be of interest to identify phenotypic variation among wild species that could plausibly arise from changes in the same gene that is perturbed in particular zebrafish mutant.
 +
 
 +
'''Example'''
 +
 
 +
User observes a reduction in number of branchiostegal rays in a zebrafish mutant for the gene endothelin-1. The user wants to know whether branchiostegal ray number is variable among fish species, and if so, what is the pattern of change across fish evolution. User queries Phenoscape using Entity = Branchiostegal rays [from TAO] and all qualities pertaining to attribute ‘count’ [from the PATO]. Phenoscape returns a list [just a list?--[[User:Tjvision|Tjvision]] 12:40, 15 August 2008 (EDT)] of taxa and phenotypes. The user would see that all cypriniforms, including zebrafish, have three branchiostegal rays, but other fishes, including close ostariophysan relatives, have higher and lower numbers. [Better to be able to return (default) phylogeny with mapped character state changes --[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 16:00, 18 August 2008 (EDT)]
 +
 
 +
'''Input'''
 +
 
 +
A phenotype search specification: entity, quality, etc. Option to match exactly or to match descendant terms (as in quality "count", above). [ Also, option to match ancestral terms a node or two up as per above use case --[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 16:02, 18 August 2008 (EDT)]
 +
 
 +
'''Output'''
 +
 
 +
A list of matching evolutionary phenotypes and the taxon for each.  [A list is too crude - the phenotypes should be phylogenetically mapped as in the use case below --[[User:Tjvision|Tjvision]] 12:40, 15 August 2008 (EDT)]
 +
 
 +
=== Map changes of an evolutionary character on a phylogeny (ranked #2 by TJV & PM; see two other similar mapping use cases, also ranked #2) ===
 +
 
 +
'''Motivation'''
 +
 
 +
After observing phenotypic variation among species in a given trait (as in use case [[#Identify evolutionary changes that match the phenotype of a zebrafish mutant|above]]), the user wants to know what the pattern of evolution of this trait has been.
 +
 
 +
'''Example'''
 +
 
 +
The user observes variation in number of branchiostegal rays across taxa from above.  They prompt Phenoscape to map the character changes on a phylogeny. From this they can see that all cypriniforms, including zebrafish, have three branchiostegal rays, but other fishes, including close ostariophysan  relatives, have higher and lower numbers. Specifically, reduction in number has occurred multiple times; solenostomids and syngnathids (ghost pipefishes and pipefishes), giganturids, and saccopharyngoid (gulper and swallower) eels have the fewest branchiostegal rays.
 +
 
 +
'''Input'''
 +
 
 +
A list of taxa and their phenotypes for a previously searched character specification.  A phylogenetic tree including the taxa of interest. [There should be trees internal to the system.  And I think this should simply be combined with the previous use case--[[User:Tjvision|Tjvision]] 13:02, 15 August 2008 (EDT)]
 +
 
 +
'''Output'''
 +
 
 +
A graphical representation of the phylogenetic tree (cladogram).  The branches are colored to represent reconstructed ancestral states of the given character values (or ambiguity) using, e.g. parsimony.  The phenotypic data matrix is shown at the tips.
 +
 
 +
=== View every change in an anatomical entity mapped on a tree (ranked #2 by PM with two other similar mapping use cases, also ranked #2) ===
 +
 
 +
'''Motivation'''
  
==Identify evolutionary changes that match the phenotype of a zebrafish mutant==
+
The user may be interested in how a particular structure has evolved, without knowing what types of changes have occurred in that structure.  It would be useful to view the pattern of evolution of all species phenotypes involving that structure, visualized on a phylogeny as in [[#Map changes of an evolutionary character on a phylogeny]].  [If multiple structures are examined, this could feed into a "generate me a NEXUS file" use case--[[User:Tjvision|Tjvision]] 13:20, 15 August 2008 (EDT)]  [Narrowed searches (e.g. from E="Branchiostegal rays", Q="all" to Q="count" are equivalent to Use cases "Map changes of an evolutionary character on a phylogeny" and "Identify evolutionary changes that match the phenotype of a zebrafish mutant" --[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 17:33, 18 August 2008 (EDT)].  A user may also want to broaden a search (e.g., to "E=dermal bone") in the cases where the search results are null--[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 16:35, 18 August 2008 (EDT)]
 +
 
 +
'''Example'''
 +
 
 +
A biologist is interested in the parietal bone.  She chooses this term from the anatomy ontology and then views a phylogeny displaying all reconstructed character transitions involving the parietal as an entity.
 +
 
 +
'''Input'''
 +
 
 +
An anatomical term from an anatomy ontology.  A (user supplied or built-in) phylogeny containing the species of interest.
 +
 
 +
'''Output'''
 +
 
 +
A display of the phylogeny mapping changes for each phenotypic character. (Possibly a listing of all phenotypes for each species which contain the entered term as an entity).
 +
 
 +
==3. Comparison of genetically and evolutionarily correlated characters==
 
===Motivation===
 
===Motivation===
With the rise of evo-devo, developmental biologists have become more interested in exploring the co-  variation of developmental and evolutionary traitsA common question is simply whether a particular trait varies in evolution and if so, what the pattern of evolution has been.
+
For phylogenetic systematics, one would like to know if two or more characters show phylogenetic correlation due to an underlying genetical/developmental correlationOne way to address this is to determine if changes to both (all) those characters are found in a single-gene zebrafish mutant. [The reverse of this use case can be imagined--[[User:Tjvision|Tjvision]] 12:55, 15 August 2008 (EDT)][agree with Todd--[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 16:03, 18 August 2008 (EDT)]
  
 
===Example===
 
===Example===
A developmental biologist observes a reduction in number of branchiostegal rays (bones in the gill membrane) in a zebrafish mutant due to changes in endothelin-1. The user wants to know whether branchiostegal ray number is variable among fish species, and if so, they want to see the pattern of change across fish evolution. They query the evolutionary phenotype database using terms from shared ontologies: Entity = Branchiostegal rays [from TAO] and all qualities pertaining to attribute ‘count’ [from the PATO]. The response will be a list of taxa and their matching evolutionary character changes or states. The user would see that all cypriniforms, including zebrafish, have three branchiostegal rays, but other fishes, including close ostariophysan relatives, have higher and lower numbers (McAllister, '68).
+
The user observes a suite of changes in the size of the dentary, maxilla, ceratohyal, and opercle bones that support the monophyly of a particular clade.  The user queries the system for zebrafish mutant phenotypes in which two or more of the above anatomical terms are used. Phenoscape returns sox9ahi1134, in which the the dentary, opercle, and maxilla bones are reduced in size relative to wild-type, whereas other bones are relatively unaffected.  [This seems like a variant on the first use case with multiple Es and no Qs, so perhaps these can be combined --[[User:Tjvision|Tjvision]] 12:55, 15 August 2008 (EDT)]
  
 
===Input===
 
===Input===
A phenotype search specification: entity, quality, etc. Option to match exactly or to match descendant terms (as in quality "count", above).
+
Multiple phenotype search specifications: entity, quality, etc., representing the evolutionary character changes. Option to match exactly or to match descendant terms (as in quality "count", above).[Also, option to match ancestral terms a node or two up.--[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 16:04, 18 August 2008 (EDT)]
  
 
===Output===
 
===Output===
A list of matching evolutionary phenotypes and the taxon for each.
+
A list of ZFIN mutant identifiers and associated genes which are associated with phenotypes matching 2 or more of the search criteria.  [The output should at least be a matrix of genes against phenotypes --[[User:Tjvision|Tjvision]] 12:55, 15 August 2008 (EDT)]  [Needs analysis workshop identified this "Correlation matrix of traits" as a high (#2) priority --[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 18:10, 18 August 2008 (EDT)]
  
==Compare genetically and evolutionarily correlated characters==
+
==4. View values for a particular character for a set of species with some value for another character (ranked equivalently with one other use case)==
 
===Motivation===
 
===Motivation===
Determining whether morphological characters are independent or genetically/developmentally correlated has been a long-  standing and intractable question in phylogenetic systematics (Sneath and Sokal, '73; Wiley, '81; Farris,  '83; O'Keefe and Wagner, '01).  Often the correlation between two (or more) characters is difficult to  ascertain, particularly when the characters involved are linked together at the molecular level.  However,  if evolutionary character changes could be matched to mutant developmental and morphological  phenotypes, single-gene mutant phenotype data from zebrafish would allow a detailed analysis of this issue for any evolutionary characters of interest.
+
A particular phenotype change may have evolutionary consequences for another aspect of phenotype. This may be because they are linked via developmental or physical constraints, or are related through their effect on natural selection.
  
 
===Example===
 
===Example===
On a phylogenetic tree of the Ostariophysi, an evolutionary biologist observes a suite  of the characters that support the monophyly of a particular clade.  These characters, however, are all marked by changes in size of the dentary, maxilla, ceratohyal, and opercle bones.  The user wants to know  whether the size modification of each of these bones represents independent support for this phylogenetic  hypothesis, or whether the changes are correlated due to a common genetic or developmental basis.  Querying the zebrafish mutant phenotype descriptions in EQ syntax with the above anatomical terms  would show that in sox9ahi1134 mutants, the dentary, opercle, and maxilla bones are reduced in size  relative to wild-type zebrafish, whereas other bones are relatively unaffected (Yan et al., '05).  This  suggests that the size of the dentary, opercle, and maxilla might be co-regulated in part by sox9a, and we  would conclude that support for the monophyly of this clade is not as strong as previously proposed.
+
User observes a number of species missing the parietal bone and notes that these species are also generally small in size. To determine the generality of that conclusion, the user searches for all species in the database which lack the parietal bone and requests the body length value for each. [Is this not also or alternatively done with zebrafish mutant data?--[[User:Tjvision|Tjvision]] 13:12, 15 August 2008 (EDT)]
  
 
===Input===
 
===Input===
Multiple phenotype search specifications: entity, quality, etc., representing the evolutionary character changes. Option to match exactly or to match descendant terms (as in quality "count", above).
+
A phenotype search specification for the phenotype to match.  A second phenotype search specification for the attribute for which to search for values.
  
 
===Output===
 
===Output===
A list of ZFIN mutant identifiers and associated genes which are associated with phenotypes matching all, or perhaps just more than one, of the search criteria.
+
A table containing, in each row, the name of the taxon matching the first entered phenotype, the value of the first phenotype (included under the assumption this may vary), and the value of the second phenotype.
  
==Map changes of an evolutionary character on a phylogeny==
+
==4. View all species with multiple phenotypes matching a condition==
 
===Motivation===
 
===Motivation===
After observing variation of a trait in evolution (as found in use case [[#Identify evolutionary changes that match the phenotype of a zebrafish mutant]], a biologist may further want to know what the pattern of evolution of this trait has been.  This can lead to hypotheses relating to how often this trait changes in evolution, such as whether such changes occur in parallel at many places on the evolutionary tree.
+
To find taxa (or mutants) matching complex phenotype descriptions.  [[This begins to really take advantage of ontological reasoning--[[User:Tjvision|Tjvision]] 13:16, 15 August 2008 (EDT) ]]
  
 
===Example===
 
===Example===
A biologist observes in number of branchiostegal rays across taxa in the database (such as in the results of [[#Identify evolutionary changes that match the phenotype of a zebrafish mutant]])The biologist maps the character changes on a phylogeny, and sees that all cypriniforms,  including zebrafish, have three branchiostegal rays, but other fishes, including close ostariophysan  relatives, have higher and lower numbers (McAllister, '68).  Specifically, reduction in number has  occurred multiple times; solenostomids and syngnathids (ghost pipefishes and pipefishes), giganturids,  and saccopharyngoid (gulper and swallower) eels have the fewest branchiostegal rays (McAllister, '68).
+
A biologist wants to list all the species that have lost more than one boneOr more specifically, all species that have lost more than one bone in the head.
  
 
===Input===
 
===Input===
A list of taxa and their phenotypes for a previously searched character specificationA phylogenetic tree including the taxa of interest.
+
A phenotype search specification, with constraints on the entity term such as "is_a term1" and "part_of term2"The threshold number of annotations matching the phenotype required to include a taxon.
  
 
===Output===
 
===Output===
A graphical representation of a phylogenetic tree (cladogram).  The branches are colored to represent reconstructed ancestral states of the given character values (or ambiguity).  The state reconstruction is performed using a standard algorithm such as parsimony or a maximum likelihood method.
+
A list of taxa (and/or mutants?) and their phenotypes matching the input criteria.
  
==View values for a particular character for a set of species with some value for another character==
+
==5. Find morphological hot spots==
 
===Motivation===
 
===Motivation===
A particular phenotype change may have evolutionary consequences for another aspect of phenotype.  This may be because they are linked via developmental or physical constraints, or are related through their effect on natural selection.
+
Some parts of anatomy may evolve rapidly relative to others.  These can be identified as those that exhibit many evolutionary changes in phenotype.  This could be a simple metric like finding anatomical terms that exhibit many different value states for characters.  A more complex analysis might perform ancestral state reconstruction for every character in the database, and return the entity terms involved in phenotypes with the most transitions. [Quality terms also of significant interest - is size, shape, or presence/absence the most common change in a particular clade? How does frequency of different types (size, shape, qualitative) compare across clades? compare between clades and mutants? --[[User:Pmabee@usd.edu|Pmabee@usd.edu]] 16:25, 18 August 2008 (EDT)]
 +
 
 +
[Are there other general properties of interest that are easily measured?  Slowest evolving, most/least evolutionary data available, affected by most/least mutants, etc].
  
 
===Example===
 
===Example===
A biologist observes a number of species missing the parietal bone.  It appears that these species are also generally small in size.  The biologist searches for all species in the database which lack the parietal bone.  He then requests the body length value for all those species.
+
The user wants to know whether structures that evolve rapidly share any genetic commonality. User obtains a list of rapidly evolving structures using this query, and then performs further analyses of those structures.
  
 
===Input===
 
===Input===
A phenotype search specification for the phenotype to match.  A second phenotype search specification for the attribute for which to search for values.
+
All phenotypes in the database.
  
 
===Output===
 
===Output===
A table containing a list of taxa matching the first entered phenotypeA second column in the table presenting the value of each taxon for the second entered character.
+
A list of anatomy terms exhibiting the highest number of phenotypes or changes, depending on the metric.
 +
 
 +
==6. Genetic or evolutionary modules: discovery and testing==
 +
 
 +
===Motivation===
 +
Some parts of anatomy may be developmentally integrated, sharing common genetic pathwaysStructures that are identified as sharing common developmental genes and/or pathways may be grouped as a possible module; this assemblage of entities can be mapped on phylogeny to see the level of constraint on its parts (i.e. whether it is evolutionarily conserved across, e.g. more nodes than one would expect from a randomly assembled group of entities).  Genetic module discovery mechanism unclear.
  
==View all species with multiple phenotypes matching a condition==
 
 
===Example===
 
===Example===
A biologist wants to list all the species that have lost more than one boneO more specifically, all species that have lost more than one bone in the head.
+
A user may want to know whether some a priori group of entities constitute a module (testing)User may also want to know whether modules exist and what constitutes them (discovery)
  
 
===Input===
 
===Input===
A phenotype search specification, with constraints on the entity term such as "is_a term1" and "part_of term2".  The threshold number of annotations matching the phenotype required to include a taxon.
+
All phenotypes in the database.
  
 
===Output===
 
===Output===
A list of taxa and their phenotypes matching the input criteria.
 
 
==View every change in an anatomical structure mapped on a tree==
 
==Motivation==
 
A biologist may be interested in how a particular structure has evolved, without knowing what types of changes have occurred in that structure.  It would be useful to view the pattern of evolution of all phenotypes involving that structure, visualized on a phylogeny as in [[#Map changes of an evolutionary character on a phylogeny]].
 
 
==Example==
 
A biologist is interested in the parietal bone.  She chooses this term from the anatomy ontology and then views a phylogeny displaying all reconstructed character transitions involving the parietal as an entity.
 
 
==Input==
 
An anatomical term from an anatomy ontology.  A phylogeny containing the species of interest.
 
 
==Output==
 
A listing of all phenotypes for each species which contain the entered term as an entity.  A display of the phylogeny mapping changes for each phenotypic character.
 
  
 
[[Category:Informatics]]
 
[[Category:Informatics]]
 +
[[Category:Use Cases]]

Latest revision as of 16:38, 26 September 2008

Contents

For South Dakota

UI functionality related to identifying and mapping evolutionary changes based on mutant phenotypes

Identify evolutionary phenotypes that match an input phenotype

Motivation

Example

Input

  • A phenotype description - e.g. input some entity and/or some quality.

Output

  • A list of annotations from the database which match that entity and quality, with taxon.

Full List

1. Identify zebrafish candidate genes for an evolutionary phenotype (ranked #1 by TJV and PM)

Motivation

To obtain one or more candidate genes for an evolutionary change in phenotype, one would like to know which genes, when perturbed in a model organism, give rise to a "similar" phenotypic difference between wildtype and mutant genotypes.

Example

User observes evolutionary variation among fishes in the size of the ceratobranchial 5 bone. User queries Phenoscape for matching mutant zebrafish phenotypes using Entity = Ceratobranchial 5 [from TAO] and all qualities pertaining to attribute ‘size’ [from the PATO]. The response is a list of zebrafish mutants and their phenotypes, along with the associated genes, and possibly gene expression images, in this case for genes such as sox9a, since there is a size reduction in ceratobranchial 5 in the mutant line sox9ahi1134.

Input

A phenotype search specification: entity (TAO), quality (PATO). Option to match exactly or to match descendant terms (as in quality "size", above). [Also, option to match ancestral terms a node or two up will be frequently desired. E.g. if a search yields no phenotype matches to "ceratobranchial 5 bone", the user may want to search "ceratobranchial bone" (Is_a parent, one node up), "ceratobranchial 5 cartilage" (develops_from relationship), "Pharyngeal arch skeleton (Part_of relationship). even pharyngeal arch (more nodes up). User will want to visualize the ontology simultaneously in order to make decisions about what nodes might be informative/how to proceed in a search. --Pmabee@usd.edu 15:50, 18 August 2008 (EDT)]

Output

A list of ZFIN mutant identifiers with matching phenotype(s) of each, associated gene(s), perhaps gene expression images (or links to). [Needs analysis workshop identified "Downloadable reports of query results (e.g. candidate genes; comparative phenotypic data)" as a priority --Pmabee@usd.edu 18:15, 18 August 2008 (EDT)]

Use cases related to identifying and mapping evolutionary changes based on mutant phenotypes

Identify evolutionary changes that match the phenotype of a zebrafish mutant (ranked #2 by TJV & PM; see two other similar mapping use cases, also ranked #2)

Motivation

It would be of interest to identify phenotypic variation among wild species that could plausibly arise from changes in the same gene that is perturbed in particular zebrafish mutant.

Example

User observes a reduction in number of branchiostegal rays in a zebrafish mutant for the gene endothelin-1. The user wants to know whether branchiostegal ray number is variable among fish species, and if so, what is the pattern of change across fish evolution. User queries Phenoscape using Entity = Branchiostegal rays [from TAO] and all qualities pertaining to attribute ‘count’ [from the PATO]. Phenoscape returns a list [just a list?--Tjvision 12:40, 15 August 2008 (EDT)] of taxa and phenotypes. The user would see that all cypriniforms, including zebrafish, have three branchiostegal rays, but other fishes, including close ostariophysan relatives, have higher and lower numbers. [Better to be able to return (default) phylogeny with mapped character state changes --Pmabee@usd.edu 16:00, 18 August 2008 (EDT)]

Input

A phenotype search specification: entity, quality, etc. Option to match exactly or to match descendant terms (as in quality "count", above). [ Also, option to match ancestral terms a node or two up as per above use case --Pmabee@usd.edu 16:02, 18 August 2008 (EDT)]

Output

A list of matching evolutionary phenotypes and the taxon for each. [A list is too crude - the phenotypes should be phylogenetically mapped as in the use case below --Tjvision 12:40, 15 August 2008 (EDT)]

Map changes of an evolutionary character on a phylogeny (ranked #2 by TJV & PM; see two other similar mapping use cases, also ranked #2)

Motivation

After observing phenotypic variation among species in a given trait (as in use case above), the user wants to know what the pattern of evolution of this trait has been.

Example

The user observes variation in number of branchiostegal rays across taxa from above. They prompt Phenoscape to map the character changes on a phylogeny. From this they can see that all cypriniforms, including zebrafish, have three branchiostegal rays, but other fishes, including close ostariophysan relatives, have higher and lower numbers. Specifically, reduction in number has occurred multiple times; solenostomids and syngnathids (ghost pipefishes and pipefishes), giganturids, and saccopharyngoid (gulper and swallower) eels have the fewest branchiostegal rays.

Input

A list of taxa and their phenotypes for a previously searched character specification. A phylogenetic tree including the taxa of interest. [There should be trees internal to the system. And I think this should simply be combined with the previous use case--Tjvision 13:02, 15 August 2008 (EDT)]

Output

A graphical representation of the phylogenetic tree (cladogram). The branches are colored to represent reconstructed ancestral states of the given character values (or ambiguity) using, e.g. parsimony. The phenotypic data matrix is shown at the tips.

View every change in an anatomical entity mapped on a tree (ranked #2 by PM with two other similar mapping use cases, also ranked #2)

Motivation

The user may be interested in how a particular structure has evolved, without knowing what types of changes have occurred in that structure. It would be useful to view the pattern of evolution of all species phenotypes involving that structure, visualized on a phylogeny as in #Map changes of an evolutionary character on a phylogeny. [If multiple structures are examined, this could feed into a "generate me a NEXUS file" use case--Tjvision 13:20, 15 August 2008 (EDT)] [Narrowed searches (e.g. from E="Branchiostegal rays", Q="all" to Q="count" are equivalent to Use cases "Map changes of an evolutionary character on a phylogeny" and "Identify evolutionary changes that match the phenotype of a zebrafish mutant" --Pmabee@usd.edu 17:33, 18 August 2008 (EDT)]. A user may also want to broaden a search (e.g., to "E=dermal bone") in the cases where the search results are null--Pmabee@usd.edu 16:35, 18 August 2008 (EDT)]

Example

A biologist is interested in the parietal bone. She chooses this term from the anatomy ontology and then views a phylogeny displaying all reconstructed character transitions involving the parietal as an entity.

Input

An anatomical term from an anatomy ontology. A (user supplied or built-in) phylogeny containing the species of interest.

Output

A display of the phylogeny mapping changes for each phenotypic character. (Possibly a listing of all phenotypes for each species which contain the entered term as an entity).

3. Comparison of genetically and evolutionarily correlated characters

Motivation

For phylogenetic systematics, one would like to know if two or more characters show phylogenetic correlation due to an underlying genetical/developmental correlation. One way to address this is to determine if changes to both (all) those characters are found in a single-gene zebrafish mutant. [The reverse of this use case can be imagined--Tjvision 12:55, 15 August 2008 (EDT)][agree with Todd--Pmabee@usd.edu 16:03, 18 August 2008 (EDT)]

Example

The user observes a suite of changes in the size of the dentary, maxilla, ceratohyal, and opercle bones that support the monophyly of a particular clade. The user queries the system for zebrafish mutant phenotypes in which two or more of the above anatomical terms are used. Phenoscape returns sox9ahi1134, in which the the dentary, opercle, and maxilla bones are reduced in size relative to wild-type, whereas other bones are relatively unaffected. [This seems like a variant on the first use case with multiple Es and no Qs, so perhaps these can be combined --Tjvision 12:55, 15 August 2008 (EDT)]

Input

Multiple phenotype search specifications: entity, quality, etc., representing the evolutionary character changes. Option to match exactly or to match descendant terms (as in quality "count", above).[Also, option to match ancestral terms a node or two up.--Pmabee@usd.edu 16:04, 18 August 2008 (EDT)]

Output

A list of ZFIN mutant identifiers and associated genes which are associated with phenotypes matching 2 or more of the search criteria. [The output should at least be a matrix of genes against phenotypes --Tjvision 12:55, 15 August 2008 (EDT)] [Needs analysis workshop identified this "Correlation matrix of traits" as a high (#2) priority --Pmabee@usd.edu 18:10, 18 August 2008 (EDT)]

4. View values for a particular character for a set of species with some value for another character (ranked equivalently with one other use case)

Motivation

A particular phenotype change may have evolutionary consequences for another aspect of phenotype. This may be because they are linked via developmental or physical constraints, or are related through their effect on natural selection.

Example

User observes a number of species missing the parietal bone and notes that these species are also generally small in size. To determine the generality of that conclusion, the user searches for all species in the database which lack the parietal bone and requests the body length value for each. [Is this not also or alternatively done with zebrafish mutant data?--Tjvision 13:12, 15 August 2008 (EDT)]

Input

A phenotype search specification for the phenotype to match. A second phenotype search specification for the attribute for which to search for values.

Output

A table containing, in each row, the name of the taxon matching the first entered phenotype, the value of the first phenotype (included under the assumption this may vary), and the value of the second phenotype.

4. View all species with multiple phenotypes matching a condition

Motivation

To find taxa (or mutants) matching complex phenotype descriptions. [[This begins to really take advantage of ontological reasoning--Tjvision 13:16, 15 August 2008 (EDT) ]]

Example

A biologist wants to list all the species that have lost more than one bone. Or more specifically, all species that have lost more than one bone in the head.

Input

A phenotype search specification, with constraints on the entity term such as "is_a term1" and "part_of term2". The threshold number of annotations matching the phenotype required to include a taxon.

Output

A list of taxa (and/or mutants?) and their phenotypes matching the input criteria.

5. Find morphological hot spots

Motivation

Some parts of anatomy may evolve rapidly relative to others. These can be identified as those that exhibit many evolutionary changes in phenotype. This could be a simple metric like finding anatomical terms that exhibit many different value states for characters. A more complex analysis might perform ancestral state reconstruction for every character in the database, and return the entity terms involved in phenotypes with the most transitions. [Quality terms also of significant interest - is size, shape, or presence/absence the most common change in a particular clade? How does frequency of different types (size, shape, qualitative) compare across clades? compare between clades and mutants? --Pmabee@usd.edu 16:25, 18 August 2008 (EDT)]

[Are there other general properties of interest that are easily measured? Slowest evolving, most/least evolutionary data available, affected by most/least mutants, etc].

Example

The user wants to know whether structures that evolve rapidly share any genetic commonality. User obtains a list of rapidly evolving structures using this query, and then performs further analyses of those structures.

Input

All phenotypes in the database.

Output

A list of anatomy terms exhibiting the highest number of phenotypes or changes, depending on the metric.

6. Genetic or evolutionary modules: discovery and testing

Motivation

Some parts of anatomy may be developmentally integrated, sharing common genetic pathways. Structures that are identified as sharing common developmental genes and/or pathways may be grouped as a possible module; this assemblage of entities can be mapped on phylogeny to see the level of constraint on its parts (i.e. whether it is evolutionarily conserved across, e.g. more nodes than one would expect from a randomly assembled group of entities). Genetic module discovery mechanism unclear.

Example

A user may want to know whether some a priori group of entities constitute a module (testing). User may also want to know whether modules exist and what constitutes them (discovery)

Input

All phenotypes in the database.

Output