Plant Ontology Response to OBO Foundry Review

From Plant Ontology Wiki
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

The Plant Ontology underwent a rigorous review in 2013 and was accepted as a full member of the OBO Foundry

Review document: Media:PO_Review_August_2013.pdf

OBO Foundry Principles

Domain of ontology: Plant anatomy, morphology and growth and development and their association to plant genomics data for all plants.

Summary of Review Findings

"In general, we found that the Plant Ontology is a good ontology, largely following the principles as laid down by the Foundry. We have some specific recommendations for improvements but found no major significant shortfalls in the offering. The following table summarizes the findings of this review on a per principle basis, and detailed discussion of each point follows."

# Principle Comments
1. Open Some improvement desirable
2. Common format Pass
3. Foundry URIs Pass
4. Versioning Pass
5. Clearly delineated content Some improvement desirable
6. Textual definitions Some improvement desirable
7. Relations Some improvement desirable
8. Documentation Pass
9. Plurality of users Pass
10. Collaboration Pass
11. Single locus of authority Pass
12. Naming conventions Pass
16. Maintenance Pass

PO Responses to OBO Foundry Review of Plant Ontology

Responses to the points requiring improvement shown in italics

Principle 1: The Ontology is Open

"Some improvement desirable"

"The self-review states that the PO is released under a Creative Commons license. However, it is not specified which Creative Commons license has been chosen. The ontology file does not contain a statement about the license or the policy for reuse of the ontology. However, the information is available on the website e.g. at http://plantontology.org/docs/otherdocs/principles_rationales.html: Plant Ontology by Plantontology.org is licensed under a Creative Commons Attribution-NoDerivs 3.0 United States License."

"We recommend that the exact license chosen be included in an additional ontology annotation in the ontology file."

"According to the OBO Foundry principle 1 documentation, this should make use of two annotations using the following properties:

  • dc:license
  • rdfs:comment

The license type goes in the dc:license field. The mode of attribution goes in the rdfs:comment field. "

"While 'Creative Commons 3.0 CC-by license' is recommended, this is not mandatory and therefore the chosen attribution-noderivs license is also compatible with the Open principle. However, we urge you to consider weakening the license to one that encourages sharing and reuse without constraint to further the adoption by the community and the value of the resource for the community." Reply: We chose the CC-BY-ND license, because in the past the derivatives (including changing the relationships and graph besides adding new terms) were created and it was difficult for us to track. Also by having ND clause, users are encouraged to go back to the source and request their suggested edits.

Done: The license info is at the bottom of every page of the browser, plus we created a License wiki page with the human-readable version of the file. The full text of the legal version of the license was also copied to a text file and saved in the Live Tag folder. We also added a note about the license as a comment in header.

Principle 2: Common Format

"Pass"

"The ontology is available in both OBO and OWL formats. It should be noted that the OBO form of the ontology contains semantics which are not yet available in the OWL form (i.e. the treat-xrefs-as-isa and treat-xrefs-as-genus-differentiae constructs). These are supported by the Oort release manager and can be instantiated in OWL versions of the ontology. See https://code.google.com/p/owltools/wiki/OortOptions

Reply: We can do this at the next release, as we use Oort to generate various different versions of the file anyway, or not depending on the effect. Should add a comment on the Release SOP Page if we are going to do so.

Principle 3: Foundry-style URIs

"Pass"

"The ontology uses numeric Foundry URIs."

Principle 4: Versioning

"Pass"

"The ontology uses date stamps for versioning. These are reflected in the OBO and OWL versions appropriately. We note that the PO version in OntoBee was not the same as their latest release described on their website and available from the OBO Foundry download page at the time of doing the review, however, this seemed to have been a problem with the OntoBee updating mechanism rather than with the PO itself."

Reply: This is not completely correct- we actually release the new versions of the PO on an approximately quarterly cycles. Those are numbered consecutively. Latest release was Version #20, July 2013.


Principle 5: Clearly Delineated Content

Some improvement desirable

"There are several sub-issues that are contained in this principle. - Firstly, the ontology needs to have a clearly delineated scope as expressed in a statement of scope. PO does have a clearly delineated scope, and this scope does not substantially duplicate the scope of any other OBO Library ontology. - Secondly, the ontology needs to have a clear upper level with root terms having definitions that indicate the content of the sub-ontologies included in the ontology. Here, we have some concerns as detailed below. - Thirdly, the ontology should not contain terminology that overlaps with other OBO ontologies except where content has been imported for reuse in specific contexts appropriate to the domain of the ontology. - Finally, the ontology should provide adequate coverage with respect to its stated domain so as to justify its use in applications. Concerns about the upper levels of the plant ontology:

"The definition of the root term ‘plant anatomical entity’ appears intended to be a plant specific subclass of the CARO term ‘anatomical entity’ and is defined as “An anatomical entity that is or was part of a plant.”

"The CARO class states that an anatomical entity is part of or located in an organism (or virus or viroid in the upcoming release of CARO), however here you include things that were once part of a plant. In OBI or ERO, such entities would be considered specimens or samples. Can you explain why this is needed? If it is justified, there is some cross-ontology coordination that should be performed."

Reply:

  • anatomical entity (CARO:0000000): Biological entity that is either an individual member of a biological species or constitutes the structural organization of an individual member of a biological species.
  • plant anatomical entity (PO:0025131): An anatomical entity that is or was part of a plant. Comment: Includes both material entities such as plant structures and immaterial entities such as plant anatomical spaces.
  • specimen (obo:OBI_0100051): A material entity that has the specimen role. Note: definition is 'in specimen creation' objective which is defined as an objective to "obtain and store a material entity for potential use as an input during an investigation".
  • sample from organism (obo:OBI_0000671): a material obtained from an organism in order to be a representative of the whole.

In the PO, we include anatomical entities that were part of a plant since many plant parts are no longer connected to the parent plant, for example grains or other fruits, wood, or leaves.

We could add a comment or Xref to refer to the OBI or ERO terms, but the problem with this is that the various plant parts are not representative of the whole plant nor are they always intended for input during an investigation. Also the OBI entities specimen and sample from an organism applies to the samples that were put together for isolating some features, in this case an RNA, DNA, protein etc. In our cases of annotation the whole body can be a specimen. Therefore, to keep the confusion of samples away and not mix it up with the OBI, we went to the intended path.


"There is a need to define the high-level distinction between plant structure vs. portion of plant substance better: currently ‘plant structure’ is defined as anatomical entity that is or was part of a plant; but substances are also (or were also) part of a plant. This is likely because these are intended to be subclasses of the CARO classes, that have more specific differentia, however, there is no mireot or subclass assertion to these classes other than in the comment field. Explicit use of the CARO classes will help differentiate these top-level nodes, and inclusion of their logical class definitions can help with error-checking."

Reply: Currently:

  • plant structure (PO:0009011): An anatomical structure that is or was part of a plant, or was derived from a part of a plant. Comment: 'Part' includes both proper parts and the whole plant. CARO:0000003 anatomical structure is defined as: Material anatomical entity that has inherent 3D shape and is generated by coordinated expression of the organism's own genome.
  • portion of plant substance (PO:0025161): A portion of organism substance that is or was part of a plant.Comment: Refers to portion of organism substance (CARO:0000004) which is defined as: Material anatomical entity in a gaseous, liquid, semisolid or solid state; produced by anatomical structures or derived from inhaled and ingested substances that have been modified by anatomical structures as they pass through the body. For plants, the word "body" refers to a whole plant or part thereof. Can include substances like latex, xylem sap, phloem sap, resin, mucilage, oil, cuticle, cutin, sporopollenin.

The first is an “anatomical structure” while the second is a “portion of organism substance”. Since the PO is developed in OBOF, we added the comments to clarify that these are indeed referencing the CARO terms, which differentiate them. We also used the CARO ID as a DBXref.

The current PO version defines ‘portion of plant substance’ is a plant anatomical entity and is part of some other plant structure. e.g. cuticular wax. (http://www.plantontology.org/amigo/go.cgi?action=dotty&view=details&search_constraint=terms&query=PO:0025386). This ontology graph is similar to the one we see for ‘cytoplasm’ in GO (http://amigo.geneontology.org/cgi-bin/amigo/browse.cgi?action=set-tree&term=GO:0005737).


"If you consider the above point on the definition of ‘anatomical entity’ referring to in vivo entities, you could consider moving ‘in vitro plant structure’ to be its own root outside anatomical entity, as it would technically be a derived structure and not part of or located within an organism (or are most of these simple plants cultured in vitro?). Efforts have been made recently in the CL and OBI to represent such things (e.g. “in environment” vs. “ex environment”, you could potentially leverage some of these design patterns and/or coordinate with them."

Reply: We disagree. Based on the CARO definition adopted by PO, it is still a plant structure that was once part of a plant. Unlike animals, we can regenerate the whole plant in-vitro as well from a single cell. Therefore we think it is placed in the appropriate location in the ontology graph.


"Other concerns from somewhat random sampling:"

"‘cultured plant embryo’ has two asserted superclasses. While asserted multiple inheritance is debatable in terms of ontology maintenance or ontological rigor (GO has a lot of this), in this case the example ensues because of a lack of logical class expression on this class. For example, this class could instead leverage a class restriction that states ‘plant embryo’ and is_specified_output of some in vitro plant culturing. In this way, you would infer the second parent, ‘in vitro plant structure’ (dependent on how you define things as per above). This would mean higher quality axioms, easier ontology maintenance, and interoperability with other ontologies such as OBI."

Reply: At the time of the revisions of this part of the ontology, when we set these up, there were no differentia we could use- tried to get PATO to add it, but had no success there. Class restrictions are available in OWL, but PO is developed in OBO.

For more info: see http://www.w3.org/TR/owl2-syntax/#Class_Expressions

Principle 6: Textual Definitions

"Some improvement desirable"

"We applaud the fact that the ontology does contain text definitions for all terms included in the ontology (see Appendix: Metrics) and for its extensive synonyms in numerous languages. However, we note that some of the text definitions do not exactly match the formal definitions as given in equivalence class or subclass axioms (specific examples contained below) and furthermore that not all of the textual definitions are as clear as they could be e.g. by following the genus differentia pattern (examples below).We advise continued evolution of the textual definitions contained in the ontology towards greater clarity for the benefit of all users, and gradual inclusion of a greater number of equivalent class definitions."

Reply: We agree wholehearted about the desirability of the genus differentia format for the text definitions and are continuing to revise any existing definitions to that form and all new definitions follow that form as well.

"Specific points:"

  • "Definitions such as that for ‘microgametophyte’, referencing IDs within the text, should be converted into logical definitions."

Reply: We reference the PO:IDs to maintain consistency in use of the terms and ensure the curators are reusing the PO terms already agreed upon. Also it allows our users to move directly to the referenced terms as they are hyperlinks (in this version of AmiGO, it only works in the comment field, but we have been told this should change with the transition to AmiGO 2.0). In some cases, we do have a cross product to a differentia such as in the term embryo plant cell (PO:0025028).

  • "‘pollen’ is textually defined as located_in some ‘pollen sac’ and logically it has the relationship part_of some pollen sac. This is an inconsistency with respect to the normal usage of these two relationships.”

Reply: This is valid- located _in was added in the July 2012 Release. Changed relationship ‘part_of some pollen sac’ to ‘located_in pollen sac’.

Principle 7: Use of Relations

"Some improvement desirable"

"For the most part, the PO uses RO relations. The relation that is PO specific is provided with adequate documentation in the form of a definition and comment. Some relations are, however, defined in the PO that are within RO or BFO scope and yet do not have appropriate cross-references/Mireoted URIs. These include ‘has_participant’, ‘located_in’ and ‘participates_in’. This should be addressed, and full inclusion of such properties will facilitate the use of their logical properties for error checking.

Reply: Agreed, We added the following xrefs to:"

  • ‘has_participant’: RO:0000057
  • ‘located_in’ : RO:0001025
  • ‘participates_in’: RO:0000056


"Specific points:"

  • "derives_by_manipulation_from is described as a subproperty of derives_from, whereby there has been a human processing step. This appears to be some kind of shortcut but isn’t yet logically defined as such. We would urge PO to work with OBI to leverage the work they have done in defining organismally derived entities, whereby such entities are the outcome of a ‘material processing’ process, has_specified_output the processed entity, and are derived_from the parent anatomical entity (for example see ‘urine specimen’).

Reply: Agreed, we can look at this in the future.

  • Plant developmental stage classes do not yet have precedes relations for temporal ordering. Consider using the stage relations (for example, existence_starts_during) from Uberon and similar to the zebrafish anatomy ontology, to relate organism developmental stages to the organismal entities at those stages. For example, ‘plant embryo’ could be defined as ‘whole plant' and (existence_ends_with some 'embryo stage') and (existence_starts_with some 'embryo stage') rather than use of the participates relation.

Reply: In the July 2013 release, #20, we added the relation “preceded_by” to temporally order the developmental stages of plant structures. You can find more info about the relations used in the PO at our wiki page: Relations in the Plant Ontology.


Principle 8: Documentation

"Pass" "Extrinsic: The ontology is well documented with an extensive website and several publications."

"Intrinsic: The ontology has high quality text definitions for every term."

"Specific points:"

  • There is some conflation in the use of annotation properties. A lot of information is placed in the comments field, including examples of usage, subclass assertions, and stage or taxon specific considerations. You may wish to break these out into more specific annotation properties. See IAO-core metadata and/or Uberon for some options, and please feedback to IAO if you desire a standard annotation property that isn’t yet available. http://code.google.com/p/information-artifact-ontology/wiki/OntologyMetadata

"In some cases, definitions are attributed to “POC:curators”. We’d urge you to consider use of specific persons or sources for attribution, and as the Foundry moves towards the use of ORCID IDs, to include these as part of your attribution strategy."

Reply: Many of our definitions are worked on by the group at our weekly meetings, not only by an individual curator. All the curators are listed on the POC Curators page on our wiki. These are all inked from browser.

"While we applaud the reference of tracker items directly in the ontology, these items can be included as URLs such that the link is easily made directly from the ontology, for example see ‘leptome’ to “OBO_SF_PO:3295055”. Similarly with the PO_REFs- please make these URLs or imports so that they can be easily located. It is likely that a new standardized annotation property for this purpose should be created and used across the Foundry."

Reply: As we are developing the PO in OBO, we currently do not have the capability to make these URLS, except for in the AmiGO browser, where they are converted to links. They can be located by searching the tracker for the number of interest, although the easier route is through the browser.

Principle 9: Plurality of Users

"Pass"

"The ontology contains a plurality of users as evidenced by the wealth of citations to the main publications in which the project has been presented (three top papers each cited >50 times)."

Principle 10: Collaboration

"Pass"

"The ontology has established many important collaborations and serves as a hub for the exchange of data and annotations in the domain as evidenced by the discussion contained in the paper Plant Ontology paper (Comparative and Functional Genomics 6 (7-8) 2005, p 388-397) and by the many citations. The PO developers have furthermore also participated in conferences and attended meetings hosted by developers of ontologies in other, related domains. Finally, the PO has offered a tracker to encourage community participation. The SourceForge tracker has 537 requests in total and there is evidence of continuous and recent responsiveness by the PO team to these requests."

Principle 11: Single Locus of Authority

"Pass"

"The PO has specified a single locus of authority."

Principle 12: Naming Conventions

"Pass"

"The PO uses singular nouns for naming the entities contained in the ontology. Names are unambiguous. Some terms, such as 'fruit', have an exceptionally high number of alternative IDs. Use of alternative IDs should be minimised wherever possible. However, it is understood that this scenario can arise for valid reasons having to do with legacy, therefore it is not specifically penalised."

Principle 16: Maintenance

"Pass"

"By their own admission, the PO is committed to the maintenance of the ontology in the light of scientific advance. The tracker and SVN repository show a history of ongoing maintenance that serves as sufficient grounds for optimism about continued performance into the future."