Back to Changelog
Announcementv1.1.0

R SDK Now Available on CRAN

The official OMOPHub R SDK is now available on CRAN, making it easier than ever to access OHDSI vocabularies from R.

We're thrilled to announce that the OMOPHub R SDK is now officially available on CRAN, the official R package repository!

Installation

Installing the SDK is now as simple as:

install.packages("omophub")

Quick Start

library(omophub)

# Create a client
client <- OMOPHubClient$new()

# Search for concepts
results <- client$search$basic("diabetes")
results$data

# Get a specific concept
concept <- client$concepts$get(201826)
concept$concept_name
# [1] "Type 2 diabetes mellitus"

Key Features

Comprehensive API Coverage

The SDK provides access to all OMOPHub API resources:

ResourceDescription
conceptsConcept lookup, batch operations, suggestions
searchBasic and advanced concept search
vocabulariesVocabulary listing and details
domainsDomain listing and concept filtering
hierarchyAncestor and descendant navigation
relationshipsConcept relationships
mappingsConcept mappings between vocabularies

Automatic Pagination

Easily fetch large result sets:

# Fetch all results automatically
all_results <- client$search$basic_all("diabetes", page_size = 100)

Vocabulary Versioning

Pin to specific vocabulary versions for reproducible research:

client <- OMOPHubClient$new(vocab_version = "2025.2")

Secure API Key Storage

Multiple options for API key management, including system keyring integration:

# Store securely in system keyring
set_api_key("your_api_key", store = "keyring")

Resources

We welcome contributions and feedback on GitHub!