As a clinical trial statistician or programmer, answer two short questions in Your review: the task and the inputs and outputs. Agreeing with both approves this benchmark; disagreeing with either needs a comment. Propose a fix with the Edit button on any source file, or add it to your comments.
We suggest spending no more than 5 minutes on a review. The other tabs beside Your review are background for assessment, not under review.
Summary
README.mdPublic entries: Python and R. Passing coverage requires an installed inventory.
Goal: show the short spellings that are the only way to write a plain value: a bare column reference, a bare input path, a bare ordering value, a lone condition, a lone label string, a lone summary formula and a plain list of checked columns. Each runs exactly as its full form.
Input: one spec.yaml over a demographics file (one record per
subject: sex and age, read as stored) and a weight file (several dated
weight records per subject, with typed sequence and weight).
Variables:
SEX: the subject's recorded sex; a subject without one stops the run.AGE: the subject's age in years, converted from the collected text; blank when not collected.AGE65FL:Yfor subjects aged 65 or older; blank otherwise. A lone condition needs no explicit yes or no text: it answersYwhen true and stays blank when false or unknown.SUBJLBL: a readable label joining the subject identifier and sex, written as one plain string with placeholders; no two subjects share a label.WTMAX: the largest collected weight across the subject's weight records, written as one plain summary formula.LASTWT: the weight from the subject's latest dated record; the latest record wins because a bare ordering value sorts earliest-first.
Note: each short spelling is the only way to write its value and
expands to its full form before the run: a bare reference reads the
named column, a bare path names the input file, a bare ordering value
sorts earliest-first, a lone condition answers Y when true and stays
blank otherwise, a lone label string keeps its placeholders, a lone
formula summarizes the matched records, and a plain list names the
columns a check covers. The full form is written only when it adds
something, such as typed fields, explicit answers or a check name; a
full form that holds nothing beyond its short spelling is refused, and
one check or one key column is still written as a one-item list.
Inputs
Under review2 source filesExpected output
Under review4 expected rowsexpected/adsl.csv
Edit4 rows| STUDYID | USUBJID | SEX | AGE | AGE65FL | SUBJLBL | WTMAX | LASTWT |
|---|---|---|---|---|---|---|---|
| YAMAA-01 | M | 34 | — | Subject YAMAA-01-001 (M) | 71 | 71 | |
| YAMAA-01 | F | 67 | Y | Subject YAMAA-01-002 (F) | 68 | 67.5 | |
| YAMAA-01 | M | — | — | Subject YAMAA-01-003 (M) | 80 | 80 | |
| YAMAA-01 | F | 72 | Y | Subject YAMAA-01-004 (F) | 56 | 56 |
Human review and assessment
| Dataset Name | Variable Name | Variable Label | Type | Codelist/Controlled Terms | Core | Computational Method | Origin |
|---|---|---|---|---|---|---|---|
| ADSL | STUDYID | Study Identifier | character | Set constant value "YAMAA-01". | Assigned | ||
| ADSL | USUBJID | Unique Subject Identifier | character | Copy value from DM.USUBJID. | Predecessor | ||
| ADSL | SEX | Sex | character | Copy value from DM.SEX. | Predecessor | ||
| ADSL | AGE | Age | numeric | Copy value from DM.AGE. | Predecessor | ||
| ADSL | AGE65FL | Age 65 or Older Flag | character | "Y" when AGE >= 65; blank otherwise. | Derived | ||
| ADSL | SUBJLBL | Subject Label | character | Fill the template "Subject {USUBJID} ({SEX})". | Derived | ||
| ADSL | WTMAX | Maximum Collected Weight | numeric | Aggregate MAX(WT.WT) over records matching on the shared output keys. | Derived | ||
| ADSL | LASTWT | Latest Collected Weight | numeric | Take WT from the last WT record matching on USUBJID, ordered by WT.WTDTC, and a row with no match is an error. | Derived |
| Version | Date | Author | Description | Reviewer | Sign-off |
|---|---|---|---|---|---|
| 1.7 | 2026-10-20 | yamaa docs build | Read a specification in the 1.0 surface as its 0.5 counterpart; state that missing values stay missing where a mapping declares no missing handler, and leave out a declared missing answer that restates a handler's default | ||
| 1.6 | 2026-10-17 | yamaa docs build | Describe collected date parts written as ISO 8601 date text and times of day counted in seconds since midnight | ||
| 1.5 | 2026-10-17 | yamaa docs build | Name collected precision in words instead of letter codes; state imputation fallbacks, minimum source precision, bounds ignored outside the collected period, and invalid text with no handler as an error; describe date and datetime shifts, imputation flag codes, and partial text giving no date part | ||
| 1.4 | 2026-10-15 | yamaa docs build | State datetime precision codes through the hour and minute, and complete only the time parts a collected datetime lacks | ||
| 1.3 | 2026-09-29 | yamaa docs build | Show study codelist names, external dictionaries, and ISO 8601 formats in variable rows; list the document's codelist values and metadata | ||
| 1.2 | 2026-09-29 | yamaa docs build | Classify ADaM copies from a declared input as Predecessor and recodes as Derived, and SDTM recodes of locally derived columns as Derived | ||
| 1.1 | 2026-09-29 | yamaa docs build | Resolve lookups into the donor record they select, and give every derivation shape a plain-language rule instead of its raw YAML | ||
| 1.0 | yamaa docs build | Initial generation from spec.yaml |
yamaa