Difference between revisions of "Guide to Character Annotation"

From phenoscape
(Post-composition: Refining entity terms on-the-fly)
(Post-composition using spatial terms)
Line 80: Line 80:
 
However, unlike pre-composed terms, post-composed terms are anonymous, and therefore if the same post-composition is used multiple times, it has the same semantics, but not the same identity. For example, if one wants to assign multiple annotations to the same bony projection of the lateral ethmoid in the same specimen, using post-composed terms does not allow the identity of the anatomical structure between the annotations to be inferred.
 
However, unlike pre-composed terms, post-composed terms are anonymous, and therefore if the same post-composition is used multiple times, it has the same semantics, but not the same identity. For example, if one wants to assign multiple annotations to the same bony projection of the lateral ethmoid in the same specimen, using post-composed terms does not allow the identity of the anatomical structure between the annotations to be inferred.
  
===Post-composition using spatial terms===
+
===Post-composition: Refining qualities using spatial terms===
 
The Spatial Ontology is used to post-compose terms related to bone margins, surfaces, or regions.  For example, the character “anterior margin of frontal bone serrate” is post-composed as follows:
 
The Spatial Ontology is used to post-compose terms related to bone margins, surfaces, or regions.  For example, the character “anterior margin of frontal bone serrate” is post-composed as follows:
  
Type “anterior margin” in the entity field and click the “comp” button.  Note that the term anterior margin is expanded in the Post Composition window because “anterior margin” is a pre-coordinated term in the Spatial Ontology.  Click the + button to add relationship = part_of and differentia = frontal bone.  Click the OK button.
+
Type “anterior margin” in the entity field and click the “comp” button.  Note that the term anterior margin is expanded in the Post Composition window because “anterior margin” is a pre-coordinated term in the Spatial Ontology (from "anatomical margin" that has the position "anterior").  Click the + button to add relationship = part_of and differentia = frontal bone.  Click the OK button.
  
 
[[Image:postcomposition2.png]]
 
[[Image:postcomposition2.png]]
 
   
 
   
 
The post-composed term for anterior margin of frontal appears as:
 
The post-composed term for anterior margin of frontal appears as:
anatomical margin^has_position(anterior)^part_of(frontal bone)
+
anatomical margin^has_position(anterior)^part_of(frontal bone)
 +
 
 +
As for semantics, identifiability, and rules for post-composing, the same applies as above for entity terms. Start with the more general term (for example, the "anterior margin") as the genus, then refine it using a relationship and a differentia term (for example, anterior margin that is part-of the "frontal bone").
  
 
===Size qualities===
 
===Size qualities===

Revision as of 15:02, 20 April 2008

Genus-differentia definitions

Term definitions in the teleost anatomy ontology (TAO) take the form of genus-differentia definitions: B is an A that has X.

The term B is defined by its membership in higher category A and distinguished from its sibling terms by characteristic X. The following are examples of genus-differentia definitions in the TAO:

  1. Antorbital: Dermal bone that is located on the anterior margin of the infraorbital series, dorsal to the first infraorbital and lateral to the nasal bone.
  2. Dentary: Dermal bone that forms the anterolateral part of the lower jaw.

In example 1, the definition mentions the parent dermal bone of the term antorbital, followed by the characteristics that differentiate antorbital from all other dermal bones.

Post-composed terms (terms created on-the-fly at the time of annotation) take the form of genus-differentia definitions (see Character Type 5, below).

Evidence Codes

We record phenotype descriptions as properties of species, and annotations are assigned one of three evidence codes based on the level of evidence given by an author for phenotype observations. These specimen evidence codes are in an Evidence Codes Ontology that was developed by the broader biological community (see http://obofoundry.org/cgi-bin/detail.cgi?id=evidence_code). We have added evidence codes to this ontology, and we use the following in order below from strong to weak evidence.

Inferred from Voucher Specimen (IVS)

Used when an annotation is made on the basis of a phenotype description for a species or higher level group that is given by an author who explicitly references an observation of a voucher specimen(s). Voucher specimens are defined as those specimens with permanent museum catalog numbers. Thus it would be possible for a person to examine this particular specimen and observe the annotated phenotype.

Traceable Author Statement (TAS)

The TAS evidence code covers author statements that are attributed to a cited source. Typically this type of information comes from review articles. Material from the introductions and discussion sections of non-review papers may also be suitable if another reference is cited as the source of experimental work or analysis. When annotating with this code the curator should use caution and be aware that authors often cite papers dealing with experiments that were performed in organisms different from the one being discussed in the paper at hand. Thus a problem with the TAS code is that it may turn out from following up the references in the paper that no experiments were performed on the gene in the organism actually being characterized in the primary paper. For this reason we recommend (when time and resources allow) that curators track down the cited paper and annotate directly from the experimental paper using the appropriate experimental evidence code. When this is not possible and it is necessary to annotate from reviews, the TAS code is the appropriate code to use for statements that are associated with a cited reference. Once an annotation has been made to a given term using an experimental evidence code, we recommend removing any annotations made to the same term using the TAS evidence code.

Nontraceable Author Statement (NAS)

The NAS evidence code should be used in all cases where the author makes a statement that a curator wants to capture but for which there are neither results presented nor a specific reference cited in the source used to make the annotation. The source of the information may be peer reviewed papers, textbooks, database records or vouchered specimens.

Character types

The following are examples of character types commonly enountered in the systematic literature and how we annotate them using the EQ model in Phenote. Abbreviations: E, entity; Q, quality, AE, additional entity, C, count.

Presence/absence characters

E: pectoral fin, Q: present
E: pectoral fin, Q: absent

Note that “presence” is the parent term for absent and present, and should not be used in annotations.

Characters using monadic qualities

Monadic qualities are those that exist in a single entity, such as shape, and do not require another entity. For example, annotation of “sigmoid-shaped supraorbital bone” is entered as:

E: supraorbital, Q: sigmoid

Characters using relational qualities

Relational qualities are those that exist in an entity but require an additional entity in order to exist. For example, annotation of “parietal fused with supraoccipital” is entered as:

E: parietal, Q: fused with, AE: supraoccipital

Characters involving presence/absence of developmentally dependent entities

An example is bone develops_from cartilage.

Interhyal: (0) present and ossified; (1) present and cartilaginous; (2) absent

E: Interhyal bone, Q: present
E: Interhyal cartilage, Q: present
E: Interhyal cartilage, Q: absent(*)

(*)Note that because interhyal bone develops_from interhyal cartilage, we can simply state that interhyal cartilage is absent, and it is implied that interhyal bone is also absent.

Meristic data

Characters involving counts of entities are annotated using the “count” quality. Values for counts are entered in the “count” field. Note that ranges and lower or upper bounds can be recorded:

E: vertebra, Q: count, C: 33 
E: vertebra, Q: count, C: 34-38
E: vertebra, Q: count, C: >38 

Could say here: Relationships across taxa between individual entities in a meristic series (e.g. vertebra 4 in a zebrafish vs. vertebra 4 in an eel), are not necessarily homologous. These can be handled in several ways, and we will discuss them here.

Post-composition: Refining entity terms on-the-fly

Terms can be refined, or post-composed, at the time of annotation rather than using a sufficiently granular term from the ontology (i.e., a pre-composed term). Post-composed terms are created in Phenote and follow genus-differentia definitions, where one term serves as the genus, which is then differentiated using a relationship and a differentia term. Unlike pre-composed terms, post-composed terms do not have an ID, and hence is an "anonymous term."

To post-compose the entity “bony projection of lateral ethmoid”, type “bony projection” in the Entity field, click the “Comp” button, select “part_of” in the relationship field, and type “lateral ethmoid” in differentia field. Click OK.

Error creating thumbnail: Unable to save thumbnail to destination

The post-composed term appears as

E: bony projection ^part_of(lateral ethmoid)

The order in which the terms are composed is important if the composition relationship is not reflexive (a relationship is reflexive iff A rel B <=> B rel A), which most relationships are not. As a general rule, choose the more general part (for example, the "bony projection") as the genus, and then use the relationship and differentia to narrow down (for example, which bony projection of the many that are possible do you mean).

Note that semantically, the post-composed term is equivalent to a pre-composed term (e.g., "bony projecttion of lateral ethmoid"), provided the pre-composed terms has both the inheritance relationship ("bony projection of lateral ethmoid" is-a "bony projection) and the cross-product relationship ("bony projection of lateral ethmoid" part-of "lateral ethmoid") properly recorded.

However, unlike pre-composed terms, post-composed terms are anonymous, and therefore if the same post-composition is used multiple times, it has the same semantics, but not the same identity. For example, if one wants to assign multiple annotations to the same bony projection of the lateral ethmoid in the same specimen, using post-composed terms does not allow the identity of the anatomical structure between the annotations to be inferred.

Post-composition: Refining qualities using spatial terms

The Spatial Ontology is used to post-compose terms related to bone margins, surfaces, or regions. For example, the character “anterior margin of frontal bone serrate” is post-composed as follows:

Type “anterior margin” in the entity field and click the “comp” button. Note that the term anterior margin is expanded in the Post Composition window because “anterior margin” is a pre-coordinated term in the Spatial Ontology (from "anatomical margin" that has the position "anterior"). Click the + button to add relationship = part_of and differentia = frontal bone. Click the OK button.

Error creating thumbnail: Unable to save thumbnail to destination

The post-composed term for anterior margin of frontal appears as:

anatomical margin^has_position(anterior)^part_of(frontal bone)

As for semantics, identifiability, and rules for post-composing, the same applies as above for entity terms. Start with the more general term (for example, the "anterior margin") as the genus, then refine it using a relationship and a differentia term (for example, anterior margin that is part-of the "frontal bone").

Size qualities

Because size qualities are monadic terms, comparison of size of one bone relative to another requires post-composition of the size quality. For example, the character “frontal length greater than parietal length” is entered as:

E: frontal 
Q: increased length, relative_to partietal(*)

(*)To post-compose the size quality, type ‘increased length’ in the quality field and click “comp” button. Select ‘relative_to’ in the relationship field and type ‘parietal’ in the differentia field. click OK.

Size qualities with ratio

For the characters in which a proportion or ratio is given in relating the length of one bone to another, the value of ratio is recorded. For example: Length of infraorbital 2: (0) over twice as long as infraorbital 1; (1) less than twice as long as infraorbital 1. This would be indicated in Phenote as follows:

E: infraorbital 2, Q: increased length, relative_to: infraorbital 1, Measurement: >2, Unit: ratio
E1: Infraorbital 2, Q: decreased length, relative_to: infraorbital 1, Measurement: <2, Unit: ratio

The qualities are post-composed.