From 6957d644d5ffa5d10e29c08318c14e552c6f4522 Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 20:59:53 -0400 Subject: [PATCH 01/10] chore: start 0.2.0.9000 development version Bumps Version to 0.2.0.9000 and opens a development-version NEWS header after the 0.2.0 CRAN submission (release/cran-0.2.0). Co-Authored-By: Claude Sonnet 5.5 --- DESCRIPTION | 2 +- NEWS.md | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/DESCRIPTION b/DESCRIPTION index 17662b2..83b40a4 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: cdiscdata Title: Versioned CDISC Standards Reference Data -Version: 0.2.0 +Version: 0.2.0.9000 Authors@R: person("Bill", "Denney", email = "wdenney@humanpred.com", role = c("aut", "cre"), comment = c(ORCID = "0000-0002-5759-428X")) diff --git a/NEWS.md b/NEWS.md index 8b2c216..fa88b70 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,3 +1,5 @@ +# cdiscdata (development version) + # cdiscdata 0.2.0 ## Classed conditions and coverage From d771fb4c236226d4181c644b8f464d3bdb53d54e Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 21:00:22 -0400 Subject: [PATCH 02/10] fix(ig): tidy IG labels and names for the 40-character XPT limit nca.reporter hit label-length failures writing XPT v5 from ig_sdtm/ig_adam. Auditing the tables found a wider transcription problem than the labels reported: hard-wrapped Word table cells left literal newlines in 62 ig_sdtm and 271 ig_adam labels, 112 ig_sdtm and 7 ig_adam variable names had trailing spaces ("--TESTCD " != "--TESTCD"), type values were padded ("Char "), and five section sub-headings in the ADaMIG 1.0 combined ADSL table were transcribed as variables with no label. read_ig_csv() now collapses whitespace in every identifying field, the sub-heading rows are dropped, and the four labels still over 40 characters use the abbreviated form. Checked against published documents, not from memory: - SDTMIG v3.3 (CDISC wiki, sdtmig_v3.3.pdf): section 4.2.1 states labels are "up to 40 characters"; section 6.3.11.2 (Pharmacokinetics Parameters), PP specification table, labels PPSTRESC "Character Result/Finding in Std Format"; section 6.3.10.1 (Generic Morphology/Physiology Specification), generic table, labels --TESTCD "Short Name of Measurement, Test or Exam". Applied to SDTMIG 3.2 PPSTRESC and SDTM Model 1.4-1.6 --TESTCD. - ADaMIG v1.2 draft (CDISC wiki, ADaMIG-compiled), section 3.3.4.1, Table 3.3.4.1.1: PBCHGCyN is published as "Percent Change to Baseline Category y (N)" (41 characters), so the IG itself exceeds the limit; the sibling PCHGCAyN is abbreviated "Percent Chg from Baseline Category y (N)". The new "Percent Chg to Baseline Category y (N)" follows that convention and is a derived label. The wiki copy is a draft, not the final v1.2. Adds gates in test-data_integrity.R: no label is NA, contains a newline, or exceeds 40 characters; no variable is NA, blank, or contains whitespace; no type/core/codelist/role value has stray whitespace. Fixes live in data-raw (utils_ig.R, build_ig_sdtm.R, build_ig_adam.R) and data/ is regenerated. Co-Authored-By: Claude Sonnet 5.5 --- NEWS.md | 29 ++++++++++++ data-raw/build_ig_adam.R | 28 +++++++++++- data-raw/build_ig_sdtm.R | 28 +++++++++++- data-raw/ig_source/README.md | 15 ++++++ data-raw/utils_ig.R | 51 ++++++++++++++++++--- data/ig_adam.rda | Bin 25376 -> 24904 bytes data/ig_sdtm.rda | Bin 8500 -> 7936 bytes tests/testthat/test-data_integrity.R | 66 +++++++++++++++++++++++++++ 8 files changed, 209 insertions(+), 8 deletions(-) diff --git a/NEWS.md b/NEWS.md index fa88b70..33d98ac 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,5 +1,34 @@ # cdiscdata (development version) +## IG label and identifier fixes + +* Fixed transcription defects in `ig_sdtm` and `ig_adam` found by nca.reporter + when writing XPT v5 files (labels are limited to 40 characters; SDTMIG 3.3 + section 4.2.1): + - 62 `ig_sdtm` and 271 `ig_adam` labels carried literal newlines from + hard-wrapped Word table cells; whitespace is now collapsed for every + identifying field (`variable`, `label`, `type`, `core`, `codelist`, + `role`). + - 112 `ig_sdtm` and 7 `ig_adam` variable names had trailing spaces (so + `"--TESTCD "` never equalled `"--TESTCD"`, and the ADSL/BDS + de-duplication in `build_domain_spec()` silently missed e.g. `"FASFL "`); + `type` values such as `"Char "` were padded the same way. + - Four labels over 40 characters now use the abbreviated form: SDTM Model + 1.4-1.6 `--TESTCD` ("Short Name of Measurement, Test or Exam", as in + SDTMIG 3.3 section 6.3.10.1), SDTMIG 3.2 `PPSTRESC` ("Character + Result/Finding in Std Format", as in SDTMIG 3.3 section 6.3.11.2), and + ADaMIG 1.2 `PBCHGCyN` ("Percent Chg to Baseline Category y (N)"; the + IG publishes 41 characters here, so this follows its sibling + `PCHGCAyN`'s "Chg" abbreviation and is a derived label). + - Five section sub-headings in the ADaMIG 1.0 combined ADSL table + ("Study Identifiers", "Subject Demographics", ...) were transcribed as + variables with no label; they are dropped (`ig_adam` is 851 rows, was + 856). + - New gates in `tests/testthat/test-data_integrity.R`: no label in + `ig_sdtm`/`ig_adam` is `NA`, contains a newline, or exceeds 40 + characters; no variable name is `NA`, blank, or contains whitespace; no + `type`/`core`/`codelist`/`role` value has stray whitespace. + # cdiscdata 0.2.0 ## Classed conditions and coverage diff --git a/data-raw/build_ig_adam.R b/data-raw/build_ig_adam.R index 13888dd..d43cbe2 100644 --- a/data-raw/build_ig_adam.R +++ b/data-raw/build_ig_adam.R @@ -25,6 +25,11 @@ build_adamig_version <- function(version) { rows_for <- function(file, dataset) { tbl <- read_ig_csv(file.path(dir, file)) + # ADaMIG 1.0's combined ADSL-specification.csv carries five section + # sub-headings as rows ("Study Identifiers", "Subject Demographics", + # "Population Indicator(s)", "Treatment Variables", "Trial Dates"): + # no Type, Core, or label, because they are not variables. + tbl <- tbl[!is.na(tbl$type), ] category <- tools::file_path_sans_ext(file) data.frame( dataset = dataset, @@ -51,10 +56,31 @@ build_adamig_version <- function(version) { ig_adam <- do.call(rbind, lapply(adamig_versions, build_adamig_version)) rownames(ig_adam) <- NULL +# ── Labels over the 40-character XPT limit ───────────────────────────────── +# Checked against the published ADaMIG v1.2 (draft) on the CDISC wiki +# (https://wiki.cdisc.org/download/attachments/54282867/ADaMIG-ADaMIG-compiled-191217-0027-11448.pdf), +# section 3.3.4.1, Table 3.3.4.1.1 "Analysis Parameter Variables for BDS +# Datasets": PBCHGCyN is published as "Percent Change to Baseline Category y +# (N)" (41 characters), so the IG itself exceeds the limit there. Its sibling +# rows in the same table abbreviate "Change" to "Chg" for the same reason +# (PCHGCATy "Percent Chg from Baseline Category y", PCHGCAyN "Percent Chg from +# Baseline Category y (N)"); this applies the same abbreviation, which is a +# derived label, not one the IG publishes. +adam_label_overrides <- data.frame( + dataset = "BDS", + version = "1.2", + variable = "PBCHGCyN", + label = "Percent Chg to Baseline Category y (N)", + evidence = "ADaMIG v1.2 draft Table 3.3.4.1.1 (PBCHGCyN 41 chars; sibling PCHGCAyN abbreviates Chg)", + stringsAsFactors = FALSE +) +ig_adam <- apply_label_overrides(ig_adam, adam_label_overrides, + by = c("dataset", "version", "variable")) + stopifnot( all(c("dataset", "version", "category", "order", "variable", "label", "type", "core", "codelist", "length", "notes") %in% names(ig_adam)), - !anyNA(ig_adam$variable), !anyNA(ig_adam$version) + !anyNA(ig_adam$variable), !anyNA(ig_adam$version), !anyNA(ig_adam$label) ) usethis::use_data(ig_adam, overwrite = TRUE, compress = "xz") diff --git a/data-raw/build_ig_sdtm.R b/data-raw/build_ig_sdtm.R index a4d3bae..2d5eb5b 100644 --- a/data-raw/build_ig_sdtm.R +++ b/data-raw/build_ig_sdtm.R @@ -80,10 +80,36 @@ sdtmig_rows <- do.call(rbind, c( ig_sdtm <- rbind(model_rows, sdtmig_rows) rownames(ig_sdtm) <- NULL +# ── Labels over the 40-character XPT limit ───────────────────────────────── +# Checked against the published SDTMIG v3.3 (CDISC wiki PDF +# https://wiki.cdisc.org/download/attachments/66274516/sdtmig_v3.3.pdf): +# - section 4.2.1: "Variable descriptive names (labels), up to 40 +# characters, should be provided as data variable labels for all +# variables, including Supplemental Qualifier variables." +# - section 6.3.11.2 (Pharmacokinetics Parameters), PP specification table: +# PPSTRESC is labelled "Character Result/Finding in Std Format". +# - section 6.3.10.1 (Generic Morphology/Physiology Specification), generic +# table: --TESTCD is labelled "Short Name of Measurement, Test or Exam". +# Model 1.7 as transcribed already uses a 40-character form of this +# (with an Oxford comma); Model 1.4-1.6 transcribe the long form +# "Short Name of Measurement, Test or Examination" (46 characters). +sdtm_label_overrides <- data.frame( + source = c("SDTM_MODEL", "SDTM_MODEL", "SDTM_MODEL", "SDTMIG"), + version = c("1.4", "1.5", "1.6", "3.2"), + variable = c("--TESTCD", "--TESTCD", "--TESTCD", "PPSTRESC"), + label = c(rep("Short Name of Measurement, Test or Exam", 3), + "Character Result/Finding in Std Format"), + evidence = c(rep("SDTMIG v3.3 6.3.10.1 generic table; 4.2.1 label limit", 3), + "SDTMIG v3.3 6.3.11.2 PP specification table"), + stringsAsFactors = FALSE +) +ig_sdtm <- apply_label_overrides(ig_sdtm, sdtm_label_overrides, + by = c("source", "version", "variable")) + stopifnot( all(c("source", "version", "class", "domain", "order", "variable", "label", "type", "role", "core", "codelist", "length", "notes") %in% names(ig_sdtm)), - !anyNA(ig_sdtm$variable), !anyNA(ig_sdtm$version) + !anyNA(ig_sdtm$variable), !anyNA(ig_sdtm$version), !anyNA(ig_sdtm$label) ) usethis::use_data(ig_sdtm, overwrite = TRUE, compress = "xz") diff --git a/data-raw/ig_source/README.md b/data-raw/ig_source/README.md index b92d0e7..1449060 100644 --- a/data-raw/ig_source/README.md +++ b/data-raw/ig_source/README.md @@ -48,3 +48,18 @@ choice). `ig_sdtm$length` / `ig_adam$length` are `NA` except for the small number of variables (PPTESTCD, PPTEST, ...) whose IG text explicitly states a maximum character count, which `parse_documented_length()` recovers from that text. + +## Whitespace and labels + +`read_ig_csv()` collapses every run of whitespace (hard line breaks and +non-breaking spaces from wrapped Word/PDF table cells included) in the +`variable`, `label`, `type`, `core`, `codelist`, and `role` fields, because a +wrapped cell otherwise keeps a literal newline and a cell with a trailing +space becomes a variable name such as `"--TESTCD "`. `notes` is left as is. + +Labels in the IGs are limited to 40 characters (SDTMIG 3.3 section 4.2.1); +the few that transcribe longer are set in `sdtm_label_overrides` +(`build_ig_sdtm.R`) and `adam_label_overrides` (`build_ig_adam.R`), each with +the IG table it was checked against. The ADaMIG 1.2 PBCHGCyN override is a +derived abbreviation, since the IG itself publishes 41 characters there. +`tests/testthat/test-data_integrity.R` gates all of this. diff --git a/data-raw/utils_ig.R b/data-raw/utils_ig.R index 50f1c4e..3287733 100644 --- a/data-raw/utils_ig.R +++ b/data-raw/utils_ig.R @@ -37,17 +37,56 @@ read_ig_csv <- function(path) { } data.frame( - variable = pick("^Variable( Name)?$", exclude = "Label"), - label = pick("Variable Label"), - type = pick("^Type$"), - core = pick("^Core$"), - codelist = pick("Codelist|Controlled Terms"), - role = pick("^Role$"), + variable = tidy_text(pick("^Variable( Name)?$", exclude = "Label")), + label = tidy_text(pick("Variable Label")), + type = tidy_text(pick("^Type$")), + core = tidy_text(pick("^Core$")), + codelist = tidy_text(pick("Codelist|Controlled Terms")), + role = tidy_text(pick("^Role$")), notes = pick("CDISC Notes|^Description$"), stringsAsFactors = FALSE ) } +# Collapse every run of whitespace (including the hard line breaks and +# non-breaking spaces left by transcribing a wrapped Word/PDF table cell) +# to a single space and trim the ends. Without this, a table cell that wrapped +# across lines in the source document keeps a literal newline in the value, and +# a cell with a trailing space in the source becomes e.g. the variable name +# "--TESTCD " that never equals "--TESTCD". Applied to every identifying or +# categorical field; not to `notes`, which is free text meant to keep its +# paragraph breaks. +tidy_text <- function(x) { + trimws(gsub("[[:space:] ]+", " ", x, perl = TRUE)) +} + +# Apply documented label overrides to a built IG table. +# +# A handful of labels as published in a CDISC IG exceed the 40-character +# limit for a SAS v5 transport (XPT) variable label, which the same IGs state +# for every variable they define (SDTMIG 3.3 section 4.2.1, "Variable +# descriptive names (labels), up to 40 characters"). The IGs deal with this +# by abbreviating in the domain tables themselves while leaving the generic +# model table or a sibling row at its long form, so the long form is what +# transcribes. `overrides` carries, for each such row, the published +# abbreviation to use instead (or, where the IG publishes none, a sibling- +# consistent one) and `evidence` naming the table checked; this stops, rather +# than silently skipping, if an override does not match exactly the rows it is +# written for. +apply_label_overrides <- function(tbl, overrides, by) { + stopifnot(all(c(by, "label", "evidence") %in% names(overrides))) + for (i in seq_len(nrow(overrides))) { + hit <- rep(TRUE, nrow(tbl)) + for (col in by) hit <- hit & !is.na(tbl[[col]]) & tbl[[col]] == overrides[[col]][i] + if (!any(hit)) { + stop("Label override matched no rows: ", + paste(by, unlist(overrides[i, by]), sep = "=", collapse = ", ")) + } + tbl$label[hit] <- overrides$label[i] + } + tbl +} + # Extract a codelist submission value (e.g. "PKPARMCD") from the free-text # "Codelist/Controlled Terms" column, e.g. "(PKPARMCD)" -> "PKPARMCD". CDISC # also uses this column for a non-codelist marker ("*" = extensible list not diff --git a/data/ig_adam.rda b/data/ig_adam.rda index ac49d45978307e0997ed675e6f98acf1009bf6e2..923183617922ec6ea6c69b90bc00ecf78bdbb964 100644 GIT binary patch literal 24904 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 L0ssI200CKAc~5eU literal 25376 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 PJ}?c70ssI200CKAzu*_w diff --git a/data/ig_sdtm.rda b/data/ig_sdtm.rda index 60686c6488f780edb726422e4e0ab5ee45c01929..9c2612d157a31d61357b5abb38a4a9e7ed3be292 100644 GIT binary patch delta 7690 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 ET0Mm1K>z>% delta 8259 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 B?v(%l diff --git a/tests/testthat/test-data_integrity.R b/tests/testthat/test-data_integrity.R index 27812bd..6b82f5f 100644 --- a/tests/testthat/test-data_integrity.R +++ b/tests/testthat/test-data_integrity.R @@ -91,6 +91,72 @@ test_that("historical codelist_name/codelist_code gaps stay within a known bound expect_lt(sum(is.na(ct_sdtm$term_code) & is.na(ct_sdtm$codelist_code)), 200L) }) +# Mechanical gate on the IG tables' identifying text, so the transcription +# problems found by nca.reporter when writing XPT v5 files (40-character +# variable-label limit, SDTMIG 3.3 section 4.2.1) cannot recur unnoticed: +# hard-wrapped labels with embedded newlines, over-length labels, section +# sub-headings transcribed as variables (NA label), and variable names with +# trailing whitespace (e.g. "--TESTCD " never equals "--TESTCD"). +ig_tables_for_gate <- function() { + list(ig_sdtm = get_ig("sdtm"), ig_adam = get_ig("adam")) +} + +test_that("no IG label is NA, contains a newline, or exceeds 40 characters", { + for (nm in names(ig_tables_for_gate())) { + tbl <- ig_tables_for_gate()[[nm]] + expect_false(anyNA(tbl$label), label = paste(nm, "has an NA label")) + expect_false(any(grepl("[\r\n]", tbl$label)), + label = paste(nm, "has a label containing a newline")) + too_long <- nchar(tbl$label) > 40L + expect_equal(tbl$variable[too_long], character(0L), + label = paste(nm, "variables whose label exceeds 40 characters")) + } +}) + +test_that("no IG variable name is NA, blank, or contains whitespace", { + for (nm in names(ig_tables_for_gate())) { + tbl <- ig_tables_for_gate()[[nm]] + expect_false(anyNA(tbl$variable), label = paste(nm, "has an NA variable")) + expect_equal(tbl$variable[!nzchar(tbl$variable)], character(0L)) + expect_equal(tbl$variable[grepl("[[:space:]]", tbl$variable)], character(0L), + label = paste(nm, "variable names containing whitespace")) + } +}) + +test_that("IG categorical fields carry no leading/trailing or doubled whitespace", { + for (nm in names(ig_tables_for_gate())) { + tbl <- ig_tables_for_gate()[[nm]] + for (col in intersect(c("type", "core", "codelist", "role"), names(tbl))) { + v <- tbl[[col]] + v <- v[!is.na(v)] + expect_equal(v[v != trimws(v) | grepl("[[:space:]]{2,}|[\r\n]", v)], character(0L), + label = paste(nm, col, "values with stray whitespace")) + } + } +}) + +test_that("the specific IG labels that exceeded 40 characters are the abbreviated published forms", { + sdtm <- get_ig("sdtm") + testcd <- sdtm[sdtm$source == "SDTM_MODEL" & sdtm$variable == "--TESTCD" & + sdtm$version %in% c("1.4", "1.5", "1.6"), ] + expect_equal(sort(testcd$version), c("1.4", "1.5", "1.6")) + expect_equal(testcd$label, rep("Short Name of Measurement, Test or Exam", 3L)) + expect_equal(sdtm$label[sdtm$variable == "PPSTRESC" & sdtm$source == "SDTMIG"], + "Character Result/Finding in Std Format") + + adam <- get_ig("adam") + expect_equal(adam$label[adam$variable == "PBCHGCyN"], + "Percent Chg to Baseline Category y (N)") +}) + +test_that("ADaMIG 1.0 ADSL section sub-headings are not transcribed as variables", { + adsl_10 <- get_ig("adam", version = "1.0") + adsl_10 <- adsl_10[adsl_10$dataset == "ADSL", ] + expect_false(any(c("Study Identifiers", "Subject Demographics", + "Population Indicator(s)", "Treatment Variables", + "Trial Dates") %in% adsl_10$variable)) +}) + # Gap-detection thresholds below are calibrated against verified NCI # publishing history (checked directly against NCI's own file listing API; # see data-raw/utils_nci.R's list_archive_dates()), not against an assumed From 21031fc7223e0890f323dea16e56f64cc29218c4 Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 21:07:40 -0400 Subject: [PATCH 03/10] feat(ig): add SDTMIG 3.3 PP and SUPP--; add get_ig(domain =) ig_sdtm now carries the SDTMIG PP domain and generic SUPP-- structure at 3.3 as well as 3.2, and get_ig() gains a domain argument so get_ig("sdtm", version = "3.3", domain = "PP") works (for "adam" it matches the dataset column). build_domain_spec("PP"/"SUPPPP") default to 3.3. Checked against the published SDTMIG v3.3 (CDISC wiki PDF wiki.cdisc.org/download/attachments/66274516/sdtmig_v3.3.pdf): - section 6.3.11.2, PP specification table (printed pp.542-547/796): 24 variables in the order STUDYID .. PPSPEC, TAETORD, EPOCH, PPDTC, PPDY, PPRFTDTC, PPSTINT, PPENINT. The table heading is stamped "Version 3.2" and the revision history lists no PP change, so the table is unchanged between 3.2 and 3.3 and 3.3 reuses the 3.2 tables. - section 8.4.1, SUPP-- specification (printed pp.763-765/796): the same ten variables, labels, and types as 3.2. - PPANMETH is NOT in the 3.3 PP table, and the published name is PPDTC, not PPPDTC; TAETORD, not PTAETORD. The Rsdtm 3.2 transcription had only 21 of the 24 PP rows (TAETORD, EPOCH and PPDY dropped); data-raw/ig_source/sdtmig_3.2/PP-additions.csv adds them in their published positions without touching the copied Rsdtm files. The PDF is a cropped browser print, so it shows no Core column: Core "Perm" for the three added rows is from the Certara PKSubmit SDTM_3.2 appendix (secondary), and existing rows keep their Rsdtm Core. NOT included: SDTMIG 3.4. CDISC's own copy is members-only and the only direct PDF is a third-party mirror, so 3.4 is left until a source is approved; PPANMETH and PPTPTREF are reported by the Certara appendix, not the IG, as 3.4 additions. Also corrects the get_ig() and NEWS claims that PPANMETH, EPOCH, PTAETORD and a PPPDTC rename were missing only because of the 3.2 cap. Co-Authored-By: Claude Sonnet 5.5 --- NEWS.md | 26 ++++++ R/data.R | 7 +- R/get_ig.R | 72 ++++++++++----- README.md | 3 +- data-raw/build_ig_sdtm.R | 59 +++++++++--- data-raw/ig_source/README.md | 33 +++++-- .../ig_source/sdtmig_3.2/PP-additions.csv | 4 + data/datasets_catalogue.rda | Bin 536 -> 540 bytes data/ig_sdtm.rda | Bin 7936 -> 8072 bytes man/get_ig.Rd | 33 ++++--- man/ig_sdtm.Rd | 7 +- tests/testthat/test-build_domain_spec.R | 18 ++++ tests/testthat/test-data_integrity.R | 5 +- tests/testthat/test-get_ig.R | 86 +++++++++++++++++- 14 files changed, 286 insertions(+), 67 deletions(-) create mode 100644 data-raw/ig_source/sdtmig_3.2/PP-additions.csv diff --git a/NEWS.md b/NEWS.md index 33d98ac..63164dd 100644 --- a/NEWS.md +++ b/NEWS.md @@ -29,6 +29,32 @@ characters; no variable name is `NA`, blank, or contains whitespace; no `type`/`core`/`codelist`/`role` value has stray whitespace. +## SDTMIG 3.3 PP/SUPP-- and `get_ig(domain =)` + +* `ig_sdtm` now carries the SDTMIG PP domain and generic SUPP-- structure at + version 3.3 as well as 3.2, and `get_ig()` gains a `domain` argument + (`get_ig("sdtm", version = "3.3", domain = "PP")`; for `"adam"` it matches + the `dataset` column, `"ADSL"` or `"BDS"`). An unknown domain is a classed + `cdiscdata_error_ig_domain_unavailable`. `build_domain_spec("PP")` and + `build_domain_spec("SUPPPP")` now default to 3.3. +* Checked against the published SDTMIG v3.3 (CDISC wiki PDF): its section + 6.3.11.2 PP specification is stamped "Version 3.2" and its revision history + lists no PP change, so the PP table is unchanged between 3.2 and 3.3; the + section 8.4.1 SUPP-- specification has the same ten variables. The 3.3 + tables are therefore the 3.2 ones. +* **Correction to the 0.2.0 notes.** They said `PPANMETH`, `EPOCH`, + `PTAETORD`, and a `PPPDTC` rename were missing because only SDTMIG 3.2 was + available. Checked against the published SDTMIG v3.3, that was wrong in + three ways: `EPOCH`, `TAETORD` (not `PTAETORD`), and `PPDY` are in the PP + table and were simply dropped from the Rsdtm 3.2 transcription (21 of 24 + rows), now added to both 3.2 and 3.3 in their published positions; + `PPDTC` (not `PPPDTC`) is the published name; and `PPANMETH` is not in the + 3.3 PP table. `PPANMETH` and `PPTPTREF` are reported (by a vendor + appendix, not the IG) as SDTMIG 3.4 additions; SDTMIG 3.4 is not yet + included because CDISC does not host it publicly. nca.reporter's + `PTAETORD`, `PPPDTC`, and `PPPDY` (seeded from aNCA) are not published + SDTMIG names. + # cdiscdata 0.2.0 ## Classed conditions and coverage diff --git a/R/data.R b/R/data.R index 111151b..4ee052f 100644 --- a/R/data.R +++ b/R/data.R @@ -40,8 +40,9 @@ #' Versioned SDTM Model and SDTMIG variable metadata: the Model's Findings #' general-observation-class variables (versions 1.4-1.7), the SDTMIG PP #' domain, and the SDTMIG generic SUPP-- qualifier structure (used for -#' SUPPPP; version 3.2 only - see \code{data-raw/ig_source/README.md} for -#' why no newer SDTMIG version's PP/SUPP-- tables were available to source). +#' SUPPPP; versions 3.2 and 3.3, which share the same tables - see +#' \code{\link{get_ig}} and \code{data-raw/ig_source/README.md} for why no +#' newer SDTMIG version's PP/SUPP-- tables are available yet). #' Use \code{\link{get_ig}} to retrieve it, and #' \code{\link{build_domain_spec}} to build a ready-to-use PP/SUPPPP/ADPP #' variable spec from it (joined to CT for codelist ids). @@ -50,7 +51,7 @@ #' \describe{ #' \item{source}{\code{"SDTM_MODEL"} or \code{"SDTMIG"}.} #' \item{version}{SDTM Model version (\code{"1.4"}-\code{"1.7"}) for -#' \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"}) for +#' \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"} or \code{"3.3"}) for #' \code{source == "SDTMIG"} rows. The two are independent numbering #' systems; see \code{\link{get_ig}}.} #' \item{class}{General observation class, e.g. \code{"Findings"}. diff --git a/R/get_ig.R b/R/get_ig.R index 161fd68..e4add43 100644 --- a/R/get_ig.R +++ b/R/get_ig.R @@ -12,42 +12,66 @@ #' and ADPP datasets specifically. #' #' \strong{SDTMIG coverage.} The SDTMIG PP domain and the generic SUPP-- -#' structure are only available at version 3.2, because that is as far as -#' the Rsdtm source this package copies from goes (see -#' \code{data-raw/ig_source/README.md}); no newer SDTMIG's PP/SUPP-- tables -#' were available to source. As a result, PP variables CDISC added or -#' renamed after SDTMIG 3.2 are absent from \code{ig_sdtm} - notably -#' \code{PPANMETH}, \code{EPOCH}, and \code{PTAETORD} (added later), and the -#' \code{PPDTC} to \code{PPPDTC} rename (SDTMIG 3.2 still has \code{PPDTC}). -#' Sourcing a newer SDTMIG - via a CDISC Library API key or a newer public -#' transcription - would close this gap. +#' structure are available at versions 3.2 and 3.3. Version 3.3 reuses the +#' 3.2 tables: the published SDTMIG v3.3 stamps its PP specification +#' "Version 3.2" (unchanged since 3.2) and its SUPP-- specification has the +#' same ten variables. Both versions include \code{TAETORD}, \code{EPOCH}, +#' and \code{PPDY}, which the Rsdtm transcription of 3.2 this package copies +#' from omitted. Neither includes \code{PPANMETH} or \code{PPTPTREF}, which +#' are reported to be SDTMIG 3.4 additions that have not yet been sourced from +#' the IG itself (see \code{data-raw/ig_source/README.md}). \code{PPDTC} (not +#' \code{PPPDTC}) is the published name of the date/time-of-calculation +#' variable in both versions. #' #' @param standard One of \code{"sdtm"} or \code{"adam"}. #' @param version A version string present in the \code{version} column #' (e.g. \code{"3.2"} for SDTMIG, \code{"1.7"} for the SDTM Model, #' \code{"1.2"} for ADaMIG). \code{NULL} (the default) returns all #' versions. +#' @param domain Restrict to one domain/dataset: for \code{"sdtm"}, the +#' \code{domain} column (\code{"PP"} or \code{"SUPPQUAL"}; SDTM Model +#' rows have no domain and are excluded); for \code{"adam"}, the +#' \code{dataset} column (\code{"ADSL"} or \code{"BDS"}). \code{NULL} +#' (the default) applies no domain filter. #' @return A data frame: \code{\link{ig_sdtm}} or \code{\link{ig_adam}}, -#' optionally filtered to one version. +#' optionally filtered to one version and/or domain. #' @export #' @examples #' get_ig("sdtm") -#' get_ig("sdtm", version = "3.2") -#' get_ig("adam", version = "1.2") -get_ig <- function(standard = c("sdtm", "adam"), version = NULL) { +#' get_ig("sdtm", version = "3.3", domain = "PP") +#' get_ig("adam", version = "1.2", domain = "BDS") +get_ig <- function(standard = c("sdtm", "adam"), version = NULL, domain = NULL) { standard <- match.arg(standard) tbl <- .pkg_data(paste0("ig_", standard)) - if (is.null(version)) return(tbl) - avail <- sort(unique(tbl$version)) - if (!version %in% avail) { - .cdiscdata_abort( - paste0( - "Version '", version, "' is not available for standard '", standard, "'. ", - "Available versions: ", paste(avail, collapse = ", "), "." - ), - "ig_version_unavailable" - ) + if (!is.null(version)) { + avail <- sort(unique(tbl$version)) + if (!version %in% avail) { + .cdiscdata_abort( + paste0( + "Version '", version, "' is not available for standard '", standard, "'. ", + "Available versions: ", paste(avail, collapse = ", "), "." + ), + "ig_version_unavailable" + ) + } + tbl <- tbl[tbl$version == version, ] } - tbl[tbl$version == version, ] + + if (!is.null(domain)) { + domain_col <- if (standard == "sdtm") "domain" else "dataset" + avail <- sort(unique(tbl[[domain_col]])) + if (!domain %in% avail) { + .cdiscdata_abort( + paste0( + "Domain '", domain, "' is not available for standard '", standard, "'", + if (!is.null(version)) paste0(" at version '", version, "'"), + ". Available: ", if (length(avail)) paste(avail, collapse = ", ") else "none", "." + ), + "ig_domain_unavailable" + ) + } + tbl <- tbl[tbl[[domain_col]] %in% domain, ] + } + tbl } diff --git a/README.md b/README.md index 32287a7..21ee31d 100644 --- a/README.md +++ b/README.md @@ -81,8 +81,7 @@ current). `get_ct()` reconstructs the state of any release on the fly. ig_sdtm <- get_ig("sdtm") # Just the SDTMIG PP domain -pp_ig <- get_ig("sdtm", version = "3.2") -pp_ig <- pp_ig[pp_ig$domain == "PP", ] +pp_ig <- get_ig("sdtm", version = "3.3", domain = "PP") # A ready-to-use variable spec (name, label, type, length, core, order, # codelist id) for PP, SUPPPP, or ADPP, joined to CT for codelist ids diff --git a/data-raw/build_ig_sdtm.R b/data-raw/build_ig_sdtm.R index 2d5eb5b..67da0ab 100644 --- a/data-raw/build_ig_sdtm.R +++ b/data-raw/build_ig_sdtm.R @@ -12,10 +12,16 @@ # the SDTM Model is available for versions 1.4-1.7 (Findings class only, the # class PP/SUPPPP need); the SDTMIG PP and Supplemental Qualifiers domain # specifications are only transcribed for version 3.2 (Rsdtm's SDTMIG_3.3 -# copy covers a different, unrelated set of domains). Only version 3.2 is -# built here as a result; a newer SDTMIG's PP/SUPP-- tables can be added by -# copying the equivalent CSVs into data-raw/ig_source/sdtmig_/ and -# extending the `sdtmig_versions` loop below. +# copy covers a different, unrelated set of domains). +# +# SDTMIG 3.3 reuses the 3.2 tables: the published SDTMIG v3.3 stamps its PP +# specification "Version 3.2" (so it is unchanged since 3.2; its revision +# history lists no PP change) and its SUPP-- specification, while stamped +# 3.3, has the same ten variables with the same labels and types. See +# `sdtmig_sources` below and data-raw/ig_source/README.md. A newer SDTMIG's +# tables can be added by copying the equivalent CSVs into +# data-raw/ig_source/sdtmig_/ and adding the version to +# `sdtmig_sources`. source("data-raw/utils_ig.R") @@ -47,11 +53,42 @@ model_rows <- do.call(rbind, lapply(model_versions, function(v) { })) # ── SDTMIG: PP and Supplemental Qualifiers (SUPP--) ───────────────────────── -sdtmig_versions <- "3.2" +# SDTMIG version -> data-raw/ig_source/sdtmig_ its tables are read from. +sdtmig_sources <- c("3.2" = "3.2", "3.3" = "3.2") +sdtmig_versions <- names(sdtmig_sources) + +# PP variables the SDTMIG v3.3 PDF (section 6.3.11.2, PP specification table) +# shows that Rsdtm's SDTMIG 3.2 transcription lacks (it has 21 of the 24 rows, +# evidently dropping the ones straddling a page break). Each row names the +# variable it follows, so the published order is kept. +read_pp_additions <- function() { + utils::read.csv("data-raw/ig_source/sdtmig_3.2/PP-additions.csv", + stringsAsFactors = FALSE, na.strings = "") +} + +insert_pp_additions <- function(tbl, additions) { + for (i in seq_len(nrow(additions))) { + a <- additions[i, ] + pos <- match(a$after, tbl$variable) + stopifnot(!is.na(pos), !a$variable %in% tbl$variable) + new <- data.frame( + variable = a$variable, label = a$label, type = a$type, + core = a$core, codelist = a$codelist, role = a$role, + notes = NA_character_, stringsAsFactors = FALSE + ) + tbl <- rbind(tbl[seq_len(pos), names(new)], new, + tbl[seq_len(nrow(tbl))[-seq_len(pos)], names(new)]) + } + tbl +} build_sdtmig_domain <- function(version, domain, file) { - path <- file.path("data-raw/ig_source", paste0("sdtmig_", version), file) + path <- file.path("data-raw/ig_source", + paste0("sdtmig_", sdtmig_sources[[version]]), file) tbl <- read_ig_csv(path) + if (domain == "PP") { + tbl <- insert_pp_additions(tbl, read_pp_additions()) + } data.frame( source = "SDTMIG", version = version, @@ -94,13 +131,13 @@ rownames(ig_sdtm) <- NULL # (with an Oxford comma); Model 1.4-1.6 transcribe the long form # "Short Name of Measurement, Test or Examination" (46 characters). sdtm_label_overrides <- data.frame( - source = c("SDTM_MODEL", "SDTM_MODEL", "SDTM_MODEL", "SDTMIG"), - version = c("1.4", "1.5", "1.6", "3.2"), - variable = c("--TESTCD", "--TESTCD", "--TESTCD", "PPSTRESC"), + source = c("SDTM_MODEL", "SDTM_MODEL", "SDTM_MODEL", "SDTMIG", "SDTMIG"), + version = c("1.4", "1.5", "1.6", "3.2", "3.3"), + variable = c("--TESTCD", "--TESTCD", "--TESTCD", "PPSTRESC", "PPSTRESC"), label = c(rep("Short Name of Measurement, Test or Exam", 3), - "Character Result/Finding in Std Format"), + rep("Character Result/Finding in Std Format", 2)), evidence = c(rep("SDTMIG v3.3 6.3.10.1 generic table; 4.2.1 label limit", 3), - "SDTMIG v3.3 6.3.11.2 PP specification table"), + rep("SDTMIG v3.3 6.3.11.2 PP specification table", 2)), stringsAsFactors = FALSE ) ig_sdtm <- apply_label_overrides(ig_sdtm, sdtm_label_overrides, diff --git a/data-raw/ig_source/README.md b/data-raw/ig_source/README.md index 1449060..91417a6 100644 --- a/data-raw/ig_source/README.md +++ b/data-raw/ig_source/README.md @@ -22,16 +22,33 @@ to describe this sourcing. | Directory | Standard | Version(s) | Content | |---|---|---|---| | `sdtm_model/1.4` .. `1.7` | SDTM Model | 1.4, 1.5, 1.6, 1.7 | `Findings_Observation_Class.csv`: the Findings general-observation-class variables (PP and ADPP are Findings-class datasets) | -| `sdtmig_3.2` | SDTMIG | 3.2 | `PP-specification.csv` (the PP domain); `Supplemental_Qualifiers-specification.csv` (the generic SUPP-- structure used for SUPPPP) | +| `sdtmig_3.2` | SDTMIG | 3.2, and 3.3 (reuses these) | `PP-specification.csv` (the PP domain); `PP-additions.csv` (three PP rows missing from the Rsdtm transcription); `Supplemental_Qualifiers-specification.csv` (the generic SUPP-- structure used for SUPPPP) | | `adamig_1.0`, `adamig_1.1`, `adamig_1.2` | ADaMIG | 1.0, 1.1, 1.2 | ADSL (subject-level) and BDS (Basic Data Structure, used by ADPP) variable tables, each split by Rsdtm into several category files (`ADSL_*` = ADSL, everything else = BDS) | -**SDTMIG coverage is limited to version 3.2.** Rsdtm's `SDTMIG_3.3` copy -covers only CO, DM, SE, SM, and SV — not PP or Supplemental Qualifiers — so -no newer SDTMIG version's PP/SUPP-- tables could be sourced this way. A -newer version can be added later by copying the equivalent -`PP-specification.csv` / `Supplemental_Qualifiers-specification.csv` into a -new `sdtmig_/` directory here and extending the version list in -`data-raw/build_ig_sdtm.R`. +**SDTMIG coverage is limited to versions 3.2 and 3.3.** Rsdtm's +`SDTMIG_3.3` copy covers only CO, DM, SE, SM, and SV, not PP or Supplemental +Qualifiers, so the PP/SUPP-- tables come from its 3.2 transcription, and +`ig_sdtm` carries them for 3.3 as well because the published SDTMIG v3.3 +(CDISC wiki PDF, https://wiki.cdisc.org/download/attachments/66274516/sdtmig_v3.3.pdf) +shows they did not change: its section 6.3.11.2 PP specification is stamped +"Version 3.2" and the revision history lists no PP change, and its section +8.4.1 SUPP-- specification has the same ten variables, labels, and types. + +That PDF is a browser print of the web page and is cropped on the right, so it +shows each variable's name, label, type, codelist, and role but not Core or +the CDISC Notes. It also shows `TAETORD`, `EPOCH`, and `PPDY` in the PP table, +which the Rsdtm 3.2 transcription (21 of the 24 rows) lacks; +`sdtmig_3.2/PP-additions.csv` adds them in their published positions, with +Core "Permissible" taken from the Certara PKSubmit SDTM_3.2 appendix +(https://onlinehelp.certara.com/pksubmit/2.1/PKSubmit/Appendix/SDTM_3.2.htm) +because the PDF does not show it. Existing rows keep their Core from the +Rsdtm transcription. + +A newer SDTMIG's PP/SUPP-- tables can be added by copying the equivalent CSVs +into a new `sdtmig_/` directory and adding the version to +`sdtmig_sources` in `data-raw/build_ig_sdtm.R`. SDTMIG 3.4 is not yet +included: its PDF is not publicly hosted by CDISC (the cdisc.org copy is +members-only). ## Encoding diff --git a/data-raw/ig_source/sdtmig_3.2/PP-additions.csv b/data-raw/ig_source/sdtmig_3.2/PP-additions.csv new file mode 100644 index 0000000..d2e9c0d --- /dev/null +++ b/data-raw/ig_source/sdtmig_3.2/PP-additions.csv @@ -0,0 +1,4 @@ +variable,after,label,type,codelist,role,core,evidence +TAETORD,PPSPEC,Planned Order of Element within Arm,Num,,Timing,Perm,"SDTMIG v3.3 PDF section 6.3.11.2 PP specification table (printed p.546/796); Core per Certara PKSubmit SDTM_3.2 appendix" +EPOCH,TAETORD,Epoch,Char,(EPOCH),Timing,Perm,"SDTMIG v3.3 PDF section 6.3.11.2 PP specification table (printed p.546/796), codelist EPOCH C99079; Core per Certara PKSubmit SDTM_3.2 appendix" +PPDY,PPDTC,Study Day of Parameter Calculations,Num,,Timing,Perm,"SDTMIG v3.3 PDF section 6.3.11.2 PP specification table (printed p.546/796); Core per Certara PKSubmit SDTM_3.2 appendix" diff --git a/data/datasets_catalogue.rda b/data/datasets_catalogue.rda index d7bf28c2915cf6ba624d00d880f1b1688593eb3a..119b9e47159f9a39dbc7c7ad220efc5dc863227d 100644 GIT binary patch delta 240 zcmV>qyq9Is=&Y5V2OAW^rl+uY}1r6VG<>cT7pKDX%o}~1zYnHSxzylrGZyG z%Tz-6^-oHN1OPjjXbmjEsoTw}>&?NDIe>!@*(W-6jez6`#}-cW_&&R+abb@-W*Uf$ z4ALPFkszr0be|lBHG_p;nri>v`Y&!zWj#`A_q%-XM1Q&+< q!U^B3y4kq@0002b>>qpp0rvx~2><~5eX=}0Fb#_W000000a;o%ux!Nu delta 236 zcmVR*|8lT0e^FO`X{%BL_hbE`hK*UhxWV$mo>A3tXRQGTPQFJ zF5sXIKd(qu{%l05r+O3rM&2Ff)PX}*k!>+OyY9KpooP@n<52jaRp+!V@ytAEoO`iB zXpmv!Hy}vJa`cI}^+0wp(|Rn8^aVJ~s~=RHnR^bTkm{0sI!Uj-k^K(N*IhcB+B$-> zW)W8cB3v0ruAupBw8Coo`GaDWDiGYP52Ct1mf->=AwFS-c>$>LtQYS6D&ki7T;18I mXb}Ja0001%%ktv@0r3N<2><}pZZ+LLFb#_W000000a;qfUu|yy diff --git a/data/ig_sdtm.rda b/data/ig_sdtm.rda index 9c2612d157a31d61357b5abb38a4a9e7ed3be292..5c298eb03c462c24aa6744a7c546dd2cd49312fd 100644 GIT binary patch delta 8062 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 Mivj=u00045S{Fj4Y5)KL delta 7925 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 diff --git a/man/get_ig.Rd b/man/get_ig.Rd index 22da92b..23acca7 100644 --- a/man/get_ig.Rd +++ b/man/get_ig.Rd @@ -4,7 +4,7 @@ \alias{get_ig} \title{Retrieve CDISC implementation-guide variable metadata} \usage{ -get_ig(standard = c("sdtm", "adam"), version = NULL) +get_ig(standard = c("sdtm", "adam"), version = NULL, domain = NULL) } \arguments{ \item{standard}{One of \code{"sdtm"} or \code{"adam"}.} @@ -13,10 +13,16 @@ get_ig(standard = c("sdtm", "adam"), version = NULL) (e.g. \code{"3.2"} for SDTMIG, \code{"1.7"} for the SDTM Model, \code{"1.2"} for ADaMIG). \code{NULL} (the default) returns all versions.} + +\item{domain}{Restrict to one domain/dataset: for \code{"sdtm"}, the +\code{domain} column (\code{"PP"} or \code{"SUPPQUAL"}; SDTM Model +rows have no domain and are excluded); for \code{"adam"}, the +\code{dataset} column (\code{"ADSL"} or \code{"BDS"}). \code{NULL} +(the default) applies no domain filter.} } \value{ A data frame: \code{\link{ig_sdtm}} or \code{\link{ig_adam}}, - optionally filtered to one version. + optionally filtered to one version and/or domain. } \description{ Mirrors \code{\link{get_ct}}, but for implementation-guide (IG) variable @@ -32,18 +38,19 @@ and ADPP datasets specifically. } \details{ \strong{SDTMIG coverage.} The SDTMIG PP domain and the generic SUPP-- -structure are only available at version 3.2, because that is as far as -the Rsdtm source this package copies from goes (see -\code{data-raw/ig_source/README.md}); no newer SDTMIG's PP/SUPP-- tables -were available to source. As a result, PP variables CDISC added or -renamed after SDTMIG 3.2 are absent from \code{ig_sdtm} - notably -\code{PPANMETH}, \code{EPOCH}, and \code{PTAETORD} (added later), and the -\code{PPDTC} to \code{PPPDTC} rename (SDTMIG 3.2 still has \code{PPDTC}). -Sourcing a newer SDTMIG - via a CDISC Library API key or a newer public -transcription - would close this gap. +structure are available at versions 3.2 and 3.3. Version 3.3 reuses the +3.2 tables: the published SDTMIG v3.3 stamps its PP specification +"Version 3.2" (unchanged since 3.2) and its SUPP-- specification has the +same ten variables. Both versions include \code{TAETORD}, \code{EPOCH}, +and \code{PPDY}, which the Rsdtm transcription of 3.2 this package copies +from omitted. Neither includes \code{PPANMETH} or \code{PPTPTREF}, which +are reported to be SDTMIG 3.4 additions that have not yet been sourced from +the IG itself (see \code{data-raw/ig_source/README.md}). \code{PPDTC} (not +\code{PPPDTC}) is the published name of the date/time-of-calculation +variable in both versions. } \examples{ get_ig("sdtm") -get_ig("sdtm", version = "3.2") -get_ig("adam", version = "1.2") +get_ig("sdtm", version = "3.3", domain = "PP") +get_ig("adam", version = "1.2", domain = "BDS") } diff --git a/man/ig_sdtm.Rd b/man/ig_sdtm.Rd index 6505c98..14771e6 100644 --- a/man/ig_sdtm.Rd +++ b/man/ig_sdtm.Rd @@ -9,7 +9,7 @@ A data frame with columns: \describe{ \item{source}{\code{"SDTM_MODEL"} or \code{"SDTMIG"}.} \item{version}{SDTM Model version (\code{"1.4"}-\code{"1.7"}) for - \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"}) for + \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"} or \code{"3.3"}) for \code{source == "SDTMIG"} rows. The two are independent numbering systems; see \code{\link{get_ig}}.} \item{class}{General observation class, e.g. \code{"Findings"}. @@ -50,8 +50,9 @@ ig_sdtm Versioned SDTM Model and SDTMIG variable metadata: the Model's Findings general-observation-class variables (versions 1.4-1.7), the SDTMIG PP domain, and the SDTMIG generic SUPP-- qualifier structure (used for -SUPPPP; version 3.2 only - see \code{data-raw/ig_source/README.md} for -why no newer SDTMIG version's PP/SUPP-- tables were available to source). +SUPPPP; versions 3.2 and 3.3, which share the same tables - see +\code{\link{get_ig}} and \code{data-raw/ig_source/README.md} for why no +newer SDTMIG version's PP/SUPP-- tables are available yet). Use \code{\link{get_ig}} to retrieve it, and \code{\link{build_domain_spec}} to build a ready-to-use PP/SUPPPP/ADPP variable spec from it (joined to CT for codelist ids). diff --git a/tests/testthat/test-build_domain_spec.R b/tests/testthat/test-build_domain_spec.R index 1785704..048c343 100644 --- a/tests/testthat/test-build_domain_spec.R +++ b/tests/testthat/test-build_domain_spec.R @@ -20,6 +20,24 @@ test_that("build_domain_spec resolves PPTESTCD/PPTEST/PPSTAT codelist ids agains expect_equal(pp$length[pp$variable == "PPTESTCD"], 8L) }) +test_that("build_domain_spec PP defaults to the newest SDTMIG (3.3) and returns the 24 published variables in order", { + pp <- build_domain_spec("PP") + expect_equal(pp$variable, + c("STUDYID", "DOMAIN", "USUBJID", "PPSEQ", "PPGRPID", "PPTESTCD", + "PPTEST", "PPCAT", "PPSCAT", "PPORRES", "PPORRESU", "PPSTRESC", + "PPSTRESN", "PPSTRESU", "PPSTAT", "PPREASND", "PPSPEC", + "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPRFTDTC", "PPSTINT", + "PPENINT")) + expect_equal(pp$order, 1:24) + expect_equal(pp$codelist_id[pp$variable == "EPOCH"], "C99079") + expect_identical(pp, build_domain_spec("PP", ig_version = "3.3")) +}) + +test_that("build_domain_spec PP at 3.2 equals 3.3 (the tables are unchanged between them)", { + expect_identical(build_domain_spec("PP", ig_version = "3.2"), + build_domain_spec("PP", ig_version = "3.3")) +}) + test_that("build_domain_spec SUPPPP returns the 10 standard SUPP-- variables", { supp <- build_domain_spec("SUPPPP") expect_setequal( diff --git a/tests/testthat/test-data_integrity.R b/tests/testthat/test-data_integrity.R index 6b82f5f..32492a2 100644 --- a/tests/testthat/test-data_integrity.R +++ b/tests/testthat/test-data_integrity.R @@ -141,8 +141,9 @@ test_that("the specific IG labels that exceeded 40 characters are the abbreviate sdtm$version %in% c("1.4", "1.5", "1.6"), ] expect_equal(sort(testcd$version), c("1.4", "1.5", "1.6")) expect_equal(testcd$label, rep("Short Name of Measurement, Test or Exam", 3L)) - expect_equal(sdtm$label[sdtm$variable == "PPSTRESC" & sdtm$source == "SDTMIG"], - "Character Result/Finding in Std Format") + ppstresc <- sdtm[sdtm$variable == "PPSTRESC" & sdtm$source == "SDTMIG", ] + expect_equal(sort(ppstresc$version), c("3.2", "3.3")) + expect_equal(ppstresc$label, rep("Character Result/Finding in Std Format", 2L)) adam <- get_ig("adam") expect_equal(adam$label[adam$variable == "PBCHGCyN"], diff --git a/tests/testthat/test-get_ig.R b/tests/testthat/test-get_ig.R index 0f0b67b..f5a2c6f 100644 --- a/tests/testthat/test-get_ig.R +++ b/tests/testthat/test-get_ig.R @@ -11,7 +11,7 @@ test_that("get_ig(version = NULL) returns every source/version", { sdtm <- get_ig("sdtm") expect_setequal(unique(sdtm$source), c("SDTM_MODEL", "SDTMIG")) expect_setequal(sdtm$version[sdtm$source == "SDTM_MODEL"], c("1.4", "1.5", "1.6", "1.7")) - expect_setequal(sdtm$version[sdtm$source == "SDTMIG"], "3.2") + expect_setequal(sdtm$version[sdtm$source == "SDTMIG"], c("3.2", "3.3")) adam <- get_ig("adam") expect_setequal(unique(adam$version), c("1.0", "1.1", "1.2")) @@ -76,3 +76,87 @@ test_that("SUPPQUAL structure has the 10 standard SUPP-- variables", { "QLABEL", "QVAL", "QORIG", "QEVAL") ) }) + +# Published PP table (SDTMIG v3.3 section 6.3.11.2), in published order. The +# 3.3 guide stamps the table "Version 3.2", so 3.2 and 3.3 carry the same rows. +pp_variables_published <- c( + "STUDYID", "DOMAIN", "USUBJID", "PPSEQ", "PPGRPID", "PPTESTCD", "PPTEST", + "PPCAT", "PPSCAT", "PPORRES", "PPORRESU", "PPSTRESC", "PPSTRESN", + "PPSTRESU", "PPSTAT", "PPREASND", "PPSPEC", "TAETORD", "EPOCH", "PPDTC", + "PPDY", "PPRFTDTC", "PPSTINT", "PPENINT" +) + +test_that("get_ig(domain = 'PP') returns the 24 published PP variables in order at 3.2 and 3.3", { + for (v in c("3.2", "3.3")) { + pp <- get_ig("sdtm", version = v, domain = "PP") + expect_equal(pp$variable, pp_variables_published, label = paste("PP variables at", v)) + expect_equal(pp$order, seq_len(24L)) + expect_true(all(pp$source == "SDTMIG" & pp$domain == "PP" & pp$version == v)) + } +}) + +test_that("PP rows added from the SDTMIG v3.3 table have the published label, type, codelist, role and core", { + pp <- get_ig("sdtm", version = "3.3", domain = "PP") + row <- function(v) pp[pp$variable == v, ] + expect_equal(row("TAETORD")$label, "Planned Order of Element within Arm") + expect_equal(row("TAETORD")$type, "Num") + expect_equal(row("TAETORD")$role, "Timing") + expect_equal(row("TAETORD")$core, "Perm") + expect_equal(row("EPOCH")$label, "Epoch") + expect_equal(row("EPOCH")$type, "Char") + expect_equal(row("EPOCH")$codelist, "EPOCH") + expect_equal(row("PPDY")$label, "Study Day of Parameter Calculations") + expect_equal(row("PPDY")$type, "Num") + expect_equal(row("PPDTC")$label, "Date/Time of Parameter Calculations") +}) + +test_that("PP does not carry the aNCA-style names PPPDTC, PPPDY, or PTAETORD, nor 3.4-only PPANMETH/PPTPTREF", { + pp <- get_ig("sdtm", domain = "PP") + expect_equal(intersect(c("PPPDTC", "PPPDY", "PTAETORD", "PPANMETH", "PPTPTREF"), pp$variable), + character(0L)) +}) + +test_that("SDTMIG 3.2 and 3.3 PP and SUPPQUAL tables are identical apart from the version", { + for (d in c("PP", "SUPPQUAL")) { + a <- get_ig("sdtm", version = "3.2", domain = d) + b <- get_ig("sdtm", version = "3.3", domain = d) + rownames(a) <- rownames(b) <- NULL + a$version <- b$version <- NULL + expect_identical(a, b, label = paste(d, "3.2 vs 3.3")) + } +}) + +test_that("SUPPQUAL at 3.3 has the 10 published SUPP-- variables in order", { + supp <- get_ig("sdtm", version = "3.3", domain = "SUPPQUAL") + expect_equal(supp$variable, + c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", + "QLABEL", "QVAL", "QORIG", "QEVAL")) +}) + +test_that("get_ig(domain =) filters ADaM by dataset and works without a version", { + bds <- get_ig("adam", domain = "BDS") + expect_equal(unique(bds$dataset), "BDS") + expect_equal(sort(unique(bds$version)), c("1.0", "1.1", "1.2")) + adsl <- get_ig("adam", version = "1.2", domain = "ADSL") + expect_equal(unique(adsl$dataset), "ADSL") + expect_equal(unique(adsl$version), "1.2") +}) + +test_that("get_ig aborts (classed) on an unknown domain, listing what is available", { + e <- expect_error(get_ig("sdtm", domain = "ZZ"), + class = "cdiscdata_error_ig_domain_unavailable") + expect_equal(conditionMessage(e), + "Domain 'ZZ' is not available for standard 'sdtm'. Available: PP, SUPPQUAL.") + e_v <- expect_error(get_ig("adam", version = "1.0", domain = "ZZ"), + class = "cdiscdata_error_ig_domain_unavailable") + expect_equal(conditionMessage(e_v), + "Domain 'ZZ' is not available for standard 'adam' at version '1.0'. Available: ADSL, BDS.") +}) + +test_that("get_ig reports 'none' when the version has no domain-bearing rows", { + # SDTM Model rows have no domain, so a model version has no domains to list. + e <- expect_error(get_ig("sdtm", version = "1.7", domain = "PP"), + class = "cdiscdata_error_ig_domain_unavailable") + expect_equal(conditionMessage(e), + "Domain 'PP' is not available for standard 'sdtm' at version '1.7'. Available: none.") +}) From 782a580ccafba52744b472b487b43fd6e6a171cf Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 21:12:47 -0400 Subject: [PATCH 04/10] feat(build_domain_spec): optional sdtm_domain = "PP" union into ADPP An ADPP built from PP carries PP's variables, which neither the ADaMIG BDS nor ADSL tables define. build_domain_spec("ADPP", sdtm_domain = "PP") now unions the SDTMIG PP domain's variables into the spec the same way adsl = TRUE unions ADSL's: marked source = "SDTMIG", core forced to "Perm", a variable BDS or ADSL already defines (STUDYID, USUBJID) keeping that version, ordered after the existing rows. 22 variables are added. Their codelist ids resolve against the SDTM CT because the ADaM CT has none of PP's codelists (PPTESTCD C85839, PPTEST C85493, PPORRESU/PPSTRESU C85494, PPSTAT C66789, PPSPEC C78734, EPOCH C99079). sdtmig_version picks the SDTMIG version, default newest. The default is NULL, which leaves the output identical (tested with expect_identical). A value other than "PP" is a classed cdiscdata_error_sdtm_domain_unavailable; sdtm_domain or sdtmig_version passed where they have no effect is a classed cdiscdata_warning_sdtm_domain_ignored. build_domain_spec() is split into small helpers (.spec_adpp, .sdtmig_domain_rows, .append_unique), reusing the existing ADSL-union logic rather than duplicating it, to stay under the lintr complexity limit. Also corrects the NEWS whitespace bullet from the label-fix commit: the default ADPP variable set is unchanged by the whitespace fix, and the visible effect was seven padded ADSL names in the ADaMIG 1.1 output. Co-Authored-By: Claude Sonnet 5.5 --- NEWS.md | 26 +++- R/build_domain_spec.R | 185 ++++++++++++++++-------- man/build_domain_spec.Rd | 38 +++-- tests/testthat/test-build_domain_spec.R | 109 ++++++++++++++ 4 files changed, 283 insertions(+), 75 deletions(-) diff --git a/NEWS.md b/NEWS.md index 63164dd..372da74 100644 --- a/NEWS.md +++ b/NEWS.md @@ -10,9 +10,12 @@ identifying field (`variable`, `label`, `type`, `core`, `codelist`, `role`). - 112 `ig_sdtm` and 7 `ig_adam` variable names had trailing spaces (so - `"--TESTCD "` never equalled `"--TESTCD"`, and the ADSL/BDS - de-duplication in `build_domain_spec()` silently missed e.g. `"FASFL "`); - `type` values such as `"Char "` were padded the same way. + `"--TESTCD "` never equalled `"--TESTCD"`, and + `build_domain_spec("ADPP", ig_version = "1.1")` returned seven ADSL + names padded this way: `FASFL`, `SAFFL`, `ITTFL`, `PPROTFL`, `COMPLFL`, + `RANDFL`, `ENRLFL`); `type` values such as `"Char "` were padded the + same way. The default `build_domain_spec("ADPP")` variable set is + unchanged. - Four labels over 40 characters now use the abbreviated form: SDTM Model 1.4-1.6 `--TESTCD` ("Short Name of Measurement, Test or Exam", as in SDTMIG 3.3 section 6.3.10.1), SDTMIG 3.2 `PPSTRESC` ("Character @@ -55,6 +58,23 @@ `PTAETORD`, `PPPDTC`, and `PPPDY` (seeded from aNCA) are not published SDTMIG names. +## `build_domain_spec(sdtm_domain =)` + +* `build_domain_spec("ADPP", sdtm_domain = "PP")` also unions the SDTMIG PP + domain's variables into the ADPP spec, the same way `adsl = TRUE` unions + ADSL's, because a real ADPP carries PP's variables (`PPTESTCD`, `PPTEST`, + ...). They are marked `source = "SDTMIG"` with `core = "Perm"`, a variable + BDS or ADSL already defines (`STUDYID`, `USUBJID`) keeps that version, they + are ordered after the existing rows, and their codelist ids resolve against + the SDTM CT (the ADaM CT has none of PP's codelists): `PPTESTCD` C85839, + `PPTEST` C85493, `PPORRESU`/`PPSTRESU` C85494, `PPSTAT` C66789, `PPSPEC` + C78734, `EPOCH` C99079. 22 variables are added. `sdtmig_version` picks the + SDTMIG version (default: newest). The default is `NULL`, which leaves the + output unchanged. A value other than `"PP"` is a classed + `cdiscdata_error_sdtm_domain_unavailable`; passing `sdtm_domain` or + `sdtmig_version` where it has no effect is a classed + `cdiscdata_warning_sdtm_domain_ignored`. + # cdiscdata 0.2.0 ## Classed conditions and coverage diff --git a/R/build_domain_spec.R b/R/build_domain_spec.R index 13889a9..0bc7e1a 100644 --- a/R/build_domain_spec.R +++ b/R/build_domain_spec.R @@ -8,14 +8,16 @@ #' draws on the ADaMIG BDS (Basic Data Structure) table, since ADPP is a BDS #' dataset and CDISC has no ADPP-specific table either, optionally unioned #' with the ADaMIG ADSL table (see \code{adsl} below), since a real ADPP -#' also carries ADSL's subject-level variables. +#' also carries ADSL's subject-level variables, and optionally with the SDTM +#' PP domain's variables (see \code{sdtm_domain} below). #' -#' This does not add PP-inherited traceability variables (\code{PPTESTCD}, -#' \code{PPTEST}, and the rest of PP's variables that a BDS dataset built -#' from PP typically carries forward). Neither the ADaMIG BDS nor ADSL -#' tables define those; which of PP's variables to carry into ADPP, and -#' under what names, is a downstream derivation choice (e.g. admiral's own -#' conventions), not IG metadata this function can source. +#' Neither the ADaMIG BDS nor ADSL tables define the PP-inherited +#' traceability variables (\code{PPTESTCD}, \code{PPTEST}, and the rest of +#' PP's variables that a BDS dataset built from PP typically carries +#' forward); which of PP's variables to carry into ADPP, and under what +#' names, is a downstream derivation choice (e.g. admiral's own +#' conventions), so they are only added when asked for with +#' \code{sdtm_domain}, and the default leaves them out. #' #' @param domain One of \code{"PP"}, \code{"SUPPPP"}, or \code{"ADPP"}. #' @param ig_version IG version to use: an SDTMIG version (for \code{PP}/ @@ -28,10 +30,21 @@ #' carries ADSL's subject-level variables (treatment, demographics, ...) #' alongside its own BDS variables. \code{FALSE} returns the BDS variables #' alone. Ignored (with a warning) for \code{domain != "ADPP"}. +#' @param sdtm_domain For \code{domain = "ADPP"} only: \code{NULL} (the +#' default) adds nothing; \code{"PP"} also unions in the SDTMIG PP +#' domain's variables, the same way \code{adsl = TRUE} unions ADSL's: +#' marked \code{source = "SDTMIG"}, \code{core} forced to \code{"Perm"}, +#' a variable already defined by BDS or ADSL (e.g. \code{STUDYID}, +#' \code{USUBJID}) keeping that version, and codelist ids resolved against +#' the ADaM CT first and the SDTM CT second. Ignored (with a warning) for +#' \code{domain != "ADPP"}; any value other than \code{"PP"} is an error. +#' @param sdtmig_version SDTMIG version to take the \code{sdtm_domain} +#' variables from. \code{NULL} uses the newest available. Ignored (with a +#' warning) unless \code{domain = "ADPP"} and \code{sdtm_domain} is set. #' @return A data frame with columns \code{variable}, \code{label}, #' \code{type}, \code{length}, \code{core}, \code{order}, \code{source} -#' (\code{"SDTMIG"} for \code{PP}/\code{SUPPPP}; \code{"BDS"} or -#' \code{"ADSL"} for \code{ADPP}), and \code{codelist_id} (the codelist's +#' (\code{"SDTMIG"} for \code{PP}/\code{SUPPPP}; \code{"BDS"}, +#' \code{"ADSL"}, or \code{"SDTMIG"} for \code{ADPP}), and \code{codelist_id} (the codelist's #' CT C-code, e.g. \code{"C85839"} for PPTESTCD's PKPARMCD codelist; #' \code{NA} when the variable has no codelist or the referenced codelist #' name is not found in the CT version used). ADSL-sourced \code{ADPP} rows @@ -45,69 +58,38 @@ #' build_domain_spec("SUPPPP") #' build_domain_spec("ADPP") # BDS + ADSL (default) #' build_domain_spec("ADPP", adsl = FALSE) # BDS only +#' build_domain_spec("ADPP", sdtm_domain = "PP") # BDS + ADSL + PP variables build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), ig_version = NULL, ct_version = NULL, - adsl = TRUE) { + adsl = TRUE, sdtm_domain = NULL, + sdtmig_version = NULL) { domain <- match.arg(domain) - if (domain != "ADPP" && !isTRUE(adsl)) { + if (domain == "ADPP") { + return(.spec_adpp(ig_version, ct_version, adsl, sdtm_domain, sdtmig_version)) + } + + if (!isTRUE(adsl)) { .cdiscdata_warn( "`adsl` is ignored for domain != \"ADPP\".", "adsl_ignored" ) } - - if (domain %in% c("PP", "SUPPPP")) { - ig_domain <- if (domain == "PP") "PP" else "SUPPQUAL" - sdtmig_all <- get_ig("sdtm") - sdtmig_all <- sdtmig_all[sdtmig_all$source == "SDTMIG", ] - version <- .resolve_ig_version(ig_version, sdtmig_all$version, "SDTMIG") - sub <- sdtmig_all[sdtmig_all$domain == ig_domain & sdtmig_all$version == version, ] - if (nrow(sub) == 0L) { - .cdiscdata_abort( - paste0("No SDTMIG '", ig_domain, "' variables found for version '", version, "'."), - "no_ig_variables" - ) - } - ct <- get_ct("sdtm", version = ct_version) - sub$source <- "SDTMIG" - codelist_id <- .lookup_codelist_id(sub$codelist, ct) - } else { - adamig_all <- get_ig("adam") - version <- .resolve_ig_version(ig_version, adamig_all$version, "ADaMIG") - bds <- adamig_all[adamig_all$dataset == "BDS" & adamig_all$version == version, ] - if (nrow(bds) == 0L) { - .cdiscdata_abort( - paste0("No ADaMIG BDS variables found for version '", version, "'."), - "no_ig_variables" - ) - } - bds$source <- "BDS" - ct_adam <- get_ct("adam", version = ct_version) - - if (isTRUE(adsl)) { - adsl_tbl <- adamig_all[adamig_all$dataset == "ADSL" & adamig_all$version == version, ] - # ADSL and BDS both define several shared base variables (STUDYID, - # USUBJID, ...); a real ADPP carries each once, so ADSL contributes - # only the variables BDS does not already define, keeping BDS's - # version (and its own Core) for anything in both. - adsl_tbl <- adsl_tbl[!adsl_tbl$variable %in% bds$variable, ] - adsl_tbl$source <- "ADSL" - adsl_tbl$core <- "Perm" - adsl_tbl$order <- max(bds$order) + seq_len(nrow(adsl_tbl)) - sub <- rbind(bds, adsl_tbl) - # ADSL variables carried from SDTM DM (SEX, RACE, AGEU, ...) reuse - # SDTM's codelists, not ADaM's much smaller CT; ADaM CT is checked - # first (matching the BDS-only behaviour), SDTM CT second. - ct_sdtm <- get_ct("sdtm", version = ct_version) - codelist_id <- .lookup_codelist_id(sub$codelist, ct_adam) - fallback <- is.na(codelist_id) & !is.na(sub$codelist) - codelist_id[fallback] <- .lookup_codelist_id(sub$codelist[fallback], ct_sdtm) - } else { - sub <- bds - codelist_id <- .lookup_codelist_id(sub$codelist, ct_adam) - } + if (!is.null(sdtm_domain) || !is.null(sdtmig_version)) { + .cdiscdata_warn( + "`sdtm_domain` and `sdtmig_version` are ignored for domain != \"ADPP\".", + "sdtm_domain_ignored" + ) } + rows <- .sdtmig_domain_rows(if (domain == "PP") "PP" else "SUPPQUAL", ig_version) + ct <- get_ct("sdtm", version = ct_version) + .spec_frame(rows, .lookup_codelist_id(rows$codelist, ct)) +} + +# The columns of a variable spec, from any IG table's rows. +.spec_columns <- c("variable", "label", "type", "length", "core", "order", + "source", "codelist") +.spec_frame <- function(sub, codelist_id) { data.frame( variable = sub$variable, label = sub$label, @@ -121,6 +103,85 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), ) } +# SDTMIG variables for one domain ("PP" or "SUPPQUAL") at `ig_version` +# (NULL = newest SDTMIG), marked source = "SDTMIG". +.sdtmig_domain_rows <- function(ig_domain, ig_version) { + sdtmig_all <- get_ig("sdtm") + sdtmig_all <- sdtmig_all[sdtmig_all$source == "SDTMIG", ] + version <- .resolve_ig_version(ig_version, sdtmig_all$version, "SDTMIG") + rows <- sdtmig_all[sdtmig_all$domain == ig_domain & sdtmig_all$version == version, ] + if (nrow(rows) == 0L) { + .cdiscdata_abort( + paste0("No SDTMIG '", ig_domain, "' variables found for version '", version, "'."), + "no_ig_variables" + ) + } + rows$source <- "SDTMIG" + rows +} + +# Append `extra`'s variables to `base` that `base` does not already define, +# marked with `source`, core forced to "Perm" (from ADPP's perspective, +# merging a variable in from ADSL or SDTM is always optional, whatever Core +# that table gives it for itself), and ordered after everything in `base`. +# A variable both define keeps `base`'s version, as a real ADPP carries it once. +.append_unique <- function(base, extra, source) { + extra <- extra[!extra$variable %in% base$variable, ] + extra$source <- source + extra$core <- "Perm" + extra$order <- max(base$order) + seq_len(nrow(extra)) + rbind(base[, .spec_columns], extra[, .spec_columns]) +} + +.spec_adpp <- function(ig_version, ct_version, adsl, sdtm_domain, sdtmig_version) { + if (!is.null(sdtm_domain) && !identical(sdtm_domain, "PP")) { + .cdiscdata_abort( + paste0( + "`sdtm_domain` must be NULL or \"PP\" (the SDTMIG domain an ADPP is built from), not '", + paste(sdtm_domain, collapse = "', '"), "'." + ), + "sdtm_domain_unavailable" + ) + } + if (is.null(sdtm_domain) && !is.null(sdtmig_version)) { + .cdiscdata_warn("`sdtmig_version` is ignored when `sdtm_domain` is NULL.", + "sdtm_domain_ignored") + } + + adamig_all <- get_ig("adam") + version <- .resolve_ig_version(ig_version, adamig_all$version, "ADaMIG") + bds <- adamig_all[adamig_all$dataset == "BDS" & adamig_all$version == version, ] + if (nrow(bds) == 0L) { + .cdiscdata_abort( + paste0("No ADaMIG BDS variables found for version '", version, "'."), + "no_ig_variables" + ) + } + bds$source <- "BDS" + ct_adam <- get_ct("adam", version = ct_version) + + sub <- bds[, .spec_columns] + if (isTRUE(adsl)) { + adsl_tbl <- adamig_all[adamig_all$dataset == "ADSL" & adamig_all$version == version, ] + sub <- .append_unique(sub, adsl_tbl, "ADSL") + } + if (!is.null(sdtm_domain)) { + sub <- .append_unique(sub, .sdtmig_domain_rows(sdtm_domain, sdtmig_version), "SDTMIG") + } + + codelist_id <- .lookup_codelist_id(sub$codelist, ct_adam) + if (isTRUE(adsl) || !is.null(sdtm_domain)) { + # ADSL variables carried from SDTM DM (SEX, RACE, AGEU, ...) and PP's own + # codelists (PKPARMCD, PKUNIT, ...) are SDTM CT, not ADaM's much smaller + # CT; ADaM CT is checked first (matching the BDS-only behaviour), SDTM CT + # second. + ct_sdtm <- get_ct("sdtm", version = ct_version) + fallback <- is.na(codelist_id) & !is.na(sub$codelist) + codelist_id[fallback] <- .lookup_codelist_id(sub$codelist[fallback], ct_sdtm) + } + .spec_frame(sub, codelist_id) +} + # Resolve ig_version = NULL to the newest version present in `versions` # (numeric comparison via package_version, so "1.10" would correctly rank # above "1.9"); abort with the available list on an unknown explicit version. diff --git a/man/build_domain_spec.Rd b/man/build_domain_spec.Rd index 0dcc8ee..2d55235 100644 --- a/man/build_domain_spec.Rd +++ b/man/build_domain_spec.Rd @@ -8,7 +8,9 @@ build_domain_spec( domain = c("PP", "SUPPPP", "ADPP"), ig_version = NULL, ct_version = NULL, - adsl = TRUE + adsl = TRUE, + sdtm_domain = NULL, + sdtmig_version = NULL ) } \arguments{ @@ -26,12 +28,25 @@ ADaMIG ADSL variables (default \code{TRUE}), since a real ADPP dataset carries ADSL's subject-level variables (treatment, demographics, ...) alongside its own BDS variables. \code{FALSE} returns the BDS variables alone. Ignored (with a warning) for \code{domain != "ADPP"}.} + +\item{sdtm_domain}{For \code{domain = "ADPP"} only: \code{NULL} (the +default) adds nothing; \code{"PP"} also unions in the SDTMIG PP +domain's variables, the same way \code{adsl = TRUE} unions ADSL's: +marked \code{source = "SDTMIG"}, \code{core} forced to \code{"Perm"}, +a variable already defined by BDS or ADSL (e.g. \code{STUDYID}, +\code{USUBJID}) keeping that version, and codelist ids resolved against +the ADaM CT first and the SDTM CT second. Ignored (with a warning) for +\code{domain != "ADPP"}; any value other than \code{"PP"} is an error.} + +\item{sdtmig_version}{SDTMIG version to take the \code{sdtm_domain} +variables from. \code{NULL} uses the newest available. Ignored (with a +warning) unless \code{domain = "ADPP"} and \code{sdtm_domain} is set.} } \value{ A data frame with columns \code{variable}, \code{label}, \code{type}, \code{length}, \code{core}, \code{order}, \code{source} - (\code{"SDTMIG"} for \code{PP}/\code{SUPPPP}; \code{"BDS"} or - \code{"ADSL"} for \code{ADPP}), and \code{codelist_id} (the codelist's + (\code{"SDTMIG"} for \code{PP}/\code{SUPPPP}; \code{"BDS"}, + \code{"ADSL"}, or \code{"SDTMIG"} for \code{ADPP}), and \code{codelist_id} (the codelist's CT C-code, e.g. \code{"C85839"} for PPTESTCD's PKPARMCD codelist; \code{NA} when the variable has no codelist or the referenced codelist name is not found in the CT version used). ADSL-sourced \code{ADPP} rows @@ -49,19 +64,22 @@ structure, since CDISC has no domain-specific SUPPPP table); \code{ADPP} draws on the ADaMIG BDS (Basic Data Structure) table, since ADPP is a BDS dataset and CDISC has no ADPP-specific table either, optionally unioned with the ADaMIG ADSL table (see \code{adsl} below), since a real ADPP -also carries ADSL's subject-level variables. +also carries ADSL's subject-level variables, and optionally with the SDTM +PP domain's variables (see \code{sdtm_domain} below). } \details{ -This does not add PP-inherited traceability variables (\code{PPTESTCD}, -\code{PPTEST}, and the rest of PP's variables that a BDS dataset built -from PP typically carries forward). Neither the ADaMIG BDS nor ADSL -tables define those; which of PP's variables to carry into ADPP, and -under what names, is a downstream derivation choice (e.g. admiral's own -conventions), not IG metadata this function can source. +Neither the ADaMIG BDS nor ADSL tables define the PP-inherited +traceability variables (\code{PPTESTCD}, \code{PPTEST}, and the rest of +PP's variables that a BDS dataset built from PP typically carries +forward); which of PP's variables to carry into ADPP, and under what +names, is a downstream derivation choice (e.g. admiral's own +conventions), so they are only added when asked for with +\code{sdtm_domain}, and the default leaves them out. } \examples{ build_domain_spec("PP") build_domain_spec("SUPPPP") build_domain_spec("ADPP") # BDS + ADSL (default) build_domain_spec("ADPP", adsl = FALSE) # BDS only +build_domain_spec("ADPP", sdtm_domain = "PP") # BDS + ADSL + PP variables } diff --git a/tests/testthat/test-build_domain_spec.R b/tests/testthat/test-build_domain_spec.R index 048c343..7295466 100644 --- a/tests/testthat/test-build_domain_spec.R +++ b/tests/testthat/test-build_domain_spec.R @@ -154,3 +154,112 @@ test_that("build_domain_spec aborts (classed) when an ADaMIG version has no BDS ) expect_match(conditionMessage(e), "No ADaMIG BDS variables found", fixed = TRUE) }) + +# ---- sdtm_domain: union the SDTMIG PP variables into an ADPP spec ---------- + +# PP's 24 published variables less STUDYID and USUBJID, which BDS already +# defines (the BDS version is kept). +pp_added_to_adpp <- c( + "DOMAIN", "PPSEQ", "PPGRPID", "PPTESTCD", "PPTEST", "PPCAT", "PPSCAT", + "PPORRES", "PPORRESU", "PPSTRESC", "PPSTRESN", "PPSTRESU", "PPSTAT", + "PPREASND", "PPSPEC", "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPRFTDTC", + "PPSTINT", "PPENINT" +) + +test_that("build_domain_spec ADPP leaves the PP variables out by default, and sdtm_domain = NULL is the default", { + base <- build_domain_spec("ADPP") + expect_equal(sum(base$variable %in% pp_added_to_adpp[-1L]), 0L) + expect_identical(base, build_domain_spec("ADPP", sdtm_domain = NULL)) +}) + +test_that("build_domain_spec ADPP sdtm_domain = 'PP' appends exactly the 22 PP variables not already defined", { + base <- build_domain_spec("ADPP") + withpp <- build_domain_spec("ADPP", sdtm_domain = "PP") + added <- withpp[withpp$source == "SDTMIG", ] + + expect_equal(nrow(withpp), nrow(base) + 22L) + # the BDS + ADSL rows are untouched and come first + expect_identical(withpp[seq_len(nrow(base)), ], base) + expect_equal(added$variable, pp_added_to_adpp) + expect_true(all(added$core == "Perm")) + # ordered after everything already there, continuing the sequence + expect_equal(added$order, max(base$order) + seq_len(22L)) + # shared base variables keep their BDS version and appear once + expect_equal(withpp$source[withpp$variable == "STUDYID"], "BDS") + expect_equal(sum(withpp$variable %in% c("STUDYID", "USUBJID")), 2L) + expect_equal(sum(duplicated(withpp$variable)), 0L) +}) + +test_that("build_domain_spec ADPP sdtm_domain = 'PP' takes labels and types from the SDTMIG PP table", { + withpp <- build_domain_spec("ADPP", sdtm_domain = "PP") + row <- function(v) withpp[withpp$variable == v, ] + expect_equal(row("PPSTRESC")$label, "Character Result/Finding in Std Format") + expect_equal(row("PPSTRESC")$type, "Char") + expect_equal(row("PPSTRESN")$type, "Num") + expect_equal(row("PPTESTCD")$length, 8L) + expect_equal(row("EPOCH")$label, "Epoch") +}) + +test_that("build_domain_spec ADPP resolves the PP codelist ids against the SDTM CT (ADaM CT has none of them)", { + withpp <- build_domain_spec("ADPP", sdtm_domain = "PP") + expect_equal(withpp$codelist_id[withpp$variable == "PPTESTCD"], "C85839") + expect_equal(withpp$codelist_id[withpp$variable == "PPTEST"], "C85493") + expect_equal(withpp$codelist_id[withpp$variable == "PPORRESU"], "C85494") + expect_equal(withpp$codelist_id[withpp$variable == "PPSTAT"], "C66789") + expect_equal(withpp$codelist_id[withpp$variable == "PPSPEC"], "C78734") + expect_equal(withpp$codelist_id[withpp$variable == "EPOCH"], "C99079") +}) + +test_that("build_domain_spec ADPP sdtm_domain = 'PP' works with adsl = FALSE (BDS + PP only)", { + nb <- build_domain_spec("ADPP", adsl = FALSE, sdtm_domain = "PP") + bds <- build_domain_spec("ADPP", adsl = FALSE) + expect_equal(sort(unique(nb$source)), c("BDS", "SDTMIG")) + expect_identical(nb[seq_len(nrow(bds)), ], bds) + expect_equal(nb$variable[nb$source == "SDTMIG"], pp_added_to_adpp) + expect_equal(nb$codelist_id[nb$variable == "PPTESTCD"], "C85839") +}) + +test_that("build_domain_spec ADPP sdtmig_version picks the SDTMIG version (3.2 and 3.3 PP tables are identical)", { + expect_identical( + build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.2"), + build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.3") + ) + e <- expect_error( + build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "9.9"), + class = "cdiscdata_error_ig_version_unavailable" + ) + expect_match(conditionMessage(e), "Version '9.9' is not available for SDTMIG.", fixed = TRUE) +}) + +test_that("build_domain_spec ADPP aborts (classed) on an sdtm_domain other than PP", { + e <- expect_error( + build_domain_spec("ADPP", sdtm_domain = "LB"), + class = "cdiscdata_error_sdtm_domain_unavailable" + ) + expect_equal( + conditionMessage(e), + "`sdtm_domain` must be NULL or \"PP\" (the SDTMIG domain an ADPP is built from), not 'LB'." + ) + e2 <- expect_error( + build_domain_spec("ADPP", sdtm_domain = c("PP", "LB")), + class = "cdiscdata_error_sdtm_domain_unavailable" + ) + expect_match(conditionMessage(e2), "not 'PP', 'LB'.", fixed = TRUE) +}) + +test_that("build_domain_spec warns (classed) when sdtm_domain or sdtmig_version is passed where it has no effect", { + w1 <- expect_warning( + build_domain_spec("PP", sdtm_domain = "PP"), + class = "cdiscdata_warning_sdtm_domain_ignored" + ) + expect_equal(conditionMessage(w1), + "`sdtm_domain` and `sdtmig_version` are ignored for domain != \"ADPP\".") + expect_warning(build_domain_spec("SUPPPP", sdtmig_version = "3.3"), + class = "cdiscdata_warning_sdtm_domain_ignored") + + w2 <- expect_warning( + build_domain_spec("ADPP", sdtmig_version = "3.3"), + class = "cdiscdata_warning_sdtm_domain_ignored" + ) + expect_equal(conditionMessage(w2), "`sdtmig_version` is ignored when `sdtm_domain` is NULL.") +}) From 379226b6b5246ff4c30236ed800284ca8d3a5e9f Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 21:18:22 -0400 Subject: [PATCH 05/10] fix(ig): keep ADaMIG PBCHGCyN as published; document it as the gate exception Replaces the derived "Percent Chg to Baseline Category y (N)" override with the label the guide publishes, "Percent Change to Baseline Category y (N)" (41 characters; ADaMIG v1.2 draft, CDISC wiki, section 3.3.4.1, Table 3.3.4.1.1). Decision (Bill): shortening a label to fit an XPT file is the dataset writer's job, not cdiscdata's. The 40-character gate in test-data_integrity.R now has an explicit exact-match allow-list naming the table, dataset, version, variable, label and reason, so any other over-length label, or this one changing, still fails. A second test pins that exactly one ig_adam label and no ig_sdtm label is over 40 characters, so the exception cannot go stale unnoticed. Co-Authored-By: Claude Sonnet 5.5 --- NEWS.md | 21 ++++++++------ data-raw/build_ig_adam.R | 27 ++++++------------ data-raw/ig_source/README.md | 10 ++++--- data/ig_adam.rda | Bin 24904 -> 24900 bytes tests/testthat/test-data_integrity.R | 41 +++++++++++++++++++++++---- 5 files changed, 64 insertions(+), 35 deletions(-) diff --git a/NEWS.md b/NEWS.md index 372da74..fd5d699 100644 --- a/NEWS.md +++ b/NEWS.md @@ -16,20 +16,25 @@ `RANDFL`, `ENRLFL`); `type` values such as `"Char "` were padded the same way. The default `build_domain_spec("ADPP")` variable set is unchanged. - - Four labels over 40 characters now use the abbreviated form: SDTM Model - 1.4-1.6 `--TESTCD` ("Short Name of Measurement, Test or Exam", as in - SDTMIG 3.3 section 6.3.10.1), SDTMIG 3.2 `PPSTRESC` ("Character - Result/Finding in Std Format", as in SDTMIG 3.3 section 6.3.11.2), and - ADaMIG 1.2 `PBCHGCyN` ("Percent Chg to Baseline Category y (N)"; the - IG publishes 41 characters here, so this follows its sibling - `PCHGCAyN`'s "Chg" abbreviation and is a derived label). + - Labels over 40 characters now use the abbreviated form the guide + publishes: SDTM Model 1.4-1.6 `--TESTCD` ("Short Name of Measurement, + Test or Exam", as in SDTMIG 3.3 section 6.3.10.1) and `PPSTRESC` in + SDTMIG 3.2 and 3.3 ("Character Result/Finding in Std Format", as in + SDTMIG 3.3 section 6.3.11.2). + - ADaMIG 1.2 `PBCHGCyN` is kept as the guide publishes it, "Percent Change + to Baseline Category y (N)", which is 41 characters (ADaMIG v1.2 draft, + section 3.3.4.1, Table 3.3.4.1.1; the sibling `PCHGCAyN` is published + abbreviated). It is the one documented exception in the 40-character + gate, an exact-match allow-list in `test-data_integrity.R`, so any other + over-length label still fails. Shortening a label to fit an XPT file is + for whoever writes the dataset, not for this package. - Five section sub-headings in the ADaMIG 1.0 combined ADSL table ("Study Identifiers", "Subject Demographics", ...) were transcribed as variables with no label; they are dropped (`ig_adam` is 851 rows, was 856). - New gates in `tests/testthat/test-data_integrity.R`: no label in `ig_sdtm`/`ig_adam` is `NA`, contains a newline, or exceeds 40 - characters; no variable name is `NA`, blank, or contains whitespace; no + characters (bar the exception above); no variable name is `NA`, blank, or contains whitespace; no `type`/`core`/`codelist`/`role` value has stray whitespace. ## SDTMIG 3.3 PP/SUPP-- and `get_ig(domain =)` diff --git a/data-raw/build_ig_adam.R b/data-raw/build_ig_adam.R index d43cbe2..844e25d 100644 --- a/data-raw/build_ig_adam.R +++ b/data-raw/build_ig_adam.R @@ -57,25 +57,16 @@ ig_adam <- do.call(rbind, lapply(adamig_versions, build_adamig_version)) rownames(ig_adam) <- NULL # ── Labels over the 40-character XPT limit ───────────────────────────────── -# Checked against the published ADaMIG v1.2 (draft) on the CDISC wiki -# (https://wiki.cdisc.org/download/attachments/54282867/ADaMIG-ADaMIG-compiled-191217-0027-11448.pdf), +# One ADaMIG label is published longer than 40 characters and is kept as +# published: ADaMIG v1.2 (draft, CDISC wiki +# https://wiki.cdisc.org/download/attachments/54282867/ADaMIG-ADaMIG-compiled-191217-0027-11448.pdf), # section 3.3.4.1, Table 3.3.4.1.1 "Analysis Parameter Variables for BDS -# Datasets": PBCHGCyN is published as "Percent Change to Baseline Category y -# (N)" (41 characters), so the IG itself exceeds the limit there. Its sibling -# rows in the same table abbreviate "Change" to "Chg" for the same reason -# (PCHGCATy "Percent Chg from Baseline Category y", PCHGCAyN "Percent Chg from -# Baseline Category y (N)"); this applies the same abbreviation, which is a -# derived label, not one the IG publishes. -adam_label_overrides <- data.frame( - dataset = "BDS", - version = "1.2", - variable = "PBCHGCyN", - label = "Percent Chg to Baseline Category y (N)", - evidence = "ADaMIG v1.2 draft Table 3.3.4.1.1 (PBCHGCyN 41 chars; sibling PCHGCAyN abbreviates Chg)", - stringsAsFactors = FALSE -) -ig_adam <- apply_label_overrides(ig_adam, adam_label_overrides, - by = c("dataset", "version", "variable")) +# Datasets": PBCHGCyN is "Percent Change to Baseline Category y (N)" (41 +# characters). Shortening a label to fit a SAS v5 transport (XPT) limit is the +# job of whoever writes the dataset, not of this package, so it is not +# overridden here; it is a documented exception, with its reason, in the gate +# in tests/testthat/test-data_integrity.R, so any other over-length label +# still fails. stopifnot( all(c("dataset", "version", "category", "order", "variable", "label", "type", diff --git a/data-raw/ig_source/README.md b/data-raw/ig_source/README.md index 91417a6..2a48eb8 100644 --- a/data-raw/ig_source/README.md +++ b/data-raw/ig_source/README.md @@ -76,7 +76,9 @@ space becomes a variable name such as `"--TESTCD "`. `notes` is left as is. Labels in the IGs are limited to 40 characters (SDTMIG 3.3 section 4.2.1); the few that transcribe longer are set in `sdtm_label_overrides` -(`build_ig_sdtm.R`) and `adam_label_overrides` (`build_ig_adam.R`), each with -the IG table it was checked against. The ADaMIG 1.2 PBCHGCyN override is a -derived abbreviation, since the IG itself publishes 41 characters there. -`tests/testthat/test-data_integrity.R` gates all of this. +(`build_ig_sdtm.R`) to the shorter form the guide itself publishes, with the +IG table each was checked against. The one label the guides publish longer +than 40 characters, ADaMIG 1.2 PBCHGCyN ("Percent Change to Baseline Category +y (N)", 41 characters), is kept as published and is the documented exception +in the gate: shortening a label is the dataset writer's job, not this +package's. `tests/testthat/test-data_integrity.R` gates all of this. diff --git a/data/ig_adam.rda b/data/ig_adam.rda index 923183617922ec6ea6c69b90bc00ecf78bdbb964..a250e0c4f8ef2ee9be7f16f90d229d07069f9500 100644 GIT binary patch delta 20542 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ӝmwC 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 R=5{_X4T}N*00001Sz6o@){g)H delta 20546 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 diff --git a/tests/testthat/test-data_integrity.R b/tests/testthat/test-data_integrity.R index 32492a2..c02961a 100644 --- a/tests/testthat/test-data_integrity.R +++ b/tests/testthat/test-data_integrity.R @@ -101,18 +101,52 @@ ig_tables_for_gate <- function() { list(ig_sdtm = get_ig("sdtm"), ig_adam = get_ig("adam")) } -test_that("no IG label is NA, contains a newline, or exceeds 40 characters", { +# The one label the guides themselves publish longer than 40 characters, kept +# as published (decision: shortening a label for an XPT file is the dataset +# writer's job, not cdiscdata's). An exact match on table, version, variable +# and text, so any other over-length label, or this one changing, still fails. +ig_over_length_allowed <- data.frame( + table = "ig_adam", + dataset = "BDS", + version = "1.2", + variable = "PBCHGCyN", + label = "Percent Change to Baseline Category y (N)", + reason = paste("Published at 41 characters in ADaMIG v1.2 (draft, CDISC wiki),", + "section 3.3.4.1, Table 3.3.4.1.1 Analysis Parameter Variables", + "for BDS Datasets; the sibling PCHGCAyN is published abbreviated."), + stringsAsFactors = FALSE +) + +test_that("no IG label is NA, contains a newline, or exceeds 40 characters (bar the documented exception)", { for (nm in names(ig_tables_for_gate())) { tbl <- ig_tables_for_gate()[[nm]] expect_false(anyNA(tbl$label), label = paste(nm, "has an NA label")) expect_false(any(grepl("[\r\n]", tbl$label)), label = paste(nm, "has a label containing a newline")) too_long <- nchar(tbl$label) > 40L + if ("dataset" %in% names(tbl)) { + key <- paste(tbl$dataset, tbl$version, tbl$variable, tbl$label, sep = "\r") + allowed <- ig_over_length_allowed[ig_over_length_allowed$table == nm, ] + allowed_key <- paste(allowed$dataset, allowed$version, allowed$variable, + allowed$label, sep = "\r") + too_long <- too_long & !key %in% allowed_key + } expect_equal(tbl$variable[too_long], character(0L), label = paste(nm, "variables whose label exceeds 40 characters")) } }) +test_that("the over-length allow-list is exactly the published 41-character PBCHGCyN label and nothing stale", { + adam <- get_ig("adam") + row <- adam[adam$dataset == "BDS" & adam$version == "1.2" & adam$variable == "PBCHGCyN", ] + expect_equal(nrow(row), 1L) + expect_equal(row$label, ig_over_length_allowed$label) + expect_equal(nchar(row$label), 41L) + # every other ig_adam / ig_sdtm label is within the limit + expect_equal(sum(nchar(adam$label) > 40L), 1L) + expect_equal(sum(nchar(get_ig("sdtm")$label) > 40L), 0L) +}) + test_that("no IG variable name is NA, blank, or contains whitespace", { for (nm in names(ig_tables_for_gate())) { tbl <- ig_tables_for_gate()[[nm]] @@ -135,7 +169,7 @@ test_that("IG categorical fields carry no leading/trailing or doubled whitespace } }) -test_that("the specific IG labels that exceeded 40 characters are the abbreviated published forms", { +test_that("the SDTM IG labels that exceeded 40 characters are the abbreviated published forms", { sdtm <- get_ig("sdtm") testcd <- sdtm[sdtm$source == "SDTM_MODEL" & sdtm$variable == "--TESTCD" & sdtm$version %in% c("1.4", "1.5", "1.6"), ] @@ -145,9 +179,6 @@ test_that("the specific IG labels that exceeded 40 characters are the abbreviate expect_equal(sort(ppstresc$version), c("3.2", "3.3")) expect_equal(ppstresc$label, rep("Character Result/Finding in Std Format", 2L)) - adam <- get_ig("adam") - expect_equal(adam$label[adam$variable == "PBCHGCyN"], - "Percent Chg to Baseline Category y (N)") }) test_that("ADaMIG 1.0 ADSL section sub-headings are not transcribed as variables", { From 0d153bbbb590ea996496ee477f8d404b48a3041d Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 21:24:01 -0400 Subject: [PATCH 06/10] docs(news): keep level-2 headings free of version-like numbers R's NEWS.md parser (tools:::.build_news_db_from_package_NEWS_md) drops headings until the first one containing a version number, and the development header "(development version)" has none, so a level-2 heading "SDTMIG 3.3 ..." became the version level and R CMD check reported "Cannot extract version info from the following section titles". Renames that heading (and one ending in a parenthesis) so the parser reads the development section normally. Co-Authored-By: Claude Sonnet 5.5 --- NEWS.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/NEWS.md b/NEWS.md index fd5d699..fb81ac7 100644 --- a/NEWS.md +++ b/NEWS.md @@ -37,7 +37,7 @@ characters (bar the exception above); no variable name is `NA`, blank, or contains whitespace; no `type`/`core`/`codelist`/`role` value has stray whitespace. -## SDTMIG 3.3 PP/SUPP-- and `get_ig(domain =)` +## Newer SDTMIG PP and SUPP-- tables, and `get_ig` by domain * `ig_sdtm` now carries the SDTMIG PP domain and generic SUPP-- structure at version 3.3 as well as 3.2, and `get_ig()` gains a `domain` argument @@ -63,7 +63,7 @@ `PTAETORD`, `PPPDTC`, and `PPPDY` (seeded from aNCA) are not published SDTMIG names. -## `build_domain_spec(sdtm_domain =)` +## ADPP: optional PP variables via `sdtm_domain` * `build_domain_spec("ADPP", sdtm_domain = "PP")` also unions the SDTMIG PP domain's variables into the ADPP spec, the same way `adsl = TRUE` unions From b1cba961494c2c06bb3c5a71214236b83720f4d2 Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 21:35:26 -0400 Subject: [PATCH 07/10] feat(ig): add every SDTMIG 3.4 domain from the CDISC Library export ig_sdtm now carries all 63 domains of SDTMIG 3.4 (1917 variables), so get_ig("sdtm", version = "3.4", domain = "PP") works. build_domain_spec ("PP"/"SUPPPP") and build_domain_spec("ADPP", sdtm_domain = "PP") default to 3.4. The 3.4 PP table has 26 variables: the 24 of 3.2/3.3 plus PPANMETH (Analysis Method, codelist PKANMET) and PPTPTREF (Time Point Reference), both Permissible, confirming the earlier vendor-page report against the primary source. The default PP spec grows from 24 to 26 variables; the sdtm_domain union adds 24 variables (22 with sdtmig_version = "3.3"). Source: SDTMIG_v3.4.csv, a CDISC Library export downloaded by Bill under CDISC's own terms. It is NOT in this repository and is never committed: data-raw/build_ig_sdtm.R reads it from CDISC_SOURCES_DIR (default ../cdisc-sources) and stops with a message naming the expected file when it is absent, so the build is reproducible by anyone who obtains the export under their own CDISC terms. Only variable metadata is transcribed (order, class, domain, name, label, type, role, Core, codelist). The CDISC Notes column is not carried into the package data (notes is NA for the 3.4 rows) and is read only to recover a stated maximum length as an integer; a test pins that notes is empty. The export gives codelists as CDISC CT C-codes only (Codelist Submission Values is empty throughout), so each first code is mapped to its submission value from the stored CT, using the most recent header row that carries it because 4 of the 135 distinct first codes are for codelists since retired from the CT; a code with no header anywhere stops the build. The existing gates (labels non-NA, newline-free, at most 40 characters; names non-blank and whitespace-free; no stray whitespace in type/core/codelist/ role) pass on all 1917 rows with no problems found. New tests pin the 3.4 PP table in published order, the domain count, per-domain order 1..n, no repeated variable per domain, and the 3.3/3.4 ADPP unions. Co-Authored-By: Claude Sonnet 5.5 --- NEWS.md | 41 +++++++++++--- R/data.R | 23 ++++---- R/get_ig.R | 26 +++++---- README.md | 12 ++-- data-raw/build_ig_sdtm.R | 70 +++++++++++++++++++++++- data-raw/ig_source/README.md | 33 +++++++++-- data-raw/utils_ig.R | 25 +++++++++ data/datasets_catalogue.rda | Bin 540 -> 544 bytes data/ig_sdtm.rda | Bin 8072 -> 20004 bytes man/get_ig.Rd | 26 +++++---- man/ig_sdtm.Rd | 23 ++++---- tests/testthat/test-build_domain_spec.R | 41 +++++++++----- tests/testthat/test-data_integrity.R | 4 +- tests/testthat/test-get_ig.R | 62 +++++++++++++++++++-- 14 files changed, 304 insertions(+), 82 deletions(-) diff --git a/NEWS.md b/NEWS.md index fb81ac7..c631a00 100644 --- a/NEWS.md +++ b/NEWS.md @@ -43,8 +43,7 @@ version 3.3 as well as 3.2, and `get_ig()` gains a `domain` argument (`get_ig("sdtm", version = "3.3", domain = "PP")`; for `"adam"` it matches the `dataset` column, `"ADSL"` or `"BDS"`). An unknown domain is a classed - `cdiscdata_error_ig_domain_unavailable`. `build_domain_spec("PP")` and - `build_domain_spec("SUPPPP")` now default to 3.3. + `cdiscdata_error_ig_domain_unavailable`. * Checked against the published SDTMIG v3.3 (CDISC wiki PDF): its section 6.3.11.2 PP specification is stamped "Version 3.2" and its revision history lists no PP change, so the PP table is unchanged between 3.2 and 3.3; the @@ -57,11 +56,39 @@ table and were simply dropped from the Rsdtm 3.2 transcription (21 of 24 rows), now added to both 3.2 and 3.3 in their published positions; `PPDTC` (not `PPPDTC`) is the published name; and `PPANMETH` is not in the - 3.3 PP table. `PPANMETH` and `PPTPTREF` are reported (by a vendor - appendix, not the IG) as SDTMIG 3.4 additions; SDTMIG 3.4 is not yet - included because CDISC does not host it publicly. nca.reporter's - `PTAETORD`, `PPPDTC`, and `PPPDY` (seeded from aNCA) are not published - SDTMIG names. + 3.3 PP table. `PPANMETH` and `PPTPTREF` are SDTMIG 3.4 additions, now + confirmed against the 3.4 export below. nca.reporter's `PTAETORD`, + `PPPDTC`, and `PPPDY` (seeded from aNCA) are not published SDTMIG names. + +## Every domain of the newest SDTMIG + +* `ig_sdtm` now carries all 63 domains of SDTMIG 3.4 (1917 variables), so + `get_ig("sdtm", version = "3.4", domain = "PP")` works, and + `build_domain_spec("PP")`, `build_domain_spec("SUPPPP")` and + `build_domain_spec("ADPP", sdtm_domain = "PP")` default to 3.4. The 3.4 PP + table has 26 variables: the 24 of 3.2/3.3 plus `PPANMETH` (Analysis + Method, codelist `PKANMET`) and `PPTPTREF` (Time Point Reference), both + Permissible; the default PP spec therefore grows from 24 to 26 variables, + and the `sdtm_domain = "PP"` union adds 24 variables (22 with + `sdtmig_version = "3.3"`). `class` is populated for the 3.4 rows. +* Source: a CDISC Library CSV export downloaded under CDISC's own terms and + conditions, which is **not in this repository** and is never committed. + `data-raw/build_ig_sdtm.R` reads it from `CDISC_SOURCES_DIR` (default + `../cdisc-sources`) and stops with a message naming the expected file if it + is absent, so the build is reproducible by anyone who obtains the export + under their own CDISC terms. Only variable metadata is transcribed (order, + class, domain, name, label, type, role, Core, codelist); the export's CDISC + Notes text is not carried into the package data (`notes` is `NA` for the 3.4 + rows) and is read only to recover a stated maximum length as an integer. + The export lists codelists as CDISC CT C-codes only; each first code is + mapped to its submission value from the stored CT (4 of the 135 distinct + first codes are for codelists since retired from the CT, and are named from + their most recent historical header). +* All the existing gates (labels non-`NA`, newline-free and at most 40 + characters; names non-blank and whitespace-free; no stray whitespace in + `type`/`core`/`codelist`/`role`) pass on every one of the 1917 rows with + no problems found. New tests pin the 3.4 PP table, the domain count, that + `notes` is empty, and that each domain's order is 1..n. ## ADPP: optional PP variables via `sdtm_domain` diff --git a/R/data.R b/R/data.R index 4ee052f..da96b49 100644 --- a/R/data.R +++ b/R/data.R @@ -38,11 +38,12 @@ #' SDTM implementation-guide variable metadata #' #' Versioned SDTM Model and SDTMIG variable metadata: the Model's Findings -#' general-observation-class variables (versions 1.4-1.7), the SDTMIG PP -#' domain, and the SDTMIG generic SUPP-- qualifier structure (used for -#' SUPPPP; versions 3.2 and 3.3, which share the same tables - see -#' \code{\link{get_ig}} and \code{data-raw/ig_source/README.md} for why no -#' newer SDTMIG version's PP/SUPP-- tables are available yet). +#' general-observation-class variables (versions 1.4-1.7); the SDTMIG PP +#' domain and generic SUPP-- qualifier structure (used for SUPPPP) at +#' versions 3.2 and 3.3, which share the same tables; and every domain of +#' SDTMIG 3.4 (63 domains, 1917 variables), transcribed from a CDISC Library +#' export that is not redistributed (see \code{\link{get_ig}} and +#' \code{data-raw/ig_source/README.md}). #' Use \code{\link{get_ig}} to retrieve it, and #' \code{\link{build_domain_spec}} to build a ready-to-use PP/SUPPPP/ADPP #' variable spec from it (joined to CT for codelist ids). @@ -51,13 +52,15 @@ #' \describe{ #' \item{source}{\code{"SDTM_MODEL"} or \code{"SDTMIG"}.} #' \item{version}{SDTM Model version (\code{"1.4"}-\code{"1.7"}) for -#' \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"} or \code{"3.3"}) for -#' \code{source == "SDTMIG"} rows. The two are independent numbering +#' \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"}, +#' \code{"3.3"}, or \code{"3.4"}) for \code{source == "SDTMIG"} rows. The two are independent numbering #' systems; see \code{\link{get_ig}}.} #' \item{class}{General observation class, e.g. \code{"Findings"}. -#' \code{NA} for \code{SDTMIG} rows.} -#' \item{domain}{\code{"PP"} or \code{"SUPPQUAL"} for \code{SDTMIG} rows. -#' \code{NA} for \code{SDTM_MODEL} rows.} +#' \code{NA} for \code{SDTMIG} 3.2 and 3.3 rows; populated for 3.4.} +#' \item{domain}{Domain: \code{"PP"} or \code{"SUPPQUAL"} for SDTMIG 3.2 +#' and 3.3; any of the 63 SDTMIG 3.4 domains (\code{"AE"}, \code{"LB"}, +#' \code{"SUPPQUAL"}, ...) for 3.4. \code{NA} for \code{SDTM_MODEL} +#' rows.} #' \item{order}{Row order within its source table, as published.} #' \item{variable}{Variable name, e.g. \code{"PPTESTCD"}.} #' \item{label}{Variable label.} diff --git a/R/get_ig.R b/R/get_ig.R index e4add43..a607121 100644 --- a/R/get_ig.R +++ b/R/get_ig.R @@ -11,17 +11,18 @@ #' \code{\link{build_domain_spec}} does this filtering for the PP, SUPPPP, #' and ADPP datasets specifically. #' -#' \strong{SDTMIG coverage.} The SDTMIG PP domain and the generic SUPP-- -#' structure are available at versions 3.2 and 3.3. Version 3.3 reuses the -#' 3.2 tables: the published SDTMIG v3.3 stamps its PP specification -#' "Version 3.2" (unchanged since 3.2) and its SUPP-- specification has the -#' same ten variables. Both versions include \code{TAETORD}, \code{EPOCH}, -#' and \code{PPDY}, which the Rsdtm transcription of 3.2 this package copies -#' from omitted. Neither includes \code{PPANMETH} or \code{PPTPTREF}, which -#' are reported to be SDTMIG 3.4 additions that have not yet been sourced from -#' the IG itself (see \code{data-raw/ig_source/README.md}). \code{PPDTC} (not +#' \strong{SDTMIG coverage.} SDTMIG 3.2 and 3.3 carry only the PP domain and +#' the generic SUPP-- structure; version 3.3 reuses the 3.2 tables, since the +#' published SDTMIG v3.3 stamps its PP specification "Version 3.2" (unchanged +#' since 3.2) and its SUPP-- specification has the same ten variables. Both +#' include \code{TAETORD}, \code{EPOCH}, and \code{PPDY}, which the Rsdtm +#' transcription of 3.2 this package copies from omitted. SDTMIG 3.4 carries +#' every one of its 63 domains, from a CDISC Library export (names, labels, +#' types, codelists, roles, Core, and order; the export's CDISC Notes text is +#' not included, so \code{notes} is \code{NA} for those rows). Its PP table +#' adds \code{PPANMETH} and \code{PPTPTREF}. \code{PPDTC} (not #' \code{PPPDTC}) is the published name of the date/time-of-calculation -#' variable in both versions. +#' variable in all three versions. See \code{data-raw/ig_source/README.md}. #' #' @param standard One of \code{"sdtm"} or \code{"adam"}. #' @param version A version string present in the \code{version} column @@ -29,8 +30,9 @@ #' \code{"1.2"} for ADaMIG). \code{NULL} (the default) returns all #' versions. #' @param domain Restrict to one domain/dataset: for \code{"sdtm"}, the -#' \code{domain} column (\code{"PP"} or \code{"SUPPQUAL"}; SDTM Model -#' rows have no domain and are excluded); for \code{"adam"}, the +#' \code{domain} column (\code{"PP"} or \code{"SUPPQUAL"} at SDTMIG +#' 3.2 and 3.3, any of 63 domains at 3.4; SDTM Model rows have no domain +#' and are excluded); for \code{"adam"}, the #' \code{dataset} column (\code{"ADSL"} or \code{"BDS"}). \code{NULL} #' (the default) applies no domain filter. #' @return A data frame: \code{\link{ig_sdtm}} or \code{\link{ig_adam}}, diff --git a/README.md b/README.md index 21ee31d..ff8a626 100644 --- a/README.md +++ b/README.md @@ -13,10 +13,11 @@ with zero runtime dependencies. It bundles: using a validity-date design (one row per term-state, not one copy per release). Current as of the 2026-09-25 NCI release. - **Implementation-guide (IG) variable metadata**: SDTM Model and SDTMIG - variable tables (the Findings general-observation-class variables, the PP - domain, and the generic SUPP-- structure used for SUPPPP) and ADaMIG ADSL - and BDS variable tables (BDS covers ADPP, a BDS-structured dataset). See - `get_ig()` and `build_domain_spec()`. + variable tables (the Findings general-observation-class variables; the PP + domain and generic SUPP-- structure used for SUPPPP at SDTMIG 3.2 and 3.3; + every domain of SDTMIG 3.4) and ADaMIG ADSL and BDS variable tables (BDS + covers ADPP, a BDS-structured dataset). See `get_ig()` and + `build_domain_spec()`. - **Define-XML XSD schemas**: for validating `define.xml` files (versions 2.0 and 2.1). - **XSLT stylesheets**: for rendering `define.xml` as HTML (versions 2.0 and 2.1). @@ -132,7 +133,8 @@ packages (e.g. `cdisclib`, `defineauto`). Key design decisions: |------|--------|---------| | SDTM CT | [NCI EVS FTP](https://evs.nci.nih.gov/ftp1/CDISC/SDTM/) | Public domain | | ADaM CT | [NCI EVS FTP](https://evs.nci.nih.gov/ftp1/CDISC/ADaM/) | Public domain | -| SDTM Model / SDTMIG / ADaMIG variable metadata | CDISC's published specification documents, transcribed via [Bill Denney's Rsdtm package](https://github.com/humanpred/Rsdtm) (private); see `data-raw/ig_source/README.md` for full provenance/attribution | CDISC published standards | +| SDTM Model / SDTMIG 3.2-3.3 / ADaMIG variable metadata | CDISC's published specification documents, transcribed via [Bill Denney's Rsdtm package](https://github.com/humanpred/Rsdtm) (private); see `data-raw/ig_source/README.md` for full provenance/attribution | CDISC published standards | +| SDTMIG 3.4 variable metadata | A CDISC Library CSV export, downloaded under CDISC's terms and **not redistributed**; only variable metadata is transcribed (not the CDISC Notes text); see `data-raw/ig_source/README.md` | CDISC terms and conditions | | Define-XML 2.1 schema | [cdisc-org/DataExchange-RWD-Lineage](https://github.com/cdisc-org/DataExchange-RWD-Lineage) | Apache 2.0 | | Define-XML 2.0 schema | [dbosak01/defineR](https://github.com/dbosak01/defineR) | MIT | | XSLT stylesheets | [cdisc-org/data-definition-engine](https://github.com/cdisc-org/data-definition-engine) / [dbosak01/defineR](https://github.com/dbosak01/defineR) | Apache 2.0 / MIT | diff --git a/data-raw/build_ig_sdtm.R b/data-raw/build_ig_sdtm.R index 67da0ab..0ee019f 100644 --- a/data-raw/build_ig_sdtm.R +++ b/data-raw/build_ig_sdtm.R @@ -114,7 +114,75 @@ sdtmig_rows <- do.call(rbind, c( domain = "SUPPQUAL", file = "Supplemental_Qualifiers-specification.csv") )) -ig_sdtm <- rbind(model_rows, sdtmig_rows) +# ── SDTMIG 3.4: every domain, from the CDISC Library export ───────────────── +# SDTMIG_v3.4.csv (CDISC Library CSV: Version, Variable Order, Class, Dataset +# Name, Variable Name, Variable Label, Type, CDISC CT Codelist Code(s), +# Codelist Submission Values, Described Value Domain(s), Value List, Role, +# CDISC Notes, Core). Read from outside the repository (see +# cdisc_sources_file()); only names, labels, types, codelists, roles, Core, and +# order are transcribed. The CDISC Notes column is NOT carried into the package +# data (`notes` is NA for these rows); it is read only to recover the maximum +# length a note states, as an integer, the same way as for 3.2/3.3. +# +# The export gives codelists as CDISC CT C-codes only ("Codelist Submission +# Values" is empty throughout). `ig_sdtm$codelist` holds the submission value +# (e.g. "PKPARMCD"), so each first code is mapped to its name from the stored CT. +# A code may be retired from the current CT (4 of the 135 distinct first codes +# are), so the name comes from the most recent CT header row that carries it, +# not only a current one; a code with no header anywhere stops the build. +build_sdtmig_34 <- function() { + x <- utils::read.csv(cdisc_sources_file("SDTMIG_v3.4.csv"), check.names = FALSE, + stringsAsFactors = FALSE, na.strings = "", + fileEncoding = "UTF-8") + need <- c("Version", "Variable Order", "Class", "Dataset Name", "Variable Name", + "Variable Label", "Type", "CDISC CT Codelist Code(s)", "Role", + "CDISC Notes", "Core") + if (!all(need %in% names(x))) { + stop("SDTMIG_v3.4.csv is missing column(s): ", + paste(setdiff(need, names(x)), collapse = ", "), call. = FALSE) + } + stopifnot(all(x$Version == "SDTMIG v3.4")) + + e <- new.env(parent = emptyenv()) + load("data/ct_sdtm.rda", envir = e) + hdr <- e$ct_sdtm[is.na(e$ct_sdtm$term_code) & !is.na(e$ct_sdtm$codelist_code) & + !is.na(e$ct_sdtm$codelist_name), ] + hdr <- hdr[order(hdr$codelist_code, hdr$valid_from, decreasing = TRUE), ] + hdr <- hdr[!duplicated(hdr$codelist_code), c("codelist_code", "codelist_name")] + + first_code <- trimws(sub(";.*$", "", x[["CDISC CT Codelist Code(s)"]])) + codelist <- hdr$codelist_name[match(first_code, hdr$codelist_code)] + unmapped <- unique(first_code[!is.na(first_code) & is.na(codelist)]) + if (length(unmapped)) { + stop("SDTMIG 3.4 codelist code(s) with no header row in the stored CT: ", + paste(unmapped, collapse = ", "), call. = FALSE) + } + + data.frame( + source = "SDTMIG", + version = "3.4", + class = tidy_text(x$Class), + domain = tidy_text(x[["Dataset Name"]]), + order = as.integer(x[["Variable Order"]]), + variable = tidy_text(x[["Variable Name"]]), + label = tidy_text(x[["Variable Label"]]), + type = tidy_text(x$Type), + role = tidy_text(x$Role), + core = tidy_text(x$Core), + codelist = codelist, + length = parse_documented_length(x[["CDISC Notes"]]), + notes = NA_character_, + stringsAsFactors = FALSE + ) +} + +sdtmig_34_rows <- build_sdtmig_34() +stopifnot( + !anyDuplicated(paste(sdtmig_34_rows$domain, sdtmig_34_rows$variable)), + all(c("PP", "SUPPQUAL") %in% sdtmig_34_rows$domain) +) + +ig_sdtm <- rbind(model_rows, sdtmig_rows, sdtmig_34_rows) rownames(ig_sdtm) <- NULL # ── Labels over the 40-character XPT limit ───────────────────────────────── diff --git a/data-raw/ig_source/README.md b/data-raw/ig_source/README.md index 2a48eb8..c1ab095 100644 --- a/data-raw/ig_source/README.md +++ b/data-raw/ig_source/README.md @@ -44,11 +44,34 @@ Core "Permissible" taken from the Certara PKSubmit SDTM_3.2 appendix because the PDF does not show it. Existing rows keep their Core from the Rsdtm transcription. -A newer SDTMIG's PP/SUPP-- tables can be added by copying the equivalent CSVs -into a new `sdtmig_/` directory and adding the version to -`sdtmig_sources` in `data-raw/build_ig_sdtm.R`. SDTMIG 3.4 is not yet -included: its PDF is not publicly hosted by CDISC (the cdisc.org copy is -members-only). +## SDTMIG 3.4 (every domain, from a CDISC Library export) + +SDTMIG 3.4 comes from `SDTMIG_v3.4.csv`, a CDISC Library CSV export (one row +per variable: Version, Variable Order, Class, Dataset Name, Variable Name, +Variable Label, Type, CDISC CT Codelist Code(s), Codelist Submission Values, +Described Value Domain(s), Value List, Role, CDISC Notes, Core; 1917 rows, +63 domains) that was downloaded under CDISC's own terms and conditions. That +file is **not in this repository and must never be committed or copied into +any repository**; `build_ig_sdtm.R` reads it from `CDISC_SOURCES_DIR` +(default `../cdisc-sources`, relative to the checkout) and stops with a +message naming the expected file if it is absent. Anyone reproducing the +build obtains the export under their own CDISC terms. + +Only variable metadata is transcribed into `ig_sdtm`: order, class, domain, +variable name, label, type, role, Core, and the codelist. The CDISC Notes +column is not carried into the package data (`notes` is `NA` for these rows); +it is read only to recover, as an integer, a maximum length a note states. +The export gives codelists only as CDISC CT C-codes, so each variable's first +code is mapped to its submission value (e.g. `C85839` to `PKPARMCD`) from the +stored CT, using the most recent header row that carries the code because a +few codes (4 of the 135 distinct first codes) are for codelists since retired +from the CT; a code with no header anywhere stops the build. Where a variable +lists several codelists (e.g. PPORRESU: PKUNIT, PKUWG, ...) only the first is +kept, as for 3.2 and 3.3. + +A newer SDTMIG's PP/SUPP-- tables from public sources can be added by copying +the equivalent CSVs into a new `sdtmig_/` directory and adding the +version to `sdtmig_sources` in `data-raw/build_ig_sdtm.R`. ## Encoding diff --git a/data-raw/utils_ig.R b/data-raw/utils_ig.R index 3287733..cee09fd 100644 --- a/data-raw/utils_ig.R +++ b/data-raw/utils_ig.R @@ -124,3 +124,28 @@ parse_documented_length <- function(notes) { len[hit] <- suppressWarnings(as.integer(sub("\\D*(\\d+).*", "\\1", matched))) len } + +# Path to a CDISC source file that is NOT part of this repository. +# +# The SDTMIG 3.4 export is a CDISC Library download made under CDISC's own +# terms and conditions (use within the downloader's organization only; no +# copying, distribution, or derivative works of the material itself). The +# file is therefore never committed here: it is read from CDISC_SOURCES_DIR +# (default "../cdisc-sources", relative to the checkout), and only variable +# metadata is transcribed from it into data/. Anyone reproducing the build +# obtains the export under their own CDISC terms and places it there. +cdisc_sources_file <- function(file) { + dir <- Sys.getenv("CDISC_SOURCES_DIR", "../cdisc-sources") + path <- file.path(dir, file) + if (!file.exists(path)) { + stop( + "Cannot find the CDISC source file '", file, "'.\n", + "Expected it at: ", normalizePath(path, winslash = "/", mustWork = FALSE), "\n", + "It is a CDISC Library export that is not part of this repository; obtain it ", + "under your own CDISC terms and put it there, or set the CDISC_SOURCES_DIR ", + "environment variable to the directory that holds it.", + call. = FALSE + ) + } + path +} diff --git a/data/datasets_catalogue.rda b/data/datasets_catalogue.rda index 119b9e47159f9a39dbc7c7ad220efc5dc863227d..f85587b53741325983f7ef8bca3bdc4b83ece9ac 100644 GIT binary patch delta 244 zcmVSKj@U=ox65gm$UZ8Q7%m?To)|Adz>$5j-KRb0*G_x-6`BGarPI uMmg+)z?e=Brvm^00002ax;62><{>Tfz=LFb#_W000000a;pvIBaGB delta 240 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 delta 8066 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 Qa6T{%ivj=u00045TE>Z|k^lez diff --git a/man/get_ig.Rd b/man/get_ig.Rd index 23acca7..aba1397 100644 --- a/man/get_ig.Rd +++ b/man/get_ig.Rd @@ -15,8 +15,9 @@ get_ig(standard = c("sdtm", "adam"), version = NULL, domain = NULL) versions.} \item{domain}{Restrict to one domain/dataset: for \code{"sdtm"}, the -\code{domain} column (\code{"PP"} or \code{"SUPPQUAL"}; SDTM Model -rows have no domain and are excluded); for \code{"adam"}, the +\code{domain} column (\code{"PP"} or \code{"SUPPQUAL"} at SDTMIG +3.2 and 3.3, any of 63 domains at 3.4; SDTM Model rows have no domain +and are excluded); for \code{"adam"}, the \code{dataset} column (\code{"ADSL"} or \code{"BDS"}). \code{NULL} (the default) applies no domain filter.} } @@ -37,17 +38,18 @@ caller to filter further (by \code{source}/\code{domain}/\code{class} for and ADPP datasets specifically. } \details{ -\strong{SDTMIG coverage.} The SDTMIG PP domain and the generic SUPP-- -structure are available at versions 3.2 and 3.3. Version 3.3 reuses the -3.2 tables: the published SDTMIG v3.3 stamps its PP specification -"Version 3.2" (unchanged since 3.2) and its SUPP-- specification has the -same ten variables. Both versions include \code{TAETORD}, \code{EPOCH}, -and \code{PPDY}, which the Rsdtm transcription of 3.2 this package copies -from omitted. Neither includes \code{PPANMETH} or \code{PPTPTREF}, which -are reported to be SDTMIG 3.4 additions that have not yet been sourced from -the IG itself (see \code{data-raw/ig_source/README.md}). \code{PPDTC} (not +\strong{SDTMIG coverage.} SDTMIG 3.2 and 3.3 carry only the PP domain and +the generic SUPP-- structure; version 3.3 reuses the 3.2 tables, since the +published SDTMIG v3.3 stamps its PP specification "Version 3.2" (unchanged +since 3.2) and its SUPP-- specification has the same ten variables. Both +include \code{TAETORD}, \code{EPOCH}, and \code{PPDY}, which the Rsdtm +transcription of 3.2 this package copies from omitted. SDTMIG 3.4 carries +every one of its 63 domains, from a CDISC Library export (names, labels, +types, codelists, roles, Core, and order; the export's CDISC Notes text is +not included, so \code{notes} is \code{NA} for those rows). Its PP table +adds \code{PPANMETH} and \code{PPTPTREF}. \code{PPDTC} (not \code{PPPDTC}) is the published name of the date/time-of-calculation -variable in both versions. +variable in all three versions. See \code{data-raw/ig_source/README.md}. } \examples{ get_ig("sdtm") diff --git a/man/ig_sdtm.Rd b/man/ig_sdtm.Rd index 14771e6..1c9e508 100644 --- a/man/ig_sdtm.Rd +++ b/man/ig_sdtm.Rd @@ -9,13 +9,15 @@ A data frame with columns: \describe{ \item{source}{\code{"SDTM_MODEL"} or \code{"SDTMIG"}.} \item{version}{SDTM Model version (\code{"1.4"}-\code{"1.7"}) for - \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"} or \code{"3.3"}) for - \code{source == "SDTMIG"} rows. The two are independent numbering + \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"}, + \code{"3.3"}, or \code{"3.4"}) for \code{source == "SDTMIG"} rows. The two are independent numbering systems; see \code{\link{get_ig}}.} \item{class}{General observation class, e.g. \code{"Findings"}. - \code{NA} for \code{SDTMIG} rows.} - \item{domain}{\code{"PP"} or \code{"SUPPQUAL"} for \code{SDTMIG} rows. - \code{NA} for \code{SDTM_MODEL} rows.} + \code{NA} for \code{SDTMIG} 3.2 and 3.3 rows; populated for 3.4.} + \item{domain}{Domain: \code{"PP"} or \code{"SUPPQUAL"} for SDTMIG 3.2 + and 3.3; any of the 63 SDTMIG 3.4 domains (\code{"AE"}, \code{"LB"}, + \code{"SUPPQUAL"}, ...) for 3.4. \code{NA} for \code{SDTM_MODEL} + rows.} \item{order}{Row order within its source table, as published.} \item{variable}{Variable name, e.g. \code{"PPTESTCD"}.} \item{label}{Variable label.} @@ -48,11 +50,12 @@ ig_sdtm } \description{ Versioned SDTM Model and SDTMIG variable metadata: the Model's Findings -general-observation-class variables (versions 1.4-1.7), the SDTMIG PP -domain, and the SDTMIG generic SUPP-- qualifier structure (used for -SUPPPP; versions 3.2 and 3.3, which share the same tables - see -\code{\link{get_ig}} and \code{data-raw/ig_source/README.md} for why no -newer SDTMIG version's PP/SUPP-- tables are available yet). +general-observation-class variables (versions 1.4-1.7); the SDTMIG PP +domain and generic SUPP-- qualifier structure (used for SUPPPP) at +versions 3.2 and 3.3, which share the same tables; and every domain of +SDTMIG 3.4 (63 domains, 1917 variables), transcribed from a CDISC Library +export that is not redistributed (see \code{\link{get_ig}} and +\code{data-raw/ig_source/README.md}). Use \code{\link{get_ig}} to retrieve it, and \code{\link{build_domain_spec}} to build a ready-to-use PP/SUPPPP/ADPP variable spec from it (joined to CT for codelist ids). diff --git a/tests/testthat/test-build_domain_spec.R b/tests/testthat/test-build_domain_spec.R index 7295466..be1ba78 100644 --- a/tests/testthat/test-build_domain_spec.R +++ b/tests/testthat/test-build_domain_spec.R @@ -20,17 +20,25 @@ test_that("build_domain_spec resolves PPTESTCD/PPTEST/PPSTAT codelist ids agains expect_equal(pp$length[pp$variable == "PPTESTCD"], 8L) }) -test_that("build_domain_spec PP defaults to the newest SDTMIG (3.3) and returns the 24 published variables in order", { +test_that("build_domain_spec PP defaults to the newest SDTMIG (3.4) and returns its 26 variables in order", { pp <- build_domain_spec("PP") expect_equal(pp$variable, c("STUDYID", "DOMAIN", "USUBJID", "PPSEQ", "PPGRPID", "PPTESTCD", "PPTEST", "PPCAT", "PPSCAT", "PPORRES", "PPORRESU", "PPSTRESC", "PPSTRESN", "PPSTRESU", "PPSTAT", "PPREASND", "PPSPEC", - "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPRFTDTC", "PPSTINT", - "PPENINT")) - expect_equal(pp$order, 1:24) + "PPANMETH", "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPTPTREF", + "PPRFTDTC", "PPSTINT", "PPENINT")) + expect_equal(pp$order, 1:26) expect_equal(pp$codelist_id[pp$variable == "EPOCH"], "C99079") - expect_identical(pp, build_domain_spec("PP", ig_version = "3.3")) + expect_equal(pp$codelist_id[pp$variable == "PPANMETH"], "C172330") + expect_equal(pp$core[pp$variable %in% c("PPANMETH", "PPTPTREF")], c("Perm", "Perm")) + expect_identical(pp, build_domain_spec("PP", ig_version = "3.4")) +}) + +test_that("build_domain_spec PP at 3.3 returns the 24 published variables, without PPANMETH or PPTPTREF", { + pp <- build_domain_spec("PP", ig_version = "3.3") + expect_equal(pp$variable, setdiff(build_domain_spec("PP")$variable, c("PPANMETH", "PPTPTREF"))) + expect_equal(pp$order, 1:24) }) test_that("build_domain_spec PP at 3.2 equals 3.3 (the tables are unchanged between them)", { @@ -157,14 +165,15 @@ test_that("build_domain_spec aborts (classed) when an ADaMIG version has no BDS # ---- sdtm_domain: union the SDTMIG PP variables into an ADPP spec ---------- -# PP's 24 published variables less STUDYID and USUBJID, which BDS already -# defines (the BDS version is kept). +# SDTMIG 3.4's 26 PP variables less STUDYID and USUBJID, which BDS already +# defines (the BDS version is kept); at 3.3 PPANMETH and PPTPTREF are absent. pp_added_to_adpp <- c( "DOMAIN", "PPSEQ", "PPGRPID", "PPTESTCD", "PPTEST", "PPCAT", "PPSCAT", "PPORRES", "PPORRESU", "PPSTRESC", "PPSTRESN", "PPSTRESU", "PPSTAT", - "PPREASND", "PPSPEC", "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPRFTDTC", - "PPSTINT", "PPENINT" + "PPREASND", "PPSPEC", "PPANMETH", "TAETORD", "EPOCH", "PPDTC", "PPDY", + "PPTPTREF", "PPRFTDTC", "PPSTINT", "PPENINT" ) +pp_added_to_adpp_33 <- setdiff(pp_added_to_adpp, c("PPANMETH", "PPTPTREF")) test_that("build_domain_spec ADPP leaves the PP variables out by default, and sdtm_domain = NULL is the default", { base <- build_domain_spec("ADPP") @@ -172,18 +181,18 @@ test_that("build_domain_spec ADPP leaves the PP variables out by default, and sd expect_identical(base, build_domain_spec("ADPP", sdtm_domain = NULL)) }) -test_that("build_domain_spec ADPP sdtm_domain = 'PP' appends exactly the 22 PP variables not already defined", { +test_that("build_domain_spec ADPP sdtm_domain = 'PP' appends exactly the 24 PP variables not already defined", { base <- build_domain_spec("ADPP") withpp <- build_domain_spec("ADPP", sdtm_domain = "PP") added <- withpp[withpp$source == "SDTMIG", ] - expect_equal(nrow(withpp), nrow(base) + 22L) + expect_equal(nrow(withpp), nrow(base) + 24L) # the BDS + ADSL rows are untouched and come first expect_identical(withpp[seq_len(nrow(base)), ], base) expect_equal(added$variable, pp_added_to_adpp) expect_true(all(added$core == "Perm")) # ordered after everything already there, continuing the sequence - expect_equal(added$order, max(base$order) + seq_len(22L)) + expect_equal(added$order, max(base$order) + seq_len(24L)) # shared base variables keep their BDS version and appear once expect_equal(withpp$source[withpp$variable == "STUDYID"], "BDS") expect_equal(sum(withpp$variable %in% c("STUDYID", "USUBJID")), 2L) @@ -208,6 +217,7 @@ test_that("build_domain_spec ADPP resolves the PP codelist ids against the SDTM expect_equal(withpp$codelist_id[withpp$variable == "PPSTAT"], "C66789") expect_equal(withpp$codelist_id[withpp$variable == "PPSPEC"], "C78734") expect_equal(withpp$codelist_id[withpp$variable == "EPOCH"], "C99079") + expect_equal(withpp$codelist_id[withpp$variable == "PPANMETH"], "C172330") }) test_that("build_domain_spec ADPP sdtm_domain = 'PP' works with adsl = FALSE (BDS + PP only)", { @@ -219,11 +229,16 @@ test_that("build_domain_spec ADPP sdtm_domain = 'PP' works with adsl = FALSE (BD expect_equal(nb$codelist_id[nb$variable == "PPTESTCD"], "C85839") }) -test_that("build_domain_spec ADPP sdtmig_version picks the SDTMIG version (3.2 and 3.3 PP tables are identical)", { +test_that("build_domain_spec ADPP sdtmig_version picks the SDTMIG version (3.2 and 3.3 PP tables are identical; 3.4 adds two)", { expect_identical( build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.2"), build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.3") ) + at33 <- build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.3") + expect_equal(at33$variable[at33$source == "SDTMIG"], pp_added_to_adpp_33) + at34 <- build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.4") + expect_equal(nrow(at34) - nrow(at33), 2L) + expect_equal(setdiff(at34$variable, at33$variable), c("PPANMETH", "PPTPTREF")) e <- expect_error( build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "9.9"), class = "cdiscdata_error_ig_version_unavailable" diff --git a/tests/testthat/test-data_integrity.R b/tests/testthat/test-data_integrity.R index c02961a..e126a5b 100644 --- a/tests/testthat/test-data_integrity.R +++ b/tests/testthat/test-data_integrity.R @@ -176,8 +176,8 @@ test_that("the SDTM IG labels that exceeded 40 characters are the abbreviated pu expect_equal(sort(testcd$version), c("1.4", "1.5", "1.6")) expect_equal(testcd$label, rep("Short Name of Measurement, Test or Exam", 3L)) ppstresc <- sdtm[sdtm$variable == "PPSTRESC" & sdtm$source == "SDTMIG", ] - expect_equal(sort(ppstresc$version), c("3.2", "3.3")) - expect_equal(ppstresc$label, rep("Character Result/Finding in Std Format", 2L)) + expect_equal(sort(ppstresc$version), c("3.2", "3.3", "3.4")) + expect_equal(ppstresc$label, rep("Character Result/Finding in Std Format", 3L)) }) diff --git a/tests/testthat/test-get_ig.R b/tests/testthat/test-get_ig.R index f5a2c6f..62fb1b4 100644 --- a/tests/testthat/test-get_ig.R +++ b/tests/testthat/test-get_ig.R @@ -11,7 +11,7 @@ test_that("get_ig(version = NULL) returns every source/version", { sdtm <- get_ig("sdtm") expect_setequal(unique(sdtm$source), c("SDTM_MODEL", "SDTMIG")) expect_setequal(sdtm$version[sdtm$source == "SDTM_MODEL"], c("1.4", "1.5", "1.6", "1.7")) - expect_setequal(sdtm$version[sdtm$source == "SDTMIG"], c("3.2", "3.3")) + expect_setequal(sdtm$version[sdtm$source == "SDTMIG"], c("3.2", "3.3", "3.4")) adam <- get_ig("adam") expect_setequal(unique(adam$version), c("1.0", "1.1", "1.2")) @@ -110,10 +110,55 @@ test_that("PP rows added from the SDTMIG v3.3 table have the published label, ty expect_equal(row("PPDTC")$label, "Date/Time of Parameter Calculations") }) -test_that("PP does not carry the aNCA-style names PPPDTC, PPPDY, or PTAETORD, nor 3.4-only PPANMETH/PPTPTREF", { +test_that("PP never carries the aNCA-style names PPPDTC, PPPDY, or PTAETORD; PPANMETH and PPTPTREF appear only at 3.4", { pp <- get_ig("sdtm", domain = "PP") - expect_equal(intersect(c("PPPDTC", "PPPDY", "PTAETORD", "PPANMETH", "PPTPTREF"), pp$variable), - character(0L)) + expect_equal(intersect(c("PPPDTC", "PPPDY", "PTAETORD"), pp$variable), character(0L)) + by_version <- split(pp$variable, pp$version) + expect_equal(intersect(c("PPANMETH", "PPTPTREF"), by_version[["3.2"]]), character(0L)) + expect_equal(intersect(c("PPANMETH", "PPTPTREF"), by_version[["3.3"]]), character(0L)) + expect_equal(intersect(c("PPANMETH", "PPTPTREF"), by_version[["3.4"]]), + c("PPANMETH", "PPTPTREF")) +}) + +test_that("get_ig(domain = 'PP') returns the 26 PP variables of SDTMIG 3.4 in published order", { + pp <- get_ig("sdtm", version = "3.4", domain = "PP") + expect_equal(pp$variable, + c("STUDYID", "DOMAIN", "USUBJID", "PPSEQ", "PPGRPID", "PPTESTCD", + "PPTEST", "PPCAT", "PPSCAT", "PPORRES", "PPORRESU", "PPSTRESC", + "PPSTRESN", "PPSTRESU", "PPSTAT", "PPREASND", "PPSPEC", + "PPANMETH", "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPTPTREF", + "PPRFTDTC", "PPSTINT", "PPENINT")) + expect_equal(pp$order, 1:26) + expect_true(all(pp$class == "Findings")) + row <- function(v) pp[pp$variable == v, ] + expect_equal(row("PPANMETH")$label, "Analysis Method") + expect_equal(row("PPANMETH")$codelist, "PKANMET") + expect_equal(row("PPANMETH")$core, "Perm") + expect_equal(row("PPTPTREF")$label, "Time Point Reference") + expect_equal(row("PPTPTREF")$type, "Char") + expect_equal(row("PPTESTCD")$codelist, "PKPARMCD") + expect_equal(row("PPTESTCD")$length, 8L) + expect_equal(row("PPSTRESC")$label, "Character Result/Finding in Std Format") +}) + +test_that("SDTMIG 3.4 carries every one of its 63 domains, and never the CDISC Notes text", { + s34 <- get_ig("sdtm", version = "3.4") + expect_equal(nrow(s34), 1917L) + expect_equal(length(unique(s34$domain)), 63L) + expect_true(all(c("AE", "LB", "VS", "PC", "PP", "DM", "TS", "SUPPQUAL", "RELREC") %in% s34$domain)) + expect_true(all(s34$source == "SDTMIG" & s34$version == "3.4")) + # the licensed export's Notes column is read only to recover a stated + # maximum length (an integer) and is never stored + expect_true(all(is.na(s34$notes))) + # order is the published position within each domain, 1..n + expect_true(all(tapply(s34$order, s34$domain, function(o) identical(o, seq_along(o))))) + # no domain repeats a variable + expect_false(anyDuplicated(paste(s34$domain, s34$variable)) > 0L) + # SUPP-- is unchanged since 3.2 + supp <- get_ig("sdtm", version = "3.4", domain = "SUPPQUAL") + expect_equal(supp$variable, + c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", + "QLABEL", "QVAL", "QORIG", "QEVAL")) }) test_that("SDTMIG 3.2 and 3.3 PP and SUPPQUAL tables are identical apart from the version", { @@ -145,8 +190,15 @@ test_that("get_ig(domain =) filters ADaM by dataset and works without a version" test_that("get_ig aborts (classed) on an unknown domain, listing what is available", { e <- expect_error(get_ig("sdtm", domain = "ZZ"), class = "cdiscdata_error_ig_domain_unavailable") + avail <- sort(unique(get_ig("sdtm")$domain)) + expect_equal(length(avail), 63L) expect_equal(conditionMessage(e), - "Domain 'ZZ' is not available for standard 'sdtm'. Available: PP, SUPPQUAL.") + paste0("Domain 'ZZ' is not available for standard 'sdtm'. Available: ", + paste(avail, collapse = ", "), ".")) + e_34 <- expect_error(get_ig("sdtm", version = "3.2", domain = "AE"), + class = "cdiscdata_error_ig_domain_unavailable") + expect_equal(conditionMessage(e_34), + "Domain 'AE' is not available for standard 'sdtm' at version '3.2'. Available: PP, SUPPQUAL.") e_v <- expect_error(get_ig("adam", version = "1.0", domain = "ZZ"), class = "cdiscdata_error_ig_domain_unavailable") expect_equal(conditionMessage(e_v), From d3d79d3238e6885b25af26075545f22dbb1d240a Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 21:43:21 -0400 Subject: [PATCH 08/10] test: shorten two test titles to satisfy the 120-character lint limit Co-Authored-By: Claude Sonnet 5.5 --- tests/testthat/test-build_domain_spec.R | 2 +- tests/testthat/test-get_ig.R | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/tests/testthat/test-build_domain_spec.R b/tests/testthat/test-build_domain_spec.R index be1ba78..42ffa7a 100644 --- a/tests/testthat/test-build_domain_spec.R +++ b/tests/testthat/test-build_domain_spec.R @@ -229,7 +229,7 @@ test_that("build_domain_spec ADPP sdtm_domain = 'PP' works with adsl = FALSE (BD expect_equal(nb$codelist_id[nb$variable == "PPTESTCD"], "C85839") }) -test_that("build_domain_spec ADPP sdtmig_version picks the SDTMIG version (3.2 and 3.3 PP tables are identical; 3.4 adds two)", { +test_that("build_domain_spec ADPP sdtmig_version picks the SDTMIG version (3.2 = 3.3; 3.4 adds two)", { expect_identical( build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.2"), build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.3") diff --git a/tests/testthat/test-get_ig.R b/tests/testthat/test-get_ig.R index 62fb1b4..6a92564 100644 --- a/tests/testthat/test-get_ig.R +++ b/tests/testthat/test-get_ig.R @@ -110,7 +110,7 @@ test_that("PP rows added from the SDTMIG v3.3 table have the published label, ty expect_equal(row("PPDTC")$label, "Date/Time of Parameter Calculations") }) -test_that("PP never carries the aNCA-style names PPPDTC, PPPDY, or PTAETORD; PPANMETH and PPTPTREF appear only at 3.4", { +test_that("PP never has PPPDTC, PPPDY or PTAETORD; PPANMETH and PPTPTREF appear only at 3.4", { pp <- get_ig("sdtm", domain = "PP") expect_equal(intersect(c("PPPDTC", "PPPDY", "PTAETORD"), pp$variable), character(0L)) by_version <- split(pp$variable, pp$version) From 2c24c7a258f63fe658b0437171f899b79e449de8 Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 22:07:27 -0400 Subject: [PATCH 09/10] feat(ig): load all 34 CDISC Library IG and model exports into three tables ig_sdtm, model_sdtm and ig_adam now carry every standard and version in the 34 CDISC Library CSV exports (SDTM 1.2-2.1, SDTMIG 3.1.2-3.4, SDTMIG-AP/MD, SENDIG, SENDIG-AR/DART/GeneTox, ADaMIG 1.0-1.3, and the ADaMIG-MD, NCA, ADAE, BDS-TTE, OCCDS and popPK guides), replacing every Rsdtm-derived row. Only metadata fields are carried; the guides' prose columns are dropped. get_ig() takes a standard, a version (newest by default) and a domain. build_domain_spec() takes a standard and an extension (ADaMIG-NCA, popPK or BDS-TTE) that is unioned onto BDS like adsl = TRUE. get_dataset() now reaches the IG and model tables, which previously returned NULL. The exports are read from CDISC_SOURCES_DIR and never committed; data-raw/ig_source and its parsers are removed. Integrity gates cover row counts, unique keys, label length (22 published exceptions, listed), types, cores, whitespace, and that no CSV is tracked under data-raw. Co-Authored-By: Claude Sonnet 5.5 --- R/build_domain_spec.R | 248 ++++++++----- R/data.R | 202 ++++++---- R/get_dataset.R | 44 ++- R/get_ig.R | 177 +++++---- R/ig_versions.R | 74 ++++ R/utils.R | 3 +- data-raw/build_catalogue.R | 56 +-- data-raw/build_ig.R | 115 ++++++ data-raw/build_ig_adam.R | 82 ----- data-raw/build_ig_sdtm.R | 224 ------------ data-raw/fetch_all.R | 5 +- data-raw/ig_source/README.md | 107 ------ .../adamig_1.0/ADSL-specification.csv | 139 ------- ...ysis_Descriptor_Variables_BDS_Datasets.csv | 42 --- ...lysis_Parameter_Variables_BDS_Datasets.csv | 47 --- .../Data_Point_Traceability_Variables.csv | 7 - .../Indicator_Variables_BDS_Datasets.csv | 63 ---- ...ject_Identifier_Variables_BDS_Datasets.csv | 8 - .../Timing_Variables_BDS_Datasets.csv | 113 ------ .../Treatment_Variables_BDS_Datasets.csv | 17 - .../adamig_1.1/ADSL_Dose_Variables.csv | 7 - .../adamig_1.1/ADSL_Identifier_Variables.csv | 15 - .../ADSL_Population_Indicator_Variables.csv | 25 -- .../ADSL_Subject_Demographics_Variables.csv | 13 - ...bject_Level_Trial_Experience_Variables.csv | 70 ---- .../ADSL_Treatment_Timing_Variables.csv | 46 --- .../adamig_1.1/ADSL_Treatment_Variables.csv | 34 -- ...ysis_Descriptor_Variables_BDS_Datasets.csv | 10 - ...ameter_Criteria_Variables_BDS_Datasets.csv | 17 - ...lysis_Parameter_Variables_BDS_Datasets.csv | 53 --- ...Visit_Windowing_Variables_BDS_Datasets.csv | 11 - .../adamig_1.1/BDS_Population_Indicators.csv | 19 - .../Datapoint_Traceability_Variables.csv | 8 - .../Identifier_Variables_BDS_Datasets.csv | 11 - .../Indicator_Variables_BDS_Datasets.csv | 21 -- ...eriod_Phase_Start_End_Timing_Variables.csv | 61 ---- ...cord_Level_Dose_Variables_BDS_Datasets.csv | 13 - ...Level_Treatment_Variables_BDS_Datasets.csv | 18 - ...eriod_Subperiod_Phase_Timing_Variables.csv | 55 --- ..._Defined_Timing_Variables_BDS_Datasets.csv | 29 -- .../Time_To_Event_Variables_BDS_Datasets.csv | 17 - .../Timing_Variables_BDS_Datasets.csv | 66 ---- .../Toxicity_Range_Variables_BDS_Datasets.csv | 35 -- .../adamig_1.2/ADSL_Dose_Variables.csv | 4 - .../adamig_1.2/ADSL_Identifier_Variables.csv | 11 - .../ADSL_Population_Indicator_Variables.csv | 11 - .../ADSL_Stratification_Variables.csv | 18 - .../ADSL_Subject_Demographics_Variables.csv | 12 - ...bject_Level_Trial_Experience_Variables.csv | 38 -- .../ADSL_Treatment_Timing_Variables.csv | 22 -- .../adamig_1.2/ADSL_Treatment_Variables.csv | 27 -- ...ysis_Descriptor_Variables_BDS_Datasets.csv | 11 - ...ameter_Criteria_Variables_BDS_Datasets.csv | 12 - .../Analysis_Parameter_Variables.csv | 49 --- ...Visit_Windowing_Variables_BDS_Datasets.csv | 8 - .../adamig_1.2/BDS_Population_Indicators.csv | 15 - .../Datapoint_Traceability_Variables.csv | 5 - .../Flag_Variables_BDS_Datasets.csv | 16 - .../Identifier_Variables_BDS_Datasets.csv | 10 - ...eriod_Phase_Start_End_Timing_Variables.csv | 31 -- ...cord_Level_Dose_Variables_BDS_Datasets.csv | 6 - ...Level_Treatment_Variables_BDS_Datasets.csv | 16 - ...eriod_Subperiod_Phase_Timing_Variables.csv | 33 -- ..._Defined_Timing_Variables_BDS_Datasets.csv | 23 -- .../Time_To_Event_Variables_BDS_Datasets.csv | 8 - .../Timing_Variables_BDS_Datasets.csv | 39 -- .../Toxicity_Range_Variables_BDS_Datasets.csv | 46 --- .../1.4/Findings_Observation_Class.csv | 270 -------------- .../1.5/Findings_Observation_Class.csv | 305 ---------------- .../1.6/Findings_Observation_Class.csv | 64 ---- .../1.7/Findings_Observation_Class.csv | 64 ---- .../ig_source/sdtmig_3.2/PP-additions.csv | 4 - .../ig_source/sdtmig_3.2/PP-specification.csv | 45 --- .../Supplemental_Qualifiers-specification.csv | 18 - data-raw/utils_ig.R | 288 ++++++++------- data/datasets_catalogue.rda | Bin 544 -> 672 bytes data/ig_adam.rda | Bin 24900 -> 11312 bytes data/ig_sdtm.rda | Bin 20004 -> 35752 bytes data/ig_sources.rda | Bin 0 -> 1460 bytes data/model_sdtm.rda | Bin 0 -> 11716 bytes man/build_domain_spec.Rd | 88 +++-- man/datasets_catalogue.Rd | 3 +- man/get_dataset.Rd | 22 +- man/get_ig.Rd | 91 +++-- man/ig_adam.Rd | 61 ++-- man/ig_sdtm.Rd | 78 ++-- man/ig_sources.Rd | 33 ++ man/model_sdtm.Rd | 50 +++ tests/testthat/helper-ig-exceptions.R | 82 +++++ tests/testthat/test-build_domain_spec.R | 345 +++++++++++++----- tests/testthat/test-data_integrity.R | 98 ----- tests/testthat/test-get_dataset.R | 34 ++ tests/testthat/test-get_ig.R | 322 +++++++--------- tests/testthat/test-ig_integrity.R | 188 ++++++++++ tests/testthat/test-ig_versions.R | 63 ++++ tests/testthat/test-list_datasets.R | 20 +- 96 files changed, 1868 insertions(+), 3666 deletions(-) create mode 100644 R/ig_versions.R create mode 100644 data-raw/build_ig.R delete mode 100644 data-raw/build_ig_adam.R delete mode 100644 data-raw/build_ig_sdtm.R delete mode 100644 data-raw/ig_source/README.md delete mode 100644 data-raw/ig_source/adamig_1.0/ADSL-specification.csv delete mode 100644 data-raw/ig_source/adamig_1.0/Analysis_Descriptor_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.0/Analysis_Parameter_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.0/Data_Point_Traceability_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.0/Indicator_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.0/Subject_Identifier_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.0/Timing_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.0/Treatment_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/ADSL_Dose_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/ADSL_Identifier_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/ADSL_Population_Indicator_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/ADSL_Subject_Demographics_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/ADSL_Subject_Level_Trial_Experience_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/ADSL_Treatment_Timing_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/ADSL_Treatment_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Analysis_Descriptor_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Analysis_Parameter_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/BDS_Population_Indicators.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Datapoint_Traceability_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Identifier_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Indicator_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Period_Subperiod_Phase_Start_End_Timing_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Record_Level_Dose_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Record_Level_Treatment_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Subject_level_Period_Subperiod_Phase_Timing_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Suffixes_User_Defined_Timing_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Time_To_Event_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Timing_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.1/Toxicity_Range_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Dose_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Identifier_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Population_Indicator_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Stratification_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Subject_Demographics_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Subject_Level_Trial_Experience_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Treatment_Timing_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/ADSL_Treatment_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Analysis_Descriptor_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Analysis_Parameter_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/BDS_Population_Indicators.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Datapoint_Traceability_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Flag_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Identifier_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Period_Subperiod_Phase_Start_End_Timing_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Record_Level_Dose_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Record_Level_Treatment_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Subject_Level_Period_Subperiod_Phase_Timing_Variables.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Suffixes_Producer_Defined_Timing_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Time_To_Event_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Timing_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/adamig_1.2/Toxicity_Range_Variables_BDS_Datasets.csv delete mode 100644 data-raw/ig_source/sdtm_model/1.4/Findings_Observation_Class.csv delete mode 100644 data-raw/ig_source/sdtm_model/1.5/Findings_Observation_Class.csv delete mode 100644 data-raw/ig_source/sdtm_model/1.6/Findings_Observation_Class.csv delete mode 100644 data-raw/ig_source/sdtm_model/1.7/Findings_Observation_Class.csv delete mode 100644 data-raw/ig_source/sdtmig_3.2/PP-additions.csv delete mode 100644 data-raw/ig_source/sdtmig_3.2/PP-specification.csv delete mode 100644 data-raw/ig_source/sdtmig_3.2/Supplemental_Qualifiers-specification.csv create mode 100644 data/ig_sources.rda create mode 100644 data/model_sdtm.rda create mode 100644 man/ig_sources.Rd create mode 100644 man/model_sdtm.Rd create mode 100644 tests/testthat/helper-ig-exceptions.R create mode 100644 tests/testthat/test-ig_integrity.R create mode 100644 tests/testthat/test-ig_versions.R diff --git a/R/build_domain_spec.R b/R/build_domain_spec.R index 0bc7e1a..30af1ae 100644 --- a/R/build_domain_spec.R +++ b/R/build_domain_spec.R @@ -1,15 +1,16 @@ #' Build a variable specification for PP, SUPPPP, or ADPP #' -#' Combines \code{\link{get_ig}} (variable name, label, type, core, order) -#' with \code{\link{get_ct}} (codelist id lookup) into a single, ready-to-use -#' variable specification for one of the three PK datasets. \code{PP} and -#' \code{SUPPPP} draw on the SDTMIG (\code{SUPPPP} from the generic SUPP-- +#' Combines \code{\link{get_ig}} (variable name, label, type, core, order, +#' codelist) with \code{\link{get_ct}} (is that codelist in the controlled +#' terminology release) into a single, ready-to-use variable specification for +#' one of the three PK datasets. \code{PP} and \code{SUPPPP} draw on an +#' SDTM-side implementation guide (\code{SUPPPP} from the generic SUPP-- #' structure, since CDISC has no domain-specific SUPPPP table); \code{ADPP} -#' draws on the ADaMIG BDS (Basic Data Structure) table, since ADPP is a BDS -#' dataset and CDISC has no ADPP-specific table either, optionally unioned -#' with the ADaMIG ADSL table (see \code{adsl} below), since a real ADPP -#' also carries ADSL's subject-level variables, and optionally with the SDTM -#' PP domain's variables (see \code{sdtm_domain} below). +#' draws on the ADaMIG Basic Data Structure (BDS) table, since ADPP is a BDS +#' dataset and CDISC has no ADPP-specific table either. An ADPP spec can +#' optionally be unioned with the ADaMIG ADSL table (\code{adsl}), with a BDS +#' extension such as ADaMIG-NCA (\code{extension}), and with the SDTM PP +#' domain's variables (\code{sdtm_domain}). #' #' Neither the ADaMIG BDS nor ADSL tables define the PP-inherited #' traceability variables (\code{PPTESTCD}, \code{PPTEST}, and the rest of @@ -20,10 +21,9 @@ #' \code{sdtm_domain}, and the default leaves them out. #' #' @param domain One of \code{"PP"}, \code{"SUPPPP"}, or \code{"ADPP"}. -#' @param ig_version IG version to use: an SDTMIG version (for \code{PP}/ -#' \code{SUPPPP}) or an ADaMIG version (for \code{ADPP}). -#' \code{NULL} uses the newest available for that IG. -#' @param ct_version CT version to resolve codelist ids against; passed to +#' @param ig_version Version of \code{standard} to use. \code{NULL} uses the +#' newest available. +#' @param ct_version CT version to check codelist ids against; passed to #' \code{\link{get_ct}}. \code{NULL} uses the newest available. #' @param adsl For \code{domain = "ADPP"} only: whether to union in the #' ADaMIG ADSL variables (default \code{TRUE}), since a real ADPP dataset @@ -34,38 +34,66 @@ #' default) adds nothing; \code{"PP"} also unions in the SDTMIG PP #' domain's variables, the same way \code{adsl = TRUE} unions ADSL's: #' marked \code{source = "SDTMIG"}, \code{core} forced to \code{"Perm"}, -#' a variable already defined by BDS or ADSL (e.g. \code{STUDYID}, -#' \code{USUBJID}) keeping that version, and codelist ids resolved against -#' the ADaM CT first and the SDTM CT second. Ignored (with a warning) for -#' \code{domain != "ADPP"}; any value other than \code{"PP"} is an error. +#' a variable already defined keeping that version, and codelist ids +#' checked against the ADaM CT first and the SDTM CT second. Ignored (with +#' a warning) for \code{domain != "ADPP"}; any value other than +#' \code{"PP"} is an error. #' @param sdtmig_version SDTMIG version to take the \code{sdtm_domain} #' variables from. \code{NULL} uses the newest available. Ignored (with a #' warning) unless \code{domain = "ADPP"} and \code{sdtm_domain} is set. +#' @param standard The implementation guide to take the domain's variables +#' from. \code{NULL} (the default) uses \code{"SDTMIG"} for \code{PP} and +#' \code{SUPPPP} and \code{"ADaMIG"} for \code{ADPP}; any standard in +#' \code{\link{get_ig}} that has the domain works (e.g. \code{"SENDIG"} +#' defines \code{PP} too). +#' @param extension For \code{domain = "ADPP"} only: \code{NULL} (the +#' default) adds nothing; \code{"ADaMIG-NCA"} (or the alias \code{"NCA"}), +#' \code{"ADaM-popPK"}, or \code{"ADaM-BDS-TTE"} unions that BDS extension +#' onto the BDS variables. Unlike the ADSL and PP unions, the extension's +#' own Core designations are kept, as they are the point of the extension: a +#' new variable is appended with its published Core, and a variable the BDS +#' already defines takes the extension's (stronger) Core (e.g. \code{AVISIT} +#' becomes required in ADaMIG-NCA). Rows the extension touches are marked +#' with its name in \code{source}. Ignored (with a warning) for +#' \code{domain != "ADPP"}. +#' @param extension_version Version of the \code{extension}; \code{NULL} uses +#' the newest. Ignored (with a warning) unless \code{domain = "ADPP"} and +#' \code{extension} is set. #' @return A data frame with columns \code{variable}, \code{label}, -#' \code{type}, \code{length}, \code{core}, \code{order}, \code{source} -#' (\code{"SDTMIG"} for \code{PP}/\code{SUPPPP}; \code{"BDS"}, -#' \code{"ADSL"}, or \code{"SDTMIG"} for \code{ADPP}), and \code{codelist_id} (the codelist's -#' CT C-code, e.g. \code{"C85839"} for PPTESTCD's PKPARMCD codelist; -#' \code{NA} when the variable has no codelist or the referenced codelist -#' name is not found in the CT version used). ADSL-sourced \code{ADPP} rows -#' have \code{core} forced to \code{"Perm"} regardless of their Core -#' designation in ADSL itself: from ADPP's perspective, merging in an -#' ADSL variable is a common but optional choice, not a requirement ADSL's -#' own Core reflects. +#' \code{type}, \code{length}, \code{core}, \code{order}, \code{source}, and +#' \code{codelist_id}. \code{source} is \code{"SDTMIG"} (or the SDTM-side +#' \code{standard}) for \code{PP}/\code{SUPPPP}; \code{"BDS"}, +#' \code{"ADSL"}, \code{"SDTMIG"}, or the extension's name for \code{ADPP}. +#' \code{order} is the published order, renumbered consecutively, with +#' unioned variables following. \code{codelist_id} is the C-code of the +#' first codelist the IG lists for the variable, when that codelist is in +#' the CT release used, and \code{NA} otherwise (no codelist, or one not in +#' that release, e.g. a codelist since retired). \code{length} is always +#' \code{NA}: the CDISC Library exports this package is built from carry no +#' length, which is a sponsor choice, and the column is kept so existing +#' code that reads it keeps working. ADSL-sourced \code{ADPP} rows have +#' \code{core} forced to \code{"Perm"} regardless of their Core designation +#' in ADSL itself: from ADPP's perspective, merging in an ADSL variable is a +#' common but optional choice, not a requirement ADSL's own Core reflects. #' @export #' @examples #' build_domain_spec("PP") #' build_domain_spec("SUPPPP") #' build_domain_spec("ADPP") # BDS + ADSL (default) #' build_domain_spec("ADPP", adsl = FALSE) # BDS only -#' build_domain_spec("ADPP", sdtm_domain = "PP") # BDS + ADSL + PP variables +#' build_domain_spec("ADPP", sdtm_domain = "PP") # BDS + ADSL + PP variables +#' build_domain_spec("ADPP", extension = "NCA") # BDS + ADSL + ADaMIG-NCA build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), ig_version = NULL, ct_version = NULL, adsl = TRUE, sdtm_domain = NULL, - sdtmig_version = NULL) { + sdtmig_version = NULL, standard = NULL, + extension = NULL, extension_version = NULL) { domain <- match.arg(domain) if (domain == "ADPP") { - return(.spec_adpp(ig_version, ct_version, adsl, sdtm_domain, sdtmig_version)) + return(.spec_adpp( + standard %||% "ADaMIG", ig_version, ct_version, adsl, sdtm_domain, + sdtmig_version, extension, extension_version + )) } if (!isTRUE(adsl)) { @@ -80,21 +108,28 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), "sdtm_domain_ignored" ) } - rows <- .sdtmig_domain_rows(if (domain == "PP") "PP" else "SUPPQUAL", ig_version) + if (!is.null(extension) || !is.null(extension_version)) { + .cdiscdata_warn( + "`extension` and `extension_version` are ignored for domain != \"ADPP\".", + "extension_ignored" + ) + } + rows <- .sdtmig_domain_rows(if (domain == "PP") "PP" else "SUPPQUAL", + standard %||% "SDTMIG", ig_version) ct <- get_ct("sdtm", version = ct_version) - .spec_frame(rows, .lookup_codelist_id(rows$codelist, ct)) + .spec_frame(rows, .codelist_ids(rows$codelist_code, list(ct))) } # The columns of a variable spec, from any IG table's rows. -.spec_columns <- c("variable", "label", "type", "length", "core", "order", - "source", "codelist") +.spec_columns <- c("variable", "label", "type", "core", "order", "source", + "codelist_code") .spec_frame <- function(sub, codelist_id) { data.frame( variable = sub$variable, label = sub$label, type = sub$type, - length = sub$length, + length = rep(NA_integer_, nrow(sub)), core = sub$core, order = sub$order, source = sub$source, @@ -103,20 +138,34 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), ) } -# SDTMIG variables for one domain ("PP" or "SUPPQUAL") at `ig_version` -# (NULL = newest SDTMIG), marked source = "SDTMIG". -.sdtmig_domain_rows <- function(ig_domain, ig_version) { - sdtmig_all <- get_ig("sdtm") - sdtmig_all <- sdtmig_all[sdtmig_all$source == "SDTMIG", ] - version <- .resolve_ig_version(ig_version, sdtmig_all$version, "SDTMIG") - rows <- sdtmig_all[sdtmig_all$domain == ig_domain & sdtmig_all$version == version, ] +# The first codelist code of each IG codelist cell ("C85494; C128684" lists +# several), kept only if that codelist is in a controlled-terminology release: +# the first release in `cts` that has it decides, NA when none does. +.codelist_ids <- function(codelist_code, cts) { + first <- trimws(sub(";.*$", "", codelist_code)) + id <- rep(NA_character_, length(first)) + for (ct in cts) { + known <- unique(ct$codelist_code[is.na(ct$term_code)]) + hit <- is.na(id) & first %in% known + id[hit] <- first[hit] + } + id +} + +# SDTM-side IG variables for one domain ("PP" or "SUPPQUAL") of `standard` at +# `ig_version` (NULL = newest), marked with the standard as their source. +.sdtmig_domain_rows <- function(ig_domain, standard, ig_version) { + tbl <- get_ig(standard, version = ig_version) + rows <- tbl[tbl$domain == ig_domain, ] if (nrow(rows) == 0L) { .cdiscdata_abort( - paste0("No SDTMIG '", ig_domain, "' variables found for version '", version, "'."), + paste0("No ", standard, " '", ig_domain, "' variables found for version '", + unique(tbl$version), "'."), "no_ig_variables" ) } - rows$source <- "SDTMIG" + rows$source <- standard + rows$order <- seq_len(nrow(rows)) rows } @@ -133,7 +182,42 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), rbind(base[, .spec_columns], extra[, .spec_columns]) } -.spec_adpp <- function(ig_version, ct_version, adsl, sdtm_domain, sdtmig_version) { +# The BDS extensions that can be unioned onto an ADaMIG BDS spec; "NCA" is +# accepted as a short name for the first. +.adam_extensions <- c("ADaMIG-NCA", "ADaM-popPK", "ADaM-BDS-TTE") + +# Union a BDS extension onto `base`. Its Core designations are kept (they are +# the point of an extension): a variable `base` already has takes the +# extension's Core and is marked with the extension's name, a new one is +# appended with its published Core. +.apply_extension <- function(base, ext, source) { + ext$source <- source + hit <- match(ext$variable, base$variable) + known <- !is.na(hit) + base$core[hit[known]] <- ext$core[known] + base$source[hit[known]] <- source + new <- ext[!known, ] + new$order <- max(base$order) + seq_len(nrow(new)) + rbind(base[, .spec_columns], new[, .spec_columns]) +} + +.extension_rows <- function(extension, extension_version) { + extension <- switch(extension, NCA = "ADaMIG-NCA", extension) + if (!extension %in% .adam_extensions) { + .cdiscdata_abort( + paste0( + "`extension` must be NULL or one of ", + paste0("\"", c(.adam_extensions, "NCA"), "\"", collapse = ", "), + ", not '", extension, "'." + ), + "extension_unavailable" + ) + } + list(name = extension, rows = get_ig(extension, version = extension_version)) +} + +.spec_adpp <- function(standard, ig_version, ct_version, adsl, sdtm_domain, + sdtmig_version, extension, extension_version) { if (!is.null(sdtm_domain) && !identical(sdtm_domain, "PP")) { .cdiscdata_abort( paste0( @@ -147,69 +231,47 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), .cdiscdata_warn("`sdtmig_version` is ignored when `sdtm_domain` is NULL.", "sdtm_domain_ignored") } + if (is.null(extension) && !is.null(extension_version)) { + .cdiscdata_warn("`extension_version` is ignored when `extension` is NULL.", + "extension_ignored") + } + ext <- if (is.null(extension)) NULL else .extension_rows(extension, extension_version) - adamig_all <- get_ig("adam") - version <- .resolve_ig_version(ig_version, adamig_all$version, "ADaMIG") - bds <- adamig_all[adamig_all$dataset == "BDS" & adamig_all$version == version, ] + adam <- get_ig(standard, version = ig_version) + bds <- adam[adam$structure == .adam_structure_aliases[["BDS"]], ] if (nrow(bds) == 0L) { .cdiscdata_abort( - paste0("No ADaMIG BDS variables found for version '", version, "'."), + paste0("No ", standard, " BDS variables found for version '", + unique(adam$version), "'."), "no_ig_variables" ) } - bds$source <- "BDS" ct_adam <- get_ct("adam", version = ct_version) + bds$source <- "BDS" + bds$order <- seq_len(nrow(bds)) sub <- bds[, .spec_columns] if (isTRUE(adsl)) { - adsl_tbl <- adamig_all[adamig_all$dataset == "ADSL" & adamig_all$version == version, ] + adsl_tbl <- adam[adam$structure == .adam_structure_aliases[["ADSL"]], ] sub <- .append_unique(sub, adsl_tbl, "ADSL") } - if (!is.null(sdtm_domain)) { - sub <- .append_unique(sub, .sdtmig_domain_rows(sdtm_domain, sdtmig_version), "SDTMIG") + if (!is.null(ext)) { + sub <- .apply_extension(sub, ext$rows, ext$name) } - - codelist_id <- .lookup_codelist_id(sub$codelist, ct_adam) - if (isTRUE(adsl) || !is.null(sdtm_domain)) { - # ADSL variables carried from SDTM DM (SEX, RACE, AGEU, ...) and PP's own - # codelists (PKPARMCD, PKUNIT, ...) are SDTM CT, not ADaM's much smaller - # CT; ADaM CT is checked first (matching the BDS-only behaviour), SDTM CT - # second. - ct_sdtm <- get_ct("sdtm", version = ct_version) - fallback <- is.na(codelist_id) & !is.na(sub$codelist) - codelist_id[fallback] <- .lookup_codelist_id(sub$codelist[fallback], ct_sdtm) + if (!is.null(sdtm_domain)) { + sub <- .append_unique(sub, .sdtmig_domain_rows(sdtm_domain, "SDTMIG", sdtmig_version), + "SDTMIG") } - .spec_frame(sub, codelist_id) -} -# Resolve ig_version = NULL to the newest version present in `versions` -# (numeric comparison via package_version, so "1.10" would correctly rank -# above "1.9"); abort with the available list on an unknown explicit version. -.resolve_ig_version <- function(ig_version, versions, label) { - avail <- sort(unique(versions)) - if (is.null(ig_version)) { - return(as.character(max(package_version(avail)))) + cts <- list(ct_adam) + if (isTRUE(adsl) || !is.null(sdtm_domain) || !is.null(ext)) { + # ADSL variables carried from SDTM DM (SEX, RACE, AGEU, ...), PP's own + # codelists (PKPARMCD, PKUNIT, ...), and an extension's are SDTM CT, not + # ADaM's much smaller CT; ADaM CT is checked first, SDTM CT second. + cts <- c(cts, list(get_ct("sdtm", version = ct_version))) } - if (!ig_version %in% avail) { - .cdiscdata_abort( - paste0( - "Version '", ig_version, "' is not available for ", label, ". ", - "Available versions: ", paste(avail, collapse = ", "), "." - ), - "ig_version_unavailable" - ) - } - ig_version + .spec_frame(sub, .codelist_ids(sub$codelist_code, cts)) } -# Map codelist submission values (e.g. "PKPARMCD") to their CT C-code (e.g. -# "C85839") via the codelist header rows (term_code is NA for those). -# NA in `codelist_names` (no codelist referenced) and names not found in -# this CT version (e.g. a codelist introduced in a CT release older/newer -# than the one used) both resolve to NA, not an error: the caller decides -# whether an unresolved codelist id is acceptable. -.lookup_codelist_id <- function(codelist_names, ct) { - headers <- ct[is.na(ct$term_code), ] - headers <- headers[!duplicated(headers$codelist_name), ] - headers$codelist_code[match(codelist_names, headers$codelist_name)] -} +# NULL-coalescing, for optional arguments with a computed default. +`%||%` <- function(x, y) if (is.null(x)) y else x diff --git a/R/data.R b/R/data.R index da96b49..c59652e 100644 --- a/R/data.R +++ b/R/data.R @@ -35,92 +35,157 @@ #' @source \url{https://evs.nci.nih.gov/ftp1/CDISC/ADaM/} "ct_adam" -#' SDTM implementation-guide variable metadata -#' -#' Versioned SDTM Model and SDTMIG variable metadata: the Model's Findings -#' general-observation-class variables (versions 1.4-1.7); the SDTMIG PP -#' domain and generic SUPP-- qualifier structure (used for SUPPPP) at -#' versions 3.2 and 3.3, which share the same tables; and every domain of -#' SDTMIG 3.4 (63 domains, 1917 variables), transcribed from a CDISC Library -#' export that is not redistributed (see \code{\link{get_ig}} and -#' \code{data-raw/ig_source/README.md}). -#' Use \code{\link{get_ig}} to retrieve it, and +#' SDTM-side implementation-guide variable metadata +#' +#' One row per variable of every domain of seven implementation-guide +#' standards, at every version: SDTMIG (3.1.2, 3.1.3, 3.2, 3.3, 3.4), +#' SDTMIG-AP (1.0), SDTMIG-MD (1.0, 1.1), SENDIG (3.0, 3.1, 3.1.1), +#' SENDIG-AR (1.0), SENDIG-DART (1.1), and SENDIG-GeneTox (1.0); 14 standard +#' versions in all. Built from CDISC Library CSV exports that are not part of +#' this package or repository (see \code{\link{ig_sources}} and +#' \code{data-raw/README.md}); only variable metadata is carried, not the +#' guides' prose. Use \code{\link{get_ig}} to retrieve a standard, and #' \code{\link{build_domain_spec}} to build a ready-to-use PP/SUPPPP/ADPP -#' variable spec from it (joined to CT for codelist ids). +#' variable spec from it. The SDTM model itself is in +#' \code{\link{model_sdtm}}. +#' +#' A (standard, version, domain, variable) is unique. #' #' @format A data frame with columns: #' \describe{ -#' \item{source}{\code{"SDTM_MODEL"} or \code{"SDTMIG"}.} -#' \item{version}{SDTM Model version (\code{"1.4"}-\code{"1.7"}) for -#' \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"}, -#' \code{"3.3"}, or \code{"3.4"}) for \code{source == "SDTMIG"} rows. The two are independent numbering -#' systems; see \code{\link{get_ig}}.} -#' \item{class}{General observation class, e.g. \code{"Findings"}. -#' \code{NA} for \code{SDTMIG} 3.2 and 3.3 rows; populated for 3.4.} -#' \item{domain}{Domain: \code{"PP"} or \code{"SUPPQUAL"} for SDTMIG 3.2 -#' and 3.3; any of the 63 SDTMIG 3.4 domains (\code{"AE"}, \code{"LB"}, -#' \code{"SUPPQUAL"}, ...) for 3.4. \code{NA} for \code{SDTM_MODEL} -#' rows.} -#' \item{order}{Row order within its source table, as published.} +#' \item{standard}{The standard, e.g. \code{"SDTMIG"} or \code{"SENDIG-AR"}.} +#' \item{version}{The standard's version, e.g. \code{"3.4"}.} +#' \item{class}{General observation class, e.g. \code{"Findings"}.} +#' \item{domain}{Domain, e.g. \code{"PP"}, \code{"LB"}, \code{"SUPPQUAL"}.} +#' \item{order}{Position within the domain, as published.} #' \item{variable}{Variable name, e.g. \code{"PPTESTCD"}.} -#' \item{label}{Variable label.} +#' \item{label}{Variable label. At most 40 characters except for 22 labels +#' the guides themselves publish longer (see the data-integrity tests).} #' \item{type}{\code{"Char"} or \code{"Num"}.} -#' \item{role}{CDISC variable role, e.g. \code{"Topic"}. \code{NA} for -#' ADaM rows (not applicable, and not present in \code{ig_adam}).} -#' \item{core}{SDTMIG Core designation (\code{"Req"}/\code{"Exp"}/ -#' \code{"Perm"}). \code{NA} for \code{SDTM_MODEL} rows (the model does -#' not designate Core; that is an IG-level concept).} -#' \item{codelist}{Codelist submission value referenced by this variable -#' (e.g. \code{"PKPARMCD"}), parsed from the IG's free-text -#' "Controlled Terms" column. Look up its codelist C-code via -#' \code{\link{get_ct}}'s \code{codelist_name}/\code{codelist_code} -#' columns, as \code{\link{build_domain_spec}} does. \code{NA} when the -#' variable has no codelist, or the column instead names a format -#' (e.g. "ISO 8601") or an unspecified extensible list ("*").} -#' \item{length}{Maximum character length, when the IG text states one -#' explicitly (e.g. PPTESTCD's 8-character limit); \code{NA} otherwise, -#' since CDISC implementation guides do not otherwise publish a Length -#' column (length is a sponsor/define.xml choice).} -#' \item{notes}{CDISC Notes / Description text for the variable.} +#' \item{role}{CDISC variable role, e.g. \code{"Topic"}.} +#' \item{core}{Core designation (\code{"Req"}, \code{"Exp"}, +#' \code{"Perm"}, \code{"Cond"}, or the published \code{"Not used"}).} +#' \item{codelist_code}{CDISC CT codelist C-code(s) the variable uses, as +#' published; several are separated by \code{"; "} (e.g. PPORRESU lists +#' PKUNIT and four normalised-unit codelists). \code{NA} when none.} +#' \item{codelist_submission_values}{The codelist submission value(s), +#' where the export gives them (the SEND guides do; the SDTMIG exports do +#' not, so look the code up in \code{\link{get_ct}}).} +#' \item{described_value_domain}{A described value domain such as +#' \code{"ISO 8601"}, where the variable has one rather than a codelist.} +#' \item{value_list}{A fixed list of allowed values, e.g. the domain +#' abbreviation for \code{DOMAIN}.} #' } -#' @source \url{https://github.com/humanpred/Rsdtm}; see -#' \code{data-raw/ig_source/README.md} for full attribution. +#' @source CDISC Library CSV exports, downloaded under CDISC's terms and not +#' redistributed; see \code{data-raw/README.md}. "ig_sdtm" +#' SDTM model variable metadata +#' +#' One row per variable of the CDISC SDTM model, at every version: 1.2, 1.3, +#' 1.4, 1.5, 1.6, 1.7, 1.8, 2.0, and 2.1. Built from CDISC Library CSV exports +#' not redistributed with this package (see \code{\link{ig_sources}}); only +#' variable metadata is carried, not the model's descriptions, definitions, +#' notes, or examples. Retrieve it with \code{\link{get_ig}("SDTM")}. +#' +#' A (standard, version, class, dataset, variable) is unique. \code{dataset} +#' is \code{NA} for the general-observation-class variables (Events, +#' Findings, ...), which are defined once per class with a \code{--} prefix, +#' and set for the datasets the model defines outright (e.g. \code{"DM"}). +#' +#' @format A data frame with columns: +#' \describe{ +#' \item{standard}{Always \code{"SDTM"}.} +#' \item{version}{Model version, e.g. \code{"2.1"}.} +#' \item{class}{Observation class or dataset class, e.g. +#' \code{"Findings"}, \code{"Trial Design"}.} +#' \item{dataset}{Dataset name, or \code{NA} for class-level variables.} +#' \item{order}{Position within the class/dataset, as published.} +#' \item{variable}{Variable name, e.g. \code{"--TESTCD"}.} +#' \item{label}{Variable label. \code{"--TESTCD"} is published at 46 +#' characters in model versions 1.2 to 1.6.} +#' \item{type}{\code{"Char"} or \code{"Num"}.} +#' \item{role}{CDISC variable role.} +#' \item{described_value_domain}{A described value domain, e.g. +#' \code{"ISO 8601"}; sparse before version 2.0.} +#' \item{variables_qualified}{The variable(s) this one qualifies.} +#' \item{usage_restrictions}{Usage restrictions on the variable; version +#' 2.0 and later, \code{NA} before.} +#' \item{variable_code}{The variable's NCI C-code; version 2.0 and later, +#' \code{NA} before.} +#' } +#' @source CDISC Library CSV exports, downloaded under CDISC's terms and not +#' redistributed; see \code{data-raw/README.md}. +"model_sdtm" + #' ADaM implementation-guide variable metadata #' -#' Versioned ADaMIG variable metadata: the ADSL (subject-level) variable -#' table and the generic BDS (Basic Data Structure) variable table (used for -#' ADPP, a BDS-structured dataset), for ADaMIG versions 1.0, 1.1, and 1.2. -#' Use \code{\link{get_ig}} to retrieve it, and -#' \code{\link{build_domain_spec}} to build a ready-to-use ADPP variable -#' spec from it (joined to CT for codelist ids). +#' One row per variable of seven ADaM standards, at every version: ADaMIG +#' (1.0, 1.1, 1.2, 1.3), ADaMIG-MD (1.0), ADaMIG-NCA (1.0), ADaM-ADAE (1.0), +#' ADaM-BDS-TTE (1.0), ADaM-OCCDS (1.0, 1.1), and ADaM-popPK (1.0); 11 standard +#' versions in all. Built from CDISC Library CSV exports that are not part of +#' this package or repository (see \code{\link{ig_sources}} and +#' \code{data-raw/README.md}); only variable metadata is carried, not the +#' guides' prose. Use \code{\link{get_ig}} to retrieve a standard, and +#' \code{\link{build_domain_spec}} to build an ADPP variable spec from it +#' (ADPP is a Basic Data Structure dataset; ADaMIG-NCA extends it). +#' +#' A (standard, version, structure, variable_set, variable) is unique: the +#' variable set is part of the key because ADaM-OCCDS defines \code{DECDORGw} +#' twice, once for each dictionary-specific variable set, with different +#' labels. #' #' @format A data frame with columns: #' \describe{ -#' \item{dataset}{\code{"ADSL"} or \code{"BDS"}.} -#' \item{version}{ADaMIG version, e.g. \code{"1.2"}.} -#' \item{category}{The Rsdtm source file's variable-category name (e.g. -#' \code{"ADSL_Treatment_Variables"}, \code{"Timing_Variables_BDS_Datasets"}), -#' kept for provenance; ADaMIG itself does not group these tables this -#' way.} -#' \item{order}{Row order within its category file, as published.} +#' \item{standard}{The standard, e.g. \code{"ADaMIG"} or +#' \code{"ADaMIG-NCA"}.} +#' \item{version}{The standard's version, e.g. \code{"1.3"}.} +#' \item{structure}{The data structure, as named in the export, e.g. +#' \code{"Basic Data Structure"} or \code{"Subject-Level Analysis +#' Dataset"} (ADSL).} +#' \item{variable_set}{The variable set within the structure, e.g. +#' \code{"Timing"}.} +#' \item{order}{Row order within the export for that standard version.} #' \item{variable}{Variable name, e.g. \code{"AVAL"}.} -#' \item{label}{Variable label.} +#' \item{label}{Variable label. At most 40 characters except +#' \code{PBCHGCyN} in ADaMIG 1.2 and 1.3, which the guide publishes at 41.} #' \item{type}{\code{"Char"} or \code{"Num"}.} -#' \item{core}{ADaMIG Core designation (\code{"Req"}/\code{"Exp"}/ -#' \code{"Perm"}/\code{"Cond"}).} -#' \item{codelist}{Codelist submission value referenced by this variable, -#' parsed the same way as \code{\link{ig_sdtm}}'s \code{codelist} -#' column; see there for details and caveats.} -#' \item{length}{Maximum character length when the IG text states one -#' explicitly; \code{NA} otherwise. See \code{\link{ig_sdtm}}.} -#' \item{notes}{CDISC Notes text for the variable.} +#' \item{core}{Core designation (\code{"Req"}, \code{"Perm"}, +#' \code{"Cond"}, ...).} +#' \item{codelist_code}{CDISC CT codelist C-code(s) the variable uses; +#' several are separated by \code{"; "}. \code{NA} when none.} +#' \item{codelist_submission_values}{The codelist submission value(s), +#' where the export gives them.} +#' \item{described_value_domain}{A described value domain, where the +#' variable has one rather than a codelist.} +#' \item{value_list}{A fixed list of allowed values, where there is one.} #' } -#' @source \url{https://github.com/humanpred/Rsdtm}; see -#' \code{data-raw/ig_source/README.md} for full attribution. +#' @source CDISC Library CSV exports, downloaded under CDISC's terms and not +#' redistributed; see \code{data-raw/README.md}. "ig_adam" +#' The CDISC Library exports the IG and model datasets were built from +#' +#' One row per export file read by \code{data-raw/build_ig.R}, so which +#' standard versions are bundled, and from exactly which files, is itself +#' data. The files are not part of this package or repository. +#' +#' @format A data frame with 34 rows and columns: +#' \describe{ +#' \item{file}{The export's file name.} +#' \item{version_string}{The export's \code{Version} value, e.g. +#' \code{"ADaMIG MD v1.0"}.} +#' \item{standard}{The canonical standard name parsed from it.} +#' \item{version}{The version number parsed from it.} +#' \item{table}{The dataset it was loaded into: \code{"ig_sdtm"}, +#' \code{"model_sdtm"}, or \code{"ig_adam"}.} +#' \item{rows}{Data rows in the file, equal to the rows loaded from it.} +#' \item{md5}{MD5 checksum of the file, to tell whether a rebuild used the +#' same export.} +#' } +#' @source CDISC Library CSV exports; see \code{data-raw/README.md}. +"ig_sources" + #' Datasets catalogue #' #' Metadata about all datasets bundled in \code{cdiscdata}, including CT @@ -129,7 +194,8 @@ #' @format A data frame with columns: #' \describe{ #' \item{dataset}{R object name or logical dataset identifier.} -#' \item{type}{One of \code{"CT"}, \code{"Schema"}, \code{"Stylesheet"}.} +#' \item{type}{One of \code{"CT"}, \code{"IG"}, \code{"Model"}, +#' \code{"Schema"}, \code{"Stylesheet"}.} #' \item{ct_type}{One of \code{"sdtm"}, \code{"adam"}, or \code{NA} for #' non-CT datasets.} #' \item{description}{Human-readable description.} diff --git a/R/get_dataset.R b/R/get_dataset.R index 45abc68..4c6061b 100644 --- a/R/get_dataset.R +++ b/R/get_dataset.R @@ -1,20 +1,26 @@ #' Retrieve any cdiscdata dataset by name and version #' #' Generic retrieval gateway. For CT datasets, filters to rows valid at -#' the requested version date. For schemas and stylesheets, returns the -#' file path for the requested Define-XML version. Use \code{\link{list_datasets}} -#' to see available dataset names. +#' the requested version date. For the implementation-guide and model datasets +#' (\code{ig_sdtm}, \code{model_sdtm}, \code{ig_adam}), returns the whole +#' table, or the rows whose \code{version} column equals \code{version} (across +#' every standard in it; use \code{\link{get_ig}} to pick one standard). For +#' schemas and stylesheets, returns the file path for the requested Define-XML +#' version. Use \code{\link{list_datasets}} to see available dataset names. #' #' @param name Dataset name from \code{\link{list_datasets}()$dataset}. -#' @param version Version string. \code{NULL} returns the latest available -#' version. For CT: a date string e.g. \code{"2024-09-27"}. For -#' schemas/stylesheets: a Define-XML version string e.g. \code{"2.1"}. -#' @return A data frame (for CT data) or a file path string (for -#' schemas/stylesheets). +#' @param version Version string. For CT, \code{NULL} returns the latest +#' available version and a value is a date string e.g. \code{"2024-09-27"}. +#' For schemas/stylesheets, \code{NULL} is the latest and a value is a +#' Define-XML version string e.g. \code{"2.1"}. For the IG and model datasets, +#' \code{NULL} returns every version. +#' @return A data frame (for CT, IG, and model data) or a file path string +#' (for schemas/stylesheets). #' @export #' @examples #' get_dataset("ct_sdtm") #' get_dataset("ct_sdtm", version = "2024-09-27") +#' get_dataset("ig_adam", version = "1.3") #' get_dataset("define_xml_schema", version = "2.1") #' get_dataset("define_xml_stylesheet", version = "2.0") get_dataset <- function(name, version = NULL) { @@ -31,11 +37,33 @@ get_dataset <- function(name, version = NULL) { switch(cat_row$type, "CT" = .get_ct_dataset(name, version), + "IG" = .get_ig_dataset(name, version), + "Model" = .get_ig_dataset(name, version), "Schema" = schema_path(.resolve_schema_version(version)), "Stylesheet" = stylesheet_path(.resolve_schema_version(version)) ) } +# Internal: an IG or model table, whole or restricted to one version string +.get_ig_dataset <- function(name, version) { + tbl <- .pkg_data(name) + if (is.null(version)) { + return(tbl) + } + avail <- unique(tbl$version) + avail <- avail[order(package_version(avail))] + if (!version %in% avail) { + .cdiscdata_abort( + paste0( + "Version '", version, "' is not available in ", name, ". ", + "Available versions: ", paste(avail, collapse = ", "), "." + ), + "ig_version_unavailable" + ) + } + tbl[tbl$version == version, ] +} + # Internal: filter CT table to a specific version date .get_ct_dataset <- function(name, version) { tbl <- .pkg_data(name) diff --git a/R/get_ig.R b/R/get_ig.R index a607121..5b5d452 100644 --- a/R/get_ig.R +++ b/R/get_ig.R @@ -1,79 +1,120 @@ -#' Retrieve CDISC implementation-guide variable metadata +#' Retrieve CDISC implementation-guide or model variable metadata #' -#' Mirrors \code{\link{get_ct}}, but for implementation-guide (IG) variable -#' metadata rather than controlled terminology. Unlike CT, which uses a -#' single validity-date timeline per standard, \code{ig_sdtm} bundles two -#' independently-versioned sources (the SDTM Model and the SDTMIG; see -#' \code{\link{ig_sdtm}}), so there is no single "latest" snapshot to default -#' to: \code{version = NULL} returns every source and version, for the -#' caller to filter further (by \code{source}/\code{domain}/\code{class} for -#' \code{ig_sdtm}, or \code{dataset}/\code{category} for \code{ig_adam}). -#' \code{\link{build_domain_spec}} does this filtering for the PP, SUPPPP, -#' and ADPP datasets specifically. +#' One accessor over every standard in \code{\link{ig_sdtm}}, +#' \code{\link{model_sdtm}}, and \code{\link{ig_adam}}, mirroring +#' \code{\link{get_ct}}. The standard is chosen with \code{standard}; the +#' version defaults to that standard's newest. #' -#' \strong{SDTMIG coverage.} SDTMIG 3.2 and 3.3 carry only the PP domain and -#' the generic SUPP-- structure; version 3.3 reuses the 3.2 tables, since the -#' published SDTMIG v3.3 stamps its PP specification "Version 3.2" (unchanged -#' since 3.2) and its SUPP-- specification has the same ten variables. Both -#' include \code{TAETORD}, \code{EPOCH}, and \code{PPDY}, which the Rsdtm -#' transcription of 3.2 this package copies from omitted. SDTMIG 3.4 carries -#' every one of its 63 domains, from a CDISC Library export (names, labels, -#' types, codelists, roles, Core, and order; the export's CDISC Notes text is -#' not included, so \code{notes} is \code{NA} for those rows). Its PP table -#' adds \code{PPANMETH} and \code{PPTPTREF}. \code{PPDTC} (not -#' \code{PPPDTC}) is the published name of the date/time-of-calculation -#' variable in all three versions. See \code{data-raw/ig_source/README.md}. +#' The standards, and the dataset each is stored in: +#' \itemize{ +#' \item \code{"SDTM"} (model versions 1.2 to 2.1): \code{\link{model_sdtm}}. +#' \item \code{"SDTMIG"} (3.1.2 to 3.4), \code{"SDTMIG-AP"}, +#' \code{"SDTMIG-MD"}, \code{"SENDIG"} (3.0 to 3.1.1), +#' \code{"SENDIG-AR"}, \code{"SENDIG-DART"}, \code{"SENDIG-GeneTox"}: +#' \code{\link{ig_sdtm}}. +#' \item \code{"ADaMIG"} (1.0 to 1.3), \code{"ADaMIG-MD"}, +#' \code{"ADaMIG-NCA"}, \code{"ADaM-ADAE"}, \code{"ADaM-BDS-TTE"}, +#' \code{"ADaM-OCCDS"}, \code{"ADaM-popPK"}: \code{\link{ig_adam}}. +#' } +#' The lower-case names \code{"sdtm"} and \code{"adam"}, the only values the +#' first argument took before it named a standard, are kept as aliases for the +#' defaults \code{"SDTMIG"} and \code{"ADaMIG"} (note \code{"SDTM"} in capitals +#' is the model, not the implementation guide). #' -#' @param standard One of \code{"sdtm"} or \code{"adam"}. -#' @param version A version string present in the \code{version} column -#' (e.g. \code{"3.2"} for SDTMIG, \code{"1.7"} for the SDTM Model, -#' \code{"1.2"} for ADaMIG). \code{NULL} (the default) returns all -#' versions. -#' @param domain Restrict to one domain/dataset: for \code{"sdtm"}, the -#' \code{domain} column (\code{"PP"} or \code{"SUPPQUAL"} at SDTMIG -#' 3.2 and 3.3, any of 63 domains at 3.4; SDTM Model rows have no domain -#' and are excluded); for \code{"adam"}, the -#' \code{dataset} column (\code{"ADSL"} or \code{"BDS"}). \code{NULL} -#' (the default) applies no domain filter. -#' @return A data frame: \code{\link{ig_sdtm}} or \code{\link{ig_adam}}, -#' optionally filtered to one version and/or domain. +#' All of this comes from CDISC Library CSV exports that are not part of this +#' package or repository (see \code{\link{ig_sources}} for exactly which +#' files, and \code{data-raw/README.md}). Only variable metadata is carried; +#' the guides' prose (CDISC Notes, Description, Definition, Examples) is not. +#' +#' @param standard One standard from the list above (default +#' \code{"SDTMIG"}), or the alias \code{"sdtm"} or \code{"adam"}. +#' @param version A version string of that standard (e.g. \code{"3.4"}). +#' \code{NULL} (the default) uses the newest, compared numerically, so +#' \code{"3.1.3"} ranks below \code{"3.2"}. +#' @param domain Restrict to one domain or structure. For the +#' implementation-guide standards in \code{\link{ig_sdtm}}, the +#' \code{domain} column (e.g. \code{"PP"}); for \code{"SDTM"}, a +#' \code{class} (e.g. \code{"Findings"}) or a \code{dataset} (e.g. +#' \code{"DM"}); for the ADaM standards, the \code{structure} column, where +#' \code{"BDS"} and \code{"ADSL"} are accepted as aliases for +#' \code{"Basic Data Structure"} and \code{"Subject-Level Analysis +#' Dataset"}. \code{NULL} (the default) applies no filter. +#' @return A data frame: the rows of \code{\link{ig_sdtm}}, +#' \code{\link{model_sdtm}}, or \code{\link{ig_adam}} for that standard, +#' version, and domain. An unknown standard, version, or domain is a classed +#' error (\code{cdiscdata_error_ig_standard_unavailable}, +#' \code{cdiscdata_error_ig_version_unavailable}, +#' \code{cdiscdata_error_ig_domain_unavailable}). #' @export #' @examples -#' get_ig("sdtm") -#' get_ig("sdtm", version = "3.3", domain = "PP") -#' get_ig("adam", version = "1.2", domain = "BDS") -get_ig <- function(standard = c("sdtm", "adam"), version = NULL, domain = NULL) { - standard <- match.arg(standard) - tbl <- .pkg_data(paste0("ig_", standard)) +#' get_ig() # newest SDTMIG (3.4) +#' get_ig("SDTMIG", version = "3.3", domain = "PP") +#' get_ig("SENDIG", domain = "PP") +#' get_ig("ADaMIG", domain = "BDS") +#' get_ig("ADaMIG-NCA") +#' get_ig("SDTM", version = "2.1", domain = "Findings") +get_ig <- function(standard = "SDTMIG", version = NULL, domain = NULL) { + standard <- .resolve_ig_standard(standard) + table <- .ig_standards$table[match(standard, .ig_standards$standard)] + tbl <- .pkg_data(table) + tbl <- tbl[tbl$standard == standard, ] - if (!is.null(version)) { - avail <- sort(unique(tbl$version)) - if (!version %in% avail) { - .cdiscdata_abort( - paste0( - "Version '", version, "' is not available for standard '", standard, "'. ", - "Available versions: ", paste(avail, collapse = ", "), "." - ), - "ig_version_unavailable" - ) - } - tbl <- tbl[tbl$version == version, ] + version <- .resolve_ig_version(version, tbl$version, standard) + tbl <- tbl[tbl$version == version, ] + + if (is.null(domain)) { + return(tbl) + } + .filter_ig_domain(tbl, table, domain, standard, version) +} + +# "sdtm"/"adam" are the pre-redesign first-argument values; any other value +# must be one of the canonical standard names. +.resolve_ig_standard <- function(standard) { + if (!is.character(standard) || length(standard) != 1L || is.na(standard)) { + .cdiscdata_abort("`standard` must be a single string.", "ig_standard_unavailable") + } + standard <- switch(standard, sdtm = "SDTMIG", adam = "ADaMIG", standard) + if (!standard %in% .ig_standards$standard) { + .cdiscdata_abort( + paste0( + "Standard '", standard, "' is not available. Available standards: ", + paste(.ig_standards$standard, collapse = ", "), "." + ), + "ig_standard_unavailable" + ) } + standard +} - if (!is.null(domain)) { - domain_col <- if (standard == "sdtm") "domain" else "dataset" - avail <- sort(unique(tbl[[domain_col]])) - if (!domain %in% avail) { - .cdiscdata_abort( - paste0( - "Domain '", domain, "' is not available for standard '", standard, "'", - if (!is.null(version)) paste0(" at version '", version, "'"), - ". Available: ", if (length(avail)) paste(avail, collapse = ", ") else "none", "." - ), - "ig_domain_unavailable" - ) +# Short names for the two ADaM structures people ask for most. +.adam_structure_aliases <- c( + BDS = "Basic Data Structure", + ADSL = "Subject-Level Analysis Dataset" +) + +.filter_ig_domain <- function(tbl, table, domain, standard, version) { + if (table == "model_sdtm") { + avail <- sort(unique(c(tbl$class, tbl$dataset))) + keep <- tbl$class %in% domain | tbl$dataset %in% domain + } else { + column <- if (table == "ig_adam") "structure" else "domain" + if (table == "ig_adam") { + domain <- ifelse(domain %in% names(.adam_structure_aliases), + .adam_structure_aliases[domain], domain) } - tbl <- tbl[tbl[[domain_col]] %in% domain, ] + avail <- sort(unique(tbl[[column]])) + keep <- tbl[[column]] %in% domain + } + if (!all(domain %in% avail)) { + .cdiscdata_abort( + paste0( + "Domain '", paste(setdiff(domain, avail), collapse = "', '"), + "' is not available for standard '", standard, "' at version '", version, + "'. Available: ", paste(avail, collapse = ", "), "." + ), + "ig_domain_unavailable" + ) } - tbl + tbl[keep, ] } diff --git a/R/ig_versions.R b/R/ig_versions.R new file mode 100644 index 0000000..8046cf4 --- /dev/null +++ b/R/ig_versions.R @@ -0,0 +1,74 @@ +# The standards the IG/model datasets cover, how each is written in the +# "Version" column of a CDISC Library CSV export, and which dataset holds it. +# +# The export writes the standard with spaces ("ADaMIG MD v1.0", "ADaM BDS for +# TTE v1.0"), not the hyphenated names CDISC uses elsewhere; this table is the +# one place those are mapped to the canonical name stored in `standard`. +.ig_standards <- data.frame( + raw = c( + "SDTM", + "SDTMIG", "SDTMIG-AP", "SDTMIG-MD", + "SENDIG", "SENDIG-AR", "SENDIG-DART", "SENDIG-GeneTox", + "ADaMIG", "ADaMIG MD", "ADaMIG NCA", "ADaM ADAE", "ADaM BDS for TTE", + "ADaM OCCDS", "ADaM popPK" + ), + standard = c( + "SDTM", + "SDTMIG", "SDTMIG-AP", "SDTMIG-MD", + "SENDIG", "SENDIG-AR", "SENDIG-DART", "SENDIG-GeneTox", + "ADaMIG", "ADaMIG-MD", "ADaMIG-NCA", "ADaM-ADAE", "ADaM-BDS-TTE", + "ADaM-OCCDS", "ADaM-popPK" + ), + table = c( + "model_sdtm", + rep("ig_sdtm", 7L), + rep("ig_adam", 7L) + ), + stringsAsFactors = FALSE +) + +# Split "Version" strings such as "SDTMIG-MD v1.1" or "ADaM BDS for TTE v1.0" +# into the canonical standard and the version number. Vectorised; an +# unrecognised string is an error, never a guess. +.parse_ig_version <- function(x) { + parts <- regmatches(x, regexec("^(.+) v([0-9]+([.][0-9]+)*)$", x)) + raw <- vapply(parts, function(p) if (length(p)) p[[2L]] else NA_character_, "") + version <- vapply(parts, function(p) if (length(p)) p[[3L]] else NA_character_, "") + standard <- .ig_standards$standard[match(raw, .ig_standards$raw)] + + bad <- is.na(x) | is.na(standard) + if (any(bad)) { + .cdiscdata_abort( + paste0( + "Cannot parse IG version string(s): ", + paste0("'", x[bad], "'", collapse = ", "), + ". Expected ' v' with a standard in: ", + paste(.ig_standards$raw, collapse = ", "), "." + ), + "ig_version_unparsable" + ) + } + data.frame(standard = standard, version = version, stringsAsFactors = FALSE) +} + +# Resolve version = NULL to the newest version present in `versions` +# (numeric comparison via package_version, so "1.10" ranks above "1.9" and +# "3.1.3" below "3.2"); abort with the available list, in numeric order, on an +# unknown explicit version. +.resolve_ig_version <- function(version, versions, label) { + avail <- unique(versions) + avail <- avail[order(package_version(avail))] + if (is.null(version)) { + return(avail[[length(avail)]]) + } + if (!version %in% avail) { + .cdiscdata_abort( + paste0( + "Version '", version, "' is not available for ", label, ". ", + "Available versions: ", paste(avail, collapse = ", "), "." + ), + "ig_version_unavailable" + ) + } + version +} diff --git a/R/utils.R b/R/utils.R index ab5c925..3ecea34 100644 --- a/R/utils.R +++ b/R/utils.R @@ -2,7 +2,8 @@ # Suppress R CMD check notes about lazy-loaded package data objects # that are not visible to the static checker. -utils::globalVariables(c("ct_sdtm", "ct_adam", "ig_sdtm", "ig_adam", "datasets_catalogue")) +utils::globalVariables(c("ct_sdtm", "ct_adam", "ig_sdtm", "model_sdtm", "ig_adam", + "ig_sources", "datasets_catalogue")) # Retrieve one of the package's own lazy-loaded datasets (ct_sdtm, ct_adam, # datasets_catalogue, ...) regardless of whether cdiscdata is attached. diff --git a/data-raw/build_catalogue.R b/data-raw/build_catalogue.R index e2513ef..938eb65 100644 --- a/data-raw/build_catalogue.R +++ b/data-raw/build_catalogue.R @@ -1,8 +1,8 @@ # Rebuild the datasets_catalogue object after any data update. -# Called at the end of fetch_all.R (CT), and after build_ig_sdtm.R / -# build_ig_adam.R (IG metadata, which fetch_all.R does not touch). -# Requires ct_sdtm, ct_adam, ig_sdtm, and ig_adam to be loaded in the -# environment (e.g. via load("data/ct_sdtm.rda") or a prior build script). +# Called at the end of fetch_all.R (CT), and after build_ig.R (IG and model +# metadata, which fetch_all.R does not touch). +# Requires ct_sdtm, ct_adam, ig_sdtm, model_sdtm, and ig_adam to be loaded in +# the environment (e.g. via load("data/ct_sdtm.rda") or a prior build script). build_version_range <- function(x) { x <- sort(unique(x)) @@ -36,36 +36,42 @@ ct_entries <- data.frame( stringsAsFactors = FALSE ) -# ── IG entries ──────────────────────────────────────────────────────────────── -# ig_sdtm bundles two independently-versioned sources (SDTM Model, SDTMIG; -# see R/data.R), so its version range is reported per source rather than as -# one min/max across both numbering systems. -ig_sdtm_model_versions <- sort(unique(ig_sdtm$version[ig_sdtm$source == "SDTM_MODEL"])) -ig_sdtm_ig_versions <- sort(unique(ig_sdtm$version[ig_sdtm$source == "SDTMIG"])) -ig_adam_versions <- sort(unique(ig_adam$version)) +# ── IG and model entries ────────────────────────────────────────────────────── +# Each of these tables holds several standards, each with its own version +# numbering, so the version range is reported per standard ("SDTMIG 3.1.2 to +# 3.4; SDTMIG-AP 1.0; ..."), n_versions counts (standard, version) pairs, and +# `latest` is NA because there is no single latest across standards. +describe_standards <- function(tbl) { + parts <- vapply(split(tbl$version, tbl$standard), function(v) { + v <- unique(v) + v <- v[order(package_version(v))] + if (length(v) == 1L) v else paste(v[[1L]], "to", v[[length(v)]]) + }, character(1L)) + parts <- parts[unique(tbl$standard)] + paste(paste(names(parts), parts), collapse = "; ") +} +count_versions <- function(tbl) nrow(unique(tbl[c("standard", "version")])) ig_entries <- data.frame( - dataset = c("ig_sdtm", "ig_adam"), - type = c("IG", "IG"), + dataset = c("ig_sdtm", "model_sdtm", "ig_adam"), + type = c("IG", "Model", "IG"), ct_type = NA_character_, description = c( - "SDTM Model + SDTMIG variable metadata", - "ADaMIG ADSL + BDS variable metadata" + "SDTMIG, SENDIG and related SDTM-side implementation-guide variable metadata", + "SDTM model variable metadata", + "ADaMIG and related ADaM implementation-guide variable metadata" ), versions = c( - sprintf("Model %s (SDTMIG %s)", - build_version_range(ig_sdtm_model_versions), - paste(ig_sdtm_ig_versions, collapse = ", ")), - build_version_range(ig_adam_versions) + describe_standards(ig_sdtm), + describe_standards(model_sdtm), + describe_standards(ig_adam) ), n_versions = c( - length(ig_sdtm_model_versions) + length(ig_sdtm_ig_versions), - length(ig_adam_versions) - ), - latest = c( - max(ig_sdtm_model_versions), - as.character(max(package_version(ig_adam_versions))) + count_versions(ig_sdtm), + count_versions(model_sdtm), + count_versions(ig_adam) ), + latest = NA_character_, last_updated = Sys.Date(), stringsAsFactors = FALSE ) diff --git a/data-raw/build_ig.R b/data-raw/build_ig.R new file mode 100644 index 0000000..ab134de --- /dev/null +++ b/data-raw/build_ig.R @@ -0,0 +1,115 @@ +# Build ig_sdtm, model_sdtm, ig_adam, and ig_sources from the 34 CDISC Library +# CSV exports (SDTM model, SDTMIG family, SENDIG family, ADaMIG family). +# +# Run from the package root: +# CDISC_SOURCES_DIR=/path/to/exports Rscript data-raw/build_ig.R +# +# The exports are NOT in this repository and are never committed: they were +# downloaded under CDISC's own terms and conditions (see data-raw/README.md). +# This script reads them from CDISC_SOURCES_DIR (default "../cdisc-sources") +# and stops with a message listing the expected files if any is missing. Only +# variable metadata is transcribed (names, labels, types, roles, Core, +# codelists, order); the guide prose columns (CDISC Notes, Description, +# Definition, Notes, Examples) are never read into the data. +# +# Sourced by nothing else; the output is data/ig_sdtm.rda, data/model_sdtm.rda, +# data/ig_adam.rda, and data/ig_sources.rda. Re-run build_catalogue.R after. + +# The version parser and the classed-condition helpers live in the package +# (R/ig_versions.R, R/utils.R) so tests can exercise them. +pkgload::load_all(".", quiet = TRUE) +source("data-raw/utils_ig.R") + +paths <- cdisc_source_paths() + +read_one <- function(file) { + e <- read_library_export(paths[[file]]) + parsed <- .parse_ig_version(e$version_string) + rows <- switch( + e$shape, + ig_sdtm = ig_sdtm_rows(e$data, parsed), + model_v1 = model_sdtm_rows(e$data, parsed), + model_v2 = model_sdtm_rows(e$data, parsed), + ig_adam = ig_adam_rows(e$data, parsed) + ) + stopifnot(nrow(rows) == nrow(e$data)) + list( + rows = rows, + source = data.frame( + file = file, + version_string = e$version_string, + standard = parsed$standard, + version = parsed$version, + table = .ig_standards$table[match(parsed$standard, .ig_standards$standard)], + rows = nrow(e$data), + md5 = unname(tools::md5sum(paths[[file]])), + stringsAsFactors = FALSE + ) + ) +} + +loaded <- lapply(ig_source_files, read_one) +ig_sources <- do.call(rbind, lapply(loaded, `[[`, "source")) +rownames(ig_sources) <- NULL + +# Every file is one distinct (standard, version): none loaded twice or missing. +stopifnot( + length(loaded) == 34L, + !anyDuplicated(paste(ig_sources$standard, ig_sources$version)), + !anyDuplicated(ig_sources$file) +) + +# Order standards as in the parser table and versions numerically. +std_rank <- match(ig_sources$standard, .ig_standards$standard) +ig_sources <- ig_sources[order(std_rank, package_version(ig_sources$version)), ] +rownames(ig_sources) <- NULL +loaded <- loaded[match(ig_sources$file, ig_source_files)] + +bind_table <- function(table) { + parts <- loaded[ig_sources$table == table] + out <- do.call(rbind, lapply(parts, `[[`, "rows")) + rownames(out) <- NULL + out +} +ig_sdtm <- bind_table("ig_sdtm") +model_sdtm <- bind_table("model_sdtm") +ig_adam <- bind_table("ig_adam") + +# Rows kept per (standard, version) equal the rows in the file it came from. +check_rows <- function(tbl, which_table) { + src <- ig_sources[ig_sources$table == which_table, ] + got <- table(paste(tbl$standard, tbl$version)) + stopifnot(identical( + as.integer(got[paste(src$standard, src$version)]), as.integer(src$rows) + )) +} +check_rows(ig_sdtm, "ig_sdtm") +check_rows(model_sdtm, "model_sdtm") +check_rows(ig_adam, "ig_adam") + +# Identifying fields are never NA, and every key is unique. Keys: +# - ig_sdtm: (standard, version, domain, variable) +# - model_sdtm: (standard, version, class, dataset, variable); dataset is NA +# for the observation-class variables, so the class is part of the key +# - ig_adam: (standard, version, structure, variable_set, variable); OCCDS +# defines DECDORGw once per dictionary-specific variable set, so the set is +# part of the key +key <- function(tbl, cols) do.call(paste, c(lapply(tbl[cols], as.character), sep = "\r")) +stopifnot( + !anyNA(ig_sdtm[c("standard", "version", "domain", "variable", "label")]), + !anyNA(model_sdtm[c("standard", "version", "class", "variable", "label")]), + !anyNA(ig_adam[c("standard", "version", "structure", "variable_set", "variable", "label")]), + !anyDuplicated(key(ig_sdtm, c("standard", "version", "domain", "variable"))), + !anyDuplicated(key(model_sdtm, c("standard", "version", "class", "dataset", "variable"))), + !anyDuplicated(key(ig_adam, c("standard", "version", "structure", "variable_set", "variable"))) +) + +usethis::use_data(ig_sdtm, model_sdtm, ig_adam, ig_sources, + overwrite = TRUE, compress = "xz") +message(sprintf( + "ig_sdtm: %d rows (%d standard versions); model_sdtm: %d rows (%d); ig_adam: %d rows (%d); ig_sources: %d files.", + nrow(ig_sdtm), sum(ig_sources$table == "ig_sdtm"), + nrow(model_sdtm), sum(ig_sources$table == "model_sdtm"), + nrow(ig_adam), sum(ig_sources$table == "ig_adam"), + nrow(ig_sources) +)) diff --git a/data-raw/build_ig_adam.R b/data-raw/build_ig_adam.R deleted file mode 100644 index 844e25d..0000000 --- a/data-raw/build_ig_adam.R +++ /dev/null @@ -1,82 +0,0 @@ -# Build the versioned `ig_adam` dataset: the ADaMIG ADSL (subject-level) -# variable table and the generic BDS (Basic Data Structure) variable table -# that ADPP, as a BDS-structured dataset, uses. -# -# Source: CSV transcriptions of CDISC's published ADaMIG specification -# tables, copied read-only from Bill Denney's Rsdtm package -# (github.com/humanpred/Rsdtm, private) into data-raw/ig_source/adamig_*/ so -# this build has no dependency on that package's checkout being present. See -# data-raw/ig_source/README.md for the full source/attribution note. -# -# Rsdtm splits each version's ADSL and BDS variables across several -# category files (e.g. ADSL_Dose_Variables.csv, Timing_Variables_BDS_Datasets.csv) -# rather than one file per dataset; every file in a version's directory -# whose name starts with "ADSL" is an ADSL category, everything else is a -# BDS category (true for all three transcribed versions: 1.0, 1.1, 1.2). - -source("data-raw/utils_ig.R") - -adamig_versions <- c("1.0", "1.1", "1.2") - -build_adamig_version <- function(version) { - dir <- file.path("data-raw/ig_source", paste0("adamig_", version)) - files <- sort(list.files(dir, pattern = "[.]csv$", full.names = FALSE)) - is_adsl <- startsWith(files, "ADSL") - - rows_for <- function(file, dataset) { - tbl <- read_ig_csv(file.path(dir, file)) - # ADaMIG 1.0's combined ADSL-specification.csv carries five section - # sub-headings as rows ("Study Identifiers", "Subject Demographics", - # "Population Indicator(s)", "Treatment Variables", "Trial Dates"): - # no Type, Core, or label, because they are not variables. - tbl <- tbl[!is.na(tbl$type), ] - category <- tools::file_path_sans_ext(file) - data.frame( - dataset = dataset, - version = version, - category = category, - order = seq_len(nrow(tbl)), - variable = tbl$variable, - label = tbl$label, - type = tbl$type, - core = tbl$core, - codelist = parse_codelist_token(tbl$codelist), - length = parse_documented_length(tbl$notes), - notes = tbl$notes, - stringsAsFactors = FALSE - ) - } - - do.call(rbind, c( - Map(rows_for, files[is_adsl], "ADSL"), - Map(rows_for, files[!is_adsl], "BDS") - )) -} - -ig_adam <- do.call(rbind, lapply(adamig_versions, build_adamig_version)) -rownames(ig_adam) <- NULL - -# ── Labels over the 40-character XPT limit ───────────────────────────────── -# One ADaMIG label is published longer than 40 characters and is kept as -# published: ADaMIG v1.2 (draft, CDISC wiki -# https://wiki.cdisc.org/download/attachments/54282867/ADaMIG-ADaMIG-compiled-191217-0027-11448.pdf), -# section 3.3.4.1, Table 3.3.4.1.1 "Analysis Parameter Variables for BDS -# Datasets": PBCHGCyN is "Percent Change to Baseline Category y (N)" (41 -# characters). Shortening a label to fit a SAS v5 transport (XPT) limit is the -# job of whoever writes the dataset, not of this package, so it is not -# overridden here; it is a documented exception, with its reason, in the gate -# in tests/testthat/test-data_integrity.R, so any other over-length label -# still fails. - -stopifnot( - all(c("dataset", "version", "category", "order", "variable", "label", "type", - "core", "codelist", "length", "notes") %in% names(ig_adam)), - !anyNA(ig_adam$variable), !anyNA(ig_adam$version), !anyNA(ig_adam$label) -) - -usethis::use_data(ig_adam, overwrite = TRUE, compress = "xz") -message(sprintf( - "ig_adam saved: %d rows across %d versions (%d ADSL, %d BDS).", - nrow(ig_adam), length(adamig_versions), - sum(ig_adam$dataset == "ADSL"), sum(ig_adam$dataset == "BDS") -)) diff --git a/data-raw/build_ig_sdtm.R b/data-raw/build_ig_sdtm.R deleted file mode 100644 index 0ee019f..0000000 --- a/data-raw/build_ig_sdtm.R +++ /dev/null @@ -1,224 +0,0 @@ -# Build the versioned `ig_sdtm` dataset: SDTM Model class-level variables -# (Findings observation class) plus SDTMIG domain-specific variables (PP, -# and the generic SUPP-- qualifier structure used for SUPPPP). -# -# Source: CSV transcriptions of CDISC's published SDTM Model and SDTMIG -# specification tables, copied read-only from Bill Denney's Rsdtm package -# (github.com/humanpred/Rsdtm, private) into data-raw/ig_source/ so this -# build has no dependency on that package's checkout being present. See -# data-raw/ig_source/README.md for the full source/attribution note. -# -# Coverage is limited by what Rsdtm's data-raw/ happens to have transcribed: -# the SDTM Model is available for versions 1.4-1.7 (Findings class only, the -# class PP/SUPPPP need); the SDTMIG PP and Supplemental Qualifiers domain -# specifications are only transcribed for version 3.2 (Rsdtm's SDTMIG_3.3 -# copy covers a different, unrelated set of domains). -# -# SDTMIG 3.3 reuses the 3.2 tables: the published SDTMIG v3.3 stamps its PP -# specification "Version 3.2" (so it is unchanged since 3.2; its revision -# history lists no PP change) and its SUPP-- specification, while stamped -# 3.3, has the same ten variables with the same labels and types. See -# `sdtmig_sources` below and data-raw/ig_source/README.md. A newer SDTMIG's -# tables can be added by copying the equivalent CSVs into -# data-raw/ig_source/sdtmig_/ and adding the version to -# `sdtmig_sources`. - -source("data-raw/utils_ig.R") - -# ── SDTM Model: Findings observation class ───────────────────────────────── -model_versions <- c("1.4", "1.5", "1.6", "1.7") - -model_rows <- do.call(rbind, lapply(model_versions, function(v) { - path <- file.path("data-raw/ig_source/sdtm_model", v, "Findings_Observation_Class.csv") - tbl <- read_ig_csv(path) - # Rows with no Type are section sub-headings embedded in the source table - # ("Topic Variable", "Qualifier Variables", ...), not real variables. - tbl <- tbl[!is.na(tbl$type), ] - data.frame( - source = "SDTM_MODEL", - version = v, - class = "Findings", - domain = NA_character_, - order = seq_len(nrow(tbl)), - variable = tbl$variable, - label = tbl$label, - type = tbl$type, - role = tbl$role, - core = NA_character_, - codelist = NA_character_, - length = NA_integer_, - notes = tbl$notes, - stringsAsFactors = FALSE - ) -})) - -# ── SDTMIG: PP and Supplemental Qualifiers (SUPP--) ───────────────────────── -# SDTMIG version -> data-raw/ig_source/sdtmig_

its tables are read from. -sdtmig_sources <- c("3.2" = "3.2", "3.3" = "3.2") -sdtmig_versions <- names(sdtmig_sources) - -# PP variables the SDTMIG v3.3 PDF (section 6.3.11.2, PP specification table) -# shows that Rsdtm's SDTMIG 3.2 transcription lacks (it has 21 of the 24 rows, -# evidently dropping the ones straddling a page break). Each row names the -# variable it follows, so the published order is kept. -read_pp_additions <- function() { - utils::read.csv("data-raw/ig_source/sdtmig_3.2/PP-additions.csv", - stringsAsFactors = FALSE, na.strings = "") -} - -insert_pp_additions <- function(tbl, additions) { - for (i in seq_len(nrow(additions))) { - a <- additions[i, ] - pos <- match(a$after, tbl$variable) - stopifnot(!is.na(pos), !a$variable %in% tbl$variable) - new <- data.frame( - variable = a$variable, label = a$label, type = a$type, - core = a$core, codelist = a$codelist, role = a$role, - notes = NA_character_, stringsAsFactors = FALSE - ) - tbl <- rbind(tbl[seq_len(pos), names(new)], new, - tbl[seq_len(nrow(tbl))[-seq_len(pos)], names(new)]) - } - tbl -} - -build_sdtmig_domain <- function(version, domain, file) { - path <- file.path("data-raw/ig_source", - paste0("sdtmig_", sdtmig_sources[[version]]), file) - tbl <- read_ig_csv(path) - if (domain == "PP") { - tbl <- insert_pp_additions(tbl, read_pp_additions()) - } - data.frame( - source = "SDTMIG", - version = version, - class = NA_character_, - domain = domain, - order = seq_len(nrow(tbl)), - variable = tbl$variable, - label = tbl$label, - type = tbl$type, - role = tbl$role, - core = tbl$core, - codelist = parse_codelist_token(tbl$codelist), - length = parse_documented_length(tbl$notes), - notes = tbl$notes, - stringsAsFactors = FALSE - ) -} - -sdtmig_rows <- do.call(rbind, c( - lapply(sdtmig_versions, build_sdtmig_domain, - domain = "PP", file = "PP-specification.csv"), - lapply(sdtmig_versions, build_sdtmig_domain, - domain = "SUPPQUAL", file = "Supplemental_Qualifiers-specification.csv") -)) - -# ── SDTMIG 3.4: every domain, from the CDISC Library export ───────────────── -# SDTMIG_v3.4.csv (CDISC Library CSV: Version, Variable Order, Class, Dataset -# Name, Variable Name, Variable Label, Type, CDISC CT Codelist Code(s), -# Codelist Submission Values, Described Value Domain(s), Value List, Role, -# CDISC Notes, Core). Read from outside the repository (see -# cdisc_sources_file()); only names, labels, types, codelists, roles, Core, and -# order are transcribed. The CDISC Notes column is NOT carried into the package -# data (`notes` is NA for these rows); it is read only to recover the maximum -# length a note states, as an integer, the same way as for 3.2/3.3. -# -# The export gives codelists as CDISC CT C-codes only ("Codelist Submission -# Values" is empty throughout). `ig_sdtm$codelist` holds the submission value -# (e.g. "PKPARMCD"), so each first code is mapped to its name from the stored CT. -# A code may be retired from the current CT (4 of the 135 distinct first codes -# are), so the name comes from the most recent CT header row that carries it, -# not only a current one; a code with no header anywhere stops the build. -build_sdtmig_34 <- function() { - x <- utils::read.csv(cdisc_sources_file("SDTMIG_v3.4.csv"), check.names = FALSE, - stringsAsFactors = FALSE, na.strings = "", - fileEncoding = "UTF-8") - need <- c("Version", "Variable Order", "Class", "Dataset Name", "Variable Name", - "Variable Label", "Type", "CDISC CT Codelist Code(s)", "Role", - "CDISC Notes", "Core") - if (!all(need %in% names(x))) { - stop("SDTMIG_v3.4.csv is missing column(s): ", - paste(setdiff(need, names(x)), collapse = ", "), call. = FALSE) - } - stopifnot(all(x$Version == "SDTMIG v3.4")) - - e <- new.env(parent = emptyenv()) - load("data/ct_sdtm.rda", envir = e) - hdr <- e$ct_sdtm[is.na(e$ct_sdtm$term_code) & !is.na(e$ct_sdtm$codelist_code) & - !is.na(e$ct_sdtm$codelist_name), ] - hdr <- hdr[order(hdr$codelist_code, hdr$valid_from, decreasing = TRUE), ] - hdr <- hdr[!duplicated(hdr$codelist_code), c("codelist_code", "codelist_name")] - - first_code <- trimws(sub(";.*$", "", x[["CDISC CT Codelist Code(s)"]])) - codelist <- hdr$codelist_name[match(first_code, hdr$codelist_code)] - unmapped <- unique(first_code[!is.na(first_code) & is.na(codelist)]) - if (length(unmapped)) { - stop("SDTMIG 3.4 codelist code(s) with no header row in the stored CT: ", - paste(unmapped, collapse = ", "), call. = FALSE) - } - - data.frame( - source = "SDTMIG", - version = "3.4", - class = tidy_text(x$Class), - domain = tidy_text(x[["Dataset Name"]]), - order = as.integer(x[["Variable Order"]]), - variable = tidy_text(x[["Variable Name"]]), - label = tidy_text(x[["Variable Label"]]), - type = tidy_text(x$Type), - role = tidy_text(x$Role), - core = tidy_text(x$Core), - codelist = codelist, - length = parse_documented_length(x[["CDISC Notes"]]), - notes = NA_character_, - stringsAsFactors = FALSE - ) -} - -sdtmig_34_rows <- build_sdtmig_34() -stopifnot( - !anyDuplicated(paste(sdtmig_34_rows$domain, sdtmig_34_rows$variable)), - all(c("PP", "SUPPQUAL") %in% sdtmig_34_rows$domain) -) - -ig_sdtm <- rbind(model_rows, sdtmig_rows, sdtmig_34_rows) -rownames(ig_sdtm) <- NULL - -# ── Labels over the 40-character XPT limit ───────────────────────────────── -# Checked against the published SDTMIG v3.3 (CDISC wiki PDF -# https://wiki.cdisc.org/download/attachments/66274516/sdtmig_v3.3.pdf): -# - section 4.2.1: "Variable descriptive names (labels), up to 40 -# characters, should be provided as data variable labels for all -# variables, including Supplemental Qualifier variables." -# - section 6.3.11.2 (Pharmacokinetics Parameters), PP specification table: -# PPSTRESC is labelled "Character Result/Finding in Std Format". -# - section 6.3.10.1 (Generic Morphology/Physiology Specification), generic -# table: --TESTCD is labelled "Short Name of Measurement, Test or Exam". -# Model 1.7 as transcribed already uses a 40-character form of this -# (with an Oxford comma); Model 1.4-1.6 transcribe the long form -# "Short Name of Measurement, Test or Examination" (46 characters). -sdtm_label_overrides <- data.frame( - source = c("SDTM_MODEL", "SDTM_MODEL", "SDTM_MODEL", "SDTMIG", "SDTMIG"), - version = c("1.4", "1.5", "1.6", "3.2", "3.3"), - variable = c("--TESTCD", "--TESTCD", "--TESTCD", "PPSTRESC", "PPSTRESC"), - label = c(rep("Short Name of Measurement, Test or Exam", 3), - rep("Character Result/Finding in Std Format", 2)), - evidence = c(rep("SDTMIG v3.3 6.3.10.1 generic table; 4.2.1 label limit", 3), - rep("SDTMIG v3.3 6.3.11.2 PP specification table", 2)), - stringsAsFactors = FALSE -) -ig_sdtm <- apply_label_overrides(ig_sdtm, sdtm_label_overrides, - by = c("source", "version", "variable")) - -stopifnot( - all(c("source", "version", "class", "domain", "order", "variable", "label", - "type", "role", "core", "codelist", "length", "notes") %in% names(ig_sdtm)), - !anyNA(ig_sdtm$variable), !anyNA(ig_sdtm$version), !anyNA(ig_sdtm$label) -) - -usethis::use_data(ig_sdtm, overwrite = TRUE, compress = "xz") -message(sprintf( - "ig_sdtm saved: %d rows (%d SDTM_MODEL, %d SDTMIG).", - nrow(ig_sdtm), sum(ig_sdtm$source == "SDTM_MODEL"), sum(ig_sdtm$source == "SDTMIG") -)) diff --git a/data-raw/fetch_all.R b/data-raw/fetch_all.R index 54574c0..4c403b6 100644 --- a/data-raw/fetch_all.R +++ b/data-raw/fetch_all.R @@ -54,10 +54,11 @@ any_updated <- sdtm_updated || adam_updated || schema_updated || stylesheet_upda if (any_updated) { message("\n--- Rebuild datasets_catalogue ---") - # build_catalogue.R also reports on ig_sdtm/ig_adam (built separately by - # build_ig_sdtm.R / build_ig_adam.R, since they have no NCI network + # build_catalogue.R also reports on ig_sdtm/model_sdtm/ig_adam (built + # separately by build_ig.R from the CDISC Library exports, since they have no NCI network # source); load the already-built copies rather than rebuilding them here. load("data/ig_sdtm.rda") + load("data/model_sdtm.rda") load("data/ig_adam.rda") source("data-raw/build_catalogue.R") diff --git a/data-raw/ig_source/README.md b/data-raw/ig_source/README.md deleted file mode 100644 index c1ab095..0000000 --- a/data-raw/ig_source/README.md +++ /dev/null @@ -1,107 +0,0 @@ -# IG source data: provenance and attribution - -The CSV files under this directory are transcriptions of tables published in -CDISC's own SDTM Model, SDTMIG, and ADaMIG specification documents -(https://www.cdisc.org/standards), copied **read-only** from -[Bill Denney's Rsdtm package](https://github.com/humanpred/Rsdtm) (private, -`data-raw/`), where they were originally transcribed for that package's own -use. They are reproduced here, with this attribution, as the implementation -guide variable metadata behind `ig_sdtm`, `ig_adam`, and `get_ig()`; built by -`data-raw/build_ig_sdtm.R` and `data-raw/build_ig_adam.R`. - -This differs from `cdiscdata`'s original design note that "Data that require -a CDISC Library API key (SDTM IG, ADaM IG) will be handled by a separate -`cdiscapi` package" (see the package README and `cran-comments.md`): no API -key is used here, only these public-source transcriptions, but the IG -metadata this enables is broader than the originally-scoped "public domain -only" CT/schema data. Flagged for Bill's review; the README has been updated -to describe this sourcing. - -## Coverage - -| Directory | Standard | Version(s) | Content | -|---|---|---|---| -| `sdtm_model/1.4` .. `1.7` | SDTM Model | 1.4, 1.5, 1.6, 1.7 | `Findings_Observation_Class.csv`: the Findings general-observation-class variables (PP and ADPP are Findings-class datasets) | -| `sdtmig_3.2` | SDTMIG | 3.2, and 3.3 (reuses these) | `PP-specification.csv` (the PP domain); `PP-additions.csv` (three PP rows missing from the Rsdtm transcription); `Supplemental_Qualifiers-specification.csv` (the generic SUPP-- structure used for SUPPPP) | -| `adamig_1.0`, `adamig_1.1`, `adamig_1.2` | ADaMIG | 1.0, 1.1, 1.2 | ADSL (subject-level) and BDS (Basic Data Structure, used by ADPP) variable tables, each split by Rsdtm into several category files (`ADSL_*` = ADSL, everything else = BDS) | - -**SDTMIG coverage is limited to versions 3.2 and 3.3.** Rsdtm's -`SDTMIG_3.3` copy covers only CO, DM, SE, SM, and SV, not PP or Supplemental -Qualifiers, so the PP/SUPP-- tables come from its 3.2 transcription, and -`ig_sdtm` carries them for 3.3 as well because the published SDTMIG v3.3 -(CDISC wiki PDF, https://wiki.cdisc.org/download/attachments/66274516/sdtmig_v3.3.pdf) -shows they did not change: its section 6.3.11.2 PP specification is stamped -"Version 3.2" and the revision history lists no PP change, and its section -8.4.1 SUPP-- specification has the same ten variables, labels, and types. - -That PDF is a browser print of the web page and is cropped on the right, so it -shows each variable's name, label, type, codelist, and role but not Core or -the CDISC Notes. It also shows `TAETORD`, `EPOCH`, and `PPDY` in the PP table, -which the Rsdtm 3.2 transcription (21 of the 24 rows) lacks; -`sdtmig_3.2/PP-additions.csv` adds them in their published positions, with -Core "Permissible" taken from the Certara PKSubmit SDTM_3.2 appendix -(https://onlinehelp.certara.com/pksubmit/2.1/PKSubmit/Appendix/SDTM_3.2.htm) -because the PDF does not show it. Existing rows keep their Core from the -Rsdtm transcription. - -## SDTMIG 3.4 (every domain, from a CDISC Library export) - -SDTMIG 3.4 comes from `SDTMIG_v3.4.csv`, a CDISC Library CSV export (one row -per variable: Version, Variable Order, Class, Dataset Name, Variable Name, -Variable Label, Type, CDISC CT Codelist Code(s), Codelist Submission Values, -Described Value Domain(s), Value List, Role, CDISC Notes, Core; 1917 rows, -63 domains) that was downloaded under CDISC's own terms and conditions. That -file is **not in this repository and must never be committed or copied into -any repository**; `build_ig_sdtm.R` reads it from `CDISC_SOURCES_DIR` -(default `../cdisc-sources`, relative to the checkout) and stops with a -message naming the expected file if it is absent. Anyone reproducing the -build obtains the export under their own CDISC terms. - -Only variable metadata is transcribed into `ig_sdtm`: order, class, domain, -variable name, label, type, role, Core, and the codelist. The CDISC Notes -column is not carried into the package data (`notes` is `NA` for these rows); -it is read only to recover, as an integer, a maximum length a note states. -The export gives codelists only as CDISC CT C-codes, so each variable's first -code is mapped to its submission value (e.g. `C85839` to `PKPARMCD`) from the -stored CT, using the most recent header row that carries the code because a -few codes (4 of the 135 distinct first codes) are for codelists since retired -from the CT; a code with no header anywhere stops the build. Where a variable -lists several codelists (e.g. PPORRESU: PKUNIT, PKUWG, ...) only the first is -kept, as for 3.2 and 3.3. - -A newer SDTMIG's PP/SUPP-- tables from public sources can be added by copying -the equivalent CSVs into a new `sdtmig_/` directory and adding the -version to `sdtmig_sources` in `data-raw/build_ig_sdtm.R`. - -## Encoding - -These files are Windows-1252 encoded (smart quotes, non-breaking spaces), -not UTF-8, as transcribed from Word/PDF source documents; `read_ig_csv()` in -`data-raw/utils_ig.R` reads them with `fileEncoding = "windows-1252"` -accordingly. - -## Length - -None of these source tables publish a variable Length column; CDISC -implementation guides do not fix one (length is a sponsor/define.xml -choice). `ig_sdtm$length` / `ig_adam$length` are `NA` except for the small -number of variables (PPTESTCD, PPTEST, ...) whose IG text explicitly states -a maximum character count, which `parse_documented_length()` recovers from -that text. - -## Whitespace and labels - -`read_ig_csv()` collapses every run of whitespace (hard line breaks and -non-breaking spaces from wrapped Word/PDF table cells included) in the -`variable`, `label`, `type`, `core`, `codelist`, and `role` fields, because a -wrapped cell otherwise keeps a literal newline and a cell with a trailing -space becomes a variable name such as `"--TESTCD "`. `notes` is left as is. - -Labels in the IGs are limited to 40 characters (SDTMIG 3.3 section 4.2.1); -the few that transcribe longer are set in `sdtm_label_overrides` -(`build_ig_sdtm.R`) to the shorter form the guide itself publishes, with the -IG table each was checked against. The one label the guides publish longer -than 40 characters, ADaMIG 1.2 PBCHGCyN ("Percent Change to Baseline Category -y (N)", 41 characters), is kept as published and is the documented exception -in the gate: shortening a label is the dataset writer's job, not this -package's. `tests/testthat/test-data_integrity.R` gates all of this. diff --git a/data-raw/ig_source/adamig_1.0/ADSL-specification.csv b/data-raw/ig_source/adamig_1.0/ADSL-specification.csv deleted file mode 100644 index d5875d0..0000000 --- a/data-raw/ig_source/adamig_1.0/ADSL-specification.csv +++ /dev/null @@ -1,139 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist / -Controlled Terms",Core,CDISC Notes -Study Identifiers,,,,, -STUDYID,Study Identifier,Char,,Req,"Must be identical to the SDTM variables DM.STUDYID, DM.USUBJID, DM.SUBJID and DM.SITEID." -USUBJID,"Unique Subject -Identifier",Char,,Req, -SUBJID,"Subject Identifier -for the Study",Char,,Req, -SITEID,"Study Site -Identifier",Char,,Req, -SITEGRy,Pooled Site Group y,Char,,Perm,"Character description of a grouping or pooling of clinical sites for analysis purposes. For example, SITEGR3 is the name of a variable containing site group (pooled site) names, -where the grouping has been done according to the third site grouping algorithm, defined in variable metadata; SITEGR3 does not mean the third group of sites." -SITEGRyN,Pooled Site Group y (N),Num,,Perm,The numeric code for SITEGRy. One-to-one map to SITEGRy. -Subject Demographics,,,,, -AGE,Age,Num,,Req,"The age of the subject is a required variable in ADSL. If the variable is not a copy of -DM.AGE, then an additional differently named variable must be added." -AGEU,Age Units,Char,(AGEU),Req,"The units for the subject’s age is a required variable in ADSL. If the variable is not a -copy of DM.AGEU, then an additional differently named variable must be added." -SEX,Sex,Char,(SEX),Req,"The sex of the subject is a required variable in ADSL. If the variable is not a copy of -DM.SEX, then an additional differently named variable must be added." -RACE,Race,Char,(RACE),Req,"The race of the subject is a required variable in ADSL. If the variable is not a copy of -DM.RACE, then an additional differently named variable must be added." -RACEGRy,"Pooled Race -Group y",Char,,Perm,Character description of a grouping or pooling of subject race for analysis purposes. -RACEGRyN,"Pooled Race -Group y (N)",Num,,Perm,"The numeric code for RACEGRy. Orders the grouping or pooling of subject race for -analysis and reporting. One-to-one map to RACEGRy." -Population Indicator(s),,,,, -FASFL,"Full Analysis Set -Population Flag",Char,"Y, N",Cond,"A character indicator variable is required for every population that is defined in the statistical analysis plan. A minimum of one subject-level population flag variable is required for every clinical trial. Additional population flags may be added. The values of subject-level population flags cannot be blank. If a flag is used, the corresponding numeric version (*FN) can also be included." -SAFFL,"Safety Population -Flag",Char,"Y, N",Cond, -ITTFL,"Intent-To-Treat -Population Flag",Char,"Y, N",Cond, -PPROTFL,"Per-Protocol -Population Flag",Char,"Y, N",Cond, -COMPLFL,"Completers -Population Flag",Char,"Y, N",Cond, -RANDFL,"Randomized -Population Flag",Char,"Y, N",Cond, -ENRLFL,"Enrolled -Population Flag",Char,"Y, N",Cond, -Treatment Variables,,,,, -ARM,"Description of -Planned Arm",Char,,Req,DM.ARM -TRTxxP,Planned Treatment for Period xx,Char,,Req,"Subject-level identifier that represents the planned treatment for period xx. In a one- period randomized trial, TRT01P would be the treatment to which the subject was randomized. TRTxxP might be derived from the SDTM DM variable ARM. At least -TRT01P is required." -TRTxxPN,"Planned Treatment for -Period xx (N)",Num,,Perm,The numeric code variable for TRTxxP. One-to-one map to TRTxxP. -TRTxxA,Actual Treatment for Period xx,Char,,Cond,"Subject-level identifier that represents the actual treatment for the subject for period xx. Required when actual treatment does not match planned and there is an analysis of the -data as treated." -TRTxxAN,Actual Treatment for Period xx (N),Num,,Perm,The numeric code variable for TRTxxA. One-to-one map to TRTxxA. -TRTSEQP,Planned Sequence of Treatments,Char,,Cond,"Required when there is a sequence of treatments that are analyzed, for example in a crossover design. TRTSEQP is not necessarily equal to ARM, for example if ARM contains elements that are not relevant to analysis of treatments or ARM is not fully -descriptive (e.g., “GROUP 1,” “GROUP 2”). Whenever applicable, TRTSEQP is required even if identical to ARM." -TRTSEQPN,Planned Sequence of Treatments (N),Num,,Perm,Numeric version of TRTSEQP. One-to-one map to TRTSEQP. -TRTSEQA,"Actual Sequence -of Treatments",Char,,Cond,"TRTSEQA is required if a situation occurred in the conduct of the trial where a subject -received a sequence of treatments other than what was planned." -TRTSEQAN,"Actual Sequence -of Treatments (N)",Num,,Perm,Numeric version of TRTSEQA. One-to-one map to TRTSEQA. -TRxxPGy,Planned Pooled Treatment y for Period xx,Char,,Perm,"Planned pooled treatment y for period xx. Useful when planned treatments (TRTxxP) in the specified period xx are pooled together for analysis according to pooling algorithm y. For example when in period 2 the first pooling algorithm dictates that all doses of Drug A (TR02PG1=“All doses of Drug A”) are pooled together for comparison to all doses of -Drug B (TR02PG1=“All doses of Drug B”). Each value of TRTxxP is pooled within at most one value of TRxxPGy." -TRxxPGyN,"Planned Pooled Trt y for Period -xx (N)",Char,,Perm,The numeric code for TRxxPGy. One-to-one map to TRxxPGy. -TRxxAGy,"Actual Pooled Treatment y for -Period xx",Char,,Cond,Actual pooled treatment y for period xx. Required when TRxxPGy is present and TRTxxA is present. -TRxxAGyN,"Actual Pooled Trt y for Period xx -(N)",Char,,Perm,The numeric code for TRxxAGy. One-to-one map to TRxxAGy. -Trial Dates,,,,, -RANDDT,"Date of -Randomization",Num,,Cond,Required in randomized trials -TRTSDT,"Date of First Exposure to -Treatment",Num,,Cond,Date of first exposure to treatment for a subject in a study. TRTSDT and/or TRTSDTM are required if there is an investigational product. -TRTSTM,"Time of First Exposure to -Treatment",Num,,Perm,Time of first exposure to treatment for a subject in a study. -TRTSDTM,"Datetime of First Exposure to -Treatment",Num,,Cond,Datetime of first exposure to treatment for a subject in a study. TRTSDT and/or TRTSDTM are required if there is an investigational product. -TRTSDTF,"Date of First -Exposure Imput. Flag",Char,(DATEFL),Cond,The level of imputation of date of first exposure to treatment. See General Timing Variable Convention #6. -TRTSTMF,"Time of First Exposure Imput. -Flag",Char,(TIMEFL),Cond,The level of imputation of time of first exposure to treatment. See General Timing Variable Convention #7. -TRTEDT,"Date of Last -Exposure to Treatment",Num,,Cond,Date of last exposure to treatment for a subject in a study. TRTEDT and/or TRTEDTM are required if there is an investigational product. -TRTETM,"Time of Last -Exposure to Treatment",Num,,Perm,Time of last exposure to treatment for a subject in a study. -TRTEDTM,"Datetime of Last -Exposure to Treatment",Num,,Cond,Datetime of last exposure to treatment for a subject in a study. TRTEDT and/or TRTEDTM are required if there is an investigational product. -TRTEDTF,"Date of Last Exposure Imput. -Flag",Char,(DATEFL),Cond,The level of imputation of date of last exposure to treatment. See General Timing Variable Convention #6. -TRTETMF,"Time of Last -Exposure Imput. Flag",Char,(TIMEFL),Cond,The level of imputation of time of last exposure to treatment. See General Timing Variable Convention #7. -TRxxSDT,Date of First Exposure in Period xx,Num,,Cond,"Date of first exposure to treatment in period xx. TRxxSDT and/or TRxxSDTM is required in trial designs where multiple treatments are given to the same subject, such as -a crossover design. Also useful in designs where multiple periods exist for the same treatment (i.e., multiple cycles of the same study treatment)." -TRxxSTM,"Time of First Exposure in -Period xx",Num,,Cond,"The starting time of exposure in period xx. TRxxSTM and/or TRxxSDTM are required in trial designs where multiple treatments are given to the same subject, such as a -crossover design, and time is important to the analysis." -TRxxSDTM,"Datetime of First Exposure in -Period xx",Num,,Cond,"Datetime of first exposure to treatment in period xx. TRxxSDT and/or TRxxSDTM are required in trial designs where multiple treatments are given to the same subject, such as -a crossover design." -TRxxSDTF,"Date 1st Exposure Period xx Imput. -Flag",Char,(DATEFL),Cond,The level of imputation of date of first exposure to treatment in period xx. See General Timing Variable Convention #6. -TRxxSTMF,"Time 1st -Exposure Period xx Imput. Flag",Char,(TIMEFL),Cond,The level of imputation of time of first exposure in period xx. See General Timing Variable Convention #7. -TRxxEDT,"Date of Last Exposure in -Period xx",Num,,Cond,"Date of last exposure in period xx. TRxxEDT and/or TRxxEDTM are required in trial designs where multiple treatments are given to the same subject, such as a crossover -design." -TRxxETM,"Time of Last -Exposure in Period xx",Num,,Cond,"The ending time of exposure in period xx. TRxxETM and/or TRxxEDTM are required -in trial designs where multiple treatments are given to the same subject, such as a crossover design, and ending time is important to the analysis." -TRxxEDTM,"Datetime of Last -Exposure in Period xx",Num,,Cond,"The datetime of last exposure to treatment in period xx. TRxxEDT and/or TRxxEDTM -are required in trial designs where multiple treatments are given to the same subject, such as a crossover design." -TRxxEDTF,"Date Last -Exposure Period xx Imput. Flag",Char,(DATEFL),Cond,The level of imputation of date of last exposure in period xx. See General Timing Variable Convention #6. -TRxxETMF,"Time Last Exposure Period -xx Imput. Flag",Char,(TIMEFL),Cond,The level of imputation of time of last exposure in period xx. See General Timing Variable Convention #7. -APxxSDT,"Period xx Start -Date",Num,,Perm,The starting date of period xx. -APxxSTM,Period xx Start Time,Num,,Perm,The starting time of period xx. -APxxSDTM,"Period xx Start -Datetime",Num,,Perm,The starting datetime of period xx. -APxxSDTF,"Period xx Start -Date Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of period xx start date. See General Timing Variable Convention -#6." -APxxSTMF,"Period xx Start -Time Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of period xx start time. See General Timing Variable Convention -#7." -APxxEDT,"Period xx End -Date",Num,,Perm,The ending date of period xx. -APxxETM,"Period xx End -Time",Num,,Perm,The ending time of period xx. -APxxEDTM,"Period xx End -Date/Time",Num,,Perm,The ending datetime of period xx. -APxxEDTF,"Period xx End -Date Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of period xx end date. See General Timing Variable Convention -#6." -APxxETMF,"Period End Time -Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of period xx end time. See General Timing Variable Convention -#7." diff --git a/data-raw/ig_source/adamig_1.0/Analysis_Descriptor_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.0/Analysis_Descriptor_Variables_BDS_Datasets.csv deleted file mode 100644 index f8bcc5d..0000000 --- a/data-raw/ig_source/adamig_1.0/Analysis_Descriptor_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,42 +0,0 @@ -Variable Name,Variable Label,Type,Codelist / Controlled Terms,Core,CDISC Notes -DTYPE,Derivation Type,Char,(DTYPE),Cond,"Analysis value derivation method. DTYPE is used to denote, and is required to be populated, when the value of AVAL or AVALC (and thus the entire record) has been imputed, derived, or copied from other record(s). DTYPE is required to be populated even if AVAL and AVALC are null on the derived record. DTYPE is not used to denote that an analysis parameter is derived. PARAMTYP may be used to indicate that an entire parameter is derived. For each value of DTYPE, the precise derivation algorithm must be defined in analysis variable metadata, even for DTYPE values in the controlled terminology. See Section 4 for examples of the use of DTYPE. -Examples of DTYPE values -LOCF = last observation carried forward. WOCF = worst observation carried forward. -AVERAGE = average of values." -AWRANGE,"Analysis Window Valid Relative -Range",Char,,Perm,"The range of values that are valid for a given analysis timepoint (a given value of AVISIT). For example, “5-9 DAYS”." -AWTARGET,Analysis Window Target,Num,,Perm,The target or most desired analysis relative day (ADY) value or analysis relative time (ARELTM) value for a given value of AVISIT. -AWTDIFF,Analysis Window Diff from Target,Num,,Perm,"Absolute difference between ADY or ARELTM and AWTARGET. It will be necessary to adjust for the fact that there is no day 0 in the event that ADY and AWTARGET are not of the same sign. -If the sign of the difference is important, then AWTDIFF might have to be used in -conjunction with ADY or ARELTM and possibly AWTARGET when choosing among records." -AWLO,"Analysis Window Beginning -Timepoint",Num,,Perm,"The value of the beginning timepoint (inclusive) needs to be used in conjunction to AWRANGE. For example, if AWRANGE is“5-9 DAYS”, then AWLO is “5”." -AWHI,"Analysis Window -Ending Timepoint",Num,,Perm,"The value of the ending timepoint (inclusive) needs to be used in conjunction to -AWRANGE. For example, if AWRANGE is“5-9 DAYS”, then AWHI is “9”." -AWU,"Analysis Window -Unit",Char,,Perm,"Unit used for AWLO and AWHI. Examples: DAYS, HOURS." -STARTDT,Time to Event Origin Date for Subject,Num,,Perm,"The original date of risk for the time-to-event analysis. This is generally the time at which a subject is first at risk of the event of interest (as defined in the protocol or -Statistical Analysis Plan). For example, this may be the randomization date or the date of first study therapy exposure." -CNSR,Censor,Num,,Cond,"Defines whether the event was censored (period of observation truncated prior to event being observed). It is strongly recommended to use 0 as an event indicator and positive integers as censoring indicators. It is also recommended that unique positive integers be -used to indicate coded descriptions of censoring reasons. CNSR is required for time-to- event parameters." -EVNTDESC,"Event or Censoring -Description",Char,,Perm,Description of the event of interest or censoring reason. -ATOXGR,"Analysis Toxicity -Grade",Char,,Perm,"Toxicity grade for analysis; may be based on SDTM --TOXGR or an imputed or -assigned value." -BTOXGR,"Baseline Toxicity -Grade",Char,,Perm,ATOXGR of the baseline record identified by ABLFL. -ANRIND,"Analysis Reference Range -Indicator",Char,,Perm,Normal range indicator for analysis; may be based on SDTM --NRIND or an imputed or assigned value. -BNRIND,"Baseline Reference Range -Indicator",Char,,Perm,ANRIND of the baseline record identified by ABLFL. -ANRLO,"Analysis Normal -Range Lower Limit",Char,,Perm,Normal range lower limit for analysis; may be based on SDTM --NRLO or an imputed or assigned value. -ANRHI,"Analysis Normal Range Upper -Limit",Char,,Perm,Normal range upper limit for analysis; may be based on SDTM --NRHI or an imputed or assigned value. -AyLO,Analysis Range y Lower Limit,Char,,Cond,"AyLO and/or AyHI are used where there are multiple ranges used for analysis. AyLO and/or AyHI are created to capture the different levels of cutoff values used to determine whether an analysis is within a clinically acceptable value range or outside that value range. AyLO and/or AyHI are usually but not necessarily constants, parameter-specific -constants, or subject-specific constants. AyLO must be included if R2AyLO is included in the dataset." -AyHI,Analysis Range y Upper Limit,Char,,Cond,"See AyLO. -For example, if ECG QTc values are summarized based on values 450, values >480, and values >500, there is a need for 3 “hi value” range variables to calculate values against: A1HI=450, A2HI=480, A3HI=500. -AyHI must be included if R2AyHI is included in the dataset." diff --git a/data-raw/ig_source/adamig_1.0/Analysis_Parameter_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.0/Analysis_Parameter_Variables_BDS_Datasets.csv deleted file mode 100644 index d83ea29..0000000 --- a/data-raw/ig_source/adamig_1.0/Analysis_Parameter_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,47 +0,0 @@ -Variable Name,Variable Label,Type,Codelist / Controlled Terms,Core,CDISC Notes -PARAM,Parameter,Char,,Req,"The description of the analysis parameter. Examples include: “Supine Systolic Blood Pressure (mm Hg)”, “Log10 (Weight (kg))”, “Time to First Hypertension Event (Days)”, “Estimated Tumor Growth Rate”, etc. PARAM should be sufficient to describe unambiguously the contents of AVAL and/or AVALC. PARAM must include test, units (if appropriate), specimen type, location, position, and any other applicable qualifying information needed, any additional information such as transformation function, and indeed any text that is needed. PARAM may be longer than 40 characters in length. -PARAM is often directly usable in Clinical Study Report displays. Note that in the ADaMIG, “parameter” is a synonym of “analysis parameter.”" -PARAMCD,Parameter Code,Char,,Req,"The short name of the analysis parameter in PARAM. Values of PARAMCD should follow SAS 5 variable naming conventions (8 characters or less; starts with a letter; contains only letters and digits). There must be a one-to-one mapping with PARAM. -Examples: SYSBP, LWEIGHT, HYPEREVT." -PARAMN,Parameter (N),Num,,Perm,"Useful for ordering and programmatic manipulation. There must be a one-to-one -mapping with PARAM. Must be an integer." -PARAMTYP,Parameter Type,Char,(PARAMTY P),Perm,"Indicator of whether the parameter is derived as a function of one or more other -parameters. This should not be confused with DTYPE which is relevant to derived AVAL and/or AVALC values." -PARCATy,Parameter Category y,Char,,Perm,"A categorization of PARAM. For example, value of PARCAT1 might group the parameters having to do with a particular questionnaire, lab specimen type, or area of -investigation." -PARCATyN,"Parameter -Category y (N)",Num,,Perm,"A numeric representation of PARCATy. This can be used for operations on PARCATy. -There should be a one to one relationship between PARCATy and PARCATyN." -AVAL,Analysis Value,Num,,"Req (at -least one)",Numeric analysis value described by PARAM. -AVALC,Analysis Value (C),Char,,,"Character analysis value described by PARAM. AVALC can be a character string -mapping to AVAL, but if so there must be a one-to-one map between AVAL and AVALC within a given PARAM. AVALC should not be used to categorize the values of AVAL." -AVALCATy,Analysis Category y,Char,,Perm,"A categorical representation of AVAL and/or AVALC. Not necessarily a one-to-one mapping to AVAL and/or AVALC. For example, if PARAM is “Headache Severity” and AVAL has values 0, 1, 2, or 3, AVALCAT1 can categorize AVAL into “None or Mild” -(for AVAL 1 or 2) and “Moderate or Severe” (for AVAL 3 or 4)" -BASE,Baseline Value,Num,,Cond,"Baseline analysis value. Required if dataset supports analysis or review of baseline value or functions of baseline value. A baseline record may be derived (e.g., it may be an average) in which case DTYPE must also be populated. If BASE is populated for a parameter, and BASE is non-null for a subject for that parameter, then there must be a -record flagged by ABLFL for that subject and parameter." -BASEC,Baseline Value (C),Char,,Perm,"Baseline value of AVALC. May be needed when AVALC is of interest. There must be a one-to-one map between BASE and BASEC within a given PARAM if both are -populated. The baseline record for AVALC must be the same as that for AVAL." -BASECATy,Baseline Category y,Char,,Perm,"A categorical representation of BASE. Not necessarily a one-to-one map to BASE. For example, if PARAM is “Headache Severity” and AVAL has values 0, 1, 2, or 3, BASECAT1 can categorize BASE into “None or Mild” (for BASE 1 or 2) and -“Moderate or Severe” (for BASE 3 or 4)" -BASETYPE,Baseline Type,Char,,Cond,"Sponsor-defined text describing the definition of baseline relevant to the value of BASE on the current record. Required when there are multiple ways that baseline is defined. If -used for a given PARAM, should be populated for all records of that PARAM. Refer to Section 4.2.1, Rule 6, for an example." -CHG,Change from Baseline,Num,,Perm,"Change from baseline analysis value. Equal to AVAL-BASE. If used for a given PARAM, should be populated for all post-baseline records of that PARAM. The -decision on how to populate pre-baseline and baseline values of CHG are left to sponsor choice." -CHGCATy,Change from Baseline Category y,Char,,Perm,"A categorical representation of CHG. Not necessarily a one-to-one mapping to CHG. The definition of CHGCATy may vary by PARAM. For example, CHGCAT1 may be -used to categorize CHG with respect to ranges of change in SYSBP; “-10 to -5 mm Hg”, “-5 to 0 mm Hg” categories." -PCHG,Percent Change from Baseline,Num,,Perm,"Percent change from baseline analysis value. Equal to ((AVAL-BASE)/BASE)*100. If used for a given PARAM, should be populated (when calculable) for all records of that PARAM. The decision on how to populate pre-baseline and baseline values of PCHG -are left to sponsor choice." -PCHGCATy,Percent Change from Baseline y,Char,,Perm,"A categorical representation of PCHG. Not necessarily a one-to-one mapping to PCHG. The definition of PCHGCATy may vary by PARAM. For example, PCHGCAT1 may be -used to categorize PCHG with respect to ranges of change in SYSBP; “>5%”, “>10%” categories." -R2BASE,Ratio to Baseline,Num,,Perm,AVAL / BASE -R2AyLO,"Ratio to Analysis Range y Lower -Limit",Num,,Perm,AVAL / AyLO. AyLO must exist in the analysis dataset. -R2AyHI,"Ratio to Analysis Range y Upper -Limit",Num,,Perm,AVAL / AyHI. AyHI must exist in the analysis dataset. -SHIFTy,Shift y,Char,,Perm,"A shift in values depending on the defined pairing for group “y”. SHIFTy can be based on the change in value of any of the following pairs (BASECATy, AVALCATy), (BNRIND, ANRIND), (BTOXGR, ATOXGR), (BASE, AVAL) or (BASEC, AVALC). -Useful for shift tables. For example, “NORMAL to HIGH”. The decision on how to populate baseline and pre-baseline values of SHIFTy are left to sponsor choice." -SHIFTyN,Shift y (N),Num,,Perm,"Numeric version of SHIFT. SHIFTN has a one-to-one mapping relationship with SHIFT. The decision on how to populate baseline and pre-baseline values of SHIFTN are left to -sponsor choice." -CRITy,Analysis Criterion y,Char,,Perm,"A text string identifying a pre-specified criterion, for example SYSBP > 90. In some cases, the presence of the text string indicates that the criterion is satisfied on this record, while a null value indicates that the criterion is not satisfied. In other cases, the text string identifies the criterion being evaluated, but whether or not the criterion is satisfied is indicated by the value of the variable CRITyFL. See CRITyFL and CRITyFN in -Section 3.2.6. Refer to Section 4.7 for additional discussion of CRITy, CRITyFL and CRITyFN." diff --git a/data-raw/ig_source/adamig_1.0/Data_Point_Traceability_Variables.csv b/data-raw/ig_source/adamig_1.0/Data_Point_Traceability_Variables.csv deleted file mode 100644 index d35400f..0000000 --- a/data-raw/ig_source/adamig_1.0/Data_Point_Traceability_Variables.csv +++ /dev/null @@ -1,7 +0,0 @@ -Variable Name,Variable Label,Type,Codelist / Controlled Terms,Core,CDISC Notes -SRCDOM,Source Domain,Char,,Perm,The 2-character identifier of the SDTM domain that relates to AVAL or AVALC. -SRCVAR,Source Variable,Char,,Perm,"The name of the column (in the SDTM domain identified by SRCDOM) that relates to -AVAL or AVALC." -SRCSEQ,"Source Sequence -Number",Num,,Perm,"The sequence number SEQ of the row (in the SDTM domain identified by SRCDOM) -that relates to AVAL or AVALC." diff --git a/data-raw/ig_source/adamig_1.0/Indicator_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.0/Indicator_Variables_BDS_Datasets.csv deleted file mode 100644 index 992d9dd..0000000 --- a/data-raw/ig_source/adamig_1.0/Indicator_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,63 +0,0 @@ -Variable Name,Variable Label,Type,Codelist / Controlled Terms,Core,CDISC Notes -ABLFL,Baseline Record Flag,Char,Y,Cond,"Character indicator to identify the baseline record for each parameter, or if there is more than one baseline definition, for each parameter and baseline type (BASETYPE). See BASETYPE in Table 3.2.4.1. ABLFL is required if BASE is present in the dataset. -A baseline record may be derived (e.g., it may be an average), in which case DTYPE must also be populated. If BASE is populated for a parameter, and BASE is non-null for -a subject for that parameter, then there must be a record flagged by ABLFL for that subject and parameter." -ABLFN,Baseline Record Flag (N),Num,1,Perm,"Numeric indicator to identify the baseline record for each parameter, or if there is more than one baseline definition, for each parameter and baseline type (BASETYPE)." -ANLzzFL,Analysis Record Flag zz,Char,Y,Cond,"ANLzzFL is a conditionally required flag to be used in addition to other selection variables when the other selection variables in combination are insufficient to identify the exact set of records used for one or more analyses. Often one ANLzzFL will serve to support the accurate selection of records for more than one analysis. -When one is defining the set of records used in a particular analysis or family of analyses, ANLzzFL is supplemental to, and is intended to be used in conjunction with, other selection variables, such as subject-level, parameter-level and record-level population flags, AVISIT, DTYPE, grouping variables such as SITEGRy, and others. Every record selection algorithm “zz” (i.e., every algorithm for populating an ANLzzFL) must be defined in variable metadata. When the set of records that the algorithm “zz” operates on is pre-filtered by application of other criteria, such as a record-level population flag, then the selection algorithm definition in the metadata must so specify. Note that the ANLzzFL value of Y indicates that the record fulfilled the requirements of the algorithm, but does not necessarily imply that the record was actually used in one or more analyses, as whether or not a record is used also depends on the other selection variables applied. The ANLzzFL flag is useful in many circumstances; an example is when there is more than one record for an analysis timepoint within a subject and parameter, as it can be used to identify the record chosen to represent the timepoint for an analysis. “zz” is an index for a record selection algorithm, such as “record closest to target relative day for the AVISIT, with ties broken by the latest record, for each AVISIT -within .”" -ANLzzFN,"Analyzed Record -Flag zz (N)",Num,1,Perm,Numeric version of ANLzzFL. -ONTRTFL,On Treatment Record Flag,Char,Y,Perm,Character indicator of whether the observation occurred while the subject was on treatment. -ONTRTFN,On Treatment Record Flag (N),Num,1,Perm,Numeric indicator of whether the observation occurred while the subject was on treatment. -LVOTFL,"Last Value On -Treatment Record Flag",Char,Y,Perm,Character indicator of the last non-missing value on treatment for each parameter. -LVOTFN,"Last Value On -Treatment Record Flag (N)",Num,1,Perm,Numeric indicator of the last non-missing value on treatment for each parameter. -ITTRFL,"Intent-To-Treat Record-Level -Flag",Char,Y,Cond,Character indicator of whether the subject was in the intent-to-treat analysis for the specific record. -ITTRFN,"Intent-To-Treat -Record-Level Flag (N)",Num,1,Perm,Numeric indicator of whether the subject was in the intent-to-treat analysis for the specific record. -ITTPFL,"Intent-To-Treat -Parameter-Level Flag",Char,Y,Cond,Character indicator of whether the subject was in the intent-to-treat analysis for the specific parameter. -ITTPFN,"Intent-To-Treat Param-Level Flag -(N)",Num,1,Perm,Numeric indicator of whether the subject was in the intent-to-treat analysis for the specific parameter. -SAFRFL,"Safety Analysis Record-Level -Flag",Char,Y,Cond,Character indicator of whether the subject was in the safety analysis for the specific record. -SAFRFN,"Safety Analysis Record-Level -Flag (N)",Num,1,Perm,Numeric indicator of whether the subject was in the safety analysis for the specific record. -SAFPFL,"Safety Analysis Parameter-Level -Flag",Char,Y,Cond,Character indicator of whether the subject was in the safety analysis for the specific parameter. -SAFPFN,"Safety Analysis Param-Level Flag -(N)",Num,1,Perm,Numeric indicator of whether the subject was in the safety analysis for the specific parameter. -FASRFL,"Full Analysis Set -Record-Level Flag",Char,Y,Cond,Character indicator of whether the subject was in the full analysis set analysis for the specific record. -FASRFN,"Full Analysis Set Record-Level -Flag (N)",Num,1,Perm,Numeric indicator of whether the subject was in the full analysis set analysis for the specific record. -FASPFL,"Full Analysis Set Parameter-Level -Flag",Char,Y,Cond,Character indicator of whether the subject was in the full analysis set analysis for the specific parameter. -FASPFN,"Full Analysis Set Param-Level Flag -(N)",Num,1,Perm,Numeric indicator of whether the subject was in the full analysis set analysis for the specific parameter. -PPROTRFL,"Per-Protocol Record-Level -Flag",Char,Y,Cond,Character indicator of whether the subject was in the per-protocol analysis for the specific record. -PPROTRFN,"Per-Protocol Record-Level -Flag (N)",Num,1,Perm,Numeric indicator of whether the subject was in the per-protocol analysis for the specific record. -PPROTPFL,"Per-Protocol -Parameter-Level Flag",Char,Y,Cond,Character indicator of whether the subject was in the per-protocol analysis for the specific parameter. -PPROTPFN,"Per-Protocol -Parameter-Level Flag (N)",Num,1,Perm,Numeric indicator of whether the subject was in the per-protocol analysis for the specific parameter. -COMPRFL,"Completers Record-Level -Flag",Char,Y,Cond,Character indicator of whether the subject was in the completed subjects analysis for the specific record. -COMPRFN,"Completers -Record-Level Flag (N)",Num,1,Perm,Numeric indicator of whether the subject was in the completed subjects analysis for the specific record. -COMPPFL,"Completers -Parameter-Level Flag",Char,Y,Cond,Character indicator of whether the subject was in the completed subjects analysis for the specific parameter. -COMPPFN,"Completers -Parameter-Level Flag (N)",Num,1,Perm,Numeric indicator of whether the subject was in the completed subjects analysis for the specific parameter. -CRITyFL,"Criterion y Evaluation Result -Flag",Char,"Y -or Y, N",Cond,"Character indicator of whether the criterion defined in CRITy was met. See also CRITy in Section 3.2.4. Required if CRITy exists. Refer to Section 4.7 for additional -discussion." -CRITyFN,"Criterion y Evaluation Result -Flag (N)",Num,"1 -or 1, 0",Perm,Numeric indicator of whether the criterion defined in CRITy was met. diff --git a/data-raw/ig_source/adamig_1.0/Subject_Identifier_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.0/Subject_Identifier_Variables_BDS_Datasets.csv deleted file mode 100644 index eea90a2..0000000 --- a/data-raw/ig_source/adamig_1.0/Subject_Identifier_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,8 +0,0 @@ -Variable Name,Variable Label,Type,Codelist / Controlled Terms,Core,CDISC Notes -STUDYID,Study Identifier,Char,,Req,SDTM DM.STUDYID -USUBJID,"Unique Subject -Identifier",Char,,Req,SDTM DM.USUBJID -SUBJID,"Subject Identifier -for the Study",Char,,Perm,"SDTM DM.SUBJID. SUBJID is required in ADSL, but permissible in other datasets." -SITEID,"Study Site -Identifier",Char,,Perm,"SDTM DM.SITEID. SITEID is required in ADSL, but permissible in other datasets." diff --git a/data-raw/ig_source/adamig_1.0/Timing_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.0/Timing_Variables_BDS_Datasets.csv deleted file mode 100644 index 0d0d229..0000000 --- a/data-raw/ig_source/adamig_1.0/Timing_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,113 +0,0 @@ -Variable Name,Variable Label,Type,Codelist / Controlled Terms,Core,CDISC Notes -ADT,Analysis Date,Num,,Perm,The date associated with AVAL and/or AVALC in numeric format. -ATM,Analysis Time,Num,,Perm,The time associated with AVAL and/or AVALC in numeric format. -ADTM,"Analysis -Date/Time",Num,,Perm,The date/time associated with AVAL and/or AVALC in numeric format. -ADY,Analysis Relative Day,Num,,Perm,"The relative day of AVAL and/or AVALC. The number of days from a reference date (not necessarily DM.RFSTDTC) to ADT. The reference date should be indicated in the -variable-level metadata for ADY and the reference date should be included as a variable in the given analysis dataset or alternatively in ADSL." -ADTF,"Analysis Date -Imputation Flag",Char,(DATEFL),Cond,"The level of imputation of ADT based on the source SDTM DTC variable. See General -Timing Variable Convention #6." -ATMF,"Analysis Time -Imputation Flag",Char,(TIMEFL),Cond,"The level of imputation of ATM based on the source SDTM DTC variable. See General -Timing Variable Convention #7." -ASTDT,Analysis Start Date,Num,,Perm,"The start date associated with AVAL and/or AVALC. ASTDT and AENDT may be useful for traceability when AVAL summarizes data collected over an interval of time, or when -AVAL is a duration." -ASTTM,Analysis Start Time,Num,,Perm,"The start time associated with AVAL and/or AVALC. ASTTM and AENTM may be useful for traceability when AVAL summarizes data collected over an interval of time, or -when AVAL is a duration." -ASTDTM,Analysis Start Date/Time,Num,,Perm,"The start datetime associated with AVAL and/or AVALC. ASTDTM and AENDTM may be useful for traceability when AVAL summarizes data collected over an interval of time, -or when AVAL is a duration." -ASTDY,Analysis Start Relative Day,Num,,Perm,"The number of days from a reference date (not necessarily DM.RFSTDTC) to ASTDT. The reference date variable should be indicated in the variable-level metadata for -ASTDY and the reference date variable should be included as a variable in an analysis dataset (typically, but not necessarily, ADSL)." -ASTDTF,"Analysis Start -Date Imputation Flag",Char,(DATEFL),Cond,The level of imputation of ASTDT based on the source SDTM DTC variable. See General Timing Variable Convention #6. -ASTTMF,"Analysis Start -Time Imputation Flag",Char,(TIMEFL),Cond,The level of imputation of ASTTM based on the source SDTM DTC variable. See General Timing Variable Convention #7. -AENDT,Analysis End Date,Num,,Perm,The end date associated with AVAL and/or AVALC. See also ASTDT. -AENTM,"Analysis End -Time",Num,,Perm,The end time associated with AVAL and/or AVALC. See also ASTTM. -AENDTM,"Analysis End -Date/Time",Num,,Perm,The end datetime associated with AVAL and/or AVALC. See also ASTDTM. -AENDY,"Analysis End -Relative Day",Num,,Perm,"The number of days from a reference date (not necessarily DM.RFSTDTC) to AENDT. -See also ASTDY." -AENDTF,"Analysis End Date Imputation -Flag",Char,(DATEFL),Cond,The level of imputation of AENDT based on the source SDTM DTC variable. See General Timing Variable Convention #6. -AENTMF,"Analysis End Time Imputation -Flag",Char,(TIMEFL),Cond,The level of imputation of AENTM based on the source SDTM DTC variable. See General Timing Variable Convention #7. -AVISIT,Analysis Visit,Char,,Cond,"AVISIT may contain the visit names as observe d (i.e., from SDTM VISIT), derived visit names, time window names, conceptual descriptions (such as Average, Endpoint, etc.), or a combination of any of these. AVISIT is a derived field and does not have to map to VISIT from the SDTM. AVISIT represents the analysis visit of the record, but it does not mean that the record was analyzed. There are often multiple records for the same subject and parameter that have the same value of AVISIT. ANLzzFL and other variables may be needed to identify the records selected for any given analysis. See Section 3.2.6 for metadata about flag variables. AVISIT should be unique for a given analysis visit window. In the event that a record does not fall within any predefined analysis timepoint window, AVISIT can be populated in any way that the sponsor chooses to indicate this fact (i.e., blank or “Not Windowed”). The way that AVISIT is calculated, including the variables used in its derivation, should be indicated in the variable metadata for AVISIT. The values and the rules for deriving AVISIT may be different for different parameters -within the same dataset. Values of AVISIT are sponsor-defined, and are often directly usable in Clinical Study Report displays." -AVISITN,Analysis Visit (N),Num,,Perm,"A numeric representation of AVISIT. This may be a protocol visit number, a week or cycle number, an analysis visit number, or any other number logically related to AVISIT or useful for sorting that is needed for analysis. Within a parameter, there is a one-to-one mapping between AVISITN and AVISIT so that AVISITN has the same value for each distinct AVISIT. In the event that a record does not fall within any predefined analysis -timepoint window, AVISITN can be populated in any way that the sponsor chooses to indicate this fact (e.g., may be null). Values of AVISITN are sponsor-defined." -ATPT,Analysis Timepoint,Char,,Perm,"The analysis time point description which is required if analysis times are derived. Timepoints are relative to ATPTREF. -ATPT can be within an analysis visit (e.g., blood pressure assessments at 10 min, 20 min, and 30 min post-dose at AVISIT=Week 1) or can be unrelated to AVISIT (e.g., migraine symptoms 30 min, 60 min, and 120 min post-dose for attack 1)." -ATPTN,"Analysis -Timepoint (N)",Num,,Perm,"ATPTN provides a numeric representation of ATPT. Within the same parameter, there is -a one-to-one mapping between ATPT and ATPTN." -ATPTREF,"Analysis Timepoint -Reference",Char,,Perm,Description of the fixed reference point referred to by ATPT/ATPTN. -APERIOD,Period,Num,,Perm,"The numeric value characterizing the period to which the record belongs. The value of APERIOD must be consistent with the xx value in TRTxxP, TRTxxA, and all variables -whose names begin with TRxx and APxx." -APERIODC,Period (C),Char,,Perm,Text characterizing to which period the record belongs. One-to-one map to APERIOD. -APHASE,Phase,Char,,Perm,"Generally, a higher-level categorization of APERIOD. Does not replace APERIOD, -because APERIOD provides the indexing for the TRxx and APxx variables." -ARELTM,Analysis Relative Time,Num,,Perm,"The time relative to an anchor time. When ARELTM is present, the anchor time variable -and ARELTMU must also be included in the dataset, and the anchor time variable must be identified in the metadata for ARELTM." -ARELTMU,"Analysis Relative -Time Unit",Char,,Cond,"The units of ARELTM. For example, “HOURS” or “MINUTES.” ARELTMU is -required if ARELTM is present." -APERSDT,Period Start Date,Num,,Perm,The starting date for the period defined by APERIOD. -APERSTM,Period Start Time,Num,,Perm,The starting time for the period defined by APERIOD. -APERSDTM,"Period Start -Date/Time",Num,,Perm,The starting datetime for the period defined by APERIOD. -APERSDTF,"Period Start Date -Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of APERSDT based on the source SDTM DTC variable. See -General Timing Variable Convention #6." -APERSTMF,"Period Start Time -Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of APERSTM based on the source SDTM DTC variable. See -General Timing Variable Convention #7." -APEREDT,Period End Date,Num,,Perm,The ending date for the period defined by APERIOD. -APERETM,Period End Time,Num,,Perm,The ending time for the period defined by APERIOD. -APEREDTM,"Period End -Date/Time",Num,,Perm,The ending datetime for the period defined by APERIOD. -APEREDTF,"Period End Date -Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of APEREDT based on the source SDTM DTC variable. See -General Timing Variable Convention #6." -APERETMF,"Period End Time -Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of APERETM based on the source SDTM DTC variable. See -General Timing Variable Convention #7." -*DT,Date of …,Num,,Perm,Analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*TM,Time of …,Num,,Perm,Analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*DTM,Date/Time of …,Num,,Perm,Analysis date/time not directly characterizing AVAL and/or AVALC in numeric format. -*ADY,"Relative Day of -…",Num,,Perm,Analysis relative day not directly characterizing AVAL and/or AVALC. -*DTF,"Date Imputation -Qual of …",Char,(DATEFL),Cond,"The level of imputation of *DT based on the source SDTM DTC variable. See General -Timing Variable Convention #6." -*TMF,"Time Imputation -Flag of …",Char,(TIMEFL),Cond,"The level of imputation of *TM based on the source SDTM DTC variable. See General -Timing Variable Convention #7." -*SDT,Start Date of …,Num,,Perm,"Starting analysis date not directly characterizing AVAL and/or AVALC in numeric -format." -*STM,Start Time of …,Num,,Perm,"Starting analysis time not directly characterizing AVAL and/or AVALC in numeric -format." -*SDTM,"Start Date/Time -of …",Num,,Perm,"Starting analysis date/time not directly characterizing AVAL and/or AVALC in numeric -format." -*SDY,"Relative Start Day -of …",Num,,Perm,Starting analysis relative day not directly characterizing AVAL and/or AVALC. -*SDTF,"Start Date -Imputation Flag of …",Char,(DATEFL),Cond,The level of imputation of *SDT based on the source SDTM DTC variable. See General Timing Variable Convention #6. -*STMF,"Start Time Imputation Qual -of …",Char,(TIMEFL),Cond,The level of imputation of *STM based on the source SDTM DTC variable. See General Timing Variable Convention #7. -*EDT,End Date of …,Num,,Perm,Ending analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*ETM,End Time of …,Num,,Perm,Ending analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*EDTM,"End Date/Time of -…",Num,,Perm,"Ending analysis date/time not directly characterizing AVAL and/or AVALC in numeric -format." -*EDY,"Relative End Day -of …",Num,,Perm,Ending analysis relative day not directly characterizing AVAL and/or AVALC. -*EDTF,"End Date Imputation Flag -of …",Char,(DATEFL),Cond,The level of imputation of *EDT based on the source SDTM DTC variable. See General Timing Variable Convention #6. -*ETMF,"End Time Imputation Flag -of …",Char,(TIMEFL),Cond,The level of imputation of *ETM based on the source SDTM DTC variable. See General Timing Variable Convention #7. diff --git a/data-raw/ig_source/adamig_1.0/Treatment_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.0/Treatment_Variables_BDS_Datasets.csv deleted file mode 100644 index 74d3703..0000000 --- a/data-raw/ig_source/adamig_1.0/Treatment_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,17 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist / Controlled -Terms",Core,CDISC Notes -TRTP,Planned Treatment,Char,,Req,"TRTP is a record-level identifier that represents the planned treatment attributed to a record for analysis purposes. TRTP indicates how treatment varies by record within a subject and enables analysis of crossover and other designs. TRTxxP (copied from ADSL) may also be needed for some analysis purposes, and may be useful for -traceability and to provide context." -TRTPN,Planned Treatment (N),Num,,Perm,The numeric code for TRTP. One-to-one map to TRTP. -TRTA,Actual Treatment,Char,,Cond,"TRTA is a record-level identifier that represents the actual treatment attributed to a record for analysis purposes. TRTA indicates how treatment varies by record within a subject and enables analysis of crossover and other multi-period designs. TRTxxA (copied from ADSL) may also be needed for some analysis purposes, and may be useful for traceability and to provide context. TRTA is required when there is an analysis of data as treated and at least one subject has any data associated with a treatment other -than the planned treatment." -TRTAN,"Actual Treatment -(N)",Num,,Perm,The numeric code for TRTA. One-to-one map to TRTA. -TRTPGy,Planned Pooled Treatment y,Char,,Perm,"Planned pooled treatment y. “y” represents an integer [1-9] corresponding to a particular pooling scheme. Useful when planned treatments (TRTP) are pooled together for analysis, for example when all doses of Drug A (TRTPG1=All doses of Drug A) are -compared to all doses of Drug B (TRTPG1=All doses of Drug B). Each value of TRTP is pooled within at most one value of TRTPGy. May vary by record within a subject." -TRTPGyN,"Planned Pooled -Treatment y (N)",Num,,Perm,The numeric code for TRTPGy. One-to-one map to TRTPGy. -TRTAGy,Actual Pooled Treatment y,Char,,Cond,"Actual pooled treatment y. “y” represents an integer [1-9] corresponding to a particular -pooling scheme. Required when TRTPGy is present and TRTA is present. May vary by record within a subject." -TRTAGyN,"Actual Pooled -Treatment y (N)",Num,,Perm,The numeric code for TRTAGy. One-to-one map to TRTAGy. diff --git a/data-raw/ig_source/adamig_1.1/ADSL_Dose_Variables.csv b/data-raw/ig_source/adamig_1.1/ADSL_Dose_Variables.csv deleted file mode 100644 index 0515525..0000000 --- a/data-raw/ig_source/adamig_1.1/ADSL_Dose_Variables.csv +++ /dev/null @@ -1,7 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -DOSExxP,Planned Treatment Dose for Period xx,Num,,Perm,Subject-level identifier that represents the planned treatment dosage for period xx. -DOSExxA,"Actual Treatment -Dose for Period xx",Num,,Perm,Subject-level identifier that represents the actual treatment dosage for period xx. -DOSExxU,"Units for Dose for -Period xx",Char,,Perm,"The units for DOSExxP and DOSExxA. It is permissible to use suffixes such as “P” and “A” if -needed, with labels modified accordingly." diff --git a/data-raw/ig_source/adamig_1.1/ADSL_Identifier_Variables.csv b/data-raw/ig_source/adamig_1.1/ADSL_Identifier_Variables.csv deleted file mode 100644 index 4ff9fcf..0000000 --- a/data-raw/ig_source/adamig_1.1/ADSL_Identifier_Variables.csv +++ /dev/null @@ -1,15 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -STUDYID,Study Identifier,Char,,Req,DM.STUDYID -USUBJID,"Unique Subject -Identifier",Char,,Req,DM.USUBJID -SUBJID,"Subject Identifier -for the Study",Char,,Req,"DM.SUBJID. SUBJID is required in ADSL, but permissible in other datasets." -SITEID,Study Site Identifier,Char,,Req,"DM.SITEID. SITEID is required in ADSL, but permissible in other datasets." -SITEGRy,Pooled Site Group y,Char,,Perm,"Character description of a grouping or pooling of clinical sites for analysis purposes. For example, SITEGR3 is the name of a variable containing site group (pooled site) names, where the grouping has been done according to the third site grouping algorithm, defined in variable metadata; SITEGR3 does not mean the third group of sites." -SITEGRyN,Pooled Site Group y (N),Num,,Perm,The numeric code for SITEGRy. One-to-one mapping to SITEGRy within a study. -REGIONy,Geographic Region y,Char,,Perm,"Character description of geographical region. For example, REGION1 might have values of ‘Asia’, -‘Europe’, ‘North America’, ‘Rest of World’; REGION2 might have values of ‘United States’, ‘Rest of World’." -REGIONyN,"Geographic Region -y (N)",Num,,Perm,"The numeric code for REGIONy. Orders REGIONy for analysis and reporting. One-to-one -mapping to REGIONy within a study." diff --git a/data-raw/ig_source/adamig_1.1/ADSL_Population_Indicator_Variables.csv b/data-raw/ig_source/adamig_1.1/ADSL_Population_Indicator_Variables.csv deleted file mode 100644 index cae3f1c..0000000 --- a/data-raw/ig_source/adamig_1.1/ADSL_Population_Indicator_Variables.csv +++ /dev/null @@ -1,25 +0,0 @@ -Variable Name ,Variable Label ,Type,"Codelist/ -Controlled -Terms",Core ,CDISC Notes -FASFL ,"Full Analysis Set -Population Flag",Char ,"Y, N ",Cond ,"These flags identify whether or not the subject is included in the specified population. A minimum -of one subject-level population flag variable is required in ADSL. -Not all of the indicators listed here need to be included in ADSL. As stated in Section 3.1.4, Item 2, -only those indicators corresponding to populations defined in the statistical analysis plan or -populations used as a basis for analysis need be included in ADSL. -This list of flags is not meant to be all-inclusive. Additional population flags may be added. -The values of subject-level population flags cannot be blank. If a flag is used, the corresponding -numeric version (*FN, where 0=no and 1=yes) of the population flag can also be included. Please -also refer to Section 3.1.4." -SAFFL ,"Safety Population -Flag",Char ,"Y, N ",Cond, -ITTFL ,"Intent-To-Treat -Population Flag",Char ,"Y, N ",Cond, -PPROTFL ,"Per-Protocol -Population Flag",Char ,"Y, N ",Cond, -COMPLFL ,"Completers -Population Flag",Char ,"Y, N ",Cond, -RANDFL ,"Randomized -Population Flag",Char ,"Y, N ",Cond, -ENRLFL ,"Enrolled Population -Flag",Char ,"Y, N ",Cond, diff --git a/data-raw/ig_source/adamig_1.1/ADSL_Subject_Demographics_Variables.csv b/data-raw/ig_source/adamig_1.1/ADSL_Subject_Demographics_Variables.csv deleted file mode 100644 index 3f2e145..0000000 --- a/data-raw/ig_source/adamig_1.1/ADSL_Subject_Demographics_Variables.csv +++ /dev/null @@ -1,13 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -AGE,Age,Num,,Req,"DM.AGE. If analysis needs require a derived age that does not match DM.AGE, then AAGE must be added" -AGEU,Age Units,Char,(AGEU),Req,DM.AGEU -AGEGRy,Pooled Age Group y,Char,,Perm,"Character description of a grouping or pooling of the subject’s age for analysis purposes. For example, AGEGR1 might have values of “<18”, “18-65”, and “>65”; AGEGR2 might have values of “Less than 35 y old” and “At least 35 y old”." -AGEGRyN,Pooled Age Group y (N),Num,,Perm,The numeric code for AGEGRy. Orders the grouping or pooling of subject age for analysis and reporting. One-to-one mapping to AGEGRy within a study. -AAGE,Analysis Age,Num,,Cond,"Age used for analysis that is derived differently from DM.AGE. AAGE is required if age is -calculated differently than in SDTM." -SEX,Sex,Char,(SEX),Req,The sex of the subject is a required variable in ADSL; must be identical to DM.SEX. -RACE,Race,Char,(RACE),Req,The race of the subject is a required variable in ADSL; must be identical to DM.RACE. -RACEGRy,Pooled Race Group y,Char,,Perm,Character description of a grouping or pooling of the subject’s race for analysis purposes. -RACEGRyN,"Pooled Race Group -y (N)",Num,,Perm,"The numeric code for RACEGRy. Orders the grouping or pooling of subject race for analysis and -reporting. One-to-one mapping to RACEGRy within a study." diff --git a/data-raw/ig_source/adamig_1.1/ADSL_Subject_Level_Trial_Experience_Variables.csv b/data-raw/ig_source/adamig_1.1/ADSL_Subject_Level_Trial_Experience_Variables.csv deleted file mode 100644 index f555eac..0000000 --- a/data-raw/ig_source/adamig_1.1/ADSL_Subject_Level_Trial_Experience_Variables.csv +++ /dev/null @@ -1,70 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -EOSSTT,End of Study Status,Char,,Perm,"The subject’s status as of the end of study or data cutoff. Examples: COMPLETED, -DISCONTINUED, ONGOING." -EOSDT,End of Study Date,Num,,Perm,"Date subject ended the study – either date of completion or date of discontinuation or data cutoff -date for interim analyses." -DCSREAS,"Reason for Discontinuation -from Study",Char,,Perm,Reason for subject’s discontinuation from study. The source would most likely be the SDTM DS dataset. Null for subjects who completed the study. -DCSREASP,Reason Spec for Discont from Study,Char,,Perm,"Additional detail regarding subject’s discontinuation from study (e.g., description of “other”)." -EOTSTT,"End of Treatment -Status",Char,,Perm,"The subject’s status as of the end of treatment or data cutoff. Examples: COMPLETED, -DISCONTINUED, ONGOING." -DCTREAS,"Reason for Discontinuation of -Treatment",Char,,Perm,"If a subject discontinued treatment in the study, then this variable indicates the reason for discontinuation. This is for discontinuation of treatment in the overall study and not to be used for -discontinuation reason within individual treatment periods." -DCTREASP,"Reason Specify for Discont of -Treatment",Char,,Perm,"Additional detail regarding subject’s discontinuation from treatment (e.g., description of “other”)." -EOTxxSTT,"End of Treatment -Status in Period xx",Char,,Perm,"The subject’s treatment status as of the end of period xx, or data cutoff if within period xx. -Examples: COMPLETED, DISCONTINUED, ONGOING." -DCTxxRS,"Reason for Discont -of Treat in Period xx",Char,,Perm,Reason for discontinuing treatment in period xx. -DCTxxRSP,"Reason Spec for -Disc of Trt in Period xx",Char,,Perm,"Additional detail regarding subject’s discontinuation of treatment in period xx (e.g., description of “other”)." -EOPxxSTT,"End of Period xx -Status",Char,,Perm,"The subject’s status as of the end of period xx, or data cutoff if within period xx. Examples: -COMPLETED, DISCONTINUED, ONGOING." -DCPxxRS,Reason for Discont from Period xx,Char,,Perm,Reason for discontinuing analysis period xx. -DCPxxRSP,"Reason Spec for -Discont from Period xx",Char,,Perm,"Additional detail regarding subject’s discontinuation from period xx (e.g., description of “other”)." -RFICDT,"Date of Informed -Consent",Num,,Perm,Date subject gave informed consent. Generally equivalent to DM.RFICDTC. -ENRLDT,Date of Enrollment,Num,,Perm,Date of subject’s enrollment into trial. -RANDDT,"Date of -Randomization",Num,,Cond,Required in randomized trials. -RFICyDT,Date of Informed Consent y,Num,,Perm,"This variable may be used in the case where there are multiple consent dates within a study. This date does not need to repeat the date in RFICDT. ‘y’ can start with 1 but it is not required to start -with 1." -ENRLyDT,Date of Enrollment y,Num,,Perm,"This variable may be used in the case where there are multiple enrollment dates within a study. This date does not need to repeat the date in ENRLDT. ‘y’ can start with 1 but it is not required to -start with 1." -RANDyDT,Date of Randomization y,Num,,Perm,"This variable may be used in the case where there are multiple randomization dates within a study. This date does not need to repeat the date in RANDDT. ‘y’ can start with 1 but it is not required to -start with 1." -LSTALVDT,Date Last Known Alive,Num,,Perm,"If this variable is included in ADSL, the best practice is to populate it for everyone. If the derivation for subjects who died differs from the derivation for subjects who are not known to have died, the differences should be noted in metadata." -TRCMP,Treatment Compliance (%),Num,,Perm,Overall percent compliance with treatment in the trial. TRCMP may be useful for inclusion in ADSL for reasons such as defining subgroups and/or populations. -TRCMPGy,"Treatment Compliance (%) -Group y",Char,,Perm,"Grouping ‘y’ of TRCMP, treatment compliance percentage." -TRCMPGyN,"Treatment Compliance (%) -Group y (N)",Num,,Perm,Numeric version of treatment compliance (%) grouping ‘y’. Must have a one-to-one mapping to TRCMPGy. -TRxxDURD,Treatment Duration in Period xx (Days),Num,,Perm,"Treatment duration for period xx as measured in days. More than one of TRxxDURD, TRxxDURM, and TRxxDURY can be populated, but each represents the entire duration in its -respective units." -TRxxDURM,"Treatment Duration in Period xx -(Months)",Num,,Perm,"Treatment duration for period xx, as measure in months. More than one of TRxxDURD, TRxxDURM, and TRxxDURY can be populated, but each represents the entire duration in its -respective units." -TRxxDURY,Treatment Duration in Period xx (Years),Num,,Perm,"Treatment duration for period xx, as measured in years. More than one of TRxxDURD, TRxxDURM, and TRxxDURY can be populated, but each represents the entire duration in its -respective units." -TRTDURD,Total Treatment Duration (Days),Num,,Perm,"Total treatment duration, as measured in days. More than one of TRTDURD, TRTDURM, and TRTDURY can be populated, but each represents the entire duration in its respective units." -TRTDURM,"Total Treatment -Duration (Months)",Num,,Perm,"Total treatment duration, as measured in months. More than one of TRTDURD, TRTDURM, and -TRTDURY can be populated, but each represents the entire duration in its respective units." -TRTDURY,"Total Treatment -Duration (Years)",Num,,Perm,"Total treatment duration, as measured in years. More than one of TRTDURD, TRTDURM, and -TRTDURY can be populated, but each represents the entire duration in its respective units." -DTHDT,Date of Death,Num,,Perm,Date of subject’s death. Derived from DM.DTHDTC. -DTHDTF,"Date of Death -Imputation Flag",Char,,Cond,"Imputation flag for date of subject’s death. If DTHDT was imputed, DTHDTF must be populated -and is required. See Section 3.1.3." -DTHCAUS,Cause of Death,Char,,Perm,Cause of Death. -DTHCAUSN,Cause of Death (N),Num,,Perm,Numeric representation of cause of death. Must have a one-to-one mapping to DTHCAUS. -DTHCGRy,Cause of Death Group y,Char,,Perm,"Grouping ‘y’ of DTHCAUS, the subject’s cause of death." -DTHCGRyN,"Cause of Death -Group y (N)",Num,,Perm,"Numeric version of grouping ‘y’ of the subject’s cause of death. Must have a one-to-one mapping -to DTHCGRy." diff --git a/data-raw/ig_source/adamig_1.1/ADSL_Treatment_Timing_Variables.csv b/data-raw/ig_source/adamig_1.1/ADSL_Treatment_Timing_Variables.csv deleted file mode 100644 index ab001f6..0000000 --- a/data-raw/ig_source/adamig_1.1/ADSL_Treatment_Timing_Variables.csv +++ /dev/null @@ -1,46 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -TRTSDT,Date of First Exposure to Treatment,Num,,Cond,"Date of first exposure to treatment for a subject in a study. TRTSDT and/or TRTSDTM are required if there is an investigational product. Note that TRTSDT is not required to have the same value as the SDTM DM variable RFXSTDTC. While both of these dates reflect the concept of first -exposure, the ADaM date may be derived to support the analysis which may not necessarily be the very first date in the SDTM EX domain." -TRTSTM,"Time of First Exposure to -Treatment",Num,,Perm,Time of first exposure to treatment for a subject in a study. -TRTSDTM,Datetime of First Exposure to Treatment,Num,,Cond,Datetime of first exposure to treatment for a subject in a study. TRTSDT and/or TRTSDTM are required if there is an investigational product. -TRTSDTF,"Date of First -Exposure Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of date of first exposure to treatment. If TRTSDT (or the date part of TRTSDTM) was imputed, TRTSDTF must be populated and is required. See Section 3.1.3." -TRTSTMF,"Time of First -Exposure Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of time of first exposure to treatment. If TRTSTM (or the time part of TRTSDTM) was imputed, TRTSTMF must be populated and is required. See Section 3.1.3." -TRTEDT,Date of Last Exposure to Treatment,Num,,Cond,"Date of last exposure to treatment for a subject in a study. TRTEDT and/or TRTEDTM are required if there is an investigational product. Note that TRTEDT is not required to have the same value as the SDTM DM variable RFXENDTC. While both of these dates reflect the concept of last -exposure, the ADaM date may be derived to support the analysis which may not necessarily be the very last date in the SDTM EX domain." -TRTETM,Time of Last Exposure to Treatment,Num,,Perm,Time of last exposure to treatment for a subject in a study. -TRTEDTM,"Datetime of Last -Exposure to Treatment",Num,,Cond,Datetime of last exposure to treatment for a subject in a study. TRTEDT and/or TRTEDTM are required if there is an investigational product. -TRTEDTF,"Date of Last Exposure Imput. -Flag",Char,(DATEFL),Cond,"The level of imputation of date of last exposure to treatment. If TRTEDT (or the date part of TRTEDTM) was imputed, TRTEDTF must be populated and is required. See Section 3.1.3." -TRTETMF,"Time of Last Exposure Imput. -Flag",Char,(TIMEFL),Cond,"The level of imputation of time of last exposure to treatment. If TRTETM (or the time part of TRTEDTM) was imputed, TRTETMF must be populated and is required. See Section 3.1.3." -TRxxSDT,Date of First Exposure in Period xx,Num,,Cond,"Date of first exposure to treatment in period xx. TRxxSDT and/or TRxxSDTM are only required in trial designs where multiple treatments are given to the same subject, such as a crossover design, but are permissible for other trial designs. Also useful in designs where multiple periods exist for -the same treatment (i.e., multiple cycles of the same study treatment)." -TRxxSTM,"Time of First Exposure in Period -xx",Num,,Cond,"The starting time of exposure to treatment in period xx. TRxxSTM and/or TRxxSDTM are only required in trial designs where multiple treatments are given to the same subject, such as a -crossover design (but are permissible for other trial designs), and time is important to the analysis." -TRxxSDTM,"Datetime of First Exposure in Period -xx",Num,,Cond,"Datetime of first exposure to treatment in period xx. TRxxSDT and/or TRxxSDTM are only required in trial designs where multiple treatments are given to the same subject, such as a -crossover design, but are permissible for other trial designs." -TRxxSDTF,"Date 1st Exposure Period xx Imput. -Flag",Char,(DATEFL),Cond,"The level of imputation of date of first exposure to treatment in period xx. If TRxxSDT (or the date part of TRxxSDTM) was imputed, TRxxSDTF must be populated and is required. See Section -3.1.3." -TRxxSTMF,"Time 1st Exposure Period xx Imput. -Flag",Char,(TIMEFL),Cond,"The level of imputation of time of first exposure to treatment in period xx. If TRxxSTM (or the time part of TRxxSDTM) was imputed, TRxxSTMF must be populated and is required. See -Section 3.1.3." -TRxxEDT,"Date of Last Exposure in Period -xx",Num,,Cond,"Date of last exposure to treatment in period xx. TRxxEDT and/or TRxxEDTM are only required in trial designs where multiple treatments are given to the same subject, such as a crossover design, -but are permissible for other trial designs." -TRxxETM,Time of Last Exposure in Period xx,Num,,Cond,"The ending time of exposure to treatment in period xx. TRxxETM and/or TRxxEDTM are only required in trial designs where multiple treatments are given to the same subject, such as a crossover design, and ending time is important to the analysis, but are permissible for other trial designs." -TRxxEDTM,"Datetime of Last Exposure in Period -xx",Num,,Cond,"The datetime of last exposure to treatment in period xx. TRxxEDT and/or TRxxEDTM are only required in trial designs where multiple treatments are given to the same subject, such as a -crossover design, but are permissible for other trial designs." -TRxxEDTF,"Date Last Exposure Period xx Imput. -Flag",Char,(DATEFL),Cond,"The level of imputation of date of last exposure to treatment in period xx. If TRxxEDT (or the date part of TRxxEDTM) was imputed, TRxxEDTF must be populated and is required. See Section 3.1.3." -TRxxETMF,"Time Last Exposure Period xx Imput. -Flag",Char,(TIMEFL),Cond,"The level of imputation of time of last exposure to treatment in period xx. If TRxxETM (or the time -part of TRxxEDTM) was imputed, TRxxETMF must be populated and is required. See Section 3.1.3." diff --git a/data-raw/ig_source/adamig_1.1/ADSL_Treatment_Variables.csv b/data-raw/ig_source/adamig_1.1/ADSL_Treatment_Variables.csv deleted file mode 100644 index c9a4311..0000000 --- a/data-raw/ig_source/adamig_1.1/ADSL_Treatment_Variables.csv +++ /dev/null @@ -1,34 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ARM,"Description of -Planned Arm",Char,,Req,DM.ARM -ACTARM,"Description of -Actual Arm",Char,,Perm,DM.ACTARM -TRTxxP,Planned Treatment for Period xx,Char,,Req,"Subject-level identifier that represents the planned treatment for period xx. In a one-period randomized trial, TRT01P would be the treatment to which the subject was randomized. TRTxxP -might be derived from the SDTM DM variable ARM. At least TRT01P is required." -TRTxxPN,"Planned Treatment -for Period xx (N)",Num,,Perm,The numeric code variable for TRTxxP. One-to-one mapping to TRTxxP within a study. -TRTxxA,Actual Treatment for Period xx,Char,,Cond,Subject-level identifier that represents the actual treatment for the subject for period xx. Required when actual treatment does not match planned and there is an analysis of the data as treated. -TRTxxAN,"Actual Treatment -for Period xx (N)",Num,,Perm,The numeric code variable for TRTxxA. One-to-one mapping to TRTxxA within a study. -TRTSEQP,Planned Sequence of Treatments,Char,,Cond,"Required when there is an analysis based on the sequence of treatments, for example in a crossover design. TRTSEQP is not necessarily equal to ARM, for example if ARM contains elements that are not relevant to analysis of treatments or ARM is not fully descriptive (e.g., “GROUP 1,” “GROUP -2”). When analyzing based on the sequence of treatments, TRTSEQP is required even if identical to ARM." -TRTSEQPN,"Planned Sequence -of Treatments (N)",Num,,Perm,Numeric version of TRTSEQP. One-to-one mapping to TRTSEQP within a study. -TRTSEQA,Actual Sequence of Treatments,Char,,Cond,"TRTSEQA is required if a situation occurred in the conduct of the trial where a subject received a -sequence of treatments other than what was planned and there is an analysis based on the sequence of treatments." -TRTSEQAN,"Actual Sequence of -Treatments (N)",Num,,Perm,Numeric version of TRTSEQA. One-to-one mapping to TRTSEQA within a study. -TRxxPGy,Planned Pooled Treatment y for Period xx,Char,,Perm,"Planned pooled treatment y for period xx. Useful when planned treatments (TRTxxP) in the specified period xx are pooled together for analysis according to pooling algorithm y. For example when in period 2 the first pooling algorithm dictates that all doses of Drug A (TR02PG1=“All -doses of Drug A”) are pooled together for comparison to all doses of Drug B (TR02PG1=“All doses of Drug B”). Each value of TRTxxP is pooled within at most one value of TRxxPGy." -TRxxPGyN,"Planned Pooled Trt -y for Period xx (N)",Num *,,Perm,The numeric code for TRxxPGy. One-to-one mapping to TRxxPGy within a study. -TRxxAGy,"Actual Pooled Treatment y for -Period xx",Char,,Cond,Actual pooled treatment y for period xx. Required when TRxxPGy is present and TRTxxA is present. -TRxxAGyN,"Actual Pooled Trt y -for Period xx (N)",Num *,,Perm,The numeric code for TRxxAGy. One-to-one mapping to TRxxAGy within a study. -TSEQPGy,Planned Pooled Treatment Sequence y,Char,,Perm,"Planned pooled treatment sequence y. Useful when planned treatment sequences (TRTSEQP) are pooled together for analysis according to pooling algorithm y. For example, this might be used in -an analysis of an extension study when the analysis is based on what the subject received in the parent study as well as in the extension study." -TSEQPGyN,Planned Pooled Treatment Sequence y (N),Num,,Perm,Numeric version of TSEQPGy. One-to-one mapping to TSEQPGy within a study. -TSEQAGy,Actual Pooled Treatment Sequence y,Char,,Cond,Actual pooled treatment sequence y. Required when TSEQPGy is present and TRTSEQA is present. -TSEQAGyN,"Actual Pooled -Treatment Sequence y (N)",Num,,Perm,Numeric version of TSEQAGy. One-to-one mapping to TSEQAGy within a study. diff --git a/data-raw/ig_source/adamig_1.1/Analysis_Descriptor_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Analysis_Descriptor_Variables_BDS_Datasets.csv deleted file mode 100644 index 628dbd7..0000000 --- a/data-raw/ig_source/adamig_1.1/Analysis_Descriptor_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,10 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -DTYPE,Derivation Type,Char,(DTYPE),Cond,"Analysis value derivation method. DTYPE is used to denote, and is required to be populated, when the value of AVAL or AVALC has been imputed or derived differently than the other analysis values within the parameter. DTYPE is required to be populated even if AVAL and AVALC are null on the derived record. -Three common situations when DTYPE should be populated: -(1) a new row is added within a parameter with the analysis value populated based on other rows within the parameter, -(2) a new row is added within a parameter with the analysis value populated based on a constant value or data from other subjects, -(3) an analysis value (AVAL or AVALC) on an existing record is being replaced with a value based on a pre-specified algorithm. -DTYPE is used to denote analysis values that are “special cases” within a parameter. For each value of DTYPE, the precise derivation algorithm must be defined in analysis variable metadata, even for DTYPE values in the controlled terminology. The controlled terminology for DTYPE is extensible. See Section 4 for examples of the use of DTYPE. -Examples of DTYPE values: -LOCF = last observation carried forward. WOCF = worst observation carried forward. AVERAGE = average of values." diff --git a/data-raw/ig_source/adamig_1.1/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv deleted file mode 100644 index 3c0a9a1..0000000 --- a/data-raw/ig_source/adamig_1.1/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,17 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -CRITy,Analysis Criterion y,Char,,Perm,"A text string identifying a pre-specified criterion within a parameter, for example SYSBP > 90. Required if CRITyFL exists. In some cases, the presence of the text string indicates that the criterion is satisfied on this record and CRITyFL is set to Y, while a null value indicates that the criterion is not satisfied or is not evaluable and is accompanied by a null value in CRITyFL. In other cases, the text string identifies the criterion being evaluated and is populated on every row for the parameter, but whether or not the criterion is satisfied is indicated by the value of the variable -CRITyFL. See CRITyFL and CRITyFN. Refer to Section 4.7 for additional discussion of CRITy, CRITyFL and CRITyFN." -CRITyFL,Criterion y Evaluation Result Flag,Char,"Y -or -Y, N",Cond,Character flag variable indicating whether the criterion defined in CRITy was met by the data on the record. See CRITy for more information regarding how to use CRITy and CRITyFL to indicate whether a criterion is met. Required if CRITy exists. Refer to Section 4.7 for additional discussion. -CRITyFN,"Criterion y -Evaluation Result Flag (N)",Num,"1 -or -1, 0",Perm,Numeric representation of CRITyFL. There is a one-to-one mapping between CRITyFL and CRITyFN. CRITyFN can be included only if CRITyFL is also included. -MCRITy,Analysis Multi- Response Criterion y,Char,,Perm,"A text string identifying a pre-specified criterion within a parameter, where the criterion can have multiple responses (as opposed to CRITy which has binary responses). Required if MCRITyML exists. For example, the grade of a lab analyte is compared to the baseline grade, with the possible conditions being 0 to 1, 0 to 2, etc. The text string identifies the criterion being evaluated (for example, “Grade increase”) and is populated on every row for the parameter; which level of the criterion is satisfied is indicated by the value of the variable MCRITyML (for example “0 to 1”, “0 -to 2”, etc.) See MCRITyML and MCRITyMN below, and refer to Section 4.7 for additional discussion of MCRITy, MCRITyML, and MCRITyMN." -MCRITyML,"Multi-Response -Criterion y Evaluation",Char,,Cond,"Character variable indicating which level of the criterion defined in MCRITy was met by the data -on the record. See MCRITy for more information regarding how to use MCRITy and MCRITyML to indicate whether a criterion was met. Content is sponsor-defined. Required if MCRITy exists." -MCRITyMN,Multi-Response Criterion y Eval (N),Num,,Perm,"Numeric representation of MCRITyML. There is a one-to-one mapping between MCRITyML and -MCRITyMN. Content is sponsor-defined. MCRITyMN can be included only if MCRITyML is also included." diff --git a/data-raw/ig_source/adamig_1.1/Analysis_Parameter_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Analysis_Parameter_Variables_BDS_Datasets.csv deleted file mode 100644 index 5492626..0000000 --- a/data-raw/ig_source/adamig_1.1/Analysis_Parameter_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,53 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -PARAM,Parameter,Char,,Req,"The description of the analysis parameter. Examples include: “Supine Systolic Blood Pressure (mm Hg)”, “Log10 (Weight (kg))”, “Time to First Hypertension Event (Days)”, “Estimated Tumor Growth Rate”, etc. PARAM should be sufficient to describe unambiguously the contents of AVAL and/or AVALC. PARAM must include all descriptive and qualifying information relevant to the analysis purpose of the parameter. -Examples of qualifying information that might be relevant to analysis and therefore are candidates for inclusion in PARAM are units, specimen type, location, position, machine type, and transformation function. There is no need to include qualifiers that are not relevant to the analysis of PARAM. In contrast to SDTM --TEST, no additional variable is needed to further qualify PARAM. -PARAM may be longer than 40 characters in length but is restricted to a maximum of 200 characters. PARAM is often directly usable in Clinical Study Report displays. Note that in the -ADaMIG, “parameter” is a synonym of “analysis parameter.”" -PARAMCD,Parameter Code,Char,,Req,"The short name of the analysis parameter in PARAM. Values of PARAMCD should follow the SAS Version 5 transport file format and Oracle constraints as noted under General Variable -Conventions in Section 3.1.1. There must be a one-to-one mapping to PARAM within a dataset." -PARAMN,Parameter (N),Num,,Perm,"A numeric representation of PARAM. Useful for ordering and programmatic manipulation. There -must be a one-to-one mapping to PARAM within a dataset." -PARAMTYP,Parameter Type,Char,(PARAMTYP),Perm,"Indicator of whether the parameter is derived as a function of one or more other parameters. -This variable will be retired from the ADaMIG in the next version because it was confused with the concept of DTYPE and therefore was being misused. The variable metadata should be adequate to indicate when a parameter is wholly derived." -PARCATy,Parameter Category y,Char,,Perm,"A categorization of PARAM within a dataset. For example, values of PARCAT1 might group the parameters having to do with a particular questionnaire, lab specimen type, or area of investigation. Note that PARCATy is not a qualifier for PARAM. PARAM to PARCATy is a many-to-one mapping; any given PARAM may be associated with at most one level of PARCATy (e.g., one -level of PARCAT1 and one level of PARCAT2)." -PARCATyN,"Parameter Category -y (N)",Num,,Perm,"A numeric representation of PARCATy. This can be used for operations on PARCATy. There must -be a one-to-one relationship within a dataset between PARCATy and PARCATyN." -AVAL,Analysis Value,Num,,Cond,"Numeric analysis value described by PARAM. On a given record, it is permissible for AVAL, AVALC, or both to be null. AVAL is required if AVALC is not present, since either AVAL or -AVALC must be present in the dataset." -AVALC,Analysis Value (C),Char,,Cond,"Character analysis value described by PARAM. AVALC can be a character string mapping to AVAL, but if so there must be a one-to-one map between AVAL and AVALC within a given PARAM. AVALC should not be used to categorize the values of AVAL. Within a given parameter, if there exists a row on which both AVALC and AVAL are populated, then there must be a one-to- one mapping between AVALC and AVAL on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either AVAL or AVALC be included when determining whether the one-to-one mapping requirement is satisfied.) On a given record, it is permissible for AVAL, AVALC, or both to be null. -AVALC is required if AVAL is not present, since either AVAL or AVALC must be present in the dataset." -AVALCATy,Analysis Value Category y,Char,,Perm,"A categorization of AVAL or AVALC within a parameter. Not necessarily a one-to-one mapping to AVAL and/or AVALC. For example, if PARAM is “Headache Severity” and AVAL has values 0, 1, 2, or 3, AVALCAT1 can categorize AVAL into “None or Mild” (for AVAL 0 or 1) and -“Moderate or Severe” (for AVAL 2 or 3)." -AVALCAyN,Analysis Value Category y (N),Num,,Perm,"A numeric representation of AVALCATy. This can be used for ordering of values of AVALCATy -or for other purposes. There must be a one-to-one relationship within a parameter between AVALCATy and AVALCAyN." -BASE,Baseline Value,Num,,Cond,"The subject’s baseline analysis value for a parameter and baseline definition (i.e. BASETYPE) if present. BASE contains the value of AVAL copied from a record within the parameter on which ABLFL = “Y”. Required if dataset supports analysis or review of numeric baseline value or functions of numeric baseline value. If BASE is populated for a parameter, and BASE is non-null for a subject for that parameter, then there must be a record flagged by ABLFL for that subject and parameter. Note that a baseline record may be derived (e.g., it may be an average) in which case -DTYPE must be populated on the baseline record." -BASEC,Baseline Value (C),Char,,Perm,"The subject’s baseline value of AVALC for a parameter and baseline definition (i.e. BASETYPE) if present. May be needed when AVALC is of interest. BASEC contains the value of AVALC copied from a record within the parameter on which ABLFL = “Y”. If both AVAL and AVALC are populated within a parameter, the baseline record for AVALC must be the same record as that for AVAL. -Within a given parameter, if there exists a row on which both BASEC and BASE are populated, then there must be a one-to-one mapping between BASEC and BASE on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either BASE or BASEC be included when determining whether the one-to-one mapping requirement is satisfied.) On a given record, it is permissible for BASE, BASEC, or both to be null." -BASECATy,Baseline Category y,Char,,Perm,"A categorization of BASE or BASEC within a parameter. Not necessarily a one-to-one mapping to BASE or BASEC. For example, if PARAM is “Headache Severity” and AVAL has values 0, 1, 2, or 3, BASECAT1 can categorize BASE into “None or Mild” (for BASE 0 or 1) and “Moderate or -Severe” (for BASE 2 or 3)." -BASECAyN,Baseline Category y (N),Num,,Perm,"A numeric representation of BASECATy. This can be used for ordering of values of BASECATy -or for other purposes. There must be a one-to-one relationship within a parameter between BASECATy and BASECAyN." -BASETYPE,Baseline Type,Char,,Cond,"Producer-defined text describing the definition of baseline relevant to the value of BASE on the current record. Required when there are multiple ways that baseline is defined. If used for any PARAM within a dataset, should be non-null for all records of that dataset. Refer to Section 4.2.1, -Rule 6, for an example." -CHG,Change from Baseline,Num,,Perm,"Change from baseline analysis value. Equal to AVAL-BASE. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used -for analysis. The decision on how to populate pre-baseline and baseline values of CHG is left to producer choice." -CHGCATy,Change from Baseline Category y,Char,,Perm,"A categorization of CHG within a parameter. Not necessarily a one-to-one mapping to CHG. The definition of CHGCATy may vary by PARAM. For example, CHGCAT1 may be used to categorize CHG with respect to ranges of change in SYSBP; “-10 to -5 mm Hg”, “-5 to 0 mm Hg” categories." -CHGCATyN,Change from Baseline Category y (N),Num,,Perm,A numeric representation of CHGCATy. This can be used for ordering of values of CHGCATy or for other purposes. There must be a one-to-one relationship within a parameter between CHGCATy and CHGCATyN. -PCHG,Percent Change from Baseline,Num,,Perm,"Percent change from baseline analysis value. Equal to ((AVAL-BASE)/BASE)*100. If used for a given PARAM, should be populated (when calculable) for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of PCHG is left to producer choice." -PCHGCATy,Percent Chg from Baseline Category y,Char,,Perm,"A categorization of PCHG within a parameter. Not necessarily a one-to-one mapping to PCHG. The definition of PCHGCATy may vary by PARAM. For example, PCHGCAT1 may be used to -categorize PCHG with respect to ranges of change in SYSBP; “>5%”, “>10%” categories." -PCHGCAyN,Percent Chg from Baseline Category y (N),Num,,Perm,A numeric representation of PCHGCATy. This can be used for ordering of values of PCHGCATy or for other purposes. There must be a one-to-one relationship within a parameter between PCHGCATy and PCHGCAyN. -R2BASE,Ratio to Baseline,Num,,Perm,"Ratio to the baseline value. Equal to AVAL / BASE. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used for -analysis. The decision on how to populate pre-baseline and baseline values of R2BASE is left to producer choice." -R2AyLO,Ratio to Analysis Range y Lower Limit,Num,,Perm,"Ratio to the lower limit of the analysis range y. Equal to AVAL / AyLO. AyLO must exist in the ADaM dataset. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of R2AyLO is left to producer choice." -R2AyHI,Ratio to Analysis Range y Upper Limit,Num,,Perm,"Ratio to the upper limit of the analysis range y. Equal to AVAL / AyHI. AyHI must exist in the ADaM dataset. If used for a given PARAM, should be populated for all post-baseline records of -that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of R2AyHI is left to producer choice." -SHIFTy,Shift y,Char,,Perm,"A shift in values depending on the defined pairing for group y. SHIFTy can be based on the change in value of any of the following pairs (BASECATy, AVALCATy), (BNRIND, ANRIND), (ByIND, AyIND), (BTOXGR, ATOXGR), (BASE, AVAL) or (BASEC, AVALC). Useful for shift -tables. For example, “NORMAL to HIGH”. If used for a given PARAM, should be populated (when calculable) for all post-baseline records of that PARAM regardless of whether that record is -used for analysis. The decision on how to populate baseline and pre-baseline values of SHIFTy is left to producer choice." -SHIFTyN,Shift y (N),Num,,Perm,"Numeric version of SHIFTy. SHIFTyN maps one-to-one to SHIFTy within a parameter. If used for a given PARAM, should be populated (when calculable) for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate -baseline and pre-baseline values of SHIFTyN is left to producer choice." diff --git a/data-raw/ig_source/adamig_1.1/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv deleted file mode 100644 index f92fff8..0000000 --- a/data-raw/ig_source/adamig_1.1/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,11 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -AWRANGE,"Analysis Window Valid Relative -Range",Char,,Perm,"The range of values that are valid for a given analysis timepoint (a given value of AVISIT). For example, “5-9 DAYS”." -AWTARGET,Analysis Window Target,Num,,Perm,The target or most desired analysis relative day (ADY) value or analysis relative time (ARELTM) value for a given value of AVISIT. -AWTDIFF,Analysis Window Diff from Target,Num,,Perm,"Absolute difference between ADY or ARELTM and AWTARGET. It will be necessary to adjust for the fact that there is no day 0 in the event that ADY and AWTARGET are not of the same sign. -If the sign of the difference is important, then AWTDIFF might have to be used in conjunction with ADY or ARELTM and possibly AWTARGET when choosing among records." -AWLO,"Analysis Window -Beginning Timepoint",Num,,Perm,"The value of the beginning timepoint (inclusive) needs to be used in conjunction to AWRANGE. For example, if AWRANGE is “5-9 DAYS”, then AWLO is “5”." -AWHI,Analysis Window Ending Timepoint,Num,,Perm,"The value of the ending timepoint (inclusive) needs to be used in conjunction to AWRANGE. For example, if AWRANGE is “5-9 DAYS”, then AWHI is “9”." -AWU,"Analysis Window -Unit",Char,,Perm,"Unit used for AWLO and AWHI. Examples: DAYS, HOURS." diff --git a/data-raw/ig_source/adamig_1.1/BDS_Population_Indicators.csv b/data-raw/ig_source/adamig_1.1/BDS_Population_Indicators.csv deleted file mode 100644 index b56bfc2..0000000 --- a/data-raw/ig_source/adamig_1.1/BDS_Population_Indicators.csv +++ /dev/null @@ -1,19 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ Controlled -Terms",Core,CDISC Notes -ITTRFL,"Intent-To-Treat -Record-Level Flag",Char,Y,Perm,"These indicators identify whether or not the subject was in the specified analysis for the specific record. Useful when the subject is included in the subject-level population, but there are records for the subject that do not satisfy requirements for the population. The valid values of these record- level population indicators are Y or Null. If a flag is used, the corresponding numeric version (*FN, where 1=yes) of the flag can also be included. As described in Section 3.1.1 Item 8, the *FN version of the variable can be included only if the corresponding *FL is also included. Additional indicators may also be used; refer to Section 3.1.4." -SAFRFL,Safety Analysis Record-Level Flag,Char,Y,Perm, -FASRFL,"Full Analysis Set -Record-Level Flag",Char,Y,Perm, -PPROTRFL,"Per-Protocol -Record-Level Flag",Char,Y,Perm, -COMPLRFL,Completers Record- Level Flag,Char,Y,Perm, -ITTPFL,Intent-To-Treat Parameter-Level Flag,Char,Y,Perm,"These indicators identify whether or not the subject was in the specified analysis for the specific parameter. Useful when the subject is included in the subject-level population, but there are parameters for which the subject does not satisfy requirements for the population. The valid values of these parameter-level population indicators are Y or Null. If a flag is used, the corresponding numeric version (*FN, where 1=yes) of the flag can also be included. As described in Section 3.1.1 Item 8, the *FN version of the variable can be included only if the corresponding *FL is also included. Additional indicators may also be used; refer to Section 3.1.4, “Flag Variable Conventions.”" -SAFPFL,"Safety Analysis -Parameter-Level Flag",Char,Y,Perm, -FASPFL,"Full Analysis Set -Parameter-Level Flag",Char,Y,Perm, -PPROTPFL,"Per-Protocol Parameter-Level -Flag",Char,Y,Perm, -COMPLPFL,"Completers Parameter-Level -Flag",Char,Y,Perm, diff --git a/data-raw/ig_source/adamig_1.1/Datapoint_Traceability_Variables.csv b/data-raw/ig_source/adamig_1.1/Datapoint_Traceability_Variables.csv deleted file mode 100644 index a0c7030..0000000 --- a/data-raw/ig_source/adamig_1.1/Datapoint_Traceability_Variables.csv +++ /dev/null @@ -1,8 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -SRCDOM,Source Data,Char,,Perm,"The SDTM domain name or ADaM dataset name that relates to the analysis value (e.g., AVAL or AVALC in a BDS dataset). If the source data is a supplemental qualifier in SDTM, this variable -will contain the value of RDOMAIN in SUPP-- or SUPPQUAL." -SRCVAR,Source Variable,Char,,Perm,"The name of the column (in the domain or dataset identified by SRCDOM) that relates to the analysis value (e.g., AVAL or AVALC in a BDS dataset). In the event that SRCDOM is a -SUPPQUAL, then SRCVAR will be populated with the value of the related QNAM." -SRCSEQ,Source Sequence Number,Num,,Perm,"The sequence number --SEQ or ASEQ of the row (in the domain or dataset identified by SRCDOM) that relates to the analysis value (e.g., AVAL or AVALC in a BDS dataset). In the event that SRCDOM is a SUPPQUAL, then this variable will contain the sequence number of the -relevant related domain record." diff --git a/data-raw/ig_source/adamig_1.1/Identifier_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Identifier_Variables_BDS_Datasets.csv deleted file mode 100644 index f377f2a..0000000 --- a/data-raw/ig_source/adamig_1.1/Identifier_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,11 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -STUDYID,Study Identifier,Char,,Req,DM.STUDYID -USUBJID,"Unique Subject -Identifier",Char,,Req,DM.USUBJID -SUBJID,"Subject Identifier -for the Study",Char,,Perm,"DM.SUBJID. SUBJID is required in ADSL, but permissible in other datasets." -SITEID,Study Site Identifier,Char,,Perm,"DM.SITEID. SITEID is required in ADSL, but permissible in other datasets." -ASEQ,Analysis Sequence Number,Num,,Perm,"Sequence number given to ensure uniqueness of subject records within an ADaM dataset. As long as values are unique within a subject within the dataset, any valid number can be used for ASEQ. ASEQ uniquely indexes records within a subject within an ADaM dataset. -ASEQ is useful for traceability when the dataset is used as input to another ADaM dataset. To refer -to a record in a predecessor ADaM dataset, set SRCDOM to the name of the predecessor dataset, and set SRCSEQ to the value of ASEQ in the predecessor dataset." diff --git a/data-raw/ig_source/adamig_1.1/Indicator_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Indicator_Variables_BDS_Datasets.csv deleted file mode 100644 index 5776d6a..0000000 --- a/data-raw/ig_source/adamig_1.1/Indicator_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,21 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ABLFL,Baseline Record Flag,Char,Y,Cond,"Character indicator to identify the baseline record for each subject, parameter, and baseline type (BASETYPE) combination. See BASETYPE in Table 3.3.4.1. ABLFL is required if BASE is present in the dataset. -A baseline record may be derived (e.g., it may be an average), in which case DTYPE must also be populated. If BASE is populated for a parameter, and BASE is non-null for a subject for that parameter, then there must be a record flagged by ABLFL for that subject and parameter." -ABLFN,"Baseline Record -Flag (N)",Num,1,Perm,"A numeric representation of ABLFL. ABLFN has a one-to-one mapping with ABLFL. As -described in Section 3.1.1 Item 8, ABLFN can be included only if ABLFL is also included." -ANLzzFL,Analysis Flag zz,Char,Y,Cond,"ANLzzFL is a conditionally required flag to be used in addition to other selection variables when the other selection variables in combination are insufficient to identify the exact set of records used for one or more analyses. Often one ANLzzFL will serve to support the accurate selection of records for more than one analysis. Note that it is allowable to add additional descriptive text to the label (see Section 3.1.6, Item 1). -When one is defining the set of records used in a particular analysis or family of analyses, ANLzzFL is supplemental to, and is intended to be used in conjunction with, other selection variables, such as subject-level, parameter-level and record-level population flags, AVISIT, DTYPE, grouping variables such as SITEGRy, and others. The lower-case letter “zz” in the variable name is an index for the zzth record selection algorithm where “zz” is replaced with a zero- padded two-digit integer [01-99]. Every record selection algorithm “zz” (i.e., every algorithm for populating an ANLzzFL) must be defined in variable metadata. When the set of records that the algorithm “zz” operates on is pre-filtered by application of other criteria, such as a record-level population flag, then the selection algorithm definition in the metadata must so specify. -Note that the ANLzzFL value of Y indicates that the record fulfilled the requirements of the algorithm, but does not necessarily imply that the record was actually used in one or more analyses, as whether or not a record is used also depends on the other selection variables applied. The ANLzzFL flag is useful in many circumstances; an example is when there is more than one record for an analysis timepoint within a subject and parameter, as it can be used to identify the record chosen to represent the timepoint for an analysis. “zz” is an index for a record selection algorithm, such as “record closest to target relative day for the AVISIT, with ties broken by the latest record, for each AVISIT within .” -Note that it is not required that a specific ANLzzFL variable has the same definition across a project or even across datasets within a study. There is also no requirement that the ANLzzFL -variables in a dataset or study be used in numerical order; e.g. ANL02FL might occur in a dataset or study without ANL01FL present in the same dataset or study." -ANLzzFN,Analysis Flag zz (N),Num,1,Perm,"Numeric version of ANLzzFL. There is a one-to-one mapping between ANLzzFL and ANLzzFN within a dataset. As described in Section 3.1.1 Item 8, ANLzzFN can be included only if ANLzzFL is also included." -ONTRTFL,On Treatment Record Flag,Char,Y,Perm,"Character indicator of whether the observation occurred while the subject was on treatment. -ONTRTFL is producer-defined, and its definition may vary across datasets in a study based on analysis needs." -ONTRTFN,On Treatment Record Flag (N),Num,1,Perm,"Numeric representation of ONTRTFL. There is a one-to-one mapping between ONTRTFL and -ONTRTFN. As described in Section 3.1.1 Item 8, ONTRTFN can be included only if ONTRTFL is also included." -LVOTFL,"Last Value On Treatment Record -Flag",Char,Y,Perm,Character indicator of the subject’s last non-missing value on treatment for each parameter. -LVOTFN,"Last Value On -Treatment Record Flag (N)",Num,1,Perm,"Numeric representation of LVOTFL. There is a one-to-one mapping between LVOTFL and -LVOTFN. As described in Section 3.1.1 Item 8, LVOTFN can be included only if LVOTFL is also included." diff --git a/data-raw/ig_source/adamig_1.1/Period_Subperiod_Phase_Start_End_Timing_Variables.csv b/data-raw/ig_source/adamig_1.1/Period_Subperiod_Phase_Start_End_Timing_Variables.csv deleted file mode 100644 index f5de42d..0000000 --- a/data-raw/ig_source/adamig_1.1/Period_Subperiod_Phase_Start_End_Timing_Variables.csv +++ /dev/null @@ -1,61 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -APERSDT,Period Start Date,Num,,Perm,The starting date for the period defined by APERIOD. -APERSTM,Period Start Time,Num,,Perm,The starting time for the period defined by APERIOD. -APERSDTM,"Period Start -Datetime",Num,,Perm,The starting datetime for the period defined by APERIOD. -APERSDTF,"Period Start Date -Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of period start date. If APERSDT (or the date part of APERSDTM) was -imputed, APERSDTF must be populated and is required. See Section 3.1.3." -APERSTMF,"Period Start Time -Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of period start time. If APERSTM (or the time part of APERSDTM) was -imputed, APERSTMF must be populated and is required. See Section 3.1.3." -APEREDT,Period End Date,Num,,Perm,The ending date for the period defined by APERIOD. -APERETM,Period End Time,Num,,Perm,The ending time for the period defined by APERIOD. -APEREDTM,"Period End -Datetime",Num,,Perm,The ending datetime for the period defined by APERIOD. -APEREDTF,"Period End Date -Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of period end date. If APEREDT (or the date part of APEREDTM) was -imputed, APEREDTF must be populated and is required. See Section 3.1.3." -APERETMF,"Period End Time -Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of period end time. If APERETM (or the time part of APEREDTM) was -imputed, APERETMF must be populated and is required. See Section 3.1.3." -ASPRSDT,"Subperiod Start -Date",Num,,Perm,The starting date for the subperiod defined by ASPER. -ASPRSTM,"Subperiod Start -Time",Num,,Perm,The starting time for the subperiod defined by ASPER. -ASPRSDTM,"Subperiod Start -Datetime",Num,,Perm,The starting datetime for the subperiod defined by ASPER. -ASPRSDTF,"Subperiod Start -Date Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of subperiod start date. If ASPRSDT (or the date part of ASPRSDTM) was -imputed, ASPRSDTF must be populated and is required. See Section 3.1.3." -ASPRSTMF,"Subperiod Start -Time Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of subperiod start time. If ASPRSTM (or the time part of ASPRSDTM) -was imputed, ASPRSTMF must be populated and is required. See Section 3.1.3." -ASPREDT,Subperiod End Date,Num,,Perm,The ending date for the subperiod defined by ASPER. -ASPRETM,Subperiod End Time,Num,,Perm,The ending time for the subperiod defined by ASPER. -ASPREDTM,"Subperiod End -Datetime",Num,,Perm,The ending datetime for the subperiod defined by ASPER. -ASPREDTF,"Subperiod End Date -Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of subperiod end date. If ASPREDT (or the date part of ASPREDTM) was -imputed, ASPREDTF must be populated and is required. See Section 3.1.3." -ASPRETMF,"Subperiod End Time -Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of subperiod end time. If ASPRETM (or the time part of ASPREDTM) was -imputed, ASPRETMF must be populated and is required. See Section 3.1.3." -PHSDT,Phase Start Date,Num,,Perm,The starting date for the phase defined by APHASE. -PHSTM,Phase Start Time,Num,,Perm,The starting time for the phase defined by APHASE. -PHSDTM,"Phase Start -Datetime",Num,,Perm,The starting datetime for the phase defined by APHASE. -PHSDTF,"Phase Start Date -Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of phase start date. If PHSDT (or the date part of PHSDTM) was imputed, -PHSDTF must be populated and is required. See Section 3.1.3." -PHSTMF,Phase Start Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of phase start time. If PHSTM (or the time part of PHSDTM) was imputed, PHSTMF must be populated and is required. See Section 3.1.3." -PHEDT,Phase End Date,Num,,Perm,The ending date for the phase defined by APHASE. -PHETM,Phase End Time,Num,,Perm,The ending time for the phase defined by APHASE. -PHEDTM,Phase End Datetime,Num,,Perm,The ending datetime for the phase defined by APHASE. -PHEDTF,"Phase End Date -Imput. Flag",Char,(DATEFL),Cond,"The level of imputation of phase end date. If PHEDT (or the date part of PHEDTM) was imputed, -PHEDTF must be populated and is required. See Section 3.1.3." -PHETMF,"Phase End Time -Imput. Flag",Char,(TIMEFL),Cond,"The level of imputation of phase end time. If PHETM (or the time part of PHEDTM) was imputed, -PHETMF must be populated and is required. See Section 3.1.3." diff --git a/data-raw/ig_source/adamig_1.1/Record_Level_Dose_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Record_Level_Dose_Variables_BDS_Datasets.csv deleted file mode 100644 index 6b4d8e5..0000000 --- a/data-raw/ig_source/adamig_1.1/Record_Level_Dose_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,13 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ -Controlled Terms",Core,CDISC Notes -DOSEP,"Planned Treatment -Dose",Num,,Perm,DOSEP represents the planned treatment dosage associated with the record. -DOSCUMP,"Cumulative Planned -Treatment Dose",Num,,Perm,"Cumulative planned dosage of treatment for the subject at the point in time of the record (e.g., -ADT)." -DOSEA,Actual Treatment Dose,Num,,Perm,DOSEA represents the actual treatment dosage associated with the record. -DOSCUMA,"Cumulative Actual -Treatment Dose",Num,,Perm,"Cumulative actual dosage of treatment for the subject at the point in time of the record (e.g., ADT)." -DOSEU,"Treatment Dose -Units",Char,,Perm,"The units for DOSEP, DOSCUMP, DOSEA, and DOSCUMA. It is permissible to use suffixes -such as “P” and “A” if needed, with labels modified accordingly." diff --git a/data-raw/ig_source/adamig_1.1/Record_Level_Treatment_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Record_Level_Treatment_Variables_BDS_Datasets.csv deleted file mode 100644 index 3f2bde9..0000000 --- a/data-raw/ig_source/adamig_1.1/Record_Level_Treatment_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,18 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ Controlled -Terms",Core,CDISC Notes -TRTP,Planned Treatment,Char,,Cond,"TRTP is a record-level identifier that represents the planned treatment attributed to a record for analysis purposes. TRTP indicates how treatment varies by record within a subject and enables analysis of crossover and other designs. Though there is no requirement that TRTP will correspond to the TRTxxP as defined by the record’s value of APERIOD, if populated, TRTP must match at least one value of the character planned treatment variables in ADSL (e.g., TRTxxP, TRTSEQP, TRxxPGy). -As noted previously, at least one treatment variable is required even in non-randomized trials. This requirement is satisfied by any subject-level or record-level treatment variables (e.g., TRTxxP, TRTP, TRTA). Even if not used for analysis, any ADSL treatment variable may be included in the -BDS dataset." -TRTPN,"Planned Treatment -(N)",Num,,Perm,The numeric code for TRTP. One-to-one mapping within a study to TRTP. -TRTA,Actual Treatment,Char,,Cond,"TRTA is a record-level identifier that represents the actual treatment attributed to a record for analysis purposes. TRTA indicates how treatment varies by record within a subject and enables analysis of crossover and other multi-period designs. Though there is no requirement that TRTA will correspond to the TRTxxA as defined by the record’s value of APERIOD, TRTA must match at least one value of the character actual treatment variables in ADSL (e.g., TRTxxA, TRTSEQA, TRxxAGy). -As noted previously, at least one treatment variable is required. This requirement is satisfied by any subject-level or record-level treatment variables (e.g., TRTxxP, TRTP, TRTA). Even if not -used for analysis, any ADSL treatment variable may be included in the BDS dataset." -TRTAN,"Actual Treatment -(N)",Num,,Perm,The numeric code for TRTA. One-to-one mapping within a study to TRTA. -TRTPGy,Planned Pooled Treatment y,Char,,Perm,"TRTPGy is the planned pooled treatment y attributed to a record for analysis purposes. “y” represents an integer [1-99, not zero-padded] corresponding to a particular pooling scheme. Useful when planned treatments (TRTP) are pooled together for analysis, for example when all doses of Drug A (TRTPG1=All doses of Drug A) are compared to all doses of Drug B (TRTPG1=All doses -of Drug B). Each value of TRTP is pooled within at most one value of TRTPGy." -TRTPGyN,"Planned Pooled -Treatment y (N)",Num,,Perm,The numeric code for TRTPGy. One-to-one mapping within a study to TRTPGy. -TRTAGy,Actual Pooled Treatment y,Char,,Cond,"TRTAGy is the actual pooled treatment y attributed to a record for analysis purposes. “y” represents an integer [1-99, not zero-padded] corresponding to a particular pooling scheme. Required when TRTPGy is present and TRTA is present." -TRTAGyN,Actual Pooled Treatment y (N),Num,,Perm,The numeric code for TRTAGy. One-to-one mapping within a study to TRTAGy. diff --git a/data-raw/ig_source/adamig_1.1/Subject_level_Period_Subperiod_Phase_Timing_Variables.csv b/data-raw/ig_source/adamig_1.1/Subject_level_Period_Subperiod_Phase_Timing_Variables.csv deleted file mode 100644 index 0acb3eb..0000000 --- a/data-raw/ig_source/adamig_1.1/Subject_level_Period_Subperiod_Phase_Timing_Variables.csv +++ /dev/null @@ -1,55 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -APxxSDT,Period xx Start Date,Num,,Perm,The starting date of period xx. -APxxSTM,"Period xx Start -Time",Num,,Perm,The starting time of period xx. -APxxSDTM,"Period xx Start -Datetime",Num,,Perm,The starting datetime of period xx. -APxxSDTF,"Period xx Start Date -Imput. Flag",Char,(DATEFL),Cond,The level of imputation of period xx start date. See Section 3.1.3. -APxxSTMF,"Period xx Start -Time Imput. Flag",Char,(TIMEFL),Cond,The level of imputation of period xx start time. See Section 3.1.3. -APxxEDT,Period xx End Date,Num,,Perm,The ending date of period xx. -APxxETM,Period xx End Time,Num,,Perm,The ending time of period xx. -APxxEDTM,"Period xx End -Datetime",Num,,Perm,The ending datetime of period xx. -APxxEDTF,"Period xx End Date -Imput. Flag",Char,(DATEFL),Cond,The level of imputation of period xx end date. See Section 3.1.3. -APxxETMF,"Period xx End Time -Imput. Flag",Char,(TIMEFL),Cond,The level of imputation of period xx end time. See Section 3.1.3. -PxxSw,"Description of Period xx Subperiod -w",Char,,Perm,Description of analysis subperiod w within period xx. -PxxSwSDT,"Period xx Subperiod -w Start Date",Num,,Perm,The starting date of subperiod w within period xx. -PxxSwSTM,Period xx Subperiod w Start Time,Num,,Perm,The starting time of subperiod w within period xx. -PxxSwSDM,"Period xx Subperiod -w Start Datetime",Num,,Perm,The starting datetime of subperiod w within period xx. -PxxSwSDF,"Period xx Subper w Start Date Imput -Flag",Char,(DATEFL),Cond,The level of imputation of the start date for subperiod w within period xx. See Section 3.1.3. -PxxSwSTF,"Period xx Subper w Start Time Imput -Flag",Char,(TIMEFL),Cond,The level of imputation of the start time for subperiod w within period xx. See Section 3.1.3. -PxxSwEDT,Period xx Subperiod w End Date,Num,,Perm,The ending date of subperiod w within period xx. -PxxSwETM,"Period xx Subperiod -w End Time",Num,,Perm,The ending time of subperiod w within period xx. -PxxSwEDM,"Period xx Subperiod -w End Datetime",Num,,Perm,The ending datetime of subperiod w within period xx. -PxxSwEDF,Period xx Subper w End Date Imput Flag,Char,(DATEFL),Cond,The level of imputation of the end date for subperiod w within period xx. See Section 3.1.3. -PxxSwETF,"Period xx Subper w -End Time Imput Flag",Char,(TIMEFL),Cond,The level of imputation of the end time for subperiod w within period xx. See Section 3.1.3. -APHASEw,"Description of Phase -w",Char,,Perm,Description of analysis phase w. -PHwSDT,Phase w Start Date,Num,,Perm,The starting date of phase w. -PHwSTM,Phase w Start Time,Num,,Perm,The starting time of phase w. -PHwSDTM,"Phase w Start -Datetime",Num,,Perm,The starting datetime of phase w. -PHwSDTF,"Phase w Start Date -Imputation Flag",Char,(DATEFL),Cond,The level of imputation of the start date for phase w. See Section 3.1.3. -PHwSTMF,"Phase w Start Time -Imputation Flag",Char,(TIMEFL),Cond,The level of imputation of the start time for phase w. See Section 3.1.3. -PHwEDT,Phase w End Date,Num,,Perm,The ending date of phase w. -PHwETM,Phase w End Time,Num,,Perm,The ending time of phase w. -PHwEDTM,"Phase w End -Datetime",Num,,Perm,The ending datetime of phase w. -PHwEDTF,"Phase w End Date -Imputation Flag",Char,(DATEFL),Cond,The level of imputation of the end date for phase w. See Section 3.1.3. -PHwETMF,"Phase w End Time -Imputation Flag",Char,(TIMEFL),Cond,The level of imputation of the end time for phase w. See Section 3.1.3. diff --git a/data-raw/ig_source/adamig_1.1/Suffixes_User_Defined_Timing_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Suffixes_User_Defined_Timing_Variables_BDS_Datasets.csv deleted file mode 100644 index d6fa72c..0000000 --- a/data-raw/ig_source/adamig_1.1/Suffixes_User_Defined_Timing_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,29 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -*DT,{Date},Num,,Perm,Analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*TM,{Time},Num,,Perm,Analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*DTM,{Datetime},Num,,Perm,Analysis datetime not directly characterizing AVAL and/or AVALC in numeric format. -*ADY,{Relative Day},Num,,Perm,Analysis relative day not directly characterizing AVAL and/or AVALC. -*DTF,"{Date Imputation -Flag}",Char,(DATEFL),Cond,"The level of imputation of *DT. If *DT (or the date part of *DTM) was imputed, *DTF must be -populated and is required. See Section 3.1.3." -*TMF,"{Time Imputation -Flag}",Char,(TIMEFL),Cond,"The level of imputation of *TM. If *TM (or the time part of *DTM) was imputed, *TMF must be -populated and is required. See Section 3.1.3." -*SDT,{Start Date},Num,,Perm,Starting analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*STM,{Start Time},Num,,Perm,Starting analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*SDTM,{Start Datetime},Num,,Perm,Starting analysis datetime not directly characterizing AVAL and/or AVALC in numeric format. -*SDY,{Relative Start Day},Num,,Perm,Starting analysis relative day not directly characterizing AVAL and/or AVALC. -*SDTF,"{Start Date -Imputation Flag}",Char,(DATEFL),Cond,"The level of imputation of *SDT. If *SDT (or the date part of *SDTM) was imputed, *SDTF must -be populated and is required. See Section 3.1.3." -*STMF,"{Start Time -Imputation Flag}",Char,(TIMEFL),Cond,"The level of imputation of *STM. If *STM (or the time part of *SDTM) was imputed, *STMF -must be populated and is required. See Section 3.1.3." -*EDT,{End Date},Num,,Perm,Ending analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*ETM,{End Time},Num,,Perm,Ending analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*EDTM,{End Datetime},Num,,Perm,Ending analysis datetime not directly characterizing AVAL and/or AVALC in numeric format. -*EDY,{Relative End Day},Num,,Perm,Ending analysis relative day not directly characterizing AVAL and/or AVALC. -*EDTF,{End Date Imputation Flag},Char,(DATEFL),Cond,"The level of imputation of *EDT. If *EDT (or the date part of *EDTM) was imputed, *EDTF must be populated and is required. See Section 3.1.3." -*ETMF,"{End Time -Imputation Flag}",Char,(TIMEFL),Cond,"The level of imputation of *ETM. If *ETM (or the time part of *EDTM) was imputed, *ETMF -must be populated and is required. See Section 3.1.3." diff --git a/data-raw/ig_source/adamig_1.1/Time_To_Event_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Time_To_Event_Variables_BDS_Datasets.csv deleted file mode 100644 index 03a0626..0000000 --- a/data-raw/ig_source/adamig_1.1/Time_To_Event_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,17 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ Controlled -Terms",Core,CDISC Notes -STARTDT,"Time-to-Event Origin Date for -Subject",Num,,Perm,"The original date of risk for the time-to-event analysis. This is generally the time at which a subject is first at risk for the event of interest evaluation (as defined in the Protocol or Statistical Analysis -Plan). For example, this may be the randomization date or the date of first study therapy exposure." -STARTDTM,"Time-to-Event -Origin Datetime",Num,,Perm,The datetime associated with STARTDT in numeric format. -STARTDTF,Origin Date Imputation Flag,Char,(DATEFL),Cond,The level of imputation of the start date. See Section 3.1.3. -STARTTMF,"Origin Time -Imputation Flag",Char,(TIMEFL),Cond,The level of imputation of the start time. See Section 3.1.3. -CNSR,Censor,Num,,Cond,"Defines whether the event was censored for the subject within the parameter (period of observation truncated prior to event being observed). It is strongly recommended to use 0 as an event indicator and positive integers as censoring indicators. It is also recommended that unique positive integers -be used to indicate coded descriptions of censoring reasons. CNSR is required for time-to-event parameters." -EVNTDESC,"Event or Censoring -Description",Char,,Perm,Description of the event of interest or censoring reason for the subject within the parameter. -CNSDTDSC,"Censor Date -Description",Char,,Perm,"Describes the circumstance represented by the censoring date if different from the event date that -warrants censoring." diff --git a/data-raw/ig_source/adamig_1.1/Timing_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Timing_Variables_BDS_Datasets.csv deleted file mode 100644 index 944530a..0000000 --- a/data-raw/ig_source/adamig_1.1/Timing_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,66 +0,0 @@ -Variable Name,Variable Label,Type,"Codelist/ Controlled -Terms",Core,CDISC Notes -ADT,Analysis Date,Num,,Perm,The date associated with AVAL and/or AVALC in numeric format. -ATM,Analysis Time,Num,,Perm,The time associated with AVAL and/or AVALC in numeric format. -ADTM,Analysis Datetime,Num,,Perm,The datetime associated with AVAL and/or AVALC in numeric format. -ADY,"Analysis Relative -Day",Num,,Perm,"The relative day of AVAL and/or AVALC. The number of days from an anchor date (not -necessarily DM.RFSTDTC) to ADT. See Section 3.1.2." -ADTF,"Analysis Date -Imputation Flag",Char,(DATEFL),Cond,"The level of imputation of analysis date. If ADT (or the date part of ADTM) was imputed, ADTF -must be populated and is required. See Section 3.1.3." -ATMF,"Analysis Time -Imputation Flag",Char,(TIMEFL),Cond,"The level of imputation of analysis time. If ATM (or the time part of ADTM) was imputed, ATMF -must be populated and is required. See Section 3.1.3." -ASTDT,Analysis Start Date,Num,,Perm,"The start date associated with AVAL and/or AVALC. ASTDT and AENDT may be useful for traceability when AVAL summarizes data collected over an interval of time, or when AVAL is a -duration." -ASTTM,Analysis Start Time,Num,,Perm,"The start time associated with AVAL and/or AVALC. ASTTM and AENTM may be useful for traceability when AVAL summarizes data collected over an interval of time, or when AVAL is a -duration." -ASTDTM,Analysis Start Datetime,Num,,Perm,"The start datetime associated with AVAL and/or AVALC. ASTDTM and AENDTM may be useful -for traceability when AVAL summarizes data collected over an interval of time, or when AVAL is a duration." -ASTDY,"Analysis Start -Relative Day",Num,,Perm,"The number of days from an anchor date (not necessarily DM.RFSTDTC) to ASTDT. See Section -3.1.2." -ASTDTF,"Analysis Start Date -Imputation Flag",Char,(DATEFL),Cond,"The level of imputation of analysis start date. If ASTDT (or the date part of ASTDTM) was -imputed, ASTDTF must be populated and is required. See Section 3.1.3." -ASTTMF,Analysis Start Time Imputation Flag,Char,(TIMEFL),Cond,"The level of imputation of analysis start time. If ASTTM (or the time part of ASTDTM) was imputed, ASTTMF must be populated and is required. See Section 3.1.3." -AENDT,Analysis End Date,Num,,Perm,The end date associated with AVAL and/or AVALC. See also ASTDT. -AENTM,Analysis End Time,Num,,Perm,The end time associated with AVAL and/or AVALC. See also ASTTM. -AENDTM,"Analysis End -Datetime",Num,,Perm,The end datetime associated with AVAL and/or AVALC. See also ASTDTM. -AENDY,Analysis End Relative Day,Num,,Perm,"The number of days from an anchor date (not necessarily DM.RFSTDTC) to AENDT. See Section -3.1.2." -AENDTF,"Analysis End Date -Imputation Flag",Char,(DATEFL),Cond,"The level of imputation of analysis end date. If AENDT (or the date part of AENDTM) was -imputed, AENDTF must be populated and is required. See Section 3.1.3." -AENTMF,Analysis End Time Imputation Flag,Char,(TIMEFL),Cond,"The level of imputation of analysis end time. If AENTM (or the time part of AENDTM) was imputed, AENTMF must be populated and is required. See Section 3.1.3." -AVISIT,Analysis Visit,Char,,Cond,"The analysis visit description; required if an analysis is done by nominal, assigned or analysis visit. AVISIT may contain the visit names as observed (i.e., from SDTM VISIT), derived visit names, time window names, conceptual descriptions (such as Average, Endpoint, etc.), or a combination of any of these. AVISIT is a derived field and does not have to map to VISIT from the SDTM. AVISIT represents the analysis visit of the record, but it does not mean that the record was analyzed. There are often multiple records for the same subject and parameter that have the same value of AVISIT. ANLzzFL and other variables may be needed to identify the records selected for any given analysis. See Section 3.3.8 for information about flag variables. AVISIT should be unique for a given analysis visit window. In the event that a record does not fall within any predefined analysis timepoint window, AVISIT can be populated in any way that the producer chooses to indicate this fact (i.e., blank or “Not Windowed”). The way that AVISIT is calculated, including the variables used in its derivation, should be indicated in the variable metadata for AVISIT. The values and the rules for deriving AVISIT may be different for different parameters within the same dataset. Values of AVISIT are producer-defined, and are often directly usable in -Clinical Study Report displays." -AVISITN,Analysis Visit (N),Num,,Perm,"A numeric representation of AVISIT. Since study visits are usually defined by certain timepoints, defining AVISITN so that it represents the timepoint associated with the visit can facilitate plotting and interpretation of the values. Alternatively, AVISITN may be a protocol visit number, a cycle number, an analysis visit number, or any other number logically related to AVISIT or useful for sorting that is needed for analysis. -Within a parameter, there is a one-to-one mapping between AVISITN and AVISIT so that AVISITN has the same value for each distinct AVISIT. (Best practice would dictate that the mapping would be one-to-one within a study, but that is not an ADaM requirement.) In the event that a record does not fall within any predefined analysis timepoint window, AVISITN can be -populated in any way that the producer chooses to indicate this fact (e.g., may be null). Values of AVISITN are producer-defined." -ATPT,Analysis Timepoint,Char,,Cond,"The analysis timepoint description; required if an analysis is done by nominal, assigned or analysis timepoint (instead of or in addition to by-visit). Timepoints are relative to ATPTREF. ATPT may contain the timepoint names as observed (i.e., from SDTM --TPT), derived timepoint names, time window names, conceptual descriptions (such as Average, Endpoint, etc.), or a combination of any of these. This variable is often used in conjunction with AVISIT. ATPT represents the analysis timepoint of the record. -ATPT can be within an analysis visit (e.g., blood pressure assessments at 10 min, 20 min, and 30 min post-dose at AVISIT=Week 1) or can be unrelated to AVISIT (e.g., migraine symptoms 30 min, 60 min, and 120 min post-dose for attack 1). -The way that ATPT is calculated, including the variables used in its derivation, should be indicated in the variable metadata for ATPT. The values and the rules for deriving ATPT may be different for different parameters within the same dataset. Values of ATPT are producer-defined, and are often -directly usable in Clinical Study Report displays." -ATPTN,Analysis Timepoint (N),Num,,Perm,"ATPTN provides a numeric representation of ATPT. Defining ATPTN so that its values represent the planned timepoints (e.g., minutes or hours after dosing) is not required but can facilitate plotting and interpretation of the values. Within the same parameter, there is a one-to-one mapping between ATPT and ATPTN. (Best practice would dictate that the mapping would be one-to-one within a -study, but that is not an ADaM requirement.)" -ATPTREF,"Analysis Timepoint -Reference",Char,,Perm,"Description of the fixed reference point referred to by ATPT/ATPTN (e.g., time of dose)." -APHASE,Phase,Char,,Perm,"APHASE is a categorization of timing within a study, for example a higher-level categorization of -APERIOD or an analysis epoch. For example, APHASE could describe spans of time for SCREENING, ON TREATMENT, and FOLLOW-UP." -APHASEN,Phase (N),Num,,Perm,"APHASEN provides a numeric representation of APHASE. Within a study, there is a one-to-one -mapping between APHASE and APHASEN." -APERIOD,Period,Num,,Perm,APERIOD is a record-level timing variable that represents the analysis period within the study associated with the record for analysis purposes. The value of APERIOD (if populated) must be one of the xx values found in the ADSL TRTxxP variables. -APERIODC,Period (C),Char,,Perm,"Text characterizing to which analysis period the record belongs. One-to-one mapping within a -dataset to APERIOD." -ASPER,"Subperiod within -Period",Num,,Perm,"The numeric value characterizing a sublevel within APERIOD to which the record belongs. Within -each APERIOD, the first ASPER is 1 (i.e., it resets to 1 when the APERIOD value changes)." -ASPERC,Subperiod within Period (C),Char,,Perm,Text characterizing to which subperiod the record belongs. One-to-one mapping within a period to ASPER. -ARELTM,Analysis Relative Time,Num,,Perm,"The time relative to an anchor time. The amount of time from an anchor time to ATM. When -ARELTM is present, the anchor time variable and ARELTMU must also be included in the dataset, and the anchor time variable must be identified in the metadata for ARELTM." -ARELTMU,"Analysis Relative -Time Unit",Char,,Perm,"The units of ARELTM. For example, “HOURS” or “MINUTES.” ARELTMU is required if -ARELTM is present." diff --git a/data-raw/ig_source/adamig_1.1/Toxicity_Range_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.1/Toxicity_Range_Variables_BDS_Datasets.csv deleted file mode 100644 index 36c4c32..0000000 --- a/data-raw/ig_source/adamig_1.1/Toxicity_Range_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,35 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ATOXGR,"Analysis Toxicity -Grade",Char,,Perm,"Toxicity grade of AVAL or AVALC for analysis; may be based on SDTM --TOXGR or an -imputed or assigned value." -BTOXGR,"Baseline Toxicity -Grade",Char,,Perm,ATOXGR of the baseline record identified by ABLFL. -ANRIND,"Analysis Reference -Range Indicator",Char,,Perm,"Indicates where AVAL or AVALC falls with respect to the normal reference range for analysis; -may be based on SDTM --NRIND or an imputed or assigned value." -BNRIND,Baseline Reference Range Indicator,Char,,Perm,ANRIND of the baseline record identified by ABLFL. -ANRLO,"Analysis Normal -Range Lower Limit",Num *,,Perm,"Normal range lower limit for analysis; may be based on SDTM --NRLO or an imputed or assigned -value." -ANRLOC,Analysis Normal Range Lower Limit (C),Char,,Perm,"Character analysis normal range lower limit. ANRLOC can be a character string mapping to ANRLO, but if so there must be a one-to-one map between ANRLO and ANRLOC within a given PARAM. ANRLOC should not be used to categorize the values of ANRLO. Within a given parameter, if there exists a row on which both ANRLOC and ANRLO are populated, then there must be a one-to-one mapping between ANRLOC and ANRLO on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either ANRLO or ANRLOC be included when determining whether the one-to-one mapping -requirement is satisfied.) On a given record, it is permissible for ANRLO, ANRLOC, or both to be null." -ANRHI,"Analysis Normal -Range Upper Limit",Num *,,Perm,"Normal range upper limit for analysis; may be based on SDTM --NRHI or an imputed or assigned -value." -ANRHIC,Analysis Normal Range Upper Limit (C),Char,,Perm,"Character analysis normal range upper limit. ANRHIC can be a character string mapping to ANRHI, but if so there must be a one-to-one map between ANRHI and ANRHIC within a given PARAM. ANRHIC should not be used to categorize the values of ANRHI. Within a given parameter, if there exists a row on which both ANRHIC and ANRHI are populated, then there must be a one-to-one mapping between ANRHIC and ANRHI on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either ANRHI -or ANRHIC be included when determining whether the one-to-one mapping requirement is satisfied.) On a given record, it is permissible for ANRHI, ANRHIC, or both to be null." -AyLO,Analysis Range y Lower Limit,Num *,,Cond,"AyLO and/or AyHI are used for analysis ranges other than the normal range. AyLO and/or AyHI are created to capture the different levels of cutoff values used to determine whether an analysis is within a clinically acceptable value range or outside that value range. AyLO and/or AyHI are -usually but not necessarily constants, parameter-specific constants, or subject-specific constants. AyLO must be included if R2AyLO is included in the dataset." -AyLOC,Analysis Range y Lower Limit (C),Char,,Perm,"Character analysis range y lower limit. AyLOC can be a character string mapping to AyLO, but if so there must be a one-to-one map between AyLO and AyLOC within a given PARAM. AyLOC should not be used to categorize the values of AyLO. Within a given parameter, if there exists a row on which both AyLOC and AyLO are populated, then there must be a one-to-one mapping between AyLOC and AyLO on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either AyLO or AyLOC be included when determining whether the one-to-one mapping requirement is satisfied.) On a given record, it is -permissible for AyLO, AyLOC, or both to be null." -AyHI,Analysis Range y Upper Limit,Num *,,Cond,"See AyLO. -For example, if ECG QTc values are summarized based on values >450, values >480, and values ->500, there is a need for 3 “hi value” range variables against which to compare values: A1HI=450, A2HI=480, A3HI=500. -AyHI must be included if R2AyHI is included in the dataset." -AyHIC,Analysis Range y Upper Limit (C),Char,,Perm,"Character analysis range y upper limit. AyHIC can be a character string mapping to AyHI, but if so there must be a one-to-one map between AyHI and AyHIC within a given PARAM. AyHIC should not be used to categorize the values of AyHI. Within a given parameter, if there exists a row on which both AyHIC and AyHI are populated, then there must be a one-to-one mapping between AyHIC and AyHI on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either AyHI or AyHIC be included when determining -whether the one-to-one mapping requirement is satisfied.) On a given record, it is permissible for AyHI, AyHIC, or both to be null." -AyIND,"Analysis Range y -Indicator",Char,,Perm,"Indicates relationship of AVAL to the analysis range variables AyLO and/or AyHI, or the -relationship of AVALC to the analysis range variables AyLOC and/or AyHIC." -ByIND,"Baseline Analysis -Range y Indicator",Char,,Perm,AyIND of the baseline record identified by ABLFL. diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Dose_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Dose_Variables.csv deleted file mode 100644 index b7bf289..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Dose_Variables.csv +++ /dev/null @@ -1,4 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -DOSExxP,Planned Treatment Dose for Period xx,Num,,Perm,Subject-level identifier that represents the planned treatment dosage for period xx. -DOSExxA,Actual Treatment Dose for Period xx,Num,,Perm,Subject-level identifier that represents the actual treatment dosage for period xx. -DOSExxU,Units for Dose for Period xx,Char,,Perm,"The units for DOSExxP and DOSExxA. It is permissible to use suffixes such as ""P"" and ""A"" if needed, with labels modified accordingly." diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Identifier_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Identifier_Variables.csv deleted file mode 100644 index 764aae4..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Identifier_Variables.csv +++ /dev/null @@ -1,11 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -STUDYID,Study Identifier,Char,,Req,DM.STUDYID -USUBJID,Unique Subject Identifier,Char,,Req,DM.USUBJID -SUBJID,Subject Identifier for the Study,Char,,Req,"DM.SUBJID. SUBJID is required in ADSL, but permissible in other datasets." -SITEID,Study Site Identifier,Char,,Req,"DM.SITEID. SITEID is required in ADSL, but permissible in other datasets." -SITEGRy,Pooled Site Group y,Char,,Perm,"Character description of a grouping or pooling of clinical sites for analysis purposes. For example, SITEGR3 is the name of a variable containing site group (pooled site) names, where the grouping has been done according to the third site grouping algorithm, defined in variable metadata; SITEGR3 does not mean the third group of sites." -SITEGRyN,Pooled Site Group y (N),Num,,Perm,"Numeric representation of SITEGRy. There must be a one-to-one relationship between SITEGRyN and SITEGRy within a study. -SITEGRyN cannot be present unless SITEGRy is also present. When SITEGRy and SITEGRyN are present, then on a given record, either both must be populated or both must be null." -REGIONy,Geographic Region y,Char,,Perm,"Character description of geographical region. For example, REGION1 might have values of ""Asia"", ""Europe"", ""North America"", ""Rest of World""; REGION2 might have values of ""United States"", ""Rest of World""." -REGIONyN,Geographic Region y (N),Num,,Perm,"Numeric representation of REGIONy. Orders REGIONy for analysis and reporting.There must be a one-to-one relationship between REGIONyN and REGIONy within a study. -REGIONyN cannot be present unless REGIONy is also present. When REGIONy and REGIONyN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Population_Indicator_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Population_Indicator_Variables.csv deleted file mode 100644 index a3cc616..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Population_Indicator_Variables.csv +++ /dev/null @@ -1,11 +0,0 @@ -Variable Name,Variable Label,,Type,Codelist/ Controlled Terms,Core,CDISC Notes -FASFL,Full Analysis Set Population Flag,,Char,"Y, N",Cond,"These flags identify whether or not the subject is included in the specified population. A minimum of one subject-level population flag variable is required in ADSL. -Not all of the indicators listed here need to be included in ADSL. As stated in Section 3.1.4, Flag Variable Conventions, only those indicators corresponding to populations defined in the statistical analysis plan or populations used as a basis for analysis need be included in ADSL. -This list of flags is not meant to be all-inclusive. Additional population flags may be added. -The values of subject-level population flags cannot be blank. If a flag is used, the corresponding numeric version (*FN, where 0 = No and 1 = Yes) of the population flag can also be included. Please also refer to Section 3.1.4, Flag Variable Conventions." -SAFFL,Safety Population Flag,,Char,"Y, N",Cond, -ITTFL,Intent-To-Treat Population Flag,,Char,"Y, N",Cond, -PPROTFL,Per-Protocol Population Flag,,Char,"Y, N",Cond, -COMPLFL,Completers Population Flag,,Char,"Y, N",Cond, -RANDFL,Randomized Population Flag,,Char,"Y, N",Cond, -ENRLFL,Enrolled Population Flag,,Char,"Y, N",Cond, diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Stratification_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Stratification_Variables.csv deleted file mode 100644 index d06ab7e..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Stratification_Variables.csv +++ /dev/null @@ -1,18 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -STRATAR,Strata Used for Randomization,Char,,Perm,"STRATAR contains the combination of values of the individual stratification factors used for randomization. The exact format should be determined by the sponsor. This variable is intended for studies that use stratified randomization. -For example, "">=50, Treatment experienced, N""" -STRATARN,Strata Used for Randomization (N),Num,,Perm,"Numeric representation of STRATAR. For example, STRATARN=3 when STRATAR="">=50, Treatment experienced, N"". There must be a one-to-one relationship between STRATARN and STRATAR within a study. -STRATARN cannot be present unless STRATAR is also present. When STRATAR and STRATARN are present, then on a given record, either both must be populated or both must be null." -STRATwD,Description of Stratification Factor w,Char,,Perm,"STRATwD is a full text description of the stratification factor ""w"". This text description will remain constant for all subjects. These descriptive variables are included to quickly and clearly communicate critical study design information as well as to facilitate integration. -For example, STRAT3D=""Hypertension""" -STRATwR,Strat Factor w Value Used for Rand,Char,,Perm,"STRATwR is the subject-level value of the ""w'th"" stratification factor used for randomization. -For example, STRAT3R=""N""" -STRATwRN,Strat Factor w Value Used for Rand (N),Num,,Perm,"Numeric representation of STRATwR. For example, STRAT3RN=0 when STRAT3R=""N"". There must be a one-to-one relationship between STRATwRN and STRATwR within a study. -STRATwRN cannot be present unless STRATwR is also present. When STRATwR and STRATwRN are present, then on a given record, either both must be populated or both must be null." -STRATAV,Strata from Verification Source,Char,,Perm,"STRATAV contains the entire string value represents the combination of values of the individual stratification factors that should have been used and represents the ""as verified"" value. The STRATAV variables are based on the source documentation and are determined after randomization. If the values used for the randomization of a given subject were all correct, then STRATAV will equal STRATAR. Otherwise, one or more components of the text string for STRATAR and STRATAV will be different. -The exact format should be determined by the sponsor. For example, "">=50, Treatment experienced, Y""" -STRATAVN,Strata from Verification Source (N),Num,,Perm,"Numeric representation of STRATAV. For example, STRATAVN=4 when STRATVR="">=50, Treatment experienced, Y"". There must be a one-to-one relationship between STRATAVN and STRATAV within a study. -STRATAVN cannot be present unless STRATAV is also present. When STRATAV and STRATAVN are present, then on a given record, either both must be populated or both must be null." -STRATwV,Strat Factor w Value from Verif Source,Char,,Perm,"STRATwV is the ""as verified"" subject-level value of the ""w'th"" stratification factor. If the value based on randomization was correct, then STRATwV will equal STRATwR. For example, STRAT3V=""Y""" -STRATwVN,Strat Fact w Val from Verif Source (N),Num,,Perm,"Numeric representation of STRATwV. For example, STRAT3VN=1 when STRAT3V=""Y"". There must be a one-to-one relationship between STRATwVN and STRATwV within a study. -STRATwVN cannot be present unless STRATwV is also present. When STRATwV and STRATwVN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Subject_Demographics_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Subject_Demographics_Variables.csv deleted file mode 100644 index 1a26ac3..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Subject_Demographics_Variables.csv +++ /dev/null @@ -1,12 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -AGE,Age,Num,,Req,"DM.AGE. If analysis needs require a derived age that does not match DM.AGE, then AAGE must be added" -AGEU,Age Units,Char,(AGEU),Req,DM.AGEU -AGEGRy,Pooled Age Group y,Char,,Perm,"Character description of a grouping or pooling of the subject's age for analysis purposes. For example, AGEGR1 might have values of ""<18"", ""18-65"", and "">65""; AGEGR2 might have values of ""Less than 35 y old"" and ""At least 35 y old""." -AGEGRyN,Pooled Age Group y (N),Num,,Perm,"Numeric representation of AGEGRy. Orders the grouping or pooling of subject age for analysis and reporting. There must be a one-to-one relationship between AGEGRyN and AGEGRy within a study. -AGEGRyN cannot be present unless AGEGRy is also present. When AGEGRy and AGEGRyN are present, then on a given record, either both must be populated or both must be null." -AAGE,Analysis Age,Num,,Cond,Age used for analysis that may be derived differently than DM.AGE. AAGE is required if age is calculated differently than DM.AGE. -SEX,Sex,Char,(SEX),Req,DM.SEX. -RACE,Race,Char,(RACE),Req,DM.RACE. -RACEGRy,Pooled Race Group y,Char,,Perm,Character description of a grouping or pooling of the subject's race for analysis purposes. -RACEGRyN,Pooled Race Group y (N),Num,,Perm,"Numeric representation of RACEGRy. Orders the grouping or pooling of subject race for analysis and reporting. There must be a one-to-one relationship between RACEGRyN and RACEGRy within a study. -RACEGRyN cannot be present unless RACEGRy is also present. When RACEGRy and RACEGRyN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Subject_Level_Trial_Experience_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Subject_Level_Trial_Experience_Variables.csv deleted file mode 100644 index a31a1be..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Subject_Level_Trial_Experience_Variables.csv +++ /dev/null @@ -1,38 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -EOSSTT,End of Study Status,Char,(SBJTSTAT),Perm,"The subject's status as of the end of study or data cutoff. Examples: COMPLETED, DISCONTINUED, ONGOING." -EOSDT,End of Study Date,Num,,Perm,Date subject ended the study - either date of completion or date of discontinuation or data cutoff date for interim analyses. -DCSREAS,Reason for Discontinuation from Study,Char,,Perm,Reason for subject's discontinuation from study. The source would most likely be the SDTM DS dataset. Null for subjects who completed the study. -DCSREASP,Reason Spec for Discont from Study,Char,,Perm,"Additional detail regarding subject's discontinuation from study (e.g., description of ""other"")." -EOTSTT,End of Treatment Status,Char,(SBJTSTAT),Perm,"The subject's status as of the end of treatment or data cutoff. Examples: COMPLETED, DISCONTINUED, ONGOING." -DCTREAS,Reason for Discontinuation of Treatment,Char,,Perm,"If a subject discontinued treatment in the study, then this variable indicates the reason for discontinuation. This is for discontinuation of treatment in the overall study and not to be used for discontinuation reason within individual treatment periods." -DCTREASP,Reason Specify for Discont of Treatment,Char,,Perm,"Additional detail regarding subject's discontinuation from treatment (e.g., description of ""other"")." -EOTxxSTT,End of Treatment Status in Period xx,Char,(SBJTSTAT),Perm,"The subject's treatment status as of the end of period xx, or data cutoff if within period xx. Examples: COMPLETED, DISCONTINUED, ONGOING." -DCTxxRS,Reason for Discont of Treat in Period xx,Char,,Perm,Reason for discontinuing treatment in period xx. -DCTxxRSP,Reason Spec for Disc of Trt in Period xx,Char,,Perm,"Additional detail regarding subject's discontinuation of treatment in period xx (e.g., description of ""other"")." -EOPxxSTT,End of Period xx Status,Char,(SBJTSTAT),Perm,"The subject's status as of the end of period xx, or data cutoff if within period xx. Examples: COMPLETED, DISCONTINUED, ONGOING." -DCPxxRS,Reason for Discont from Period xx,Char,,Perm,Reason for discontinuing analysis period xx. -DCPxxRSP,Reason Spec for Discont from Period xx,Char,,Perm,"Additional detail regarding subject's discontinuation from period xx (e.g., description of ""other"")." -RFICDT,Date of Informed Consent,Num,,Perm,Date subject gave informed consent. Generally equivalent to DM.RFICDTC. -ENRLDT,Date of Enrollment,Num,,Perm,Date of subject's enrollment into trial. -RANDDT,Date of Randomization,Num,,Cond,Required in randomized trials. -RFICyDT,Date of Informed Consent y,Num,,Perm,"This variable may be used in the case where there are multiple consent dates within a study. This date does not need to repeat the date in RFICDT. ""y"" can start with 1 but it is not required to start with 1." -ENRLyDT,Date of Enrollment y,Num,,Perm,"This variable may be used in the case where there are multiple enrollment dates within a study. This date does not need to repeat the date in ENRLDT. ""y"" can start with 1 but it is not required to start with 1." -RANDyDT,Date of Randomization y,Num,,Perm,"This variable may be used in the case where there are multiple randomization dates within a study. This date does not need to repeat the date in RANDDT. ""y"" can start with 1 but it is not required to start with 1." -LSTALVDT,Date Last Known Alive,Num,,Perm,"If this variable is included in ADSL, the best practice is to populate it for everyone. If the derivation for subjects who died differs from the derivation for subjects who are not known to have died, the differences should be noted in metadata." -TRCMP,Treatment Compliance (%),Num,,Perm,Overall percent compliance with treatment in the trial. TRCMP may be useful for inclusion in ADSL for reasons such as defining subgroups and/or populations. -TRCMPGy,Treatment Compliance (%) Group y,Char,,Perm,"Grouping ""y"" of TRCMP, treatment compliance percentage." -TRCMPGyN,Treatment Compliance (%) Group y (N),Num,,Perm,"Numeric representation of treatment compliance (%) grouping ""y"". There must be a one-to-one relationship between TRCMPGyN and TRCMPGy within a study. -TRCMPGyN cannot be present unless TRCMPGy is also present. When TRCMPGy and TRCMPGyN are present, then on a given record, either both must be populated or both must be null." -TRxxDURD,Treatment Duration in Period xx (Days),Num,,Perm,"Treatment duration for period xx as measured in days. More than one of TRxxDURD, TRxxDURM, and TRxxDURY can be populated, but each represents the entire duration in its respective units." -TRxxDURM,Treatment Duration in Period xx (Months),Num,,Perm,"Treatment duration for period xx, as measure in months. More than one of TRxxDURD, TRxxDURM, and TRxxDURY can be populated, but each represents the entire duration in its respective units." -TRxxDURY,Treatment Duration in Period xx (Years),Num,,Perm,"Treatment duration for period xx, as measured in years. More than one of TRxxDURD, TRxxDURM, and TRxxDURY can be populated, but each represents the entire duration in its respective units." -TRTDURD,Total Treatment Duration (Days),Num,,Perm,"Total treatment duration, as measured in days. More than one of TRTDURD, TRTDURM, and TRTDURY can be populated, but each represents the entire duration in its respective units." -TRTDURM,Total Treatment Duration (Months),Num,,Perm,"Total treatment duration, as measured in months. More than one of TRTDURD, TRTDURM, and TRTDURY can be populated, but each represents the entire duration in its respective units." -TRTDURY,Total Treatment Duration (Years),Num,,Perm,"Total treatment duration, as measured in years. More than one of TRTDURD, TRTDURM, and TRTDURY can be populated, but each represents the entire duration in its respective units." -DTHDT,Date of Death,Num,,Perm,Date of subject's death. Derived from DM.DTHDTC. -DTHDTF,Date of Death Imputation Flag,Char,(DATEFL),Cond,"Imputation flag for date of subject's death. If DTHDT was imputed, DTHDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -DTHCAUS,Cause of Death,Char,,Perm,Cause of Death. -DTHCAUSN,Cause of Death (N),Num,,Perm,"Numeric representation of cause of death. There must be a one-to-one relationship between DTHCAUSN and DTHCAUS within a study. DTHCAUSN cannot be present unless DTHCAUS is also present. When DTHCAUS and DTHCAUSN are present, then on a given record, either both must be populated or both must be null." -DTHCGRy,Cause of Death Group y,Char,,Perm,"Grouping ""y"" of DTHCAUS, the subject's cause of death." -DTHCGRyN,Cause of Death Group y (N),Num,,Perm,"Numeric representation of grouping ""y"" of the subject's cause of death. There must be a one-to-one relationship between DTHCGRyN and DTHCGRy within a study. -DTHCGyN cannot be present unless DTHCGy is also present. When DTHCGy and DTHCGyN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Treatment_Timing_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Treatment_Timing_Variables.csv deleted file mode 100644 index 6a997d6..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Treatment_Timing_Variables.csv +++ /dev/null @@ -1,22 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -TRTSDT,Date of First Exposure to Treatment,Num,,Cond,"Date of first exposure to treatment for a subject in a study. TRTSDT and/or TRTSDTM are required if there is an investigational product. Note that TRTSDT is not required to have the same value as the SDTM DM variable RFXSTDTC. While both of these dates reflect the concept of first exposure, the ADaM date may be derived to support the analysis which may not necessarily -be the very first date in the SDTM EX domain." -TRTSTM,Time of First Exposure to Treatment,Num,,Perm,Time of first exposure to treatment for a subject in a study. -TRTSDTM,Datetime of First Exposure to Treatment,Num,,Cond,Datetime of first exposure to treatment for a subject in a study. TRTSDT and/or TRTSDTM are required if there is an investigational product. -TRTSDTF,Date of First Exposure Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of date of first exposure to treatment. If TRTSDT (or the date part of TRTSDTM) was imputed, TRTSDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -TRTSTMF,Time of First Exposure Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of time of first exposure to treatment. If TRTSTM (or the time part of TRTSDTM) was imputed, TRTSTMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -TRTEDT,Date of Last Exposure to Treatment,Num,,Cond,"Date of last exposure to treatment for a subject in a study. TRTEDT and/or TRTEDTM are required if there is an investigational product. Note that TRTEDT is not required to have the same value as the SDTM DM variable RFXENDTC. While both of these dates reflect the concept of last exposure, the ADaM date may be derived to support the analysis which may not necessarily be the very last date in the SDTM EX domain." -TRTETM,Time of Last Exposure to Treatment,Num,,Perm,Time of last exposure to treatment for a subject in a study. -TRTEDTM,Datetime of Last Exposure to Treatment,Num,,Cond,Datetime of last exposure to treatment for a subject in a study. TRTEDT and/or TRTEDTM are required if there is an investigational product. -TRTEDTF,Date of Last Exposure Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of date of last exposure to treatment. If TRTEDT (or the date part of TRTEDTM) was imputed, TRTEDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -TRTETMF,Time of Last Exposure Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of time of last exposure to treatment. If TRTETM (or the time part of TRTEDTM) was imputed, TRTETMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -TRxxSDT,Date of First Exposure in Period xx,Num,,Cond,"Date of first exposure to treatment in period xx. TRxxSDT and/or TRxxSDTM are only required in trial designs where multiple treatment periods are defined (i.e., required when there is a TRTxxP other than TRT01P). Examples include crossover designs or designs where multiple periods exist for the same treatment." -TRxxSTM,Time of First Exposure in Period xx,Num,,Cond,"Starting time of exposure to treatment in period xx. TRxxSTM and/or TRxxSDTM are only required in trial designs where starting time is important to the analysis and multiple treatment periods are defined (i.e., required when there is a TRTxxP other than TRT01P)." -TRxxSDTM,Datetime of First Exposure in Period xx,Num,,Cond,"Datetime of first exposure to treatment in period xx. TRxxSDTM is only required in trial designs where multiple treatment periods are defined (i.e., required when there is a TRTxxP other than TRT01P)." -TRxxSDTF,Date 1st Exposure Period xx Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of date of first exposure to treatment in period xx. If TRxxSDT (or the date part of TRxxSDTM) was imputed, TRxxSDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -TRxxSTMF,Time 1st Exposure Period xx Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of time of first exposure to treatment in period xx. If TRxxSTM (or the time part of TRxxSDTM) was imputed, TRxxSTMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -TRxxEDT,Date of Last Exposure in Period xx,Num,,Cond,"Date of last exposure to treatment in period xx. TRxxEDT and/or TRxxEDTM are only required in trial designs where multiple treatment periods are defined (i.e., required when there is a TRTxxP other than TRT01P)." -TRxxETM,Time of Last Exposure in Period xx,Num,,Cond,"Ending time of exposure to treatment in period xx. TRxxETM and/or TRxxEDTM are only required in trial designs where ending time is important to the analysis and multiple treatment periods are defined (i.e., required when there is a TRTxxP other than TRT01P)." -TRxxEDTM,Datetime of Last Exposure in Period xx,Num,,Cond,"Datetime of last exposure to treatment in period xx. TRxxEDTM is only required in trial designs where multiple treatment periods are defined (i.e., required when there is a TRTxxP other than TRT01P)." -TRxxEDTF,Date Last Exposure Period xx Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of date of last exposure to treatment in period xx. If TRxxEDT (or the date part of TRxxEDTM) was imputed, TRxxEDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -TRxxETMF,Time Last Exposure Period xx Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of time of last exposure to treatment in period xx. If TRxxETM (or the time part of TRxxEDTM) was imputed, TRxxETMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." diff --git a/data-raw/ig_source/adamig_1.2/ADSL_Treatment_Variables.csv b/data-raw/ig_source/adamig_1.2/ADSL_Treatment_Variables.csv deleted file mode 100644 index b5be374..0000000 --- a/data-raw/ig_source/adamig_1.2/ADSL_Treatment_Variables.csv +++ /dev/null @@ -1,27 +0,0 @@ -Variable Name,,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ARM,,Description of Planned Arm,Char,,Req,DM.ARM -ACTARM,,Description of Actual Arm,Char,,Perm,DM.ACTARM -TRTxxP,,Planned Treatment for Period xx,Char,,Req,"Subject-level identifier that represents the planned treatment for period xx. In a one-period randomized trial, TRT01P would be the treatment to which the subject was randomized. TRTxxP might be derived from the SDTM DM variable ARM. At least TRT01P is required." -TRTxxPN,,Planned Treatment for Period xx (N),Num,,Perm,"Numeric representation of TRTxxP. There must be a one- to-one relationship between TRTxxPN and TRTxxP within a study. -TRTxxPN cannot be present unless TRTxxP is also present. When TRTxxP and TRTxxPN are present, then on a given record, either both must be populated or both must be null." -TRTxxA,,Actual Treatment for Period xx,Char,,Cond,Subject-level identifier that represents the actual treatment for the subject for period xx. Required when actual treatment does not match planned and there is an analysis of the data as treated. -TRTxxAN,,Actual Treatment for Period xx (N),Num,,Perm,"Numeric representation of TRTxxA. There must be a -one-to-one relationship between TRTxxAN and TRTxxA within a study. TRTxxAN cannot be present unless TRTxxA is also present. When TRTxxA and TRTxxAN are present, then on a given record, either both must be populated or both must be null." -TRTSEQP,,Planned Sequence of Treatments,Char,,Cond,"Required when there is an analysis based on the sequence of treatments, for example in a crossover design. -TRTSEQP is not necessarily equal to ARM, for example if ARM contains elements that are not relevant to analysis of treatments or ARM is not fully descriptive (e.g., ""GROUP 1,"" ""GROUP 2""). When analyzing based on the sequence of treatments, TRTSEQP is required even if identical to ARM." -TRTSEQPN,,Planned Sequence of Treatments (N),Num,,Perm,"Numeric representation of TRTSEQP. There must be a one-to-one relationship between TRTSEQPN and TRTSEQP within a study. -TRTSEQPN cannot be present unless TRTSEQP is also present. When TRTSEQP and TRTSEQPN are present, then on a given record, either both must be populated or both must be null." -TRTSEQA,,Actual Sequence of Treatments,Char,,Cond,TRTSEQA is required if a situation occurred in the conduct of the trial where a subject received a sequence of treatments other than what was planned and there is an analysis based on the sequence of treatments. -TRTSEQAN,,Actual Sequence of Treatments (N),Num,,Perm,"Numeric representation of TRTSEQA. There must be a one-to-one relationship between TRTSEQAN and TRTSEQA within a study. -TRTSEQAN cannot be present unless TRTSEQA is also present. When TRTSEQA and TRTSEQAN are present, then on a given record, either both must be populated or both must be null." -TRxxPGy,,Planned Pooled Treatment y for Period xx,Char,,Perm,"Planned pooled treatment y for period xx. Useful when planned treatments (TRTxxP) in the specified period xx are pooled together for analysis according to pooling algorithm y. For example when in period 2 the first pooling algorithm dictates that all doses of Drug A (TR02PG1=""All doses of Drug A"") are pooled together for comparison to all doses of Drug B (TR02PG1=""All doses of Drug B""). Each value of TRTxxP is pooled within at most one value of TRxxPGy." -TRxxPGyN,,Planned Pooled Trt y for Period xx (N),Num,,Perm,"Numeric representation of TRxxPGy. There must be a one-to-one relationship between TRxxPGyN and TRxxPGy within a study. -TRxxPGyN cannot be present unless TRxxPGy is also present. When TRxxPGy and TRxxPGyN are present, then on a given record, either both must be populated or both must be null." -TRxxAGy,,Actual Pooled Treatment y for Period xx,Char,,Cond,Actual pooled treatment y for period xx. Required when TRxxPGy is present and TRTxxA is present. -TRxxAGyN,,Actual Pooled Trt y for Period xx (N),Num,,Perm,"Numeric representation of TRxxAGy. There must be a one-to-one relationship between TRxxAGyN and TRxxAGy within a study. TRxxAGyN cannot be present unless TRxxAGy is also present. When TRxxAGy and TRxxAGyN are present, then on a given record, either both must be populated or both must be null." -TSEQPGy,,Planned Pooled Treatment Sequence y,Char,,Perm,"Planned pooled treatment sequence y. Useful when planned treatment sequences (TRTSEQP) are pooled together for analysis according to pooling algorithm y. For example, this might be used in an analysis of an extension study when the analysis is based on what the subject received in the parent study as well as in the extension study." -TSEQPGyN,,Planned Pooled Treatment Sequence y (N),Num,,Perm,"Numeric representation of TSEQPGy. There must be a one-to-one relationship between TSEQPGyN and TSEQPGy within a study. -TSEQPGyN cannot be present unless TSEQPGy is also present. When TSEQPGy and TSEQPGyN are present, then on a given record, either both must be populated or both must be null." -TSEQAGy,,Actual Pooled Treatment Sequence y,Char,,Cond,Actual pooled treatment sequence y. Required when TSEQPGy is present and TRTSEQA is present. -TSEQAGyN,,Actual Pooled Treatment Sequence y (N),Num,,Perm,"Numeric representation of TSEQAGy. There must be a one-to-one relationship between TSEQAGyN and TSEQAGy within a study. -TSEQAGyN cannot be present unless TSEQAGy is also present. When TSEQAGy and TSEQAGyN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/Analysis_Descriptor_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Analysis_Descriptor_Variables_BDS_Datasets.csv deleted file mode 100644 index 22930fe..0000000 --- a/data-raw/ig_source/adamig_1.2/Analysis_Descriptor_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,11 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -DTYPE,Derivation Type,Char,(DTYPE),Cond,"Analysis value derivation method. DTYPE is used to denote, and must be populated, when the value of AVAL or AVALC has been imputed or derived differently than the other analysis values within the parameter. DTYPE is required to be populated even if AVAL and AVALC are null on the derived record. -Three common situations when DTYPE should be populated: -? A new row is added within a parameter with the analysis value populated based on other rows within the parameter. -? A new row is added within a parameter with the analysis value populated based on a constant value or data from other subjects. -? An analysis value (AVAL or AVALC) on an existing record is being replaced with a value based on a pre- specified algorithm. -DTYPE is used to denote analysis values that are ""special cases"" within a parameter. For each value of DTYPE, the precise derivation algorithm must be defined in analysis variable metadata, even for DTYPE values in the CDISC Controlled Terminology. The controlled terminology for DTYPE is extensible. See Section 4, Implementation Issues, Standard Solutions, and Examples for examples of the use of DTYPE. -Some examples of DTYPE values: -? LOCF = last observation carried forward. -? WOCF = worst observation carried forward. -? AVERAGE = average of values." diff --git a/data-raw/ig_source/adamig_1.2/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv deleted file mode 100644 index bb4ce66..0000000 --- a/data-raw/ig_source/adamig_1.2/Analysis_Parameter_Criteria_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,12 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -CRITy,Analysis Criterion y,Char,,Perm,"A text string identifying a pre-specified criterion within a parameter, for example SYSBP > 90. Required if CRITyFL is present. In some cases, the presence of the text string indicates that the criterion is satisfied on this record and CRITyFL is set to Y, while a null value indicates that the criterion is not satisfied or is not evaluable and is accompanied by a null value in CRITyFL. In other cases, the text string identifies the criterion being evaluated and is populated on every row for the parameter, but whether or not the criterion is satisfied is indicated by the value of the variable CRITyFL. See CRITyFL and CRITyFN. -Refer to Section 4.7, Identification of Records which Satisfy a Predefined Criterion for Analysis Purposes, for additional discussion of CRITy, CRITyFL and CRITyFN." -CRITyFL,Criterion y Evaluation Result Flag,Char,"Y or Y, N",Cond,"Character flag variable indicating whether the criterion defined in CRITy was met by the data on the record. See CRITy for more information regarding how to use CRITy and CRITyFL to indicate whether a criterion is met. Required if CRITy is present. -Refer to Section 4.7, Identification of Records which Satisfy a Predefined Criterion for Analysis Purposes, for additional discussion." -CRITyFN,Criterion y Evaluation Result Flag (N),Num,"1 or 1, 0",Perm,"Numeric representation of CRITyFL. There must be a one-to-one relationship between CRITyFN and CRITyFL within a parameter. CRITyFN cannot be present unless CRITyFL is also present. When CRITyFL and CRITyFN are present, then on a given record, either -both must be populated or both must be null." -MCRITy,Analysis Multi- Response Criterion y,Char,,Perm,"A text string identifying a pre-specified criterion within a parameter, where the criterion can have multiple responses (as opposed to CRITy which has binary responses). Required if MCRITyML is present. For example, the grade of a lab analyte is compared to the baseline grade, with the possible conditions being 0 to 1, 0 to 2, etc. The text string identifies the criterion being evaluated (for example, ""Grade increase"") and is populated on every row for the parameter; which level of the criterion is satisfied is indicated by the value of the variable MCRITyML (for example ""0 to 1"", ""0 to 2"", etc.). -See MCRITyML and MCRITyMN below, and refer to Section 4.7, Identification of Records which Satisfy a Predefined Criterion for Analysis Purposes, for additional discussion of MCRITy, MCRITyML, and MCRITyMN." -MCRITyML,Multi- Response Criterion y Evaluation,Char,,Cond,Character variable indicating which level of the criterion defined in MCRITy was met by the data on the record. See MCRITy for more information regarding how to use MCRITy and MCRITyML to indicate whether a criterion was met. Content is sponsor-defined. Required if MCRITy is present. -MCRITyMN,Multi- Response Criterion y Eval (N),Num,,Perm,"Numeric representation of MCRITyML. There must be a one-to-one relationship between MCRITyMN and MCRITyML within a parameter. Content is sponsor-defined. -MCRITyMN cannot be present unless MCRITyML is also present. When MCRITyML and MCRITyMN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/Analysis_Parameter_Variables.csv b/data-raw/ig_source/adamig_1.2/Analysis_Parameter_Variables.csv deleted file mode 100644 index 9b40752..0000000 --- a/data-raw/ig_source/adamig_1.2/Analysis_Parameter_Variables.csv +++ /dev/null @@ -1,49 +0,0 @@ -Variable Name,,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -PARAM,,Parameter,Char,,Req,"The description of the analysis parameter. PARAM must include all descriptive and qualifying information relevant to the analysis purpose of the parameter. -Some examples are: ""Supine Systolic Blood Pressure (mm Hg)"", ""Log10 (Weight (kg))"", ""Time to First Hypertension Event (Days)"", and ""Estimated Tumor Growth Rate"". PARAM should be sufficient to describe unambiguously the contents of AVAL and/or AVALC. -Examples of qualifying information that might be relevant to analysis, and are therefore candidates for inclusion in PARAM, are units, specimen type, location, position, machine type, and transformation function. There is no need to include qualifiers that are not relevant to the analysis of PARAM. In contrast to SDTM -- TEST, no additional variable is needed to further qualify PARAM. PARAM is restricted to a maximum of 200 characters. If the value of PARAM will be used as a variable label in a transposed dataset, -then the producer may wish to limit the value of PARAM to 40 characters. Such limitation to 40 characters should not compromise the integrity of the description. -PARAM is often directly usable in Clinical Study Report displays. Note that in the ADaMIG, ""parameter"" is a synonym of ""analysis parameter."" -PARAM must be present and populated on every record in a BDS dataset." -PARAMCD,,Parameter Code,Char,,Req,"The short name of the analysis parameter in PARAM. The values of PARAMCD must be no more than 8 characters in length, start with a letter (not underscore), and be comprised only of letters (A-Z), underscore (_), and numerals (0-9). These constraints will allow for a BDS dataset to be transposed in such a way that the values of PARAMCD can be used as valid ADaM variable names per Section 3.1.1, General Variable Conventions. There must be a one-to-one relationship between PARAM and PARAMCD within a dataset. -PARAMCD must be present and populated on every record in a BDS dataset." -PARAMN,,Parameter (N),Num,,Perm,"Numeric representation of PARAM. Useful for ordering and programmatic manipulation. There must be a one-to-one relationship between PARAM and PARAMN within a dataset for all parameters where PARAMN is populated. -if PARAMN is populated on any record for a PARAM, it must be populated on every record for that PARAM." -PARCATy,,Parameter Category y,Char,,Perm,"A categorization of PARAM within a dataset. For example, values of PARCAT1 might group the parameters having to do with a particular questionnaire, lab specimen type, or area of investigation. Note that PARCATy is not a qualifier for PARAM. PARAM to PARCATy is a many-to-one mapping; any given PARAM may be associated with at most one level of PARCATy (e.g., one level of PARCAT1 and one level of PARCAT2)." -PARCATyN,,Parameter Category y (N),Num,,Perm,"Numeric representation of PARCATy. Useful for the ordering of values of PARCATy or for other purposes. There must be a one-to- one relationship between PARCATy and PARCATyN within a dataset. -PARCATyN cannot be present unless PARCATy is also present. When PARCATy and PARCATyN are present, then on a given record, either both must be populated or both must be null." -AVAL,,Analysis Value,Num,,Cond,"Numeric analysis value described by PARAM. On a given record, it is permissible for AVAL, AVALC, or both to be null. AVAL is required if AVALC is not present, since either AVAL or AVALC must be present in the dataset." -AVALC,,Analysis Value (C),Char,,Cond,"Character analysis value described by PARAM. AVALC can be a character string mapping to AVAL, but if so there must be a one-to- one relationship between AVAL and AVALC within a given PARAM. AVALC should not be used to categorize the values of AVAL. Within a given parameter, if there exists a row on which both AVALC and AVAL are populated, then there must be a one-to- one relationship between AVALC and AVAL on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either AVAL or AVALC be included when determining whether the one-to-one relationship requirement is satisfied.) On a given record, it is permissible for AVAL, AVALC, or both to be null. -AVALC is required if AVAL is not present, since either AVAL or AVALC must be present in the dataset." -AVALCATy,,Analysis Value Category y,Char,,Perm,"A categorization of AVAL or AVALC within a parameter. Not necessarily a one-to-one mapping to AVAL and/or AVALC. For example, if PARAM is ""Headache Severity"" and AVAL has values 0, 1, 2, or 3, AVALCAT1 can categorize AVAL into ""None or Mild"" (for AVAL 0 or 1) and ""Moderate or Severe"" (for AVAL 2 or 3). AVALCATy is parameter variant." -AVALCAyN,,Analysis Value Category y (N),Num,,Perm,"Numeric representation of AVALCATy. Useful for ordering of values of AVALCATy or for other purposes. There must be a one- to-one relationship between AVALCAyN and AVALCATy within a parameter. -AVALCAyN cannot be present unless AVALCATy is also present. When AVALCATy and AVALCAyN are present, then on a given record, either both must be populated or both must be null." -BASE,,Baseline Value,Num,,Cond,"The subject's baseline analysis value for a parameter and baseline definition (i.e., BASETYPE) if present. BASE contains the value of AVAL copied from a record within the parameter on which ABLFL -= ""Y"". Required if dataset supports analysis or review of numeric baseline value or functions of numeric baseline value. If BASE is populated for a parameter, and BASE is non-null for a subject for that parameter, then there must be a record flagged by ABLFL for that subject and parameter. Note that a baseline record may be derived (e.g., it may be an average) in which case DTYPE must be populated on the baseline record." -BASEC,,Baseline Value (C),Char,,Perm,"The subject's baseline value of AVALC for a parameter and baseline definition (i.e., BASETYPE) if present. May be needed when AVALC is of interest. BASEC contains the value of AVALC copied from a record within the parameter on which ABLFL = ""Y"". If both AVAL and AVALC are populated within a parameter, the baseline record for AVALC must be the same record as that for AVAL. -Within a given parameter, if there exists a row on which both BASEC and BASE are populated, then there must be a one-to-one relationship between BASEC and BASE on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either BASE or BASEC be included when determining whether the one-to-one relationship requirement is satisfied.) On a given record, it is permissible for BASE, BASEC, or both to be null." -BASECATy,,Baseline Category y,Char,,Perm,"A categorization of BASE or BASEC within a parameter. Not necessarily a one-to-one mapping to BASE or BASEC. For example, if PARAM is ""Headache Severity"" and AVAL has values 0, 1, 2, or 3, BASECAT1 can categorize BASE into ""None or Mild"" (for BASE 0 or 1) and ""Moderate or Severe"" (for BASE 2 or 3)." -BASECAyN,,Baseline Category y (N),Num,,Perm,"Numeric representation of BASECATy. Useful for ordering of values of BASECATy or for other purposes. There must be a one-to- one relationship between BASECAyN and BASECATy within a parameter. BASECAyN cannot be present unless BASECATy is also present. When BASECATy and BASECAyN are present, then on a given record, either both must be populated or both must be null." -BASETYPE,,Baseline Type,Char,,Cond,"Producer-defined text describing the definition of baseline relevant to the value of BASE on the current record. Required when there are multiple ways that baseline is defined. If used for any PARAM within a dataset, should be non-null for all records for that PARAM within that dataset. Refer to Section 4.2.1.6, Rule 6, for an example." -CHG,,Change from Baseline,Num,,Perm,"Change from baseline analysis value. Equal to AVAL-BASE. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of CHG is left to producer choice." -CHGCATy,,Change from Baseline Category y,Char,,Perm,"A categorization of CHG within a parameter. Not necessarily a one- to-one mapping to CHG. The definition of CHGCATy may vary by PARAM. For example, CHGCAT1 may be used to categorize CHG with respect to ranges of change in SYSBP; ""-10 to -5 mm Hg"", ""-5 to 0 mm Hg"" categories." -CHGCATyN,,Change from Baseline Category y (N),Num,,Perm,"Numeric representation of CHGCATy. Useful for ordering of values of CHGCATy or for other purposes. There must be a one-to-one relationship between CHGCATyN and CHGCATy within a parameter. -CHGCATyN cannot be present unless CHGCATy is also present. When CHGCATy and CHGCATyN are present, then on a given record, either both must be populated or both must be null." -PCHG,,Percent Change from Baseline,Num,,Perm,"Percent change from baseline analysis value. Equal to ((AVAL- BASE)/BASE)*100. If used for a given PARAM, should be populated (when calculable) for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of PCHG is left to producer choice." -PCHGCATy,,Percent Chg from Baseline Category y,Char,,Perm,"A categorization of PCHG within a parameter. Not necessarily a one-to-one mapping to PCHG. The definition of PCHGCATy may vary by PARAM. For example, PCHGCAT1 may be used to categorize PCHG with respect to ranges of change in SYSBP; "">5%"", "">10%"" categories." -PCHGCAyN,,Percent Chg from Baseline Category y (N),Num,,Perm,"Numeric representation of PCHGCATy. Useful for ordering of values of PCHGCATy or for other purposes. There must be a one- to-one relationship between PCHGCAyN and PCHGCATy within a parameter. -PCHGCAyN cannot be present unless PCHGCATy is also present. When PCHGCATy and PCHGCAyN are present, then on a given record, either both must be populated or both must be null." -R2BASE,,Ratio to Baseline,Num,,Perm,"Ratio to the baseline value. Equal to AVAL / BASE. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of R2BASE is left to producer choice." -R2AyLO,,Ratio to Analysis Range y Lower Limit,Num,,Perm,"Ratio to the lower limit of the analysis range y. Equal to AVAL / AyLO. AyLO must exist in the ADaM dataset. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of R2AyLO is left to producer choice." -R2AyHI,,Ratio to Analysis Range y Upper Limit,Num,,Perm,"Ratio to the upper limit of the analysis range y. Equal to AVAL / AyHI. AyHI must exist in the ADaM dataset. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of R2AyHI is left to producer choice." -SHIFTy,,Shift y,Char,,Perm,"A shift in values depending on the defined pairing for group y within a parameter. SHIFTy can only be based on the change in value of any of the following pairs (BASECATy, AVALCATy), (BNRIND, ANRIND), (ByIND, AyIND), (BTOXGR, ATOXGR), (BTOXGRL, ATOXGRL), (BTOXGRH, ATOXGRH), (BASE, AVAL) or -(BASEC, AVALC). Useful for shift tables. For example, ""NORMAL to HIGH"". If used for a given PARAM, should be populated (when calculable) for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate baseline and pre-baseline values of SHIFTy is left to producer choice." -SHIFTyN,,Shift y (N),Num,,Perm,"Numeric representation of SHIFTy. There must be a one-to-one relationship between SHIFTyN and SHIFTy within a parameter.SHIFTyN cannot be present unless SHIFTy is also present. When SHIFTy and SHIFTyN are present, then on a given record, either both must be populated or both must be null.If SHIFTyN is used for a given PARAM, SHIFTy and SHIFTyN should be populated (when calculable) for all post-baseline records of that PARAM regardless of whether that record is used for analysis." -BCHG,,Change to Baseline,Num,,Perm,"Change to baseline analysis value. Equal to BASE-AVAL. If used for a given PARAM, should be populated for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of BCHG is left to producer choice." -BCHGCATy,,Change to Baseline Category y,Char,,Perm,"A categorization of BCHG within a parameter. Not necessarily a one-to-one mapping to BCHG. The definition of BCHGCATy may vary by PARAM. For example, BCHGCAT1 may be used to categorize BCHG with respect to ranges of change in SYSBP; ""-10 to -5 mm Hg"", ""-5 to 0 mm Hg"" categories." -BCHGCAyN,,Change to Baseline Category y (N),Num,,Perm,"Numeric representation of BCHGCATy. Useful for ordering of values of BCHGCATy or for other purposes. There must be a one- to-one relationship between BCHGCAyN and BCHGCATy within a parameter. -BCHGCAyN cannot be present unless BCHGCATy is also present. When BCHGCATy and BCHGCAyN are present, then on a given record, either both must be populated or both must be null." -PBCHG,,Percent Change to Baseline,Num,,Perm,"Percent change to baseline analysis value. Equal to ((BASE- AVAL)/AVAL)*100. If used for a given PARAM, should be populated (when calculable) for all post-baseline records of that PARAM regardless of whether that record is used for analysis. The decision on how to populate pre-baseline and baseline values of PBCHG is left to producer choice" -PBCHGCAy,,Percent Change to Baseline Category y,Char,,Perm,"A categorization of PBCHG within a parameter. Not necessarily a one-to-one mapping to PBCHG. The definition of PBCHGCAy may vary by PARAM. For example, PBCHGCA1 may be used to categorize PBCHG with respect to ranges of change in SYSBP; "">5%"", "">10%"" categories." -PBCHGCyN,,Percent Change to Baseline Category y (N),Num,,Perm,"Numeric representation of PBCHGCAy. Useful for ordering of values of PBCHGCAy or for other purposes. There must be a one- to-one relationship between PBCHGCyN and PBCHGCAy within a parameter. -PBCHGCyN cannot be present unless PBCHGCAy is also present. When PBCHGCAy and PBCHGCyN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv deleted file mode 100644 index 194c59b..0000000 --- a/data-raw/ig_source/adamig_1.2/Analysis_Visit_Windowing_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,8 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -AWRANGE,Analysis Window Valid Relative Range,Char,,Perm,"The range of values that are valid for a given analysis timepoint (a given value of AVISIT). For example, ""5-9 DAYS""." -AWTARGET,Analysis Window Target,Num,,Perm,The target or most desired analysis relative day (ADY) value or analysis relative time (ARELTM) value for a given value of AVISIT. -AWTDIFF,Analysis Window Diff from Target,Num,,Perm,"Absolute difference between ADY or ARELTM and AWTARGET. It will be necessary to adjust for the fact that there is no Day 0 in the event that ADY and AWTARGET are not of the same sign. -If the sign of the difference is important, then AWTDIFF might have to be used in conjunction with ADY or ARELTM and possibly AWTARGET when choosing among records." -AWLO,Analysis Window Beginning Timepoint,Num,,Perm,"The value of the beginning timepoint (inclusive) needs to be used in conjunction to AWRANGE. For example, if AWRANGE is ""5-9 DAYS"", then AWLO is ""5""." -AWHI,Analysis Window Ending Timepoint,Num,,Perm,"The value of the ending timepoint (inclusive) needs to be used in conjunction to AWRANGE. For example, if AWRANGE is ""5-9 DAYS"", then AWHI is ""9""." -AWU,Analysis Window Unit,Char,,Perm,"Unit used for AWTARGET, AWTDIFF, AWLO and AWHI. Examples: DAYS, HOURS." diff --git a/data-raw/ig_source/adamig_1.2/BDS_Population_Indicators.csv b/data-raw/ig_source/adamig_1.2/BDS_Population_Indicators.csv deleted file mode 100644 index ed75c48..0000000 --- a/data-raw/ig_source/adamig_1.2/BDS_Population_Indicators.csv +++ /dev/null @@ -1,15 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ITTRFL,Intent-To-Treat Record-Level Flag,Char,Y,Perm,"These indicators identify whether or not the subject was in the specified analysis for the specific record. Useful when the subject is included in the subject-level population, but there are records for the subject that do not satisfy requirements for the population. -The valid values of these record-level population indicators are Y or null. If a flag is used, the corresponding numeric version (*FN, where 1=Yes) of the flag can also be included. As described in Section 3.1.1 Item 8, the *FN version of the variable can be included only if the corresponding *FL is also included. -Additional indicators may also be used; refer to Section 3.1.4, Flag Variable Conventions." -SAFRFL,Safety Analysis Record-Level Flag,Char,Y,Perm, -FASRFL,Full Analysis Set Record-Level Flag,Char,Y,Perm, -PPROTRFL,Per-Protocol Record-Level Flag,Char,Y,Perm, -COMPLRFL,Completers Record-Level Flag,Char,Y,Perm, -ITTPFL,Intent-To-Treat Parameter-Level Flag,Char,Y,Perm,"These indicators identify whether or not the subject was in the specified analysis for the specific parameter. Useful when the subject is included in the subject-level population, but there are parameters for which the subject does not satisfy requirements for the population. -The valid values of these parameter-level population indicators are Y or null. If a flag is used, the corresponding numeric version (*FN, where 1=Yes) of the flag can also be included. As described in Section 3.1.1, Item 8, the *FN version of the variable can be included only if the corresponding *FL is also included. -Additional indicators may also be used; refer to Section 3.1.4, Flag Variable Conventions." -SAFPFL,Safety Analysis Parameter-Level Flag,Char,Y,Perm, -FASPFL,Full Analysis Set Parameter-Level Flag,Char,Y,Perm, -PPROTPFL,Per-Protocol Parameter-Level Flag,Char,Y,Perm, -COMPLPFL,Completers Parameter-Level Flag,Char,Y,Perm, diff --git a/data-raw/ig_source/adamig_1.2/Datapoint_Traceability_Variables.csv b/data-raw/ig_source/adamig_1.2/Datapoint_Traceability_Variables.csv deleted file mode 100644 index e5dd1fe..0000000 --- a/data-raw/ig_source/adamig_1.2/Datapoint_Traceability_Variables.csv +++ /dev/null @@ -1,5 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -SRCDOM,Source Data,Char,,Perm,"The SDTM domain name or ADaM dataset name that relates to the analysis value (i.e., AVAL or AVALC in a BDS dataset). If the source data is a supplemental qualifier in SDTM, this variable will contain the value of RDOMAIN in SUPP-- or SUPPQUAL." -SRCVAR,Source Variable,Char,,Perm,"The name of the column (in the domain or dataset identified by SRCDOM) that relates to the analysis value (i.e., AVAL or AVALC in a BDS dataset). In the event that SRCDOM is a SUPPQUAL, then SRCVAR will be populated with the value of the related QNAM." -SRCSEQ,Source Sequence Number,Num,,Perm,"The sequence number --SEQ or ASEQ of the row (in the domain or dataset identified by SRCDOM) that relates to the analysis value (i.e., AVAL or AVALC in a BDS dataset). In the event that SRCDOM is a SUPPQUAL, then this -variable will contain the sequence number of the relevant related domain record." diff --git a/data-raw/ig_source/adamig_1.2/Flag_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Flag_Variables_BDS_Datasets.csv deleted file mode 100644 index bc232bc..0000000 --- a/data-raw/ig_source/adamig_1.2/Flag_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,16 +0,0 @@ -Variable Name,Variable Label,,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ABLFL,Baseline Record Flag,,Char,Y,Cond,"Character indicator to identify the baseline record for each subject, parameter, and baseline type (BASETYPE) combination. See BASETYPE in Table 3.3.4.1.1. ABLFL is required if BASE is present in the dataset. -A baseline record may be derived (e.g., it may be an average), in which case DTYPE must also be populated. If BASE is populated for a parameter, and BASE is non-null for a subject for that parameter, then there must be a record flagged by ABLFL for that subject and parameter." -ABLFN,Baseline Record Flag (N),,Num,1,Perm,"Numeric representation of ABLFL. There must be a one-to- one relationship between ABLFN and ABLFL. ABLFN cannot be present unless ABLFL is also present. When ABLFL and ABLFN are present, then on a given record, either both must be populated or both must be null." -ANLzzFL,Analysis Flag zz,,Char,Y,Cond,"ANLzzFL is a conditionally required flag to be used in addition to other selection variables when the other selection variables in combination are insufficient to identify the exact set of records used for one or more analyses. Often one ANLzzFL will serve to support the accurate selection of records for more than one analysis. Note that it is allowable to add additional descriptive text to the label (see Section 3.1.6, Item 1). -When defining the set of records used in a particular analysis or family of analyses, ANLzzFL is supplemental to, and is intended to be used in conjunction with, other selection variables, such as subject-level, parameter-level and record- level population flags, AVISIT, DTYPE, grouping variables such as SITEGRy, and others. The lower-case letter ""zz"" in the variable name is an index for the zzth record selection algorithm where ""zz"" is replaced with a zero-padded two-digit integer [01-99]. Every record selection algorithm ""zz"" (i.e., every algorithm for populating an ANLzzFL) must be defined in variable metadata. When the set of records that the algorithm ""zz"" operates on is pre-filtered by application of other criteria, such as a record-level population flag, then the selection algorithm definition in the metadata must so specify. -Note that the ANLzzFL value of Y indicates that the record fulfilled the requirements of the algorithm, but does not necessarily imply that the record was actually used in one or more analyses, as whether or not a record is used also depends on the other selection variables applied. The ANLzzFL flag is useful in many circumstances; an example is when there is more than one record for an analysis timepoint within a subject and parameter, as it can be used to identify the record chosen to represent the timepoint for an analysis. ""zz"" is an index for a record selection algorithm, such as ""record closest to target relative day for the AVISIT, with ties broken by the latest record, for each AVISIT within ."" -Note that it is not required that a specific ANLzzFL variable has the same definition across a project or even across datasets within a study. There is also no requirement that the ANLzzFL variables in a dataset or study be used in numerical order; e.g. ANL02FL might occur in a dataset or study without ANL01FL present in the same dataset or study." -ANLzzFN,Analysis Flag zz (N),,Num,1,Perm,"Numeric representation of ANLzzFL. There must be a one-to- one relationship between ANLzzFN and ANLzzFL within a dataset. -ANLzzFN cannot be present unless ANLzzFL is also present. When ANLzzFL and ANLzzFN are present, then on a given record, either both must be populated or both must be null." -ONTRTFL,On Treatment Record Flag,,Char,Y,Perm,"Character indicator of whether the observation occurred while the subject was on treatment. ONTRTFL is producer-defined, and its definition may vary across datasets in a study based on analysis needs." -ONTRTFN,On Treatment Record Flag (N),,Num,1,Perm,"Numeric representation of ONTRTFL. There must be a one- to-one relationship between ONTRTFN and ONTRTFL within a dataset. -ONTRTFN cannot be present unless ONTRTFL is also present. When ONTRTFL and ONTRTFN are present, then on a given record, either both must be populated or both must be null." -LVOTFL,Last Value On Treatment Record Flag,,Char,Y,Perm,Character indicator of the subject's last non-missing value on treatment for each parameter. -LVOTFN,Last Value On Treatment Record Flag (N),,Num,1,Perm,"Numeric representation of LVOTFL. There must be a one-to- one relationship between LVOTFN and LVOTFL within a dataset. -LVOTFN cannot be present unless LVOTFL is also present. When LVOTFL and LVOTFN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/Identifier_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Identifier_Variables_BDS_Datasets.csv deleted file mode 100644 index 5c36a18..0000000 --- a/data-raw/ig_source/adamig_1.2/Identifier_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,10 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -STUDYID,Study Identifier,Char,,Req,"DM.STUDYID, ADSL STUDYID, and/or STUDYID -from another ADaM or SDTM dataset appropriate to the analysis." -USUBJID,Unique Subject Identifier,Char,,Req,"DM.USUBJID, ADSL.USUBJID, and/or USUBJID from -another ADaM or SDTM dataset appropriate to the analysis." -SUBJID,Subject Identifier for the Study,Char,,Perm,"DM.SUBJID, ADSL.SUBJID, and/or SUBJID from -another ADaM dataset appropriate to the analysis. SUBJID is required in ADSL, but permissible in other datasets." -SITEID,Study Site Identifier,Char,,Perm,"DM.SITEID, ADSL.SITEID, and/or SITEID from -another ADaM dataset appropriate to the analysis. SITEID is required in ADSL, but permissible in other datasets." -ASEQ,Analysis Sequence Number,Num,,Perm,"Sequence number given to ensure uniqueness of subject records within an ADaM dataset. As long as values are unique within a subject within the dataset, any valid number can be used for ASEQ. ASEQ uniquely indexes records within a subject within an ADaM dataset. ASEQ is useful for traceability when the dataset is used as input to another ADaM dataset. To refer to a record in a predecessor ADaM dataset, set SRCDOM to the name of the predecessor dataset, and set SRCSEQ to the value of ASEQ in the predecessor dataset." diff --git a/data-raw/ig_source/adamig_1.2/Period_Subperiod_Phase_Start_End_Timing_Variables.csv b/data-raw/ig_source/adamig_1.2/Period_Subperiod_Phase_Start_End_Timing_Variables.csv deleted file mode 100644 index 0dcac85..0000000 --- a/data-raw/ig_source/adamig_1.2/Period_Subperiod_Phase_Start_End_Timing_Variables.csv +++ /dev/null @@ -1,31 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -APERSDT,Period Start Date,Num,,Perm,The starting date for the period defined by APERIOD. -APERSTM,Period Start Time,Num,,Perm,The starting time for the period defined by APERIOD. -APERSDTM,Period Start Datetime,Num,,Perm,The starting datetime for the period defined by APERIOD. -APERSDTF,Period Start Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of period start date. If APERSDT (or the date part of APERSDTM) was imputed, APERSDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -APERSTMF,Period Start Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of period start time. If APERSTM (or the time part of APERSDTM) was imputed, APERSTMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -APEREDT,Period End Date,Num,,Perm,The ending date for the period defined by APERIOD. -APERETM,Period End Time,Num,,Perm,The ending time for the period defined by APERIOD. -APEREDTM,Period End Datetime,Num,,Perm,The ending datetime for the period defined by APERIOD. -APEREDTF,Period End Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of period end date. If APEREDT (or the date part of APEREDTM) was imputed, APEREDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -APERETMF,Period End Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of period end time. If APERETM (or the time part of APEREDTM) was imputed, APERETMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -ASPRSDT,Subperiod Start Date,Num,,Perm,The starting date for the subperiod defined by ASPER. -ASPRSTM,Subperiod Start Time,Num,,Perm,The starting time for the subperiod defined by ASPER. -ASPRSDTM,Subperiod Start Datetime,Num,,Perm,The starting datetime for the subperiod defined by ASPER. -ASPRSDTF,Subperiod Start Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of subperiod start date. If ASPRSDT (or the date part of ASPRSDTM) was imputed, ASPRSDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -ASPRSTMF,Subperiod Start Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of subperiod start time. If ASPRSTM (or the time part of ASPRSDTM) was imputed, ASPRSTMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -ASPREDT,Subperiod End Date,Num,,Perm,The ending date for the subperiod defined by ASPER. -ASPRETM,Subperiod End Time,Num,,Perm,The ending time for the subperiod defined by ASPER. -ASPREDTM,Subperiod End Datetime,Num,,Perm,The ending datetime for the subperiod defined by ASPER. -ASPREDTF,Subperiod End Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of subperiod end date. If ASPREDT (or the date part of ASPREDTM) was imputed, ASPREDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -ASPRETMF,Subperiod End Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of subperiod end time. If ASPRETM (or the time part of ASPREDTM) was imputed, ASPRETMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -PHSDT,Phase Start Date,Num,,Perm,The starting date for the phase defined by APHASE. -PHSTM,Phase Start Time,Num,,Perm,The starting time for the phase defined by APHASE. -PHSDTM,Phase Start Datetime,Num,,Perm,The starting datetime for the phase defined by APHASE. -PHSDTF,Phase Start Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of phase start date. If PHSDT (or the date part of PHSDTM) was imputed, PHSDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -PHSTMF,Phase Start Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of phase start time. If PHSTM (or the time part of PHSDTM) was imputed, PHSTMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -PHEDT,Phase End Date,Num,,Perm,The ending date for the phase defined by APHASE. -PHETM,Phase End Time,Num,,Perm,The ending time for the phase defined by APHASE. -PHEDTM,Phase End Datetime,Num,,Perm,The ending datetime for the phase defined by APHASE. -PHEDTF,Phase End Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of phase end date. If PHEDT (or the date part of PHEDTM) was imputed, PHEDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -PHETMF,Phase End Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of phase end time. If PHETM (or the time part of PHEDTM) was imputed, PHETMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." diff --git a/data-raw/ig_source/adamig_1.2/Record_Level_Dose_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Record_Level_Dose_Variables_BDS_Datasets.csv deleted file mode 100644 index 1b31fb5..0000000 --- a/data-raw/ig_source/adamig_1.2/Record_Level_Dose_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,6 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -DOSEP,Planned Treatment Dose,Num,,Perm,DOSEP represents the planned treatment dosage associated with the record. -DOSCUMP,Cumulative Planned Treatment Dose,Num,,Perm,"Cumulative planned dosage of treatment for the subject at the point in time of the record (e.g., ADT)." -DOSEA,Actual Treatment Dose,Num,,Perm,DOSEA represents the actual treatment dosage associated with the record. -DOSCUMA,Cumulative Actual Treatment Dose,Num,,Perm,"Cumulative actual dosage of treatment for the subject at the point in time of the record (e.g., ADT)." -DOSEU,Treatment Dose Units,Char,,Perm,"The units for DOSEP, DOSCUMP, DOSEA, and DOSCUMA. It is permissible to use suffixes such as ""P"" and ""A"" if needed, with labels modified accordingly." diff --git a/data-raw/ig_source/adamig_1.2/Record_Level_Treatment_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Record_Level_Treatment_Variables_BDS_Datasets.csv deleted file mode 100644 index 336723e..0000000 --- a/data-raw/ig_source/adamig_1.2/Record_Level_Treatment_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,16 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -TRTP,Planned Treatment,Char,,Cond,"TRTP is a record-level identifier that represents the planned treatment attributed to a record for analysis purposes. TRTP indicates how treatment varies by record within a subject and enables analysis of crossover and other designs. Though there is no requirement that TRTP will correspond to the TRTxxP as defined by the record's value of APERIOD, if populated, TRTP must match at least one value of the character planned treatment variables in ADSL (e.g., TRTxxP, TRTSEQP, TRxxPGy). -As noted previously, at least one treatment variable is required even in non-randomized trials. This requirement is satisfied by any subject-level or record-level treatment variables (e.g., TRTxxP, TRTP, TRTA). Even if not used for analysis, any ADSL treatment variable may be included in the BDS dataset." -TRTPN,Planned Treatment (N),Num,,Perm,"Numeric representation of TRTP. There must be a one- to-one relationship between TRTPN and TRTP within a study. -TRTPN cannot be present unless TRTP is also present. When TRTP and TRTPN are present, then on a given record, either both must be populated or both must be null." -TRTA,Actual Treatment,Char,,Cond,"TRTA is a record-level identifier that represents the actual treatment attributed to a record for analysis purposes. TRTA indicates how treatment varies by record within a subject and enables analysis of crossover and other multi-period designs. Though there is no requirement that TRTA will correspond to the TRTxxA as defined by the record's value of APERIOD, TRTA must match at least one value of the character actual treatment variables in ADSL (e.g., TRTxxA, TRTSEQA, TRxxAGy). -As noted previously, at least one treatment variable is required. This requirement is satisfied by any subject-level or record-level treatment variables (e.g., TRTxxP, TRTP, TRTA). Even if not used for analysis, any ADSL treatment variable may be included in the BDS dataset." -TRTAN,Actual Treatment (N),Num,,Perm,"Numeric representation of TRTA. There must be a one- to-one relationship between TRTAN and TRTA within a study. -TRTAN cannot be present unless TRTA is also present. When TRTA and TRTAN are present, then on a given record, either both must be populated or both must be null." -TRTPGy,Planned Pooled Treatment y,Char,,Perm,"TRTPGy is the planned pooled treatment y attributed to a record for analysis purposes. ""y"" represents an integer [1- 99, not zero-padded] corresponding to a particular pooling scheme. Useful when planned treatments (TRTP) are pooled together for analysis, for example when all doses of Drug A (TRTPG1=All doses of Drug A) are compared to all doses of Drug B (TRTPG1=All doses of Drug B). Each value of TRTP is pooled within at most one value of TRTPGy." -TRTPGyN,Planned Pooled Treatment y (N),Num,,Perm,"Numeric representation of TRTPGy. There must be a -one-to-one relationship between TRTPGyN and TRTPGy within a study. -TRTPGyN cannot be present unless TRTPGy is also present. When TRTPGy and TRTPGyN are present, then on a given record, either both must be populated or both must be null." -TRTAGy,Actual Pooled Treatment y,Char,,Cond,"TRTAGy is the actual pooled treatment y attributed to a record for analysis purposes. ""y"" represents an integer [1- 99, not zero-padded] corresponding to a particular pooling scheme. Required when TRTPGy is present and TRTA is present." -TRTAGyN,Actual Pooled Treatment y (N),Num,,Perm,"Numeric representation of TRTAGy. There must be a one-to-one relationship between TRTAGyN and TRTAGy within a study. -TRTAGyN cannot be present unless TRTAGy is also present. When TRTAGy and TRTAGyN are present, then on a given record, either both must be populated or both must be null." diff --git a/data-raw/ig_source/adamig_1.2/Subject_Level_Period_Subperiod_Phase_Timing_Variables.csv b/data-raw/ig_source/adamig_1.2/Subject_Level_Period_Subperiod_Phase_Timing_Variables.csv deleted file mode 100644 index 2f37b6f..0000000 --- a/data-raw/ig_source/adamig_1.2/Subject_Level_Period_Subperiod_Phase_Timing_Variables.csv +++ /dev/null @@ -1,33 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -APxxSDT,Period xx Start Date,Num,,Perm,The starting date of period xx. -APxxSTM,Period xx Start Time,Num,,Perm,The starting time of period xx. -APxxSDTM,Period xx Start Datetime,Num,,Perm,The starting datetime of period xx. -APxxSDTF,Period xx Start Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of period xx start date. See Section 3.1.3, Date and Time Imputation Flag Variables." -APxxSTMF,Period xx Start Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of period xx start time. See Section 3.1.3, Date and Time Imputation Flag Variables." -APxxEDT,Period xx End Date,Num,,Perm,The ending date of period xx. -APxxETM,Period xx End Time,Num,,Perm,The ending time of period xx. -APxxEDTM,Period xx End Datetime,Num,,Perm,The ending datetime of period xx. -APxxEDTF,Period xx End Date Imput. Flag,Char,(DATEFL),Cond,"The level of imputation of period xx end date. See Section 3.1.3, Date and Time Imputation Flag Variables." -APxxETMF,Period xx End Time Imput. Flag,Char,(TIMEFL),Cond,"The level of imputation of period xx end time. See Section 3.1.3, Date and Time Imputation Flag Variables." -PxxSw,Description of Period xx Subperiod w,Char,,Perm,Description of analysis subperiod w within period xx. -PxxSwSDT,Period xx Subperiod w Start Date,Num,,Perm,The starting date of subperiod w within period xx. -PxxSwSTM,Period xx Subperiod w Start Time,Num,,Perm,The starting time of subperiod w within period xx. -PxxSwSDM,Period xx Subperiod w Start Datetime,Num,,Perm,The starting datetime of subperiod w within period xx. -PxxSwSDF,Period xx Subper w Start Date Imput Flag,Char,(DATEFL),Cond,"The level of imputation of the start date for subperiod w within period xx. See Section 3.1.3, Date and Time Imputation Flag Variables." -PxxSwSTF,Period xx Subper w Start Time Imput Flag,Char,(TIMEFL),Cond,"The level of imputation of the start time for subperiod w within period xx. See Section 3.1.3, Date and Time Imputation Flag Variables." -PxxSwEDT,Period xx Subperiod w End Date,Num,,Perm,The ending date of subperiod w within period xx. -PxxSwETM,Period xx Subperiod w End Time,Num,,Perm,The ending time of subperiod w within period xx. -PxxSwEDM,Period xx Subperiod w End Datetime,Num,,Perm,The ending datetime of subperiod w within period xx. -PxxSwEDF,Period xx Subper w End Date Imput Flag,Char,(DATEFL),Cond,"The level of imputation of the end date for subperiod w within period xx. See Section 3.1.3, Date and Time Imputation Flag Variables." -PxxSwETF,Period xx Subper w End Time Imput Flag,Char,(TIMEFL),Cond,"The level of imputation of the end time for subperiod w within period xx. See Section 3.1.3, Date and Time Imputation Flag Variables." -APHASEw,Description of Phase w,Char,,Perm,"Description of analysis phase w. Analysis phase is independent of TRTxxP within ADSL, and may be populated for spans of time where a subject is not on treatment." -PHwSDT,Phase w Start Date,Num,,Perm,The starting date of phase w. -PHwSTM,Phase w Start Time,Num,,Perm,The starting time of phase w. -PHwSDTM,Phase w Start Datetime,Num,,Perm,The starting datetime of phase w. -PHwSDTF,Phase w Start Date Imputation Flag,Char,(DATEFL),Cond,"The level of imputation of the start date for phase w. See Section 3.1.3, Date and Time Imputation Flag Variables." -PHwSTMF,Phase w Start Time Imputation Flag,Char,(TIMEFL),Cond,"The level of imputation of the start time for phase w. See Section 3.1.3, Date and Time Imputation Flag Variables." -PHwEDT,Phase w End Date,Num,,Perm,The ending date of phase w. -PHwETM,Phase w End Time,Num,,Perm,The ending time of phase w. -PHwEDTM,Phase w End Datetime,Num,,Perm,The ending datetime of phase w. -PHwEDTF,Phase w End Date Imputation Flag,Char,(DATEFL),Cond,"The level of imputation of the end date for phase w. See Section 3.1.3, Date and Time Imputation Flag Variables." -PHwETMF,Phase w End Time Imputation Flag,Char,(TIMEFL),Cond,"The level of imputation of the end time for phase w. See Section 3.1.3, Date and Time Imputation Flag Variables." diff --git a/data-raw/ig_source/adamig_1.2/Suffixes_Producer_Defined_Timing_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Suffixes_Producer_Defined_Timing_Variables_BDS_Datasets.csv deleted file mode 100644 index 21d5a85..0000000 --- a/data-raw/ig_source/adamig_1.2/Suffixes_Producer_Defined_Timing_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,23 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -*DT,{Date},Num,,Perm,Analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*TM,{Time},Num,,Perm,Analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*DTM,{Datetime},Num,,Perm,Analysis datetime not directly characterizing AVAL and/or AVALC in numeric format. -*ADY,{Relative Day},Num,,Perm,Analysis relative day not directly characterizing AVAL and/or AVALC. -*DTF,{Date Imputation Flag},Char,(DATEFL),Cond,"The level of imputation of *DT. If *DT (or the date part of *DTM) was imputed, *DTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -*TMF,{Time Imputation Flag},Char,(TIMEFL),Cond,"The level of imputation of *TM. If *TM (or the time part of *DTM) was imputed, *TMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -*SDT,{Start Date},Num,,Perm,Starting analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*STM,{Start Time},Num,,Perm,Starting analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*SDTM,{Start Datetime},Num,,Perm,Starting analysis datetime not directly characterizing AVAL and/or AVALC in numeric format. -*SDY,{Relative Start Day},Num,,Perm,Starting analysis relative day not directly characterizing AVAL and/or AVALC. -*SDTF,{Start Date Imputation Flag},Char,(DATEFL),Cond,"The level of imputation of *SDT. If *SDT (or the date part of -*SDTM) was imputed, *SDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -*STMF,{Start Time Imputation Flag},Char,(TIMEFL),Cond,"The level of imputation of *STM. If *STM (or the time part of -*SDTM) was imputed, *STMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -*EDT,{End Date},Num,,Perm,Ending analysis date not directly characterizing AVAL and/or AVALC in numeric format. -*ETM,{End Time},Num,,Perm,Ending analysis time not directly characterizing AVAL and/or AVALC in numeric format. -*EDTM,{End Datetime},Num,,Perm,Ending analysis datetime not directly characterizing AVAL and/or AVALC in numeric format. -*EDY,{Relative End Day},Num,,Perm,Ending analysis relative day not directly characterizing AVAL and/or AVALC. -*EDTF,{End Date Imputation Flag},Char,(DATEFL),Cond,"The level of imputation of *EDT. If *EDT (or the date part of -*EDTM) was imputed, *EDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -*ETMF,{End Time Imputation Flag},Char,(TIMEFL),Cond,"The level of imputation of *ETM. If *ETM (or the time part of -*EDTM) was imputed, *ETMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." diff --git a/data-raw/ig_source/adamig_1.2/Time_To_Event_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Time_To_Event_Variables_BDS_Datasets.csv deleted file mode 100644 index 294a45b..0000000 --- a/data-raw/ig_source/adamig_1.2/Time_To_Event_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,8 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,,Core,,CDISC Notes,, -STARTDT,Time-to- Event Origin Date for Subject,Num,,,Perm,,"The original date of risk for the time-to-event analysis. This is generally the point at which a subject is first at risk for the event of interest evaluation (as defined in the Protocol or SAP). For example, this may be the randomization date or the date of first study therapy exposure.",, -STARTDTM,Time-to- Event Origin Datetime,Num,,,Perm,,"The original datetime of risk for the time-to-event analysis. This is generally the point at which a subject is first at risk for the event of interest evaluation (as defined in the Protocol or SAP). For example, this may be the randomization datetime or the datetime of first study therapy exposure.",, -STARTDTF,Origin Date Imputation Flag,Char,(DATEFL),,Cond,,"The level of imputation of the start date. See Section 3.1.3, Date and Time Imputation Flag Variables.",, -STARTTMF,Origin Time Imputation Flag,Char,(TIMEFL),,Cond,,"The level of imputation of the start time. See Section 3.1.3, Date and Time Imputation Flag Variables.",, -CNSR,Censor,Num,,,Cond,,Defines whether the event was censored for the subject within the parameter (period of observation truncated prior to event being observed). It is strongly recommended to use 0 as an event indicator and positive integers as censoring indicators. It is also recommended that unique positive integers be used to indicate coded descriptions of censoring reasons. CNSR is required for time-to-event parameters.,, -EVNTDESC,Event or Censoring Description,Char,,,Perm,,Description of the event of interest or censoring reason for the subject within the parameter.,, -CNSDTDSC,Censor Date Description,Char,,,Perm,,Describes the circumstance represented by the censoring date if different from the event date that warrants censoring.,, diff --git a/data-raw/ig_source/adamig_1.2/Timing_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Timing_Variables_BDS_Datasets.csv deleted file mode 100644 index ea460b9..0000000 --- a/data-raw/ig_source/adamig_1.2/Timing_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,39 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ADT,Analysis Date,Num,,Perm,The date associated with AVAL and/or AVALC in numeric format. -ATM,Analysis Time,Num,,Perm,The time associated with AVAL and/or AVALC in numeric format. -ADTM,Analysis Datetime,Num,,Perm,The datetime associated with AVAL and/or AVALC in numeric format. -ADY,Analysis Relative Day,Num,,Perm,"The relative day of AVAL and/or AVALC. The number of days from an anchor date (not necessarily DM.RFSTDTC) to ADT. See Section 3.1.2, Timing Variable Conventions." -ADTF,Analysis Date Imputation Flag,Char,(DATEFL),Cond,"The level of imputation of analysis date. If ADT (or the date part of ADTM) was imputed, ADTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -ATMF,Analysis Time Imputation Flag,Char,(TIMEFL),Cond,"The level of imputation of analysis time. If ATM (or the time part of ADTM) was imputed, ATMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -ASTDT,Analysis Start Date,Num,,Perm,"The start date associated with AVAL and/or AVALC. ASTDT and AENDT may be useful for traceability when AVAL summarizes data collected over an interval of time, or when AVAL is a duration." -ASTTM,Analysis Start Time,Num,,Perm,"The start time associated with AVAL and/or AVALC. ASTTM and AENTM may be useful for traceability when AVAL summarizes data collected over an interval of time, or when AVAL is a duration." -ASTDTM,Analysis Start Datetime,Num,,Perm,"The start datetime associated with AVAL and/or AVALC. ASTDTM and AENDTM may be useful for traceability when AVAL summarizes data collected over an interval of time, or when AVAL is a duration." -ASTDY,Analysis Start Relative Day,Num,,Perm,"The number of days from an anchor date (not necessarily DM.RFSTDTC) to ASTDT. See Section 3.1.2, Timing Variable Conventions." -ASTDTF,Analysis Start Date Imputation Flag,Char,(DATEFL),Cond,"The level of imputation of analysis start date. If ASTDT (or the date part of ASTDTM) was imputed, ASTDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -ASTTMF,Analysis Start Time Imputation Flag,Char,(TIMEFL),Cond,"The level of imputation of analysis start time. If ASTTM (or the time part of ASTDTM) was imputed, ASTTMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -AENDT,Analysis End Date,Num,,Perm,The end date associated with AVAL and/or AVALC. See also ASTDT. -AENTM,Analysis End Time,Num,,Perm,The end time associated with AVAL and/or AVALC. See also ASTTM. -AENDTM,Analysis End Datetime,Num,,Perm,The end datetime associated with AVAL and/or AVALC. See also ASTDTM. -AENDY,Analysis End Relative Day,Num,,Perm,"The number of days from an anchor date (not necessarily DM.RFSTDTC) to AENDT. See Section 3.1.2, Timing Variable Conventions." -AENDTF,Analysis End Date Imputation Flag,Char,(DATEFL),Cond,"The level of imputation of analysis end date. If AENDT (or the date part of AENDTM) was imputed, AENDTF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -AENTMF,Analysis End Time Imputation Flag,Char,(TIMEFL),Cond,"The level of imputation of analysis end time. If AENTM (or the time part of AENDTM) was imputed, AENTMF must be populated and is required. See Section 3.1.3, Date and Time Imputation Flag Variables." -AVISIT,Analysis Visit,Char,,Cond,"The analysis visit description; required if an analysis is done by nominal, assigned or analysis visit. AVISIT may contain the visit names as observed (i.e., from SDTM VISIT), derived visit names, time window names, conceptual descriptions (such as Average, Endpoint, etc.), or a combination of any of these. AVISIT is a derived field and does not have to map to VISIT from the SDTM. AVISIT represents the analysis visit of the record, but it does not mean that the record was analyzed. There are often multiple records for the same subject and parameter that have the same value of AVISIT. ANLzzFL and other variables may be needed to identify the records selected for any given analysis. See Section 3.3.8, Indicator Variables for BDS Datasets, for information about flag variables. AVISIT should be unique for a given analysis visit window. In the event that a record does not fall within any predefined analysis timepoint window, AVISIT can be populated in any way that the producer chooses to indicate this fact (e.g., blank or ""Not Windowed""). The way that AVISIT is calculated, including the variables used in its derivation, should be indicated in the variable metadata for AVISIT. The values and the rules for deriving AVISIT may be different for different parameters within the same dataset. Values of AVISIT are producer-defined, and are often directly usable in Clinical Study Report displays." -AVISITN,Analysis Visit (N),Num,,Perm,"Numeric representation of AVISIT. Since study visits are usually defined by certain timepoints, defining AVISITN so that it represents the timepoint associated with the visit can facilitate plotting and interpretation of the values. -Alternatively, AVISITN may be a protocol visit number, a cycle number, an analysis visit number, or any other number logically related to AVISIT or useful for sorting that is needed for analysis. -There must be a one-to-one relationship between AVISITN and AVISIT (i.e., AVISITN has the same value for each distinct AVISIT) within a parameter. A best practice is to extend the one-to-one relationship to within a study, but this is not an ADaM requirement. In the event that a record does not fall within any predefined analysis timepoint window, AVISITN can be populated in any way that the producer chooses to indicate this fact (e.g., may be null). Values of AVISITN are producer- defined. -AVISITN cannot be present unless AVISIT is also present. On a given record, AVISITN cannot be populated if AVISIT is null. AVISITN can be null when AVISIT is populated, as long as the one-to-one relationship is maintained within a parameter on all rows on which both variables are populated." -ATPT,Analysis Timepoint,Char,,Cond,"The analysis timepoint description; required if an analysis is done by nominal, assigned or analysis timepoint (instead of or in addition to by-visit). Timepoints are relative to ATPTREF. ATPT may contain the timepoint names as observed (i.e., from SDTM -- TPT), derived timepoint names, time window names, conceptual descriptions (such as Average, Endpoint, etc.), or a combination of any of these. This variable is often used in conjunction with AVISIT. ATPT represents the analysis timepoint of the record. -ATPT can be within an analysis visit (e.g., blood pressure assessments at 10 min, 20 min, and 30 min post- dose at AVISIT=Week 1) or can be unrelated to AVISIT (e.g., migraine symptoms 30 min, 60 min, and 120 min post-dose for attack 1). The way that ATPT is calculated, including the variables used in its derivation, should be indicated in the variable metadata for ATPT. The values and the rules for deriving ATPT may be different for different parameters within the same dataset. Values of ATPT are producer-defined, and are often directly usable in Clinical Study Report displays." -ATPTN,Analysis Timepoint (N),Num,,Perm,"Numeric representation of ATPT. Defining ATPTN so that its values represent the planned timepoints (e.g., minutes or hours after dosing) is not required but can facilitate plotting and interpretation of the values. There must be a one-to-one relationship between ATPTN and ATPT within a parameter. (Best practice would dictate that the mapping would be one-to-one within a study, but that is not an ADaM requirement.) -ATPTN cannot be present unless ATPT is also present. When ATPT and ATPTN are present, then on a given record, either both must be populated or both must be null." -ATPTREF,Analysis Timepoint Reference,Char,,Perm,"Description of the fixed reference point referred to by ATPT/ATPTN (e.g., time of dose)." -APHASE,Phase,Char,,Perm,"APHASE is a categorization of timing within a study, for example a higher-level categorization of APERIOD or an analysis epoch. For example, APHASE could describe spans of time for SCREENING, ON TREATMENT, and FOLLOW-UP. APHASE may be used alone or in addition to APERIOD. APHASE is independent of TRTxxP within ADSL. APHASE may be populated for spans of time where a subject is not on treatment. The value of APHASE (if populated) must be one of the values found in the ADSL APHASEw variables." -APHASEN,Phase (N),Num,,Perm,"Numeric representation of APHASE. The value of APHASEN (if populated) must be one of the w values found in the ADSL APHASEw variable names. There must be a one-to-one relationship between APHASEN and APHASE within a study, which must be the same as the one-to-one mapping between w and APHASEw in ADSL. -APHASEN cannot be present unless APHASE is also present. When APHASE and APHASEN are present, then on a given record, either both must be populated or both must be null." -APERIOD,Period,Num,,Cond,APERIOD is a record-level timing variable that represents the analysis period within the study associated with the record for analysis purposes. The value of APERIOD (if populated) must be one of the xx values found in the ADSL TRTxxP variable names. APERIOD is required if ASPER is present. APERIOD must be populated on all records where ASPER is populated. -APERIODC,Period (C),Char,,Perm,"Text characterizing to which analysis period the record belongs. There must be a one-to-one relationship between APERIODC and APERIOD within a study. APERIODC cannot be present unless APERIOD is also present. When APERIOD and APERIODC are present, then on a given record, either both must be populated or both must be null." -ASPER,Subperiod within Period,Num,,Perm,"The numeric value characterizing a sublevel within APERIOD to which the record belongs. Within each APERIOD, the first ASPER is 1 (i.e., it resets to 1 when the APERIOD value changes). The value of ASPER (if populated) must be one of the w values found in the ADSL PxxSw variable names." -ASPERC,Subperiod within Period (C),Char,,Perm,"Text characterizing to which subperiod the record belongs. There must be a one-to-one relationship between ASPERC and ASPER within a value of APERIOD, which must be the same as the one-to-one mapping between PxxSw and w in ADSL, where xx is equal to the value of APERIOD. The value of ASPERC (if populated) must be one of the values found in the ADSL PxxSw variables. -ASPERC cannot be present unless ASPER is also present. When ASPER and ASPERC are present, then on a given record, either both must be populated or both must be null." -ARELTM,Analysis Relative Time,Num,,Perm,"The time relative to an anchor time. The amount of time from an anchor time to ATM. When ARELTM is present, the anchor time variable and ARELTMU must also be included in the dataset, and the anchor time variable must be identified in the metadata for ARELTM." -ARELTMU,Analysis Relative Time Unit,Char,,Perm,"The units of ARELTM. For example, ""HOURS"" or ""MINUTES."" ARELTMU is required if ARELTM is present." diff --git a/data-raw/ig_source/adamig_1.2/Toxicity_Range_Variables_BDS_Datasets.csv b/data-raw/ig_source/adamig_1.2/Toxicity_Range_Variables_BDS_Datasets.csv deleted file mode 100644 index 209a796..0000000 --- a/data-raw/ig_source/adamig_1.2/Toxicity_Range_Variables_BDS_Datasets.csv +++ /dev/null @@ -1,46 +0,0 @@ -Variable Name,Variable Label,Type,Codelist/ Controlled Terms,Core,CDISC Notes -ATOXGR,Analysis Toxicity Grade,Char,,Perm,Toxicity grade of AVAL or AVALC for analysis; may be based on SDTM --TOXGR or an imputed or assigned value. -ATOXGRN,Analysis Toxicity Grade (N),Num,,Perm,"Numeric representation of ATOXGR. There must be a one-to-one relationship between ATOXGRN and ATOXGR within a parameter. -ATOXGRN cannot be present unless ATOXGR is also present. When ATOXGR and ATOXGRN are present, then on a given record, either both must be populated or both must be null." -BTOXGR,Baseline Toxicity Grade,Char,,Perm,ATOXGR of the baseline record identified by ABLFL. -BTOXGRN,Baseline Toxicity Grade (N),Num,,Perm,"Numeric representation of BTOXGR. There must be a one-to-one relationship between BTOXGRN and BTOXGR within a parameter. -BTOXGRN cannot be present unless BTOXGR is also present. When BTOXGR and BTOXGRN are present, then on a given record, either both must be populated or both must be null." -ANRIND,Analysis Reference Range Indicator,Char,,Perm,Indicates where AVAL or AVALC falls with respect to the normal reference range for analysis; may be based on SDTM --NRIND or an imputed or assigned value. -BNRIND,Baseline Reference Range Indicator,Char,,Perm,ANRIND of the baseline record identified by ABLFL. -ANRLO,Analysis Normal Range Lower Limit,Num,,Perm,Normal range lower limit for analysis; may be based on SDTM --NRLO or an imputed or assigned value. -ANRLOC,Analysis Normal Range Lower Limit (C),Char,,Perm,"Character analysis normal range lower limit. ANRLOC can be a character string mapping to ANRLO, but if so there must be a one-to-one -relationship between ANRLO and ANRLOC -within a given PARAM. ANRLOC should not be used to categorize the values of ANRLO. -Within a given parameter, if there exists a row on which both ANRLOC and ANRLO are populated, then there must be a one-to-one relationship between ANRLOC and ANRLO on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either ANRLO or ANRLOC be included when determining whether the one-to-one relationship requirement is satisfied.) On a given record, it is permissible for ANRLO, ANRLOC, or both to be null." -ANRHI,Analysis Normal Range Upper Limit,Num,,Perm,Normal range upper limit for analysis; may be based on SDTM --NRHI or an imputed or assigned value. -ANRHIC,Analysis Normal Range Upper Limit (C),Char,,Perm,"Character analysis normal range upper limit. ANRHIC can be a character string mapping to ANRHI, but if so there must be a one-to-one -relationship between ANRHI and ANRHIC within -a given PARAM. ANRHIC should not be used to categorize the values of ANRHI. Within a given parameter, if there exists a row on which both ANRHIC and ANRHI are populated, then there must be a one-to-one relationship between ANRHIC and ANRHI on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either ANRHI or ANRHIC be included when determining whether the one-to-one relationship requirement is satisfied.) On a given record, it is permissible for ANRHI, ANRHIC, or both to be null." -AyLO,Analysis Range y Lower Limit,Num,,Cond,"AyLO and/or AyHI are used for analysis ranges other than the normal range. AyLO and/or AyHI are created to capture the different levels of cutoff values used to determine whether an analysis is within a clinically acceptable value range or outside that value range. AyLO and/or AyHI are usually but not necessarily constants, parameter-specific constants, or subject-specific constants. AyLO must be included if R2AyLO is included in the dataset." -AyLOC,Analysis Range y Lower Limit (C),Char,,Perm,"Character analysis range y lower limit. AyLOC can be a character string mapping to AyLO, but if so there must be a one-to-one -relationship between AyLO and AyLOC within a -given PARAM. AyLOC should not be used to categorize the values of AyLO. -Within a given parameter, if there exists a row on which both AyLOC and AyLO are populated, then there must be a one-to-one relationship between AyLOC and AyLO on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either AyLO or AyLOC be included when determining whether the one-to-one relationship requirement is satisfied.) On a given record, it is permissible for AyLO, AyLOC, or both to be null." -AyHI,Analysis Range y Upper Limit,Num,,Cond,"See AyLO. -For example, if ECG QTc values are summarized based on values >450, values >480, and values ->500, there is a need for 3 ""hi value"" range variables against which to compare values: A1HI=450, A2HI=480, A3HI=500. -AyHI must be included if R2AyHI is included in the dataset." -AyHIC,Analysis Range y Upper Limit (C),Char,,Perm,"Character analysis range y upper limit. -AyHIC can be a character string mapping to AyHI, but if so there must be a one-to-one relationship between AyHI and AyHIC within a given PARAM. AyHIC should not be used to categorize the values of AyHI. -Within a given parameter, if there exists a row on which both AyHIC and AyHI are populated, then there must be a one-to-one relationship between AyHIC and AyHI on all rows on which both variables are populated. (In other words, there is no requirement that records with a null value in either AyHI or AyHIC be included when determining whether the one-to-one relationship requirement is satisfied.) On a given record, it is permissible for AyHI, AyHIC, or both to be null." -AyIND,Analysis Range y Indicator,Char,,Perm,"Indicates relationship of AVAL to the analysis range variables AyLO and/or AyHI, or the relationship of AVALC to the analysis range variables AyLOC and/or AyHIC." -ByIND,Baseline Analysis Range y Indicator,Char,,Perm,AyIND of the baseline record identified by ABLFL. -ATOXGRL,Analysis Toxicity Grade Low,Char,,Perm,Low toxicity grade of AVAL or AVALC for analysis; may be based on SDTM --TOXGR or an imputed or assigned value. Used to assess when a subject's lab value falls within the low toxicity range. -ATOXGRLN,Analysis Toxicity Grade Low (N),Num,,Perm,"Numeric representation of ATOXGRL. There must be a one-to-one relationship between ATOXGRLN and ATOXGRL within a parameter. -ATOXGRLN cannot be present unless ATOXGRL is also present. When ATOXGRL and ATOXGRLN are present, then on a given record, either both must be populated or both must be null." -ATOXGRH,Analysis Toxicity Grade High,Char,,Perm,"High toxicity grade of AVAL or AVALC for analysis; may be based on SDTM --TOXGR or -an imputed or assigned value. Used to assess when a subject's lab value falls within the high toxicity range." -ATOXGRHN,Analysis Toxicity Grade High (N),Num,,Perm,"Numeric representation of ATOXGRH. There must be a one-to-one relationship between ATOXGRHN and ATOXGRH within a parameter. -ATOXGRHN cannot be present unless ATOXGRH is also present. When ATOXGRH and ATOXGRHN are present, then on a given record, either both must be populated or both must be null." -BTOXGRL,Baseline Toxicity Grade Low,Char,,Perm,ATOXGRL of the baseline record identified by ABLFL. -BTOXGRLN,Baseline Toxicity Grade Low (N),Num,,Perm,"Numeric representation of BTOXGRL. There must be a one-to-one relationship between BTOXGRLN and BTOXGRL within a parameter. -BTOXGRLN cannot be present unless BTOXGRL is also present. When BTOXGRL and BTOXGRLN are present, then on a given record, either both must be populated or both must be null." -BTOXGRH,Baseline Toxicity Grade High,Char,,Perm,ATOXGRH of the baseline record identified by ABLFL. -BTOXGRHN,Baseline Toxicity Grade High (N),Num,,Perm,"Numeric representation of BTOXGRH. There must be a one-to-one relationship between BTOXGRHN and BTOXGRH within a parameter. BTOXGRHN cannot be present unless BTOXGRH is also present. When BTOXGRH and BTOXGRHN are present, then on a given record, either both must be populated or both must be null." -ATOXDSCL,Analysis Toxicity Description Low,Char,,Perm,The analysis toxicity term used to describe toxicity in the low direction. ATOXDCSL is only populated if AVAL is populated and the PARAM is evaluated for toxicity in the low direction. There is a one-to- one relationship between ATOXDCSL and PARAM within a subject. The intent of this variable is to describe the type of toxicity being evaluated and not the level of toxicity on the specific record. -ATOXDSCH,Analysis Toxicity Description High,Char,,Perm,The analysis toxicity term used to describe toxicity in the high direction. ATOXDSCH is only populated if AVAL is populated and the PARAM is evaluated for toxicity in the high direction. There is a one-to-one relationship between ATOXDCSH and PARAM within a subject. The intent of this variable is to describe the type of toxicity being evaluated and not the level of toxicity on the specific record. diff --git a/data-raw/ig_source/sdtm_model/1.4/Findings_Observation_Class.csv b/data-raw/ig_source/sdtm_model/1.4/Findings_Observation_Class.csv deleted file mode 100644 index 70c85b6..0000000 --- a/data-raw/ig_source/sdtm_model/1.4/Findings_Observation_Class.csv +++ /dev/null @@ -1,270 +0,0 @@ -"Variable -Name ",Variable Label ,Type ,Role ,Description -Topic Variable,,,, ---TESTCD ,"Short Name of -Measurement, Test -or Examination",Char ,Topic ,"Short character value for --TEST used as a column name when -converting a dataset from a vertical format to a horizontal -format. The short value can be up to 8 characters. Examples: -PLAT, SYSBP, RRMIN, EYEEXAM." -Qualifier Variables,,,, ---TEST ,"Name of -Measurement, Test -or Examination",Char ,"Synonym -Qualifier of ---TESTCD","Long name For --TESTCD. Examples: Platelet, Systolic Blood -Pressure, Summary (Min) RR Duration, Eye Examination." ---MODIFY ,Modified Term ,Char ,"Synonym -Qualifier of ---ORRES","If the value of --ORRES is modified for coding purposes, then -the modified text is placed here." ---TSTDTL ,"Measurement, Test -or Examination -Detail",Char ,"Variable -Qualifier of ---TESTCD and ---TEST","Further description of --TESTCD and --TEST. Example: “The -percentage of cells with +1 intensity of staining” when -MITESTCD = TTF1." ---CAT ,Category ,Char ,"Grouping -Qualifier","Used to define a category of topic-variable values. Examples: -HEMATOLOGY, URINALYSIS, CHEMISTRY, HAMILTON -DEPRESSION SCALE, SF36, MICRO ARRAY, EGFR -MUTATION ANALYSIS" ---SCAT ,Subcategory ,Char ,"Grouping -Qualifier","Used to define a further categorization of --CAT values. -Example: DIFFERENTIAL." ---POS ,"Position of Subject -During -Observation",Char ,"Record -Qualifier","Position of the subject during a measurement or examination. -Examples: SUPINE, STANDING, SITTING." ---BODSYS ,"Body System or -Organ Class",Char ,"Record -Qualifier","Body System or Organ Class that is involved for a finding from -the standard hierarchy for dictionary-coded results. Example: -MedDRA SOC." ---ORRES ,"Result or Finding -in Original Units",Char ,"Result -Qualifier","Result of the measurement or finding as originally received or -collected. Examples: 120, <1, POS." ---ORRESU ,Original Units ,Char ,"Variable -Qualifier of ---ORRES","Unit for --ORRES. Examples: IN, LB, kg/L." ---ORNRLO ,"Normal Range -Lower Limit -Original Units",Char ,"Variable -Qualifier of ---ORRES","Lower end of normal range or reference range for results stored -in --ORRES." ---ORNRHI ,"Normal Range -Upper Limit -Original Units",Char ,"Variable -Qualifier of ---ORRES","Upper end of normal range or reference range for results stored -in --ORRES." ---STRESC ,"Result or Finding -in Standard Format",Char ,"Result -Qualifier","Contains the result value for all findings, copied or derived from ---ORRES in a standard format or in standard units. --STRESC -should store all results or findings in character format; if results -are numeric, they should also be stored in numeric format in -- -STRESN. For example, if various tests have results “NONE”, -“NEG”, and “NEGATIVE” in --ORRES and these results -effectively have the same meaning, they could be represented in -standard format in --STRESC as ""NEGATIVE""." ---STRESN ,"Numeric -Result/Finding in -Standard Units",Num ,"Result -Qualifier","Used for continuous or numeric results or findings in standard -format; copied in numeric format from --STRESC. --STRESN -should store all numeric test results or findings." ---STRESU ,Standard Units ,Char ,"Variable -Qualifier of ---STRESC and ---STRESN","Standardized units used for --STRESC and --STRESN. -Example: mol/L." ---STNRLO ,"Normal Range -Lower Limit -Standard Units",Num ,"Variable -Qualifier of ---STRESC and ---STRESN","Lower end of normal range or reference range for standardized -results (e.g., --STRESC, --STRESN) represented in -standardized units (--STRESU)." ---STNRHI ,"Normal Range -Upper Limit -Standard Units",Num ,"Variable -Qualifier of ---STRESC and ---STRESN","Upper end of normal range or reference range for standardized -results (e.g., --STRESC, --STRESN) represented in -standardized units (--STRESU)." ---STNRC ,"Normal Range for -Character Results",Char ,"Variable -Qualifier of ---STRESC","Normal range or reference range for results stored in --STRESC -that are character in ordinal or categorical scale. Example: -Negative to Trace." ---NRIND ,"Normal/Reference -Range Indicator",Char ,"Variable -Qualifier of ---ORRES","Used to indicate the value is outside the normal range or -reference range. May be defined by --ORNRLO and --ORNRHI -or other objective criteria. Examples: Y, N; HIGH, LOW; -NORMAL; ABNORMAL." ---RESCAT ,Result Category ,Char ,"Variable -Qualifier of ---ORRES","Used to categorize the result of a finding. Example: -MALIGNANT or BENIGN for tumor findings. RESISTANCE -VARIANT for genetic variation." ---STAT ,Completion Status ,Char ,"Record -Qualifier","Used to indicate that a question was not asked or a test was not -done, or a test was attempted but did not generate a result. -Should be null or have a value of NOT DONE." ---REASND ,Reason Not Done ,Char ,"Record -Qualifier","Reason not done. Used in conjunction with --STAT when value -is NOT DONE." ---XFN ,External File Path ,Char ,"Record -Qualifier","Filename for an external file, such as one for an ECG waveform -or a medical image." ---NAM ,"Laboratory/Vendor -Name",Char ,"Record -Qualifier","Name or identifier of the vendor (e.g., laboratory) that provided -the test results." ---LOINC ,LOINC Code ,Char ,"Synonym -Qualifier of ---TESTCD","Logical Observation Identifiers Names and Codes (LOINC) -code for the topic variable such as a lab test." ---SPEC ,"Specimen Material -Type",Char ,"Record -Qualifier","Defines the type of specimen used for a measurement. -Examples: SERUM, PLASMA, URINE, DNA, RNA." ---ANTREG ,Anatomical Region ,Char ,"Variable -Qualifier of ---SPEC","Defines the specific anatomical or biological region of a tissue, -organ specimen or the region from which the specimen is -obtained, as defined in the protocol, such as a section or part of -what is described in the --SPEC variable. Examples: CORTEX, -MEDULLA, MUCOSA" ---SPCCND ,"Specimen -Condition",Char ,"Record -Qualifier",Defines the condition of the specimen. Example: CLOUDY. ---SPCUFL ,"Specimen -Usability for the -Test",Char ,"Record -Qualifier","Describes the usability of the specimen for the test. The value -will be N if the specimen is not usable, and null if the specimen -is usable." ---LOC ,"Location Used for -the Measurement",Char ,"Record -Qualifier","Anatomical location of the subject relevant to the collection of -the measurement. Examples: RECTAL for temperature, ARM -for blood pressure." ---LAT ,Laterality ,Char ,"Variable -Qualifier of ---LOC","Qualifier for anatomical location or specimen further detailing -laterality. Examples: RIGHT, LEFT, BILATERAL" ---DIR ,Directionality ,Char ,"Variable -Qualifier of ---LOC","Qualifier for anatomical location or specimen further detailing -directionality. Examples: ANTERIOR, LOWER, PROXIMAL" ---PORTOT ,Portion or Totality ,Char ,"Variable -Qualifier of ---LOC","Qualifier for anatomical location or specimen further detailing -the distribution, which means arrangement of, apportioning of. . -Examples: ENTIRE, SINGLE, SEGMENT, MANY." ---METHOD ,"Method of Test or -Examination",Char ,"Record -Qualifier","Method of the test or examination. Examples: EIA (Enzyme -Immunoassay), ELECTROPHORESIS, DIPSTICK" ---RUNID ,Run ID ,Char ,"Record -Qualifier","A unique identifier for a particular run of a test on a particular -batch of samples." ---ANMETH ,Analysis Method ,Char ,"Record -Qualifier","Analysis method applied to obtain a summarized result. -Analysis method describes the method of secondary processing -applied to a complex observation result (e.g. an image or a -genetic sequence)." ---LEAD ,"Lead Identified to -Collect -Measurements",Char ,"Record -Qualifier","Lead or leads identified to capture the measurement for a test -from an instrument. Examples: LEAD I, LEAD V2, LEAD -CM5." ---CSTATE ,"Consciousness -State",Char ,"Record -Qualifier","The consciousness state of the subject at the time of -measurement. Examples: CONSCIOUS, SEMI-CONSCIOUS, -UNCONSCIOUS" ---BLFL ,Baseline Flag ,Char ,"Record -Qualifier",Indicator used to identify a baseline value. Should be Y or null. ---FAST ,Fasting Status ,Char ,"Record -Qualifier","Indicator used to identify fasting status. Valid values include Y, -N, U or null if not relevant." ---DRVFL ,Derived Flag ,Char ,"Record -Qualifier","Used to indicate a derived record (e.g., a record that represents -the average of other records such as a computed baseline). -Should be Y or null." ---EVAL ,Evaluator ,Char ,"Record -Qualifier","Role of the person who provided the evaluation. Used only for -results that are subjective (e.g., assigned by a person or a -group). Examples: ADJUDICATION COMMITTEE, -INDEPENDENT ASSESSOR, RADIOLOGIST." ---EVALID ,"Evaluator -Identifier",Char ,"Variable -Qualifier of ---EVAL","Used to distinguish multiple evaluators with the same role -recorded in --EVAL. Examples: RADIOLOGIST1 or -RADIOLOGIST2" ---ACPTFL ,"Accepted Record -Flag",Char ,"Record -Qualifier","In cases where more than one assessor provides an evaluation of -a result or response, this flag identifies the record that is -considered, by an independent assessor, to be the accepted -evaluation. Expected to be Y or null." ---TOX ,Toxicity ,Char ,"Variable -Qualifier of ---TOXGR","Description of toxicity quantified by --TOXGR such as NCI -CTCAE Short Name. Examples: HYPERCALCEMIA, -HYPOCALCEMIA. Sponsor should specify which scale and -version is used in the Sponsor Comments column of the Define -XML document." ---TOXGR ,Toxicity Grade ,Char ,"Record -Qualifier","Records toxicity grade using a standard toxicity scale (such as -the NCI CTCAE). Sponsor should specify which scale and -version is used in the Sponsor Comments column of the Define -data definition document. Example: 2." ---SEV ,Severity ,Char ,"Record -Qualifier","Describes the severity or intensity of a particular finding. -Examples: MILD, MODERATE, SEVERE." ---DTHREL ,"Relationship to -Death",Char ,"Record -Qualifier","Describes the relationship of a particular finding to the death of -a subject. Examples: Y, N or U." ---LLOQ ,"Lower Limit of -Quantitation",Num ,"Variable -Qualifier of ---STRESC and ---STRESN","Indicates the lower limit of quantitation for an assay. Units will -be those used for --STRESU." ---ULOQ ,"Upper Limit of -Quantitation",Num ,"Variable -Qualifier of ---STRESC and ---STRESN","Indicates the upper limit of quantitation for an assay. Units will -be those used for --STRESU." ---EXCLFL ,"Exclude from -Statistics",Char ,"Record -Qualifier","Indicates whether the values in the result variables for this -record should be excluded from summary statistical calculations -such as Mean, Standard Deviation, and Count (and others). -Expected to be Y or null. --EXCLFL should not be used when - --STAT is NOT DONE. Not to be used with human clinical -trials." ---REASEX ,"Reason for -Exclusion from -Statistics",Char ,"Record -Qualifier","Reason excluded from statistics. Used in conjunction with -- -EXCLFL when its value is Y. Not to be used with human -clinical trials" diff --git a/data-raw/ig_source/sdtm_model/1.5/Findings_Observation_Class.csv b/data-raw/ig_source/sdtm_model/1.5/Findings_Observation_Class.csv deleted file mode 100644 index 7d7a730..0000000 --- a/data-raw/ig_source/sdtm_model/1.5/Findings_Observation_Class.csv +++ /dev/null @@ -1,305 +0,0 @@ -"Variable -Name ",Variable Label ,Type ,Role ,Description -Topic Variable,,,, ---TESTCD ,"Short Name of -Measurement, Test or -Examination",Char ,Topic ,"Short character value for --TEST used as a column name when -converting a dataset from a vertical format to a horizontal format. -The short value can be up to 8 characters. Examples: PLAT, -SYSBP, RRMIN, EYEEXAM." -Qualifier Variables,,,, ---TEST ,"Name of -Measurement, Test or -Examination",Char ,"Synonym -Qualifier of ---TESTCD","Long name For --TESTCD. Examples: Platelet, Systolic Blood -Pressure, Summary (Min) RR Duration, Eye Examination." ---MODIFY ,Modified Term ,Char ,"Synonym -Qualifier of ---ORRES","If the value of --ORRES is modified for coding purposes, then the -modified text is placed here." ---TSTDTL ,"Measurement, Test or -Examination Detail",Char ,"Variable -Qualifier of ---TESTCD -and --TEST","Further description of --TESTCD and --TEST. Example: ""The -percentage of cells with +1 intensity of staining"" when MITEST -= Thyroid Transcription Factor 1." ---CAT ,Category ,Char ,"Grouping -Qualifier","Used to define a category of topic-variable values. Examples: -HEMATOLOGY, URINALYSIS, CHEMISTRY, HAMILTON -DEPRESSION SCALE, SF36, EGFR MUTATION ANALYSIS." ---SCAT ,Subcategory ,Char ,"Grouping -Qualifier","Used to define a further categorization of --CAT values. -Example: WBC DIFFERENTIAL." ---POS ,"Position of Subject -During Observation",Char ,"Record -Qualifier","Position of the subject during a measurement or examination. -Examples: SUPINE, STANDING, SITTING." ---BODSYS ,"Body System or -Organ Class",Char ,"Record -Qualifier","Body System or Organ Class that is involved for a finding from -the standard hierarchy for dictionary-coded results. Example: -MedDRA SOC." ---ORRES ,"Result or Finding in -Original Units",Char ,"Result -Qualifier","Result of the measurement or finding as originally received or -collected. Examples: 120, <1, POS." ---ORRESU ,Original Units ,Char ,"Variable -Qualifier of ---ORRES","Unit for --ORRES. Examples: in, LB, kg/L." ---ORNRLO ,"Normal Range Lower -Limit-Original Units",Char ,"Variable -Qualifier of ---ORRES","Lower end of normal range or reference range for results stored in ---ORRES." ---ORNRHI ,"Normal Range Upper -Limit-Original Units",Char ,"Variable -Qualifier of ---ORRES","Upper end of normal range or reference range for results stored in ---ORRES." ---ORREF ,"Reference Result in -Original Units",Char ,"Variable -Qualifier of ---ORRES","Reference value for the result or finding as originally received or -collected. --ORREF uses the same units as --ORRES, if -applicable. Examples: value from predicted normal value in -spirometry tests." ---STRESC ,"Result or Finding in -Standard Format",Char ,"Result -Qualifier","Contains the result value for all findings, copied or derived from ---ORRES in a standard format or in standard units. --STRESC -should store all results or findings in character format; if results -are numeric, they should also be stored in numeric format in ---STRESN. For example, if various tests have results ""NONE"", -""NEG"", and ""NEGATIVE"" in --ORRES and these results -effectively have the same meaning, they could be represented in -standard format in --STRESC as ""NEGATIVE""." ---STRESN ,"Numeric -Result/Finding in -Standard Units",Num ,"Result -Qualifier","Used for continuous or numeric results or findings in standard -format; copied in numeric format from --STRESC. --STRESN -should store all numeric test results or findings." ---STRESU ,Standard Units ,Char ,"Variable -Qualifier of ---STRESC -and ---STRESN","Standardized units used for --STRESC and --STRESN. Example: -mol/L." ---STNRLO ,"Normal Range Lower -Limit-Standard Units",Num ,"Variable -Qualifier of ---STRESC -and ---STRESN","Lower end of normal range or reference range for standardized -results (e.g., --STRESC, --STRESN) represented in standardized -units (-STRESU)." ---STNRHI ,"Normal Range Upper -Limit-Standard Units",Num ,"Variable -Qualifier of ---STRESC -and ---STRESN","Upper end of normal range or reference range for standardized -results (e.g., --STRESC, --STRESN) represented in standardized -units (-STRESU)." ---STNRC ,"Normal Range for -Character Results",Char ,"Variable -Qualifier of ---STRESC","Normal range or reference range for results stored in --STRESC -that are character in ordinal or categorical scale. Example: -Negative to Trace." ---STREFC ,"Reference Result in -Standard Format",Char ,"Variable -Qualifier of ---STRESC","Reference value for the result or finding copied or derived from ---ORREF in a standard format." ---STREFN ,"Numeric Reference -Result in Std Units",Num ,"Variable -Qualifier of ---STRESN","Reference value for continuous or numeric results or findings in -standard format or in standard units. --STREFN uses the same -units as --STRESN, if applicable." ---NRIND ,"Normal/Reference -Range Indicator",Char ,"Variable -Qualifier of ---ORRES","Used to indicate the value is outside the normal range or -reference range. May be defined by --ORNRLO and --ORNRHI -or other objective criteria. Examples: Y, N; HIGH, LOW; -NORMAL; ABNORMAL." ---RESCAT ,Result Category ,Char ,"Variable -Qualifier of ---ORRES","Used to categorize the result of a finding. Example: -MALIGNANT or BENIGN for tumor findings. RESISTANCE -VARIANT for genetic variation." ---CHRON ,Chronicity of Finding ,Char ,"Variable -Qualifier of ---STRESC","Characterization of the duration of a biological process resulting -in a particular finding. Examples: ACUTE, CHRONIC, -SUBACUTE." ---DISTR ,"Distribution Pattern of -Finding",Char ,"Variable -Qualifier of ---STRESC","Description of the distribution pattern of a finding within the -examined area. Examples: FOCAL, MULTIFOCAL, DIFFUSE, -FOCAL MULTIFOCAL." ---STAT ,Completion Status ,Char ,"Record -Qualifier","Used to indicate that a question was not asked or a test was not -done, or a test was attempted but did not generate a result. Should -be null or have a value of NOT DONE." ---REASND ,Reason Not Done ,Char ,"Record -Qualifier","Reason not done. Used in conjunction with --STAT when value is -NOT DONE." ---XFN ,External File Path ,Char ,"Record -Qualifier","Filename for an external file, such as one for an ECG waveform -or a medical image." ---NAM ,"Laboratory/Vendor -Name",Char ,"Record -Qualifier","Name or identifier of the vendor (e.g., laboratory) that provided -the test results." ---LOINC ,LOINC Code ,Char ,"Synonym -Qualifier of ---TESTCD","Logical Observation Identifiers Names and Codes (LOINC) code -for the topic variable such as a lab test." ---SPEC ,"Specimen Material -Type",Char ,"Record -Qualifier","Defines the type of specimen used for a measurement. Examples: -SERUM, PLASMA, URINE, DNA, RNA." ---ANTREG ,Anatomical Region ,Char ,"Variable -Qualifier of ---SPEC","Defines the specific anatomical or biological region of a tissue, -organ specimen or the region from which the specimen is -obtained, as defined in the protocol, such as a section or part of -what is described in the --SPEC variable. Examples: CORTEX, -MEDULLA, MUCOSA" ---SPCCND ,Specimen Condition ,Char ,"Record -Qualifier",Defines the condition of the specimen. Example: CLOUDY. ---SPCUFL ,"Specimen Usability -for the Test",Char ,"Record -Qualifier","Describes the usability of the specimen for the test. The value -will be N if the specimen is not usable, and null if the specimen is -usable." ---LOC ,"Location Used for the -Measurement",Char ,"Record -Qualifier","Anatomical location of the subject relevant to the collection of -the measurement. Examples: RECTAL for temperature, ARM for -blood pressure." ---LAT ,Laterality ,Char ,"Variable -Qualifier of ---LOC","Qualifier for anatomical location or specimen further detailing -laterality. Examples: RIGHT, LEFT, BILATERAL" ---DIR ,Directionality ,Char ,"Variable -Qualifier of ---LOC","Qualifier for anatomical location or specimen further detailing -directionality. Examples: ANTERIOR, LOWER, PROXIMAL" ---PORTOT ,Portion or Totality ,Char ,"Variable -Qualifier of ---LOC","Qualifier for anatomical location or specimen further detailing the -distribution, which means arrangement of, apportioning of. -Examples: ENTIRE, SINGLE, SEGMENT, MANY." ---METHOD ,"Method of Test or -Examination",Char ,"Record -Qualifier","Method of the test or examination. Examples: EIA (Enzyme -Immunoassay), ELECTROPHORESIS, DIPSTICK" ---RUNID ,Run ID ,Char ,"Record -Qualifier","A unique identifier for a particular run of a test on a particular -batch of samples." ---ANMETH ,Analysis Method ,Char ,"Record -Qualifier","Analysis method applied to obtain a summarized result. Analysis -method describes the method of secondary processing applied to -a complex observation result (e.g. an image or a genetic -sequence)." ---LEAD ,"Lead Identified to -Collect Measurements",Char ,"Record -Qualifier","Lead or leads identified to capture the measurement for a test -from an instrument. Examples: LEAD I, LEAD V2, LEAD CM5." ---CSTATE ,Consciousness State ,Char ,"Record -Qualifier","The consciousness state of the subject at the time of -measurement. Examples: CONSCIOUS, SEMI-CONSCIOUS, -UNCONSCIOUS" ---LOBXFL ,"Last Observation -Before Exposure Flag",Char ,"Record -Qualifier","Operationally-derived indicator used to identify the last non -missing value prior to RFXSTDTC. Should be Y or null." ---BLFL ,Baseline Flag ,Char ,"Record -Qualifier",Indicator used to identify a baseline value. Should be Y or null. ---FAST ,Fasting Status ,Char ,"Record -Qualifier","Indicator used to identify fasting status. Valid values include Y, -N, U or null if not relevant." ---DRVFL ,Derived Flag ,Char ,"Record -Qualifier","Used to indicate a derived record (e.g., a record that represents -the average of other records such as a computed baseline). Should -be Y or null." ---EVAL ,Evaluator ,Char ,"Record -Qualifier","Role of the person who provided the evaluation. Used only for -results that are subjective (e.g., assigned by a person or a group). -Examples: ADJUDICATION COMMITTEE, INDEPENDENT -ASSESSOR, RADIOLOGIST." ---EVALID ,Evaluator Identifier ,Char ,"Variable -Qualifier of ---EVAL","Used to distinguish multiple evaluators with the same role -recorded in --EVAL. Examples: RADIOLOGIST1, -RADIOLOGIST2." ---ACPTFL ,Accepted Record Flag ,Char ,"Record -Qualifier","In cases where more than one assessor provides an evaluation of a -result or response, this flag identifies the record that is considered -to be the accepted evaluation. Expected values can include Y, N -or null. This is not intended to be an analysis flag to indicate -acceptability for a given analysis" ---TOX ,Toxicity ,Char ,"Variable -Qualifier of ---TOXGR","Description of toxicity quantified by --TOXGR such as NCI -CTCAE Short Name. Examples: HYPERCALCEMIA, -HYPOCALCEMIA. Sponsor should specify which scale and -version is used in the Sponsor Comments column of the Define -XML document." ---TOXGR ,Toxicity Grade ,Char ,"Record -Qualifier","Records toxicity grade using a standard toxicity scale (such as the -NCI CTCAE). Sponsor should specify which scale and version is -used in the Sponsor Comments column of the Define data -definition document. Example: 2." ---SEV ,Severity ,Char ,"Record -Qualifier","Describes the severity or intensity of a particular finding. -Examples: MILD, MODERATE, SEVERE." ---DTHREL ,Relationship to Death ,Char ,"Record -Qualifier","Describes the relationship of a particular finding to the death of a -subject. Examples: Y, N or U. Not to be used with human clinical -trials." ---LLOQ ,"Lower Limit of -Quantitation",Num ,"Variable -Qualifier of ---STRESC -and ---STRESN","Indicates the lower limit of quantitation for an assay. Units will -be those used for --STRESU." ---ULOQ ,"Upper Limit of -Quantitation",Num ,"Variable -Qualifier of ---STRESC -and ---STRESN","Indicates the upper limit of quantitation for an assay. Units will -be those used for --STRESU." ---EXCLFL ,"Exclude from -Statistics",Char ,"Record -Qualifier","Indicates whether the values in the result variables for this record -should be excluded from summary statistical calculations such as -Mean, Standard Deviation, and Count (and others). Expected to -be Y or null. --EXCLFL should not be used when --STAT is -NOT DONE. Not to be used with human clinical trials." ---REASEX ,"Reason for Exclusion -from Statistics",Char ,"Record -Qualifier","Reason excluded from statistics. Used in conjunction with ---EXCLFL when its value is Y. Not to be used with human -clinical trials." ---USCHFL ,Unscheduled Flag ,Char ,"Record -Qualifier","Indicates whether the timing of a performed test or observation -was unscheduled. If a test or observation was performed based -upon a schedule defined in the protocol, this flag should be null. -Expected values are Y or null. Not to be used with human clinical -trials. This variable would not be needed when information on planned assessments is provided, such as when the Trial Visits -(TV) and Subject Visits (SV) domains are used." ---REPNUM ,Repetition Number ,Num ,"Record -Qualifier","The instance number of a test that is repeated within a given -timeframe for the same test. The level of granularity can vary, -e.g., within a time point or within a visit. For example, multiple -measurements of blood pressure or multiple analyses of a sample." diff --git a/data-raw/ig_source/sdtm_model/1.6/Findings_Observation_Class.csv b/data-raw/ig_source/sdtm_model/1.6/Findings_Observation_Class.csv deleted file mode 100644 index 53d28e5..0000000 --- a/data-raw/ig_source/sdtm_model/1.6/Findings_Observation_Class.csv +++ /dev/null @@ -1,64 +0,0 @@ -Variable Name,Variable Label,Type,Role,Description -Topic Variable,,,, ---TESTCD,"Short Name of Measurement, Test or Examination",Char,Topic,"Short character value for --TEST used as a column name when converting a dataset from a vertical format to a horizontal format. The short value can be up to 8 characters. Examples: PLAT, SYSBP, RRMIN, EYEEXAM." -Qualifier Variables,,,, ---TEST,"Name of Measurement, Test or Examination",Char,Synonym Qualifier of --TESTCD,"Long name For --TESTCD. Examples: Platelet, Systolic Blood Pressure, Summary (Min) RR Duration, Eye Examination." ---MODIFY,Modified Term,Char,Synonym Qualifier of --ORRES,"If the value of --ORRES is modified for coding purposes, then the modified text is placed here." ---TSTDTL,"Measurement, Test or Examination Detail",Char,Variable Qualifier of --TESTCD and --TEST,"Further description of --TESTCD and --TEST. Example: ""The percentage of cells with +1 intensity of staining"" when MITEST = Thyroid Transcription Factor 1." ---CAT,Category,Char,Grouping Qualifier,"Used to define a category of topic-variable values. Examples: HEMATOLOGY, URINALYSIS, CHEMISTRY, HAMD 17, SF36 V2.0 ACUTE, EGFR MUTATION ANALYSIS." ---SCAT,Subcategory,Char,Grouping Qualifier,Used to define a further categorization of --CAT values. Example: WBC DIFFERENTIAL. ---POS,Position of Subject During Observation,Char,Record Qualifier,"Position of the subject during a measurement or examination. Examples: SUPINE, STANDING, SITTING." ---BODSYS,Body System or Organ Class,Char,Record Qualifier,Body System or Organ Class that is involved for a finding from the standard hierarchy for dictionary-coded results. Example: MedDRA SOC. ---ORRES,Result or Finding in Original Units,Char,Result Qualifier,"Result of the measurement or finding as originally received or collected. Examples: 120, <1, POS." ---ORRESU,Original Units,Char,Variable Qualifier of --ORRES,"Unit for --ORRES. Examples: in, LB, kg/L." ---ORNRLO,Normal Range Lower Limit-Original Units,Char,Variable Qualifier of --ORRES,Lower end of normal range or reference range for results stored in --ORRES. ---ORNRHI,Normal Range Upper Limit-Original Units,Char,Variable Qualifier of --ORRES,Upper end of normal range or reference range for results stored in --ORRES. ---ORREF,Reference Result in Original Units,Char,Variable Qualifier of --ORRES,"Reference value for the result or finding as originally received or collected. --ORREF uses the same units as --ORRES, if applicable. Examples: value from predicted normal value in spirometry tests." ---STRESC,Result or Finding in Standard Format,Char,Result Qualifier,"Contains the result value for all findings, copied or derived from --ORRES in a standard format or in standard units. --STRESC should store all results or findings in character format; if results are numeric, they should also be stored in numeric format in --STRESN. For example, if various tests have results ""NONE"", ""NEG"", and ""NEGATIVE"" in --ORRES and these results effectively have the same meaning, they could be represented in standard format in --STRESC as ""NEGATIVE""." ---STRESN,Numeric Result/Finding in Standard Units,Num,Result Qualifier,Used for continuous or numeric results or findings in standard format; copied in numeric format from --STRESC. --STRESN should store all numeric test results or findings. ---STRESU,Standard Units,Char,Variable Qualifier of --STRESC and --STRESN,Standardized units used for --STRESC and --STRESN. Example: mol/L. ---STNRLO,Normal Range Lower Limit-Standard Units,Num,Variable Qualifier of --STRESC and --STRESN,"Lower end of normal range or reference range for standardized results (e.g., --STRESC, --STRESN) represented in standardized units (--STRESU)." ---STNRHI,Normal Range Upper Limit-Standard Units,Num,Variable Qualifier of --STRESC and --STRESN,"Upper end of normal range or reference range for standardized results (e.g., --STRESC, --STRESN) represented in standardized units (--STRESU)." ---STNRC,Normal Range for Character Results,Char,Variable Qualifier of --STRESC,Normal range or reference range for results stored in --STRESC that are character in ordinal or categorical scale. Example: Negative to Trace. ---STREFC,Reference Result in Standard Format,Char,Variable Qualifier of --STRESC,Reference value for the result or finding copied or derived from --ORREF in a standard format. ---STREFN,Numeric Reference Result in Std Units,Num,Variable Qualifier of --STRESN,"Reference value for continuous or numeric results or findings in standard format or in standard units. --STREFN uses the same units as --STRESN, if applicable." ---NRIND,Normal/Reference Range Indicator,Char,Variable Qualifier of --ORRES,"Used to indicate the value is outside the normal range or reference range. May be defined by --ORNRLO and --ORNRHI or other objective criteria. Examples: Y, N; HIGH, LOW; NORMAL; ABNORMAL." ---RESCAT,Result Category,Char,Variable Qualifier of --ORRES,Used to categorize the result of a finding. Example: MALIGNANT or BENIGN for tumor findings. RESISTANCE VARIANT for genetic variation. ---CHRON,Chronicity of Finding,Char,Variable Qualifier of --STRESC,"Characterization of the duration of a biological process resulting in a particular finding. Examples: ACUTE, CHRONIC, SUBACUTE." ---DISTR,Distribution Pattern of Finding,Char,Variable Qualifier of --STRESC,"Description of the distribution pattern of a finding within the examined area. Examples: FOCAL, MULTIFOCAL, DIFFUSE, FOCAL MULTIFOCAL." ---RESLOC,Result Location of Finding,Char,Result Qualifier,Location where the result was observed (as opposed to the location specified for examination). This location may have a higher degree of specificity than the location specified for examination. Not to be used with human clinical trials. ---STAT,Completion Status,Char,Record Qualifier,"Used to indicate that a question was not asked or a test was not done, or a test was attempted but did not generate a result. Should be null or have a value of NOT DONE." ---REASND,Reason Not Done,Char,Record Qualifier,Reason not done. Used in conjunction with --STAT when value is NOT DONE. ---XFN,External File Path,Char,Record Qualifier,"Filename for an external file, such as one for an ECG waveform or a medical image." ---NAM,Laboratory/Vendor Name,Char,Record Qualifier,"Name or identifier of the vendor (e.g., laboratory) that provided the test results." ---LOINC,LOINC Code,Char,Synonym Qualifier of --TESTCD,Logical Observation Identifiers Names and Codes (LOINC) code for the topic variable such as a lab test. ---SPEC,Specimen Material Type,Char,Record Qualifier,"Defines the type of specimen used for a measurement. Examples: SERUM, PLASMA, URINE, DNA, RNA." ---ANTREG,Anatomical Region,Char,Variable Qualifier of --SPEC,"Defines the specific anatomical or biological region of a tissue, organ specimen or the region from which the specimen is obtained, as defined in the protocol, such as a section or part of what is described in the --SPEC variable. Examples: CORTEX, MEDULLA, MUCOSA." ---SPCCND,Specimen Condition,Char,Record Qualifier,Defines the condition of the specimen. Example: CLOUDY. ---SPCUFL,Specimen Usability for the Test,Char,Record Qualifier,"Describes the usability of the specimen for the test. The value will be N if the specimen is not usable, and null if the specimen is usable." ---LOC,Location Used for the Measurement,Char,Record Qualifier,"Anatomical location of the subject relevant to the collection of the measurement. Examples: RECTAL for temperature, ARM for blood pressure." ---LAT,Laterality,Char,Variable Qualifier of --LOC,"Qualifier for anatomical location or specimen further detailing laterality. Examples: RIGHT, LEFT, BILATERAL." ---DIR,Directionality,Char,Variable Qualifier of --LOC,"Qualifier for anatomical location or specimen further detailing directionality. Examples: ANTERIOR, LOWER, PROXIMAL." ---PORTOT,Portion or Totality,Char,Variable Qualifier of --LOC,"Qualifier for anatomical location or specimen further detailing the distribution, which means arrangement of, apportioning of. Examples: ENTIRE, SINGLE, SEGMENT, MANY." ---METHOD,Method of Test or Examination,Char,Record Qualifier,"Method of the test or examination. Examples: EIA (Enzyme Immunoassay), ELECTROPHORESIS, DIPSTICK." ---RUNID,Run ID,Char,Record Qualifier,A unique identifier for a particular run of a test on a particular batch of samples. ---ANMETH,Analysis Method,Char,Record Qualifier,Analysis method applied to obtain a summarized result. Analysis method describes the method of secondary processing applied to a complex observation result (e.g. an image or a genetic sequence). ---LEAD,Lead Identified to Collect Measurements,Char,Record Qualifier,"Lead or leads identified to capture the measurement for a test from an instrument. Examples: LEAD I, LEAD V2, LEAD CM5." ---CSTATE,Consciousness State,Char,Record Qualifier,"The consciousness state of the subject at the time of measurement. Examples: CONSCIOUS, SEMI-CONSCIOUS, UNCONSCIOUS." ---LOBXFL,Last Observation Before Exposure Flag,Char,Record Qualifier,Operationally-derived indicator used to identify the last non-missing value prior to RFXSTDTC. Should be Y or null. ---BLFL,Baseline Flag,Char,Record Qualifier,Indicator used to identify a baseline value. Should be Y or null. ---FAST,Fasting Status,Char,Record Qualifier,"Indicator used to identify fasting status. Valid values include Y, N, U, or null if not relevant." ---DRVFL,Derived Flag,Char,Record Qualifier,"Used to indicate a derived record (e.g., a record that represents the average of other records such as a computed baseline). Should be Y or null." ---EVAL,Evaluator,Char,Record Qualifier,"Role of the person who provided the evaluation. Used only for results that are subjective (e.g., assigned by a person or a group). Examples: ADJUDICATION COMMITTEE, INDEPENDENT ASSESSOR, RADIOLOGIST." ---EVALID,Evaluator Identifier,Char,Variable Qualifier of --EVAL,"Used to distinguish multiple evaluators with the same role recorded in --EVAL. Examples: RADIOLOGIST1, RADIOLOGIST2." ---ACPTFL,Accepted Record Flag,Char,Record Qualifier,"In cases where more than one assessor provides an evaluation of a result or response, this flag identifies the record that is considered to be the accepted evaluation. Expected values can include Y, N or null. This is not intended to be an analysis flag to indicate acceptability for a given analysis." ---TOX,Toxicity,Char,Variable Qualifier of --TOXGR,"Description of toxicity quantified by --TOXGR such as NCI CTCAE Short Name. Examples: HYPERCALCEMIA, HYPOCALCEMIA. Sponsor should specify which scale and version is used in the Sponsor Comments column of the Define-XML document." ---TOXGR,Toxicity Grade,Char,Record Qualifier,Records toxicity grade using a standard toxicity scale (such as the NCI CTCAE). Sponsor should specify which scale and version is used in the Sponsor Comments column of the Define data definition document. Example: 2. ---SEV,Severity,Char,Record Qualifier,"Describes the severity or intensity of a particular finding. Examples: MILD, MODERATE, SEVERE." ---DTHREL,Relationship to Death,Char,Record Qualifier,"Describes the relationship of a particular finding to the death of a subject. Examples: Y, N, or U. Not to be used with human clinical trials." ---LLOQ,Lower Limit of Quantitation,Num,Variable Qualifier of --STRESC and --STRESN,Indicates the lower limit of quantitation for an assay. Units will be those used for --STRESU. ---ULOQ,Upper Limit of Quantitation,Num,Variable Qualifier of --STRESC and --STRESN,Indicates the upper limit of quantitation for an assay. Units will be those used for --STRESU. ---EXCLFL,Exclude from Statistics,Char,Record Qualifier,"Indicates whether the values in the result variables for this record should be excluded from summary statistical calculations such as Mean, Standard Deviation, and Count (and others). Expected to be Y or null. --EXCLFL should not be used when --STAT is NOT DONE. Not to be used with human clinical trials." ---REASEX,Reason for Exclusion from Statistics,Char,Record Qualifier,Reason excluded from statistics. Used in conjunction with --EXCLFL when its value is Y. Not to be used with human clinical trials. ---USCHFL,Unscheduled Flag,Char,Record Qualifier,"Indicates whether the timing of a performed test or observation was unscheduled. If a test or observation was performed based upon a schedule defined in the protocol, this flag should be null. Expected values are Y or null. Not to be used with human clinical trials. This variable would not be needed when information on planned assessments is provided, such as when the Trial Visits (TV) and Subject Visits (SV) domains are used." ---REPNUM,Repetition Number,Num,Record Qualifier,"The instance number of a test that is repeated within a given timeframe for the same test. The level of granularity can vary, e.g., within a time point or within a visit. For example, multiple measurements of blood pressure or multiple analyses of a sample." diff --git a/data-raw/ig_source/sdtm_model/1.7/Findings_Observation_Class.csv b/data-raw/ig_source/sdtm_model/1.7/Findings_Observation_Class.csv deleted file mode 100644 index d376467..0000000 --- a/data-raw/ig_source/sdtm_model/1.7/Findings_Observation_Class.csv +++ /dev/null @@ -1,64 +0,0 @@ -Variable Name,Variable Label,Type,Role,Description -Topic Variable,,,, ---TESTCD,"Short Name of Measurement, Test, or Exam",Char,Topic,"Short character value for --TEST used as a column name when converting a dataset from a vertical format to a horizontal format. The short value can be up to 8 characters. Examples: ""PLAT"", ""SYSBP"", ""RRMIN"", ""EYEEXAM""." -Qualifier Variables,,,, ---TEST,"Name of Measurement, Test, or Exam",Char,Synonym Qualifier of --TESTCD,"Long name For --TESTCD. Examples: Platelets, Systolic Blood Pressure, Summary (Min) RR Duration, Eye Examination." ---MODIFY,Modified Term,Char,Synonym Qualifier of --ORRES,"If the value of --ORRES is modified for coding purposes, then the modified text is placed here." ---TSTDTL,"Measurement, Test, or Examination Detail",Char,Variable Qualifier of --TESTCD and --TEST,"Further description of --TESTCD and --TEST. Example: ""The percentage of cells with +1 intensity of staining"" when MITEST = ""Thyroid Transcription Factor 1""." ---CAT,Category,Char,Grouping Qualifier,"Used to define a category of topic-variable values. Examples: ""HEMATOLOGY"", ""URINALYSIS"", ""CHEMISTRY"", ""HAMD 17"", ""SF36 V2.0 ACUTE"", ""EGFR MUTATION ANALYSIS""." ---SCAT,Subcategory,Char,Grouping Qualifier,"Used to define a further categorization of --CAT values. Example: ""WBC DIFFERENTIAL""." ---POS,Position of Subject During Observation,Char,Record Qualifier,"Position of the subject during a measurement or examination. Examples: ""SUPINE"", ""STANDING"", ""SITTING""." ---BODSYS,Body System or Organ Class,Char,Record Qualifier,Body System or Organ Class that is involved for a finding from the standard hierarchy for dictionary-coded results. Example: MedDRA SOC. ---ORRES,Result or Finding in Original Units,Char,Result Qualifier,"Result of the measurement or finding as originally received or collected. Examples: ""120"", ""<1"", ""POS""." ---ORRESU,Original Units,Char,Variable Qualifier of --ORRES and --ORREF,"Unit for --ORRES and --ORREF. Examples: ""in"", ""LB"", ""kg/L""." ---ORNRLO,Normal Range Lower Limit-Original Units,Char,Variable Qualifier of --ORRES,Lower end of normal range or reference range for results stored in --ORRES. ---ORNRHI,Normal Range Upper Limit-Original Units,Char,Variable Qualifier of --ORRES,Upper end of normal range or reference range for results stored in --ORRES. ---ORREF,Reference Result in Original Units,Char,Variable Qualifier of --ORRES,"Reference value for the result or finding as originally received or collected. --ORREF uses the same units as --ORRES, if applicable. Examples: value from predicted normal value in spirometry tests." ---STRESC,Result or Finding in Standard Format,Char,Result Qualifier,"Contains the result value for all findings, copied or derived from --ORRES in a standard format or in standard units. --STRESC should store all results or findings in character format; if results are numeric, they should also be stored in numeric format in --STRESN. For example, if various tests have results ""NONE"", ""NEG"", and ""NEGATIVE"" in --ORRES and these results effectively have the same meaning, they could be represented in standard format in --STRESC as ""NEGATIVE""." ---STRESN,Numeric Result/Finding in Standard Units,Num,Result Qualifier,Used for continuous or numeric results or findings in standard format; copied in numeric format from --STRESC. --STRESN should store all numeric test results or findings. ---STRESU,Standard Units,Char,Variable Qualifier of --STRESC and --STRESN and --STREFC and --STREFN,"Standardized units used for --STRESC, --STRESN, --STREFC, and --STREFN. Example: ""mol/L""." ---STNRLO,Normal Range Lower Limit-Standard Units,Num,Variable Qualifier of --STRESC and --STRESN,"Lower end of normal range or reference range for standardized results (e.g., --STRESC, --STRESN) represented in standardized units (--STRESU)." ---STNRHI,Normal Range Upper Limit-Standard Units,Num,Variable Qualifier of --STRESC and --STRESN,"Upper end of normal range or reference range for standardized results (e.g., --STRESC, --STRESN) represented in standardized units (--STRESU)." ---STNRC,Normal Range for Character Results,Char,Variable Qualifier of --STRESC,"Normal range or reference range for results stored in --STRESC that are character in ordinal or categorical scale. Example: ""Negative to Trace""." ---STREFC,Reference Result in Standard Format,Char,Variable Qualifier of --STRESC,Reference value for the result or finding copied or derived from --ORREF in a standard format. ---STREFN,Numeric Reference Result in Std Units,Num,Variable Qualifier of --STRESN,"Reference value for continuous or numeric results or findings in standard format or in standard units. --STREFN uses the same units as --STRESN, if applicable." ---NRIND,Normal/Reference Range Indicator,Char,Variable Qualifier of --ORRES,"Used to indicate the value is outside the normal range or reference range. May be defined by --ORNRLO and --ORNRHI or other objective criteria. Examples: ""Y"", ""N""; ""HIGH"", ""LOW""; ""NORMAL"", ""ABNORMAL""." ---RESCAT,Result Category,Char,Variable Qualifier of --ORRES,"Used to categorize the result of a finding. Example: ""MALIGNANT"" or ""BENIGN"" for tumor findings." ---CHRON,Chronicity of Finding,Char,Variable Qualifier of --STRESC,"Characterization of the duration of a biological process resulting in a particular finding. Examples: ""ACUTE"", ""CHRONIC"", ""SUBACUTE""." ---DISTR,Distribution Pattern of Finding,Char,Variable Qualifier of --STRESC,"Description of the distribution pattern of a finding within the examined area. Examples: ""FOCAL"", ""MULTIFOCAL"", ""DIFFUSE"", ""FOCAL"", ""MULTIFOCAL""." ---RESLOC,Result Location of Finding,Char,Result Qualifier,Location where the result was observed (as opposed to the location specified for examination). This location may have a higher degree of specificity than the location specified for examination. Not to be used with human clinical trials. ---STAT,Completion Status,Char,Record Qualifier,"Used to indicate that a question was not asked or a test was not done, or a test was attempted but did not generate a result. Should be null or have a value of ""NOT DONE""." ---REASND,Reason Not Done,Char,Record Qualifier,"Reason not done. Used in conjunction with --STAT when value is ""NOT DONE""." ---XFN,External File Path,Char,Record Qualifier,"Filename for an external file, such as one for an ECG waveform or a medical image." ---NAM,Laboratory/Vendor Name,Char,Record Qualifier,"Name or identifier of the vendor (e.g., laboratory) that provided the test results." ---LOINC,LOINC Code,Char,Synonym Qualifier of --TESTCD,Logical Observation Identifiers Names and Codes (LOINC) code for the topic variable such as a lab test. ---SPEC,Specimen Material Type,Char,Record Qualifier,"Defines the type of specimen used for a measurement. Examples: ""SERUM"", ""PLASMA"", ""URINE"", ""DNA"", ""RNA""." ---ANTREG,Anatomical Region,Char,Variable Qualifier of --SPEC,"Defines the specific anatomical or biological region of a tissue, organ specimen or the region from which the specimen is obtained, as defined in the protocol, such as a section or part of what is described in the --SPEC variable. Examples: ""CORTEX"", ""MEDULLA"", ""MUCOSA""." ---SPCCND,Specimen Condition,Char,Record Qualifier,"Defines the condition of the specimen. Example: ""CLOUDY""." ---SPCUFL,Specimen Usability for the Test,Char,Record Qualifier,"Describes the usability of the specimen for the test. The value will be ""N"" if the specimen is not usable, and null if the specimen is usable." ---LOC,Location Used for the Measurement,Char,Record Qualifier,"Anatomical location of the subject relevant to the collection of the measurement. Examples: ""RECTAL"" for temperature, ""ARM"" for blood pressure." ---LAT,Laterality,Char,Variable Qualifier of --LOC,"Qualifier for anatomical location or specimen further detailing laterality. Examples: ""RIGHT"", ""LEFT"", ""BILATERAL""." ---DIR,Directionality,Char,Variable Qualifier of --LOC,"Qualifier for anatomical location or specimen further detailing directionality. Examples: ""ANTERIOR"", ""LOWER"", ""PROXIMAL""." ---PORTOT,Portion or Totality,Char,Variable Qualifier of --LOC,"Qualifier for anatomical location or specimen further detailing the distribution, which means arrangement of, apportioning of. Examples: ""ENTIRE"", ""SINGLE"", ""SEGMENT"", ""MANY""." ---METHOD,Method of Test or Examination,Char,Record Qualifier,"Method of the test or examination. Examples: ""EIA"" (enzyme immunoassay), ""ELECTROPHORESIS"", ""DIPSTICK""." ---RUNID,Run ID,Char,Record Qualifier,A unique identifier for a particular run of a test on a particular batch of samples. ---ANMETH,Analysis Method,Char,Record Qualifier,"Analysis method applied to obtain a summarized result. Analysis method describes the method of secondary processing applied to a complex observation result (e.g., an image or a genetic sequence)." ---LEAD,Lead Identified to Collect Measurements,Char,Record Qualifier,"Lead or leads identified to capture the measurement for a test from an instrument. Examples: ""LEAD I"", ""LEAD V2"", ""LEAD CM5""." ---CSTATE,Consciousness State,Char,Record Qualifier,"The consciousness state of the subject at the time of measurement. Examples: ""CONSCIOUS"", ""SEMI-CONSCIOUS"", ""UNCONSCIOUS""." ---LOBXFL,Last Observation Before Exposure Flag,Char,Record Qualifier,"Operationally-derived indicator used to identify the last non-missing value prior to RFXSTDTC. Should be ""Y"" or null." ---BLFL,Baseline Flag,Char,Record Qualifier,"Indicator used to identify a baseline value. Should be ""Y"" or null." ---FAST,Fasting Status,Char,Record Qualifier,"Indicator used to identify fasting status. Valid values include ""Y"", ""N"", ""U"", or null if not relevant." ---DRVFL,Derived Flag,Char,Record Qualifier,"Used to indicate a derived record (e.g., a record that represents the average of other records such as a computed baseline). Should be ""Y"" or null." ---EVAL,Evaluator,Char,Record Qualifier,"Role of the person who provided the evaluation. Used only for results that are subjective (e.g., assigned by a person or a group). Examples: ""ADJUDICATION COMMITTEE"", ""INDEPENDENT ASSESSOR"", ""RADIOLOGIST""." ---EVALID,Evaluator Identifier,Char,Variable Qualifier of --EVAL,"Used to distinguish multiple evaluators with the same role recorded in --EVAL. Examples: ""RADIOLOGIST1"", ""RADIOLOGIST2""." ---ACPTFL,Accepted Record Flag,Char,Record Qualifier,"In cases where more than one assessor provides an evaluation of a result or response, this flag identifies the record that is considered to be the accepted evaluation. Expected values can include ""Y"", ""N"", or null. This is not intended to be an analysis flag to indicate acceptability for a given analysis." ---TOX,Toxicity,Char,Variable Qualifier of --TOXGR,"Description of toxicity quantified by --TOXGR such as NCI CTCAE Short Name. Examples: ""HYPERCALCEMIA"", ""HYPOCALCEMIA"". Sponsor should specify which scale and version is used in the Sponsor Comments column of the Define-XML document." ---TOXGR,Toxicity Grade,Char,Record Qualifier,Records toxicity grade using a standard toxicity scale (such as the NCI CTCAE). Sponsor should specify which scale and version is used in the Sponsor Comments column of the Define data definition document. Example: 2. ---SEV,Severity,Char,Record Qualifier,"Describes the severity or intensity of a particular finding. Examples: ""MILD"", ""MODERATE"", ""SEVERE""." ---DTHREL,Relationship to Death,Char,Record Qualifier,"Describes the relationship of a particular finding to the death of a subject. Examples: ""Y"", ""N"", or ""U"". Not to be used with human clinical trials." ---LLOQ,Lower Limit of Quantitation,Num,Variable Qualifier of --STRESC and --STRESN,Indicates the lower limit of quantitation for an assay. Units will be those used for --STRESU. ---ULOQ,Upper Limit of Quantitation,Num,Variable Qualifier of --STRESC and --STRESN,Indicates the upper limit of quantitation for an assay. Units will be those used for --STRESU. ---EXCLFL,Exclude from Statistics,Char,Record Qualifier,"Indicates whether the values in the result variables for this record should be excluded from summary statistical calculations such as Mean, Standard Deviation, and Count (and others). Expected to be Y or null. --EXCLFL should not be used when --STAT is ""NOT DONE"". Not to be used with human clinical trials." ---REASEX,Reason for Exclusion from Statistics,Char,Record Qualifier,"Reason excluded from statistics. Used in conjunction with --EXCLFL when its value is ""Y"". Not to be used with human clinical trials." ---USCHFL,Unscheduled Flag,Char,Record Qualifier,"Indicates whether the timing of a performed test or observation was unscheduled. If a test or observation was performed based upon a schedule defined in the protocol, this flag should be null. Expected values are ""Y"" or null. Not to be used with human clinical trials. This variable would not be needed when information on planned assessments is provided, such as when the Trial Visits (TV) and Subject Visits (SV) domains are used." ---REPNUM,Repetition Number,Num,Record Qualifier,"The instance number of a test that is repeated within a given timeframe for the same test. The level of granularity can vary (e.g., within a time point or within a visit). For example, multiple measurements of blood pressure or multiple analyses of a sample." diff --git a/data-raw/ig_source/sdtmig_3.2/PP-additions.csv b/data-raw/ig_source/sdtmig_3.2/PP-additions.csv deleted file mode 100644 index d2e9c0d..0000000 --- a/data-raw/ig_source/sdtmig_3.2/PP-additions.csv +++ /dev/null @@ -1,4 +0,0 @@ -variable,after,label,type,codelist,role,core,evidence -TAETORD,PPSPEC,Planned Order of Element within Arm,Num,,Timing,Perm,"SDTMIG v3.3 PDF section 6.3.11.2 PP specification table (printed p.546/796); Core per Certara PKSubmit SDTM_3.2 appendix" -EPOCH,TAETORD,Epoch,Char,(EPOCH),Timing,Perm,"SDTMIG v3.3 PDF section 6.3.11.2 PP specification table (printed p.546/796), codelist EPOCH C99079; Core per Certara PKSubmit SDTM_3.2 appendix" -PPDY,PPDTC,Study Day of Parameter Calculations,Num,,Timing,Perm,"SDTMIG v3.3 PDF section 6.3.11.2 PP specification table (printed p.546/796); Core per Certara PKSubmit SDTM_3.2 appendix" diff --git a/data-raw/ig_source/sdtmig_3.2/PP-specification.csv b/data-raw/ig_source/sdtmig_3.2/PP-specification.csv deleted file mode 100644 index b3cbd0d..0000000 --- a/data-raw/ig_source/sdtmig_3.2/PP-specification.csv +++ /dev/null @@ -1,45 +0,0 @@ -Variable Name,Variable Label,Type,"Controlled Terms, Codelist or Format",Role,CDISC Notes,Core -STUDYID,Study Identifier,Char,,Identifier,Unique identifier for a study.,Req -DOMAIN,Domain Abbreviation,Char,PP,Identifier,Two-character abbreviation for the domain.,Req -USUBJID,Unique Subject Identifier,Char,,Identifier,Unique subject identifier within the submission.,Req -PPSEQ,Sequence Number,Num,,Identifier,"Sequence Number given to ensure uniqueness of subject records within a domain. -May be any valid number.",Req -PPGRPID,Group ID,Char,,Identifier,"Used to tie together a block of related records in a single domain to support -relationships within the domain and between domains.",Perm -PPTESTCD,Parameter Short Name,Char,(PKPARMCD),Topic,"Short name of the pharmacokinetic parameter. It can be used as a column name when converting a dataset from a vertical to a horizontal format. The value in PPTESTCD cannot be longer than 8 characters, nor can it start with a number (e.g., “1TEST”). PPTESTCD cannot contain characters other than letters, numbers, or underscores. Examples: AUCALL, -TMAX, CMAX.",Req -PPTEST,Parameter Name,Char,(PKPARM),"Synonym -Qualifier","Name of the pharmacokinetic parameter. The value in PPTEST cannot be longer -than 40 characters. Examples: AUC All, Time of CMAX, Max Conc.",Req -PPCAT,Parameter Category,Char,*,"Grouping -Qualifier","Used to define a category of related records. For PP, this should be the name of the -analyte in PCTEST whose profile the parameter is associated with.",Exp -PPSCAT,Parameter Subcategory,Char,*,"Grouping -Qualifier","Categorization of the model type used to calculate the PK parameters. Examples -include COMPARTMENTAL, NON-COMPARTMENTAL.",Perm -PPORRES,"Result or Finding in Original -Units",Char,,"Result -Qualifier",Result of the measurement or finding as originally received or collected.,Exp -PPORRESU,Original Units,Char,(PKUNIT),"Variable -Qualifier","Original units in which the data were collected. The unit for PPORRES. Example: -ng/L.",Exp -PPSTRESC,Character Result/Finding in Standard Format,Char,,Result Qualifier,"Contains the result value for all findings, copied or derived from PPORRES in a standard format or standard units. PPSTRESC should store all results or findings in character format; if results are numeric, they should also be stored in numeric format in PPSTRESN.",Exp -PPSTRESN,Numeric Result/Finding in Standard Units,Num,,Result Qualifier,"Used for continuous or numeric results or findings in standard format; copied in numeric format from PPSTRESC. PPSTRESN should store all numeric test results -or findings.",Exp -PPSTRESU,Standard Units,Char,(PKUNIT),"Variable -Qualifier",Standardized unit used for PPSTRESC and PPSTRESN.,Exp -PPSTAT,Completion Status,Char,(ND),"Record -Qualifier","Used to indicate that a parameter was not calculated. Should be null if a result exists -in PPORRES.",Perm -PPREASND,Reason Parameter Not Calculated,Char,,Record Qualifier,"Describes why a parameter was not calculated, such as INSUFFICIENT DATA. Used in conjunction with PPSTAT when value is NOT DONE.",Perm -PPSPEC,Specimen Material Type,Char,(SPECTYPE),Record Qualifier,"Defines the type of specimen used for a measurement. If multiple specimen types are used for a calculation (e.g., serum and urine for renal clearance), then this field should be left -blank. Examples: SERUM, PLASMA, URINE.",Exp -PPDTC,Date/Time of Parameter Calculations,Char,ISO 8601,Timing,Nominal date/time of parameter calculations.,Perm -PPRFTDTC,Date/Time of Reference Point,Char,ISO 8601,Timing,"Date/time of the reference time point from the PC records used to calculate a -parameter record. The values in PPRFTDTC should be the same as that in PCRFTDTC for related records.",Exp -PPSTINT,"Planned Start of Assessment -Interval",Char,ISO 8601,Timing,"The start of a planned evaluation or assessment interval relative to the Time Point -Reference.",Perm -PPENINT,"Planned End of Assessment -Interval",Char,ISO 8601,Timimg,"The end of a planned evaluation or assessment interval relative to the Time Point -Reference.",Perm diff --git a/data-raw/ig_source/sdtmig_3.2/Supplemental_Qualifiers-specification.csv b/data-raw/ig_source/sdtmig_3.2/Supplemental_Qualifiers-specification.csv deleted file mode 100644 index c8149a2..0000000 --- a/data-raw/ig_source/sdtmig_3.2/Supplemental_Qualifiers-specification.csv +++ /dev/null @@ -1,18 +0,0 @@ -Variable,Variable Label,Type,"Controlled Terms, Codelist -or Format",CDISC Notes,Core -STUDYID,Study Identifier,Char,,Study Identifier of the Parent record(s).,Req -RDOMAIN,Related Domain Abbreviation,Char,DOMAIN,Two-character abbreviation for the domain of the parent record(s).,Req -USUBJID,"Unique -Subject Identifier",Char,,Unique Subject Identifier of the Parent record(s).,Req -IDVAR,Identifying Variable,Char,*,"Identifying variable in the dataset that identifies the related record(s). Examples: --SEQ, --GRPID.",Exp -IDVARVAL,Identifying Variable Value,Char,,Value of identifying variable of the parent record(s).,Exp -QNAM,Qualifier Variable Name,Char,*,"The short name of the Qualifier variable, which is used as a column name in a domain view with data from the parent domain. The value in QNAM cannot be longer than 8 characters, nor can it start with a number (e.g., “1TEST”). QNAM cannot contain characters other than letters, numbers, or underscores. This will often be the column -name in the sponsor’s operational dataset.",Req -QLABEL,Qualifier Variable Label,Char,,"This is the long name or label associated with QNAM. The value in QLABEL cannot be longer than 40 characters. -This will often be the column label in the sponsor’s original dataset.",Req -QVAL,Data Value,Char,,"Result of, response to, or value associated with QNAM. A -value for this column is required; no records can be in SUPP-- with a null value for QVAL.",Req -QORIG,Origin,Char,,"Since QVAL can represent a mixture of collected (on a CRF), derived, or assigned items, QORIG is used to indicate the origin of this data. Examples include CRF, ASSIGNED, or DERIVED. See Section 4: 4.1.1.8, -Origin Metadata.",Req -QEVAL,Evaluator,Char,*,"Used only for results that are subjective (e.g., assigned by a person or a group). Should be null for records that contain objectively collected or derived data. Some examples include ADJUDICATION COMMITTEE, -STATISTICIAN, DATABASE ADMINISTRATOR, CLINICAL COORDINATOR, etc.",Exp diff --git a/data-raw/utils_ig.R b/data-raw/utils_ig.R index cee09fd..d330bbe 100644 --- a/data-raw/utils_ig.R +++ b/data-raw/utils_ig.R @@ -1,151 +1,171 @@ -# Helpers for building versioned SDTM/ADaM implementation-guide (IG) variable -# metadata from the CSV transcriptions under data-raw/ig_source/. -# Sourced by build_ig_sdtm.R and build_ig_adam.R. +# Helpers for building the IG and model datasets (ig_sdtm, model_sdtm, ig_adam, +# ig_sources) from CDISC Library CSV exports. Sourced by build_ig.R. # -# Those source CSVs are column-inconsistent in minor ways across files and -# CDISC versions (a stray blank header cell here, "Codelist/ Controlled -# Terms" vs "Codelist / Controlled Terms" there, "Variable" vs -# "Variable Name"), evidently from how each was originally transcribed from -# a CDISC PDF/Word table. read_ig_csv() normalises all of that by matching -# column *names* (not position) against the canonical fields every one of -# these tables can carry, rather than assuming a fixed column order. +# The exports are downloaded under CDISC's own terms and conditions (use within +# the downloader's organization only; no copying, distribution, or derivative +# works of the material itself). They are therefore never committed here: they +# are read from CDISC_SOURCES_DIR (default "../cdisc-sources", relative to the +# checkout), and only variable metadata is transcribed into data/. See +# data-raw/README.md for how to obtain them. -# Read one IG source CSV and return it with canonical column names: -# variable, label, type, core, codelist, role, notes. Any canonical column -# absent from this particular file (e.g. "role" in an ADaM spec) is filled -# with NA. Blank/duplicate header cells (transcription artifacts) are -# dropped before matching. -read_ig_csv <- function(path) { - # These CSVs are transcriptions of CDISC Word/PDF tables and are encoded - # as Windows-1252 (smart quotes, non-breaking spaces), not UTF-8; reading - # as UTF-8 silently mangles those characters into mojibake instead of - # erroring, so the encoding must be stated explicitly. - raw <- utils::read.csv(path, check.names = FALSE, stringsAsFactors = FALSE, - na.strings = "", fileEncoding = "windows-1252") - # Collapse embedded newlines/extra whitespace in header cells so matching - # is robust to how the CSV happened to wrap a multi-word header. - nm <- gsub("\\s+", " ", trimws(names(raw))) - nm[is.na(nm) | !nzchar(nm)] <- NA_character_ - names(raw) <- nm - raw <- raw[, !is.na(names(raw)) & !duplicated(names(raw)), drop = FALSE] +# The 34 exports this build reads, one standard version per file. +ig_source_files <- c( + "SDTM_v1.2.csv", "SDTM_v1.3.csv", "SDTM_v1.4.csv", "SDTM_v1.5.csv", + "SDTM_v1.6.csv", "SDTM_v1.7.csv", "SDTM_v1.8.csv", "SDTM_v2.0.csv", + "SDTM_v2.1.csv", + "SDTMIG_v3.1.2.csv", "SDTMIG_v3.1.3.csv", "SDTMIG_v3.2.csv", + "SDTMIG_v3.3.csv", "SDTMIG_v3.4.csv", "SDTMIG-AP_v1.0.csv", + "SDTMIG-MD_v1.0.csv", "SDTMIG-MD_v1.1.csv", + "SENDIG_v3.0.csv", "SENDIG_v3.1.csv", "SENDIG_v3.1.1.csv", + "SENDIG-AR_v1.0.csv", "SENDIG-DART_v1.1.csv", "SENDIG-GeneTox_v1.0.csv", + "ADaMIG_v1.0.csv", "ADaMIG_v1.1.csv", "ADaMIG_v1.2.csv", "ADaMIG_v1.3.csv", + "ADaMIG_MD_v1.0.csv", "ADaMIG_NCA_v1.0.csv", "ADaM_ADAE_v1.0.csv", + "ADaM_BDS_for_TTE_v1.0.csv", "ADaM_OCCDS_v1.0.csv", "ADaM_OCCDS_v1.1.csv", + "ADaM_popPK_v1.0.csv" +) - pick <- function(pattern, exclude = NULL) { - hit <- grepl(pattern, names(raw), ignore.case = TRUE) - if (!is.null(exclude)) hit <- hit & !grepl(exclude, names(raw), ignore.case = TRUE) - if (!any(hit)) return(rep(NA_character_, nrow(raw))) - as.character(raw[[which(hit)[1L]]]) - } - - data.frame( - variable = tidy_text(pick("^Variable( Name)?$", exclude = "Label")), - label = tidy_text(pick("Variable Label")), - type = tidy_text(pick("^Type$")), - core = tidy_text(pick("^Core$")), - codelist = tidy_text(pick("Codelist|Controlled Terms")), - role = tidy_text(pick("^Role$")), - notes = pick("CDISC Notes|^Description$"), - stringsAsFactors = FALSE +# The four column layouts the exports come in, and the dataset each feeds. +ig_source_shapes <- list( + ig_sdtm = c( + "Version", "Variable Order", "Class", "Dataset Name", "Variable Name", + "Variable Label", "Type", "CDISC CT Codelist Code(s)", + "Codelist Submission Values", "Described Value Domain(s)", "Value List", + "Role", "CDISC Notes", "Core" + ), + model_v1 = c( + "Version", "Variable Order", "Class", "Dataset Name", "Variable Name", + "Variable Label", "Type", "Described Value Domain", "Role", + "Variables Qualified", "Description" + ), + model_v2 = c( + "Version", "Variable Order", "Class", "Dataset Name", "Variable Name", + "Variable Label", "Type", "Described Value Domain", "Role", + "Variables Qualified", "Usage Restrictions", "Variable C-Code", + "Definition", "Notes", "Examples" + ), + ig_adam = c( + "Version", "Data Structure Name", "Variable Set", "Variable Name", + "Variable Label", "Type", "CDISC CT Codelist Code(s)", + "CDISC CT Codelist Submission Value(s)", "Described Value Domain(s)", + "Value List Value", "Core", "CDISC Notes" ) -} +) -# Collapse every run of whitespace (including the hard line breaks and -# non-breaking spaces left by transcribing a wrapped Word/PDF table cell) -# to a single space and trim the ends. Without this, a table cell that wrapped -# across lines in the source document keeps a literal newline in the value, and -# a cell with a trailing space in the source becomes e.g. the variable name -# "--TESTCD " that never equals "--TESTCD". Applied to every identifying or -# categorical field; not to `notes`, which is free text meant to keep its -# paragraph breaks. +# Collapse every run of whitespace (hard line breaks and non-breaking spaces +# from a wrapped table cell included) to one space, trim the ends, and turn +# the empty result into NA. Applied to every field that is carried into the +# data; the guide prose columns (CDISC Notes, Description, Definition, Notes, +# Examples) are never read into it. tidy_text <- function(x) { - trimws(gsub("[[:space:] ]+", " ", x, perl = TRUE)) + x <- trimws(gsub("[[:space:] ]+", " ", x, perl = TRUE)) + x[!is.na(x) & !nzchar(x)] <- NA_character_ + x } -# Apply documented label overrides to a built IG table. -# -# A handful of labels as published in a CDISC IG exceed the 40-character -# limit for a SAS v5 transport (XPT) variable label, which the same IGs state -# for every variable they define (SDTMIG 3.3 section 4.2.1, "Variable -# descriptive names (labels), up to 40 characters"). The IGs deal with this -# by abbreviating in the domain tables themselves while leaving the generic -# model table or a sibling row at its long form, so the long form is what -# transcribes. `overrides` carries, for each such row, the published -# abbreviation to use instead (or, where the IG publishes none, a sibling- -# consistent one) and `evidence` naming the table checked; this stops, rather -# than silently skipping, if an override does not match exactly the rows it is -# written for. -apply_label_overrides <- function(tbl, overrides, by) { - stopifnot(all(c(by, "label", "evidence") %in% names(overrides))) - for (i in seq_len(nrow(overrides))) { - hit <- rep(TRUE, nrow(tbl)) - for (col in by) hit <- hit & !is.na(tbl[[col]]) & tbl[[col]] == overrides[[col]][i] - if (!any(hit)) { - stop("Label override matched no rows: ", - paste(by, unlist(overrides[i, by]), sep = "=", collapse = ", ")) - } - tbl$label[hit] <- overrides$label[i] +# Absolute path of the CDISC sources directory (not part of this repository). +cdisc_sources_dir <- function() { + Sys.getenv("CDISC_SOURCES_DIR", "../cdisc-sources") +} + +# Paths of all expected export files; stops with a message that lists every +# one that is missing, so a partial download is obvious. +cdisc_source_paths <- function(files = ig_source_files) { + dir <- cdisc_sources_dir() + paths <- file.path(dir, files) + missing <- files[!file.exists(paths)] + if (length(missing)) { + stop( + length(missing), " of the ", length(files), " expected CDISC Library ", + "export file(s) are missing from ", + normalizePath(dir, winslash = "/", mustWork = FALSE), ":\n ", + paste(missing, collapse = "\n "), "\n", + "They are not part of this repository; obtain them under your own CDISC ", + "terms (see data-raw/README.md) and put them there, or set the ", + "CDISC_SOURCES_DIR environment variable to the directory that holds them.", + call. = FALSE + ) } - tbl + stats::setNames(paths, files) } -# Extract a codelist submission value (e.g. "PKPARMCD") from the free-text -# "Codelist/Controlled Terms" column, e.g. "(PKPARMCD)" -> "PKPARMCD". CDISC -# also uses this column for a non-codelist marker ("*" = extensible list not -# further specified in the IG) or a format note ("ISO 8601"); neither names -# an actual codelist, so both return NA. -parse_codelist_token <- function(x) { - text <- ifelse(is.na(x), "", x) - pos <- regexpr("\\(([A-Za-z0-9_]+)\\)", text) - hit <- pos > 0L - token <- rep(NA_character_, length(x)) - # regmatches(text, pos) returns matches only for the TRUE positions of - # `hit`, in order, so it lines up with token[hit] element-for-element. - matched <- regmatches(text, pos) - token[hit] <- sub("^\\((.*)\\)$", "\\1", matched) - # A handful of IG tables reference a codelist by bare name (no - # parentheses), e.g. SUPP--'s RDOMAIN -> "DOMAIN". - bare_ok <- is.na(token) & grepl("^[A-Z][A-Z0-9_]*$", text) - token[bare_ok] <- text[bare_ok] - token +# Read one export and say which of the four shapes it is. +read_library_export <- function(path) { + x <- utils::read.csv(path, check.names = FALSE, stringsAsFactors = FALSE, + na.strings = "", fileEncoding = "UTF-8") + shape <- names(ig_source_shapes)[vapply( + ig_source_shapes, function(cols) identical(sort(cols), sort(names(x))), logical(1L) + )] + if (length(shape) != 1L) { + stop(basename(path), " has columns that match none of the four known export ", + "shapes: ", paste(names(x), collapse = " | "), call. = FALSE) + } + versions <- unique(x$Version) + if (length(versions) != 1L) { + stop(basename(path), " must carry exactly one Version value, found ", + length(versions), ": ", paste(versions, collapse = "; "), call. = FALSE) + } + list(data = x, shape = shape, version_string = versions) } -# Recover a documented maximum character length from CDISC Notes text, e.g. -# "cannot be longer than 8 characters" -> 8L. CDISC implementation guides do -# not publish a Length column at all (length is a sponsor/define.xml -# choice); this recovers the few lengths the IG text states explicitly as a -# hard rule, rather than guessing one for every variable. -parse_documented_length <- function(notes) { - text <- ifelse(is.na(notes), "", notes) - pos <- regexpr("longer than (\\d+) character", text, ignore.case = TRUE) - hit <- pos > 0L - len <- rep(NA_integer_, length(notes)) - # regmatches(text, pos) returns matches only for the TRUE positions of - # `hit`, in order, so it lines up with len[hit] element-for-element. - matched <- regmatches(text, pos) - len[hit] <- suppressWarnings(as.integer(sub("\\D*(\\d+).*", "\\1", matched))) - len +# ---- one converter per shape: only metadata fields are read ---------------- + +ig_sdtm_rows <- function(x, parsed) { + data.frame( + standard = parsed$standard, + version = parsed$version, + class = tidy_text(x$Class), + domain = tidy_text(x[["Dataset Name"]]), + order = as.integer(x[["Variable Order"]]), + variable = tidy_text(x[["Variable Name"]]), + label = tidy_text(x[["Variable Label"]]), + type = tidy_text(x$Type), + role = tidy_text(x$Role), + core = tidy_text(x$Core), + codelist_code = tidy_text(x[["CDISC CT Codelist Code(s)"]]), + codelist_submission_values = tidy_text(x[["Codelist Submission Values"]]), + described_value_domain = tidy_text(x[["Described Value Domain(s)"]]), + value_list = tidy_text(x[["Value List"]]), + stringsAsFactors = FALSE + ) } -# Path to a CDISC source file that is NOT part of this repository. -# -# The SDTMIG 3.4 export is a CDISC Library download made under CDISC's own -# terms and conditions (use within the downloader's organization only; no -# copying, distribution, or derivative works of the material itself). The -# file is therefore never committed here: it is read from CDISC_SOURCES_DIR -# (default "../cdisc-sources", relative to the checkout), and only variable -# metadata is transcribed from it into data/. Anyone reproducing the build -# obtains the export under their own CDISC terms and places it there. -cdisc_sources_file <- function(file) { - dir <- Sys.getenv("CDISC_SOURCES_DIR", "../cdisc-sources") - path <- file.path(dir, file) - if (!file.exists(path)) { - stop( - "Cannot find the CDISC source file '", file, "'.\n", - "Expected it at: ", normalizePath(path, winslash = "/", mustWork = FALSE), "\n", - "It is a CDISC Library export that is not part of this repository; obtain it ", - "under your own CDISC terms and put it there, or set the CDISC_SOURCES_DIR ", - "environment variable to the directory that holds it.", - call. = FALSE - ) +model_sdtm_rows <- function(x, parsed) { + chr_or_na <- function(col) { + if (col %in% names(x)) tidy_text(x[[col]]) else rep(NA_character_, nrow(x)) } - path + data.frame( + standard = parsed$standard, + version = parsed$version, + class = tidy_text(x$Class), + dataset = tidy_text(x[["Dataset Name"]]), + order = as.integer(x[["Variable Order"]]), + variable = tidy_text(x[["Variable Name"]]), + label = tidy_text(x[["Variable Label"]]), + type = tidy_text(x$Type), + role = tidy_text(x$Role), + described_value_domain = tidy_text(x[["Described Value Domain"]]), + variables_qualified = tidy_text(x[["Variables Qualified"]]), + usage_restrictions = chr_or_na("Usage Restrictions"), + variable_code = chr_or_na("Variable C-Code"), + stringsAsFactors = FALSE + ) +} + +ig_adam_rows <- function(x, parsed) { + data.frame( + standard = parsed$standard, + version = parsed$version, + structure = tidy_text(x[["Data Structure Name"]]), + variable_set = tidy_text(x[["Variable Set"]]), + order = seq_len(nrow(x)), + variable = tidy_text(x[["Variable Name"]]), + label = tidy_text(x[["Variable Label"]]), + type = tidy_text(x$Type), + core = tidy_text(x$Core), + codelist_code = tidy_text(x[["CDISC CT Codelist Code(s)"]]), + codelist_submission_values = tidy_text(x[["CDISC CT Codelist Submission Value(s)"]]), + described_value_domain = tidy_text(x[["Described Value Domain(s)"]]), + value_list = tidy_text(x[["Value List Value"]]), + stringsAsFactors = FALSE + ) } diff --git a/data/datasets_catalogue.rda b/data/datasets_catalogue.rda index f85587b53741325983f7ef8bca3bdc4b83ece9ac..fdac553912922a352496e0c2de95dc3d8084e0ed 100644 GIT binary patch delta 594 zcmV-Y0&3r$AzY=ny1irw7l0w?Aydb`@f`i^C#C|4%l2UpIiKaS0*Y) zGr$g*YyMGShQ^(4GZseUi zxKSHz32;1fK?l*RyQdSaq2R+Kl|}~9w_OaC(Wd^dv8UBd-SGP7g>`Bdw-GL!j@QGF zSTN}AuV5{jg3Kk`OWOUPegA8V1lF~XGMl7fQ>j-Lnc?9sC0%lOznj6|aSR_0Na}r- z@%HtMq~nZKs-yF5g+uAxEQ$(CFytkD`Zgxox^~<;Y`p#>4W$jAunOkV6m@&M1!4dI g0Q*LMegFac1gi`H0H^%$+CDH1ivj=u00045TEv?lFaQ7m delta 465 zcmV;?0WSWa1)v0w83Y8e0pXDyM1N*lB<=DprPEEJRYq@amMovgMr}Ca3bw&+e&PS> z_SJT`d!Fht$3HP$vhdmrgP@RRVhrSfI!+pCx9kf;t6@4ROB5LG+aRqL6I)aeeC3Xb zm6sQxbh&q=YgRw#WsWU{KxBGs_uBAM1vfYjO;r%De_C|kaJGbqiLGptF@OG<%GVFu z35>?}(PbvKeS>be`AKWf zmU3fC+oS&Iw|=TePz9(}0O=&!Yq1^7DS_gk#-HgXFM>DC&p4|!vDgI%3~npomPFqs zV!PNd>MWr1K0R|2Ni&Mm{N-xYZN5?>SKj@U=ox65gm$UZ8Q7%m?Lv&dZ6J|%!4W(m ztaB#Lk-99bcQYS^kVZM|g20$g4yOYE00000&bmc)00H>}vIzhHLR-QPJ}?c70ssI2 H00CKA%Td}p diff --git a/data/ig_adam.rda b/data/ig_adam.rda index a250e0c4f8ef2ee9be7f16f90d229d07069f9500..e432fa3207a042ef95b65c07f7c3544387e266d0 100644 GIT binary patch literal 11312 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 literal 20004 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 diff --git a/data/ig_sources.rda b/data/ig_sources.rda new file mode 100644 index 0000000000000000000000000000000000000000..d0bd8d66b475c80fc31ef04ce4b90b69da83f9ac GIT binary patch literal 1460 zcmV;l1xxzvQ&2UKVgRpfklK z2LrlZWZHZHK}m`G8$$Uyy$3$RvJQ!aT}{AYd1ld)7ePwU;!={F3}ApS8S7RMKM>Fo zrg9n)uBkCa`2~gJnK`lPU|xKe>Cj@bI)OSD41X(QG-zItP=GUC9IS=-3LV=HU7;T| z7DKd%4JL}1%lpO-RsXpgj4fR`;|vQ-Bd3+!rpOn@-GW&X$2|lJg*@5*VDeqT1;CDF zs`GdfojbQHWFsPK*(i}KdjOT+7t$7nhIX-p!eirUnbDG4&S zn6PfncCGcuD%V?5z%r)%LXEF_FgW=f+G}s_MYWPPZW*KT;4ZCg zuyN70q4H*7M<@70Rs@`7Dkh-=Hoi`%?=bX0(vyk8%+c4(0IT?lss3LMOnlTDN?(V(&V4FoK{CKGFIY-+EijOT{tXwFHnT&=FJ{+wAkC1Jmkr`8*N+5g2MJCAiKm| z_!*V|w#^8{{J|Q%g>scB=N*_6G04CcBYS2ihZlqyDM%IP4~j$({sdR*4?(9nprxke zHqsl{bASlxvC@3!NYW~<)*XgLySfs3X$S46KjCxP2~D14_BrrHF9Z)z>BXLhB1wa1 znL!*NX;aQf<8kiT@Ljoi{A2Xm=@Q=8#W@U8)n_L0syJy@5_8S3n4M0aZ&@13p5av) z+mDKUS@-s7Dh5zX-wJ>2l_zv`5jblyV|DG+=Bja#%Hy#|hXnyOIR_TwPKAxC?dUoS z-Xz=nXq!Ih2dhmRQ-J!q7~Se?B1DX8Sn|@d^3c{l0ykffb8b*6gEgCX4UwuMycf`; z*~imeK^54c1Hr9%>SYQjirSul36hLFt~K%8j~r?N)|$89!r>!`j4wsDr9(fVhl9&5z%3jQ*m1BJpY{F@BAh8&hZ{ z`QD*6&u8y1E|)cyuD~1h*x}OX4C{Msb@cDJvQ-c8i-NxLh}DB?uILj+{ARW1tAlG$ zTidEaYr47nyYLZyYTpVGr!P}lezA%9& z`|&Jvj@$cELar*!rr<|{{(h!=GsrYw~X&B*6 z6fGHzi0(`F%$9_J>4?#l$s0rN0WLU`Xvz2o`@X7NyZ`{XAWh8x0gwx_B>(`G@g5*P OFb#_W000000a;oC^2MeA literal 0 HcmV?d00001 diff --git a/data/model_sdtm.rda b/data/model_sdtm.rda new file mode 100644 index 0000000000000000000000000000000000000000..5e253bc6303c0e24cc241ff52e9a62e0c47672eb GIT binary patch literal 11716 zcmV;#Ej!ZvH+ooF0004LBHlIv03iV!0000G&sfaqPS`DoT>vQ&2UKVgRpfklK z2LrlZWZHZHK}m`G8$$Uyy$3$RvJQ!aT~4oI8XlcP@i)er2-1~qOrSa@fx=aj1$ru# z1&&J0B#@D12OE%w9 zC|BrO!SOF!g$8g}&D5SI6iU>cDGhgM~jS!Zd}NxU+EvO>JKaG z_nN1LlGZdA?WymGdo2A`VR&{7JlN(r z;t+v7i1}Ebk}EfTU)p<=*vvM5T7u< zB9gMez`m){gwv-&oxL!p=%~e$se)W=I;Lpy_@mvj(S~99St>u*a&fp{AB_87sELTP zL6^rPx>wB=usKF6#o=D+a-_t?OlrnPzK%WWAFM>xk`9WMe=r&4F_k- zoT89fZ27ZG&t?8wB)AHp_Jgn4C#p{+=(iy@>Srt7CyZL6e>u`I(#V~Wdi87h0DTr` z@8b-2CfkN&{E^m6xZ>hYa!auymH`aNmLu;zeTZN}LNQsXYkW1y#C@MwQ`2XDvm=jw z7*&(tFio1kN$mB~z*%odG7iTH1e4#ASa&loD9asKe|G(Gz;(YrC(ITm*u$ zWGKaqN|lv8A2pH`cw4hH}sxb*gekq(O9l#3g@Q{OvoEIINUGiEpPsKB~nsr=vwX;BkEipNP z7~W%%9a|UyZvjHB9(sFE@4$8UZ?yF!S3-{YjLJ6K&?WY9z{&nn4>?*C3A^>UK5Io( zd~o3&x_K7>$r0D+Me=)JH*oL3ie609zGo%ingYEuV&x`pg>FBup)OP?+`6HjjF8d; zTIq}6obz{3Qnc54rFQp6y6*OwWkVTRH4d^l2o

Q$h&S#=*ZpbR;$$4C^=)302Gq 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 a0iavioh1OiHty3tFb#_W000000a;q}e~>@` literal 0 HcmV?d00001 diff --git a/man/build_domain_spec.Rd b/man/build_domain_spec.Rd index 2d55235..192e738 100644 --- a/man/build_domain_spec.Rd +++ b/man/build_domain_spec.Rd @@ -10,17 +10,19 @@ build_domain_spec( ct_version = NULL, adsl = TRUE, sdtm_domain = NULL, - sdtmig_version = NULL + sdtmig_version = NULL, + standard = NULL, + extension = NULL, + extension_version = NULL ) } \arguments{ \item{domain}{One of \code{"PP"}, \code{"SUPPPP"}, or \code{"ADPP"}.} -\item{ig_version}{IG version to use: an SDTMIG version (for \code{PP}/ -\code{SUPPPP}) or an ADaMIG version (for \code{ADPP}). -\code{NULL} uses the newest available for that IG.} +\item{ig_version}{Version of \code{standard} to use. \code{NULL} uses the +newest available.} -\item{ct_version}{CT version to resolve codelist ids against; passed to +\item{ct_version}{CT version to check codelist ids against; passed to \code{\link{get_ct}}. \code{NULL} uses the newest available.} \item{adsl}{For \code{domain = "ADPP"} only: whether to union in the @@ -33,39 +35,66 @@ alone. Ignored (with a warning) for \code{domain != "ADPP"}.} default) adds nothing; \code{"PP"} also unions in the SDTMIG PP domain's variables, the same way \code{adsl = TRUE} unions ADSL's: marked \code{source = "SDTMIG"}, \code{core} forced to \code{"Perm"}, -a variable already defined by BDS or ADSL (e.g. \code{STUDYID}, -\code{USUBJID}) keeping that version, and codelist ids resolved against -the ADaM CT first and the SDTM CT second. Ignored (with a warning) for -\code{domain != "ADPP"}; any value other than \code{"PP"} is an error.} +a variable already defined keeping that version, and codelist ids +checked against the ADaM CT first and the SDTM CT second. Ignored (with +a warning) for \code{domain != "ADPP"}; any value other than +\code{"PP"} is an error.} \item{sdtmig_version}{SDTMIG version to take the \code{sdtm_domain} variables from. \code{NULL} uses the newest available. Ignored (with a warning) unless \code{domain = "ADPP"} and \code{sdtm_domain} is set.} + +\item{standard}{The implementation guide to take the domain's variables +from. \code{NULL} (the default) uses \code{"SDTMIG"} for \code{PP} and +\code{SUPPPP} and \code{"ADaMIG"} for \code{ADPP}; any standard in +\code{\link{get_ig}} that has the domain works (e.g. \code{"SENDIG"} +defines \code{PP} too).} + +\item{extension}{For \code{domain = "ADPP"} only: \code{NULL} (the +default) adds nothing; \code{"ADaMIG-NCA"} (or the alias \code{"NCA"}), +\code{"ADaM-popPK"}, or \code{"ADaM-BDS-TTE"} unions that BDS extension +onto the BDS variables. Unlike the ADSL and PP unions, the extension's +own Core designations are kept, as they are the point of the extension: a +new variable is appended with its published Core, and a variable the BDS +already defines takes the extension's (stronger) Core (e.g. \code{AVISIT} +becomes required in ADaMIG-NCA). Rows the extension touches are marked +with its name in \code{source}. Ignored (with a warning) for +\code{domain != "ADPP"}.} + +\item{extension_version}{Version of the \code{extension}; \code{NULL} uses +the newest. Ignored (with a warning) unless \code{domain = "ADPP"} and +\code{extension} is set.} } \value{ A data frame with columns \code{variable}, \code{label}, - \code{type}, \code{length}, \code{core}, \code{order}, \code{source} - (\code{"SDTMIG"} for \code{PP}/\code{SUPPPP}; \code{"BDS"}, - \code{"ADSL"}, or \code{"SDTMIG"} for \code{ADPP}), and \code{codelist_id} (the codelist's - CT C-code, e.g. \code{"C85839"} for PPTESTCD's PKPARMCD codelist; - \code{NA} when the variable has no codelist or the referenced codelist - name is not found in the CT version used). ADSL-sourced \code{ADPP} rows - have \code{core} forced to \code{"Perm"} regardless of their Core - designation in ADSL itself: from ADPP's perspective, merging in an - ADSL variable is a common but optional choice, not a requirement ADSL's - own Core reflects. + \code{type}, \code{length}, \code{core}, \code{order}, \code{source}, and + \code{codelist_id}. \code{source} is \code{"SDTMIG"} (or the SDTM-side + \code{standard}) for \code{PP}/\code{SUPPPP}; \code{"BDS"}, + \code{"ADSL"}, \code{"SDTMIG"}, or the extension's name for \code{ADPP}. + \code{order} is the published order, renumbered consecutively, with + unioned variables following. \code{codelist_id} is the C-code of the + first codelist the IG lists for the variable, when that codelist is in + the CT release used, and \code{NA} otherwise (no codelist, or one not in + that release, e.g. a codelist since retired). \code{length} is always + \code{NA}: the CDISC Library exports this package is built from carry no + length, which is a sponsor choice, and the column is kept so existing + code that reads it keeps working. ADSL-sourced \code{ADPP} rows have + \code{core} forced to \code{"Perm"} regardless of their Core designation + in ADSL itself: from ADPP's perspective, merging in an ADSL variable is a + common but optional choice, not a requirement ADSL's own Core reflects. } \description{ -Combines \code{\link{get_ig}} (variable name, label, type, core, order) -with \code{\link{get_ct}} (codelist id lookup) into a single, ready-to-use -variable specification for one of the three PK datasets. \code{PP} and -\code{SUPPPP} draw on the SDTMIG (\code{SUPPPP} from the generic SUPP-- +Combines \code{\link{get_ig}} (variable name, label, type, core, order, +codelist) with \code{\link{get_ct}} (is that codelist in the controlled +terminology release) into a single, ready-to-use variable specification for +one of the three PK datasets. \code{PP} and \code{SUPPPP} draw on an +SDTM-side implementation guide (\code{SUPPPP} from the generic SUPP-- structure, since CDISC has no domain-specific SUPPPP table); \code{ADPP} -draws on the ADaMIG BDS (Basic Data Structure) table, since ADPP is a BDS -dataset and CDISC has no ADPP-specific table either, optionally unioned -with the ADaMIG ADSL table (see \code{adsl} below), since a real ADPP -also carries ADSL's subject-level variables, and optionally with the SDTM -PP domain's variables (see \code{sdtm_domain} below). +draws on the ADaMIG Basic Data Structure (BDS) table, since ADPP is a BDS +dataset and CDISC has no ADPP-specific table either. An ADPP spec can +optionally be unioned with the ADaMIG ADSL table (\code{adsl}), with a BDS +extension such as ADaMIG-NCA (\code{extension}), and with the SDTM PP +domain's variables (\code{sdtm_domain}). } \details{ Neither the ADaMIG BDS nor ADSL tables define the PP-inherited @@ -81,5 +110,6 @@ build_domain_spec("PP") build_domain_spec("SUPPPP") build_domain_spec("ADPP") # BDS + ADSL (default) build_domain_spec("ADPP", adsl = FALSE) # BDS only -build_domain_spec("ADPP", sdtm_domain = "PP") # BDS + ADSL + PP variables +build_domain_spec("ADPP", sdtm_domain = "PP") # BDS + ADSL + PP variables +build_domain_spec("ADPP", extension = "NCA") # BDS + ADSL + ADaMIG-NCA } diff --git a/man/datasets_catalogue.Rd b/man/datasets_catalogue.Rd index a4c8021..75c6da2 100644 --- a/man/datasets_catalogue.Rd +++ b/man/datasets_catalogue.Rd @@ -8,7 +8,8 @@ A data frame with columns: \describe{ \item{dataset}{R object name or logical dataset identifier.} - \item{type}{One of \code{"CT"}, \code{"Schema"}, \code{"Stylesheet"}.} + \item{type}{One of \code{"CT"}, \code{"IG"}, \code{"Model"}, + \code{"Schema"}, \code{"Stylesheet"}.} \item{ct_type}{One of \code{"sdtm"}, \code{"adam"}, or \code{NA} for non-CT datasets.} \item{description}{Human-readable description.} diff --git a/man/get_dataset.Rd b/man/get_dataset.Rd index 44ad2cd..65f3adc 100644 --- a/man/get_dataset.Rd +++ b/man/get_dataset.Rd @@ -9,23 +9,29 @@ get_dataset(name, version = NULL) \arguments{ \item{name}{Dataset name from \code{\link{list_datasets}()$dataset}.} -\item{version}{Version string. \code{NULL} returns the latest available -version. For CT: a date string e.g. \code{"2024-09-27"}. For -schemas/stylesheets: a Define-XML version string e.g. \code{"2.1"}.} +\item{version}{Version string. For CT, \code{NULL} returns the latest +available version and a value is a date string e.g. \code{"2024-09-27"}. +For schemas/stylesheets, \code{NULL} is the latest and a value is a +Define-XML version string e.g. \code{"2.1"}. For the IG and model datasets, +\code{NULL} returns every version.} } \value{ -A data frame (for CT data) or a file path string (for - schemas/stylesheets). +A data frame (for CT, IG, and model data) or a file path string + (for schemas/stylesheets). } \description{ Generic retrieval gateway. For CT datasets, filters to rows valid at -the requested version date. For schemas and stylesheets, returns the -file path for the requested Define-XML version. Use \code{\link{list_datasets}} -to see available dataset names. +the requested version date. For the implementation-guide and model datasets +(\code{ig_sdtm}, \code{model_sdtm}, \code{ig_adam}), returns the whole +table, or the rows whose \code{version} column equals \code{version} (across +every standard in it; use \code{\link{get_ig}} to pick one standard). For +schemas and stylesheets, returns the file path for the requested Define-XML +version. Use \code{\link{list_datasets}} to see available dataset names. } \examples{ get_dataset("ct_sdtm") get_dataset("ct_sdtm", version = "2024-09-27") +get_dataset("ig_adam", version = "1.3") get_dataset("define_xml_schema", version = "2.1") get_dataset("define_xml_stylesheet", version = "2.0") } diff --git a/man/get_ig.Rd b/man/get_ig.Rd index aba1397..856f8e9 100644 --- a/man/get_ig.Rd +++ b/man/get_ig.Rd @@ -2,57 +2,68 @@ % Please edit documentation in R/get_ig.R \name{get_ig} \alias{get_ig} -\title{Retrieve CDISC implementation-guide variable metadata} +\title{Retrieve CDISC implementation-guide or model variable metadata} \usage{ -get_ig(standard = c("sdtm", "adam"), version = NULL, domain = NULL) +get_ig(standard = "SDTMIG", version = NULL, domain = NULL) } \arguments{ -\item{standard}{One of \code{"sdtm"} or \code{"adam"}.} +\item{standard}{One standard from the list above (default +\code{"SDTMIG"}), or the alias \code{"sdtm"} or \code{"adam"}.} -\item{version}{A version string present in the \code{version} column -(e.g. \code{"3.2"} for SDTMIG, \code{"1.7"} for the SDTM Model, -\code{"1.2"} for ADaMIG). \code{NULL} (the default) returns all -versions.} +\item{version}{A version string of that standard (e.g. \code{"3.4"}). +\code{NULL} (the default) uses the newest, compared numerically, so +\code{"3.1.3"} ranks below \code{"3.2"}.} -\item{domain}{Restrict to one domain/dataset: for \code{"sdtm"}, the -\code{domain} column (\code{"PP"} or \code{"SUPPQUAL"} at SDTMIG -3.2 and 3.3, any of 63 domains at 3.4; SDTM Model rows have no domain -and are excluded); for \code{"adam"}, the -\code{dataset} column (\code{"ADSL"} or \code{"BDS"}). \code{NULL} -(the default) applies no domain filter.} +\item{domain}{Restrict to one domain or structure. For the +implementation-guide standards in \code{\link{ig_sdtm}}, the +\code{domain} column (e.g. \code{"PP"}); for \code{"SDTM"}, a +\code{class} (e.g. \code{"Findings"}) or a \code{dataset} (e.g. +\code{"DM"}); for the ADaM standards, the \code{structure} column, where +\code{"BDS"} and \code{"ADSL"} are accepted as aliases for +\code{"Basic Data Structure"} and \code{"Subject-Level Analysis +Dataset"}. \code{NULL} (the default) applies no filter.} } \value{ -A data frame: \code{\link{ig_sdtm}} or \code{\link{ig_adam}}, - optionally filtered to one version and/or domain. +A data frame: the rows of \code{\link{ig_sdtm}}, + \code{\link{model_sdtm}}, or \code{\link{ig_adam}} for that standard, + version, and domain. An unknown standard, version, or domain is a classed + error (\code{cdiscdata_error_ig_standard_unavailable}, + \code{cdiscdata_error_ig_version_unavailable}, + \code{cdiscdata_error_ig_domain_unavailable}). } \description{ -Mirrors \code{\link{get_ct}}, but for implementation-guide (IG) variable -metadata rather than controlled terminology. Unlike CT, which uses a -single validity-date timeline per standard, \code{ig_sdtm} bundles two -independently-versioned sources (the SDTM Model and the SDTMIG; see -\code{\link{ig_sdtm}}), so there is no single "latest" snapshot to default -to: \code{version = NULL} returns every source and version, for the -caller to filter further (by \code{source}/\code{domain}/\code{class} for -\code{ig_sdtm}, or \code{dataset}/\code{category} for \code{ig_adam}). -\code{\link{build_domain_spec}} does this filtering for the PP, SUPPPP, -and ADPP datasets specifically. +One accessor over every standard in \code{\link{ig_sdtm}}, +\code{\link{model_sdtm}}, and \code{\link{ig_adam}}, mirroring +\code{\link{get_ct}}. The standard is chosen with \code{standard}; the +version defaults to that standard's newest. } \details{ -\strong{SDTMIG coverage.} SDTMIG 3.2 and 3.3 carry only the PP domain and -the generic SUPP-- structure; version 3.3 reuses the 3.2 tables, since the -published SDTMIG v3.3 stamps its PP specification "Version 3.2" (unchanged -since 3.2) and its SUPP-- specification has the same ten variables. Both -include \code{TAETORD}, \code{EPOCH}, and \code{PPDY}, which the Rsdtm -transcription of 3.2 this package copies from omitted. SDTMIG 3.4 carries -every one of its 63 domains, from a CDISC Library export (names, labels, -types, codelists, roles, Core, and order; the export's CDISC Notes text is -not included, so \code{notes} is \code{NA} for those rows). Its PP table -adds \code{PPANMETH} and \code{PPTPTREF}. \code{PPDTC} (not -\code{PPPDTC}) is the published name of the date/time-of-calculation -variable in all three versions. See \code{data-raw/ig_source/README.md}. +The standards, and the dataset each is stored in: +\itemize{ + \item \code{"SDTM"} (model versions 1.2 to 2.1): \code{\link{model_sdtm}}. + \item \code{"SDTMIG"} (3.1.2 to 3.4), \code{"SDTMIG-AP"}, + \code{"SDTMIG-MD"}, \code{"SENDIG"} (3.0 to 3.1.1), + \code{"SENDIG-AR"}, \code{"SENDIG-DART"}, \code{"SENDIG-GeneTox"}: + \code{\link{ig_sdtm}}. + \item \code{"ADaMIG"} (1.0 to 1.3), \code{"ADaMIG-MD"}, + \code{"ADaMIG-NCA"}, \code{"ADaM-ADAE"}, \code{"ADaM-BDS-TTE"}, + \code{"ADaM-OCCDS"}, \code{"ADaM-popPK"}: \code{\link{ig_adam}}. +} +The lower-case names \code{"sdtm"} and \code{"adam"}, the only values the +first argument took before it named a standard, are kept as aliases for the +defaults \code{"SDTMIG"} and \code{"ADaMIG"} (note \code{"SDTM"} in capitals +is the model, not the implementation guide). + +All of this comes from CDISC Library CSV exports that are not part of this +package or repository (see \code{\link{ig_sources}} for exactly which +files, and \code{data-raw/README.md}). Only variable metadata is carried; +the guides' prose (CDISC Notes, Description, Definition, Examples) is not. } \examples{ -get_ig("sdtm") -get_ig("sdtm", version = "3.3", domain = "PP") -get_ig("adam", version = "1.2", domain = "BDS") +get_ig() # newest SDTMIG (3.4) +get_ig("SDTMIG", version = "3.3", domain = "PP") +get_ig("SENDIG", domain = "PP") +get_ig("ADaMIG", domain = "BDS") +get_ig("ADaMIG-NCA") +get_ig("SDTM", version = "2.1", domain = "Findings") } diff --git a/man/ig_adam.Rd b/man/ig_adam.Rd index 6282737..2d25ab9 100644 --- a/man/ig_adam.Rd +++ b/man/ig_adam.Rd @@ -7,39 +7,52 @@ \format{ A data frame with columns: \describe{ - \item{dataset}{\code{"ADSL"} or \code{"BDS"}.} - \item{version}{ADaMIG version, e.g. \code{"1.2"}.} - \item{category}{The Rsdtm source file's variable-category name (e.g. - \code{"ADSL_Treatment_Variables"}, \code{"Timing_Variables_BDS_Datasets"}), - kept for provenance; ADaMIG itself does not group these tables this - way.} - \item{order}{Row order within its category file, as published.} + \item{standard}{The standard, e.g. \code{"ADaMIG"} or + \code{"ADaMIG-NCA"}.} + \item{version}{The standard's version, e.g. \code{"1.3"}.} + \item{structure}{The data structure, as named in the export, e.g. + \code{"Basic Data Structure"} or \code{"Subject-Level Analysis + Dataset"} (ADSL).} + \item{variable_set}{The variable set within the structure, e.g. + \code{"Timing"}.} + \item{order}{Row order within the export for that standard version.} \item{variable}{Variable name, e.g. \code{"AVAL"}.} - \item{label}{Variable label.} + \item{label}{Variable label. At most 40 characters except + \code{PBCHGCyN} in ADaMIG 1.2 and 1.3, which the guide publishes at 41.} \item{type}{\code{"Char"} or \code{"Num"}.} - \item{core}{ADaMIG Core designation (\code{"Req"}/\code{"Exp"}/ - \code{"Perm"}/\code{"Cond"}).} - \item{codelist}{Codelist submission value referenced by this variable, - parsed the same way as \code{\link{ig_sdtm}}'s \code{codelist} - column; see there for details and caveats.} - \item{length}{Maximum character length when the IG text states one - explicitly; \code{NA} otherwise. See \code{\link{ig_sdtm}}.} - \item{notes}{CDISC Notes text for the variable.} + \item{core}{Core designation (\code{"Req"}, \code{"Perm"}, + \code{"Cond"}, ...).} + \item{codelist_code}{CDISC CT codelist C-code(s) the variable uses; + several are separated by \code{"; "}. \code{NA} when none.} + \item{codelist_submission_values}{The codelist submission value(s), + where the export gives them.} + \item{described_value_domain}{A described value domain, where the + variable has one rather than a codelist.} + \item{value_list}{A fixed list of allowed values, where there is one.} } } \source{ -\url{https://github.com/humanpred/Rsdtm}; see - \code{data-raw/ig_source/README.md} for full attribution. +CDISC Library CSV exports, downloaded under CDISC's terms and not + redistributed; see \code{data-raw/README.md}. } \usage{ ig_adam } \description{ -Versioned ADaMIG variable metadata: the ADSL (subject-level) variable -table and the generic BDS (Basic Data Structure) variable table (used for -ADPP, a BDS-structured dataset), for ADaMIG versions 1.0, 1.1, and 1.2. -Use \code{\link{get_ig}} to retrieve it, and -\code{\link{build_domain_spec}} to build a ready-to-use ADPP variable -spec from it (joined to CT for codelist ids). +One row per variable of seven ADaM standards, at every version: ADaMIG +(1.0, 1.1, 1.2, 1.3), ADaMIG-MD (1.0), ADaMIG-NCA (1.0), ADaM-ADAE (1.0), +ADaM-BDS-TTE (1.0), ADaM-OCCDS (1.0, 1.1), and ADaM-popPK (1.0); 11 standard +versions in all. Built from CDISC Library CSV exports that are not part of +this package or repository (see \code{\link{ig_sources}} and +\code{data-raw/README.md}); only variable metadata is carried, not the +guides' prose. Use \code{\link{get_ig}} to retrieve a standard, and +\code{\link{build_domain_spec}} to build an ADPP variable spec from it +(ADPP is a Basic Data Structure dataset; ADaMIG-NCA extends it). +} +\details{ +A (standard, version, structure, variable_set, variable) is unique: the +variable set is part of the key because ADaM-OCCDS defines \code{DECDORGw} +twice, once for each dictionary-specific variable set, with different +labels. } \keyword{datasets} diff --git a/man/ig_sdtm.Rd b/man/ig_sdtm.Rd index 1c9e508..88d3a4a 100644 --- a/man/ig_sdtm.Rd +++ b/man/ig_sdtm.Rd @@ -3,61 +3,55 @@ \docType{data} \name{ig_sdtm} \alias{ig_sdtm} -\title{SDTM implementation-guide variable metadata} +\title{SDTM-side implementation-guide variable metadata} \format{ A data frame with columns: \describe{ - \item{source}{\code{"SDTM_MODEL"} or \code{"SDTMIG"}.} - \item{version}{SDTM Model version (\code{"1.4"}-\code{"1.7"}) for - \code{source == "SDTM_MODEL"} rows; SDTMIG version (\code{"3.2"}, - \code{"3.3"}, or \code{"3.4"}) for \code{source == "SDTMIG"} rows. The two are independent numbering - systems; see \code{\link{get_ig}}.} - \item{class}{General observation class, e.g. \code{"Findings"}. - \code{NA} for \code{SDTMIG} 3.2 and 3.3 rows; populated for 3.4.} - \item{domain}{Domain: \code{"PP"} or \code{"SUPPQUAL"} for SDTMIG 3.2 - and 3.3; any of the 63 SDTMIG 3.4 domains (\code{"AE"}, \code{"LB"}, - \code{"SUPPQUAL"}, ...) for 3.4. \code{NA} for \code{SDTM_MODEL} - rows.} - \item{order}{Row order within its source table, as published.} + \item{standard}{The standard, e.g. \code{"SDTMIG"} or \code{"SENDIG-AR"}.} + \item{version}{The standard's version, e.g. \code{"3.4"}.} + \item{class}{General observation class, e.g. \code{"Findings"}.} + \item{domain}{Domain, e.g. \code{"PP"}, \code{"LB"}, \code{"SUPPQUAL"}.} + \item{order}{Position within the domain, as published.} \item{variable}{Variable name, e.g. \code{"PPTESTCD"}.} - \item{label}{Variable label.} + \item{label}{Variable label. At most 40 characters except for 22 labels + the guides themselves publish longer (see the data-integrity tests).} \item{type}{\code{"Char"} or \code{"Num"}.} - \item{role}{CDISC variable role, e.g. \code{"Topic"}. \code{NA} for - ADaM rows (not applicable, and not present in \code{ig_adam}).} - \item{core}{SDTMIG Core designation (\code{"Req"}/\code{"Exp"}/ - \code{"Perm"}). \code{NA} for \code{SDTM_MODEL} rows (the model does - not designate Core; that is an IG-level concept).} - \item{codelist}{Codelist submission value referenced by this variable - (e.g. \code{"PKPARMCD"}), parsed from the IG's free-text - "Controlled Terms" column. Look up its codelist C-code via - \code{\link{get_ct}}'s \code{codelist_name}/\code{codelist_code} - columns, as \code{\link{build_domain_spec}} does. \code{NA} when the - variable has no codelist, or the column instead names a format - (e.g. "ISO 8601") or an unspecified extensible list ("*").} - \item{length}{Maximum character length, when the IG text states one - explicitly (e.g. PPTESTCD's 8-character limit); \code{NA} otherwise, - since CDISC implementation guides do not otherwise publish a Length - column (length is a sponsor/define.xml choice).} - \item{notes}{CDISC Notes / Description text for the variable.} + \item{role}{CDISC variable role, e.g. \code{"Topic"}.} + \item{core}{Core designation (\code{"Req"}, \code{"Exp"}, + \code{"Perm"}, \code{"Cond"}, or the published \code{"Not used"}).} + \item{codelist_code}{CDISC CT codelist C-code(s) the variable uses, as + published; several are separated by \code{"; "} (e.g. PPORRESU lists + PKUNIT and four normalised-unit codelists). \code{NA} when none.} + \item{codelist_submission_values}{The codelist submission value(s), + where the export gives them (the SEND guides do; the SDTMIG exports do + not, so look the code up in \code{\link{get_ct}}).} + \item{described_value_domain}{A described value domain such as + \code{"ISO 8601"}, where the variable has one rather than a codelist.} + \item{value_list}{A fixed list of allowed values, e.g. the domain + abbreviation for \code{DOMAIN}.} } } \source{ -\url{https://github.com/humanpred/Rsdtm}; see - \code{data-raw/ig_source/README.md} for full attribution. +CDISC Library CSV exports, downloaded under CDISC's terms and not + redistributed; see \code{data-raw/README.md}. } \usage{ ig_sdtm } \description{ -Versioned SDTM Model and SDTMIG variable metadata: the Model's Findings -general-observation-class variables (versions 1.4-1.7); the SDTMIG PP -domain and generic SUPP-- qualifier structure (used for SUPPPP) at -versions 3.2 and 3.3, which share the same tables; and every domain of -SDTMIG 3.4 (63 domains, 1917 variables), transcribed from a CDISC Library -export that is not redistributed (see \code{\link{get_ig}} and -\code{data-raw/ig_source/README.md}). -Use \code{\link{get_ig}} to retrieve it, and +One row per variable of every domain of seven implementation-guide +standards, at every version: SDTMIG (3.1.2, 3.1.3, 3.2, 3.3, 3.4), +SDTMIG-AP (1.0), SDTMIG-MD (1.0, 1.1), SENDIG (3.0, 3.1, 3.1.1), +SENDIG-AR (1.0), SENDIG-DART (1.1), and SENDIG-GeneTox (1.0); 14 standard +versions in all. Built from CDISC Library CSV exports that are not part of +this package or repository (see \code{\link{ig_sources}} and +\code{data-raw/README.md}); only variable metadata is carried, not the +guides' prose. Use \code{\link{get_ig}} to retrieve a standard, and \code{\link{build_domain_spec}} to build a ready-to-use PP/SUPPPP/ADPP -variable spec from it (joined to CT for codelist ids). +variable spec from it. The SDTM model itself is in +\code{\link{model_sdtm}}. +} +\details{ +A (standard, version, domain, variable) is unique. } \keyword{datasets} diff --git a/man/ig_sources.Rd b/man/ig_sources.Rd new file mode 100644 index 0000000..0e2e2db --- /dev/null +++ b/man/ig_sources.Rd @@ -0,0 +1,33 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/data.R +\docType{data} +\name{ig_sources} +\alias{ig_sources} +\title{The CDISC Library exports the IG and model datasets were built from} +\format{ +A data frame with 34 rows and columns: +\describe{ + \item{file}{The export's file name.} + \item{version_string}{The export's \code{Version} value, e.g. + \code{"ADaMIG MD v1.0"}.} + \item{standard}{The canonical standard name parsed from it.} + \item{version}{The version number parsed from it.} + \item{table}{The dataset it was loaded into: \code{"ig_sdtm"}, + \code{"model_sdtm"}, or \code{"ig_adam"}.} + \item{rows}{Data rows in the file, equal to the rows loaded from it.} + \item{md5}{MD5 checksum of the file, to tell whether a rebuild used the + same export.} +} +} +\source{ +CDISC Library CSV exports; see \code{data-raw/README.md}. +} +\usage{ +ig_sources +} +\description{ +One row per export file read by \code{data-raw/build_ig.R}, so which +standard versions are bundled, and from exactly which files, is itself +data. The files are not part of this package or repository. +} +\keyword{datasets} diff --git a/man/model_sdtm.Rd b/man/model_sdtm.Rd new file mode 100644 index 0000000..6ec286d --- /dev/null +++ b/man/model_sdtm.Rd @@ -0,0 +1,50 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/data.R +\docType{data} +\name{model_sdtm} +\alias{model_sdtm} +\title{SDTM model variable metadata} +\format{ +A data frame with columns: +\describe{ + \item{standard}{Always \code{"SDTM"}.} + \item{version}{Model version, e.g. \code{"2.1"}.} + \item{class}{Observation class or dataset class, e.g. + \code{"Findings"}, \code{"Trial Design"}.} + \item{dataset}{Dataset name, or \code{NA} for class-level variables.} + \item{order}{Position within the class/dataset, as published.} + \item{variable}{Variable name, e.g. \code{"--TESTCD"}.} + \item{label}{Variable label. \code{"--TESTCD"} is published at 46 + characters in model versions 1.2 to 1.6.} + \item{type}{\code{"Char"} or \code{"Num"}.} + \item{role}{CDISC variable role.} + \item{described_value_domain}{A described value domain, e.g. + \code{"ISO 8601"}; sparse before version 2.0.} + \item{variables_qualified}{The variable(s) this one qualifies.} + \item{usage_restrictions}{Usage restrictions on the variable; version + 2.0 and later, \code{NA} before.} + \item{variable_code}{The variable's NCI C-code; version 2.0 and later, + \code{NA} before.} +} +} +\source{ +CDISC Library CSV exports, downloaded under CDISC's terms and not + redistributed; see \code{data-raw/README.md}. +} +\usage{ +model_sdtm +} +\description{ +One row per variable of the CDISC SDTM model, at every version: 1.2, 1.3, +1.4, 1.5, 1.6, 1.7, 1.8, 2.0, and 2.1. Built from CDISC Library CSV exports +not redistributed with this package (see \code{\link{ig_sources}}); only +variable metadata is carried, not the model's descriptions, definitions, +notes, or examples. Retrieve it with \code{\link{get_ig}("SDTM")}. +} +\details{ +A (standard, version, class, dataset, variable) is unique. \code{dataset} +is \code{NA} for the general-observation-class variables (Events, +Findings, ...), which are defined once per class with a \code{--} prefix, +and set for the datasets the model defines outright (e.g. \code{"DM"}). +} +\keyword{datasets} diff --git a/tests/testthat/helper-ig-exceptions.R b/tests/testthat/helper-ig-exceptions.R new file mode 100644 index 0000000..1f0edc4 --- /dev/null +++ b/tests/testthat/helper-ig-exceptions.R @@ -0,0 +1,82 @@ +# Reviewed, explicit exceptions to the IG data gates (test-ig_integrity.R). +# +# Every row here is a defect the CDISC guides themselves publish, kept as +# published: shortening a label to fit an XPT file, or filling in a missing +# type or Core, is the job of whoever writes a dataset, not of this package. +# The gates compare against these lists in both directions, so a new +# over-length label fails, and so does an entry that is no longer true. + +# Labels over 40 characters (the SAS v5 transport limit the guides themselves +# state, SDTMIG 3.3 section 4.2.1). 22 rows across four standards. +ig_label_exceptions <- local({ + rows <- list( + # SDTMIG 3.2 (the long forms were abbreviated in 3.3) + c("ig_sdtm", "SDTMIG", "3.2", "HO", "HOTERM"), + c("ig_sdtm", "SDTMIG", "3.2", "HO", "HODECOD"), + c("ig_sdtm", "SDTMIG", "3.2", "HO", "HOSTDY"), + c("ig_sdtm", "SDTMIG", "3.2", "MH", "MHREASND"), + c("ig_sdtm", "SDTMIG", "3.2", "IS", "ISSTRESC"), + c("ig_sdtm", "SDTMIG", "3.2", "MI", "MISTRESC"), + c("ig_sdtm", "SDTMIG", "3.2", "PC", "PCSTRESC"), + c("ig_sdtm", "SDTMIG", "3.2", "PP", "PPSTRESC"), + c("ig_sdtm", "SDTMIG", "3.2", "PE", "PESTRESC"), + c("ig_sdtm", "SDTMIG", "3.2", "QS", "QSSTRESC"), + c("ig_sdtm", "SDTMIG", "3.2", "FA", "FALAT"), + c("ig_sdtm", "SDTMIG", "3.2", "SR", "SRSTRESC"), + # SDTMIG-MD 1.0 (abbreviated in 1.1) + c("ig_sdtm", "SDTMIG-MD", "1.0", "DE", "DEDY"), + c("ig_sdtm", "SDTMIG-MD", "1.0", "DE", "DESTDY"), + c("ig_sdtm", "SDTMIG-MD", "1.0", "DT", "DTDTC"), + # SDTM model 1.2 to 1.6 (abbreviated from 1.7) + c("model_sdtm", "SDTM", "1.2", "Findings", "--TESTCD"), + c("model_sdtm", "SDTM", "1.3", "Findings", "--TESTCD"), + c("model_sdtm", "SDTM", "1.4", "Findings", "--TESTCD"), + c("model_sdtm", "SDTM", "1.5", "Findings", "--TESTCD"), + c("model_sdtm", "SDTM", "1.6", "Findings", "--TESTCD"), + # ADaMIG 1.2 and 1.3 + c("ig_adam", "ADaMIG", "1.2", "Basic Data Structure", "PBCHGCyN"), + c("ig_adam", "ADaMIG", "1.3", "Basic Data Structure", "PBCHGCyN") + ) + labels <- c( + rep(c("Reported Term for the Healthcare Encounter", + "Dictionary-Derived Term for the Healthcare Encounter", + "Study Day of Start of Healthcare Encounter", + "Reason Medical History Not Done or Not Occurred", + "Character Results/Findings in Std. Format"), 1L), + rep("Character Result/Finding in Standard Format", 5L), + "Laterality of Location of the Finding About", + "Character Results/Findings in Std. Format", + "Study Day of Device Event Data Collection", + "Study Day of Device Event Start Date/Time", + "Date/Time of Device Tracking Event Collection", + rep("Short Name of Measurement, Test or Examination", 5L), + rep("Percent Change to Baseline Category y (N)", 2L) + ) + m <- do.call(rbind, rows) + data.frame(table = m[, 1L], standard = m[, 2L], version = m[, 3L], + where = m[, 4L], variable = m[, 5L], label = labels, + stringsAsFactors = FALSE) +}) + +# The only rows whose type or Core the guides leave blank. +ig_missing_field_exceptions <- data.frame( + table = "ig_sdtm", + standard = c("SDTMIG", "SDTMIG", "SDTMIG", "SDTMIG", "SDTMIG-MD"), + version = c("3.1.3", "3.2", "3.2", "3.2", "1.0"), + domain = c("TR", "TR", "PR", "FA", "DX"), + variable = c("TRMETHOD", "TRMETHOD", "PRLNKGRP", "FALAT", "DXLAT"), + field = c("type", "type", "core", "core", "core"), + stringsAsFactors = FALSE +) + +# The 34 "Version" strings of the exports the tables are built from. +ig_version_strings <- c( + paste("SDTM v", c("1.2", "1.3", "1.4", "1.5", "1.6", "1.7", "1.8", "2.0", "2.1"), sep = ""), + paste("SDTMIG v", c("3.1.2", "3.1.3", "3.2", "3.3", "3.4"), sep = ""), + "SDTMIG-AP v1.0", "SDTMIG-MD v1.0", "SDTMIG-MD v1.1", + paste("SENDIG v", c("3.0", "3.1", "3.1.1"), sep = ""), + "SENDIG-AR v1.0", "SENDIG-DART v1.1", "SENDIG-GeneTox v1.0", + paste("ADaMIG v", c("1.0", "1.1", "1.2", "1.3"), sep = ""), + "ADaMIG MD v1.0", "ADaMIG NCA v1.0", "ADaM ADAE v1.0", "ADaM BDS for TTE v1.0", + "ADaM OCCDS v1.0", "ADaM OCCDS v1.1", "ADaM popPK v1.0" +) diff --git a/tests/testthat/test-build_domain_spec.R b/tests/testthat/test-build_domain_spec.R index 42ffa7a..9719271 100644 --- a/tests/testthat/test-build_domain_spec.R +++ b/tests/testthat/test-build_domain_spec.R @@ -1,23 +1,27 @@ +# Ground truth for these tests: the CDISC Library exports in ig_sdtm and +# ig_adam. SDTMIG 3.4 PP has 26 variables, ADaMIG 1.3 has 195 BDS and 141 ADSL +# variables (4 shared), ADaMIG-NCA 1.0 has 59, ADaM-popPK 1.0 has 82, and +# ADaM-BDS-TTE 1.0 has 29. + +source_counts <- function(spec) { + tab <- table(spec$source) + stats::setNames(as.integer(tab), names(tab)) +} + test_that("build_domain_spec rejects invalid domain", { expect_error(build_domain_spec("XX")) }) -test_that("build_domain_spec returns expected columns for PP", { +test_that("build_domain_spec returns the documented columns for PP, with no length (the exports have none)", { pp <- build_domain_spec("PP") expect_s3_class(pp, "data.frame") expect_equal(names(pp), c("variable", "label", "type", "length", "core", "order", "source", "codelist_id")) - expect_gt(nrow(pp), 0L) + expect_equal(nrow(pp), 26L) expect_true(all(pp$source == "SDTMIG")) -}) - -test_that("build_domain_spec resolves PPTESTCD/PPTEST/PPSTAT codelist ids against CT", { - pp <- build_domain_spec("PP") - expect_equal(pp$codelist_id[pp$variable == "PPTESTCD"], "C85839") - expect_equal(pp$codelist_id[pp$variable == "PPTEST"], "C85493") - expect_equal(pp$codelist_id[pp$variable == "PPSTAT"], "C66789") - expect_equal(pp$length[pp$variable == "PPTESTCD"], 8L) + expect_type(pp$length, "integer") + expect_true(all(is.na(pp$length))) }) test_that("build_domain_spec PP defaults to the newest SDTMIG (3.4) and returns its 26 variables in order", { @@ -29,138 +33,192 @@ test_that("build_domain_spec PP defaults to the newest SDTMIG (3.4) and returns "PPANMETH", "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPTPTREF", "PPRFTDTC", "PPSTINT", "PPENINT")) expect_equal(pp$order, 1:26) - expect_equal(pp$codelist_id[pp$variable == "EPOCH"], "C99079") - expect_equal(pp$codelist_id[pp$variable == "PPANMETH"], "C172330") expect_equal(pp$core[pp$variable %in% c("PPANMETH", "PPTPTREF")], c("Perm", "Perm")) + expect_equal(pp$label[pp$variable == "PPSTRESC"], "Character Result/Finding in Std Format") expect_identical(pp, build_domain_spec("PP", ig_version = "3.4")) }) -test_that("build_domain_spec PP at 3.3 returns the 24 published variables, without PPANMETH or PPTPTREF", { - pp <- build_domain_spec("PP", ig_version = "3.3") - expect_equal(pp$variable, setdiff(build_domain_spec("PP")$variable, c("PPANMETH", "PPTPTREF"))) - expect_equal(pp$order, 1:24) +test_that("build_domain_spec resolves PP codelist ids against the SDTM CT, the first code of a list winning", { + pp <- build_domain_spec("PP") + ids <- stats::setNames(pp$codelist_id, pp$variable) + expect_equal(ids[["PPTESTCD"]], "C85839") + expect_equal(ids[["PPTEST"]], "C85493") + expect_equal(ids[["PPSTAT"]], "C66789") + expect_equal(ids[["PPSPEC"]], "C78734") + expect_equal(ids[["EPOCH"]], "C99079") + expect_equal(ids[["PPANMETH"]], "C172330") + # "C85494; C128684; ..." in the guide + expect_equal(ids[["PPORRESU"]], "C85494") + expect_equal(sort(names(ids)[!is.na(ids)]), + sort(c("PPTESTCD", "PPTEST", "PPORRESU", "PPSTRESU", "PPSTAT", + "PPSPEC", "PPANMETH", "EPOCH"))) +}) + +test_that("build_domain_spec PP follows each SDTMIG version's published variables: 21, 24, 26 at 3.2, 3.3, 3.4", { + pp32 <- build_domain_spec("PP", ig_version = "3.2") + pp33 <- build_domain_spec("PP", ig_version = "3.3") + pp34 <- build_domain_spec("PP", ig_version = "3.4") + expect_equal(c(nrow(pp32), nrow(pp33), nrow(pp34)), c(21L, 24L, 26L)) + expect_equal(pp33$variable, setdiff(pp34$variable, c("PPANMETH", "PPTPTREF"))) + expect_equal(pp32$variable, setdiff(pp33$variable, c("TAETORD", "EPOCH", "PPDY"))) + expect_equal(pp32$order, 1:21) + expect_equal(nrow(build_domain_spec("PP", ig_version = "3.1.2")), 19L) + expect_false(identical(pp32, pp33)) }) -test_that("build_domain_spec PP at 3.2 equals 3.3 (the tables are unchanged between them)", { - expect_identical(build_domain_spec("PP", ig_version = "3.2"), - build_domain_spec("PP", ig_version = "3.3")) +test_that("build_domain_spec PP can be built from another SDTM-side guide with the standard argument", { + pp <- build_domain_spec("PP", standard = "SENDIG") + expect_equal(nrow(pp), 25L) + expect_true(all(pp$source == "SENDIG")) + expect_equal(nrow(build_domain_spec("PP", standard = "SENDIG", ig_version = "3.0")), 23L) + e <- expect_error(build_domain_spec("PP", standard = "FOO"), + class = "cdiscdata_error_ig_standard_unavailable") + expect_match(conditionMessage(e), "Standard 'FOO' is not available.", fixed = TRUE) }) -test_that("build_domain_spec SUPPPP returns the 10 standard SUPP-- variables", { +test_that("build_domain_spec SUPPPP returns the 10 standard SUPP-- variables, from SUPPQUAL", { supp <- build_domain_spec("SUPPPP") - expect_setequal( - supp$variable, - c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", - "QLABEL", "QVAL", "QORIG", "QEVAL") - ) + expect_equal(supp$variable, + c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", + "QLABEL", "QVAL", "QORIG", "QEVAL")) + expect_equal(supp$order, 1:10) + expect_true(all(supp$source == "SDTMIG")) + expect_equal(supp$codelist_id[!is.na(supp$codelist_id)], c("C66734", "C78735")) + expect_equal(supp$variable[!is.na(supp$codelist_id)], c("RDOMAIN", "QEVAL")) }) -test_that("build_domain_spec ADPP defaults to exactly one (the newest) ADaMIG version", { +test_that("build_domain_spec ADPP defaults to the newest ADaMIG (1.3): 195 BDS variables plus the 137 ADSL ones not already there", { adpp <- build_domain_spec("ADPP") - expect_gt(nrow(adpp), 0L) + expect_equal(nrow(adpp), 332L) + expect_equal(source_counts(adpp)[c("ADSL", "BDS")], c(ADSL = 137L, BDS = 195L)) expect_equal(sum(duplicated(adpp$variable)), 0L) + expect_equal(adpp$order, 1:332) + expect_identical(adpp, build_domain_spec("ADPP", ig_version = "1.3")) }) test_that("build_domain_spec ADPP with an explicit older version differs from the default", { - adpp_latest <- build_domain_spec("ADPP", ig_version = "1.0") - adpp_default <- build_domain_spec("ADPP") - expect_false(identical(sort(adpp_latest$variable), sort(adpp_default$variable))) + adpp_old <- build_domain_spec("ADPP", ig_version = "1.0") + expect_false(identical(sort(adpp_old$variable), sort(build_domain_spec("ADPP")$variable))) + expect_equal(sum(duplicated(adpp_old$variable)), 0L) }) -test_that("build_domain_spec ADPP defaults to adsl = TRUE and unions ADSL variables", { +test_that("build_domain_spec ADPP unions ADSL with Perm core, keeping the BDS version of shared variables", { adpp <- build_domain_spec("ADPP") - expect_true(all(c("BDS", "ADSL") %in% adpp$source)) - # ADSL-only variables (not also defined by BDS) are present... - expect_true("ARM" %in% adpp$variable[adpp$source == "ADSL"]) - # ...marked Perm regardless of their Core designation in ADSL itself - # (ARM is "Req" in ADSL_Treatment_Variables.csv) + expect_equal(adpp$source[adpp$variable == "ARM"], "ADSL") expect_equal(adpp$core[adpp$variable == "ARM"], "Perm") - # no duplicates even though BDS and ADSL share base identifier variables - expect_equal(sum(duplicated(adpp$variable)), 0L) + expect_true(all(adpp$core[adpp$source == "ADSL"] == "Perm")) + expect_equal(adpp$source[adpp$variable == "STUDYID"], "BDS") + expect_equal(sum(adpp$variable == "STUDYID"), 1L) }) -test_that("build_domain_spec ADPP with adsl = FALSE returns BDS variables only", { +test_that("build_domain_spec ADPP resolves codelist ids against the ADaM CT, then the SDTM CT", { + adpp <- build_domain_spec("ADPP") + ids <- stats::setNames(adpp$codelist_id, adpp$variable) + expect_equal(ids[["DTYPE"]], "C81224") + expect_equal(ids[["SEX"]], "C66731") + expect_equal(ids[["AGEU"]], "C66781") + expect_true(is.na(ids[["RACE"]])) + expect_equal(sum(!is.na(adpp$codelist_id)), 54L) + expect_equal(sort(unique(adpp$codelist_id)), + c("C124296", "C66731", "C66781", "C81223", "C81224", "C81226")) +}) + +test_that("build_domain_spec ADPP with adsl = FALSE returns the 195 BDS variables only", { adpp <- build_domain_spec("ADPP", adsl = FALSE) + expect_equal(nrow(adpp), 195L) expect_true(all(adpp$source == "BDS")) expect_false("ARM" %in% adpp$variable) }) -test_that("shared BDS/ADSL variables keep the BDS version, not duplicated", { - adpp <- build_domain_spec("ADPP") - expect_equal(adpp$source[adpp$variable == "STUDYID"], "BDS") - expect_equal(sum(adpp$variable == "STUDYID"), 1L) -}) - test_that("build_domain_spec warns (classed) when adsl is passed for a non-ADPP domain", { w <- expect_warning( build_domain_spec("PP", adsl = FALSE), class = "cdiscdata_warning_adsl_ignored" ) - expect_match(conditionMessage(w), "ignored", fixed = TRUE) + expect_equal(conditionMessage(w), '`adsl` is ignored for domain != "ADPP".') }) -test_that("build_domain_spec aborts (classed) on unknown ig_version", { +test_that("build_domain_spec aborts (classed) on an unknown ig_version, naming the standard", { e_pp <- expect_error( build_domain_spec("PP", ig_version = "9.9"), class = "cdiscdata_error_ig_version_unavailable" ) - expect_match(conditionMessage(e_pp), "not available", fixed = TRUE) - + expect_equal(conditionMessage(e_pp), + "Version '9.9' is not available for SDTMIG. Available versions: 3.1.2, 3.1.3, 3.2, 3.3, 3.4.") e_adpp <- expect_error( build_domain_spec("ADPP", ig_version = "9.9"), class = "cdiscdata_error_ig_version_unavailable" ) - expect_match(conditionMessage(e_adpp), "not available", fixed = TRUE) + expect_match(conditionMessage(e_adpp), "Version '9.9' is not available for ADaMIG.", fixed = TRUE) }) test_that("build_domain_spec aborts informatively on unknown ct_version", { expect_error(build_domain_spec("PP", ct_version = "1900-01-01"), regexp = "not available") }) -test_that("build_domain_spec aborts (classed) when an SDTMIG version has no PP/SUPPQUAL rows", { - # Not reachable via the public API with the currently bundled ig_sdtm - # (SDTMIG's one version, 3.2, always has both PP and SUPPQUAL rows); this - # exercises the defensive check directly by mocking get_ig() to return a - # version that validates but has no rows for either domain. +# ---- codelist id resolution, in isolation ----------------------------------- + +test_that(".codelist_ids takes the first code of a list, from the first CT release that has the codelist", { + ids <- cdiscdata:::.codelist_ids + ct1 <- data.frame(codelist_code = c("C1", "C1"), term_code = c(NA, "T1"), + stringsAsFactors = FALSE) + ct2 <- data.frame(codelist_code = c("C2", "C3"), term_code = c(NA_character_, NA_character_), + stringsAsFactors = FALSE) + expect_equal(ids(c("C1; C2", "C2", NA, "C9", "C3; C1", " C1"), list(ct1, ct2)), + c("C1", "C2", NA, NA, "C3", "C1")) + # a term code alone does not make a codelist known + expect_equal(ids("T1", list(ct1)), NA_character_) + expect_equal(ids(c("C1", "C2"), list(ct1)), c("C1", NA)) + expect_equal(ids(character(0L), list(ct1)), character(0L)) +}) + +test_that("the NULL-coalescing helper returns its left side unless that is NULL", { + or <- cdiscdata:::`%||%` + expect_equal(or(NULL, 1), 1) + expect_equal(or(2, 1), 2) + expect_equal(or(NA, 1), NA) +}) + +# ---- defensive checks, via mocked guides ------------------------------------ + +test_that("build_domain_spec aborts (classed) when an SDTM-side guide has no PP/SUPPQUAL rows", { + # Not reachable with the bundled ig_sdtm for SDTMIG; the check is exercised + # by mocking get_ig() to return a version that validates but has no rows + # for the domain. fake_sdtm <- data.frame( - source = "SDTMIG", version = "9.9", class = NA_character_, + standard = "SDTMIG", version = "9.9", class = NA_character_, domain = "OTHER", order = 1L, variable = "X", label = "X", type = "Char", - role = NA_character_, core = "Req", codelist = NA_character_, - length = NA_integer_, notes = NA_character_, stringsAsFactors = FALSE + role = NA_character_, core = "Req", codelist_code = NA_character_, + stringsAsFactors = FALSE ) testthat::local_mocked_bindings( - get_ig = function(standard, version = NULL) { - if (standard == "sdtm") fake_sdtm else get_ig(standard, version) - }, + get_ig = function(standard = "SDTMIG", version = NULL, domain = NULL) fake_sdtm, .package = "cdiscdata" ) e <- expect_error( build_domain_spec("PP"), class = "cdiscdata_error_no_ig_variables" ) - expect_match(conditionMessage(e), "No SDTMIG 'PP' variables found", fixed = TRUE) + expect_equal(conditionMessage(e), "No SDTMIG 'PP' variables found for version '9.9'.") + e2 <- expect_error(build_domain_spec("SUPPPP"), class = "cdiscdata_error_no_ig_variables") + expect_match(conditionMessage(e2), "No SDTMIG 'SUPPQUAL' variables found", fixed = TRUE) }) -test_that("build_domain_spec aborts (classed) when an ADaMIG version has no BDS rows", { - # Same rationale as the SDTMIG test above: not reachable with the - # currently bundled ig_adam (every version has BDS rows), so mocked. +test_that("build_domain_spec aborts (classed) when an ADaM guide has no BDS rows", { fake_adam <- data.frame( - dataset = "OTHER", version = "9.9", category = "X", order = 1L, - variable = "X", label = "X", type = "Char", core = "Req", - codelist = NA_character_, length = NA_integer_, notes = NA_character_, - stringsAsFactors = FALSE + standard = "ADaMIG", version = "9.9", structure = "OTHER", + variable_set = "X", order = 1L, variable = "X", label = "X", type = "Char", + core = "Req", codelist_code = NA_character_, stringsAsFactors = FALSE ) testthat::local_mocked_bindings( - get_ig = function(standard, version = NULL) { - if (standard == "adam") fake_adam else get_ig(standard, version) - }, + get_ig = function(standard = "ADaMIG", version = NULL, domain = NULL) fake_adam, .package = "cdiscdata" ) e <- expect_error( build_domain_spec("ADPP"), class = "cdiscdata_error_no_ig_variables" ) - expect_match(conditionMessage(e), "No ADaMIG BDS variables found", fixed = TRUE) + expect_equal(conditionMessage(e), "No ADaMIG BDS variables found for version '9.9'.") }) # ---- sdtm_domain: union the SDTMIG PP variables into an ADPP spec ---------- @@ -177,7 +235,7 @@ pp_added_to_adpp_33 <- setdiff(pp_added_to_adpp, c("PPANMETH", "PPTPTREF")) test_that("build_domain_spec ADPP leaves the PP variables out by default, and sdtm_domain = NULL is the default", { base <- build_domain_spec("ADPP") - expect_equal(sum(base$variable %in% pp_added_to_adpp[-1L]), 0L) + expect_equal(sum(base$variable %in% pp_added_to_adpp), 0L) expect_identical(base, build_domain_spec("ADPP", sdtm_domain = NULL)) }) @@ -186,14 +244,12 @@ test_that("build_domain_spec ADPP sdtm_domain = 'PP' appends exactly the 24 PP v withpp <- build_domain_spec("ADPP", sdtm_domain = "PP") added <- withpp[withpp$source == "SDTMIG", ] + expect_equal(nrow(withpp), 356L) expect_equal(nrow(withpp), nrow(base) + 24L) - # the BDS + ADSL rows are untouched and come first expect_identical(withpp[seq_len(nrow(base)), ], base) expect_equal(added$variable, pp_added_to_adpp) expect_true(all(added$core == "Perm")) - # ordered after everything already there, continuing the sequence expect_equal(added$order, max(base$order) + seq_len(24L)) - # shared base variables keep their BDS version and appear once expect_equal(withpp$source[withpp$variable == "STUDYID"], "BDS") expect_equal(sum(withpp$variable %in% c("STUDYID", "USUBJID")), 2L) expect_equal(sum(duplicated(withpp$variable)), 0L) @@ -205,40 +261,40 @@ test_that("build_domain_spec ADPP sdtm_domain = 'PP' takes labels and types from expect_equal(row("PPSTRESC")$label, "Character Result/Finding in Std Format") expect_equal(row("PPSTRESC")$type, "Char") expect_equal(row("PPSTRESN")$type, "Num") - expect_equal(row("PPTESTCD")$length, 8L) + expect_true(is.na(row("PPTESTCD")$length)) expect_equal(row("EPOCH")$label, "Epoch") }) test_that("build_domain_spec ADPP resolves the PP codelist ids against the SDTM CT (ADaM CT has none of them)", { withpp <- build_domain_spec("ADPP", sdtm_domain = "PP") - expect_equal(withpp$codelist_id[withpp$variable == "PPTESTCD"], "C85839") - expect_equal(withpp$codelist_id[withpp$variable == "PPTEST"], "C85493") - expect_equal(withpp$codelist_id[withpp$variable == "PPORRESU"], "C85494") - expect_equal(withpp$codelist_id[withpp$variable == "PPSTAT"], "C66789") - expect_equal(withpp$codelist_id[withpp$variable == "PPSPEC"], "C78734") - expect_equal(withpp$codelist_id[withpp$variable == "EPOCH"], "C99079") - expect_equal(withpp$codelist_id[withpp$variable == "PPANMETH"], "C172330") + ids <- stats::setNames(withpp$codelist_id, withpp$variable) + expect_equal(ids[["PPTESTCD"]], "C85839") + expect_equal(ids[["PPTEST"]], "C85493") + expect_equal(ids[["PPORRESU"]], "C85494") + expect_equal(ids[["PPSTAT"]], "C66789") + expect_equal(ids[["PPSPEC"]], "C78734") + expect_equal(ids[["EPOCH"]], "C99079") + expect_equal(ids[["PPANMETH"]], "C172330") }) test_that("build_domain_spec ADPP sdtm_domain = 'PP' works with adsl = FALSE (BDS + PP only)", { nb <- build_domain_spec("ADPP", adsl = FALSE, sdtm_domain = "PP") bds <- build_domain_spec("ADPP", adsl = FALSE) + expect_equal(nrow(nb), 195L + 24L) expect_equal(sort(unique(nb$source)), c("BDS", "SDTMIG")) expect_identical(nb[seq_len(nrow(bds)), ], bds) expect_equal(nb$variable[nb$source == "SDTMIG"], pp_added_to_adpp) expect_equal(nb$codelist_id[nb$variable == "PPTESTCD"], "C85839") }) -test_that("build_domain_spec ADPP sdtmig_version picks the SDTMIG version (3.2 = 3.3; 3.4 adds two)", { - expect_identical( - build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.2"), - build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.3") - ) +test_that("build_domain_spec ADPP sdtmig_version picks the SDTMIG version (3.3 adds 22, 3.4 adds 24)", { at33 <- build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.3") - expect_equal(at33$variable[at33$source == "SDTMIG"], pp_added_to_adpp_33) at34 <- build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.4") - expect_equal(nrow(at34) - nrow(at33), 2L) + at32 <- build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "3.2") + expect_equal(at33$variable[at33$source == "SDTMIG"], pp_added_to_adpp_33) + expect_equal(c(nrow(at32), nrow(at33), nrow(at34)) - 332L, c(19L, 22L, 24L)) expect_equal(setdiff(at34$variable, at33$variable), c("PPANMETH", "PPTPTREF")) + expect_identical(at34, build_domain_spec("ADPP", sdtm_domain = "PP")) e <- expect_error( build_domain_spec("ADPP", sdtm_domain = "PP", sdtmig_version = "9.9"), class = "cdiscdata_error_ig_version_unavailable" @@ -253,7 +309,7 @@ test_that("build_domain_spec ADPP aborts (classed) on an sdtm_domain other than ) expect_equal( conditionMessage(e), - "`sdtm_domain` must be NULL or \"PP\" (the SDTMIG domain an ADPP is built from), not 'LB'." + '`sdtm_domain` must be NULL or "PP" (the SDTMIG domain an ADPP is built from), not \'LB\'.' ) e2 <- expect_error( build_domain_spec("ADPP", sdtm_domain = c("PP", "LB")), @@ -268,7 +324,7 @@ test_that("build_domain_spec warns (classed) when sdtm_domain or sdtmig_version class = "cdiscdata_warning_sdtm_domain_ignored" ) expect_equal(conditionMessage(w1), - "`sdtm_domain` and `sdtmig_version` are ignored for domain != \"ADPP\".") + '`sdtm_domain` and `sdtmig_version` are ignored for domain != "ADPP".') expect_warning(build_domain_spec("SUPPPP", sdtmig_version = "3.3"), class = "cdiscdata_warning_sdtm_domain_ignored") @@ -278,3 +334,104 @@ test_that("build_domain_spec warns (classed) when sdtm_domain or sdtmig_version ) expect_equal(conditionMessage(w2), "`sdtmig_version` is ignored when `sdtm_domain` is NULL.") }) + +# ---- extension: union a BDS extension (ADaMIG-NCA, popPK, TTE) -------------- + +test_that("extension = 'NCA' unions ADaMIG-NCA onto BDS + ADSL: 56 new rows, 3 touched, 388 in all", { + base <- build_domain_spec("ADPP") + nca <- build_domain_spec("ADPP", extension = "NCA") + ext <- get_ig("ADaMIG-NCA") + expect_equal(nrow(nca), 388L) + expect_equal(source_counts(nca)[c("ADaMIG-NCA", "ADSL", "BDS")], c("ADaMIG-NCA" = 59L, ADSL = 137L, BDS = 192L)) + expect_equal(sum(duplicated(nca$variable)), 0L) + expect_equal(nca$order, 1:388) + # the BDS and ADSL rows keep their position; the extension's new ones follow + expect_equal(nca$variable[seq_len(nrow(base))], base$variable) + expect_equal(nca$variable[-seq_len(nrow(base))], + ext$variable[!ext$variable %in% base$variable]) + expect_equal(nca$order[-seq_len(nrow(base))], nrow(base) + 1:56) +}) + +test_that("extension = 'NCA' is the same as 'ADaMIG-NCA' and keeps the extension's Core, unlike the ADSL and PP unions", { + expect_identical(build_domain_spec("ADPP", extension = "NCA"), + build_domain_spec("ADPP", extension = "ADaMIG-NCA")) + expect_identical(build_domain_spec("ADPP", extension = "NCA"), + build_domain_spec("ADPP", extension = "ADaMIG-NCA", extension_version = "1.0")) + base <- build_domain_spec("ADPP") + nca <- build_domain_spec("ADPP", extension = "NCA") + # variables the BDS already had take NCA's Core, and are marked as NCA's + touched <- c("DOSEA", "DOSEU", "AVISIT") + expect_equal(nca$core[match(touched, nca$variable)], rep("Req", 3L)) + expect_equal(nca$source[match(touched, nca$variable)], rep("ADaMIG-NCA", 3L)) + expect_equal(nca$order[match(touched, nca$variable)], c(11L, 13L, 32L)) + expect_equal(nca$order[match(touched, nca$variable)], base$order[match(touched, base$variable)]) + # newly added variables keep their published Core, with the NCA source + row <- function(v) nca[nca$variable == v, ] + expect_equal(row("PKSUMXF")$core, "Perm") + expect_equal(row("METABFL")$core, "Cond") + expect_equal(row("PCRFTDT")$core, "Req") + expect_equal(row("ROUTE")$core, "Perm") + expect_equal(row("ROUTE")$source, "ADaMIG-NCA") + expect_equal(row("ROUTE")$codelist_id, "C66729") + expect_gt(sum(nca$source == "ADaMIG-NCA" & nca$core == "Req"), 3L) +}) + +test_that("extension = 'NCA' with adsl = FALSE adds the extension to BDS alone", { + nb <- build_domain_spec("ADPP", adsl = FALSE, extension = "NCA") + expect_equal(nrow(nb), 195L + 56L) + expect_false("ARM" %in% nb$variable) + expect_equal(sort(unique(nb$source)), c("ADaMIG-NCA", "BDS")) +}) + +test_that("extension = 'ADaM-popPK' touches 11 existing variables and adds 71", { + p <- build_domain_spec("ADPP", extension = "ADaM-popPK") + expect_equal(nrow(p), 403L) + expect_equal(sum(p$source == "ADaM-popPK"), 82L) + expect_equal(sum(p$source == "BDS"), 189L) + expect_equal(sum(p$source == "ADSL"), 132L) + expect_equal(sum(duplicated(p$variable)), 0L) + expect_equal(p$order, seq_len(403L)) +}) + +test_that("extension = 'ADaM-BDS-TTE' only restates 29 variables the BDS and ADSL already define", { + tte <- build_domain_spec("ADPP", extension = "ADaM-BDS-TTE") + expect_equal(nrow(tte), 332L) + expect_equal(sum(tte$source == "ADaM-BDS-TTE"), 29L) + expect_equal(sum(tte$source == "BDS"), 170L) + expect_equal(sum(tte$source == "ADSL"), 133L) + expect_equal(tte$variable, build_domain_spec("ADPP")$variable) +}) + +test_that("extension aborts (classed) on an unknown extension or version, and warns where it has no effect", { + e <- expect_error(build_domain_spec("ADPP", extension = "FOO"), + class = "cdiscdata_error_extension_unavailable") + expect_equal( + conditionMessage(e), + paste0('`extension` must be NULL or one of "ADaMIG-NCA", "ADaM-popPK", ', + '"ADaM-BDS-TTE", "NCA", not \'FOO\'.') + ) + expect_error(build_domain_spec("ADPP", extension = "SDTMIG"), + class = "cdiscdata_error_extension_unavailable") + ev <- expect_error(build_domain_spec("ADPP", extension = "NCA", extension_version = "9.9"), + class = "cdiscdata_error_ig_version_unavailable") + expect_equal(conditionMessage(ev), + "Version '9.9' is not available for ADaMIG-NCA. Available versions: 1.0.") + + w1 <- expect_warning(build_domain_spec("PP", extension = "NCA"), + class = "cdiscdata_warning_extension_ignored") + expect_equal(conditionMessage(w1), + '`extension` and `extension_version` are ignored for domain != "ADPP".') + expect_warning(build_domain_spec("SUPPPP", extension_version = "1.0"), + class = "cdiscdata_warning_extension_ignored") + w2 <- expect_warning(build_domain_spec("ADPP", extension_version = "1.0"), + class = "cdiscdata_warning_extension_ignored") + expect_equal(conditionMessage(w2), "`extension_version` is ignored when `extension` is NULL.") +}) + +test_that("extension and sdtm_domain compose: BDS, ADSL, NCA, then the PP variables", { + both <- build_domain_spec("ADPP", extension = "NCA", sdtm_domain = "PP") + nca <- build_domain_spec("ADPP", extension = "NCA") + expect_identical(both[seq_len(nrow(nca)), ], nca) + expect_equal(nrow(both), 388L + sum(!pp_added_to_adpp %in% nca$variable)) + expect_equal(sum(duplicated(both$variable)), 0L) +}) diff --git a/tests/testthat/test-data_integrity.R b/tests/testthat/test-data_integrity.R index e126a5b..27812bd 100644 --- a/tests/testthat/test-data_integrity.R +++ b/tests/testthat/test-data_integrity.R @@ -91,104 +91,6 @@ test_that("historical codelist_name/codelist_code gaps stay within a known bound expect_lt(sum(is.na(ct_sdtm$term_code) & is.na(ct_sdtm$codelist_code)), 200L) }) -# Mechanical gate on the IG tables' identifying text, so the transcription -# problems found by nca.reporter when writing XPT v5 files (40-character -# variable-label limit, SDTMIG 3.3 section 4.2.1) cannot recur unnoticed: -# hard-wrapped labels with embedded newlines, over-length labels, section -# sub-headings transcribed as variables (NA label), and variable names with -# trailing whitespace (e.g. "--TESTCD " never equals "--TESTCD"). -ig_tables_for_gate <- function() { - list(ig_sdtm = get_ig("sdtm"), ig_adam = get_ig("adam")) -} - -# The one label the guides themselves publish longer than 40 characters, kept -# as published (decision: shortening a label for an XPT file is the dataset -# writer's job, not cdiscdata's). An exact match on table, version, variable -# and text, so any other over-length label, or this one changing, still fails. -ig_over_length_allowed <- data.frame( - table = "ig_adam", - dataset = "BDS", - version = "1.2", - variable = "PBCHGCyN", - label = "Percent Change to Baseline Category y (N)", - reason = paste("Published at 41 characters in ADaMIG v1.2 (draft, CDISC wiki),", - "section 3.3.4.1, Table 3.3.4.1.1 Analysis Parameter Variables", - "for BDS Datasets; the sibling PCHGCAyN is published abbreviated."), - stringsAsFactors = FALSE -) - -test_that("no IG label is NA, contains a newline, or exceeds 40 characters (bar the documented exception)", { - for (nm in names(ig_tables_for_gate())) { - tbl <- ig_tables_for_gate()[[nm]] - expect_false(anyNA(tbl$label), label = paste(nm, "has an NA label")) - expect_false(any(grepl("[\r\n]", tbl$label)), - label = paste(nm, "has a label containing a newline")) - too_long <- nchar(tbl$label) > 40L - if ("dataset" %in% names(tbl)) { - key <- paste(tbl$dataset, tbl$version, tbl$variable, tbl$label, sep = "\r") - allowed <- ig_over_length_allowed[ig_over_length_allowed$table == nm, ] - allowed_key <- paste(allowed$dataset, allowed$version, allowed$variable, - allowed$label, sep = "\r") - too_long <- too_long & !key %in% allowed_key - } - expect_equal(tbl$variable[too_long], character(0L), - label = paste(nm, "variables whose label exceeds 40 characters")) - } -}) - -test_that("the over-length allow-list is exactly the published 41-character PBCHGCyN label and nothing stale", { - adam <- get_ig("adam") - row <- adam[adam$dataset == "BDS" & adam$version == "1.2" & adam$variable == "PBCHGCyN", ] - expect_equal(nrow(row), 1L) - expect_equal(row$label, ig_over_length_allowed$label) - expect_equal(nchar(row$label), 41L) - # every other ig_adam / ig_sdtm label is within the limit - expect_equal(sum(nchar(adam$label) > 40L), 1L) - expect_equal(sum(nchar(get_ig("sdtm")$label) > 40L), 0L) -}) - -test_that("no IG variable name is NA, blank, or contains whitespace", { - for (nm in names(ig_tables_for_gate())) { - tbl <- ig_tables_for_gate()[[nm]] - expect_false(anyNA(tbl$variable), label = paste(nm, "has an NA variable")) - expect_equal(tbl$variable[!nzchar(tbl$variable)], character(0L)) - expect_equal(tbl$variable[grepl("[[:space:]]", tbl$variable)], character(0L), - label = paste(nm, "variable names containing whitespace")) - } -}) - -test_that("IG categorical fields carry no leading/trailing or doubled whitespace", { - for (nm in names(ig_tables_for_gate())) { - tbl <- ig_tables_for_gate()[[nm]] - for (col in intersect(c("type", "core", "codelist", "role"), names(tbl))) { - v <- tbl[[col]] - v <- v[!is.na(v)] - expect_equal(v[v != trimws(v) | grepl("[[:space:]]{2,}|[\r\n]", v)], character(0L), - label = paste(nm, col, "values with stray whitespace")) - } - } -}) - -test_that("the SDTM IG labels that exceeded 40 characters are the abbreviated published forms", { - sdtm <- get_ig("sdtm") - testcd <- sdtm[sdtm$source == "SDTM_MODEL" & sdtm$variable == "--TESTCD" & - sdtm$version %in% c("1.4", "1.5", "1.6"), ] - expect_equal(sort(testcd$version), c("1.4", "1.5", "1.6")) - expect_equal(testcd$label, rep("Short Name of Measurement, Test or Exam", 3L)) - ppstresc <- sdtm[sdtm$variable == "PPSTRESC" & sdtm$source == "SDTMIG", ] - expect_equal(sort(ppstresc$version), c("3.2", "3.3", "3.4")) - expect_equal(ppstresc$label, rep("Character Result/Finding in Std Format", 3L)) - -}) - -test_that("ADaMIG 1.0 ADSL section sub-headings are not transcribed as variables", { - adsl_10 <- get_ig("adam", version = "1.0") - adsl_10 <- adsl_10[adsl_10$dataset == "ADSL", ] - expect_false(any(c("Study Identifiers", "Subject Demographics", - "Population Indicator(s)", "Treatment Variables", - "Trial Dates") %in% adsl_10$variable)) -}) - # Gap-detection thresholds below are calibrated against verified NCI # publishing history (checked directly against NCI's own file listing API; # see data-raw/utils_nci.R's list_archive_dates()), not against an assumed diff --git a/tests/testthat/test-get_dataset.R b/tests/testthat/test-get_dataset.R index 5ffd9db..4cac7a8 100644 --- a/tests/testthat/test-get_dataset.R +++ b/tests/testthat/test-get_dataset.R @@ -34,3 +34,37 @@ test_that("get_dataset schema version argument is respected", { path_20 <- get_dataset("define_xml_schema", version = "2.0") expect_false(identical(path_21, path_20)) }) + +test_that("get_dataset returns the whole IG and model tables when no version is given", { + expect_identical(get_dataset("ig_sdtm"), cdiscdata::ig_sdtm) + expect_identical(get_dataset("model_sdtm"), cdiscdata::model_sdtm) + expect_identical(get_dataset("ig_adam"), cdiscdata::ig_adam) + expect_equal(c(nrow(get_dataset("ig_sdtm")), nrow(get_dataset("model_sdtm")), + nrow(get_dataset("ig_adam"))), c(10064L, 3604L, 1804L)) +}) + +test_that("get_dataset(version =) restricts an IG or model table to that version string, across standards", { + a13 <- get_dataset("ig_adam", version = "1.3") + expect_equal(unique(a13$version), "1.3") + expect_equal(unique(a13$standard), "ADaMIG") + expect_equal(nrow(a13), nrow(get_ig("ADaMIG", "1.3"))) + expect_equal(nrow(a13), 195L + 141L) + # "1.0" is shared by many standards, and all of them come back + a10 <- get_dataset("ig_adam", version = "1.0") + expect_equal(unique(a10$version), "1.0") + expect_gt(length(unique(a10$standard)), 1L) + m21 <- get_dataset("model_sdtm", version = "2.1") + expect_equal(unique(m21$standard), "SDTM") + expect_equal(nrow(m21), nrow(get_ig("SDTM", "2.1"))) + # only SDTMIG has a 3.4 + expect_equal(nrow(get_dataset("ig_sdtm", version = "3.4")), 1917L) +}) + +test_that("get_dataset aborts (classed) on a version no standard in the IG table has", { + e <- expect_error(get_dataset("ig_adam", version = "9.9"), + class = "cdiscdata_error_ig_version_unavailable") + expect_equal(conditionMessage(e), + "Version '9.9' is not available in ig_adam. Available versions: 1.0, 1.1, 1.2, 1.3.") + expect_error(get_dataset("model_sdtm", version = "3.4"), + class = "cdiscdata_error_ig_version_unavailable") +}) diff --git a/tests/testthat/test-get_ig.R b/tests/testthat/test-get_ig.R index 6a92564..e285622 100644 --- a/tests/testthat/test-get_ig.R +++ b/tests/testthat/test-get_ig.R @@ -1,214 +1,166 @@ -test_that("get_ig returns a data frame for sdtm and adam", { - expect_s3_class(get_ig("sdtm"), "data.frame") - expect_s3_class(get_ig("adam"), "data.frame") -}) - -test_that("get_ig rejects invalid standard", { - expect_error(get_ig("other")) -}) - -test_that("get_ig(version = NULL) returns every source/version", { - sdtm <- get_ig("sdtm") - expect_setequal(unique(sdtm$source), c("SDTM_MODEL", "SDTMIG")) - expect_setequal(sdtm$version[sdtm$source == "SDTM_MODEL"], c("1.4", "1.5", "1.6", "1.7")) - expect_setequal(sdtm$version[sdtm$source == "SDTMIG"], c("3.2", "3.3", "3.4")) - - adam <- get_ig("adam") - expect_setequal(unique(adam$version), c("1.0", "1.1", "1.2")) - expect_setequal(unique(adam$dataset), c("ADSL", "BDS")) -}) - -test_that("get_ig filters to one version when given", { - sdtm_32 <- get_ig("sdtm", version = "3.2") - expect_true(all(sdtm_32$version == "3.2")) - expect_true(all(sdtm_32$source == "SDTMIG")) - - adam_10 <- get_ig("adam", version = "1.0") - expect_true(all(adam_10$version == "1.0")) -}) - -test_that("get_ig aborts (classed) on unknown version", { - e_sdtm <- expect_error( - get_ig("sdtm", version = "9.9"), - class = "cdiscdata_error_ig_version_unavailable" - ) - expect_match(conditionMessage(e_sdtm), "not available", fixed = TRUE) - - e_adam <- expect_error( - get_ig("adam", version = "9.9"), - class = "cdiscdata_error_ig_version_unavailable" - ) - expect_match(conditionMessage(e_adam), "not available", fixed = TRUE) -}) - -test_that("ig_sdtm has expected columns and no NA variable/version", { - ig <- get_ig("sdtm") - expect_true(all(c("source", "version", "class", "domain", "order", - "variable", "label", "type", "role", "core", "codelist", - "length", "notes") %in% names(ig))) - expect_false(anyNA(ig$variable)) - expect_false(anyNA(ig$version)) -}) - -test_that("ig_adam has expected columns and no NA variable/version", { - ig <- get_ig("adam") - expect_true(all(c("dataset", "version", "category", "order", "variable", - "label", "type", "core", "codelist", "length", "notes") %in% - names(ig))) - expect_false(anyNA(ig$variable)) - expect_false(anyNA(ig$version)) -}) - -test_that("SDTMIG PP domain contains PPTESTCD with the PKPARMCD codelist token", { - pp <- get_ig("sdtm", version = "3.2") - pp <- pp[pp$domain == "PP", ] - expect_true("PPTESTCD" %in% pp$variable) - expect_equal(pp$codelist[pp$variable == "PPTESTCD"], "PKPARMCD") - expect_equal(pp$length[pp$variable == "PPTESTCD"], 8L) -}) - -test_that("SUPPQUAL structure has the 10 standard SUPP-- variables", { - supp <- get_ig("sdtm", version = "3.2") - supp <- supp[supp$domain == "SUPPQUAL", ] - expect_setequal( - supp$variable, - c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", - "QLABEL", "QVAL", "QORIG", "QEVAL") - ) -}) - -# Published PP table (SDTMIG v3.3 section 6.3.11.2), in published order. The -# 3.3 guide stamps the table "Version 3.2", so 3.2 and 3.3 carry the same rows. -pp_variables_published <- c( - "STUDYID", "DOMAIN", "USUBJID", "PPSEQ", "PPGRPID", "PPTESTCD", "PPTEST", - "PPCAT", "PPSCAT", "PPORRES", "PPORRESU", "PPSTRESC", "PPSTRESN", - "PPSTRESU", "PPSTAT", "PPREASND", "PPSPEC", "TAETORD", "EPOCH", "PPDTC", - "PPDY", "PPRFTDTC", "PPSTINT", "PPENINT" -) - -test_that("get_ig(domain = 'PP') returns the 24 published PP variables in order at 3.2 and 3.3", { - for (v in c("3.2", "3.3")) { - pp <- get_ig("sdtm", version = v, domain = "PP") - expect_equal(pp$variable, pp_variables_published, label = paste("PP variables at", v)) - expect_equal(pp$order, seq_len(24L)) - expect_true(all(pp$source == "SDTMIG" & pp$domain == "PP" & pp$version == v)) +test_that("get_ig() defaults to the newest SDTMIG (3.4), all 63 of its domains", { + x <- get_ig() + expect_equal(unique(x$standard), "SDTMIG") + expect_equal(unique(x$version), "3.4") + expect_equal(nrow(x), 1917L) + expect_equal(length(unique(x$domain)), 63L) + expect_s3_class(x, "data.frame") + expect_equal(names(x), names(get_dataset("ig_sdtm"))) +}) + +test_that("the pre-redesign names 'sdtm' and 'adam' are kept as aliases for SDTMIG and ADaMIG", { + expect_identical(get_ig("sdtm"), get_ig("SDTMIG")) + expect_identical(get_ig("adam"), get_ig("ADaMIG")) + expect_equal(unique(get_ig("adam")$version), "1.3") + # capital SDTM is the model, not the IG + expect_equal(unique(get_ig("SDTM")$standard), "SDTM") + expect_equal(unique(get_ig("SDTM")$version), "2.1") +}) + +test_that("each standard's default version is its newest, compared numerically", { + src <- cdiscdata::ig_sources + for (std in unique(src$standard)) { + v <- src$version[src$standard == std] + newest <- v[order(package_version(v))][length(v)] + expect_equal(unique(get_ig(std)$version), newest, label = paste("default version of", std)) } + expect_equal(unique(get_ig("SDTMIG", version = "3.1.3")$version), "3.1.3") + expect_equal(unique(get_ig("SENDIG")$version), "3.1.1") }) -test_that("PP rows added from the SDTMIG v3.3 table have the published label, type, codelist, role and core", { - pp <- get_ig("sdtm", version = "3.3", domain = "PP") - row <- function(v) pp[pp$variable == v, ] - expect_equal(row("TAETORD")$label, "Planned Order of Element within Arm") - expect_equal(row("TAETORD")$type, "Num") - expect_equal(row("TAETORD")$role, "Timing") - expect_equal(row("TAETORD")$core, "Perm") - expect_equal(row("EPOCH")$label, "Epoch") - expect_equal(row("EPOCH")$type, "Char") - expect_equal(row("EPOCH")$codelist, "EPOCH") - expect_equal(row("PPDY")$label, "Study Day of Parameter Calculations") - expect_equal(row("PPDY")$type, "Num") - expect_equal(row("PPDTC")$label, "Date/Time of Parameter Calculations") -}) - -test_that("PP never has PPPDTC, PPPDY or PTAETORD; PPANMETH and PPTPTREF appear only at 3.4", { - pp <- get_ig("sdtm", domain = "PP") - expect_equal(intersect(c("PPPDTC", "PPPDY", "PTAETORD"), pp$variable), character(0L)) - by_version <- split(pp$variable, pp$version) - expect_equal(intersect(c("PPANMETH", "PPTPTREF"), by_version[["3.2"]]), character(0L)) - expect_equal(intersect(c("PPANMETH", "PPTPTREF"), by_version[["3.3"]]), character(0L)) - expect_equal(intersect(c("PPANMETH", "PPTPTREF"), by_version[["3.4"]]), - c("PPANMETH", "PPTPTREF")) +test_that("get_ig reaches every one of the 15 standards, and only that standard's rows", { + src <- cdiscdata::ig_sources + for (i in seq_len(nrow(src))) { + x <- get_ig(src$standard[i], version = src$version[i]) + expect_equal(nrow(x), src$rows[i], label = paste(src$standard[i], src$version[i])) + expect_true(all(x$standard == src$standard[i] & x$version == src$version[i])) + } }) -test_that("get_ig(domain = 'PP') returns the 26 PP variables of SDTMIG 3.4 in published order", { - pp <- get_ig("sdtm", version = "3.4", domain = "PP") - expect_equal(pp$variable, +test_that("get_ig aborts (classed) on an unknown standard, version, or a malformed standard", { + e <- expect_error(get_ig("FOO"), class = "cdiscdata_error_ig_standard_unavailable") + expect_equal( + conditionMessage(e), + paste0("Standard 'FOO' is not available. Available standards: ", + "SDTM, SDTMIG, SDTMIG-AP, SDTMIG-MD, SENDIG, SENDIG-AR, SENDIG-DART, ", + "SENDIG-GeneTox, ADaMIG, ADaMIG-MD, ADaMIG-NCA, ADaM-ADAE, ADaM-BDS-TTE, ", + "ADaM-OCCDS, ADaM-popPK.") + ) + expect_error(get_ig(c("SDTMIG", "SENDIG")), class = "cdiscdata_error_ig_standard_unavailable") + expect_error(get_ig(NA_character_), class = "cdiscdata_error_ig_standard_unavailable") + expect_error(get_ig(3L), class = "cdiscdata_error_ig_standard_unavailable") + + ev <- expect_error(get_ig("SDTMIG", version = "9.9"), + class = "cdiscdata_error_ig_version_unavailable") + expect_equal(conditionMessage(ev), + "Version '9.9' is not available for SDTMIG. Available versions: 3.1.2, 3.1.3, 3.2, 3.3, 3.4.") + expect_error(get_ig("ADaMIG-NCA", version = "2.0"), + class = "cdiscdata_error_ig_version_unavailable") +}) + +test_that("SDTMIG PP grows 19, 19, 21, 24, 26 variables across 3.1.2 to 3.4 as the Library publishes it", { + n <- vapply(c("3.1.2", "3.1.3", "3.2", "3.3", "3.4"), + function(v) nrow(get_ig("SDTMIG", v, "PP")), integer(1L)) + expect_equal(unname(n), c(19L, 19L, 21L, 24L, 26L)) + + v32 <- get_ig("SDTMIG", "3.2", "PP")$variable + v33 <- get_ig("SDTMIG", "3.3", "PP")$variable + v34 <- get_ig("SDTMIG", "3.4", "PP")$variable + expect_equal(setdiff(v33, v32), c("TAETORD", "EPOCH", "PPDY")) + expect_equal(setdiff(v34, v33), c("PPANMETH", "PPTPTREF")) + expect_equal(v34, c("STUDYID", "DOMAIN", "USUBJID", "PPSEQ", "PPGRPID", "PPTESTCD", "PPTEST", "PPCAT", "PPSCAT", "PPORRES", "PPORRESU", "PPSTRESC", "PPSTRESN", "PPSTRESU", "PPSTAT", "PPREASND", "PPSPEC", "PPANMETH", "TAETORD", "EPOCH", "PPDTC", "PPDY", "PPTPTREF", "PPRFTDTC", "PPSTINT", "PPENINT")) - expect_equal(pp$order, 1:26) - expect_true(all(pp$class == "Findings")) + for (v in c("3.1.2", "3.1.3", "3.2", "3.3", "3.4")) { + pp <- get_ig("SDTMIG", v, "PP")$variable + expect_equal(intersect(c("PPPDTC", "PPPDY", "PTAETORD"), pp), character(0L)) + } +}) + +test_that("the SDTMIG 3.4 PP rows carry the published label, type, role, core, and codelist", { + pp <- get_ig("SDTMIG", "3.4", "PP") row <- function(v) pp[pp$variable == v, ] expect_equal(row("PPANMETH")$label, "Analysis Method") - expect_equal(row("PPANMETH")$codelist, "PKANMET") + expect_equal(row("PPANMETH")$codelist_code, "C172330") expect_equal(row("PPANMETH")$core, "Perm") expect_equal(row("PPTPTREF")$label, "Time Point Reference") - expect_equal(row("PPTPTREF")$type, "Char") - expect_equal(row("PPTESTCD")$codelist, "PKPARMCD") - expect_equal(row("PPTESTCD")$length, 8L) + expect_equal(row("PPTESTCD")$codelist_code, "C85839") + expect_equal(row("PPTESTCD")$role, "Topic") + expect_equal(row("PPTESTCD")$core, "Req") + expect_equal(row("PPORRESU")$codelist_code, "C85494; C128684; C128683; C128685; C128686") expect_equal(row("PPSTRESC")$label, "Character Result/Finding in Std Format") + expect_equal(pp$order, 1:26) + expect_true(all(pp$class == "Findings")) }) -test_that("SDTMIG 3.4 carries every one of its 63 domains, and never the CDISC Notes text", { - s34 <- get_ig("sdtm", version = "3.4") - expect_equal(nrow(s34), 1917L) - expect_equal(length(unique(s34$domain)), 63L) - expect_true(all(c("AE", "LB", "VS", "PC", "PP", "DM", "TS", "SUPPQUAL", "RELREC") %in% s34$domain)) - expect_true(all(s34$source == "SDTMIG" & s34$version == "3.4")) - # the licensed export's Notes column is read only to recover a stated - # maximum length (an integer) and is never stored - expect_true(all(is.na(s34$notes))) - # order is the published position within each domain, 1..n - expect_true(all(tapply(s34$order, s34$domain, function(o) identical(o, seq_along(o))))) - # no domain repeats a variable - expect_false(anyDuplicated(paste(s34$domain, s34$variable)) > 0L) - # SUPP-- is unchanged since 3.2 - supp <- get_ig("sdtm", version = "3.4", domain = "SUPPQUAL") - expect_equal(supp$variable, - c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", - "QLABEL", "QVAL", "QORIG", "QEVAL")) -}) - -test_that("SDTMIG 3.2 and 3.3 PP and SUPPQUAL tables are identical apart from the version", { - for (d in c("PP", "SUPPQUAL")) { - a <- get_ig("sdtm", version = "3.2", domain = d) - b <- get_ig("sdtm", version = "3.3", domain = d) - rownames(a) <- rownames(b) <- NULL - a$version <- b$version <- NULL - expect_identical(a, b, label = paste(d, "3.2 vs 3.3")) +test_that("SUPP-- is the same ten variables in every SDTMIG version", { + for (v in c("3.1.2", "3.1.3", "3.2", "3.3", "3.4")) { + expect_equal(get_ig("SDTMIG", v, "SUPPQUAL")$variable, + c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", + "QLABEL", "QVAL", "QORIG", "QEVAL"), + label = paste("SUPPQUAL at", v)) } }) -test_that("SUPPQUAL at 3.3 has the 10 published SUPP-- variables in order", { - supp <- get_ig("sdtm", version = "3.3", domain = "SUPPQUAL") - expect_equal(supp$variable, - c("STUDYID", "RDOMAIN", "USUBJID", "IDVAR", "IDVARVAL", "QNAM", - "QLABEL", "QVAL", "QORIG", "QEVAL")) -}) - -test_that("get_ig(domain =) filters ADaM by dataset and works without a version", { - bds <- get_ig("adam", domain = "BDS") - expect_equal(unique(bds$dataset), "BDS") - expect_equal(sort(unique(bds$version)), c("1.0", "1.1", "1.2")) - adsl <- get_ig("adam", version = "1.2", domain = "ADSL") - expect_equal(unique(adsl$dataset), "ADSL") - expect_equal(unique(adsl$version), "1.2") +test_that("SENDIG defines PP too, at 23, 25, and 25 variables", { + expect_equal(c(nrow(get_ig("SENDIG", "3.0", "PP")), nrow(get_ig("SENDIG", "3.1", "PP")), + nrow(get_ig("SENDIG", "3.1.1", "PP"))), c(23L, 25L, 25L)) + expect_true(all(get_ig("SENDIG", domain = "PP")$standard == "SENDIG")) }) -test_that("get_ig aborts (classed) on an unknown domain, listing what is available", { - e <- expect_error(get_ig("sdtm", domain = "ZZ"), +test_that("get_ig(domain =) filters, and an unknown domain is a classed error listing what exists", { + e <- expect_error(get_ig("SDTMIG", domain = "ZZ"), class = "cdiscdata_error_ig_domain_unavailable") - avail <- sort(unique(get_ig("sdtm")$domain)) + avail <- sort(unique(get_ig("SDTMIG")$domain)) expect_equal(length(avail), 63L) expect_equal(conditionMessage(e), - paste0("Domain 'ZZ' is not available for standard 'sdtm'. Available: ", + paste0("Domain 'ZZ' is not available for standard 'SDTMIG' at version '3.4'. Available: ", paste(avail, collapse = ", "), ".")) - e_34 <- expect_error(get_ig("sdtm", version = "3.2", domain = "AE"), - class = "cdiscdata_error_ig_domain_unavailable") - expect_equal(conditionMessage(e_34), - "Domain 'AE' is not available for standard 'sdtm' at version '3.2'. Available: PP, SUPPQUAL.") - e_v <- expect_error(get_ig("adam", version = "1.0", domain = "ZZ"), - class = "cdiscdata_error_ig_domain_unavailable") - expect_equal(conditionMessage(e_v), - "Domain 'ZZ' is not available for standard 'adam' at version '1.0'. Available: ADSL, BDS.") -}) - -test_that("get_ig reports 'none' when the version has no domain-bearing rows", { - # SDTM Model rows have no domain, so a model version has no domains to list. - e <- expect_error(get_ig("sdtm", version = "1.7", domain = "PP"), + e2 <- expect_error(get_ig("SDTMIG", "3.2", domain = c("PP", "AE", "ZZ", "YY")), + class = "cdiscdata_error_ig_domain_unavailable") + expect_match(conditionMessage(e2), "Domain 'ZZ', 'YY' is not available", fixed = TRUE) + both <- get_ig("SDTMIG", "3.4", domain = c("PP", "PC")) + expect_setequal(unique(both$domain), c("PP", "PC")) +}) + +test_that("ADaM structures are reachable by name and by the BDS and ADSL aliases", { + expect_equal(nrow(get_ig("ADaMIG", "1.3", "BDS")), 195L) + expect_equal(nrow(get_ig("ADaMIG", "1.3", "ADSL")), 141L) + expect_identical(get_ig("ADaMIG", "1.3", "BDS"), + get_ig("ADaMIG", "1.3", "Basic Data Structure")) + expect_identical(get_ig("ADaMIG", "1.3", "ADSL"), + get_ig("ADaMIG", "1.3", "Subject-Level Analysis Dataset")) + expect_equal(nrow(get_ig("ADaMIG", "1.3", c("BDS", "ADSL"))), 336L) + expect_equal(nrow(get_ig("ADaMIG-NCA")), 59L) + expect_equal(unique(get_ig("ADaMIG-NCA")$structure), + "Basic Data Structure Non-Compartmental Analysis") + e <- expect_error(get_ig("ADaMIG", "1.0", "OCCDS"), class = "cdiscdata_error_ig_domain_unavailable") expect_equal(conditionMessage(e), - "Domain 'PP' is not available for standard 'sdtm' at version '1.7'. Available: none.") + paste0("Domain 'OCCDS' is not available for standard 'ADaMIG' at version '1.0'. ", + "Available: Basic Data Structure, Subject-Level Analysis Dataset.")) +}) + +test_that("ADaM-OCCDS keeps both DECDORGw definitions, one per dictionary variable set", { + occ <- get_ig("ADaM-OCCDS", "1.1") + d <- occ[occ$variable == "DECDORGw", ] + expect_equal(nrow(d), 4L) + expect_equal(sort(unique(d$label)), + c("PT in Original Dictionary w", "Standardized Med Name in Orig Dict w")) +}) + +test_that("the SDTM model is reachable by class or dataset, with the 2.0 and later fields only from 2.0", { + expect_equal(nrow(get_ig("SDTM", "1.2", "Findings")), 37L) + expect_equal(nrow(get_ig("SDTM", "2.1", "DM")), 38L) + expect_true(all(is.na(get_ig("SDTM", "1.7")$variable_code))) + expect_true(any(!is.na(get_ig("SDTM", "2.1")$variable_code))) + expect_true(all(is.na(get_ig("SDTM", "1.7")$usage_restrictions))) + expect_true(any(!is.na(get_ig("SDTM", "2.1")$usage_restrictions))) + e <- expect_error(get_ig("SDTM", domain = "ZZ"), class = "cdiscdata_error_ig_domain_unavailable") + expect_match(conditionMessage(e), + "Domain 'ZZ' is not available for standard 'SDTM' at version '2.1'. Available: AC, ", + fixed = TRUE) }) diff --git a/tests/testthat/test-ig_integrity.R b/tests/testthat/test-ig_integrity.R new file mode 100644 index 0000000..1515da7 --- /dev/null +++ b/tests/testthat/test-ig_integrity.R @@ -0,0 +1,188 @@ +# Mechanical gates on the IG and model tables (ig_sdtm, model_sdtm, ig_adam), +# built from the CDISC Library exports by data-raw/build_ig.R. They exist so +# the transcription defects nca.reporter hit when writing XPT v5 files +# (40-character labels, newlines, padded names) cannot recur unnoticed, and so +# a new export cannot be loaded wrongly. + +ig_gate_tables <- function() { + list( + ig_sdtm = get_dataset("ig_sdtm"), + model_sdtm = get_dataset("model_sdtm"), + ig_adam = get_dataset("ig_adam") + ) +} + +# What identifies a row in each table. dataset is NA for the SDTM model's +# observation-class variables, so its class is part of the key; ADaM-OCCDS +# defines DECDORGw once per dictionary-specific variable set, so the set is +# part of the ADaM key. +ig_keys <- list( + ig_sdtm = c("standard", "version", "domain", "variable"), + model_sdtm = c("standard", "version", "class", "dataset", "variable"), + ig_adam = c("standard", "version", "structure", "variable_set", "variable") +) + +ig_row_key <- function(tbl, cols) { + do.call(paste, c(lapply(tbl[cols], as.character), sep = "\r")) +} + +test_that("each IG/model table has exactly the documented metadata columns, nothing from the guides' prose", { + tbls <- ig_gate_tables() + expect_equal(names(tbls$ig_sdtm), + c("standard", "version", "class", "domain", "order", "variable", + "label", "type", "role", "core", "codelist_code", + "codelist_submission_values", "described_value_domain", "value_list")) + expect_equal(names(tbls$model_sdtm), + c("standard", "version", "class", "dataset", "order", "variable", + "label", "type", "role", "described_value_domain", + "variables_qualified", "usage_restrictions", "variable_code")) + expect_equal(names(tbls$ig_adam), + c("standard", "version", "structure", "variable_set", "order", + "variable", "label", "type", "core", "codelist_code", + "codelist_submission_values", "described_value_domain", "value_list")) + # The prose columns of the exports (CDISC Notes, Description, Definition, + # Notes, Examples) run to paragraphs; the longest value in anything carried + # is 85 characters, so a long value means prose has leaked in. + for (nm in names(tbls)) { + longest <- vapply(Filter(is.character, tbls[[nm]]), + function(v) max(nchar(v), na.rm = TRUE), integer(1L)) + expect_lte(max(longest), 100L, label = paste("longest text value in", nm)) + } +}) + +test_that("ig_sources lists the 34 exports, each parsed to one distinct standard version", { + src <- cdiscdata::ig_sources + expect_equal(nrow(src), 34L) + expect_setequal(src$version_string, ig_version_strings) + expect_false(anyDuplicated(src$file) > 0L) + expect_false(anyDuplicated(paste(src$standard, src$version)) > 0L) + # the stored parse is the parser's parse + parsed <- cdiscdata:::.parse_ig_version(src$version_string) + expect_equal(src$standard, parsed$standard) + expect_equal(src$version, parsed$version) + expect_true(all(nchar(src$md5) == 32L)) + expect_equal(sort(unique(src$table)), c("ig_adam", "ig_sdtm", "model_sdtm")) +}) + +test_that("every export is loaded exactly once, with as many rows as its file has", { + src <- cdiscdata::ig_sources + tbls <- ig_gate_tables() + for (nm in names(tbls)) { + s <- src[src$table == nm, ] + got <- table(paste(tbls[[nm]]$standard, tbls[[nm]]$version)) + expect_setequal(names(got), paste(s$standard, s$version)) + expect_equal(as.integer(got[paste(s$standard, s$version)]), s$rows, + label = paste("rows loaded into", nm)) + } + expect_equal(c(nrow(tbls$ig_sdtm), nrow(tbls$model_sdtm), nrow(tbls$ig_adam)), + c(10064L, 3604L, 1804L)) + expect_equal(sum(src$rows), 10064L + 3604L + 1804L) +}) + +test_that("each table's standards are the ones the parser table assigns to it", { + for (nm in names(ig_gate_tables())) { + expected <- cdiscdata:::.ig_standards$standard[cdiscdata:::.ig_standards$table == nm] + expect_setequal(unique(ig_gate_tables()[[nm]]$standard), expected) + } +}) + +test_that("every row is unique on its key", { + tbls <- ig_gate_tables() + for (nm in names(tbls)) { + key <- ig_row_key(tbls[[nm]], ig_keys[[nm]]) + expect_equal(sum(duplicated(key)), 0L, label = paste("duplicate keys in", nm)) + } +}) + +test_that("standard, version, variable, and label are never NA, and names are clean", { + for (nm in names(ig_gate_tables())) { + tbl <- ig_gate_tables()[[nm]] + for (col in c("standard", "version", "variable", "label")) { + expect_false(anyNA(tbl[[col]]), label = paste(nm, col, "has NA")) + } + expect_equal(tbl$variable[!nzchar(tbl$variable)], character(0L)) + expect_equal(tbl$variable[grepl("[[:space:]]", tbl$variable)], character(0L), + label = paste(nm, "variable names containing whitespace")) + } + tbls <- ig_gate_tables() + expect_false(anyNA(tbls$ig_sdtm$domain)) + expect_false(anyNA(tbls$ig_sdtm$class)) + expect_false(anyNA(tbls$model_sdtm$class)) + expect_false(anyNA(tbls$ig_adam$structure)) + expect_false(anyNA(tbls$ig_adam$variable_set)) +}) + +test_that("labels have no newline and none exceeds 40 characters except the 22 the guides publish longer", { + found <- do.call(rbind, lapply(names(ig_gate_tables()), function(nm) { + tbl <- ig_gate_tables()[[nm]] + expect_false(any(grepl("[\r\n]", tbl$label)), label = paste(nm, "label with a newline")) + i <- which(nchar(tbl$label) > 40L) + where <- switch(nm, ig_sdtm = tbl$domain, model_sdtm = tbl$class, ig_adam = tbl$structure) + data.frame(table = rep(nm, length(i)), standard = tbl$standard[i], + version = tbl$version[i], where = where[i], + variable = tbl$variable[i], label = tbl$label[i], + stringsAsFactors = FALSE) + })) + ord <- function(d) d[order(d$table, d$standard, d$version, d$where, d$variable), ] + # Both directions: a new over-length label fails, and so does an exception + # that is no longer true. + expect_equal(nrow(ig_label_exceptions), 22L) + expect_equal(ord(found), ord(ig_label_exceptions), ignore_attr = TRUE) +}) + +test_that("type and core hold only the published values, bar the five rows the guides leave blank", { + tbls <- ig_gate_tables() + ex <- ig_missing_field_exceptions + for (nm in names(tbls)) { + tbl <- tbls[[nm]] + expect_true(all(tbl$type %in% c("Char", "Num", NA)), label = paste(nm, "type values")) + if ("core" %in% names(tbl)) { + expect_true(all(tbl$core %in% c("Req", "Exp", "Perm", "Cond", "Not used", "Not Used", NA)), + label = paste(nm, "core values")) + } + } + sd <- tbls$ig_sdtm + na_type <- sd[is.na(sd$type), c("standard", "version", "domain", "variable")] + na_core <- sd[is.na(sd$core), c("standard", "version", "domain", "variable")] + expect_equal(na_type, ex[ex$field == "type", c("standard", "version", "domain", "variable")], + ignore_attr = TRUE) + expect_equal(na_core, ex[ex$field == "core", c("standard", "version", "domain", "variable")], + ignore_attr = TRUE) + expect_false(anyNA(tbls$model_sdtm$type)) + expect_false(anyNA(tbls$ig_adam$type)) + expect_false(anyNA(tbls$ig_adam$core)) +}) + +test_that("no carried text field has leading, trailing, or doubled whitespace", { + for (nm in names(ig_gate_tables())) { + tbl <- ig_gate_tables()[[nm]] + for (col in names(Filter(is.character, tbl))) { + v <- tbl[[col]] + v <- v[!is.na(v)] + expect_equal(v[v != trimws(v) | grepl("[[:space:]]{2,}|[\r\n]", v)], character(0L), + label = paste(nm, col, "values with stray whitespace")) + } + } +}) + +test_that("order is a positive integer and strictly increasing within each standard version's group", { + tbls <- ig_gate_tables() + for (nm in names(tbls)) { + expect_type(tbls[[nm]]$order, "integer") + expect_true(all(tbls[[nm]]$order >= 1L)) + } + grp <- function(tbl, cols) split(tbl$order, ig_row_key(tbl, cols)) + inc <- function(g) all(vapply(g, function(o) all(diff(o) > 0L), logical(1L))) + expect_true(inc(grp(tbls$ig_sdtm, c("standard", "version", "domain")))) + expect_true(inc(grp(tbls$model_sdtm, c("standard", "version", "class", "dataset")))) + expect_true(inc(grp(tbls$ig_adam, c("standard", "version")))) +}) + +test_that("a CSV is never committed under data-raw (the exports must stay out of the repository)", { + dir <- testthat::test_path("..", "..", "data-raw") + skip_if_not(dir.exists(dir), "data-raw is not installed with the package") + csvs <- list.files(dir, pattern = "[.]csv$", recursive = TRUE, ignore.case = TRUE) + # No CSV fixtures are owned by data-raw; the CDISC Library exports live in + # CDISC_SOURCES_DIR, outside every repository. + expect_equal(csvs, character(0L)) +}) diff --git a/tests/testthat/test-ig_versions.R b/tests/testthat/test-ig_versions.R new file mode 100644 index 0000000..a7b6220 --- /dev/null +++ b/tests/testthat/test-ig_versions.R @@ -0,0 +1,63 @@ +parse_ig <- cdiscdata:::.parse_ig_version + +test_that("the parser turns each of the 34 export Version strings into one standard and version", { + got <- parse_ig(ig_version_strings) + expect_equal( + got$standard, + c(rep("SDTM", 9L), rep("SDTMIG", 5L), "SDTMIG-AP", "SDTMIG-MD", "SDTMIG-MD", + rep("SENDIG", 3L), "SENDIG-AR", "SENDIG-DART", "SENDIG-GeneTox", + rep("ADaMIG", 4L), "ADaMIG-MD", "ADaMIG-NCA", "ADaM-ADAE", "ADaM-BDS-TTE", + "ADaM-OCCDS", "ADaM-OCCDS", "ADaM-popPK") + ) + expect_equal( + got$version, + c("1.2", "1.3", "1.4", "1.5", "1.6", "1.7", "1.8", "2.0", "2.1", + "3.1.2", "3.1.3", "3.2", "3.3", "3.4", "1.0", "1.0", "1.1", + "3.0", "3.1", "3.1.1", "1.0", "1.1", "1.0", + "1.0", "1.1", "1.2", "1.3", "1.0", "1.0", "1.0", "1.0", "1.0", "1.1", "1.0") + ) + expect_equal(nrow(got), 34L) + expect_false(anyDuplicated(paste(got$standard, got$version)) > 0L) +}) + +test_that("the parser handles the spaced names the exports use, mapping them to hyphenated standards", { + expect_equal(parse_ig("ADaMIG MD v1.0"), data.frame(standard = "ADaMIG-MD", version = "1.0")) + expect_equal(parse_ig("ADaM BDS for TTE v1.0"), + data.frame(standard = "ADaM-BDS-TTE", version = "1.0")) + expect_equal(parse_ig("SDTMIG-MD v1.1"), data.frame(standard = "SDTMIG-MD", version = "1.1")) + expect_equal(parse_ig("SDTMIG v3.1.2"), data.frame(standard = "SDTMIG", version = "3.1.2")) +}) + +test_that("every raw standard name maps to a distinct canonical name, and to one table", { + std <- cdiscdata:::.ig_standards + expect_equal(nrow(std), 15L) + expect_false(anyDuplicated(std$raw) > 0L) + expect_false(anyDuplicated(std$standard) > 0L) + expect_equal(std$table[std$standard == "SDTM"], "model_sdtm") + expect_equal(sum(std$table == "ig_sdtm"), 7L) + expect_equal(sum(std$table == "ig_adam"), 7L) +}) + +test_that("an unparseable Version string is a classed error naming it, never a guess", { + e <- expect_error(parse_ig("SDTMIG 3.4"), class = "cdiscdata_error_ig_version_unparsable") + expect_match(conditionMessage(e), "Cannot parse IG version string(s): 'SDTMIG 3.4'.", fixed = TRUE) + expect_error(parse_ig("FOO v1.0"), class = "cdiscdata_error_ig_version_unparsable") + expect_error(parse_ig("SDTMIG v3."), class = "cdiscdata_error_ig_version_unparsable") + expect_error(parse_ig(NA_character_), class = "cdiscdata_error_ig_version_unparsable") + # only the bad ones are listed + e2 <- expect_error(parse_ig(c("SDTMIG v3.4", "BAD", "ADaMIG v1.3", "WORSE v2")), + class = "cdiscdata_error_ig_version_unparsable") + expect_match(conditionMessage(e2), "'BAD', 'WORSE v2'", fixed = TRUE) + expect_false(grepl("'SDTMIG v3.4'", conditionMessage(e2), fixed = TRUE)) +}) + +test_that("version resolution picks the newest numerically and lists versions in numeric order", { + resolve <- cdiscdata:::.resolve_ig_version + expect_equal(resolve(NULL, c("3.1.3", "3.2", "3.1.2"), "SDTMIG"), "3.2") + expect_equal(resolve(NULL, c("1.9", "1.10", "1.2"), "X"), "1.10") + expect_equal(resolve("3.1.2", c("3.1.3", "3.2", "3.1.2"), "SDTMIG"), "3.1.2") + e <- expect_error(resolve("9.9", c("3.2", "3.1.3", "3.1.2"), "SDTMIG"), + class = "cdiscdata_error_ig_version_unavailable") + expect_equal(conditionMessage(e), + "Version '9.9' is not available for SDTMIG. Available versions: 3.1.2, 3.1.3, 3.2.") +}) diff --git a/tests/testthat/test-list_datasets.R b/tests/testthat/test-list_datasets.R index 0f466d1..e8a3cf5 100644 --- a/tests/testthat/test-list_datasets.R +++ b/tests/testthat/test-list_datasets.R @@ -5,7 +5,7 @@ test_that("list_datasets returns a data frame", { test_that("list_datasets contains expected dataset names", { ds <- list_datasets()$dataset - expect_true(all(c("ct_sdtm", "ct_adam", "ig_sdtm", "ig_adam", + expect_true(all(c("ct_sdtm", "ct_adam", "ig_sdtm", "model_sdtm", "ig_adam", "define_xml_schema", "define_xml_stylesheet") %in% ds)) }) @@ -18,5 +18,21 @@ test_that("list_datasets has required columns", { test_that("list_datasets type values are expected set", { types <- unique(list_datasets()$type) - expect_true(all(types %in% c("CT", "IG", "Schema", "Stylesheet"))) + expect_true(all(types %in% c("CT", "IG", "Model", "Schema", "Stylesheet"))) +}) + +test_that("list_datasets describes the IG and model tables by standard, counting standard versions", { + ds <- list_datasets() + row <- function(name) ds[ds$dataset == name, ] + expect_equal(row("ig_sdtm")$type, "IG") + expect_equal(row("model_sdtm")$type, "Model") + expect_equal(row("ig_adam")$type, "IG") + expect_equal(c(row("ig_sdtm")$n_versions, row("model_sdtm")$n_versions, + row("ig_adam")$n_versions), c(14L, 9L, 11L)) + expect_equal(row("model_sdtm")$versions, "SDTM 1.2 to 2.1") + expect_match(row("ig_sdtm")$versions, "SDTMIG 3.1.2 to 3.4; SDTMIG-AP 1.0;", fixed = TRUE) + expect_match(row("ig_adam")$versions, "ADaMIG 1.0 to 1.3; ADaMIG-MD 1.0; ADaMIG-NCA 1.0;", + fixed = TRUE) + # one row per standard version, so the counts add up to the 34 exports + expect_equal(sum(ds$n_versions[ds$type %in% c("IG", "Model")]), 34L) }) From 8f0989a648b556104d11339c9b9d48e86a714371 Mon Sep 17 00:00:00 2001 From: Bill Denney Date: Wed, 30 Sep 2026 22:33:23 -0400 Subject: [PATCH 10/10] feat(cdash): add CDASH model, CDASHIG, and QRS supplement tables cdash_model (CDASH 1.0-1.3, 1,138 rows), ig_cdash (CDASHIG 1.1 and 2.0-2.3, 4,483 rows) and qrs_supplement (nine instruments, 75 items) are built from 18 more CDISC Library exports read from CDISC_SOURCES_DIR and never committed. Only metadata and the CDASH collection wording are carried; the definitions, mapping and CRF completion instructions, implementation notes, and QRS item text are not. The QRS exports have no Version column, so the instrument and version are parsed from the file name, and build_ig.R stops on any *_Supplement_v*.csv it does not list. get_cdash() mirrors get_ig() for the two CDASH tables; get_dataset() and list_datasets() reach all three. ig_sources now lists all 52 exports. Gates: key uniqueness, row counts per file, label length with an exhaustive exception list (6 in the model, 71 in CDASHIG 2.0; CDASHIG 1.1 has no labels), prose-length caps, and tests of the data-raw helpers on synthetic exports including that no prose column of any layout is carried. build_domain_spec's ADPP path is split into helpers to stay under the complexity limit. Docs: NEWS rewritten for the whole redesign (including the corrected SDTMIG 3.2 PP count), README tables, and data-raw/README.md on obtaining the exports. Co-Authored-By: Claude Sonnet 5.5 --- DESCRIPTION | 3 +- NAMESPACE | 1 + NEWS.md | 246 ++++++++++++++---------- R/build_domain_spec.R | 38 +++- R/data.R | 139 ++++++++++++- R/get_cdash.R | 42 ++++ R/get_dataset.R | 29 +-- R/get_ig.R | 50 +++-- R/ig_versions.R | 43 ++++- R/utils.R | 1 + README.md | 72 +++++-- data-raw/README.md | 66 +++++++ data-raw/build_catalogue.R | 53 +++-- data-raw/build_ig.R | 117 ++++++++--- data-raw/fetch_all.R | 14 +- data-raw/utils_ig.R | 128 +++++++++++- data/cdash_model.rda | Bin 0 -> 14196 bytes data/datasets_catalogue.rda | Bin 672 -> 828 bytes data/ig_cdash.rda | Bin 0 -> 38752 bytes data/ig_sources.rda | Bin 1460 -> 2044 bytes data/qrs_supplement.rda | Bin 0 -> 1792 bytes man/cdash_model.Rd | 53 +++++ man/datasets_catalogue.Rd | 2 +- man/get_cdash.Rd | 52 +++++ man/get_dataset.Rd | 24 +-- man/ig_cdash.Rd | 55 ++++++ man/ig_sources.Rd | 18 +- man/qrs_supplement.Rd | 47 +++++ tests/testthat/helper-ig-exceptions.R | 139 +++++++++++++ tests/testthat/test-build_domain_spec.R | 6 +- tests/testthat/test-cdash_integrity.R | 232 ++++++++++++++++++++++ tests/testthat/test-data_raw_ig.R | 166 ++++++++++++++++ tests/testthat/test-get_cdash.R | 108 +++++++++++ tests/testthat/test-get_ig.R | 4 +- tests/testthat/test-ig_integrity.R | 10 +- tests/testthat/test-ig_versions.R | 51 +++++ tests/testthat/test-list_datasets.R | 2 +- 37 files changed, 1747 insertions(+), 264 deletions(-) create mode 100644 R/get_cdash.R create mode 100644 data-raw/README.md create mode 100644 data/cdash_model.rda create mode 100644 data/ig_cdash.rda create mode 100644 data/qrs_supplement.rda create mode 100644 man/cdash_model.Rd create mode 100644 man/get_cdash.Rd create mode 100644 man/ig_cdash.Rd create mode 100644 man/qrs_supplement.Rd create mode 100644 tests/testthat/test-cdash_integrity.R create mode 100644 tests/testthat/test-data_raw_ig.R create mode 100644 tests/testthat/test-get_cdash.R diff --git a/DESCRIPTION b/DESCRIPTION index 83b40a4..4330300 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -5,7 +5,8 @@ Authors@R: person("Bill", "Denney", email = "wdenney@humanpred.com", role = c("aut", "cre"), comment = c(ORCID = "0000-0002-5759-428X")) Description: Provides versioned CDISC Controlled Terminology (SDTM, ADaM), - SDTM Model/SDTMIG and ADaMIG implementation-guide variable metadata, + variable metadata for the SDTM model, the SDTMIG, SENDIG, and ADaMIG + families of implementation guides, CDASH, and QRS supplements, and Define-XML schemas (XSD) and CDISC XSLT stylesheets. Uses a validity-date design to store all historical CT versions compactly without redundant row duplication. Intended as a shared data diff --git a/NAMESPACE b/NAMESPACE index aa2a9fa..cdb1362 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -3,6 +3,7 @@ export(available_ct_versions) export(build_domain_spec) export(cdiscdata_versions) +export(get_cdash) export(get_ct) export(get_dataset) export(get_ig) diff --git a/NEWS.md b/NEWS.md index c631a00..afda455 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,111 +1,145 @@ # cdiscdata (development version) -## IG label and identifier fixes - -* Fixed transcription defects in `ig_sdtm` and `ig_adam` found by nca.reporter - when writing XPT v5 files (labels are limited to 40 characters; SDTMIG 3.3 - section 4.2.1): - - 62 `ig_sdtm` and 271 `ig_adam` labels carried literal newlines from - hard-wrapped Word table cells; whitespace is now collapsed for every - identifying field (`variable`, `label`, `type`, `core`, `codelist`, - `role`). - - 112 `ig_sdtm` and 7 `ig_adam` variable names had trailing spaces (so - `"--TESTCD "` never equalled `"--TESTCD"`, and - `build_domain_spec("ADPP", ig_version = "1.1")` returned seven ADSL - names padded this way: `FASFL`, `SAFFL`, `ITTFL`, `PPROTFL`, `COMPLFL`, - `RANDFL`, `ENRLFL`); `type` values such as `"Char "` were padded the - same way. The default `build_domain_spec("ADPP")` variable set is - unchanged. - - Labels over 40 characters now use the abbreviated form the guide - publishes: SDTM Model 1.4-1.6 `--TESTCD` ("Short Name of Measurement, - Test or Exam", as in SDTMIG 3.3 section 6.3.10.1) and `PPSTRESC` in - SDTMIG 3.2 and 3.3 ("Character Result/Finding in Std Format", as in - SDTMIG 3.3 section 6.3.11.2). - - ADaMIG 1.2 `PBCHGCyN` is kept as the guide publishes it, "Percent Change - to Baseline Category y (N)", which is 41 characters (ADaMIG v1.2 draft, - section 3.3.4.1, Table 3.3.4.1.1; the sibling `PCHGCAyN` is published - abbreviated). It is the one documented exception in the 40-character - gate, an exact-match allow-list in `test-data_integrity.R`, so any other - over-length label still fails. Shortening a label to fit an XPT file is - for whoever writes the dataset, not for this package. - - Five section sub-headings in the ADaMIG 1.0 combined ADSL table - ("Study Identifiers", "Subject Demographics", ...) were transcribed as - variables with no label; they are dropped (`ig_adam` is 851 rows, was - 856). - - New gates in `tests/testthat/test-data_integrity.R`: no label in - `ig_sdtm`/`ig_adam` is `NA`, contains a newline, or exceeds 40 - characters (bar the exception above); no variable name is `NA`, blank, or contains whitespace; no - `type`/`core`/`codelist`/`role` value has stray whitespace. - -## Newer SDTMIG PP and SUPP-- tables, and `get_ig` by domain - -* `ig_sdtm` now carries the SDTMIG PP domain and generic SUPP-- structure at - version 3.3 as well as 3.2, and `get_ig()` gains a `domain` argument - (`get_ig("sdtm", version = "3.3", domain = "PP")`; for `"adam"` it matches - the `dataset` column, `"ADSL"` or `"BDS"`). An unknown domain is a classed - `cdiscdata_error_ig_domain_unavailable`. -* Checked against the published SDTMIG v3.3 (CDISC wiki PDF): its section - 6.3.11.2 PP specification is stamped "Version 3.2" and its revision history - lists no PP change, so the PP table is unchanged between 3.2 and 3.3; the - section 8.4.1 SUPP-- specification has the same ten variables. The 3.3 - tables are therefore the 3.2 ones. -* **Correction to the 0.2.0 notes.** They said `PPANMETH`, `EPOCH`, - `PTAETORD`, and a `PPPDTC` rename were missing because only SDTMIG 3.2 was - available. Checked against the published SDTMIG v3.3, that was wrong in - three ways: `EPOCH`, `TAETORD` (not `PTAETORD`), and `PPDY` are in the PP - table and were simply dropped from the Rsdtm 3.2 transcription (21 of 24 - rows), now added to both 3.2 and 3.3 in their published positions; - `PPDTC` (not `PPPDTC`) is the published name; and `PPANMETH` is not in the - 3.3 PP table. `PPANMETH` and `PPTPTREF` are SDTMIG 3.4 additions, now - confirmed against the 3.4 export below. nca.reporter's `PTAETORD`, - `PPPDTC`, and `PPPDY` (seeded from aNCA) are not published SDTMIG names. - -## Every domain of the newest SDTMIG - -* `ig_sdtm` now carries all 63 domains of SDTMIG 3.4 (1917 variables), so - `get_ig("sdtm", version = "3.4", domain = "PP")` works, and - `build_domain_spec("PP")`, `build_domain_spec("SUPPPP")` and - `build_domain_spec("ADPP", sdtm_domain = "PP")` default to 3.4. The 3.4 PP - table has 26 variables: the 24 of 3.2/3.3 plus `PPANMETH` (Analysis - Method, codelist `PKANMET`) and `PPTPTREF` (Time Point Reference), both - Permissible; the default PP spec therefore grows from 24 to 26 variables, - and the `sdtm_domain = "PP"` union adds 24 variables (22 with - `sdtmig_version = "3.3"`). `class` is populated for the 3.4 rows. -* Source: a CDISC Library CSV export downloaded under CDISC's own terms and - conditions, which is **not in this repository** and is never committed. - `data-raw/build_ig_sdtm.R` reads it from `CDISC_SOURCES_DIR` (default - `../cdisc-sources`) and stops with a message naming the expected file if it - is absent, so the build is reproducible by anyone who obtains the export - under their own CDISC terms. Only variable metadata is transcribed (order, - class, domain, name, label, type, role, Core, codelist); the export's CDISC - Notes text is not carried into the package data (`notes` is `NA` for the 3.4 - rows) and is read only to recover a stated maximum length as an integer. - The export lists codelists as CDISC CT C-codes only; each first code is - mapped to its submission value from the stored CT (4 of the 135 distinct - first codes are for codelists since retired from the CT, and are named from - their most recent historical header). -* All the existing gates (labels non-`NA`, newline-free and at most 40 - characters; names non-blank and whitespace-free; no stray whitespace in - `type`/`core`/`codelist`/`role`) pass on every one of the 1917 rows with - no problems found. New tests pin the 3.4 PP table, the domain count, that - `notes` is empty, and that each domain's order is 1..n. - -## ADPP: optional PP variables via `sdtm_domain` - -* `build_domain_spec("ADPP", sdtm_domain = "PP")` also unions the SDTMIG PP - domain's variables into the ADPP spec, the same way `adsl = TRUE` unions - ADSL's, because a real ADPP carries PP's variables (`PPTESTCD`, `PPTEST`, - ...). They are marked `source = "SDTMIG"` with `core = "Perm"`, a variable - BDS or ADSL already defines (`STUDYID`, `USUBJID`) keeps that version, they - are ordered after the existing rows, and their codelist ids resolve against - the SDTM CT (the ADaM CT has none of PP's codelists): `PPTESTCD` C85839, - `PPTEST` C85493, `PPORRESU`/`PPSTRESU` C85494, `PPSTAT` C66789, `PPSPEC` - C78734, `EPOCH` C99079. 22 variables are added. `sdtmig_version` picks the - SDTMIG version (default: newest). The default is `NULL`, which leaves the - output unchanged. A value other than `"PP"` is a classed - `cdiscdata_error_sdtm_domain_unavailable`; passing `sdtm_domain` or - `sdtmig_version` where it has no effect is a classed - `cdiscdata_warning_sdtm_domain_ignored`. +## Every CDISC Library implementation-guide export, replacing the Rsdtm tables + +* `ig_sdtm`, `ig_adam`, and the new `model_sdtm` are rebuilt from 34 CDISC + Library CSV exports and carry every standard and version in them, replacing + every row transcribed from the Rsdtm package: + + | Table | Standards | Standard versions | Rows | + |-------|-----------|------------------:|-----:| + | `model_sdtm` | SDTM model | 9 | 3,604 | + | `ig_sdtm` | SDTMIG, SDTMIG-AP, SDTMIG-MD, SENDIG, SENDIG-AR, SENDIG-DART, SENDIG-GeneTox | 14 | 10,064 | + | `ig_adam` | ADaMIG, ADaMIG-MD, ADaMIG-NCA, ADaM-ADAE, ADaM-BDS-TTE, ADaM-OCCDS, ADaM-popPK | 11 | 1,804 | + + Only variable metadata is carried. The guides' prose (CDISC Notes, + Description, Definition, Notes, Examples) is not in the package data. +* **Breaking: new columns.** `ig_sdtm` is now `standard`, `version`, `class`, + `domain`, `order`, `variable`, `label`, `type`, `role`, `core`, + `codelist_code`, `codelist_submission_values`, `described_value_domain`, + `value_list`. `ig_adam` is `standard`, `version`, `structure`, + `variable_set`, `order`, `variable`, `label`, `type`, `core`, + `codelist_code`, `codelist_submission_values`, `described_value_domain`, + `value_list`. `model_sdtm` is `standard`, `version`, `class`, `dataset`, + `order`, `variable`, `label`, `type`, `role`, `described_value_domain`, + `variables_qualified`, `usage_restrictions`, `variable_code`. The old + `source` (now `standard`), `dataset` and `category` (ADaM; now `structure` + and `variable_set`), `codelist` (now `codelist_code`, a C-code rather than a + submission value), `length`, and `notes` columns are gone. The SDTM model + moved out of `ig_sdtm` into `model_sdtm`. +* `ig_sources` lists the exports each table was built from: file name, the + export's version string, the parsed standard and version, the dataset it was + loaded into, its row count, and its MD5 checksum. + +## CDASH and QRS supplement metadata + +* New `cdash_model` (CDASH model 1.0 to 1.3, 1,138 rows), `ig_cdash` (CDASHIG + 1.1 and 2.0 to 2.3, 4,483 rows), and `qrs_supplement` (75 items of nine + questionnaire, rating-scale, and functional-test supplements, 9 instrument + versions), from 18 more CDISC Library exports. The CDASH tables carry the + collection wording (`question_text`, `prompt`) and the SDTM target of each + field, but not the definitions, CRF completion instructions, mapping + instructions, or implementation notes. `qrs_supplement` carries the + `--TEST`/`--TESTCD` names and codes of each item but not the item text. The + QRS exports have no version column, so the instrument and version are read + from the file name. +* New `get_cdash(standard, version, domain)` for the CDASH tables, with the + same conventions as `get_ig()`. It is a separate function because the CDASH + tables describe data collection, not a dataset's structure, and so have + different columns. The QRS supplements are reached with + `get_dataset("qrs_supplement")`. + +## Retrieval functions + +* **Breaking: `get_ig(standard, version, domain)`.** `standard` now names one + of 15 standards (`"SDTM"`, `"SDTMIG"`, `"SDTMIG-AP"`, `"SDTMIG-MD"`, + `"SENDIG"`, `"SENDIG-AR"`, `"SENDIG-DART"`, `"SENDIG-GeneTox"`, `"ADaMIG"`, + `"ADaMIG-MD"`, `"ADaMIG-NCA"`, `"ADaM-ADAE"`, `"ADaM-BDS-TTE"`, + `"ADaM-OCCDS"`, `"ADaM-popPK"`). The default is `"SDTMIG"`, and a `NULL` + `version` now returns that standard's newest version (compared numerically) + where it used to return every version. The lower-case `"sdtm"` and `"adam"` + are kept as aliases for `"SDTMIG"` and `"ADaMIG"`; capital `"SDTM"` is the + model. `domain` filters by domain (SDTMIG), class or dataset (SDTM model), + or structure (ADaM, where `"BDS"` and `"ADSL"` are accepted). An unknown + standard, version, or domain is a classed error + (`cdiscdata_error_ig_standard_unavailable`, + `cdiscdata_error_ig_version_unavailable`, + `cdiscdata_error_ig_domain_unavailable`) listing what is available. +* **Fixed: `get_dataset("ig_sdtm")` and `get_dataset("ig_adam")`.** They + silently returned `NULL`. They now return the table, whole or restricted to + the rows of one version string, and `get_dataset("model_sdtm")`, + `get_dataset("cdash_model")`, `get_dataset("ig_cdash")` and + `get_dataset("qrs_supplement")` work the same way. `list_datasets()` reports + the new tables with types `"Model"`, `"CDASH"`, and `"QRS"`, and counts + versions per standard. + +## Variable specs + +* `build_domain_spec()` takes a `standard` (any SDTM-side standard that + defines the domain, e.g. `"SENDIG"` for PP) and an `extension` for ADPP: + `"ADaMIG-NCA"` (or `"NCA"`), `"ADaM-popPK"`, or `"ADaM-BDS-TTE"` is unioned + onto the BDS variables, as `adsl = TRUE` unions ADSL, with `extension_version` + to pick its version. Unlike the ADSL and PP unions, the extension keeps its + own Core designations: a variable the BDS already defines takes the + extension's Core (`DOSEA`, `DOSEU`, and `AVISIT` become required in + ADaMIG-NCA) and is marked with the extension's name in `source`. Existing + calls keep working. +* The default specs now follow the newest guides: PP is the 26 variables of + SDTMIG 3.4, and ADPP is the 195 ADaMIG 1.3 BDS variables plus the 137 ADSL + variables not already there (332 in all). `build_domain_spec("ADPP", + extension = "NCA")` has 388 variables. `sdtm_domain = "PP"` adds 24 variables + (22 with `sdtmig_version = "3.3"`). +* The `length` column is kept but is always `NA`: the exports carry no + length, which is a sponsor choice. `codelist_id` takes the first C-code of an + IG codelist list, kept only when that codelist is in the CT release used. + +## Data gates + +* New tests in `test-ig_integrity.R` and `test-cdash_integrity.R`: every + export is loaded exactly once and with as many rows as its file has; every + row is unique on its key; no name or label is `NA` or contains a newline; + no text field has stray whitespace; no value is long enough to be prose; + `type` and `core` hold only published values; and no CSV is tracked under + `data-raw`. The version-string parser is tested on all 43 version strings + and on the nine QRS file names. +* Labels are limited to 40 characters (the XPT v5 limit, SDTMIG section 4.2.1) + except for the labels the guides themselves publish longer, kept as + published and listed in full in `helper-ig-exceptions.R`: 22 in the SDTM and + ADaM tables (SDTMIG 3.2 and SDTMIG-MD 1.0 long forms that later versions + abbreviate, the SDTM model `--TESTCD` before 1.7, and ADaMIG `PBCHGCyN`), 6 + in the CDASH model, and 71 in CDASHIG 2.0. Both directions are checked, so a + new over-length label fails and so does an exception that is no longer + true. CDASHIG 1.1 publishes no variable labels at all (`NA`). Five SDTMIG and + SDTMIG-MD rows have no `type` or `core` in the guide and are listed the same way. + Shortening a label to fit an XPT file is for whoever writes the dataset, not + for this package. +* `data-raw/utils_ig.R` is tested on synthetic exports written to a + temporary directory, including that no prose column of any export layout + reaches the data. + +## Corrections to earlier notes + +* The SDTMIG PP domain has 19 variables in 3.1.2 and 3.1.3, 21 in 3.2, 24 in + 3.3, and 26 in 3.4, as the CDISC Library publishes them. Earlier development + notes said 3.2 and 3.3 were the same 24-variable table; that was inferred + from a version stamp in the published PDF and was wrong. `EPOCH`, + `TAETORD` and `PPDY` first appear in 3.3, and `PPANMETH` and `PPTPTREF` in + 3.4. `PPDTC`, not `PPPDTC`, is the published name, and nca.reporter's + `PTAETORD`, `PPPDTC` and `PPPDY` are not published SDTMIG variables. +* SDTMIG 3.2 `PPSTRESC` is published as "Character Result/Finding in + Standard Format" (43 characters; 3.3 abbreviates it). It is now carried as + published and is one of the exceptions above, where an earlier development + version had abbreviated it. + +## Sources + +* The exports are downloaded under CDISC's own terms and conditions. They are + not in this repository, are never committed, and are read from + `CDISC_SOURCES_DIR` (default `../cdisc-sources`) by `data-raw/build_ig.R`, + which stops with a message listing every expected file if any is missing + and refuses a QRS supplement it does not list. `data-raw/README.md` says how + to obtain them. The Rsdtm copies in `data-raw/ig_source/` and the scripts + that read them are removed. # cdiscdata 0.2.0 diff --git a/R/build_domain_spec.R b/R/build_domain_spec.R index 30af1ae..35f5878 100644 --- a/R/build_domain_spec.R +++ b/R/build_domain_spec.R @@ -91,7 +91,7 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), domain <- match.arg(domain) if (domain == "ADPP") { return(.spec_adpp( - standard %||% "ADaMIG", ig_version, ct_version, adsl, sdtm_domain, + .if_null(standard, "ADaMIG"), ig_version, ct_version, adsl, sdtm_domain, sdtmig_version, extension, extension_version )) } @@ -115,7 +115,7 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), ) } rows <- .sdtmig_domain_rows(if (domain == "PP") "PP" else "SUPPQUAL", - standard %||% "SDTMIG", ig_version) + .if_null(standard, "SDTMIG"), ig_version) ct <- get_ct("sdtm", version = ct_version) .spec_frame(rows, .codelist_ids(rows$codelist_code, list(ct))) } @@ -216,8 +216,9 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), list(name = extension, rows = get_ig(extension, version = extension_version)) } -.spec_adpp <- function(standard, ig_version, ct_version, adsl, sdtm_domain, - sdtmig_version, extension, extension_version) { +# Reject or warn about ADPP-only options, before any data is read. +.check_adpp_options <- function(sdtm_domain, sdtmig_version, extension, + extension_version) { if (!is.null(sdtm_domain) && !identical(sdtm_domain, "PP")) { .cdiscdata_abort( paste0( @@ -235,9 +236,10 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), .cdiscdata_warn("`extension_version` is ignored when `extension` is NULL.", "extension_ignored") } - ext <- if (is.null(extension)) NULL else .extension_rows(extension, extension_version) +} - adam <- get_ig(standard, version = ig_version) +# The BDS variables of an ADaM guide, as the first block of an ADPP spec. +.adpp_bds_rows <- function(adam, standard) { bds <- adam[adam$structure == .adam_structure_aliases[["BDS"]], ] if (nrow(bds) == 0L) { .cdiscdata_abort( @@ -246,11 +248,15 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), "no_ig_variables" ) } - ct_adam <- get_ct("adam", version = ct_version) - bds$source <- "BDS" bds$order <- seq_len(nrow(bds)) - sub <- bds[, .spec_columns] + bds[, .spec_columns] +} + +# BDS, then the optional unions in a fixed order: ADSL, the BDS extension, and +# the SDTMIG PP variables. +.adpp_union <- function(bds, adam, adsl, ext, sdtm_domain, sdtmig_version) { + sub <- bds if (isTRUE(adsl)) { adsl_tbl <- adam[adam$structure == .adam_structure_aliases[["ADSL"]], ] sub <- .append_unique(sub, adsl_tbl, "ADSL") @@ -262,6 +268,18 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), sub <- .append_unique(sub, .sdtmig_domain_rows(sdtm_domain, "SDTMIG", sdtmig_version), "SDTMIG") } + sub +} + +.spec_adpp <- function(standard, ig_version, ct_version, adsl, sdtm_domain, + sdtmig_version, extension, extension_version) { + .check_adpp_options(sdtm_domain, sdtmig_version, extension, extension_version) + ext <- if (is.null(extension)) NULL else .extension_rows(extension, extension_version) + + adam <- get_ig(standard, version = ig_version) + bds <- .adpp_bds_rows(adam, standard) + ct_adam <- get_ct("adam", version = ct_version) + sub <- .adpp_union(bds, adam, adsl, ext, sdtm_domain, sdtmig_version) cts <- list(ct_adam) if (isTRUE(adsl) || !is.null(sdtm_domain) || !is.null(ext)) { @@ -274,4 +292,4 @@ build_domain_spec <- function(domain = c("PP", "SUPPPP", "ADPP"), } # NULL-coalescing, for optional arguments with a computed default. -`%||%` <- function(x, y) if (is.null(x)) y else x +.if_null <- function(x, y) if (is.null(x)) y else x diff --git a/R/data.R b/R/data.R index c59652e..02145ac 100644 --- a/R/data.R +++ b/R/data.R @@ -164,21 +164,146 @@ #' redistributed; see \code{data-raw/README.md}. "ig_adam" -#' The CDISC Library exports the IG and model datasets were built from +#' CDASH model variable metadata +#' +#' One row per variable of the CDISC Clinical Data Acquisition Standards +#' Harmonization (CDASH) model, at every version: 1.0, 1.1, 1.2, and 1.3. +#' Built from CDISC Library CSV exports not redistributed with this package +#' (see \code{\link{ig_sources}}); only variable metadata and the collection +#' wording (question text, prompt) is carried, not the model's definitions, +#' mapping instructions, or implementation notes. Retrieve it with +#' \code{\link{get_cdash}("CDASH")}. +#' +#' A (standard, version, class, domain, variable) is unique. The model defines +#' most variables once per class with a \code{--} prefix (\code{domain} is +#' \code{NA}) and some per domain. +#' +#' @format A data frame with columns: +#' \describe{ +#' \item{standard}{Always \code{"CDASH"}.} +#' \item{version}{Model version, e.g. \code{"1.3"}.} +#' \item{class}{Observation or special-purpose class, e.g. +#' \code{"Findings"}, \code{"Identifiers"}.} +#' \item{domain}{The domain a domain-specific variable belongs to (e.g. +#' \code{"AE"}), or \code{NA} for class-level variables.} +#' \item{order}{Position within the class and domain, as published.} +#' \item{variable}{CDASH variable name, e.g. \code{"--TERM"}.} +#' \item{label}{Variable label. At most 40 characters except for 6 labels +#' the model publishes longer (\code{--TESTCD} in 1.0 and 1.1; +#' \code{--ENDATF} in all four versions).} +#' \item{domain_specific}{\code{TRUE} where the model flags the variable as +#' domain specific; \code{NA} where it does not say.} +#' \item{question_text}{The CRF question text the model suggests.} +#' \item{prompt}{The CRF field prompt the model suggests.} +#' \item{type}{\code{"Char"} or \code{"Num"}.} +#' \item{sdtm_target}{The SDTM variable or variables the collected value +#' maps to.} +#' \item{codelist_code}{The CDISC CT codelist C-code the variable uses; +#' \code{NA} when none.} +#' } +#' @source CDISC Library CSV exports, downloaded under CDISC's terms and not +#' redistributed; see \code{data-raw/README.md}. +"cdash_model" + +#' CDASH implementation-guide variable metadata +#' +#' One row per variable of every domain and data collection scenario of the +#' CDASH implementation guide (CDASHIG), at every version: 1.1, 2.0, 2.1, 2.2, +#' and 2.3. Built from CDISC Library CSV exports not redistributed with this +#' package (see \code{\link{ig_sources}}); only variable metadata and the +#' collection wording (question text, prompt) is carried, not the guide's +#' definitions, CRF completion instructions, mapping instructions, or +#' implementation notes. Retrieve it with \code{\link{get_cdash}}. +#' +#' A (standard, version, domain, scenario, variable) is unique. +#' +#' @format A data frame with columns: +#' \describe{ +#' \item{standard}{Always \code{"CDASHIG"}.} +#' \item{version}{Guide version, e.g. \code{"2.3"}.} +#' \item{class}{General observation class, e.g. \code{"Findings"}.} +#' \item{domain}{Domain, e.g. \code{"LB"}.} +#' \item{scenario}{The data collection scenario or implementation option +#' the row belongs to (e.g. \code{"Local Processing"}), or \code{NA} for +#' variables common to the domain.} +#' \item{order}{Position within the domain and scenario, as published.} +#' \item{variable}{CDASHIG variable name, e.g. \code{"LBORRES"}.} +#' \item{label}{Variable label. Not published in version 1.1 (\code{NA} +#' for all of its rows); at most 40 characters except for 71 labels in +#' version 2.0, which the guide publishes longer.} +#' \item{question_text}{The CRF question text the guide suggests.} +#' \item{prompt}{The CRF field prompt the guide suggests.} +#' \item{type}{As published: \code{"Char"}, \code{"Num"}, +#' \code{"Date (dd-MON-yyyy)"}, or \code{"Time (24 hour)"}.} +#' \item{core}{CDASHIG Core designation, as published: \code{"HR"} (highly +#' recommended), \code{"R/C"} (recommended or conditional), or \code{"O"} +#' (optional).} +#' \item{sdtmig_target}{The SDTMIG variable the collected value maps to.} +#' \item{codelist_code}{The CDISC CT codelist C-code(s) or subset code(s) +#' the variable uses; \code{NA} when none.} +#' \item{codelist_submission_value}{The codelist submission value, where the +#' export gives one.} +#' } +#' @source CDISC Library CSV exports, downloaded under CDISC's terms and not +#' redistributed; see \code{data-raw/README.md}. +"ig_cdash" + +#' CDISC QRS supplement item metadata +#' +#' One row per item of each of nine questionnaire, rating-scale, and +#' functional-test (QRS) instrument supplements: AIMS (2.0), APACHE_II (1.0), +#' ATLAS (1.0), CGI (2.1), HAM-A (2.1), KFSS (2.0), KPS_SCALE (2.0), PGI (1.1), +#' and SIX_MINUTE_WALK (1.0). Built from CDISC Library CSV exports not +#' redistributed with this package (see \code{\link{ig_sources}}); only the +#' identifiers that map an item to SDTM controlled terminology are carried, +#' not the item text. Reach it with \code{get_dataset("qrs_supplement")}. +#' +#' The exports have no \code{Version} column; \code{instrument} and +#' \code{version} are taken from the file name (\code{HAM-A_Supplement_v2.1.csv}). +#' A (instrument, version, item_order) is unique. +#' +#' @format A data frame with columns: +#' \describe{ +#' \item{instrument}{The instrument, as in the file name, e.g. +#' \code{"HAM-A"}, \code{"SIX_MINUTE_WALK"}.} +#' \item{version}{The supplement's version, e.g. \code{"2.1"}.} +#' \item{item_order}{Position of the item within the instrument.} +#' \item{test_name}{The item's \code{--TEST} value, e.g. +#' \code{"AIMS01-Muscles of Facial Expression"}; at most 40 characters.} +#' \item{testcd_codelist_code}{C-code of the \code{--TESTCD} codelist for +#' the instrument.} +#' \item{testcd_code}{The item's \code{--TESTCD} term C-code.} +#' \item{test_codelist_code}{C-code of the \code{--TEST} codelist for the +#' instrument.} +#' \item{test_code}{The item's \code{--TEST} term C-code.} +#' \item{response_group}{The response (value list) group the item uses, or +#' \code{NA} for the few items that have none.} +#' } +#' @source CDISC Library CSV exports, downloaded under CDISC's terms and not +#' redistributed; see \code{data-raw/README.md}. +"qrs_supplement" + +#' The CDISC Library exports the datasets were built from #' #' One row per export file read by \code{data-raw/build_ig.R}, so which #' standard versions are bundled, and from exactly which files, is itself #' data. The files are not part of this package or repository. #' -#' @format A data frame with 34 rows and columns: +#' @format A data frame with 52 rows (34 implementation-guide and model +#' exports, 9 CDASH, 9 QRS supplements) and columns: #' \describe{ #' \item{file}{The export's file name.} #' \item{version_string}{The export's \code{Version} value, e.g. -#' \code{"ADaMIG MD v1.0"}.} -#' \item{standard}{The canonical standard name parsed from it.} -#' \item{version}{The version number parsed from it.} +#' \code{"ADaMIG MD v1.0"}; \code{NA} for the QRS supplements, whose +#' exports have none.} +#' \item{standard}{The canonical standard name parsed from the version +#' string (for a QRS supplement, the instrument parsed from the file +#' name).} +#' \item{version}{The version number parsed from the version string (for a +#' QRS supplement, from the file name).} #' \item{table}{The dataset it was loaded into: \code{"ig_sdtm"}, -#' \code{"model_sdtm"}, or \code{"ig_adam"}.} +#' \code{"model_sdtm"}, \code{"ig_adam"}, \code{"cdash_model"}, +#' \code{"ig_cdash"}, or \code{"qrs_supplement"}.} #' \item{rows}{Data rows in the file, equal to the rows loaded from it.} #' \item{md5}{MD5 checksum of the file, to tell whether a rebuild used the #' same export.} @@ -195,7 +320,7 @@ #' \describe{ #' \item{dataset}{R object name or logical dataset identifier.} #' \item{type}{One of \code{"CT"}, \code{"IG"}, \code{"Model"}, -#' \code{"Schema"}, \code{"Stylesheet"}.} +#' \code{"CDASH"}, \code{"QRS"}, \code{"Schema"}, \code{"Stylesheet"}.} #' \item{ct_type}{One of \code{"sdtm"}, \code{"adam"}, or \code{NA} for #' non-CT datasets.} #' \item{description}{Human-readable description.} diff --git a/R/get_cdash.R b/R/get_cdash.R new file mode 100644 index 0000000..ad25b3e --- /dev/null +++ b/R/get_cdash.R @@ -0,0 +1,42 @@ +#' Retrieve CDASH model or implementation-guide variable metadata +#' +#' Accessor over the two CDASH (collection-side) tables, +#' \code{\link{cdash_model}} and \code{\link{ig_cdash}}, with the same +#' conventions as \code{\link{get_ig}}: the standard is chosen with +#' \code{standard} and the version defaults to its newest. CDASH is kept apart +#' from \code{get_ig()} because its tables describe case report form +#' collection (question text, prompts, the SDTM variable each field maps to), +#' not a dataset's structure, and so have different columns. +#' +#' The standards: \code{"CDASH"} (the CDASH model, versions 1.0 to 1.3, in +#' \code{\link{cdash_model}}) and \code{"CDASHIG"} (the CDASH implementation +#' guide, 1.1 and 2.0 to 2.3, in \code{\link{ig_cdash}}). +#' +#' Like the other implementation-guide data these come from CDISC Library CSV +#' exports that are not part of this package or repository (see +#' \code{\link{ig_sources}}); the guides' definitions, CRF completion +#' instructions, mapping instructions, and implementation notes are not carried. +#' The collection wording the guides publish (\code{question_text}, +#' \code{prompt}) is. +#' +#' @param standard \code{"CDASHIG"} (default) or \code{"CDASH"}. +#' @param version A version string of that standard (e.g. \code{"2.3"}). +#' \code{NULL} (the default) uses the newest, compared numerically. +#' @param domain Restrict to one domain (e.g. \code{"LB"}); for +#' \code{"CDASH"} a \code{class} (e.g. \code{"Findings"}) is accepted too. +#' \code{NULL} (the default) applies no filter. +#' @return A data frame: the rows of \code{\link{cdash_model}} or +#' \code{\link{ig_cdash}} for that standard, version, and domain. An unknown +#' standard, version, or domain is a classed error +#' (\code{cdiscdata_error_ig_standard_unavailable}, +#' \code{cdiscdata_error_ig_version_unavailable}, +#' \code{cdiscdata_error_ig_domain_unavailable}). +#' @export +#' @examples +#' get_cdash() # newest CDASHIG (2.3) +#' get_cdash("CDASHIG", version = "2.1", domain = "LB") +#' get_cdash("CDASH", domain = "Findings") +get_cdash <- function(standard = "CDASHIG", version = NULL, domain = NULL) { + standard <- .resolve_ig_standard(standard, .cdash_standards$standard, character(0L)) + .library_rows(standard, version, domain, .cdash_standards) +} diff --git a/R/get_dataset.R b/R/get_dataset.R index 4c6061b..7dcd590 100644 --- a/R/get_dataset.R +++ b/R/get_dataset.R @@ -1,21 +1,23 @@ #' Retrieve any cdiscdata dataset by name and version #' -#' Generic retrieval gateway. For CT datasets, filters to rows valid at -#' the requested version date. For the implementation-guide and model datasets -#' (\code{ig_sdtm}, \code{model_sdtm}, \code{ig_adam}), returns the whole -#' table, or the rows whose \code{version} column equals \code{version} (across -#' every standard in it; use \code{\link{get_ig}} to pick one standard). For -#' schemas and stylesheets, returns the file path for the requested Define-XML -#' version. Use \code{\link{list_datasets}} to see available dataset names. +#' Generic retrieval gateway. For CT datasets, filters to rows valid at the +#' requested version date. For the implementation-guide, model, CDASH, and QRS +#' datasets (\code{ig_sdtm}, \code{model_sdtm}, \code{ig_adam}, +#' \code{cdash_model}, \code{ig_cdash}, \code{qrs_supplement}), returns the +#' whole table, or the rows whose \code{version} column equals \code{version} +#' (across every standard or instrument in it; use \code{\link{get_ig}} or +#' \code{\link{get_cdash}} to pick one standard). For schemas and stylesheets, +#' returns the file path for the requested Define-XML version. Use +#' \code{\link{list_datasets}} to see available dataset names. #' #' @param name Dataset name from \code{\link{list_datasets}()$dataset}. #' @param version Version string. For CT, \code{NULL} returns the latest #' available version and a value is a date string e.g. \code{"2024-09-27"}. #' For schemas/stylesheets, \code{NULL} is the latest and a value is a -#' Define-XML version string e.g. \code{"2.1"}. For the IG and model datasets, -#' \code{NULL} returns every version. -#' @return A data frame (for CT, IG, and model data) or a file path string -#' (for schemas/stylesheets). +#' Define-XML version string e.g. \code{"2.1"}. For the IG, model, CDASH, +#' and QRS datasets, \code{NULL} returns every version. +#' @return A data frame (for CT, IG, model, CDASH, and QRS data) or a file +#' path string (for schemas/stylesheets). #' @export #' @examples #' get_dataset("ct_sdtm") @@ -39,12 +41,15 @@ get_dataset <- function(name, version = NULL) { "CT" = .get_ct_dataset(name, version), "IG" = .get_ig_dataset(name, version), "Model" = .get_ig_dataset(name, version), + "CDASH" = .get_ig_dataset(name, version), + "QRS" = .get_ig_dataset(name, version), "Schema" = schema_path(.resolve_schema_version(version)), "Stylesheet" = stylesheet_path(.resolve_schema_version(version)) ) } -# Internal: an IG or model table, whole or restricted to one version string +# Internal: an IG, model, CDASH, or QRS table, whole or restricted to one +# version string .get_ig_dataset <- function(name, version) { tbl <- .pkg_data(name) if (is.null(version)) { diff --git a/R/get_ig.R b/R/get_ig.R index 5b5d452..2c3769a 100644 --- a/R/get_ig.R +++ b/R/get_ig.R @@ -55,7 +55,13 @@ #' get_ig("SDTM", version = "2.1", domain = "Findings") get_ig <- function(standard = "SDTMIG", version = NULL, domain = NULL) { standard <- .resolve_ig_standard(standard) - table <- .ig_standards$table[match(standard, .ig_standards$standard)] + .library_rows(standard, version, domain, .ig_standards) +} + +# The rows of one standard at one version (NULL = newest), optionally +# restricted to a domain, from whichever dataset `standards` says holds it. +.library_rows <- function(standard, version, domain, standards) { + table <- standards$table[match(standard, standards$standard)] tbl <- .pkg_data(table) tbl <- tbl[tbl$standard == standard, ] @@ -68,18 +74,21 @@ get_ig <- function(standard = "SDTMIG", version = NULL, domain = NULL) { .filter_ig_domain(tbl, table, domain, standard, version) } -# "sdtm"/"adam" are the pre-redesign first-argument values; any other value -# must be one of the canonical standard names. -.resolve_ig_standard <- function(standard) { +# "sdtm"/"adam" are the pre-redesign first-argument values (get_ig only); any +# other value must be one of the canonical standard names in `known`. +.resolve_ig_standard <- function(standard, known = .ig_standards$standard, + aliases = c(sdtm = "SDTMIG", adam = "ADaMIG")) { if (!is.character(standard) || length(standard) != 1L || is.na(standard)) { .cdiscdata_abort("`standard` must be a single string.", "ig_standard_unavailable") } - standard <- switch(standard, sdtm = "SDTMIG", adam = "ADaMIG", standard) - if (!standard %in% .ig_standards$standard) { + if (standard %in% names(aliases)) { + standard <- aliases[[standard]] + } + if (!standard %in% known) { .cdiscdata_abort( paste0( "Standard '", standard, "' is not available. Available standards: ", - paste(.ig_standards$standard, collapse = ", "), "." + paste(known, collapse = ", "), "." ), "ig_standard_unavailable" ) @@ -93,19 +102,24 @@ get_ig <- function(standard = "SDTMIG", version = NULL, domain = NULL) { ADSL = "Subject-Level Analysis Dataset" ) +# Columns a `domain` value is matched against, by dataset: a class or a +# dataset/domain for the models, a domain for the guides, a structure for ADaM. +.domain_columns <- list( + model_sdtm = c("class", "dataset"), + cdash_model = c("class", "domain"), + ig_sdtm = "domain", + ig_cdash = "domain", + ig_adam = "structure" +) + .filter_ig_domain <- function(tbl, table, domain, standard, version) { - if (table == "model_sdtm") { - avail <- sort(unique(c(tbl$class, tbl$dataset))) - keep <- tbl$class %in% domain | tbl$dataset %in% domain - } else { - column <- if (table == "ig_adam") "structure" else "domain" - if (table == "ig_adam") { - domain <- ifelse(domain %in% names(.adam_structure_aliases), - .adam_structure_aliases[domain], domain) - } - avail <- sort(unique(tbl[[column]])) - keep <- tbl[[column]] %in% domain + if (table == "ig_adam") { + domain <- ifelse(domain %in% names(.adam_structure_aliases), + .adam_structure_aliases[domain], domain) } + columns <- .domain_columns[[table]] + avail <- sort(unique(unlist(tbl[columns], use.names = FALSE))) + keep <- Reduce(`|`, lapply(tbl[columns], `%in%`, domain)) if (!all(domain %in% avail)) { .cdiscdata_abort( paste0( diff --git a/R/ig_versions.R b/R/ig_versions.R index 8046cf4..9d1eaad 100644 --- a/R/ig_versions.R +++ b/R/ig_versions.R @@ -27,6 +27,20 @@ stringsAsFactors = FALSE ) +# The CDASH standards, which the CDISC Library exports in the same layout but +# which are collection-side, not SDTM or ADaM guides, so get_ig() does not +# reach them (get_cdash() does). +.cdash_standards <- data.frame( + raw = c("CDASH Model", "CDASHIG"), + standard = c("CDASH", "CDASHIG"), + table = c("cdash_model", "ig_cdash"), + stringsAsFactors = FALSE +) + +# Every standard whose export carries a "Version" column; the parser's +# vocabulary. +.library_standards <- rbind(.ig_standards, .cdash_standards) + # Split "Version" strings such as "SDTMIG-MD v1.1" or "ADaM BDS for TTE v1.0" # into the canonical standard and the version number. Vectorised; an # unrecognised string is an error, never a guess. @@ -34,7 +48,7 @@ parts <- regmatches(x, regexec("^(.+) v([0-9]+([.][0-9]+)*)$", x)) raw <- vapply(parts, function(p) if (length(p)) p[[2L]] else NA_character_, "") version <- vapply(parts, function(p) if (length(p)) p[[3L]] else NA_character_, "") - standard <- .ig_standards$standard[match(raw, .ig_standards$raw)] + standard <- .library_standards$standard[match(raw, .library_standards$raw)] bad <- is.na(x) | is.na(standard) if (any(bad)) { @@ -43,7 +57,7 @@ "Cannot parse IG version string(s): ", paste0("'", x[bad], "'", collapse = ", "), ". Expected ' v' with a standard in: ", - paste(.ig_standards$raw, collapse = ", "), "." + paste(.library_standards$raw, collapse = ", "), "." ), "ig_version_unparsable" ) @@ -72,3 +86,28 @@ } version } + +# The QRS supplement exports carry no "Version" column: the instrument and its +# version are in the file name ("HAM-A_Supplement_v2.1.csv" is instrument +# "HAM-A", version "2.1"; "SIX_MINUTE_WALK_Supplement_v1.0.csv" keeps its +# underscores). Vectorised; a name that does not fit is an error. +.parse_qrs_filename <- function(x) { + file <- basename(x) + parts <- regmatches(file, regexec("^(.+)_Supplement_v([0-9]+([.][0-9]+)*)[.]csv$", file)) + ok <- lengths(parts) > 0L + if (!all(ok)) { + .cdiscdata_abort( + paste0( + "Cannot parse QRS supplement file name(s): ", + paste0("'", file[!ok], "'", collapse = ", "), + ". Expected '_Supplement_v.csv'." + ), + "qrs_filename_unparsable" + ) + } + data.frame( + instrument = vapply(parts, `[[`, "", 2L), + version = vapply(parts, `[[`, "", 3L), + stringsAsFactors = FALSE + ) +} diff --git a/R/utils.R b/R/utils.R index 3ecea34..a3ef2e8 100644 --- a/R/utils.R +++ b/R/utils.R @@ -3,6 +3,7 @@ # Suppress R CMD check notes about lazy-loaded package data objects # that are not visible to the static checker. utils::globalVariables(c("ct_sdtm", "ct_adam", "ig_sdtm", "model_sdtm", "ig_adam", + "cdash_model", "ig_cdash", "qrs_supplement", "ig_sources", "datasets_catalogue")) # Retrieve one of the package's own lazy-loaded datasets (ct_sdtm, ct_adam, diff --git a/README.md b/README.md index ff8a626..780f823 100644 --- a/README.md +++ b/README.md @@ -12,22 +12,23 @@ with zero runtime dependencies. It bundles: the [NCI EVS FTP site](https://evs.nci.nih.gov/ftp1/CDISC/), stored compactly using a validity-date design (one row per term-state, not one copy per release). Current as of the 2026-09-25 NCI release. -- **Implementation-guide (IG) variable metadata**: SDTM Model and SDTMIG - variable tables (the Findings general-observation-class variables; the PP - domain and generic SUPP-- structure used for SUPPPP at SDTMIG 3.2 and 3.3; - every domain of SDTMIG 3.4) and ADaMIG ADSL and BDS variable tables (BDS - covers ADPP, a BDS-structured dataset). See `get_ig()` and - `build_domain_spec()`. +- **Implementation-guide, model, CDASH, and QRS variable metadata**: the + variables of 34 SDTM-, SEND-, and ADaM-side guides (the SDTM model; SDTMIG + 3.1.2 to 3.4, -AP, -MD; SENDIG 3.0 to 3.1.1, -AR, -DART, -GeneTox; ADaMIG 1.0 + to 1.3, -MD, -NCA, ADaM-ADAE, -BDS-TTE, -OCCDS, -popPK), the CDASH model and + CDASHIG, and the items of nine QRS instrument supplements, at every version. + See `get_ig()`, `get_cdash()`, and `build_domain_spec()`. - **Define-XML XSD schemas**: for validating `define.xml` files (versions 2.0 and 2.1). - **XSLT stylesheets**: for rendering `define.xml` as HTML (versions 2.0 and 2.1). CT, Define-XML schemas, and XSLT stylesheets are sourced exclusively from publicly available, license-free sources, with no CDISC Library API key -needed. IG variable metadata is sourced from CDISC's own published SDTM -Model/SDTMIG/ADaMIG specification tables (also without an API key) - see -[Data sources](#data-sources) below, which supersedes this package's -original plan to leave all IG metadata to a separate `cdiscapi` package. +needed. The IG, model, CDASH, and QRS metadata is transcribed from CDISC +Library CSV exports that were downloaded under CDISC's own terms and +conditions. **Those exports are not in this repository and are not +redistributed**; only variable metadata is carried, not the guides' prose. See +[Data sources](#data-sources) and `data-raw/README.md`. ## Installation @@ -78,19 +79,44 @@ current). `get_ct()` reconstructs the state of any release on the fly. ### Implementation-guide variable metadata ``` r -# All SDTM Model + SDTMIG variable metadata (every source and version) -ig_sdtm <- get_ig("sdtm") +# The newest SDTMIG (3.4), every domain +get_ig() -# Just the SDTMIG PP domain -pp_ig <- get_ig("sdtm", version = "3.3", domain = "PP") +# One standard, one version, one domain +get_ig("SDTMIG", version = "3.3", domain = "PP") +get_ig("SENDIG", domain = "PP") -# A ready-to-use variable spec (name, label, type, length, core, order, +# The SDTM model, and the ADaM guides and their extensions +get_ig("SDTM", version = "2.1", domain = "Findings") +get_ig("ADaMIG", domain = "BDS") +get_ig("ADaMIG-NCA") + +# The CDASH model and implementation guide +get_cdash() +get_cdash("CDASHIG", version = "2.1", domain = "LB") + +# A ready-to-use variable spec (name, label, type, core, order, source, # codelist id) for PP, SUPPPP, or ADPP, joined to CT for codelist ids build_domain_spec("PP") build_domain_spec("SUPPPP") -build_domain_spec("ADPP") +build_domain_spec("ADPP") # ADaMIG BDS + ADSL +build_domain_spec("ADPP", extension = "NCA") # ... + ADaMIG-NCA ``` +Every standard and version bundled, and the export each was built from: + +| Dataset | Standards | Standard versions | Rows | +|---------|-----------|------------------:|-----:| +| `ig_sdtm` | SDTMIG 3.1.2 to 3.4, SDTMIG-AP, SDTMIG-MD, SENDIG 3.0 to 3.1.1, SENDIG-AR, SENDIG-DART, SENDIG-GeneTox | 14 | 10,064 | +| `model_sdtm` | SDTM model 1.2 to 2.1 | 9 | 3,604 | +| `ig_adam` | ADaMIG 1.0 to 1.3, ADaMIG-MD, ADaMIG-NCA, ADaM-ADAE, ADaM-BDS-TTE, ADaM-OCCDS, ADaM-popPK | 11 | 1,804 | +| `cdash_model` | CDASH model 1.0 to 1.3 | 4 | 1,138 | +| `ig_cdash` | CDASHIG 1.1, 2.0 to 2.3 | 5 | 4,483 | +| `qrs_supplement` | AIMS, APACHE_II, ATLAS, CGI, HAM-A, KFSS, KPS_SCALE, PGI, SIX_MINUTE_WALK | 9 | 75 | + +`ig_sources` lists each export, its parsed standard and version, its row +count, and its checksum. + ### Define-XML schemas and stylesheets ``` r @@ -111,6 +137,8 @@ xml_validate(doc, schema) # get_dataset() is a single entry point for all bundled assets get_dataset("ct_sdtm") # latest SDTM CT get_dataset("ct_adam", version = "2024-03-29") # historical ADaM CT +get_dataset("ig_adam", version = "1.3") # IG, model, CDASH, QRS tables +get_dataset("qrs_supplement") get_dataset("define_xml_schema", version = "2.1") get_dataset("define_xml_stylesheet", version = "2.0") ``` @@ -124,7 +152,7 @@ packages (e.g. `cdisclib`, `defineauto`). Key design decisions: |----------|-----------| | Zero runtime dependencies | Easier deployment in locked/air-gapped environments; CRAN friendly | | Validity-date CT storage | Compact representation of all historical releases without row duplication | -| No CDISC Library API key required | CT, schemas, and stylesheets are public domain / open-source licensed; IG metadata is transcribed from CDISC's published specification documents (see Data sources) | +| No CDISC Library API key required | CT, schemas, and stylesheets are public domain / open-source licensed; the IG, model, CDASH, and QRS metadata is transcribed from CDISC Library CSV exports downloaded under CDISC's terms and not redistributed (see Data sources) | | Per-release RDS cache in `data-raw/raw/` | Fast incremental rebuilds; preserves full audit trail | ## Data sources @@ -133,8 +161,9 @@ packages (e.g. `cdisclib`, `defineauto`). Key design decisions: |------|--------|---------| | SDTM CT | [NCI EVS FTP](https://evs.nci.nih.gov/ftp1/CDISC/SDTM/) | Public domain | | ADaM CT | [NCI EVS FTP](https://evs.nci.nih.gov/ftp1/CDISC/ADaM/) | Public domain | -| SDTM Model / SDTMIG 3.2-3.3 / ADaMIG variable metadata | CDISC's published specification documents, transcribed via [Bill Denney's Rsdtm package](https://github.com/humanpred/Rsdtm) (private); see `data-raw/ig_source/README.md` for full provenance/attribution | CDISC published standards | -| SDTMIG 3.4 variable metadata | A CDISC Library CSV export, downloaded under CDISC's terms and **not redistributed**; only variable metadata is transcribed (not the CDISC Notes text); see `data-raw/ig_source/README.md` | CDISC terms and conditions | +| SDTM model, SDTMIG, SENDIG, ADaMIG, and related guides: variable metadata | 34 CDISC Library CSV exports, downloaded under CDISC's terms and **not redistributed**; only variable metadata is transcribed (not the CDISC Notes, Description, Definition, Notes, or Examples text); see `data-raw/README.md` | CDISC terms and conditions | +| CDASH model and CDASHIG variable metadata | 9 CDISC Library CSV exports, as above; the collection wording (question text, prompt) is carried, the definitions, mapping and CRF completion instructions, and implementation notes are not | CDISC terms and conditions | +| QRS supplement item metadata | 9 CDISC Library CSV exports, as above; the `--TEST` and `--TESTCD` names and codes are carried, the item text is not | CDISC terms and conditions | | Define-XML 2.1 schema | [cdisc-org/DataExchange-RWD-Lineage](https://github.com/cdisc-org/DataExchange-RWD-Lineage) | Apache 2.0 | | Define-XML 2.0 schema | [dbosak01/defineR](https://github.com/dbosak01/defineR) | MIT | | XSLT stylesheets | [cdisc-org/data-definition-engine](https://github.com/cdisc-org/data-definition-engine) / [dbosak01/defineR](https://github.com/dbosak01/defineR) | Apache 2.0 / MIT | @@ -142,8 +171,9 @@ packages (e.g. `cdisclib`, `defineauto`). Key design decisions: ## Related packages - **`cdiscapi`** *(forthcoming)*: CDISC Library API access (requires API key) - for metadata not available from public sources - e.g. newer SDTMIG/ADaMIG - versions than `get_ig()` currently covers. + for metadata not available from public sources or from the exports + bundled here - e.g. guides and versions newer than those `get_ig()` and + `get_cdash()` cover. - **`cdisclib`**: Core utilities built on top of `cdiscdata`. - **`defineauto`**: Automated Define-XML generation. diff --git a/data-raw/README.md b/data-raw/README.md new file mode 100644 index 0000000..54d3af8 --- /dev/null +++ b/data-raw/README.md @@ -0,0 +1,66 @@ +# data-raw + +Scripts that build the data in `data/`. Nothing here is part of the installed +package (`data-raw` is in `.Rbuildignore`). + +| Script | Builds | Reads | +|--------|--------|-------| +| `fetch_all.R` (with `fetch_ct_*.R`, `fetch_schemas.R`, `fetch_stylesheets.R`) | `ct_sdtm`, `ct_adam`, the Define-XML schemas and stylesheets, and the catalogue | The NCI EVS FTP site (public) | +| `build_ig.R` | `ig_sdtm`, `model_sdtm`, `ig_adam`, `cdash_model`, `ig_cdash`, `qrs_supplement`, `ig_sources` | The 52 CDISC Library CSV exports described below | +| `build_catalogue.R` | `datasets_catalogue` | `data/*.rda` (run it after either of the first two; `fetch_all.R` runs it itself) | + +## The CDISC Library exports + +The implementation-guide, model, CDASH, and QRS tables are built from CSV +exports of the CDISC Library. **They are not in this repository, are never +committed, and must not be redistributed.** CDISC provides them under its own +terms and conditions (use within the downloader's organization; no copying, +distribution, posting, or derivative works of the material itself). Only the +variable metadata is transcribed into the package data: names, labels, types, +roles, Core designations, codelists, order, and for CDASH the collection +wording (question text and prompt). The guides' prose is never read. + +To obtain them, sign in to the [CDISC Library](https://library.cdisc.org/), +open **Standards**, choose the standard and version, and use the **CSV +export**. Save each file under the name below in one directory, outside any +git repository, and point the build at it: + +``` sh +CDISC_SOURCES_DIR=/path/to/cdisc-sources Rscript data-raw/build_ig.R +Rscript data-raw/build_catalogue.R +``` + +`CDISC_SOURCES_DIR` defaults to `../cdisc-sources`, next to the checkout. +`build_ig.R` stops, listing every file that is missing, if any of the 52 is +not there; and stops on any `*_Supplement_v*.csv` it does not list, so a new +QRS supplement is added on purpose. + +| Files | Count | +|-------|------:| +| `SDTM_v1.2.csv` to `SDTM_v1.8.csv`, `SDTM_v2.0.csv`, `SDTM_v2.1.csv` | 9 | +| `SDTMIG_v3.1.2.csv`, `SDTMIG_v3.1.3.csv`, `SDTMIG_v3.2.csv`, `SDTMIG_v3.3.csv`, `SDTMIG_v3.4.csv` | 5 | +| `SDTMIG-AP_v1.0.csv`, `SDTMIG-MD_v1.0.csv`, `SDTMIG-MD_v1.1.csv` | 3 | +| `SENDIG_v3.0.csv`, `SENDIG_v3.1.csv`, `SENDIG_v3.1.1.csv`, `SENDIG-AR_v1.0.csv`, `SENDIG-DART_v1.1.csv`, `SENDIG-GeneTox_v1.0.csv` | 6 | +| `ADaMIG_v1.0.csv` to `ADaMIG_v1.3.csv`, `ADaMIG_MD_v1.0.csv`, `ADaMIG_NCA_v1.0.csv`, `ADaM_ADAE_v1.0.csv`, `ADaM_BDS_for_TTE_v1.0.csv`, `ADaM_OCCDS_v1.0.csv`, `ADaM_OCCDS_v1.1.csv`, `ADaM_popPK_v1.0.csv` | 11 | +| `CDASH_Model_v1.0.csv` to `CDASH_Model_v1.3.csv`, `CDASHIG_v1.1.csv`, `CDASHIG_v2.0.csv` to `CDASHIG_v2.3.csv` | 9 | +| `AIMS_Supplement_v2.0.csv`, `APACHE_II_Supplement_v1.0.csv`, `ATLAS_Supplement_v1.0.csv`, `CGI_Supplement_v2.1.csv`, `HAM-A_Supplement_v2.1.csv`, `KFSS_Supplement_v2.0.csv`, `KPS_SCALE_Supplement_v2.0.csv`, `PGI_Supplement_v1.1.csv`, `SIX_MINUTE_WALK_Supplement_v1.0.csv` | 9 | + +Each export holds one standard version and has a `Version` column such as +`ADaMIG MD v1.0`, which the build parses into a standard and a version. The +QRS supplements have no such column, so their instrument and version come +from the file name. `ig_sources` records each file's name, parsed version, +row count, and MD5 checksum, so a rebuild can be checked against the files +that built the committed data. + +## What the build checks + +`build_ig.R` stops unless every file is loaded exactly once, as many rows are +kept as the file has, every identifying field is present, and every key is +unique. `tests/testthat/test-ig_integrity.R`, +`tests/testthat/test-cdash_integrity.R`, and `tests/testthat/test-ig_versions.R` +repeat those checks on the committed data, and also check that labels are at +most 40 characters except for an explicit, exhaustive list of the ones the +guides publish longer (`tests/testthat/helper-ig-exceptions.R`), and that no +CSV is tracked under `data-raw`. +`tests/testthat/test-data_raw_ig.R` runs the helpers in `utils_ig.R` on small +synthetic exports, including a check that no prose column reaches the data. diff --git a/data-raw/build_catalogue.R b/data-raw/build_catalogue.R index 938eb65..29afd7d 100644 --- a/data-raw/build_catalogue.R +++ b/data-raw/build_catalogue.R @@ -1,9 +1,19 @@ # Rebuild the datasets_catalogue object after any data update. # Called at the end of fetch_all.R (CT), and after build_ig.R (IG and model -# metadata, which fetch_all.R does not touch). -# Requires ct_sdtm, ct_adam, ig_sdtm, model_sdtm, and ig_adam to be loaded in +# CDASH, and QRS metadata, which fetch_all.R does not touch). +# Requires ct_sdtm, ct_adam, ig_sdtm, model_sdtm, ig_adam, cdash_model, ig_cdash, +# and qrs_supplement to be loaded in # the environment (e.g. via load("data/ct_sdtm.rda") or a prior build script). +# Load any data object not already in the global environment, so the script +# also runs on its own from the package root. +for (obj in c("ct_sdtm", "ct_adam", "ig_sdtm", "model_sdtm", "ig_adam", + "cdash_model", "ig_cdash", "qrs_supplement")) { + if (!exists(obj, envir = globalenv(), inherits = FALSE)) { + load(file.path("data", paste0(obj, ".rda")), envir = globalenv()) + } +} + build_version_range <- function(x) { x <- sort(unique(x)) if (length(x) == 0L) return(NA_character_) @@ -36,40 +46,51 @@ ct_entries <- data.frame( stringsAsFactors = FALSE ) -# ── IG and model entries ────────────────────────────────────────────────────── -# Each of these tables holds several standards, each with its own version -# numbering, so the version range is reported per standard ("SDTMIG 3.1.2 to -# 3.4; SDTMIG-AP 1.0; ..."), n_versions counts (standard, version) pairs, and -# `latest` is NA because there is no single latest across standards. -describe_standards <- function(tbl) { - parts <- vapply(split(tbl$version, tbl$standard), function(v) { +# ── IG, model, CDASH, and QRS entries ───────────────────────────────────────── +# Each of these tables holds several standards (or instruments), each with its +# own version numbering, so the version range is reported per standard +# ("SDTMIG 3.1.2 to 3.4; SDTMIG-AP 1.0; ..."), n_versions counts +# (standard, version) pairs, and `latest` is NA because there is no single +# latest across standards. +describe_standards <- function(tbl, by = "standard") { + parts <- vapply(split(tbl$version, tbl[[by]]), function(v) { v <- unique(v) v <- v[order(package_version(v))] if (length(v) == 1L) v else paste(v[[1L]], "to", v[[length(v)]]) }, character(1L)) - parts <- parts[unique(tbl$standard)] + parts <- parts[unique(tbl[[by]])] paste(paste(names(parts), parts), collapse = "; ") } -count_versions <- function(tbl) nrow(unique(tbl[c("standard", "version")])) +count_versions <- function(tbl, by = "standard") nrow(unique(tbl[c(by, "version")])) ig_entries <- data.frame( - dataset = c("ig_sdtm", "model_sdtm", "ig_adam"), - type = c("IG", "Model", "IG"), + dataset = c("ig_sdtm", "model_sdtm", "ig_adam", "cdash_model", "ig_cdash", + "qrs_supplement"), + type = c("IG", "Model", "IG", "CDASH", "CDASH", "QRS"), ct_type = NA_character_, description = c( "SDTMIG, SENDIG and related SDTM-side implementation-guide variable metadata", "SDTM model variable metadata", - "ADaMIG and related ADaM implementation-guide variable metadata" + "ADaMIG and related ADaM implementation-guide variable metadata", + "CDASH model variable metadata", + "CDASH implementation-guide (CDASHIG) variable metadata", + "QRS instrument supplement item metadata" ), versions = c( describe_standards(ig_sdtm), describe_standards(model_sdtm), - describe_standards(ig_adam) + describe_standards(ig_adam), + describe_standards(cdash_model), + describe_standards(ig_cdash), + describe_standards(qrs_supplement, by = "instrument") ), n_versions = c( count_versions(ig_sdtm), count_versions(model_sdtm), - count_versions(ig_adam) + count_versions(ig_adam), + count_versions(cdash_model), + count_versions(ig_cdash), + count_versions(qrs_supplement, by = "instrument") ), latest = NA_character_, last_updated = Sys.Date(), diff --git a/data-raw/build_ig.R b/data-raw/build_ig.R index ab134de..f343e77 100644 --- a/data-raw/build_ig.R +++ b/data-raw/build_ig.R @@ -1,5 +1,7 @@ -# Build ig_sdtm, model_sdtm, ig_adam, and ig_sources from the 34 CDISC Library -# CSV exports (SDTM model, SDTMIG family, SENDIG family, ADaMIG family). +# Build ig_sdtm, model_sdtm, ig_adam, cdash_model, ig_cdash, qrs_supplement, +# and ig_sources from 52 CDISC Library CSV exports: the SDTM model and the +# SDTMIG, SENDIG, and ADaMIG families (34), the CDASH model and CDASHIG (9), +# and nine QRS instrument supplements (9). # # Run from the package root: # CDISC_SOURCES_DIR=/path/to/exports Rscript data-raw/build_ig.R @@ -9,28 +11,54 @@ # This script reads them from CDISC_SOURCES_DIR (default "../cdisc-sources") # and stops with a message listing the expected files if any is missing. Only # variable metadata is transcribed (names, labels, types, roles, Core, -# codelists, order); the guide prose columns (CDISC Notes, Description, -# Definition, Notes, Examples) are never read into the data. +# codelists, order, and the CDASH collection wording); the guide prose columns +# (CDISC Notes, Description, Definition, Notes, Examples, Mapping and CRF +# Completion Instructions, Implementation Notes, QRS Item Text) are never read +# into the data. # # Sourced by nothing else; the output is data/ig_sdtm.rda, data/model_sdtm.rda, -# data/ig_adam.rda, and data/ig_sources.rda. Re-run build_catalogue.R after. +# data/ig_adam.rda, data/cdash_model.rda, data/ig_cdash.rda, +# data/qrs_supplement.rda, and data/ig_sources.rda. Re-run build_catalogue.R +# after. -# The version parser and the classed-condition helpers live in the package +# The version parsers and the classed-condition helpers live in the package # (R/ig_versions.R, R/utils.R) so tests can exercise them. pkgload::load_all(".", quiet = TRUE) source("data-raw/utils_ig.R") -paths <- cdisc_source_paths() +all_files <- c(ig_source_files, cdash_source_files, qrs_source_files) +check_qrs_exports() +paths <- cdisc_source_paths(all_files) + +# The dataset each export shape is loaded into. +shape_table <- c( + ig_sdtm = "ig_sdtm", model_v1 = "model_sdtm", model_v2 = "model_sdtm", + ig_adam = "ig_adam", cdash_model = "cdash_model", cdash_ig = "ig_cdash", + qrs = "qrs_supplement" +) read_one <- function(file) { e <- read_library_export(paths[[file]]) - parsed <- .parse_ig_version(e$version_string) + if (e$shape == "qrs") { + parsed <- .parse_qrs_filename(file) + standard <- parsed$instrument + table <- "qrs_supplement" + } else { + parsed <- .parse_ig_version(e$version_string) + standard <- parsed$standard + table <- .library_standards$table[match(standard, .library_standards$standard)] + } + # the layout of the file must be the layout its standard's dataset expects + stopifnot(identical(unname(shape_table[[e$shape]]), table)) rows <- switch( e$shape, - ig_sdtm = ig_sdtm_rows(e$data, parsed), - model_v1 = model_sdtm_rows(e$data, parsed), - model_v2 = model_sdtm_rows(e$data, parsed), - ig_adam = ig_adam_rows(e$data, parsed) + ig_sdtm = ig_sdtm_rows(e$data, parsed), + model_v1 = model_sdtm_rows(e$data, parsed), + model_v2 = model_sdtm_rows(e$data, parsed), + ig_adam = ig_adam_rows(e$data, parsed), + cdash_model = cdash_model_rows(e$data, parsed), + cdash_ig = cdash_ig_rows(e$data, parsed), + qrs = qrs_rows(e$data, parsed) ) stopifnot(nrow(rows) == nrow(e$data)) list( @@ -38,9 +66,9 @@ read_one <- function(file) { source = data.frame( file = file, version_string = e$version_string, - standard = parsed$standard, + standard = standard, version = parsed$version, - table = .ig_standards$table[match(parsed$standard, .ig_standards$standard)], + table = table, rows = nrow(e$data), md5 = unname(tools::md5sum(paths[[file]])), stringsAsFactors = FALSE @@ -48,22 +76,27 @@ read_one <- function(file) { ) } -loaded <- lapply(ig_source_files, read_one) +loaded <- lapply(all_files, read_one) ig_sources <- do.call(rbind, lapply(loaded, `[[`, "source")) rownames(ig_sources) <- NULL -# Every file is one distinct (standard, version): none loaded twice or missing. +# Every file is one distinct (standard or instrument, version): none loaded +# twice or missing. stopifnot( - length(loaded) == 34L, + length(loaded) == 52L, !anyDuplicated(paste(ig_sources$standard, ig_sources$version)), !anyDuplicated(ig_sources$file) ) -# Order standards as in the parser table and versions numerically. -std_rank <- match(ig_sources$standard, .ig_standards$standard) -ig_sources <- ig_sources[order(std_rank, package_version(ig_sources$version)), ] +# Order the standards as in the parser table (the QRS instruments last, by +# name) and versions numerically. +is_qrs <- ig_sources$table == "qrs_supplement" +std_rank <- ifelse(is_qrs, nrow(.library_standards) + 1L, + match(ig_sources$standard, .library_standards$standard)) +ig_sources <- ig_sources[order(std_rank, ig_sources$standard, + package_version(ig_sources$version)), ] rownames(ig_sources) <- NULL -loaded <- loaded[match(ig_sources$file, ig_source_files)] +loaded <- loaded[match(ig_sources$file, all_files)] bind_table <- function(table) { parts <- loaded[ig_sources$table == table] @@ -71,14 +104,17 @@ bind_table <- function(table) { rownames(out) <- NULL out } -ig_sdtm <- bind_table("ig_sdtm") -model_sdtm <- bind_table("model_sdtm") -ig_adam <- bind_table("ig_adam") +ig_sdtm <- bind_table("ig_sdtm") +model_sdtm <- bind_table("model_sdtm") +ig_adam <- bind_table("ig_adam") +cdash_model <- bind_table("cdash_model") +ig_cdash <- bind_table("ig_cdash") +qrs_supplement <- bind_table("qrs_supplement") # Rows kept per (standard, version) equal the rows in the file it came from. -check_rows <- function(tbl, which_table) { +check_rows <- function(tbl, which_table, by = "standard") { src <- ig_sources[ig_sources$table == which_table, ] - got <- table(paste(tbl$standard, tbl$version)) + got <- table(paste(tbl[[by]], tbl$version)) stopifnot(identical( as.integer(got[paste(src$standard, src$version)]), as.integer(src$rows) )) @@ -86,6 +122,9 @@ check_rows <- function(tbl, which_table) { check_rows(ig_sdtm, "ig_sdtm") check_rows(model_sdtm, "model_sdtm") check_rows(ig_adam, "ig_adam") +check_rows(cdash_model, "cdash_model") +check_rows(ig_cdash, "ig_cdash") +check_rows(qrs_supplement, "qrs_supplement", by = "instrument") # Identifying fields are never NA, and every key is unique. Keys: # - ig_sdtm: (standard, version, domain, variable) @@ -94,22 +133,42 @@ check_rows(ig_adam, "ig_adam") # - ig_adam: (standard, version, structure, variable_set, variable); OCCDS # defines DECDORGw once per dictionary-specific variable set, so the set is # part of the key +# - cdash_model: (standard, version, class, domain, variable) +# - ig_cdash: (standard, version, domain, scenario, variable); scenario is NA +# for the variables common to a domain +# - qrs_supplement: (instrument, version, item_order) +# CDASHIG 1.1 publishes no variable label, so its label is the one NA allowed. key <- function(tbl, cols) do.call(paste, c(lapply(tbl[cols], as.character), sep = "\r")) stopifnot( !anyNA(ig_sdtm[c("standard", "version", "domain", "variable", "label")]), !anyNA(model_sdtm[c("standard", "version", "class", "variable", "label")]), !anyNA(ig_adam[c("standard", "version", "structure", "variable_set", "variable", "label")]), + !anyNA(cdash_model[c("standard", "version", "class", "variable", "label", "type")]), + !anyNA(ig_cdash[c("standard", "version", "class", "domain", "variable", "type", "core")]), + !anyNA(ig_cdash$label[ig_cdash$version != "1.1"]), + all(is.na(ig_cdash$label[ig_cdash$version == "1.1"])), + !anyNA(qrs_supplement[c("instrument", "version", "item_order", "test_name", "testcd_code", + "test_code", "testcd_codelist_code", "test_codelist_code")]), !anyDuplicated(key(ig_sdtm, c("standard", "version", "domain", "variable"))), !anyDuplicated(key(model_sdtm, c("standard", "version", "class", "dataset", "variable"))), - !anyDuplicated(key(ig_adam, c("standard", "version", "structure", "variable_set", "variable"))) + !anyDuplicated(key(ig_adam, c("standard", "version", "structure", "variable_set", "variable"))), + !anyDuplicated(key(cdash_model, c("standard", "version", "class", "domain", "variable"))), + !anyDuplicated(key(ig_cdash, c("standard", "version", "domain", "scenario", "variable"))), + !anyDuplicated(key(qrs_supplement, c("instrument", "version", "item_order"))) ) -usethis::use_data(ig_sdtm, model_sdtm, ig_adam, ig_sources, +usethis::use_data(ig_sdtm, model_sdtm, ig_adam, cdash_model, ig_cdash, + qrs_supplement, ig_sources, overwrite = TRUE, compress = "xz") message(sprintf( - "ig_sdtm: %d rows (%d standard versions); model_sdtm: %d rows (%d); ig_adam: %d rows (%d); ig_sources: %d files.", + paste0("ig_sdtm: %d rows (%d standard versions); model_sdtm: %d rows (%d); ", + "ig_adam: %d rows (%d); cdash_model: %d rows (%d); ig_cdash: %d rows (%d); ", + "qrs_supplement: %d rows (%d); ig_sources: %d files."), nrow(ig_sdtm), sum(ig_sources$table == "ig_sdtm"), nrow(model_sdtm), sum(ig_sources$table == "model_sdtm"), nrow(ig_adam), sum(ig_sources$table == "ig_adam"), + nrow(cdash_model), sum(ig_sources$table == "cdash_model"), + nrow(ig_cdash), sum(ig_sources$table == "ig_cdash"), + nrow(qrs_supplement), sum(ig_sources$table == "qrs_supplement"), nrow(ig_sources) )) diff --git a/data-raw/fetch_all.R b/data-raw/fetch_all.R index 4c403b6..e6baabb 100644 --- a/data-raw/fetch_all.R +++ b/data-raw/fetch_all.R @@ -54,12 +54,14 @@ any_updated <- sdtm_updated || adam_updated || schema_updated || stylesheet_upda if (any_updated) { message("\n--- Rebuild datasets_catalogue ---") - # build_catalogue.R also reports on ig_sdtm/model_sdtm/ig_adam (built - # separately by build_ig.R from the CDISC Library exports, since they have no NCI network - # source); load the already-built copies rather than rebuilding them here. - load("data/ig_sdtm.rda") - load("data/model_sdtm.rda") - load("data/ig_adam.rda") + # build_catalogue.R also reports on the IG, model, CDASH, and QRS tables + # (built separately by build_ig.R from the CDISC Library exports, which have + # no NCI network source); load the already-built copies rather than + # rebuilding them here. + for (f in c("ig_sdtm", "model_sdtm", "ig_adam", "cdash_model", "ig_cdash", + "qrs_supplement")) { + load(file.path("data", paste0(f, ".rda"))) + } source("data-raw/build_catalogue.R") message("\n--- Change summary ---") diff --git a/data-raw/utils_ig.R b/data-raw/utils_ig.R index d330bbe..4d6150a 100644 --- a/data-raw/utils_ig.R +++ b/data-raw/utils_ig.R @@ -1,5 +1,6 @@ -# Helpers for building the IG and model datasets (ig_sdtm, model_sdtm, ig_adam, -# ig_sources) from CDISC Library CSV exports. Sourced by build_ig.R. +# Helpers for building the IG, model, CDASH, and QRS datasets (ig_sdtm, +# model_sdtm, ig_adam, cdash_model, ig_cdash, qrs_supplement, ig_sources) from +# CDISC Library CSV exports. Sourced by build_ig.R. # # The exports are downloaded under CDISC's own terms and conditions (use within # the downloader's organization only; no copying, distribution, or derivative @@ -24,7 +25,28 @@ ig_source_files <- c( "ADaM_popPK_v1.0.csv" ) -# The four column layouts the exports come in, and the dataset each feeds. +# The nine CDASH exports (four model versions, five implementation-guide +# versions), one version per file. +cdash_source_files <- c( + "CDASH_Model_v1.0.csv", "CDASH_Model_v1.1.csv", "CDASH_Model_v1.2.csv", + "CDASH_Model_v1.3.csv", + "CDASHIG_v1.1.csv", "CDASHIG_v2.0.csv", "CDASHIG_v2.1.csv", + "CDASHIG_v2.2.csv", "CDASHIG_v2.3.csv" +) + +# The nine QRS supplement exports, one instrument version per file. The build +# also looks for every "*_Supplement_v*.csv" in the sources directory and +# stops on any that is not listed here, so a new supplement is added on +# purpose, not loaded or skipped by accident. +qrs_source_files <- c( + "AIMS_Supplement_v2.0.csv", "APACHE_II_Supplement_v1.0.csv", + "ATLAS_Supplement_v1.0.csv", "CGI_Supplement_v2.1.csv", + "HAM-A_Supplement_v2.1.csv", "KFSS_Supplement_v2.0.csv", + "KPS_SCALE_Supplement_v2.0.csv", "PGI_Supplement_v1.1.csv", + "SIX_MINUTE_WALK_Supplement_v1.0.csv" +) + +# The column layouts the exports come in, and the dataset each feeds. ig_source_shapes <- list( ig_sdtm = c( "Version", "Variable Order", "Class", "Dataset Name", "Variable Name", @@ -48,6 +70,25 @@ ig_source_shapes <- list( "Variable Label", "Type", "CDISC CT Codelist Code(s)", "CDISC CT Codelist Submission Value(s)", "Described Value Domain(s)", "Value List Value", "Core", "CDISC Notes" + ), + cdash_model = c( + "Version", "Class", "Domain", "Variable Order", "CDASH Variable", + "CDASH Variable Label", "DRAFT CDASH Definition", "Domain Specific", + "Question Text", "Prompt", "Type", "SDTM Target", "Mapping Instructions", + "Controlled Terminology Codelist Code", "Implementation Notes" + ), + cdash_ig = c( + "Version", "Class", "Domain", "Data Collection Scenario/Implementation Option", + "Variable Order", "CDASHIG Variable", "CDASHIG Variable Label", + "DRAFT CDASHIG Definition", "Question Text", "Prompt", "Type", "CDASHIG Core", + "Case Report Form Completion Instructions", "SDTMIG Target", + "Mapping Instructions", "CDISC CT Codelist Code(s), Subset Codes(s)", + "Codelist Submission Value", "Implementation Notes" + ), + qrs = c( + "Item Order", "Item Test Name", "Item Text", "Codelist Code for '--TEST'", + "Code for '--TEST'", "Codelist Code for '--TESTCD'", "Code for '--TESTCD'", + "Response Group" ) ) @@ -88,7 +129,23 @@ cdisc_source_paths <- function(files = ig_source_files) { stats::setNames(paths, files) } -# Read one export and say which of the four shapes it is. +# Stops if the sources directory holds a QRS supplement this build does not +# list, or lacks one it does. +check_qrs_exports <- function() { + found <- list.files(cdisc_sources_dir(), pattern = "_Supplement_v.*[.]csv$") + unexpected <- setdiff(found, qrs_source_files) + if (length(unexpected)) { + stop("QRS supplement export(s) not listed in qrs_source_files: ", + paste(unexpected, collapse = ", "), ". Add them there, extend the ", + "expected counts in tests/testthat/test-cdash_integrity.R, and rebuild.", + call. = FALSE) + } + invisible(found) +} + +# Read one export and say which of the shapes it is. The QRS supplements have +# no Version column (their version is in the file name), so for them +# version_string is NA. read_library_export <- function(path) { x <- utils::read.csv(path, check.names = FALSE, stringsAsFactors = FALSE, na.strings = "", fileEncoding = "UTF-8") @@ -96,9 +153,12 @@ read_library_export <- function(path) { ig_source_shapes, function(cols) identical(sort(cols), sort(names(x))), logical(1L) )] if (length(shape) != 1L) { - stop(basename(path), " has columns that match none of the four known export ", + stop(basename(path), " has columns that match none of the known export ", "shapes: ", paste(names(x), collapse = " | "), call. = FALSE) } + if (shape == "qrs") { + return(list(data = x, shape = shape, version_string = NA_character_)) + } versions <- unique(x$Version) if (length(versions) != 1L) { stop(basename(path), " must carry exactly one Version value, found ", @@ -169,3 +229,61 @@ ig_adam_rows <- function(x, parsed) { stringsAsFactors = FALSE ) } + +cdash_model_rows <- function(x, parsed) { + data.frame( + standard = parsed$standard, + version = parsed$version, + class = tidy_text(x$Class), + domain = tidy_text(x$Domain), + order = as.integer(x[["Variable Order"]]), + variable = tidy_text(x[["CDASH Variable"]]), + label = tidy_text(x[["CDASH Variable Label"]]), + # the export writes "true" for a flagged variable and leaves the rest blank + domain_specific = ifelse(tidy_text(x[["Domain Specific"]]) == "true", TRUE, NA), + question_text = tidy_text(x[["Question Text"]]), + prompt = tidy_text(x$Prompt), + type = tidy_text(x$Type), + sdtm_target = tidy_text(x[["SDTM Target"]]), + codelist_code = tidy_text(x[["Controlled Terminology Codelist Code"]]), + stringsAsFactors = FALSE + ) +} + +cdash_ig_rows <- function(x, parsed) { + data.frame( + standard = parsed$standard, + version = parsed$version, + class = tidy_text(x$Class), + domain = tidy_text(x$Domain), + scenario = tidy_text(x[["Data Collection Scenario/Implementation Option"]]), + order = as.integer(x[["Variable Order"]]), + variable = tidy_text(x[["CDASHIG Variable"]]), + label = tidy_text(x[["CDASHIG Variable Label"]]), + question_text = tidy_text(x[["Question Text"]]), + prompt = tidy_text(x$Prompt), + type = tidy_text(x$Type), + core = tidy_text(x[["CDASHIG Core"]]), + sdtmig_target = tidy_text(x[["SDTMIG Target"]]), + codelist_code = tidy_text(x[["CDISC CT Codelist Code(s), Subset Codes(s)"]]), + codelist_submission_value = tidy_text(x[["Codelist Submission Value"]]), + stringsAsFactors = FALSE + ) +} + +# `parsed` is the (instrument, version) from the file name; the item text +# column is never read. +qrs_rows <- function(x, parsed) { + data.frame( + instrument = parsed$instrument, + version = parsed$version, + item_order = as.integer(x[["Item Order"]]), + test_name = tidy_text(x[["Item Test Name"]]), + testcd_codelist_code = tidy_text(x[["Codelist Code for '--TESTCD'"]]), + testcd_code = tidy_text(x[["Code for '--TESTCD'"]]), + test_codelist_code = tidy_text(x[["Codelist Code for '--TEST'"]]), + test_code = tidy_text(x[["Code for '--TEST'"]]), + response_group = tidy_text(x[["Response Group"]]), + stringsAsFactors = FALSE + ) +} diff --git a/data/cdash_model.rda b/data/cdash_model.rda new file mode 100644 index 0000000000000000000000000000000000000000..aa1c90ccce280b26a2f578f9d38bfe5f7c9b1b27 GIT binary patch literal 14196 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 K000000a;p@a$lAJ literal 0 HcmV?d00001 diff --git a/data/datasets_catalogue.rda b/data/datasets_catalogue.rda index fdac553912922a352496e0c2de95dc3d8084e0ed..2049057c3b8afb702f47331189c376712fc1ae2a 100644 GIT binary patch delta 751 zcmV?=#Whb+{jgq8(BXc%K{Lyu4z@Inq=Q< zrHxm#mZt?e$esgVp^A!ly&8P@FY#AjKpl2==!5=Pggr`oQD|6C!sRM^l7E))f=U(; z(>tYk|mUM>v0EV|Ce8h3&ema^kzjadcN{^2X19x;Cdz^AP z{P#OpnLZv^%@1D^>QdyQSBj}B_8d2w%hc~IPIpLwC|%y8SGz#34b;uJ+U2=sbwSyH+^x6RaL!-@T7TyJQ-`5y(jrVc749Nmf~ zH$Uvnchj@>u~gzb9ussb9b7I;JawMIAU{k7|4|q1!RkN6$LK5g+kefY(^L%Yh;lfQ z2Y+SmSk2m8`i1I*K1yPvKuIoyBM_R#XY9*PG z6)4p5BLC_lmrGidS8!U1u7TXY^3x*w`IT}%pveK(49<&G2K-_ij9U@B#nXmGX<=x@ zEi`H7pX(`g8TNAua({gXE<1ZN${4Hzu9_p+hPwZZKw*qUHEcyaElWEPPhy;mh&03n zu`0R$7C0W+m*Fhmqy(SPUvjUK#eEsJEgqc4e=TL0{w{Wpb9y>t-BAl;@MX!qP2brq zx3QiLVZBnAq-iB%U>{txh3X(%ET6Hz)Mo;y+@;a(rI^ixYGB?DuvX?!EiRWa>GSOZ zXXa1&3r$AzY=ny1irw7l0w?Aydb`@f`i^C#C|4%l2UpIiKaS0*Y) zGr$g*YyMGShQ^(4GZseUi zxKSHz32;1fK?l*RyQdSaq2R+Kl|}~9w_OaC(Wd^dv8UBd-SGP7g>`Bdw-GL!j@QGF zSTN}AuV5{jg3Kk`OWOUPegA8V1lF~XGMl7fQ>j-Lnc?9sC0%lOznj6|aSR_0Na}r- z@%HtMq~nZKs-yF5g+uAxEQ$(CFytkD`Zgxox^~<;Y`p#>4W$jAunOkV6m@&M1!4dI g0Q*LMegFac1gi`H0H^%$+CDH1ivj=u00045S_(uTP5=M^ diff --git a/data/ig_cdash.rda b/data/ig_cdash.rda new file mode 100644 index 0000000000000000000000000000000000000000..b4a94dd828e5f8d16579ac8b35aa050b82bafa82 GIT binary patch literal 38752 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≪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 literal 0 HcmV?d00001 diff --git a/data/ig_sources.rda b/data/ig_sources.rda index d0bd8d66b475c80fc31ef04ce4b90b69da83f9ac..4323c5222d3a9a85517ebb5848f5f948fe67b54c 100644 GIT binary patch delta 1806 zcmV+p2l4o{3;Yj|83Y^}2f&dXJp=yKkda-qe>WZg41F1T($qvbOwy2z2k|$?0P?*x zNV-{)Ca!`Tb%=Xk5LfTMDkGQ}-{hKA>(o?%?s@?w^!T+HfHa`U&Uy+^qJT(eat@&M z4grF6=J(&u5-<#O8rrP`0S+oJ4z(!XE?NKQS7rrGG?p(0q2`{5A z+P`hn%yw3ZC3D6;`Dt@?3Hf{s!=+CVr!y%Ob=W0wosShx(A;5#olMJV=a7tP-X1qG zu)59VIasjU^b+74d#rq+x`MNWLdzv&f6)zfv)^&zlWVwPsaZQrQU|NUc5U6JFpj_% zsRo=j&(0KFOy`CercE$W>_b-yi@d1>jJ<`-69pfCsH8n0=2VwxQ;)A=S0YdT8nlBV z9;#{EMKq%s5^gXtn?9uRjKwXUT$0(GrOnpn<$N4I3Q4qn?zdvf&%&;(>#}Arf7kwd z&g2_|-iCF{4Kyx^$RwWaF;6p&698{4-XOPw7+4FGH1jYd-`$i_U`y+~7!;VB@dNe~U{Cn$6JOR2TU-xI>*KJSH1P`5TqRUrbX_gPfvh z4*fJaW^-9Aa0QUvPUb2s{jH=8oPmCAp>8s#HCylyJx;ju=5!RJ5X!OB%+af$V0WI4 z(@FJG-xB*oXJhCWc?-f+N7H=*@YW*KA+Vkd*i-SsHCB z?k6Yu(Hqtlmmyd-n@diAHl*e8MD$AH?uB^koB00cLWj2@0Hd2zM5^$>L>!N%AxiBH+c>*!mPI&C&lV9TJ#{e5x7F z$Sc?}mM8(>Mk@L1@mV*4M{EDLT1&XG4@*CmB2*vCKc;TPv*$Hza1*!JjRxy`y$gyM zK9C)8#Fp>S^uF>-(Gg>TXAGtprj5`;ZzWQhRBHqw*Z}$r1zqRVe{nP>GrkXf4n{L) zKv5ns8~?>3W2xjuJCx&m+th$57X35zo-E2@FE;Rr%cO85{o-szdVy2ivU&E`m^i1< zGIx~mb_#xSfN~osW4qdiZ^_m2LLdHPM^ga0^0COEy1rTZYcte+BoMbvOxJDKOg!X% z;Lx=Q-}*q6mewUCe;VGf@v4U%{l3+->St`3ufa z+aR@o(8|s`Mr<-6c6OnKn`AG3DZL{RQ$X=3JC5^m0W4KCf5*Q>E59R5C3Y^uNQ}61 zeAK|aDWBQG8+R8{M40M1WWJ?*dzPSCLIl8|OK^E}$B13Bc&otDz*6p%$#G#6n3>0I zi*n)5WE-wBa;tQ1Z|4OU@!)=Fo8>n^uY@>x0=HC@pVE}VPjzv9Vw1(oIjL56QL|38 z{ThXWbGTm(f7-}9Qk+kB8pTG4Q8$g{rzM+)<=3oexB-!~&a`v&2DPU0jqP-=nDB%T zTg1{0TzhVwZa0xnoe3Cf`Ri~^F55drnk+_I1-hc3jG;>-fKZI$n_CX3V&e;Wp%Y8ICi?@9=j7J#=?kSa?} zYHJ%*9~uyn$+9{w+U@J$n0FL7t#s;Wof_{dFOFb7>+dsfrg{X6h}S{UMY3XF(7gq7 zH=RaFmFFp$Rv37vU93qJ3K#MR1bN&t)cg;?GQf**_^Zsc*qeUym0)clJXiZn`DhA( z_X0*0e@QD!S3JVry(TlHtgD~WmH!YRrw+J4k8J(hk3jP90x_U z@A#Ye0eozOo#wt5Gp14*7>)4HmV(|51Tju0K*Sa|2{Acivj=u00045T7%tg>;M1& delta 1218 zcmV;z1U>uw53~!A83Yos1$dDiJp=1j5RqN9e=s=t9NKGd?nSkdHf|ac@}3!JpIfO! z54Svlr{FHFZLo3CwxRN7VMizULskTwWhy4212(=+sP8cJK+=_eYDO ze-ZYpfq2*ZX&vf1-f+_7pSPS=M=vr~;)dE(VliDfEO;+agy`nY9&@zV+m}4#$+{bD zTg!sN_9Y;@#9a6pmH)QQ2*mus8oh;bl_=*Om=iI`z!oEWW+#Uigc&JF73U9%L=gT2 zSLzQzr#YadrsX!$8`pDy2SYQjirSul36hLFt~K%8j~r?63$w;1DZIot63xsuEGO)N-*JXbdU>Az}c~vdR zrbK%c0!5&a`HuQt%C6rauVl&^AxVVjs_Hrc#2G(hkHgx;fvAJ3Y=F3oe?!fW-*Aln zqJ1LqYA7*&jhGu#XeIgHp*GKF?=LQwHI}Zx8}-=X(&!B9du?^}@3^v65AchEzVe9G zgKDnm6Gr@IwdbpYYfxL;szPhJx%<2D5q@gl3K6F-Q(AtpiTThAMj$Etz&Vl;wKsc8 z1@lwx0aA(9i;=tuXdV0Ue=Ky4+xt>Nt}4x@;75A0(a3G?V%8?4W+1W^HNsolHunj< z-<5mKZK|3f1<>O7c4G89*a?DeB`~TRiQS7#$xqdnnU(Met$tCGfzA>**eyyGJyV|> zKYqo!BuYeDH8pPjo&?bulgk9#p9VOtX`oQuo^raX9P5^TfVL*Ne+OgX+GTw^^sx_% zWcH(VYNBA!=NUP%C1XG|o~~fuFjzc_yP_our=Oet%=!WK1G|bz)&Mz9(IGi!sQw|h zl*s9ZzBKt3jh(C@-apTb29!q73Vmb@6wTf!&~Habyl8eZskiwhtoHj}#j}3_w|=`} z)pkS4?5AzclfQr$e}{yHO2qFNR8<}MP%zIO1{{3bPtBl*Z^^6AQ$n@Sv@e?m#|d3p zSE*Dl`yH9!C!!yP0j8x0&u>h6OfP!4&NI{?QlgXfy-eLU`-c8wN!fk+ha|RDAhWK5 zkzqkP$V(A3$i5u0G06`AU-e+ivj=u00045TB0Xg+W-In diff --git a/data/qrs_supplement.rda b/data/qrs_supplement.rda new file mode 100644 index 0000000000000000000000000000000000000000..614a1d1acfc7f263c949fe0e1e0bf09692b38ae4 GIT binary patch literal 1792 zcmV+b2mko}H+ooF0004LBHlIv03iV!0000G&sfahE@}qDT>vQ&2UKVgRpfklK z2LrlZWZHZHK}m`G8$$Uyy$3$RvJQ!aUmq7YyOU$sxL9*jJp4OIY5J=ui;FmU4gzZA z$ISt6cvkv{5`HyuQ@q6X_iqvAeb>sO7vR4hgYRv!Z@TAHkrulapfzA>Vc+LQgI}zJ z`#$NR9I^qzANqYQ&{iP(I$||=RR$hrHE(NWPcgZYc*Trsl}AayPxIVyPk$h7o21@$JgmpD=!!*C{JdXz(R$>0o$DDAQ&Q-NxVY>bKK5WFPEx*!C4S# zOhCg0hh$-l-LJ(=0`s;L6Z2lXH#NSMi+V#^JkVLp=1D?z2u|Z(DFEsX?J^=?1Gx^O z`us@Kz-kSZ!!~Lk!DVlAlPbc6!Cf*hy3+prnN|ly%A!jI0r&xu7w^1RIcec~wS-?KwQPGiRhVa1dZ(~zgV!xM=wX9IN~^8nLah4}$rdm*fX2K?+dZI4 z+RJjiTS#+fmDuEYWMYD$YF^*%b{ivvkS-@|{RnzUOtC)Z4+8PH^hSXMv~hP@aPcIv z`og2pq{vPEi_ z#?bLAAS-%v#XZCL-~@IX=fu42#4rSo$Lwx^8 zjE^Wx-i;hJSJMe#tGlkEzo(zI0>!y+A%jCHk_HPcHomYl^2Ac|!Pf*Kg30*ZqL7J| z`bA#?Q}tCcf%qN$LZq$fqK&#PC@oNL7kk2jnh?Yb^Ve8HVDkN-;}Rb@XrBXklYwxP z@AN%iY|xtuq)A~|X_@D(!T=Aw2^LC}Zy0&~7GS5m%6nT{q$}m@x`7FUgSH>poZret zSiyCr0ikYm4w@Ph4|;i9B=hP+y_n(6G18F)@j%>+}j01uEbvghM}@0V)|%ZYogv?0GzVN*RVIY-QtSRYuwx=nM7> zRGl3=z%U{*@t->E+5!x;Q>(hIL`v%htcFU*lgj-=G`&aU$N9%-wPB;x+26iE3c}KFBGCpQEwz=3HQFTE6kjCR|SP+R=)5*5P+1(UJioJ|1f`2T>g%;Pz0{mpQ7FLPW@hB)Q)yU_?bX-_*R^Mw+e0aL~|`+UD+D3p?P8 z53Y`qn-Z3pPfMCkOb|sgXVxBgzqPXulP~ zWY$aWr5k6$t%zRcPNsU&y}ATpOWt}L%gPi=N+bMymGTSC<7&3F)8$L_buPj3BdP-*yj)!1ItNWf>uy3OFa?neQN`WBke i0002 0L) + expect_false(anyDuplicated(paste(src$table, src$standard, src$version)) > 0L) + expect_true(all(nchar(src$md5) == 32L)) + + cd <- src[src$table %in% c("cdash_model", "ig_cdash"), ] + expect_setequal(cd$version_string, cdash_version_strings) + parsed <- cdiscdata:::.parse_ig_version(cd$version_string) + expect_equal(cd$standard, parsed$standard) + expect_equal(cd$version, parsed$version) + + qrs <- src[src$table == "qrs_supplement", ] + expect_setequal(qrs$file, qrs_files) + expect_true(all(is.na(qrs$version_string))) + from_name <- cdiscdata:::.parse_qrs_filename(qrs$file) + expect_equal(qrs$standard, from_name$instrument) + expect_equal(qrs$version, from_name$version) + # the version strings of everything that has one all parse + has <- src[!is.na(src$version_string), ] + expect_equal(nrow(has), 43L) + expect_equal(cdiscdata:::.parse_ig_version(has$version_string)$standard, has$standard) +}) + +test_that("every CDASH and QRS export is loaded exactly once, with as many rows as its file has", { + src <- cdash_sources() + tbls <- cdash_gate_tables() + for (nm in names(tbls)) { + s <- src[src$table == nm, ] + col <- cdash_group_col[[nm]] + got <- table(paste(tbls[[nm]][[col]], tbls[[nm]]$version)) + expect_setequal(names(got), paste(s$standard, s$version)) + expect_equal(as.integer(got[paste(s$standard, s$version)]), s$rows, + label = paste("rows loaded into", nm)) + } + expect_equal(c(nrow(tbls$cdash_model), nrow(tbls$ig_cdash), nrow(tbls$qrs_supplement)), + c(1138L, 4483L, 75L)) + expect_equal(src$rows[src$table == "cdash_model"], c(270L, 276L, 278L, 314L)) + expect_equal(src$rows[src$table == "ig_cdash"], c(370L, 858L, 927L, 1075L, 1253L)) + expect_equal(src$rows[src$table == "qrs_supplement"], c(12L, 18L, 6L, 3L, 15L, 11L, 1L, 3L, 6L)) + expect_equal(src$standard[src$table == "qrs_supplement"], + c("AIMS", "APACHE_II", "ATLAS", "CGI", "HAM-A", "KFSS", "KPS_SCALE", "PGI", + "SIX_MINUTE_WALK")) +}) + +test_that("every CDASH and QRS row is unique on its key", { + tbls <- cdash_gate_tables() + for (nm in names(tbls)) { + key <- ig_row_key(tbls[[nm]], cdash_keys[[nm]]) + expect_equal(sum(duplicated(key)), 0L, label = paste("duplicate keys in", nm)) + } + q <- tbls$qrs_supplement + expect_false(anyDuplicated(paste(q$instrument, q$test_name)) > 0L) + expect_false(anyDuplicated(q$test_code) > 0L) +}) + +test_that("identifying fields are never NA, bar the CDASHIG 1.1 labels, which the guide leaves out", { + tbls <- cdash_gate_tables() + expect_false(anyNA(tbls$cdash_model[c("standard", "version", "class", "order", "variable", + "label", "type")])) + ig <- tbls$ig_cdash + expect_false(anyNA(ig[c("standard", "version", "class", "domain", "order", "variable", + "type", "core")])) + ex <- cdash_missing_label_exceptions + na_label <- ig[is.na(ig$label), ] + expect_equal(nrow(na_label), ex$rows) + expect_equal(unique(na_label$version), ex$version) + expect_equal(sum(ig$version == ex$version), ex$rows) + expect_false(anyNA(tbls$qrs_supplement[c("instrument", "version", "item_order", "test_name", + "testcd_codelist_code", "testcd_code", + "test_codelist_code", "test_code")])) + for (nm in names(tbls)) { + v <- tbls[[nm]]$variable + if (!is.null(v)) { + expect_equal(v[!nzchar(v) | grepl("[[:space:]]", v)], character(0L), label = nm) + } + } +}) + +test_that("labels have no newline and none exceeds 40 characters except the 77 the guides publish longer", { + tbls <- cdash_gate_tables() + found <- do.call(rbind, lapply(c("cdash_model", "ig_cdash"), function(nm) { + tbl <- tbls[[nm]] + expect_false(any(grepl("[\r\n]", tbl$label)), label = paste(nm, "label with a newline")) + i <- which(nchar(tbl$label) > 40L) + where <- if (nm == "cdash_model") tbl$class else tbl$domain + scenario <- if (nm == "ig_cdash") tbl$scenario else rep(NA_character_, nrow(tbl)) + data.frame(table = rep(nm, length(i)), standard = tbl$standard[i], + version = tbl$version[i], where = where[i], scenario = scenario[i], + variable = tbl$variable[i], nchar = nchar(tbl$label[i]), + stringsAsFactors = FALSE) + })) + ord <- function(d) { + d <- d[order(d$table, d$version, d$where, d$scenario, d$variable), ] + rownames(d) <- NULL + d + } + # Both directions: a new over-length label fails, and so does an exception + # that is no longer true (or whose label changed length). + expect_equal(nrow(cdash_label_exceptions), 77L) + expect_equal(c(table(cdash_label_exceptions$table)), c(cdash_model = 6L, ig_cdash = 71L)) + expect_equal(ord(found), ord(cdash_label_exceptions)) + expect_equal(unique(cdash_label_exceptions$version[cdash_label_exceptions$table == "ig_cdash"]), "2.0") + # the QRS test names are --TEST values: SDTM's 40 characters apply without exception + q <- tbls$qrs_supplement + expect_lte(max(nchar(q$test_name)), 40L) + expect_false(any(grepl("[\r\n]", q$test_name))) +}) + +test_that("type, core, and the flag column hold only the published values", { + tbls <- cdash_gate_tables() + expect_equal(sort(unique(tbls$cdash_model$type)), c("Char", "Num")) + expect_equal(sort(unique(tbls$ig_cdash$type)), + c("Char", "Date (dd-MON-yyyy)", "Num", "Time (24 hour)")) + expect_equal(sort(unique(tbls$ig_cdash$core)), c("HR", "O", "R/C")) + # the date and time types are the CDASHIG 1.1 conventions, dropped from 2.0 + ig <- tbls$ig_cdash + expect_equal(unique(ig$version[ig$type %in% c("Date (dd-MON-yyyy)", "Time (24 hour)")]), "1.1") + cm <- tbls$cdash_model + expect_type(cm$domain_specific, "logical") + expect_equal(sum(cm$domain_specific, na.rm = TRUE), 65L) + expect_equal(sum(!is.na(cm$domain_specific) & !cm$domain_specific), 0L) + expect_false(anyNA(cm$domain[cm$domain_specific %in% TRUE])) +}) + +test_that("codelist codes are C-codes, and a QRS item's TEST and TESTCD terms share one code", { + tbls <- cdash_gate_tables() + expect_true(all(grepl("^C[0-9]+$", tbls$cdash_model$codelist_code[!is.na(tbls$cdash_model$codelist_code)]))) + ig <- tbls$ig_cdash$codelist_code + expect_true(all(grepl("^C[0-9]+(; C[0-9]+)*$", ig[!is.na(ig)]))) + q <- tbls$qrs_supplement + for (col in c("testcd_codelist_code", "testcd_code", "test_codelist_code", "test_code")) { + expect_true(all(grepl("^C[0-9]+$", q[[col]])), label = col) + } + expect_equal(q$testcd_code, q$test_code) + # one --TEST and one --TESTCD codelist per instrument + expect_equal(c(unname(tapply(q$test_codelist_code, q$instrument, function(v) length(unique(v))))), + rep(1L, 9L)) + expect_equal(c(unname(tapply(q$testcd_codelist_code, q$instrument, function(v) length(unique(v))))), + rep(1L, 9L)) + expect_equal(length(unique(q$test_codelist_code)), 9L) + # only two instruments have items without a response group (6 items) + expect_equal(c(table(q$instrument[is.na(q$response_group)])), c(CGI = 3L, PGI = 3L)) +}) + +test_that("no carried CDASH or QRS text field has leading, trailing, or doubled whitespace", { + tbls <- cdash_gate_tables() + for (nm in names(tbls)) { + for (col in names(Filter(is.character, tbls[[nm]]))) { + v <- tbls[[nm]][[col]] + v <- v[!is.na(v)] + expect_equal(v[v != trimws(v) | grepl("[[:space:]]{2,}|[\r\n]", v)], character(0L), + label = paste(nm, col, "values with stray whitespace")) + } + } +}) + +test_that("order is a positive integer, and QRS items are numbered consecutively within an instrument", { + tbls <- cdash_gate_tables() + expect_type(tbls$cdash_model$order, "integer") + expect_type(tbls$ig_cdash$order, "integer") + expect_type(tbls$qrs_supplement$item_order, "integer") + expect_true(all(tbls$cdash_model$order >= 1L)) + expect_true(all(tbls$ig_cdash$order >= 1L)) + q <- tbls$qrs_supplement + expect_true(all(vapply(split(q$item_order, q$instrument), + function(o) identical(o, seq_along(o)), logical(1L)))) +}) diff --git a/tests/testthat/test-data_raw_ig.R b/tests/testthat/test-data_raw_ig.R new file mode 100644 index 0000000..69db49f --- /dev/null +++ b/tests/testthat/test-data_raw_ig.R @@ -0,0 +1,166 @@ +# The data-raw builder helpers (data-raw/utils_ig.R) read licensed CDISC +# Library exports that are never in this repository, so CI cannot run the +# build. These tests run its helpers on small synthetic exports written to a +# temporary directory, so the build logic (shape detection, missing-file and +# unexpected-file checks, and above all that no prose column reaches the data) +# is exercised without the real files. + +load_utils_ig <- function() { + path <- testthat::test_path("..", "..", "data-raw", "utils_ig.R") + testthat::skip_if_not(file.exists(path), "data-raw is not installed with the package") + env <- new.env(parent = globalenv()) + sys.source(path, envir = env) + env +} + +# A synthetic export of a given shape: every cell is ":" except +# the numeric and flag columns, which get values the converters can parse. +synthetic_export <- function(env, shape, rows = 2L) { + cols <- env$ig_source_shapes[[shape]] + x <- as.data.frame(lapply(stats::setNames(cols, cols), function(col) { + paste0(col, ":", seq_len(rows)) + }), check.names = FALSE, stringsAsFactors = FALSE) + for (col in intersect(cols, c("Variable Order", "Item Order"))) { + x[[col]] <- as.character(seq_len(rows)) + } + if ("Domain Specific" %in% cols) x[["Domain Specific"]] <- c("true", NA)[seq_len(rows)] + x +} + +# The prose columns of each shape, which must never be carried. +prose_columns <- list( + ig_sdtm = "CDISC Notes", + model_v1 = "Description", + model_v2 = c("Definition", "Notes", "Examples"), + ig_adam = "CDISC Notes", + cdash_model = c("DRAFT CDASH Definition", "Mapping Instructions", "Implementation Notes"), + cdash_ig = c("DRAFT CDASHIG Definition", "Case Report Form Completion Instructions", + "Mapping Instructions", "Implementation Notes"), + qrs = "Item Text" +) + +test_that("tidy_text collapses whitespace, including non-breaking spaces, and turns empty into NA", { + env <- load_utils_ig() + expect_equal(env$tidy_text(c(" a b ", "c\n d", "e  f", "", " ", NA)), + c("a b", "c d", "e f", NA, NA, NA)) +}) + +test_that("no prose column of any export shape reaches the data", { + env <- load_utils_ig() + parsed <- data.frame(standard = "S", version = "1.0", stringsAsFactors = FALSE) + qrs_parsed <- data.frame(instrument = "I", version = "1.0", stringsAsFactors = FALSE) + converters <- list( + ig_sdtm = env$ig_sdtm_rows, model_v1 = env$model_sdtm_rows, + model_v2 = env$model_sdtm_rows, ig_adam = env$ig_adam_rows, + cdash_model = env$cdash_model_rows, cdash_ig = env$cdash_ig_rows, qrs = env$qrs_rows + ) + for (shape in names(converters)) { + x <- synthetic_export(env, shape) + out <- converters[[shape]](x, if (shape == "qrs") qrs_parsed else parsed) + expect_equal(nrow(out), 2L, label = shape) + values <- unlist(Filter(is.character, out), use.names = FALSE) + for (col in prose_columns[[shape]]) { + expect_false(any(grepl(paste0(col, ":"), values, fixed = TRUE)), + label = paste(shape, "carries the", col, "column")) + } + # and the metadata columns do arrive + carried <- setdiff(env$ig_source_shapes[[shape]], c(prose_columns[[shape]], "Version")) + for (col in setdiff(carried, c("Variable Order", "Item Order", "Domain Specific"))) { + expect_true(any(startsWith(values, paste0(col, ":"))), label = paste(shape, "drops", col)) + } + } +}) + +test_that("the CDASH converters keep the flag, the wording, and the QRS names under their own columns", { + env <- load_utils_ig() + cm <- env$cdash_model_rows(synthetic_export(env, "cdash_model"), + data.frame(standard = "CDASH", version = "1.3")) + expect_equal(cm$domain_specific, c(TRUE, NA)) + expect_equal(cm$question_text, c("Question Text:1", "Question Text:2")) + expect_equal(cm$sdtm_target, c("SDTM Target:1", "SDTM Target:2")) + expect_equal(cm$order, 1:2) + ig <- env$cdash_ig_rows(synthetic_export(env, "cdash_ig"), + data.frame(standard = "CDASHIG", version = "2.3")) + expect_equal(ig$scenario[1L], "Data Collection Scenario/Implementation Option:1") + expect_equal(ig$codelist_submission_value[2L], "Codelist Submission Value:2") + qrs <- env$qrs_rows(synthetic_export(env, "qrs"), + data.frame(instrument = "HAM-A", version = "2.1")) + expect_equal(qrs$instrument, c("HAM-A", "HAM-A")) + expect_equal(qrs$test_name[1L], "Item Test Name:1") + expect_equal(qrs$testcd_code[1L], "Code for '--TESTCD':1") + expect_equal(qrs$test_code[1L], "Code for '--TEST':1") + expect_equal(qrs$testcd_codelist_code[1L], "Codelist Code for '--TESTCD':1") + expect_equal(qrs$test_codelist_code[1L], "Codelist Code for '--TEST':1") +}) + +test_that("read_library_export recognises each shape and its single Version value", { + env <- load_utils_ig() + dir <- withr::local_tempdir() + for (shape in names(env$ig_source_shapes)) { + x <- synthetic_export(env, shape) + if ("Version" %in% names(x)) x$Version <- "ADaMIG v1.3" + path <- file.path(dir, paste0(shape, ".csv")) + utils::write.csv(x, path, row.names = FALSE, na = "") + got <- env$read_library_export(path) + expect_equal(got$shape, shape) + expect_equal(nrow(got$data), 2L) + expect_equal(got$version_string, if (shape == "qrs") NA_character_ else "ADaMIG v1.3") + } +}) + +test_that("read_library_export stops on an unknown layout and on a file with two versions", { + env <- load_utils_ig() + dir <- withr::local_tempdir() + utils::write.csv(data.frame(a = 1, b = 2), file.path(dir, "odd.csv"), row.names = FALSE) + expect_error(env$read_library_export(file.path(dir, "odd.csv")), + "odd.csv has columns that match none of the known export shapes", fixed = TRUE) + x <- synthetic_export(env, "ig_adam") + x$Version <- c("ADaMIG v1.2", "ADaMIG v1.3") + utils::write.csv(x, file.path(dir, "two.csv"), row.names = FALSE) + expect_error(env$read_library_export(file.path(dir, "two.csv")), + "must carry exactly one Version value, found 2: ADaMIG v1.2; ADaMIG v1.3", + fixed = TRUE) +}) + +test_that("a missing export is an error that lists every missing file and points at the README", { + env <- load_utils_ig() + dir <- withr::local_tempdir() + file.create(file.path(dir, env$ig_source_files[1:30])) + withr::local_envvar(CDISC_SOURCES_DIR = dir) + e <- expect_error(env$cdisc_source_paths(env$ig_source_files), "4 of the 34 expected") + msg <- conditionMessage(e) + for (f in env$ig_source_files[31:34]) expect_match(msg, f, fixed = TRUE) + expect_false(grepl(env$ig_source_files[1L], msg, fixed = TRUE)) + expect_match(msg, "data-raw/README.md", fixed = TRUE) + expect_match(msg, "CDISC_SOURCES_DIR", fixed = TRUE) + file.create(file.path(dir, env$ig_source_files[31:34])) + expect_equal(names(env$cdisc_source_paths(env$ig_source_files)), env$ig_source_files) +}) + +test_that("the sources directory defaults to ../cdisc-sources and follows CDISC_SOURCES_DIR", { + env <- load_utils_ig() + withr::local_envvar(CDISC_SOURCES_DIR = NA) + expect_equal(env$cdisc_sources_dir(), "../cdisc-sources") + withr::local_envvar(CDISC_SOURCES_DIR = "somewhere/else") + expect_equal(env$cdisc_sources_dir(), "somewhere/else") +}) + +test_that("a QRS supplement the build does not list is an error, not silently loaded or skipped", { + env <- load_utils_ig() + dir <- withr::local_tempdir() + file.create(file.path(dir, env$qrs_source_files)) + withr::local_envvar(CDISC_SOURCES_DIR = dir) + expect_equal(sort(env$check_qrs_exports()), sort(env$qrs_source_files)) + file.create(file.path(dir, "NEW_SCALE_Supplement_v1.0.csv")) + expect_error(env$check_qrs_exports(), + "not listed in qrs_source_files: NEW_SCALE_Supplement_v1.0.csv", fixed = TRUE) +}) + +test_that("the file lists hold 34 IG and model, 9 CDASH, and 9 QRS exports, none twice", { + env <- load_utils_ig() + expect_equal(c(length(env$ig_source_files), length(env$cdash_source_files), + length(env$qrs_source_files)), c(34L, 9L, 9L)) + all_files <- c(env$ig_source_files, env$cdash_source_files, env$qrs_source_files) + expect_false(anyDuplicated(all_files) > 0L) + expect_setequal(env$qrs_source_files, qrs_files) +}) diff --git a/tests/testthat/test-get_cdash.R b/tests/testthat/test-get_cdash.R new file mode 100644 index 0000000..47d9f0e --- /dev/null +++ b/tests/testthat/test-get_cdash.R @@ -0,0 +1,108 @@ +test_that("get_cdash() defaults to the newest CDASHIG (2.3)", { + x <- get_cdash() + expect_s3_class(x, "data.frame") + expect_equal(unique(x$standard), "CDASHIG") + expect_equal(unique(x$version), "2.3") + expect_equal(nrow(x), 1253L) + expect_equal(names(x), names(get_dataset("ig_cdash"))) + expect_identical(x, get_cdash("CDASHIG")) +}) + +test_that("get_cdash reaches the CDASH model, newest version 1.3", { + x <- get_cdash("CDASH") + expect_equal(unique(x$standard), "CDASH") + expect_equal(unique(x$version), "1.3") + expect_equal(nrow(x), 314L) + expect_equal(names(x), names(get_dataset("cdash_model"))) +}) + +test_that("get_cdash reaches every standard version, with exactly the rows of its export", { + src <- cdiscdata::ig_sources + src <- src[src$table %in% c("cdash_model", "ig_cdash"), ] + expect_equal(nrow(src), 9L) + for (i in seq_len(nrow(src))) { + x <- get_cdash(src$standard[i], version = src$version[i]) + expect_equal(nrow(x), src$rows[i], label = paste(src$standard[i], src$version[i])) + expect_true(all(x$standard == src$standard[i] & x$version == src$version[i])) + } + expect_equal(unique(get_cdash("CDASHIG", "1.1")$version), "1.1") +}) + +test_that("get_cdash filters by domain, and the CDASH model also by class", { + lb <- get_cdash("CDASHIG", "2.1", "LB") + expect_equal(nrow(lb), 59L) + expect_equal(unique(lb$domain), "LB") + expect_equal(nrow(get_cdash("CDASHIG", "2.3", c("LB", "VS"))), + nrow(get_cdash("CDASHIG", "2.3", "LB")) + nrow(get_cdash("CDASHIG", "2.3", "VS"))) + findings <- get_cdash("CDASH", domain = "Findings") + expect_equal(unique(findings$class), "Findings") + ae <- get_cdash("CDASH", "1.3", "AE") + expect_gt(nrow(ae), 0L) + expect_equal(unique(ae$domain), "AE") +}) + +test_that("get_cdash aborts (classed) on an unknown standard, version, or domain", { + e <- expect_error(get_cdash("SDTMIG"), class = "cdiscdata_error_ig_standard_unavailable") + expect_equal(conditionMessage(e), + "Standard 'SDTMIG' is not available. Available standards: CDASH, CDASHIG.") + # the lower-case get_ig() aliases mean nothing here + expect_error(get_cdash("sdtm"), class = "cdiscdata_error_ig_standard_unavailable") + expect_error(get_cdash(c("CDASH", "CDASHIG")), class = "cdiscdata_error_ig_standard_unavailable") + expect_error(get_cdash(NA_character_), class = "cdiscdata_error_ig_standard_unavailable") + + ev <- expect_error(get_cdash("CDASHIG", version = "9.9"), + class = "cdiscdata_error_ig_version_unavailable") + expect_equal(conditionMessage(ev), + "Version '9.9' is not available for CDASHIG. Available versions: 1.1, 2.0, 2.1, 2.2, 2.3.") + expect_error(get_cdash("CDASH", version = "2.0"), class = "cdiscdata_error_ig_version_unavailable") + + ed <- expect_error(get_cdash("CDASHIG", domain = "ZZ"), + class = "cdiscdata_error_ig_domain_unavailable") + expect_match(conditionMessage(ed), + "Domain 'ZZ' is not available for standard 'CDASHIG' at version '2.3'. Available: AE, AG, CE,", + fixed = TRUE) + ec <- expect_error(get_cdash("CDASH", domain = "ZZ"), + class = "cdiscdata_error_ig_domain_unavailable") + # the CDASH model names classes and domains alike + expect_match(conditionMessage(ec), "Available: AE, Associated Persons - Identifiers,", fixed = TRUE) +}) + +test_that("get_ig does not reach the CDASH standards, and get_cdash does not reach the SDTM ones", { + expect_error(get_ig("CDASHIG"), class = "cdiscdata_error_ig_standard_unavailable") + expect_error(get_ig("CDASH"), class = "cdiscdata_error_ig_standard_unavailable") + expect_false(any(c("CDASH", "CDASHIG") %in% get_ig("SDTMIG")$standard)) +}) + +test_that("get_dataset reaches the CDASH and QRS tables whole or by version string", { + expect_identical(get_dataset("cdash_model"), cdiscdata::cdash_model) + expect_identical(get_dataset("ig_cdash"), cdiscdata::ig_cdash) + expect_identical(get_dataset("qrs_supplement"), cdiscdata::qrs_supplement) + expect_equal(nrow(get_dataset("ig_cdash", version = "2.3")), 1253L) + expect_equal(nrow(get_dataset("cdash_model", version = "1.1")), 276L) + # "2.0" is shared by AIMS, KFSS, KPS_SCALE, and the CDASHIG 2.0 is a different table + q20 <- get_dataset("qrs_supplement", version = "2.0") + expect_equal(sort(unique(q20$instrument)), c("AIMS", "KFSS", "KPS_SCALE")) + expect_equal(nrow(q20), 12L + 11L + 1L) + e <- expect_error(get_dataset("qrs_supplement", version = "9.9"), + class = "cdiscdata_error_ig_version_unavailable") + expect_equal(conditionMessage(e), + "Version '9.9' is not available in qrs_supplement. Available versions: 1.0, 1.1, 2.0, 2.1.") +}) + +test_that("list_datasets describes the CDASH and QRS tables by standard or instrument", { + ds <- list_datasets() + row <- function(name) ds[ds$dataset == name, ] + expect_equal(c(row("cdash_model")$type, row("ig_cdash")$type, row("qrs_supplement")$type), + c("CDASH", "CDASH", "QRS")) + expect_equal(row("cdash_model")$versions, "CDASH 1.0 to 1.3") + expect_equal(row("ig_cdash")$versions, "CDASHIG 1.1 to 2.3") + expect_equal(row("qrs_supplement")$versions, + paste("AIMS 2.0; APACHE_II 1.0; ATLAS 1.0; CGI 2.1; HAM-A 2.1; KFSS 2.0;", + "KPS_SCALE 2.0; PGI 1.1; SIX_MINUTE_WALK 1.0")) + expect_equal(c(row("cdash_model")$n_versions, row("ig_cdash")$n_versions, + row("qrs_supplement")$n_versions), c(4L, 5L, 9L)) + expect_true(all(is.na(c(row("cdash_model")$latest, row("ig_cdash")$latest, + row("qrs_supplement")$latest)))) + # one row per export: 34 IG and model, 9 CDASH, 9 QRS + expect_equal(sum(ds$n_versions[ds$type %in% c("IG", "Model", "CDASH", "QRS")]), 52L) +}) diff --git a/tests/testthat/test-get_ig.R b/tests/testthat/test-get_ig.R index e285622..4b6bf77 100644 --- a/tests/testthat/test-get_ig.R +++ b/tests/testthat/test-get_ig.R @@ -18,7 +18,7 @@ test_that("the pre-redesign names 'sdtm' and 'adam' are kept as aliases for SDTM }) test_that("each standard's default version is its newest, compared numerically", { - src <- cdiscdata::ig_sources + src <- ig_standard_sources() for (std in unique(src$standard)) { v <- src$version[src$standard == std] newest <- v[order(package_version(v))][length(v)] @@ -29,7 +29,7 @@ test_that("each standard's default version is its newest, compared numerically", }) test_that("get_ig reaches every one of the 15 standards, and only that standard's rows", { - src <- cdiscdata::ig_sources + src <- ig_standard_sources() for (i in seq_len(nrow(src))) { x <- get_ig(src$standard[i], version = src$version[i]) expect_equal(nrow(x), src$rows[i], label = paste(src$standard[i], src$version[i])) diff --git a/tests/testthat/test-ig_integrity.R b/tests/testthat/test-ig_integrity.R index 1515da7..b023ca3 100644 --- a/tests/testthat/test-ig_integrity.R +++ b/tests/testthat/test-ig_integrity.R @@ -22,10 +22,6 @@ ig_keys <- list( ig_adam = c("standard", "version", "structure", "variable_set", "variable") ) -ig_row_key <- function(tbl, cols) { - do.call(paste, c(lapply(tbl[cols], as.character), sep = "\r")) -} - test_that("each IG/model table has exactly the documented metadata columns, nothing from the guides' prose", { tbls <- ig_gate_tables() expect_equal(names(tbls$ig_sdtm), @@ -50,8 +46,8 @@ test_that("each IG/model table has exactly the documented metadata columns, noth } }) -test_that("ig_sources lists the 34 exports, each parsed to one distinct standard version", { - src <- cdiscdata::ig_sources +test_that("ig_sources lists the 34 IG and model exports, each parsed to one distinct standard version", { + src <- ig_standard_sources() expect_equal(nrow(src), 34L) expect_setequal(src$version_string, ig_version_strings) expect_false(anyDuplicated(src$file) > 0L) @@ -65,7 +61,7 @@ test_that("ig_sources lists the 34 exports, each parsed to one distinct standard }) test_that("every export is loaded exactly once, with as many rows as its file has", { - src <- cdiscdata::ig_sources + src <- ig_standard_sources() tbls <- ig_gate_tables() for (nm in names(tbls)) { s <- src[src$table == nm, ] diff --git a/tests/testthat/test-ig_versions.R b/tests/testthat/test-ig_versions.R index a7b6220..f5d6a4f 100644 --- a/tests/testthat/test-ig_versions.R +++ b/tests/testthat/test-ig_versions.R @@ -61,3 +61,54 @@ test_that("version resolution picks the newest numerically and lists versions in expect_equal(conditionMessage(e), "Version '9.9' is not available for SDTMIG. Available versions: 3.1.2, 3.1.3, 3.2.") }) + +test_that("the parser also handles the nine CDASH Version strings", { + got <- parse_ig(cdash_version_strings) + expect_equal(got$standard, c(rep("CDASH", 4L), rep("CDASHIG", 5L))) + expect_equal(got$version, c("1.0", "1.1", "1.2", "1.3", "1.1", "2.0", "2.1", "2.2", "2.3")) + expect_equal(parse_ig("CDASH Model v1.3"), data.frame(standard = "CDASH", version = "1.3")) + expect_equal(parse_ig("CDASHIG v2.3"), data.frame(standard = "CDASHIG", version = "2.3")) + # 'CDASH' alone is not a standard: the model is written 'CDASH Model' + expect_error(parse_ig("CDASH v1.3"), class = "cdiscdata_error_ig_version_unparsable") +}) + +test_that("the CDASH standards map to their own tables and stay out of get_ig()'s standards", { + lib <- cdiscdata:::.library_standards + expect_equal(nrow(lib), 17L) + expect_equal(lib$table[lib$standard == "CDASH"], "cdash_model") + expect_equal(lib$table[lib$standard == "CDASHIG"], "ig_cdash") + expect_equal(cdiscdata:::.cdash_standards$standard, c("CDASH", "CDASHIG")) + expect_false(any(c("CDASH", "CDASHIG") %in% cdiscdata:::.ig_standards$standard)) + expect_false(anyDuplicated(lib$raw) > 0L) + expect_false(anyDuplicated(lib$standard) > 0L) +}) + +test_that("the QRS file-name parser reads the instrument and version out of the nine file names", { + parse_qrs <- cdiscdata:::.parse_qrs_filename + got <- parse_qrs(qrs_files) + expect_equal(got$instrument, + c("AIMS", "APACHE_II", "ATLAS", "CGI", "HAM-A", "KFSS", "KPS_SCALE", + "PGI", "SIX_MINUTE_WALK")) + expect_equal(got$version, c("2.0", "1.0", "1.0", "2.1", "2.1", "2.0", "2.0", "1.1", "1.0")) + expect_equal(parse_qrs("HAM-A_Supplement_v2.1.csv"), + data.frame(instrument = "HAM-A", version = "2.1")) + # a path is reduced to its file name, and a multi-part version is kept whole + expect_equal(parse_qrs("C:/some/dir/X_Y_Supplement_v1.2.3.csv"), + data.frame(instrument = "X_Y", version = "1.2.3")) +}) + +test_that("a QRS file name that does not fit is a classed error naming it, never a guess", { + parse_qrs <- cdiscdata:::.parse_qrs_filename + e <- expect_error(parse_qrs("AIMS_Supplement.csv"), + class = "cdiscdata_error_qrs_filename_unparsable") + expect_equal(conditionMessage(e), + paste0("Cannot parse QRS supplement file name(s): 'AIMS_Supplement.csv'. ", + "Expected '_Supplement_v.csv'.")) + e2 <- expect_error(parse_qrs(c("CGI_Supplement_v2.1.csv", "bad.csv", "PGI_v1.1.csv")), + class = "cdiscdata_error_qrs_filename_unparsable") + expect_match(conditionMessage(e2), "'bad.csv', 'PGI_v1.1.csv'", fixed = TRUE) + expect_false(grepl("CGI_Supplement", conditionMessage(e2), fixed = TRUE)) + expect_error(parse_qrs("AIMS_Supplement_v2.0.txt"), + class = "cdiscdata_error_qrs_filename_unparsable") + expect_error(parse_qrs(NA_character_), class = "cdiscdata_error_qrs_filename_unparsable") +}) diff --git a/tests/testthat/test-list_datasets.R b/tests/testthat/test-list_datasets.R index e8a3cf5..b3d31e6 100644 --- a/tests/testthat/test-list_datasets.R +++ b/tests/testthat/test-list_datasets.R @@ -18,7 +18,7 @@ test_that("list_datasets has required columns", { test_that("list_datasets type values are expected set", { types <- unique(list_datasets()$type) - expect_true(all(types %in% c("CT", "IG", "Model", "Schema", "Stylesheet"))) + expect_true(all(types %in% c("CT", "IG", "Model", "CDASH", "QRS", "Schema", "Stylesheet"))) }) test_that("list_datasets describes the IG and model tables by standard, counting standard versions", {