Back to Claude Scientific Skills

Ontology registry

skills/ontology-term-resolution/references/ontology-registry.md

2.57.05.4 KB
Original Source

Ontology registry

Which ontology owns which kind of term, what OLS calls it, and a branch root to constrain against. Every ontology id and branch label below was resolved against OLS in July 2026.

Prefix to OLS ontology id

The OLS ontology id is almost always the lowercased CURIE prefix. Note the exceptions.

CURIE prefixOLS idCovers
UBERONuberonAnatomy, tissues, organs, body fluids (cross-species)
CLclCell types
CLOcloCell lines
MONDOmondoDiseases (the merged disease ontology; prefer over DOID/NCIT)
DOIDdoidHuman Disease Ontology (largely subsumed by MONDO)
HPhpHuman phenotypic abnormalities — id is hp, not hpo
EFOefoExperimental factors, assays, platforms, cell lines
CHEBIchebiChemical entities, drugs, metabolites
NCBITaxonncbitaxonOrganisms
GOgoBiological process, molecular function, cellular component
OBIobiAssays, devices, protocols, study design
PATOpatoQualities — sex, colour, magnitude, normal
SOsoSequence features
HsapDvhsapdvHuman developmental stages
MmusDvmmusdvMouse developmental stages
ENVOenvoEnvironmental materials and biomes
FOODONfoodonFood
NCITncitNCI Thesaurus (clinical/oncology breadth)
MSmsMass spectrometry instruments and methods
BAObaoBioAssay descriptions
OrphanetordoRare diseases — id is ordo, prefix in CURIEs is Orphanet, and OLS reports preferredPrefix: ORDO

Not in OLS at all: Cellosaurus (cell line identity, RRID CVCL_*) — query https://api.cellosaurus.org instead. Vendor and instrument vocabularies generally are not there either.

Branch roots for constraint checks

Pass these to --branch to assert a term is the right kind of thing.

RootLabelUse for
UBERON:0001062anatomical entityany anatomy
UBERON:0000465material anatomical entitytissues and organs
CL:0000000cellcell types
MONDO:0700096human diseasehuman disease fields
HP:0000118Phenotypic abnormalityphenotype fields
CHEBI:24431chemical entitycompounds
NCBITaxon:1rootorganisms
OBI:0000070assayassay fields
PATO:0000001qualityqualities including sex
GO:0008150biological_processGO BP only
GO:0003674molecular_functionGO MF only
GO:0005575cellular_componentGO CC only
EFO:0000001experimental factorEFO breadth
SO:0000110sequence_featuresequence features
HsapDv:0000001life cyclehuman developmental stage
MmusDv:0000001life cyclemouse developmental stage
ENVO:00010483environmental materialenvironmental samples
CLO:0000031cell linecell lines
NCIT:C7057Disease, Disorder or FindingNCIT disease subtree
DOID:4diseaseDOID subtree

MONDO:0000001 resolves (label disease) but only through the IRI fallback described in ols4-api.md; prefer MONDO:0700096 as a human-disease root.

A branch check does not substitute for a prefix check. CARO places cell under anatomical structure, so cell types pass an anatomy branch test. Constrain both.

Choosing between overlapping ontologies

  • Disease: MONDO. It is the merge target for DOID, Orphanet, OMIM, and NCIT disease terms, and it carries cross-references back to all of them. Use DOID or NCIT only when a downstream consumer demands that namespace.
  • Disease vs phenotype. MONDO for the diagnosis (asthma), HP for the observed abnormality (Wheezing). Metadata fields usually want one or the other, not either.
  • Tissue vs cell type. UBERON for the sample's anatomical origin, CL for what the cells are. liver is UBERON, hepatocyte is CL — even though a search for hepatocyte restricted to uberon will return the CL term as an imported copy.
  • Assay: EFO first, OBI second. Genomics platforms and library strategies are richer in EFO; OBI is better for general laboratory assay classes.
  • Chemicals: ChEBI for anything with a structure. Drug products by trade name belong in a drug vocabulary (RxNorm, DrugBank), not ChEBI.
  • Sex: PATO (PATO:0000384 male, PATO:0000383 female). Not NCIT, not free text.
  • "Normal" / healthy control: PATO:0000461 (normal) is the conventional filler for a disease field with no disease, and is what several submission schemas require.

Common metadata fields and their expected ontology

Field names differ per archive, but the ontology behind each concept is stable:

ConceptOntology
tissue / organ / anatomical siteUBERON
cell typeCL
cell lineCLO, or Cellosaurus for identity and contamination status
diseaseMONDO (PATO:0000461 when none)
phenotypeHP
organismNCBITaxon
assay / platformEFO
developmental stageHsapDv, MmusDv
sexPATO
chemical / treatment compoundChEBI
environmental materialENVO

Submission schemas — CELLxGENE, HCA, ENA/BioSamples checklists, ISA-Tab configurations — pin both the field names and the permitted ontologies, and they revise them. Read the schema version the submission targets rather than relying on this table or on memory; the ontology choices above are the stable part, the field names are not.