Review ask

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

Lifecycle: draftEditUnder review
What this benchmark means
README.md

Public 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:

  • AEPREDUR would hold the calendar time from the event's start to the first dose, so 26 August 2007 to 27 September 2007 gives P1M1D. 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

Edit
the run is rejected; no artifact is accepted
expected/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 review
1 source file

input/ae_raw.csv

Edit
2 rows
input/ae_raw.csv
STUDYIDUSUBJIDAESEQAESTDTCRFXSTDTC
YAMAA-0112007-08-262007-09-27
YAMAA-0112008-01-312008-02-29

Unexpected Output

Under review
No artifact is produced

No fixture files in this directory.

Shaded columns are derived— = missing value

Human review and assessment

Your review

2 questions and your comments · View benchmark discussions

Mapping spec

Generated from the benchmark YAML; do not edit by hand

Variable NameVariable LabelTypeLengthControlled Terms or FormatOriginCoreConversion DefinitionVariable TypeVariable OrderComments for Define
STUDYIDStudy IdentifierCharCollectedCopy value from AE_RAW.STUDYID.SDTM1
USUBJIDUnique Subject IdentifierCharCollectedCopy value from AE_RAW.USUBJID.SDTM2
AESEQSequence NumberNumCollectedCopy value from AE_RAW.AESEQ.SDTM3
AEPREDURTime From Start of Event to First DoseCharDerivedWrite 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.SDTM4
VersionDateAuthorDescriptionReviewerSign-off
1.72026-10-20yamaa docs buildRead 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.62026-10-17yamaa docs buildDescribe collected date parts written as ISO 8601 date text and times of day counted in seconds since midnight
1.52026-10-17yamaa docs buildName 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.42026-10-15yamaa docs buildState datetime precision codes through the hour and minute, and complete only the time parts a collected datetime lacks
1.32026-09-29yamaa docs buildShow study codelist names, external dictionaries, and ISO 8601 formats in variable rows; list the document's codelist values and metadata
1.22026-09-29yamaa docs buildClassify ADaM copies from a declared input as Predecessor and recodes as Derived, and SDTM recodes of locally derived columns as Derived
1.12026-09-29yamaa docs buildResolve lookups into the donor record they select, and give every derivation shape a plain-language rule instead of its raw YAML
1.0yamaa docs buildInitial generation from spec.yaml