As a clinical trial statistician or programmer, answer two short questions in Your review: the task and the inputs. 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: give each subject the date of their first dose in treatment period
2 (TR02SDT).
Input: the subjects with the date of their first dose, their dosing records with a start date, and each subject's treatment periods, each from a first to a last day.
Variables:
TR02SDTwould be the start date of the subject's earliest dose whose period is period 2, and blank for a subject with no dose in period 2.
Note: each dose is placed in a period while that dose is looked at, and only the dose itself is known then. The period is chosen by the subject's first dose date instead, a value of the subject rather than of the dose, so the run is rejected before any data is read and no artifact is accepted.
How to fix
Place each dose by its own start date, which the dose record holds:
between: {value: EXSTDT, lower: APERSDT, upper: APEREDT}
EX.EXSTDT names the same date. The subject's first dose date would place
every dose of the subject in the same period.
Expected failure
Editthe run is rejected; no artifact is acceptedexpected/error.yaml- phase
- validation
- condition
- unknown_field
- rule
- LOOKUP-16
expected/error.yaml
phase: validation
condition: unknown_field
spec_paths:
- intermediates.P2DOSE.derivations.DOSEPER.source
rule: LOOKUP-16
context:
identifier: DM.RFXSTDT
intermediate: P2DOSE
read: PERIOD
Inputs
Under review3 source filesinput/dm.csv
Edit2 rows| STUDYID | USUBJID | RFXSTDT |
|---|---|---|
| YAMAA-01 | 2025-01-01 | |
| YAMAA-01 | 2025-01-05 |
input/ex.csv
Edit4 rows| STUDYID | USUBJID | EXSEQ | EXSTDT |
|---|---|---|---|
| YAMAA-01 | 1 | 2025-01-01 | |
| YAMAA-01 | 2 | 2025-02-01 | |
| YAMAA-01 | 1 | 2025-01-05 | |
| YAMAA-01 | 2 | 2025-02-06 |
input/periods.csv
Edit4 rows| STUDYID | USUBJID | APERIOD | APERSDT | APEREDT |
|---|---|---|---|---|
| YAMAA-01 | 1 | 2025-01-01 | 2025-01-31 | |
| YAMAA-01 | 2 | 2025-02-01 | 2025-02-28 | |
| YAMAA-01 | 1 | 2025-01-05 | 2025-02-05 | |
| YAMAA-01 | 2 | 2025-02-06 | 2025-03-07 |
Unexpected Output
Under reviewNo artifact is producedNo fixture files in this directory.
Human review and assessment
| Dataset Name | Variable Name | Variable Label | Type | Codelist/Controlled Terms | Core | Computational Method | Origin |
|---|---|---|---|---|---|---|---|
| ADSL | STUDYID | Study Identifier | character | Copy value from DM.STUDYID. | Predecessor | ||
| ADSL | USUBJID | Unique Subject Identifier | character | Copy value from DM.USUBJID. | Predecessor | ||
| ADSL | TR02SDT | Date of First Exposure in Period 02 | numeric | ISO 8601 | Take EXSTDT from the first EX record matching on STUDYID and USUBJID, where EX.DOSEPER = 2, ordered by EX.EXSTDT, and no match yields blank. | 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