Review ask

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

Lifecycle: draftEditUnder review
What this benchmark means
README.md

Public entries: Python and R. Passing coverage requires an installed inventory.

Goal: one row per adverse event (AE) with an analysis start date/time (ASTDTM) completed from the collected start, and the date and time imputation flags (ASTDTF, ASTTMF) naming the first part of each that was supplied.

Input: one spec.yaml over adverse event records carrying the reported term (AETERM) and the collected start (AESTDTC), collected to the year, month, day, hour, minute or second.

Variables:

  • ASTDTM is the analysis start date/time. Every part the start did not collect takes its earliest value: January, the first day, and 00 for each part of the time.
  • ASTDTF is M when the month and day were supplied and D when only the day was; empty when the date was collected in full.
  • ASTTMF is H when the whole time was supplied, which includes every start collected only to a year, a month or a day, M when the minutes and seconds were and S when only the seconds were; empty when the time was collected to the second.

Note: both flags are read from the completed date/time, which keeps how much of it was collected; the completed values themselves look alike.

Inputs

Under review
1 source file

input/ae.csv

Edit
6 rows
input/ae.csv
STUDYIDUSUBJIDAESEQAETERMAESTDTC
YAMAA-011HEADACHE2025
YAMAA-012NAUSEA2025-03
YAMAA-013DIZZINESS2025-03-04
YAMAA-014FATIGUE2025-03-05T14
YAMAA-015RASH2025-03-06T09:30
YAMAA-016COUGH2025-03-07T10:15:30

Expected output

Under review
6 expected rows

expected/adae.csv

Edit
6 rows
expected/adae.csv
STUDYIDUSUBJIDAESEQAETERMAESTDTCASTDTMASTDTFASTTMF
YAMAA-011HEADACHE20252025-01-01T00:00:00MH
YAMAA-012NAUSEA2025-032025-03-01T00:00:00DH
YAMAA-013DIZZINESS2025-03-042025-03-04T00:00:00—H
YAMAA-014FATIGUE2025-03-05T142025-03-05T14:00:00—M
YAMAA-015RASH2025-03-06T09:302025-03-06T09:30:00—S
YAMAA-016COUGH2025-03-07T10:15:302025-03-07T10:15:30——
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

Dataset NameVariable NameVariable LabelTypeCodelist/Controlled TermsCoreComputational MethodOrigin
ADAESTUDYIDStudy IdentifiercharacterCopy value from AE.STUDYID.Predecessor
ADAEUSUBJIDUnique Subject IdentifiercharacterCopy value from AE.USUBJID.Predecessor
ADAEAESEQSequence NumbernumericCopy value from AE.AESEQ.Predecessor
ADAEAETERMReported Term for the Adverse EventcharacterCopy value from AE.AETERM.Predecessor
ADAEAESTDTCStart Date/Time of Adverse EventcharacterCopy value from AE.AESTDTC.Predecessor
ADAEASTDTMAnalysis Start Date/TimenumericISO 8601Impute incomplete datetime from AESTDTC, defaulting month=1, day=first, giving each time part the source lacks its earliest value; invalid text is an error.Derived
ADAEASTDTFAnalysis Start Date Imputation FlagcharacterM, DDate imputation flag for ASTDTM: "Y" when the whole date was imputed, "M" when the month and day were, "D" when only the day was; blank when the date was collected in full.Derived
ADAEASTTMFAnalysis Start Time Imputation FlagcharacterH, M, STime imputation flag for ASTDTM: "H" when the whole time was imputed, "M" when the minutes and seconds were, "S" when only the seconds were; blank when the time was collected to the second.Derived
VariablePermitted values
ASTDTFM, D
ASTTMFH, M, S
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

yamaa code

Public calls generated from benchmark.yaml; results must match the expected output

R

Edit
3 lines
library(yamaa)yamaa_spec("spec.yaml")$run()$output

Python

Edit
3 lines
import yamaayamaa.spec("spec.yaml").run().output