ct: Retrieve CDISC SDTM Controlled Terminology

View source: R/ct.R

ctR Documentation

Retrieve CDISC SDTM Controlled Terminology

Description

Returns a tibble of CDISC SDTM controlled terminology, optionally filtered to include only term-level entries, only code list definitions, or both.

Usage

ct(subset = c("term", "list", "all"))

Arguments

subset

One of "term", "list", or "all" to specify which part of the terminology to return.

Value

A tibble containing the requested subset of CDISC controlled terminology:

clst_code

C-code of the code list that the term belongs to. Identifies the parent code list concept (e.g., C66742 for Yes/No/Unknown).

is_clst

Logical indicator: TRUE if the row represents a code list definition; FALSE if it represents a term within a code list.

code

C-code of the concept (either a term or a code list). Each term and list has a unique NCI Thesaurus concept code (e.g., C49487 for "Yes").

term

Submission value or label for the term (e.g., "Y", "TENMW1-Was Walk/Run Performed"). For code list rows, this may be the list name.

ext

Extensibility of the code list (TRUE, FALSE, or NA). NA for term-level rows.

name

Name of the code list or term category (e.g., "Yes/No/Unknown Response" or "10-Meter Walk/Run Functional Test Test Code").

syn

Synonyms or alternative names for the term, often used in CRF annotations or mappings.

def

Definition or description of the term or code list, taken from the NCI Thesaurus.

nci

Preferred label from the NCI Thesaurus; usually a short human-readable label for the concept.

Version

Controlled terminology data comes from the release dated 2025-03-25.

Source

https://evs.nci.nih.gov/ftp1/CDISC/SDTM/SDTM%20Terminology.txt

Examples

# Return only the terms
ct("term")

# Return only the code lists
ct("list")

# Return the full terminology (code lists and individual terms)
ct("all")


sdtm.terminology documentation built on April 12, 2025, 1:16 a.m.