Retrieve CDISC SDTM Controlled Terminology

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"))

Source

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

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.

Examples

# Return only the terms
ct("term")
#> # A tibble: 43,698 × 7
#>    clst_code code    term                              name    syn   def   nci  
#>    <chr>     <chr>   <chr>                             <chr>   <chr> <chr> <chr>
#>  1 C141657   C174106 TENMW101                          10-Met… TENM… 10-M… 10-M…
#>  2 C141657   C141700 TENMW102                          10-Met… TENM… 10-M… 10-M…
#>  3 C141657   C147592 TENMW103                          10-Met… TENM… 10-M… 10-M…
#>  4 C141657   C141701 TENMW104                          10-Met… TENM… 10-M… 10-M…
#>  5 C141656   C141701 TENMW1-Test Grade                 10-Met… TENM… 10-M… 10-M…
#>  6 C141656   C141700 TENMW1-Time to Walk/Run 10 Meters 10-Met… TENM… 10-M… 10-M…
#>  7 C141656   C174106 TENMW1-Was Walk/Run Performed     10-Met… TENM… 10-M… 10-M…
#>  8 C141656   C147592 TENMW1-Wear Orthoses              10-Met… TENM… 10-M… 10-M…
#>  9 C141663   C174103 A4STR101                          4-Stai… A4ST… 4-St… 4-St…
#> 10 C141663   C141706 A4STR102                          4-Stai… A4ST… 4-St… 4-St…
#> # ℹ 43,688 more rows

# Return only the code lists
ct("list")
#> # A tibble: 1,158 × 9
#>    clst_code is_clst code    term          ext   name          syn   def   nci  
#>    <chr>     <lgl>   <chr>   <chr>         <lgl> <chr>         <chr> <chr> <chr>
#>  1 C141657   TRUE    C141657 TENMW1TC      FALSE 10-Meter Wal… 10-M… 10-M… CDIS…
#>  2 C141656   TRUE    C141656 TENMW1TN      FALSE 10-Meter Wal… 10-M… 10-M… CDIS…
#>  3 C141663   TRUE    C141663 A4STR1TC      FALSE 4-Stair Asce… 4-St… 4-St… CDIS…
#>  4 C141662   TRUE    C141662 A4STR1TN      FALSE 4-Stair Asce… 4-St… 4-St… CDIS…
#>  5 C141661   TRUE    C141661 D4STR1TC      FALSE 4-Stair Desc… 4-St… 4-St… CDIS…
#>  6 C141660   TRUE    C141660 D4STR1TN      FALSE 4-Stair Desc… 4-St… 4-St… CDIS…
#>  7 C115388   TRUE    C115388 SIXMW1TC      FALSE 6 Minute Wal… 6 Mi… 6 Mi… CDIS…
#>  8 C115387   TRUE    C115387 SIXMW1TN      FALSE 6 Minute Wal… 6 Mi… 6 Mi… CDIS…
#>  9 C182464   TRUE    C182464 AIMS0101T07OR FALSE Abnormal Inv… Abno… Abno… CDIS…
#> 10 C182465   TRUE    C182465 AIMS0108T09OR FALSE Abnormal Inv… Abno… Abno… CDIS…
#> # ℹ 1,148 more rows

# Return the full terminology (code lists and individual terms)
ct("all")
#> # A tibble: 44,856 × 9
#>    clst_code is_clst code    term                  ext   name  syn   def   nci  
#>    <chr>     <lgl>   <chr>   <chr>                 <lgl> <chr> <chr> <chr> <chr>
#>  1 C141657   TRUE    C141657 TENMW1TC              FALSE 10-M… 10-M… 10-M… CDIS…
#>  2 C141657   FALSE   C174106 TENMW101              NA    10-M… TENM… 10-M… 10-M…
#>  3 C141657   FALSE   C141700 TENMW102              NA    10-M… TENM… 10-M… 10-M…
#>  4 C141657   FALSE   C147592 TENMW103              NA    10-M… TENM… 10-M… 10-M…
#>  5 C141657   FALSE   C141701 TENMW104              NA    10-M… TENM… 10-M… 10-M…
#>  6 C141656   TRUE    C141656 TENMW1TN              FALSE 10-M… 10-M… 10-M… CDIS…
#>  7 C141656   FALSE   C141701 TENMW1-Test Grade     NA    10-M… TENM… 10-M… 10-M…
#>  8 C141656   FALSE   C141700 TENMW1-Time to Walk/… NA    10-M… TENM… 10-M… 10-M…
#>  9 C141656   FALSE   C174106 TENMW1-Was Walk/Run … NA    10-M… TENM… 10-M… 10-M…
#> 10 C141656   FALSE   C147592 TENMW1-Wear Orthoses  NA    10-M… TENM… 10-M… 10-M…
#> # ℹ 44,846 more rows