Skip to content

Add UBERON:9900001 guttural pouch (issue #3346)#3699

Open
ai4c-agent[bot] wants to merge 2 commits intomasterfrom
dragon-ai-agent-issue-3346-run845
Open

Add UBERON:9900001 guttural pouch (issue #3346)#3699
ai4c-agent[bot] wants to merge 2 commits intomasterfrom
dragon-ai-agent-issue-3346-run845

Conversation

@ai4c-agent
Copy link
Copy Markdown

@ai4c-agent ai4c-agent Bot commented Apr 28, 2026

Resolves #3346.

Summary

Adds a new term UBERON:9900001 guttural pouch to the ontology as requested by @katiermullen.

The guttural pouches are paired ventral diverticulae of the auditory (pharyngotympanic) tube, formed by escape of the mucosal lining of the tube through a long ventral slit in the supporting cartilages. They are normally air filled and in the domestic horse can have a capacity of 300-500ml. The pouches are connected to the nasal cavity and middle ear via the auditory tube. They are present in members of the order Perissodactyla (horses, tapirs, rhinoceroses) and in a small group of other mammals (hyraxes, certain bats, and a South American mouse).

Term details

  • id: UBERON:9900001
  • name: guttural pouch
  • synonyms: diverticulum of the auditory tube; diverticulum of the pharyngotympanic tube
  • is_a: UBERON:0000064 organ part
  • part_of: UBERON:0002393 pharyngotympanic tube
  • xref: Wikipedia:Guttural_pouch
  • definition references: ISBN:978-0721649610 (Color Atlas of Veterinary Anatomy: The Horse), Wikipedia:Guttural_pouch
  • dc-contributor: https://orcid.org/0000-0002-5002-8648 (Katie Mullen)

Notes for reviewer

  • The term was placed under organ part and made part_of the pharyngotympanic tube. The user's request also mentioned mucosa of pharyngotympanic tube (UBERON:0005044) as a candidate parent, but I did not use it because the guttural pouch is the entire diverticulum (a pouch with cavity and walls), not specifically the mucosa.
  • No taxon constraints were added because the description in the issue notes the structure occurs in a phylogenetically scattered set of taxa (Perissodactyla plus various other mammals); this is captured in a comment instead.

🤖 Generated by @dragon-ai-agent

Adds the term 'guttural pouch' as part_of pharyngotympanic tube. The
guttural pouches are paired ventral diverticulae of the auditory
(eustachian) tube, present in horses, tapirs, rhinoceroses, hyraxes,
some bats and a South American mouse.

Definition sourced from Wikipedia and the Color Atlas of Veterinary
Anatomy: The Horse (ISBN:978-0721649610). Contributed by Katie Mullen
(ORCID 0000-0002-5002-8648) per issue #3346.

Signed-off-by: @dragon-ai-agent

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@ai4c-agent ai4c-agent Bot mentioned this pull request Apr 28, 2026
@ai4c-agent
Copy link
Copy Markdown
Author

ai4c-agent Bot commented Apr 28, 2026

Claude finished @ai4c-agent[bot]'s task in 3m 54s —— View job


PR Review: Add UBERON:9900001 guttural pouch

Review checklist:

  • Hierarchy and parents are consistent
  • Definitions and supporting references look adequate
  • Obsolete or replacement handling is safe (N/A — no obsoletions)
  • OBO and ODK conventions appear preserved (mostly — see below)
  • No obvious CI, auth, or workflow regression

Overall

This is a well-reasoned new term addition. The anatomical placement (is_a organ part, part_of pharyngotympanic tube) is logically consistent: the pharyngotympanic tube (UBERON:0002393) is classified as an organ per FMA, so a diverticulum of it correctly fits as an organ part. The decision not to use mucosa of pharyngotympanic tube (UBERON:0005044) as parent is correct — the guttural pouch is the entire diverticulum (cavity + walls), not just the mucosa. UBERON:0011619 (stylohyoid bone) already references the guttural pouch in its taxon_notes, confirming this is a real and relevant structure.

One issue should be fixed before merge.


🟡 IMPORTANT: dc-contributor missing name comment

Per CLAUDE.md guidelines, the format must be:

relationship: dc-contributor https://orcid.org/<ORCID> ! <NAME>

The current term has:

relationship: dc-contributor https://orcid.org/0000-0002-5002-8648

It should read:

relationship: dc-contributor https://orcid.org/0000-0002-5002-8648 ! Katie Mullen

🔵 SUGGESTION: No PMID in definition references

CLAUDE.md asks for definitions with at least one xref, ideally a PMID. Current refs are ISBN:978-0721649610 and Wikipedia:Guttural_pouch. The original issue links to WikiVet (no PMID), but a literature search for a veterinary anatomy paper covering the guttural pouch in Perissodactyla would strengthen the term.

🔵 SUGGESTION: WikiVet xref

The original issue cites https://en.wikivet.net/Guttural_Pouches_-_Anatomy_%26_Physiology. Consider adding this as an additional xref.

🔵 SUGGESTION: Definition phrasing

"A paired ventral diverticulum" is slightly awkward — "paired" and "A" together imply one structure is itself a pair. Consider: "One of a pair of ventral diverticulae of the auditory (pharyngotympanic) tube, formed by escape of the mucosal lining..." to make clear that the class represents a single pouch (one side), consistent with how bilateral structures are handled in UBERON.


Note: I cannot formally request changes on a PR from the same bot account. The 🟡 IMPORTANT issue above (dc-contributor name comment) should be fixed before merging.

Copy link
Copy Markdown
Author

@ai4c-agent ai4c-agent Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review of UBERON:9900001 guttural pouch

Review checklist:

  • Hierarchy and parents are consistent
  • Definitions and supporting references look adequate
  • Obsolete or replacement handling is safe (N/A)
  • OBO and ODK conventions appear preserved (mostly)
  • No obvious CI, auth, or workflow regression

Overall

This is a well-reasoned new term addition. The anatomical placement (is_a organ part, part_of pharyngotympanic tube) is logically consistent: the pharyngotympanic tube is classified as an organ in FMA, so a diverticulum of it fits as an organ part. The decision not to use mucosa of pharyngotympanic tube (UBERON:0005044) as parent is correct, since the guttural pouch is the entire diverticulum, not just the mucosa. UBERON:0011619 (stylohyoid bone) already referenced the guttural pouch in its taxon_notes, confirming this is a real and relevant structure.

One issue should be fixed before merge.


Issues

🟡 IMPORTANT: dc-contributor is missing the name comment

Per CLAUDE.md guidelines, the format is:

relationship: dc-contributor https://orcid.org/<ORCID> ! <NAME>

The added term has:

relationship: dc-contributor https://orcid.org/0000-0002-5002-8648

It should be:

relationship: dc-contributor https://orcid.org/0000-0002-5002-8648 ! Katie Mullen

Suggestions

🔵 SUGGESTION: No PMID in definition references

CLAUDE.md asks for at least one definition xref and ideally a PMID. The current references are ISBN:978-0721649610 and Wikipedia:Guttural_pouch. A PMID would strengthen the term. The original issue links to WikiVet (which itself doesn't carry a PMID), but a literature search may surface a suitable veterinary anatomy review.

🔵 SUGGESTION: WikiVet xref

The original issue cites https://en.wikivet.net/Guttural_Pouches_-_Anatomy_%26_Physiology. This could be added as an xref alongside Wikipedia.

🔵 SUGGESTION: Definition phrasing

"A paired ventral diverticulum" is slightly awkward — "paired" and "A" read together as though one structure is a pair. Consider rephrasing to "One of a pair of ventral diverticulae of the auditory (pharyngotympanic) tube..." to clarify that this class represents a single pouch (one side), consistent with how bilateral structures are typically represented in UBERON.


Signed: @dragon-ai-agent

@cmungall
Copy link
Copy Markdown
Member

cmungall commented May 2, 2026

@dragon-ai-agent please add taxon constraints (at least only-in; possibly present-in). Also address minor comment about orcids

@dragon-ai-agent
Copy link
Copy Markdown
Collaborator

🤖 Working on it...

Follow along: View workflow run

@dragon-ai-agent

… pouch

Addresses review feedback on PR #3699:
- Added `relationship: in_taxon NCBITaxon:40674 ! Mammalia` as the only-in
  taxon constraint, since the guttural pouch is restricted to mammals.
- Added `present_in_taxon` relationships for the three mammalian groups
  documented in the original request (ISBN:978-0721649610):
  Perissodactyla (NCBITaxon:9787), Chiroptera (NCBITaxon:9397), and
  Hyracoidea (NCBITaxon:9810).
- Added the `! Katie Mullen` name comment to the dc-contributor
  relationship to comply with CLAUDE.md formatting.
- Added NCBITaxon:9810 (Hyracoidea) to ncbitaxon_terms.txt so the
  imported label survives reserialisation.

Signed-off-by: @dragon-ai-agent
@dragon-ai-agent
Copy link
Copy Markdown
Collaborator

Addressed review feedback on this PR:

Taxon constraints added:

  • relationship: in_taxon NCBITaxon:40674 ! Mammalia — only-in constraint (the guttural pouch is restricted to mammals).
  • relationship: present_in_taxon NCBITaxon:9787 ! Perissodactyla (horses, tapirs, rhinoceroses)
  • relationship: present_in_taxon NCBITaxon:9397 ! Chiroptera (the bat groups noted in the request)
  • relationship: present_in_taxon NCBITaxon:9810 ! Hyracoidea (hyraxes)

The "South American mouse" mentioned in the issue is not specifically identified, so I did not add a present_in_taxon for it; the more general Mammalia-only constraint still covers it.

ORCID name comment fixed:
Updated the dc-contributor line to include ! Katie Mullen per CLAUDE.md guidance. Also added NCBITaxon:9810 (Hyracoidea) to imports/ncbitaxon_terms.txt so the label survives reserialisation.

Note: Katie Mullen's ORCID is not yet in the imported orcidio ontology, so future robot reserialisations may strip the ! Katie Mullen comment until orcidio is updated. This is consistent with several other contributor ORCIDs already in the file.

Final term:

[Term]
id: UBERON:9900001
name: guttural pouch
def: "A paired ventral diverticulum of the auditory (pharyngotympanic) tube, formed by escape of the mucosal lining of the tube through a relatively long ventral slit in the supporting cartilages. The pouches are normally air filled and in the domestic horse can have a capacity of 300-500ml." [ISBN:978-0721649610, Wikipedia:Guttural_pouch]
comment: The guttural pouch is present in members of the order Perissodactyla (nonruminant ungulates: horses, tapirs, rhinoceroses) and in a small group of other mammals including hyraxes, certain bats, and a South American mouse.
synonym: "diverticulum of the auditory tube" EXACT []
synonym: "diverticulum of the pharyngotympanic tube" EXACT []
xref: Wikipedia:Guttural_pouch
is_a: UBERON:0000064 ! organ part
relationship: dc-contributor https://orcid.org/0000-0002-5002-8648 ! Katie Mullen
relationship: in_taxon NCBITaxon:40674 ! Mammalia
relationship: part_of UBERON:0002393 ! pharyngotympanic tube
relationship: present_in_taxon NCBITaxon:9397 {source="ISBN:978-0721649610"} ! Chiroptera
relationship: present_in_taxon NCBITaxon:9787 {source="ISBN:978-0721649610"} ! Perissodactyla
relationship: present_in_taxon NCBITaxon:9810 {source="ISBN:978-0721649610"} ! Hyracoidea
property_value: dcterms-date "2026-04-28T05:09:28Z" xsd:dateTime
property_value: term_tracker_item "https://github.com/obophenotype/uberon/issues/3346" xsd:anyURI
created_by: dragon-ai-agent

🤖 Generated by @dragon-ai-agent

@ai4c-agent
Copy link
Copy Markdown
Author

ai4c-agent Bot commented May 2, 2026

Claude finished @dragon-ai-agent's task in 3m 14s —— View job


PR Review: UBERON:9900001 guttural pouch

Review checklist:

  • Hierarchy and parents are consistent
  • Definitions and supporting references look adequate
  • Obsolete or replacement handling is safe (N/A — no obsoletions)
  • OBO and ODK conventions appear preserved
  • No obvious CI, auth, or workflow regression

Overall

Both issues raised in the previous review cycle have been correctly addressed. The term is well-formed and ready to merge.


✅ Issues from previous review — resolved

dc-contributor name comment — fixed. The line now reads:

relationship: dc-contributor https://orcid.org/0000-0002-5002-8648 ! Katie Mullen

Taxon constraints — added as requested by @cmungall. The term now has:

  • relationship: in_taxon NCBITaxon:40674 ! Mammalia — only-in constraint (guttural pouch restricted to mammals)
  • relationship: present_in_taxon NCBITaxon:9787 ! Perissodactyla — horses, tapirs, rhinoceroses
  • relationship: present_in_taxon NCBITaxon:9397 ! Chiroptera — bats
  • relationship: present_in_taxon NCBITaxon:9810 ! Hyracoidea — hyraxes

All four NCBITaxon IDs are present in src/ontology/imports/ncbitaxon_terms.txt (9810 was added in the latest commit; the others were pre-existing).


Final term (verified)

[Term]
id: UBERON:9900001
name: guttural pouch
def: "A paired ventral diverticulum of the auditory (pharyngotympanic) tube, formed by escape
     of the mucosal lining of the tube through a relatively long ventral slit in the supporting
     cartilages. The pouches are normally air filled and in the domestic horse can have a capacity
     of 300-500ml." [ISBN:978-0721649610, Wikipedia:Guttural_pouch]
synonym: "diverticulum of the auditory tube" EXACT []
synonym: "diverticulum of the pharyngotympanic tube" EXACT []
xref: Wikipedia:Guttural_pouch
is_a: UBERON:0000064 ! organ part
relationship: dc-contributor https://orcid.org/0000-0002-5002-8648 ! Katie Mullen
relationship: in_taxon NCBITaxon:40674 ! Mammalia
relationship: part_of UBERON:0002393 ! pharyngotympanic tube
relationship: present_in_taxon NCBITaxon:9397 {source="ISBN:978-0721649610"} ! Chiroptera
relationship: present_in_taxon NCBITaxon:9787 {source="ISBN:978-0721649610"} ! Perissodactyla
relationship: present_in_taxon NCBITaxon:9810 {source="ISBN:978-0721649610"} ! Hyracoidea
property_value: dcterms-date "2026-04-28T05:09:28Z" xsd:dateTime
property_value: term_tracker_item "https://github.com/obophenotype/uberon/issues/3346" xsd:anyURI
created_by: dragon-ai-agent

Remaining suggestions (non-blocking)

  • 🔵 Definition phrasing: "A paired ventral diverticulum" — since UBERON terms represent a single instance, "One of a pair of ventral diverticulae..." would more precisely follow Uberon's bilateral-structure convention. Minor style issue.
  • 🔵 No PMID in definition references: current refs are ISBN:978-0721649610 and Wikipedia:Guttural_pouch; a published veterinary anatomy PMID would strengthen provenance but is not required.
  • 🔵 WikiVet xref: the original issue cited WikiVet; could be added as an additional xref.

None of these are blocking.


Recommendation: approve and merge.

Note: GitHub does not allow self-approval of PRs, so a human reviewer or a different bot account needs to submit the formal approval.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

NTR: guttural pouch

2 participants