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: write how long before the first dose each adverse event began as
ISO 8601 duration text in years, months and days (AEPREDUR).
Input: adverse event records, one per event (AESEQ), with the event's
start date as the case report form collected it and the subject's date of
first dose.
Variables:
AEPREDURwould hold the calendar time from the event's start to the first dose, so 26 August 2007 to 27 September 2007 givesP1M1D. Only two dates give a calendar duration, and the collected start is still text that nothing has read as a date, so the run is rejected before any data is read and no artifact is accepted.
How to fix
Declare the start a date where the input is read, so each value is checked as a complete date as the records are read:
input:
AE_RAW:
path: input/ae_raw.csv
types: {AESEQ: int, AESTDTC: date, RFXSTDTC: date}
When a start may be collected to the month or the year only, keep it as
text, take its date in a column of its own with to_date, and name that
column as the start; a partial start then has no date and no duration:
- name: AESTDT
type: date
label: Start Date of Adverse Event
derivation:
to_date: {source: AE_RAW.AESTDTC}
Expected failure
Editthe run is rejected; no artifact is acceptedexpected/error.yaml- phase
- validation
- condition
- incompatible_input_type
- rule
- TIME-24
expected/error.yaml
phase: validation
condition: incompatible_input_type
spec_paths:
- columns.AEPREDUR.derivation.calendar_duration.start
rule: TIME-24
context:
source: AE_RAW.AESTDTC
expected: date
actual: str
Inputs
Under review1 source fileinput/ae_raw.csv
Edit2 rows| STUDYID | USUBJID | AESEQ | AESTDTC | RFXSTDTC |
|---|---|---|---|---|
| YAMAA-01 | 1 | 2007-08-26 | 2007-09-27 | |
| YAMAA-01 | 1 | 2008-01-31 | 2008-02-29 |
Unexpected Output
Under reviewNo artifact is producedNo fixture files in this directory.
Human review and assessment
| Variable Name | Variable Label | Type | Length | Controlled Terms or Format | Origin | Core | Conversion Definition | Variable Type | Variable Order | Comments for Define |
|---|---|---|---|---|---|---|---|---|---|---|
| STUDYID | Study Identifier | Char | Collected | Copy value from AE_RAW.STUDYID. | SDTM | 1 | ||||
| USUBJID | Unique Subject Identifier | Char | Collected | Copy value from AE_RAW.USUBJID. | SDTM | 2 | ||||
| AESEQ | Sequence Number | Num | Collected | Copy value from AE_RAW.AESEQ. | SDTM | 3 | ||||
| AEPREDUR | Time From Start of Event to First Dose | Char | Derived | Write the calendar time from AE_RAW.AESTDTC to AE_RAW.RFXSTDTC as ISO 8601 duration text: whole months as years and months, then the remaining days, with a leading minus sign when AE_RAW.RFXSTDTC is earlier. | SDTM | 4 |
| 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