pv-mapping

linkml 的头像作者 linkml

将LinkML枚举中的允许值映射到本体术语。当以下情况时使用此技能:(1) 为枚举允许值添加或更新本体映射(含义:字段),(2) 修复来自linkml-term-validator的验证错误,(3) 用户要求将枚举映射到本体术语或修复CURIE映射。此技能涵盖OAK/runoak查找、CURIE验证和验证工作流程。

📖 中文导读:将LinkML枚举中的允许值映射到本体术语。当以下情况时使用此技能:(1) 为枚举允许值添加或更新本体映射(含义:字段),(2) 修复来自linkml-term-validator的验证错误,(3) 用户要求将枚举映射到本体术语或修复CURIE映射。此技能涵盖OAK/runoak查找、CURIE验证和验证工作流程。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: pv-mapping description: > Map permissible values in LinkML enums to ontology terms. Use this skill when: (1) Adding or updating ontology mappings (meaning: field) for enum permissible values, (2) Fixing validation errors from linkml-term-validator, (3) User asks to map enums to ontology terms or fix CURIE mappings. This skill covers OAK/runoak lookup, CURIE verification, and validation workflows.

Permissible Value Ontology Mapping

Core Rules

  1. Never change PERMISSIBLE_VALUE names - Keep uppercase names like NUCLEIC_ACID
  2. Use title: for ontology label - Match the ontology term's label
  3. Use meaning: for CURIE - Always verify via runoak before adding
  4. Never guess CURIEs - Wrong mappings are worse than no mappings

Workflow

1. Look up term via runoak

# Search for terms
runoak -i sqlite:obo:ncit search "nucleic acid"

# Verify a CURIE exists and get its label
runoak -i sqlite:obo:ncit info NCIT:C706

2. Add mapping

NUCLEIC_ACID:
  title: Nucleic Acids          # matches ontology term label
  description: DNA or RNA sample
  meaning: NCIT:C706            # verified CURIE

Note that either the permissible value key, the title, or one of the aliases should be a (case insensitive) match to the ontology term.

If there is already a canonical meaning field, OR the concept is not a close map, then linkml close/narrow/broad/exact mappings can be used:

NUCLEIC_ACID:
  title: Nucleic Acids          # matches ontology term label
  description: DNA or RNA sample
  meaning: NCIT:C706            # verified CURIE
  close_mappings:
    - SO:0000348.               # label is nucleic_acid
  aliases:
    - nucleic_acid              # to match SO

3. Validate

just validate

Interpreting Validation Errors

Error Type Action
"resolves to [wrong concept]" Fix immediately - CURIE points to wrong term
"label mismatch" Usually OK - add title: to match label if needed, or use an aliases
"Could not retrieve" Check CURIE format or remove if term doesn't exist

Ontology Selection

See references/ontologies.md for:

  • Domain-to-ontology mapping (which ontology for which concept type)
  • CURIE format patterns for each ontology
  • Additional runoak commands

When to Remove Mappings

Remove meaning: when:

  • No appropriate ontology term exists
  • CURIE consistently fails validation
  • Mapped term is semantically incorrect or not the same concept