Review ask

As a clinical trial statistician or programmer, challenge anything in this benchmark: describe a problem in Comments, or propose a fix with the Edit button on any source file.

  1. Task: Is this a specification error a study team could realistically make, and should the build stop on it rather than continue?
  2. Inputs: Do they trigger the failure for the reason the summary gives?
  3. Expected failure: Is this the right error, raised at the right point, and would it tell the programmer what to fix?

The other tabs beside Comments are background for assessment, not under review.

Summary

Lifecycle: draftEditUnder review
What this benchmark means
README.md

Goal: carry the numeric result (LBSTRESN) and the baseline flag (LBBLFL) as collected, and repeat the baseline value (BAVL) on every row for the subject.

Input: collected lab (LB) records, each with a numeric result (LBSTRESN) and a baseline flag (LBBLFL) holding Y on the baseline record.

Variables:

  • BAVL: the baseline value, taken from the subject's row flagged Y in LBBLFL and repeated on every row for that subject; missing when the subject has no flagged row.

Note: the run is rejected when a subject has more than one record flagged Y: no single baseline value exists, so no artifact is accepted.

How to fix

Keep exactly one baseline record per subject. Either clear the flag in the collected data on the visit that is not the baseline, for example WEEK 1:

STUDYID,USUBJID,VISIT,LBSTRESN,LBBLFL
PILOT7,P7-901,SCREENING,5.1,Y
PILOT7,P7-901,WEEK 1,5.4,
PILOT7,P7-901,WEEK 2,5.2,

or, when both visits genuinely qualify, pick one by rule (for example the earliest) and flag only that row before deriving.

Expected failure

Edit
the run is rejected; no artifact is accepted
expected/error.yaml
phase
derivation
condition
aggregate_multiple_records
requirement
REQ-0501
expected/error.yaml
phase: derivation
condition: aggregate_multiple_records
spec_paths:
  - columns.BAVL.derivation.aggregate
requirement: REQ-0501
context:
  reducer: ONLY
  record_count: 2

Inputs

Under review
1 source file

input/lb.csv

Edit
3 rows
input/lb.csv
STUDYIDUSUBJIDVISITLBSTRESNLBBLFL
PILOT7SCREENING5.1Y
PILOT7WEEK 15.4Y
PILOT7WEEK 25.2—

Unexpected Output

Under review
No artifact is produced

No fixture files in this directory.

Shaded columns are derived— = missing value

Comments and assessment materials

Comments

Signed in with GitHub; saved in repository Discussions

Mapping spec

Generated from the benchmark YAML; do not edit by hand

Dataset NameVariable NameVariable LabelTypeCodelist/Controlled TermsCoreComputational MethodOrigin
ADLBSTUDYIDStudy IdentifiercharacterCopy value from LB.STUDYID.Predecessor
ADLBUSUBJIDUnique Subject IdentifiercharacterCopy value from LB.USUBJID.Predecessor
ADLBVISITVisit NamecharacterCopy value from LB.VISIT.Predecessor
ADLBLBSTRESNNumeric ResultnumericCopy value from LB.LBSTRESN.Predecessor
ADLBLBBLFLBaseline FlagcharacterCopy value from LB.LBBLFL.Predecessor
ADLBBAVLBaseline ValuenumericAggregate ONLY(LBSTRESN) over records grouped by STUDYID, USUBJID, matching on the shared output keys, where LBBLFL = 'Y'.Derived
VersionDateAuthorDescriptionReviewerSign-off
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