Package: rxref 0.5.0

rxref: Tidy Utilities for 'RxNorm' and NDC Resolution

Provides a tidy, vectorized interface to the 'RxNorm' / 'RxNav' API for resolving drug names, 'RxNorm' Concept Unique Identifiers (RxCUIs), National Drug Codes (NDCs), and related drug concept metadata. The package supports workflows for mapping between drug names, RxCUIs, NDCs, ingredients, products, drug classes, and related concepts using data from the U.S. National Library of Medicine's 'RxNav' services <https://lhncbc.nlm.nih.gov/RxNav/APIs/> and 'RxNorm' <https://www.nlm.nih.gov/research/umls/rxnorm/>.

Authors:Steven Smith [aut, cre]

rxref_0.5.0.tar.gz
rxref_0.5.0.zip(r-4.7-any)rxref_0.5.0.zip(r-4.6-any)rxref_0.5.0.zip(r-4.5-any)
rxref_0.5.0.tgz(r-4.6-any)rxref_0.5.0.tgz(r-4.5-any)
rxref_0.5.0.tar.gz(r-4.7-any)rxref_0.5.0.tar.gz(r-4.6-any)
rxref_0.5.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
rxref/json (API)

# Install 'rxref' in R:
install.packages('rxref', repos = c('https://ssmithm.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/ssmithm/rxref/issues

Pkgdown/docs site:https://www.stevenmsmith.org

On CRAN:

Conda:

5.12 score 1 stars 11 scripts 286 downloads 42 exports 30 dependencies

Last updated from:14a6dfdbc1. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK125
source / vignettesOK246
linux-releaseOK124
macos-releaseOK135
macos-oldrelOK209
windows-develOK93
windows-releaseOK85
windows-oldrelOK78
wasm-releaseOK99

Exports:default_product_ttysexclude_products_with_ingredientsextended_product_ttysextended_ttysfilter_products_by_routefind_classesfind_ingredientsget_atcget_atcprodget_chemical_structureget_class_membersget_classesget_clinical_attributesget_contraindicationsget_drug_classesget_epcget_may_treatget_medrtget_medrt_moaget_medrt_peget_propertiesget_vaingredients_for_rxcuimap_ndc_to_rxcuimap_rxcui_to_ndcmap_tondc_statusproduct_ttysproducts_for_ingredientsresolverxclass_rela_sourcesrxclass_relasrxclass_relationshipsrxref_cacherxref_cache_clearrxref_cache_disablerxref_cache_inforxref_cache_use_diskrxref_cache_use_memoryrxref_confsearch_drugtty_catalogue

Dependencies:askpasscachemclicpp11curldigestdplyrfastmapgenericsgluehttr2jsonlitelifecyclemagrittrmemoiseopensslpillarpkgconfigpurrrR6rlangstringistringrsystibbletidyrtidyselectutf8vctrswithr

Case Study: Building route-specific RxCUI and NDC lists
Case | Define the ingredient list | Step 1: Identify ingredient RxCUIs | Step 2: Expand ingredients to product RxCUIs | Step 3: Inspect route and dose-form information | Step 4: Filter to oral products | Step 5: Map oral product RxCUIs to active NDCs | Quality-control checks | Confirm the observed routes | Look for non-oral terminology in product names | Review combination products | Check products without active NDCs | Summarize the final definition | A compact alternative with search_drug() | Adapting the workflow | Filter by route during product expansion | Exclude fixed-dose combination products | Include historical RxNorm concepts and NDC associations | Finalizing a route-specific medication definition

Last update: 2026-08-25
Started: 2026-05-07

Case Study: GLP-1 and related incretin therapies
Case | Define the ingredient list | Step 1: Identify ingredient RxCUIs | Step 2: Expand ingredients to product RxCUIs | Inspect the product set | Step 3: Map product RxCUIs to NDCs | Step 4: Perform a few quality checks | A compact alternative with search_drug() | Adapting the workflow | Exclude fixed-dose combination products | Use a broader set of product-related TTYs | Include historical RxNorm concepts and NDC associations | Finalizing the medication definition

Last update: 2026-08-25
Started: 2025-11-13

rxref: Getting started
Overview | Installation | Resolve drug names and identifiers | Inspect RxNorm concepts | Identify ingredient concepts | Expand ingredients to product concepts | Refine products using clinical attributes | Filter products by route | Map between RxCUIs and NDCs | Use search_drug() for a compact workflow | Work with historical concepts and NDC associations | Query drug classes with RxClass | Configure API behavior | Reproducibility | Summary

Last update: 2026-08-25
Started: 2025-11-11

Readme and manuals

Help Manual

Help pageTopics
Default RxNorm product term typesdefault_product_ttys
Exclude products containing specified ingredientsexclude_products_with_ingredients
Extended RxNorm product term typesextended_product_ttys
Extended RxNorm term typesextended_ttys
Filter RxNorm product concepts by route of administration.filter_products_by_route
Find RxClass drug classes by class namefind_classes
Resolve a free-text drug name to ingredient CUIs (IN/PIN)find_ingredients
Get ATC classes for RxNorm drugsget_atc
Get ATC product-level classes for RxNorm drugsget_atcprod
Get chemical-structure assertionsget_chemical_structure
Get RxNorm members of an RxClass classget_class_members
Get RxClass assertions for RxNorm drugsget_classes
Clinical attributes from the concept (SCD/SBD) or related SCD/SBDget_clinical_attributes
Get contraindication assertions from MED-RTget_contraindications
Get class-like RxClass assertions for RxNorm drugsget_drug_classes
Get FDA/SPL established pharmacologic classesget_epc
Get indication/treatment assertions from MED-RTget_may_treat
Get MED-RT assertions for RxNorm drugsget_medrt
Get MED-RT mechanism-of-action assertionsget_medrt_moa
Get MED-RT physiologic-effect assertionsget_medrt_pe
Get core RxNorm properties for one or more RxCUIsget_properties
Get VA drug classes for RxNorm drugsget_va
Get ingredient concepts for RxCUIsingredients_for_rxcui
Map NDCs to RxCUIsmap_ndc_to_rxcui
Map RxCUIs to NDCsmap_rxcui_to_ndc
Map between NDCs and RxCUIsmap_to
Get RxNav status for NDCsndc_status
RxNorm product term type setsproduct_ttys
Expand ingredient CUIs to product CUIs that truly contain the ingredientproducts_for_ingredients
Resolve free text, RxCUI, or NDC to RxCUI and preferred nameresolve
Get RxClass relationship sourcesrxclass_rela_sources
Get RxClass relationship typesrxclass_relas
Summarize RxClass relationship types for drugsrxclass_relationships
Manage the rxref cacherxref_cache rxref_cache_clear rxref_cache_disable rxref_cache_info rxref_cache_use_disk rxref_cache_use_memory
Configure rxrefrxref_conf
Search free-text drug name and return product CUIs and/or NDCssearch_drug
Catalogue of RxNorm TTY (Term Types)tty_catalogue