Add hra muscular ntr#3700
Conversation
10 input terms processed by the new dual-template flow: - Stage 1: pre-classified into 8 leaf + 2 group rows - Stage 2: 8 group JSONs (7 leaf parent groups + 1 grouping_terms bucket) - Stage 3: 8 ntr-term-researcher agents (3 needed retry due to API stream timeouts; grouping_terms handled inline after retry stalled) - Stage 4: dual-template merge Final output: - 4 NEW leaf terms with Aristotelian definitions, real PMID/DOI refs, resolved is_a/part_of, Wikipedia + FMA xrefs - 0 NEW group terms — both 'anterior vertebral muscle' and 'circular pharyngeal muscle' resolved to existing UBERON terms via Step 2 OLS4 check, validating that confirmed_match takes precedence over Step 8 EC pattern detection - 5 confirmed_match (5 of 10 input terms already exist in UBERON): - ceratoglossus → UBERON:0008428 - chondroglossus muscle → UBERON:0011535 - costal diaphragm → UBERON:0035831 - aryepiglotticus muscle → UBERON:0011025 - constrictor muscle of pharynx → UBERON:0001569 (NEW from group flow) - 1 possible_match: anterior vertebral muscle ≈ UBERON:0008549 (prevertebral muscle) — flagged for curator decision (synonym vs new term) - 1 manual_curation: anterior vertebral muscle — UBERON's similar term uses attaches_to + innervated_by axioms, not the simple genus + part_of pattern, so out of EC template scope The test exercises: leaf+INFER parent, leaf+NEEDS_MAPPING:FMA parent, leaf+UNRESOLVABLE parent (including wrong-domain), group→confirmed_match, group→possible_match+manual_curation. All paths working as designed. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Claude finished @dosumis's task in 5m 44s —— View job PR Review: Add HRA Muscular NTRReview checklist:
SummaryThis PR adds ROBOT template infrastructure and four new NTR (New Term Request) leaf terms for HRA (Human Reference Atlas) muscular-system structures, along with a bulk NTR workflow toolkit. The term-level research appears careful and the definition quality is high. However, there are two issues that should be addressed before merge, and several important follow-on items. 🔴 CRITICAL1. New templates not registered in ODK config — they will never compile
The precedent is 2. The definition research output (
and sets 🟡 IMPORTANT3. Row 5 of 4. ASCTB-TEMP IRIs in the All four terms carry For example, The ASCTB-TEMP IRI is the third token in the definition xref list. 5. Missing Per 6.
🔵 SUGGESTIONS7. Binary Excel file in repo root
8. ISBN references are non-standard in OBO/UBERON; 9. FMA parent for articularis genu (UBERON:0004252) is very broad FMA:22424 "Muscle of anterior compartment of thigh" has no UBERON equivalent, so the workflow fell back to UBERON:0004252 "hindlimb stylopod muscle". The fallback is documented in the definition output and the errors report, but UBERON:0004252 is a very coarse grouping. The definition output itself suggests considering UBERON:0001377 (quadriceps femoris) and explicitly notes that "articularis genu is anatomically discrete from the quadriceps". Curator should confirm the fallback is acceptable or note it for a follow-up parent term request. 10. Using 11. The PR adds 1,700+ lines of Python scripts, JSON outputs, and documentation for the bulk NTR pipeline. This infrastructure is valuable but may belong in a separate utilities repository or be Per-term verdict
Confirmed matches correctly excluded from template: The term research quality and definition writing are solid. The main blockers are the missing ODK registration (templates won't compile without it) and the relationship-type inconsistency on UBERON:9900010. Addressing the missing |
![ai4c-agent[bot]](https://avatars.githubusercontent.com/in/2242960?s=60&v=4){kind=small}
There was a problem hiding this comment.
Two blocking issues before merge:
-
Templates not wired into the build —
hra-muscular.template.tsvandhra-muscular-groups.template.tsvare not registered inuberon-odk.yamloruberon.Makefile. Without equivalent entries to thehra-skeletonprecedent these terms will never compile into the ontology. -
Relationship-type conflict on UBERON:9900010 — the definition workflow output (
unresolvable_meningohypophyseal_artery.json) explicitly recommendspart_offordorsal part of intertransversarii laterales lumborum musclebut the template usesis_a. These need to be reconciled.
Also flagged as important (see full comment):
- UBERON:9900008 (clavicular head) has no
is_a, onlypart_of - ASCTB-TEMP IRIs in the
def_xrefcolumn should be inxref term_tracker_itemmissing from both templates- Report files under
src/templates/hra-muscular-reports/should not live inside the template directory
There was a problem hiding this comment.
Two blocking issues before merge:
-
Templates not wired into the build — hra-muscular.template.tsv and hra-muscular-groups.template.tsv are not registered in uberon-odk.yaml or uberon.Makefile. Without equivalent entries to the hra-skeleton precedent these terms will never compile into the ontology.
-
Relationship-type conflict on UBERON:9900010 — the definition workflow output (unresolvable_meningohypophyseal_artery.json) explicitly recommends part_of for dorsal part of intertransversarii laterales lumborum muscle but the template uses is_a. These need to be reconciled.
Also flagged as important (see full comment):
- UBERON:9900008 (clavicular head) has no is_a, only part_of
- ASCTB-TEMP IRIs in the def_xref column should be in xref
- term_tracker_item missing from both templates
- Report files under src/templates/hra-muscular-reports/ should not live inside the template directory
There was a problem hiding this comment.
Two blocking issues before merge. 1) Templates not wired into the build: hra-muscular.template.tsv and hra-muscular-groups.template.tsv are not registered in uberon-odk.yaml or uberon.Makefile. 2) Relationship-type conflict on UBERON:9900010: workflow output says part_of but template uses is_a. See full review comment for details.
…umn assignment
Previously the agent picked is_a OR part_of and put the resolved parent in one
column, leaving the other empty. UBERON convention for specific named structures
is to populate BOTH — e.g. vastus lateralis (UBERON:0001379) has
'is_a UBERON:0001630 (muscle organ)' AND 'relationship: part_of UBERON:0001377
(quadriceps femoris)'.
ntr-term-researcher.md changes:
- Step 7 rewritten: agent now uses awk over uberon-edit.obo to find similar
specific UBERON terms, identifies the genus class (typically muscle organ
UBERON:0001630, muscle head UBERON:0011906) AND the part_of containing
structure, then populates leaf_template_rows[label] = {is_a, part_of}
- Worked examples included (clavicular head, articularis genu, dominant
follicle subtypes)
- Explicit warning: do NOT just take the source parent and assign it to one
column; the source parent is often too broad to serve as the genus
- Output JSON gains leaf_template_rows key (analogous to group_template_rows)
- Quality checks updated: prefer leaf_template_rows; both is_a and part_of
should be populated when applicable
merge_definitions.py changes:
- load_subagent_outputs reads leaf_template_rows
- merge_leaf_template uses leaf_template_rows first; falls back to legacy
resolved_relationships + resolved_parents if absent (backward compatible)
- New counter 'leaf_template_rows used' in summary output
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…lated After updating Step 7 of the agent spec to require obo-grep lookup of similar UBERON terms before assigning the parent, re-ran the 4 leaf-term agents on the muscular-system test set. All 4 now populate both is_a and part_of columns: | Term | is_a | part_of | |-----------------------------------------------------|--------------------|-------------------| | anterior cervical intertransversarii muscle | muscle organ | neck | | articularis genu muscle | muscle organ | hindlimb stylopod | | clavicular head of pectoralis major muscle | muscle head | pectoralis major | | dorsal part of intertransversarii laterales lumborum| muscle organ | lower back muscle | Notable: clavicular head correctly resolved to is_a UBERON:0011906 (muscle head) — matching the long head of biceps brachii (UBERON:0007168) precedent. articularis genu correctly distinguished UBERON:0004252 (sibling grouping class, not container) from UBERON:0000376 (the actual containing region) by following the pectineus precedent. Stage 4 reports leaf_template_rows used=4, legacy resolved_relationships=0 — confirms the new path is exercising the proper genus+location lookup rather than the legacy single-column assignment. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Standalone experiment in bulk_ntr_workflow/experiments/. Workflow scripts NOT modified. Tests whether an agent can extract origin/insertion/ innervation/action from Wikipedia + uberon-edit.obo with UBERON ID resolution and verbatim evidence quotes per field. Test set (well-known whole muscle → obscure sub-part): - internal abdominal oblique muscle (existing UBERON:0005454) - tensor fascia latae muscle (existing UBERON:0001376) - iliocostalis cervicalis muscle (existing UBERON:0008546) - articularis genu muscle (NEW) - clavicular head of pectoralis major muscle (NEW, muscle head) - dorsal part of intertransversarii laterales lumborum (NEW, obscure) Findings (full report in SUMMARY.md): 1. All 6 terms got 5-6 of 6 enrichment fields populated. Where UBERON IDs couldn't be resolved (named attachments, specific nerves, specific bone landmarks), the agent gracefully fell back to free-text quotes plus parent-class UBERON IDs. 2. The hypothesis that 'muscle parts are poorly axiomatised' is partly confirmed: parent muscle classes for sub-parts are missing (intertransversarii laterales lumborum), but the bigger gap is in UBERON's coverage of related anatomical entities — superior gluteal nerve, lateral pectoral nerve, iliotibial tract, suprapatellar bursa, ilioinguinal nerve, linea alba, accessory process of lumbar vertebra are all missing. A famous muscle like tensor fasciae latae has 2 such gaps; the obscure dorsal sub-part has 3 — gaps are not strongly correlated with term obscurity. 3. The verbatim-quote design works well for review. Each enrichment field carries 1-3 sentences of evidence + a source URL, making the enrichment auditable in seconds per field. 4. 3 of 6 picks turned out to be already in UBERON despite being plausible NTR candidates — Step 2 (existing-term check) continues to do real work. Existing UBERON stanzas often have surprisingly light axiomatisation (tensor fasciae latae has only 1 origin axiom), so enrichment could also improve existing terms, not just new ones. No workflow changes; results are reference material for a future enrichment phase. Roadmap candidates: (a) system-specific templates with pre-extracted fields per system, (b) standardised evidence-quote design across all fields, (c) cascade detection — flag missing UBERON entities as candidate NTRs. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
User hypothesis: simple is_a + part_of would be sufficient for ovary terms (unlike muscles where origin/insertion/innervation are needed). Result: hypothesis NOT confirmed. 5 of 6 ovary terms tested require relations beyond is_a + part_of: - Layers (corona radiata, CL granulosa lutein, CL theca): need composed_primarily_of (CL:cell type) and/or bounding_layer_of, has_part - Compositional complex (cumulus oophorus oocyte complex): needs has_part to distinguish from cumulus oophorus alone - Follicle stages (early antral, transitional primary): need develops_from PLUS has_component with cardinality constraints PLUS has_potential_to_develop_into — UBERON's existing precedent (UBERON:0000035/36/37) uses all of these Why ovary is harder for simple is_a + part_of than expected: - Sibling layers share part_of (both lutein + theca layers part_of corpus luteum) — part_of alone doesn't differentiate - Sibling follicle stages share is_a (all primary/secondary/tertiary is_a ovarian follicle AND part_of ovary) — neither relation distinguishes - The defining property is cellular composition or developmental position, neither captured by spatial part_of Cross-experiment comparison: - Muscle group: simple genus + part_of EC sufficient (74% precedent) - Muscle individual: needs muscle origin/insertion/innervation - Muscle head/sub-part: simple is_a + part_of works (sparse precedent) - Ovary layer/complex/stage: needs composed_primarily_of, has_part, develops_from, cardinality Conclusion: per-system templates are warranted. A single one-size-fits-all leaf template either over-fits one domain or under-serves both. The evidence-quote JSON design transferred cleanly between domains — confirming it as a generalisable pattern. Output: bulk_ntr_workflow/experiments/SUMMARY_OVARY.md and 6 enriched JSONs. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Stage 1 now partitions input rows by source `tables` value into system overlays. Each overlay produces its own clean leaf template with system-specific columns; unmapped tables go to the default template. Phase 6 — develops_from on default leaf template - New optional column with directive `SC RO:0002202 some %` - Empty cell → no axiom (standard ROBOT pattern; do NOT alter directive to work around empty cells) - Populated by agent for stage series (follicle stages, embryonic stages, etc.) Phase 7 — skeletal-muscle overlay - New muscle template variant: <name>-muscle.template.tsv - Adds has_muscle_origin (RO:0002372), has_muscle_insertion (RO:0002373), innervated_by (RO:0002005) - All optional; populated by agent only with evidence-quoted UBERON IDs - Triggered by source table value `muscular-system` (SYSTEM_OVERLAYS map) Implementation notes: - generate_template.py: SYSTEM_OVERLAYS, classify_system(), overlay_paths(); per-row routing builds leaf_rows_by_overlay dict; one template TSV written per overlay - group_terms_by_parent.py: reads ALL leaf templates (default + system overlays) via discover_leaf_templates(); each per-term JSON entry now carries `system` field - merge_definitions.py: REFACTORED to use header-name lookup (header_indices()) instead of hardcoded column indices. Each leaf template variant's columns are looked up at merge time. Optional logic columns (develops_from, has_muscle_*) populate from leaf_template_rows[label] when both column and value exist. - agent spec: documents system field, develops_from + muscle-overlay guidance; output JSON example shows the optional fields - CLAUDE.md: column reference splits leaf table into default + muscle overlay; new partitioning subsection Smoke-tested with --table muscular-system --limit 10: - Step 0 routing correctly outputs muscle=8, group=2 (no default partition since all 10 rows are muscular-system) - Output template has 16 columns with the 6 expected logic relations (is_a + part_of + develops_from + 3 muscle) - Merge with existing leaf_template_rows from previous run still works via legacy is_a + part_of fallback (Optional cols filled: 0 because agents haven't been re-run with new spec) Phase 8 (term promotion) and overlays for skeleton/vasculature/nervous documented in ROADMAP only — not implemented. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Re-ran Stage 1 with --table muscular-system --limit 10. Output: - Step 0 routing: muscle=8, group=2 (correctly partitioned by source table) - <name>-muscle.template.tsv has 16 columns: 6 logic relations (is_a, part_of, develops_from, has_muscle_origin, has_muscle_insertion, innervated_by) + 10 metadata - Default leaf template absent (no rows for it — all are muscular-system) Re-ran one agent (articularis genu) with the updated spec. Agent emitted leaf_template_rows with the new optional muscle-overlay fields: is_a=UBERON:0001630 (muscle organ), part_of=UBERON:0000376 (thigh), has_muscle_origin=UBERON:0000981 (femur), innervated_by=UBERON:0001267 (femoral nerve). has_muscle_insertion correctly omitted (suprapatellar bursa not in UBERON). Merge correctly populated all 4 columns from leaf_template_rows (Optional cols filled: 2 in summary). The other 3 leaf JSONs were generated under the older agent spec — they fall back to legacy resolved_relationships and only get is_a OR part_of. To populate their muscle-overlay fields, those agents would need to be re-run. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Stage 1 partitioning: muscle=55, group=20 (no default partition)
Stage 2 grouping: 45 groups (44 leaf + 1 grouping_terms bucket of 20 group terms)
Stage 3: 45 agents in 6 parallel batches; all completed without API timeouts
Stage 4 merge results:
Leaf template <name>-muscle.template.tsv (25 new terms):
- Phase 7 muscle overlay populated: 68 optional column values across 25 rows
(avg 2.7 muscle-specific columns per term — origin/insertion/innervated_by)
- All 25 use leaf_template_rows (no legacy fallback path triggered)
- 0 PENDING definitions, 0 INFER relationships, 0 unresolved
- 24 of 25 have real PMID/DOI/ISBN def_xrefs added
Groups template <name>-groups.template.tsv (8 new terms):
- All 8 fit the simple genus + part_of some Y EC pattern
- Genus is UBERON:0014892 (skeletal muscle organ, vertebrate) for all 8
- Locations: thoracic cavity, sole of pes, dorsum, external/middle ear, etc.
Reports:
- candidates.tsv: 39 confirmed_matches (existing UBERON terms)
Notable: 9 of 20 grouping_terms already existed (prevertebral muscle,
constrictor muscle of pharynx, scalene, hypothenar, palmar/plantar
interosseous, splenius, facial muscle, intra-ocular muscle)
- manual_curation.tsv: 3 group terms not fitting simple part_of pattern
(pelvic floor, dorsum of foot, longitudinal pharyngeal — all need
new region/orientation terms OR has_part/membership-based modelling)
- name_corrections.tsv: 17 entries (typos like 'capitus' → 'capitis',
Latin variants like 'fascia' → 'fasciae', 'tibalis' → 'tibialis')
Wrong-domain parent issues flagged by agents (data quality in HRA source):
- sternum→diaphragm (costal/sternal parts)
- splenic artery→intrinsic muscle of tongue (inferior longitudinal)
- innominate bone→pharyngeal muscle (pterygopharyngeus)
- tip of renal papilla→hand muscle (palmar interosseous)
- meningohypophyseal artery→lumbar back muscle (dorsal intertransversarii)
- and many more — captured in individual JSON unresolvable notes
NOT merged to main. Branch retains everything for review.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Claude finished @dosumis's task in 5m 44s —— View job PR Review: Add HRA Muscular NTR (Re-review after sync)Review checklist:
Tasks:
SummaryThe PR has grown substantially since the first review: the original four-term ✅ Fixed since previous review
🔴 CRITICAL1. Templates still not registered in ODK config or Makefile Neither In - filename: hra_muscular.owl
templates:
- hra-muscular-muscle.template.tsv
- hra-muscular-groups.template.tsvAnd a corresponding build rule in 2. Groups template: three back-muscle terms have identical EC axiom definitions — reasoner will infer equivalence
The OWL reasoner will immediately conclude all three are equivalent classes. Grouping terms like these are usually defined via 🟡 IMPORTANT3. ASCTB-TEMP IRIs still in the All 33 terms still carry 4. Per 5. Pipeline outputs ( 6. Three leaf terms use
All other skeletal muscle leaf terms in the same template correctly use 7. UBERON:9900025 (lateral compartment of leg muscle) — The definition explicitly states the structure is "part of the lateral (fibular) fascial compartment of the leg". The 🔵 SUGGESTIONS8. ISBN citations are not standard OBO/UBERON practice. The TA2 URL ( 9. UBERON:9900047 (posterior abdominal wall muscle) — location is generic abdominal wall The EC axiom uses Per-template verdictLeaf template (25 terms) — most terms look anatomically sound with good definitions and PMIDs. Specific concerns:
Groups template (8 terms) — logical-definition structure is sound in principle, but three back-layer groupings share identical EC axioms (see critical issue 2 above). The remaining five groupings (ear, abdominal wall, sole, thoracic wall) each have unique location values and are fine. Two prior blockers are resolved. The remaining critical items (build registration and EC axiom collision) must be addressed before merge. |
This PR modifies some logical definitions. See details below:Number of classes with modified logical definitions: 5 http://purl.obolibrary.org/obo/UBERON_1100029No changes in inferred subclasses. http://purl.obolibrary.org/obo/UBERON_1100017Added subclasses: 3 http://purl.obolibrary.org/obo/UBERON_1100005No changes in inferred subclasses. http://purl.obolibrary.org/obo/UBERON_1100024Added subclasses: 1 http://purl.obolibrary.org/obo/UBERON_1100021Added subclasses: 4 |
There was a problem hiding this comment.
Two new critical issues must be fixed before merge:
-
Templates still not registered in ODK config/Makefile — both hra-muscular-muscle.template.tsv and hra-muscular-groups.template.tsv are absent from uberon-odk.yaml and uberon.Makefile. No component build rule exists, so all 33 new terms will never compile.
-
Groups template EC axiom collision — intermediate back muscle (UBERON:9900020), segmental back muscle (UBERON:9900055), and superficial back muscle (UBERON:9900063) all produce identical EquivalentClass axioms (skeletal muscle organ AND part_of dorsum). The reasoner will infer these three terms are equivalent. These grouping terms should use SC (SubClassOf) columns, not EC (EquivalentClass).
Fixed from prior review: UBERON:9900008 now has is_a (muscle head) ✅; UBERON:9900010 relationship conflict resolved ✅.
Still outstanding from prior review (IMPORTANT): ASCTB-TEMP IRIs remain in the def_xref column; term_tracker_item columns missing from both templates; hra-muscular-reports/ still under src/templates/.
See the full review comment for details and per-term verdict.
…m run 26 unresolvable notes extracted from per-term JSON outputs in bulk_ntr_workflow/outputs/definitions/. Most are wrong-domain parent issues in HRA source data (sternum→diaphragm, splenic artery→tongue muscle, innominate bone→pharyngeal muscle, meningohypophyseal artery→ lumbar muscle, anterior cerebral artery→hand muscle, fused sacrum→ abdominal muscle, etc.). Workflow gap noted: merge_definitions.py currently writes aggregated reports for confirmed_matches, name_corrections, out_of_scope, and manual_curation, but NOT for unresolvable. Adding this aggregation to the merge script would surface these systematically without manual extraction. Tracked for follow-up. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replaces standalone unresolvable.tsv with a single curator-facing review file. Each row of the original input gets: | Column | Purpose | |-------------------------|-----------------------------------------------| | table, as_iri, label | Input source identifiers | | term_type | leaf | group | | source_parent_id | Parent ID from source data | | source_parent_label | Parent label from source | | status | confirmed_match | new_term_leaf | | | | new_term_group | manual_curation | | mapped_uberon_id | Either existing UBERON ID (if confirmed) | | | OR new UBERON:99xxxxx ID (if new term) | | label_correction | Suggested corrected label (typos etc.) | | label_correction_reason | Why the label was corrected | | parent_correction | Corrected parent UBERON ID (when source was | | | wrong-domain or missing) | | curator_notes | Pipe-separated unresolvable notes from agents | | | (wrong-domain parents, missing UBERON | | | entities, modelling caveats) | Aggregated stats for the muscular-system run: - 75 input rows - Status: 39 confirmed_match, 25 new_term_leaf, 8 new_term_group, 3 manual_curation - 17 with label corrections - 34 with parent corrections (parent_correction populated) - 20 with curator notes (mostly wrong-domain source parents) This is the file curators should review first — one row per input term, all findings consolidated, no need to dig into per-term JSONs. Built one-off via Python script joining input.tsv + candidates.tsv + name_corrections.tsv + manual_curation.tsv + per-term unresolvable notes from outputs/definitions/*.json. Should be moved into merge_definitions.py as an aggregated report writer (follow-up). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Three new columns make curator review substantially faster: - mapped_label: human-readable label of the mapped UBERON term (looked up from src/ontology/uberon-edit.obo). For new terms, shows '(new term: <label>)'. Saves the curator from having to look up each UBERON ID separately. - parent_correction_label: human-readable label for parent_correction. Same rationale. - mapping_evidence: synthesised evidence from per-term JSON outputs explaining WHY each source term maps to its existing UBERON match. Pulls from various agent field names (note, match_notes, match_evidence, web_evidence, rationale, matched_synonyms). Example: 'UBERON:0035831 has EXACT synonym "costal part of diaphragm" (FMA:58277). The source label "respiratory diaphragm muscle" resolves to UBERON:0001103 (diaphragm)...' Stats: - 71/75 rows have mapped_label populated - 29 confirmed_match rows have mapping_evidence (the other 10 had agents that didn't emit the optional evidence fields — minor gap) - 34 with parent_correction (so 34 with parent_correction_label too) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Claude finished @dosumis's task in 6m 48s —— View job PR Review: Add HRA Muscular NTR (Third review)Tasks:
Review checklist:
SummaryNo issues from the previous review have been fixed. The three most recent commits ( Additionally, the new NTR terms are not present in The uberon-edit.obo changes in this PR (removing UBERON:1200004 and updating lymph node sinus axioms) appear correct; CI confirms no regression in inferred subclasses for the two affected terms. 🔴 CRITICAL (same as previous review — still unresolved)1. Templates not registered in ODK config or Makefile
In - filename: hra_muscular.owl
templates:
- hra-muscular-muscle.template.tsv
- hra-muscular-groups.template.tsvAnd a corresponding build rule in 2. EC axiom collision in groups template — three back-layer groupings will be inferred equivalent
All three produce the identical EquivalentClass axiom 🟡 IMPORTANT (same as previous review — still unresolved)3. ASCTB-TEMP IRIs still in the All 33 terms still carry 4. Neither template has a 5. The reports directory now has 6 files ( 6. Three leaf terms use
All other skeletal muscle leaf terms in the same template use 7. UBERON:9900025 (lateral compartment of leg muscle) — The definition says "A skeletal muscle organ that is part of the lateral (fibular) fascial compartment of the leg". The 🔵 SUGGESTIONS (carried from previous review)8. ISBN:9780323393225 in def_xref is non-standard — the TA2 URL already covers the Terminologia Anatomica reference; the ISBN could be dropped or moved to a comment. 9. UBERON:9900047 (posterior abdominal wall muscle) — uses What changed since the last reviewThe three newest commits add pipeline output enhancements:
These are valuable workflow additions, but do not address any of the open issues. The uberon-edit.obo changes (removal of UBERON:1200004 and related axiom updates) look correct; CI reports no inferred-subclass regressions for the two affected lymph node sinus terms. Per-template verdict (unchanged)Leaf template (25 terms): Definition quality is high with good PMID support. Specific concerns remain on UBERON:9900003, 9900010, 9900026 (is_a too broad) and UBERON:9900025 (part_of blank). Groups template (8 terms): The critical EC axiom collision on the three back-layer groupings (UBERON:9900020, 9900055, 9900063) must be fixed. The other five groupings (ear, abdominal wall, sole, thoracic wall, middle ear) each have unique locations and are logically sound. The two critical blockers (build registration; EC axiom collision) and the important issues must be addressed before merge. |
There was a problem hiding this comment.
Two critical blockers remain unresolved since the previous review:
-
Templates not registered in ODK config/Makefile — hra-muscular-muscle.template.tsv and hra-muscular-groups.template.tsv are absent from uberon-odk.yaml and uberon.Makefile. All 33 new NTR terms exist only in unregistered template files and will never compile into the ontology.
-
EC axiom collision in groups template — intermediate back muscle (UBERON:9900020), segmental back muscle (UBERON:9900055), and superficial back muscle (UBERON:9900063) produce identical EquivalentClass axioms (skeletal muscle organ AND part_of dorsum). The reasoner will infer all three are equivalent classes. Change EC to SC for grouping rows.
Also still outstanding (flagged in both prior reviews): ASCTB-TEMP IRIs in def_xref; term_tracker_item missing from both templates; hra-muscular-reports/ under src/templates/; three leaf terms (9900003, 9900010, 9900026) using too-broad is_a UBERON:0001630; UBERON:9900025 part_of column empty.
No issues from the previous review were addressed in the three most recent commits. See the full review comment for details.
- uberon-odk.yaml: add hra_muscular.owl component product, built from hra-muscular-groups.template.tsv + hra-muscular-muscle.template.tsv - update_repo regenerated src/ontology/Makefile (OTHER_SRC, recreate-components, $(COMPONENTSDIR)/hra_muscular.owl rule) and the components documentation page - uberon.Makefile: override the ODK-generated rule for hra_muscular.owl so it pulls in templates/hra-muscular-prefixes.owl (declaring dcterms: and foaf: annotation properties) plus explicit --prefix flags; modelled on the existing hra_skeleton override - templates/hra-muscular-prefixes.owl: new prefix stub declaring all annotation/object properties used in the two muscular template TSVs - catalog-v001.xml: add catalog entry for hra_muscular.owl - uberon-edit.obo: add import: line for the new component - components/hra_muscular.owl: initial generated component file - .github/workflows/diff.yml: change COMP=false -> COMP=true in both classify_branch and classify_main so the #gogoeditdiff workflow rebuilds template-derived components before classification. Without this, PRs that only edit a template TSV produce a no-op classification diff because both sides load the committed component. This lets #gogoeditdiff surface the effect of template changes on both the unreasoned edit-file diff (catalog-resolved imports load the freshly generated component) and the reasoned -base diff. Signed-off-by: @dragon-ai-agent
PR Review: Add HRA Muscular NTR (Fourth review)
|
…dit file Adds three HRA back-muscle grouping terms to uberon-edit.obo with plain is_a parents under UBERON:0004469 (musculature of back): - UBERON:9900020 intermediate back muscle - UBERON:9900055 segmental back muscle - UBERON:9900063 superficial back muscle These were originally in hra-muscular-groups.template.tsv with EC axioms of the form (skeletal muscle organ AND part_of some dorsum). Because all three share the same genus + location, the reasoner produced an unsatisfiable triplet collapsing them into a single equivalence class. Per Wikipedia (Human_back), the three groupings are differentiated by anatomical layer, innervation source (anterior vs posterior rami), embryological origin, and function - none of which the simple genus + part_of location pattern can capture. The terms are therefore curated manually as named groupings without OWL equivalence axioms; the rationale is captured in per-term comments and in src/templates/hra-muscular-reports/manual_curation.tsv. Refs #3707 Signed-off-by: @dragon-ai-agent Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
|
#gogoedtidiff |
|
Claude finished @dosumis's task in 5m 21s —— View job PR Review: Add HRA Muscular NTR (Fourth review)Review checklist:
Tasks:
SummaryBoth previous critical blockers are now resolved:
Five important issues from prior reviews remain open: 🟡 IMPORTANT (still outstanding)1. ASCTB-TEMP IRIs still in the All 25 leaf terms and 5 group terms still carry 2. Three leaf terms use
All three are clearly skeletal muscles. All other leaf terms in the same template use 3. UBERON:9900025 (lateral compartment of leg muscle) — The definition says "part of the lateral (fibular) fascial compartment of the leg" but the 4. The three manually-curated terms in 5. Six pipeline-output files remain in 🔵 SUGGESTIONS6. 7. UBERON:9900047 (posterior abdominal wall muscle) uses generic What changed since the last review
Both critical blockers are resolved. The five remaining important issues are convention and logical-accuracy items that should be fixed before merge. |
|
Claude finished @dosumis's task in 7m 50s —— View job PR Review: Add HRA Muscular NTR (Eighth review)Review checklist:
Tasks:
SummaryThis review addresses the one remaining issue flagged in all seven prior reviews: ccf:ASCTB-TEMP_ CURIEs used as definition sources instead of plain xrefs. I prepared the fix and committed it locally, but could not push because the Changes prepared (commit
|
| Issue | Status |
|---|---|
| Templates not registered in ODK/Makefile | ✅ Fixed in 3f73ed6 |
| EC axiom collision (3 back groupings) | ✅ Fixed in c21556f |
| UBERON:9900008 missing is_a | ✅ Fixed |
| UBERON:9900003 articularis genu is_a too broad | ✅ Fixed in de0719b |
| UBERON:9900010/9900026 is_a too broad | ✅ Fixed in 6436580 |
| UBERON:9900025 part_of column blank | ✅ Fixed in e640036 |
| term_tracker_item missing from templates | ✅ Fixed in e640036 |
| hra-muscular-reports/ under src/templates/ | ✅ Fixed in e640036 |
| 8 unsatisfiable classes (part_of spine region) | ✅ Fixed in d5f52d5 |
| RO:0002177 typed as DataProperty | ✅ Fixed in 2007e30 |
| ASCTB-TEMP CURIEs as definition sources | 🟡 Script above; commit 4041700 prepared but push blocked |
Once this last fix is applied and CI passes, this PR is ready to merge.
|
#gogoeditdiff |
|
This PR has not seen any activity in the past month; if nobody comments or reviews it in the next week, the PR creator will be allowed to proceed with merging without explicit approval, should they wish to do so. |
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
Reports are review artifacts, not ODK templates, and should not live under src/templates/. Relocated to bulk_ntr_workflow/outputs/ to match the canonical layout used by the muscular branch (PR #3700). Signed-off-by: dragon-ai-agent
1 participant
fixes #3707