Quick Start

pip install omophub

import omophub

# Option 1: environment variable (recommended)
# export OMOPHUB_API_KEY="oh_xxxxxxxxx"
client = omophub.OMOPHub()

# Option 2: pass directly
client = omophub.OMOPHub(api_key="oh_xxxxxxxxx")

# Keyword search
results = client.search.basic("hypertension", page_size=5)
for concept in results["concepts"]:
    print(f"{concept['concept_id']}: {concept['concept_name']} ({concept['vocabulary_id']})")

# Semantic search - find concepts by clinical meaning, not just keyword match
results = client.search.semantic("high blood pressure that comes and goes", page_size=5)
for concept in results["concepts"]:
    print(f"{concept['concept_id']}: {concept['concept_name']}")

concept = client.concepts.get(201826)
print(f"Name:       {concept['concept_name']}")        # Type 2 diabetes mellitus
print(f"Code:       {concept['concept_code']}")         # 44054006
print(f"Vocabulary: {concept['vocabulary_id']}")        # SNOMED
print(f"Domain:     {concept['domain_id']}")            # Condition
print(f"Standard:   {concept['standard_concept']}")     # S

# Ancestors (parents)
result = client.hierarchy.ancestors(201826, max_levels=2)
for ancestor in result["ancestors"]:
    level = ancestor.get("hierarchy_level", 0)
    print(f"{'  ' * level}{ancestor['concept_name']}")

# Descendants (children)
result = client.hierarchy.descendants(201826, max_levels=1)
print(f"\n{len(result['descendants'])} child concepts")

# Map SNOMED "Type 2 diabetes" to ICD-10-CM
result = client.mappings.get(201826, target_vocabulary="ICD10CM")
for m in result["data"]["mappings"]:
    print(f"{m['relationship_id']}: {m['target_concept_name']} "
          f"({m['target_vocabulary_id']}: {m['target_concept_code']})")

result = client.fhir.resolve(
    system="http://snomed.info/sct",
    code="44054006",
    resource_type="Condition",
)
res = result["resolution"]
print(f"Standard concept: {res['standard_concept']['concept_id']} - {res['standard_concept']['concept_name']}")
print(f"Domain:           {res['standard_concept']['domain_id']}")
print(f"Target table:     {res['target_table']}")         # condition_occurrence
print(f"Mapping type:     {res['mapping_type']}")         # direct