OBO Foundry

<!doctype html> <html lang="en"> <head> <title>OBO Foundry</title> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.2/dist/css/bootstrap.min.css">  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/themes/prism.css" />  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.9.1/font/bootstrap-icons.css">  <link rel="stylesheet" href="/assets/css/style.css"> <link type="application/atom+xml" rel="alternate" href="http://obofoundry.org/feed.xml" title="The OBO Foundry" /> <style> html, body { height: 100%; } body { display: flex; flex-flow: column; } .footer { margin-top: auto; padding-top: 1em; background-color: #f5f5f5; } </style> </head> <body><nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="/"> <img src="/images/foundrylogo.png" alt="" style="max-height: 24px" class="d-inline-block align-text-top"> OBO Foundry </a> <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarSupportedContent"> <ul class="navbar-nav me-auto mb-2 mb-lg-0"> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarAboutDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> About </a> <ul class="dropdown-menu" aria-labelledby="navbarAboutDropdown"> <li><a class="dropdown-item" href="/about-OBO-Foundry.html">About</a></li> <li><a class="dropdown-item" href="/docs/COC.html">Code of Conduct</a></li> <li><a class="dropdown-item" href="/resources">Resources</a></li> <li> <hr class="dropdown-divider"> </li> <li><a class="dropdown-item" href="/docs/OperationsCommittee.html">Operations Committee</a></li> <li><a class="dropdown-item" href="/docs/SOP.html" style="padding-left: 2em">Standard Operating Procedures</a></li> <li><a class="dropdown-item" href="/docs/EditorialWG.html" style="padding-left: 2em">Editorial Working Group</a></li> <li><a class="dropdown-item" href="/docs/TechnicalWG.html" style="padding-left: 2em">Technical Working Group</a></li> <li><a class="dropdown-item" href="/docs/OutreachWG.html" style="padding-left: 2em">Outreach Working Group</a></li> <li><a class="dropdown-item" href="/roles/">OBO Foundry Organizational Roles</a></li> <li> <hr class="dropdown-divider"> </li> <li><a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io">GitHub Project</a></li> <li><a class="dropdown-item" href="https://github.com/OBOFoundry">GitHub Organization</a></li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarPrinciplesDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Principles </a> <ul class="dropdown-menu" aria-labelledby="navbarPrinciplesDropdown"> <li><a class="dropdown-item" href="/principles/fp-000-summary.html">Overview</a></li> <li><a class="dropdown-item" href="/principles/fp-001-open.html">Open (principle 1)</a></li> <li><a class="dropdown-item" href="/principles/fp-002-format.html">Common Format (principle 2)</a></li> <li><a class="dropdown-item" href="/principles/fp-003-uris.html">URI/Identifier Space (principle 3)</a></li> <li><a class="dropdown-item" href="/principles/fp-004-versioning.html">Versioning (principle 4)</a></li> <li><a class="dropdown-item" href="/principles/fp-005-delineated-content.html">Scope (principle 5)</a></li> <li><a class="dropdown-item" href="/principles/fp-006-textual-definitions.html">Textual Definitions (principle 6)</a></li> <li><a class="dropdown-item" href="/principles/fp-007-relations.html">Relations (principle 7)</a></li> <li><a class="dropdown-item" href="/principles/fp-008-documented.html">Documentation (principle 8)</a></li> <li><a class="dropdown-item" href="/principles/fp-009-users.html">Documented Plurality of Users (principle 9)</a></li> <li><a class="dropdown-item" href="/principles/fp-010-collaboration.html">Commitment To Collaboration (principle 10)</a></li> <li><a class="dropdown-item" href="/principles/fp-011-locus-of-authority.html">Locus of Authority (principle 11)</a></li> <li><a class="dropdown-item" href="/principles/fp-012-naming-conventions.html">Naming Conventions (principle 12)</a></li> <li><a class="dropdown-item" href="/principles/fp-013-notification.html">Notification of Changes (principle 13)</a></li> <li><a class="dropdown-item" href="/principles/fp-016-maintenance.html">Maintenance (principle 16)</a></li> <li><a class="dropdown-item" href="/principles/fp-020-responsiveness.html">Responsiveness (principle 20)</a></li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarOntologiesDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Ontologies </a> <ul class="dropdown-menu" aria-labelledby="navbarOntologiesDropdown"> <li><a class="dropdown-item" href="/">Ontology Table</a></li> <li><a class="dropdown-item" href="/id-policy.html">ID Policy</a></li> <li><a class="dropdown-item" href="http://dashboard.obofoundry.org/dashboard/index.html">OBO Dashboard</a></li> <li> <hr class="dropdown-divider"> </li> <li> <a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io/tree/master/ontology"> Ontologies Metadata Source </a> </li> <li> <a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/registry/"> Combined Metadata </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/obo_context.jsonld"> JSON-LD 1.1 Context </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/ontologies.yml"> Ontology YAML </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/ontologies.jsonld"> Ontology JSON-LD </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/ontologies.ttl"> Ontology RDF/Turtle </a> </li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarCitationDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Citation </a> <ul class="dropdown-menu" aria-labelledby="navbarCitationDropdown"> <li><a class="dropdown-item" href="/citation/Citation.html">Cite Ontologies</a></li> <li><a class="dropdown-item" href="/citation/RelatedPublications.html">OBO Foundry Publications</a></li> <li><a class="dropdown-item" href="/citation/KnownPublications.html">Known OBO Foundry Ontology Publications</a></li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarParticipateDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Participate </a> <ul class="dropdown-menu" aria-labelledby="navbarParticipateDropdown"> <li> <a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io/issues">OBO Foundry Issue Tracker</a></li> <li> <a class="dropdown-item" href="https://groups.google.com/forum/#!forum/obo-discuss">OBO-Discuss Mail List</a> </li> <li> <a class="dropdown-item" href="https://groups.google.com/forum/#!members/obo-tools">OBO-Tools Mail List</a> </li> <li> <a class="dropdown-item" href="https://join.slack.com/t/obo-communitygroup/shared_invite/zt-1oq48ttk7-kKo0i6TwntYtAq~Jcjjg4g">OBO Community Slack channel</a> </li> <li> <a class="dropdown-item" href="/docs/NewOBOFC.html">Join the OBO Operations Committee</a> </li> <li> <a class="dropdown-item" href="/faq/how-do-i-register-my-ontology.html">Submit your ontology</a> </li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarNewsletterDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Newsletter </a> <ul class="dropdown-menu" aria-labelledby="navbarNewsletterDropdown"> <li><a class="dropdown-item" href="/newsletter/2024/10/14/6th-issue-newsletter.html">OBO Foundry Newsletter Issue 6</a></li> <li><a class="dropdown-item" href="/newsletter/2024/06/27/5th-issue-newsletter.html">OBO Foundry Newsletter Issue 5</a></li> <li><a class="dropdown-item" href="/newsletter/2024/03/18/4th-issue-newsletter.html">OBO Foundry Newsletter Issue 4</a></li> <li><a class="dropdown-item" href="/newsletter/2023/12/18/3rd-issue-newsletter.html">OBO Foundry Newsletter Issue 3</a></li> <li><a class="dropdown-item" href="/newsletter/2023/09/15/second-issue-newsletter.html">OBO Foundry Newsletter issue 2</a></li> <li><a class="dropdown-item" href="/newsletter/2023/06/16/inaugural-newsletter.html">Inaugural OBO Foundry Newsletter</a></li> </ul> </li> <li class="nav-item"> <a class="nav-link" href="/faq/index.html">FAQ</a> </li> </ul> </div> </div> </nav> <div class="container" style="margin-top: 2em; margin-bottom: 2em;"> <div class="content"> <div> <div class="page-header"> <h1> Principle: Textual Definitions (principle 6) </h1> <p></p> </div> </div> <div class="col-md-12"> <div class="row"> <div class="col-md-3"> <ul> <li> <a href="fp-000-summary.html">Overview</a> </li> <li> <a href="fp-001-open.html">Open (principle 1)</a> </li> <li> <a href="fp-002-format.html">Common Format (principle 2)</a> </li> <li> <a href="fp-003-uris.html">URI/Identifier Space (principle 3)</a> </li> <li> <a href="fp-004-versioning.html">Versioning (principle 4)</a> </li> <li> <a href="fp-005-delineated-content.html">Scope (principle 5)</a> </li> <li> <a href="fp-006-textual-definitions.html">Textual Definitions (principle 6)</a> </li> <li> <a href="fp-007-relations.html">Relations (principle 7)</a> </li> <li> <a href="fp-008-documented.html">Documentation (principle 8)</a> </li> <li> <a href="fp-009-users.html">Documented Plurality of Users (principle 9)</a> </li> <li> <a href="fp-010-collaboration.html">Commitment To Collaboration (principle 10)</a> </li> <li> <a href="fp-011-locus-of-authority.html">Locus of Authority (principle 11)</a> </li> <li> <a href="fp-012-naming-conventions.html">Naming Conventions (principle 12)</a> </li> <li> <a href="fp-013-notification.html">Notification of Changes (principle 13)</a> </li> <li> <a href="fp-016-maintenance.html">Maintenance (principle 16)</a> </li> <li> <a href="fp-020-responsiveness.html">Responsiveness (principle 20)</a> </li> </ul> <div class="btn-group" role="group" aria-label="Source"> <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/principles/fp-006-textual-definitions.md" > <button type="button" data-toggle="tooltip" title="See FAQ entry: How I do propose edits to principles?" html="true" class="btn btn-outline-primary" > View </button> </a> <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/edit/master/principles/fp-006-textual-definitions.md" > <button type="button" data-toggle="tooltip" title="See FAQ entry: How I do propose edits to principles?" html="true" class="btn btn-outline-primary" > Edit </button> </a>  </div> <div> This page is generated via <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/_layouts/principle.html" >_layouts/principle.html</a >. See <a href="/faq/how-do-i-edit-content.html">edit guide</a> </div> </div> <div class="col-md-9"><p>GO TO: <a href="#recommendations-and-requirements">Recommendations/Requirements</a> | <a href="#implementation">Implementation</a> | <a href="#examples">Examples/Counter‑Examples</a> | <a href="#criteria-for-review">Criteria for Review</a> | <a href="#feedback-and-discussion">Feedback/Discussion</a></p> <h2 id="summary">Summary</h2> <p>The ontology has textual definitions for the majority of its classes and for top level terms in particular.</p> <h2 id="purpose">Purpose</h2> <p>A textual definition provides a human-readable understanding about what is a member of the associated class. Textual definitions are, optimally, in concordance with associated machine-readable logical definitions (the latter of which are OPTIONAL).</p> <h2 id="recommendations-and-requirements">Recommendations and Requirements</h2> <p>Textual definitions MUST be unique within an ontology (i.e. no two terms should share a definition) and be written in English. Textual definitions SHOULD follow Aristotelian form (e.g. “a B that Cs” where B is the parent and C is the differentia), where this is practical.</p> <p>For terms lacking textual definitions, there should be evidence of implementation of a strategy to provide definitions for all remaining undefined terms. In lieu of textual definitions, there can be elucidations when the term can not be rigorously defined. Note that textual definitions can be programmatically generated from logical definitions, if available (see <a href="http://oro.open.ac.uk/21501/1/">http://oro.open.ac.uk/21501/1/</a>). In addition, <a href="https://github.com/INCATools/dead_simple_owl_design_patterns">Dead Simple Ontology Design Patterns</a> (DOSDPs) can be used to generate both textual and logical definitions. DOSDPs are design specifications, written in YAML format, that specify structured text definitions and logical definitions for groups of ontology terms. These are widely used in many OBO Foundry ontologies, such as Mondo and uPheno. For some example patterns, see <a href="https://mondo.readthedocs.io/en/latest/editors-guide/patterns/">Mondo patterns</a> and <a href="https://github.com/obophenotype/upheno/tree/master/src/patterns/dosdp-patterns">uPheno patterns</a>.</p> <p>Logical definitions, when present, should agree with textual definitions and vice versa. This is important for two reasons: (1) Reasoners classify terms solely based on logical definitions, while humans predominantly classify terms based on textual definitions, and mismatches between the two can cause unexpected misclassification; and (2) Curators could create incorrect annotations. An example of mismatched definitions:</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://purl.obolibrary.org/obo/OBI_0003243 blood assay datum Text definition: "A data item that is the specified output of a blood assay." </code></pre></div></div> <p>Logical definition (that does not match the textual def):</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>= 'information content entity' and (is_specified_output_of some 'blood assay') </code></pre></div></div> <p>Logical definition (that matches the textual def):</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>= 'data item' and (is_specified_output_of some 'blood assay') </code></pre></div></div> <p>While both logical definitions can be used to define the class, one better fits with the textual definition than the other.</p> <p>Note that it’s permissible to not to have a logical definition if the class is fuzzy or the axioms/relations can’t be composed equivalence axioms.</p> <p>Terms often benefit from examples of usage, as well as editor notes about edge cases and the history of the term, but these should be included as separate annotations and not in the definition.</p> <p>Instances, such as organizations or geographical locations, can benefit from definitions although it is understood that definitions for instances are not required. It is recognized that OBO format (e.g., versions 1.2 and 1.4) does not allow this as an option.</p> <h2 id="implementation">Implementation</h2> <p>Textual definitions should be identified using the annotation property: ‘definition’ <a href="http://purl.obolibrary.org/obo/IAO_0000115">http://purl.obolibrary.org/obo/IAO_0000115</a>. The source of the definition should be provided using the annotation property ‘definition source’ <a href="http://purl.obolibrary.org/obo/IAO_0000119">http://purl.obolibrary.org/obo/IAO_0000119</a>, or as an axiom annotation on the definition assertion.</p> <p>An example of providing source in an axiom annotation:</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code><http://purl.obolibrary.org/obo/GO_0000109> rdf:type owl:Class ; <http://purl.obolibrary.org/obo/IAO_0000115> "Any complex formed of proteins that act in nucleotide-excision repair."@en ; rdfs:label "nucleotide-excision repair complex"^^xsd:string . [ rdf:type owl:Axiom ; owl:annotatedSource <http://purl.obolibrary.org/obo/GO_0000109> ; owl:annotatedProperty <http://purl.obolibrary.org/obo/IAO_0000115> ; owl:annotatedTarget "Any complex formed of proteins that act in nucleotide-excision repair."@en ; <http://www.geneontology.org/formats/oboInOwl#hasDbXref> "PMID:10915862"^^xsd:string ] . </code></pre></div></div> <p>this corresponds to the obo format:</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>id: GO:0000109 name: nucleotide-excision repair complex def: "Any complex formed of proteins that act in nucleotide-excision repair." [PMID:10915862] </code></pre></div></div> <h2 id="examples">Examples</h2> <p><i><b>Class</b></i>: primary phloem sieve element <br /> <i><b>Term IRI</b></i>: <a href="http://purl.obolibrary.org/obo/PO_0025452">http://purl.obolibrary.org/obo/PO_0025452</a> <br /> <i><b>Definition</b></i>: A sieve element (PO:0025406) that is part of a portion of primary phloem (PO:0006075). <br /> <i><b>Logical definition</b></i>:</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>'sieve element' and ('part of' some 'primary phloem') </code></pre></div></div> <p><i><b>Class</b></i>: ecto-epithelial cell <br /> <i><b>Term IRI</b></i>: <a href="http://purl.obolibrary.org/obo/CL_0002077">http://purl.obolibrary.org/obo/CL_0002077</a> <br /> <i><b>Definition</b></i>: An epithelial cell derived from ectoderm. <br /> <i><b>Logical definition</b></i>:</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>'epithelial cell' and ('develops from' some 'ectodermal cell') </code></pre></div></div> <h2 id="counter-examples">Counter-Examples</h2> <ul> <li>No definition</li> <li>Circular/Self-referential definition “A chromatography device is a device that uses chromatography” when chromatography is not defined elsewhere</li> </ul> <h2 id="criteria-for-review">Criteria for Review</h2> <p>Each definition MUST be unique. Each entity MUST NOT have more than one textual definition (tagged using <a href="http://purl.obolibrary.org/obo/IAO_0000115">IAO:0000115</a>). Textual definitions SHOULD be provided for most terms, and for top level terms especially.</p> <p><a href="checks/fp_006">This check is automatically validated.</a></p> <h2 id="feedback-and-discussion">Feedback and Discussion</h2> <p>To suggest revisions or begin a discussion pertaining to this principle, please <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/issues/new?labels=attn%3A+Editorial+WG,principles&title=Principle+%236+%22Definitions%22+%3CENTER+ISSUE+TITLE%3E">create an issue on GitHub</a>.</p> <p>To suggest revisions or begin a discussion pertaining to the automated validation of this principle, please <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/issues/new?labels=attn%3A+Technical+WG,automated+validation+of+principles&title=Principle+%236+%22Definitions%22+-+automated+validation+%3CENTER+ISSUE+TITLE%3E">create an issue on GitHub</a>.</p> </div> </div> </div> </div> </div><footer class="footer"> <p class="small text-center text-muted"> © 2024 OBO Technical WG </p> </footer> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.2.2/dist/js/bootstrap.bundle.min.js"></script>  <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/prism.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/plugins/autoloader/prism-autoloader.min.js"></script> </body> </html>

CINXE.COM

OBO Foundry