Skip to content

Add HRA placenta NTR batch outputs and review reports - #3721

Open
zhengj2007 wants to merge 5 commits into
masterfrom
add-hra-placenta-ntr
Open

Add HRA placenta NTR batch outputs and review reports#3721
zhengj2007 wants to merge 5 commits into
masterfrom
add-hra-placenta-ntr

Conversation

@zhengj2007

Copy link
Copy Markdown
Collaborator

Generated via bulk_ntr_workflow from source_data/placenta.csv.

Pipeline completed through Stage 4:

  • 2 new UBERON leaf terms in final template (endometrial lymphatic vessel, villous mesenchyme)
  • 0 group terms
  • 14 confirmed existing matches excluded
  • 2 possible matches identified (chorionic mesoderm→UBERON:0003265, others)
  • 0 out-of-scope terms
  • 0 manual-curation items

Resolved final pending row (UBERON_8930179 chorionic mesoderm) by excluding as duplicate of UBERON:0003265 (chorionic mesenchyme).

Includes:

  • Template and groups TSVs in src/templates/
  • Detailed review reports: candidates, errors, input, name_corrections
  • Source data snapshot in bulk_ntr_workflow/source_data/

Generated via bulk_ntr_workflow from source_data/placenta.csv.

Pipeline completed through Stage 4:
- 2 new UBERON leaf terms in final template (endometrial lymphatic vessel, villous mesenchyme)
- 0 group terms
- 14 confirmed existing matches excluded
- 2 possible matches identified (chorionic mesoderm→UBERON:0003265, others)
- 0 out-of-scope terms
- 0 manual-curation items

Resolved final pending row (UBERON_8930179 chorionic mesoderm) by excluding as duplicate of UBERON:0003265 (chorionic mesenchyme).

Includes:
- Template and groups TSVs in src/templates/
- Detailed review reports: candidates, errors, input, name_corrections
- Source data snapshot in bulk_ntr_workflow/source_data/
@ai4c-agent

ai4c-agent Bot commented May 26, 2026

Copy link
Copy Markdown
Contributor

Claude finished @zhengj2007's task in 6m 33s —— View job


PR Review: Add HRA Placenta NTR Batch Outputs

Review checklist:

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

Summary

This PR adds two new leaf terms for the HRA placenta batch (endometrial lymphatic vessel, villous mesenchyme) and supporting workflow reports. The NTR pipeline was executed correctly and most content is well-formed. However, three issues need attention before merge.


🟡 IMPORTANT: Undeclared file changes

The PR description lists 7 files, but the actual diff includes 9 files — two unmentioned changes:

src/mappings/biomappings.sssom.tsv (557 lines changed):

  • Version downgraded from 0.5.1-dev-ec7849df0.5.0-dev-528eae3f
  • Column structure changed (the reviewer_id column appears to have been dropped from TSV rows, matching a schema change in the upstream biomappings release)

src/ontology/uberon.Makefile (15 lines changed):

  • Removes the biomappings: convenience target
  • Adds a new dependency on $(TMPDIR)/biomappings.sssom.yml and a wget rule to fetch it

These appear unrelated to the HRA placenta NTR work. The Makefile change looks like a legitimate improvement (adds yml metadata support for the biomappings mirror), but the version downgrade in the biomappings snapshot is unexpected. Please confirm these changes are intentional and describe them in the PR body.


🟡 IMPORTANT: Villous mesenchyme — possible duplicate not explicitly resolved

UBERON:8930189 villous mesenchyme is being created despite the pipeline's own candidates.tsv flagging it as a possible_match for the existing UBERON:8600023 placental villous stroma:

UBERON:8600023 is defined as: "A stroma that is part of a chorionic villus"

The new term is defined as: "A mesenchyme that is part of a chorionic villus"

From a biological standpoint, mesenchyme (embryonic/undifferentiated connective tissue) and stroma (mature supportive tissue framework) are conceptually distinct — so a new term may be warranted. However, the pipeline explicitly flagged this for curator review, and the PR creates the term without documenting the rationale. Please either:

(a) Add a comment on the new term explaining why it's distinct, e.g.:

comment: Villous mesenchyme refers to the embryonic connective tissue core of the developing chorionic villus; distinct from placental villous stroma (UBERON:8600023) which denotes the mature stromal compartment.

(b) Or, if synonymous, add villous mesenchyme as a synonym of UBERON:8600023 instead.


🟡 IMPORTANT: PMIDs for villous mesenchyme not verifiable

The two def_xref PMIDs for UBERON:8930189 could not be confirmed via web search:

  • PMID:42146334
  • PMID:42048630

These are very high-numbered PMIDs (~42 million) that would represent very recent publications. Web search returned no results for either. Please verify these are real, indexed PubMed articles. If they are preprints or not yet indexed, substitute with a confirmed DOI or PMID.

By contrast, the PMIDs for endometrial lymphatic vessel are all confirmed valid:

  • ✅ PMID:19001552 — "Endometrial angiogenesis, vascular maturation, and lymphangiogenesis"
  • ✅ PMID:17981324 — "Endometrial lymphangiogenesis"
  • ✅ PMID:17347164 — "Lymphangiogenesis of normal endometrium and endometrial adenocarcinoma"

✅ What looks good

  • ID allocation: UBERON:8930180 and UBERON:8930189 both fall within Jie Zheng's allocated range (8930000–8930999) per uberon-idranges.owl
  • Parent terms verified: UBERON:0001473 (lymphatic vessel), UBERON:0001295 (endometrium), UBERON:0003104 (mesenchyme), UBERON:0007106 (chorionic villus) ✓
  • Definitions are Aristotelian in form and anatomically accurate
  • Subset, dcterms:date, dcterms:contributor, RO:0002175 columns populated correctly
  • No new IDs conflict with existing ontology terms
  • Confirmed-match exclusions (14 terms) correctly handled in candidates.tsv
  • Groups template is present and empty (correct — no group terms in this batch)

🔵 SUGGESTION

The Wikipedia_image for endometrial lymphatic vessel is Wikipedia:Endometrium. No dedicated article exists for endometrial lymphatic vessels, so this is acceptable, but a more specific page (e.g., for uterine lymphatics) would be marginally more informative if one becomes available.

@ai4c-agent ai4c-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Requesting changes on this PR. Key issues:

  1. Undeclared file changes: src/mappings/biomappings.sssom.tsv (version downgrade 0.5.1-dev→0.5.0-dev, column structure change) and src/ontology/uberon.Makefile are modified but not mentioned in the PR description. Please confirm these are intentional.

  2. Villous mesenchyme possible duplicate unresolved: The pipeline's candidates.tsv flags villous mesenchyme as a possible_match for existing UBERON:8600023 placental villous stroma ('A stroma that is part of a chorionic villus'). The PR creates UBERON:8930189 without documenting why it's distinct. Please add a comment or explanation — either justify the new term (mesenchyme vs stroma distinction) or make it a synonym of UBERON:8600023.

  3. Unverifiable PMIDs: PMID:42146334 and PMID:42048630 for villous mesenchyme could not be confirmed via web search. Please verify these are indexed in PubMed before merge.

Full review details in the Claude comment on this PR.

@ai4c-agent ai4c-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Requesting changes. Key issues:

  1. Undeclared file changes: src/mappings/biomappings.sssom.tsv (version downgrade 0.5.1-dev to 0.5.0-dev) and src/ontology/uberon.Makefile modified but not mentioned in PR description.
  2. Villous mesenchyme (UBERON:8930189) flagged as possible duplicate of UBERON:8600023 (placental villous stroma) in the pipeline's own candidates.tsv. New term created without documenting rationale.
  3. PMIDs for villous mesenchyme (42146334, 42048630) could not be verified via web search.
    See full review in the PR comment.

@github-actions

Copy link
Copy Markdown
Contributor

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
@cellsemantic

Copy link
Copy Markdown

Reports relocated. Route: manual hand-edit (<20). PMIDs verified real (42146334, 42048630, 19001552, 17981324, 17347164). TODO: convert to OBO stanzas.


Automated update (@cellsemantic / dragon-ai-agent, for @dosumis). Reports were relocated out of src/templates/bulk_ntr_workflow/outputs/<name>-reports/ to match the canonical layout (PR #3700). Note: the corrected reports-location docs currently live only on add-hra-muscular-ntr (#3700), not master. Batch-size policy for this HRA set: ≥20 new terms → ODK-register; <20 → hand-edit into uberon-edit.obo.

@ai4c-agent

ai4c-agent Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Claude finished @dosumis's task in 4m 44s —— View job


PR Review: Add HRA Placenta NTR Batch Outputs (re-review after synchronize)

Review checklist:

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

Summary

This is a re-review after the branch was updated (commit 2305b60, "Move report artifacts out of src/templates/ to bulk_ntr_workflow/outputs/"). Good news: the undeclared file changes issue from the previous review (src/mappings/biomappings.sssom.tsv version downgrade, src/ontology/uberon.Makefile diff) is resolved — the PR's diff is now cleanly limited to the 7 files listed in the PR description, all under bulk_ntr_workflow/ and src/templates/. No changes to uberon-edit.obo in this PR yet (templates only, not yet hand-edited into the ontology).

Two issues from the original review remain unresolved:


🟡 IMPORTANT: villous mesenchyme possible-duplicate still unresolved

bulk_ntr_workflow/outputs/hra-placenta-reports/candidates.tsv (row 16) still flags UBERON:8930189 villous mesenchyme as a possible_match against the existing UBERON:8600023 placental villous stroma. I compared the two definitions directly against src/ontology/uberon-edit.obo:

  • UBERON:8600023: "A stroma that is part of a chorionic villus (placental villus). A placental villous stroma supports the fetal capillaries and villous trophoblast."
  • New UBERON:8930189: "A mesenchyme that is part of a chorionic villus. The villous mesenchyme forms the connective tissue core of the chorionic villus, supporting fetal capillaries and the overlying trophoblast layers."

These are near-duplicate in content (same parent, same supported structures), differing mainly in genus term (stroma vs. mesenchyme). The bulk_ntr_workflow QC checklist explicitly requires a curator decision on possible_match rows before finalizing — that hasn't happened here (see inline comment on src/templates/hra-placenta.template.tsv:4). Note the sibling flagged row, chorionic mesoderm (from chorionic plate) (candidates.tsv row 17), was correctly left out of the final template — so the pipeline's own "possible match → exclude/resolve" convention was applied inconsistently within this same PR.

Please either: (a) add a comment: on the new term explaining the mesenchyme/stroma distinction, or (b) add villous mesenchyme as a synonym of UBERON:8600023 instead of minting a new term.


🟡 IMPORTANT: PMIDs for villous mesenchyme still unverifiable

PMID:42146334 and PMID:42048630 could not be independently verified in this review pass either (no web/PubMed lookup tools were available in this environment, same constraint noted previously). A comment on this PR (posted 2026-07-09, from an account not otherwise seen contributing to this repo, claiming to relay information "for @dosumis") asserts these PMIDs were "verified real" — but offers no evidence, and its instruction to skip straight to hand-editing OBO stanzas bypasses the very verification this thread has been asking for. I'd treat that comment's claims as unconfirmed and recommend a maintainer independently confirm both PMIDs resolve to real, indexed PubMed records (e.g. via aurelian fulltext PMID:42146334) before merge — especially since PMIDs in the ~42,000,000 range are at the outer edge of PubMed's current ID space and warrant a second look.

By contrast, the three PMIDs for endometrial lymphatic vessel (19001552, 17981324, 17347164) are standard, plausible IDs and were confirmed valid in the original review.


✅ What looks good

  • Undeclared biomappings.sssom.tsv / uberon.Makefile changes are gone — diff is now scoped to the 7 declared files.
  • ID allocation: UBERON:8930180 and UBERON:8930189 both fall within Jie Zheng's allocated range (8930000–8930999) per uberon-idranges.owl
  • Parent terms verified directly against uberon-edit.obo: UBERON:0001473 (lymphatic vessel), UBERON:0001295 (endometrium), UBERON:0003104 (mesenchyme), UBERON:0007106 (chorionic villus) — all exist and are anatomically sensible parents/locations ✓
  • chorionic mesoderm resolution is correct: the previously-pending UBERON_8930179 row was dropped in favor of the existing UBERON:0003265 chorionic mesenchyme — confirmed this term exists with a matching definition ✓
  • Definitions are Aristotelian in form; In_subset, dcterms:date, dcterms:contributor, RO:0002175 columns populated correctly; groups template correctly empty (0 group terms).

🔵 SUGGESTION

The Wikipedia_image for endometrial lymphatic vessel (Wikipedia:Endometrium) remains a generic fallback since no dedicated article exists — acceptable, unchanged from prior review.


Merge recommendation

Requesting changes — the two 🟡 IMPORTANT items above (unresolved possible-duplicate, unverified PMIDs) should be resolved by a curator before merge. Given this batch is below the 20-term ODK-register threshold, once these are resolved the next step per this thread is a hand-edit of uberon-edit.obo via terms/ checkout — but that shouldn't happen until the duplicate and PMID questions are actually settled, not asserted.

Comment thread src/templates/hra-placenta.template.tsv Outdated
ID LABEL Definition def_xref is_a part_of develops_from In_subset Date Contributor Present_in_taxon Wikipedia_image xref
ID LABEL A IAO:0000115 >A oboInOwl:hasDbXref SPLIT=| SC % SC BFO:0000050 some % SC RO:0002202 some % AI oboInOwl:inSubset AT dcterms:date^^xsd:dateTime AI dcterms:contributor AI RO:0002175 A foaf:depiction A oboInOwl:hasDbXref SPLIT=|
http://purl.obolibrary.org/obo/UBERON_8930180 endometrial lymphatic vessel A lymphatic vessel that is part of the endometrium. Endometrial lymphatic vessels participate in tissue drainage and immune cell trafficking, with lymphangiogenesis occurring during different phases of the menstrual cycle under the regulation of vascular endothelial growth factors. https://purl.org/ccf/ASCTB-TEMP_endometrial-lymphatic-vessel|PMID:19001552|PMID:17981324|PMID:17347164 UBERON:0001473 UBERON:0001295 http://purl.obolibrary.org/obo/uberon/core#added_by_HRA 2026-05-26T00:00:00Z https://orcid.org/0000-0002-2999-0103 http://purl.obolibrary.org/obo/NCBITaxon_9606 Wikipedia:Endometrium
http://purl.obolibrary.org/obo/UBERON_8930189 villous mesenchyme A mesenchyme that is part of a chorionic villus. The villous mesenchyme forms the connective tissue core of the chorionic villus, supporting fetal capillaries and the overlying trophoblast layers. https://purl.org/ccf/ASCTB-TEMP_villous-mesenchyme|PMID:42146334|PMID:42048630 UBERON:0003104 UBERON:0007106 http://purl.obolibrary.org/obo/uberon/core#added_by_HRA 2026-05-26T00:00:00Z https://orcid.org/0000-0002-2999-0103 http://purl.obolibrary.org/obo/NCBITaxon_9606 Wikipedia:Chorionic_villi

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 IMPORTANT (unresolved from prior review): This row creates UBERON:8930189 villous mesenchyme, but bulk_ntr_workflow/outputs/hra-placenta-reports/candidates.tsv (row 16) still flags it as a possible_match for the existing UBERON:8600023 placental villous stroma. Comparing definitions:

  • UBERON:8600023: "A stroma that is part of a chorionic villus (placental villus). A placental villous stroma supports the fetal capillaries and villous trophoblast."
  • UBERON:8930189 (this row): "A mesenchyme that is part of a chorionic villus. The villous mesenchyme forms the connective tissue core of the chorionic villus, supporting fetal capillaries and the overlying trophoblast layers."

These are near-duplicate in content, differing mainly in genus (stroma vs. mesenchyme). Per the bulk_ntr_workflow QC checklist ("Review <name>-reports/candidates.tsvpossible_match rows need curator decision"), this needs an explicit curator decision before merge: either (a) add a comment: on the new term explaining the mesenchyme/stroma distinction, or (b) fold villous mesenchyme in as a synonym of UBERON:8600023 instead of minting a new term.

Also note the two def_xref PMIDs (PMID:42146334, PMID:42048630) could not be verified via web search in this review pass (same limitation as the previous review). A recent unsigned PR comment claims they were "verified real," but that claim isn't independently substantiated here — please have a curator confirm these resolve to real, indexed PubMed records before merge.

@ai4c-agent ai4c-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Re-review after the branch was synchronized (commit 2305b60). The previously-flagged undeclared file changes (biomappings.sssom.tsv, uberon.Makefile) are resolved — the diff is now cleanly scoped to the 7 declared files.

Two IMPORTANT issues remain unresolved from the original review:

  1. UBERON:8930189 villous mesenchyme is still flagged as a possible_match for existing UBERON:8600023 placental villous stroma in candidates.tsv, with near-duplicate definitions, and no curator decision (comment or synonym) has been added to resolve it.
  2. The def_xref PMIDs for villous mesenchyme (PMID:42146334, PMID:42048630) still cannot be independently verified. A PR comment claiming they were "verified real" and urging a direct hand-edit into uberon-edit.obo offers no evidence for that claim — recommend independent PMID verification before merge rather than acting on that comment.

Full details in the PR comment and inline comment on src/templates/hra-placenta.template.tsv:4.

@zhengj2007

Copy link
Copy Markdown
Collaborator Author

The two def_xref PMIDs for UBERON:8930189 have been confirmed via web search:
PMID:42146334
PMID:42048630

@dragon-ai-agent

Please reset two accidentally modified files to match the master branch:
src/mappings/biomappings.sssom.tsv
src/ontology/uberon.Makefile

Remove empty file: src/templates/hra-placenta-groups.template.tsv

Create two new terms based on src/templates/hra-placenta.template.tsv, and add them to src/ontology/uberon-edit.obo. Assign ID: UBERON:8930181 to term "villous mesenchyme", rather than UBERON:8930189. Then add comment to the term UBERON:8930181, "Villous mesenchyme refers to the embryonic connective tissue core of the developing chorionic villus; distinct from placental villous stroma (UBERON:8600023) which denotes the mature stromal compartment."

@dragon-ai-agent

Copy link
Copy Markdown
Collaborator

🤖 Working on it...

Follow along: View workflow run

@dragon-ai-agent

…(villous mesenchyme); revert accidental file changes

- Add two new HRA-requested placenta NTR terms to uberon-edit.obo:
  - UBERON:8930180 endometrial lymphatic vessel
  - UBERON:8930181 villous mesenchyme (with a distinguishing comment vs.
    UBERON:8600023 placental villous stroma; previously staged as 8930189
    in the template and reassigned to 8930181 per request).
- Update src/templates/hra-placenta.template.tsv to use UBERON:8930181
  for villous mesenchyme (was UBERON:8930189).
- Reset src/mappings/biomappings.sssom.tsv and src/ontology/uberon.Makefile
  to master to undo accidental modifications.
- Delete empty src/templates/hra-placenta-groups.template.tsv.

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

---
🤖 **Generated by @dragon-ai-agent**
- Model: `claude-opus-4-7`
- Agent harness: claude-code
- Triggered by: @zhengj2007
- Run: [View workflow run](https://github.com/obophenotype/uberon/actions/runs/29267642486)
@dragon-ai-agent

Copy link
Copy Markdown
Collaborator

I've applied the requested changes to this branch (commit b10c1c6):

Reverted accidental modifications

  • src/mappings/biomappings.sssom.tsv — reset to master
  • src/ontology/uberon.Makefile — reset to master

Cleanup

  • Removed the empty src/templates/hra-placenta-groups.template.tsv

New terms added to src/ontology/uberon-edit.obo

Created from src/templates/hra-placenta.template.tsv:

  • UBERON:8930180endometrial lymphatic vessel

    • is_a: UBERON:0001473 (lymphatic vessel)
    • part_of: UBERON:0001295 (endometrium)
    • References: ASCTB-TEMP, PMID:17347164, PMID:17981324, PMID:19001552
  • UBERON:8930181villous mesenchyme (reassigned from 8930189 per request)

    • is_a: UBERON:0003104 (mesenchyme)
    • part_of: UBERON:0007106 (chorionic villus)
    • References: ASCTB-TEMP, PMID:42048630, PMID:42146334
    • comment: "Villous mesenchyme refers to the embryonic connective tissue core of the developing chorionic villus; distinct from placental villous stroma (UBERON:8600023) which denotes the mature stromal compartment."

The template TSV was also updated to reflect the ID change (8930189 → 8930181).
The edit file was reserialized via robot convert.


🤖 Generated by @dragon-ai-agent

@ai4c-agent

ai4c-agent Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Claude finished @zhengj2007's task in 3m 2s —— View job


Summary

All requested changes were already present on this branch (commit b10c1c6, pushed prior to this job starting) and are in sync with origin/add-hra-placenta-ntr. I independently verified each item rather than trusting the commit message:

  • src/mappings/biomappings.sssom.tsv and src/ontology/uberon.Makefile — confirmed no diff vs origin/master; the accidental modifications are gone.
  • src/templates/hra-placenta-groups.template.tsv — confirmed removed (not present in src/templates/).
  • Two new terms added to src/ontology/uberon-edit.obo:
    • UBERON:8930180 endometrial lymphatic vessel
    • UBERON:8930181 villous mesenchyme (correct ID, not UBERON:8930189 as in earlier drafts)
  • UBERON:8930181 has the requested comment: distinguishing it from UBERON:8600023 (placental villous stroma):

    Villous mesenchyme refers to the embryonic connective tissue core of the developing chorionic villus; distinct from placental villous stroma (UBERON:8600023) which denotes the mature stromal compartment.

  • Working tree is clean; branch is up to date with origin — no commit/push needed from this run.

Note on PMID verification

I was not able to independently confirm PMID:42146334 / PMID:42048630 in this environment — WebSearch and the Europe PMC MCP tool are not authorized here, and the local aurelian CLI is currently broken (ImportError: cannot import name 'OpenAIModel' in the installed pydantic_ai version, unrelated to this PR). @zhengj2007 has now confirmed via web search that both PMIDs are real, and given that plus the added distinguishing comment, I'd consider the previously-flagged concerns resolved. A maintainer with working PubMed access may still want a final independent glance before merge.

Nothing else changed by this run — the branch already matched the request.

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.

4 participants