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
README.mdPublic entries: Python and R. Passing coverage requires an installed inventory.
Goal: one row per concomitant medication with an analysis start date
(ASTDT) taken only from a start collected with a complete date.
Input: one spec.yaml over concomitant medication records, each
identified by its sequence number (CMSEQ), carrying the reported name
(CMTRT) and the collected start (CMSTDTC): a date with a time to the
minute or the hour, a date alone, a year and month, a year alone, or nothing
at all.
Variables:
ASTDTis the calendar date of the collected start when it carries a complete date, whether or not a time follows it. A start collected to the year and month or the year alone is partial and gives no analysis date, and nothing is supplied to complete it; a start never collected gives none either.
Note: a partial start is not an error here: it is counted and left without a date, while text that is not a date at all would stop the run.
Inputs
Under review1 source fileinput/cm.csv
Edit6 rows| STUDYID | USUBJID | CMSEQ | CMTRT | CMSTDTC |
|---|---|---|---|---|
| YAMAA-01 | 1 | Paracetamol | 2025-01-12T08:30 | |
| YAMAA-01 | 2 | Omeprazole | 2025-01-15 | |
| YAMAA-01 | 3 | Loratadine | 2025-02 | |
| YAMAA-01 | 1 | Amoxicillin | 2024 | |
| YAMAA-01 | 2 | Cetirizine | 2025-02-03T14 | |
| YAMAA-01 | 3 | Aspirin | — |
Expected output
Under review6 expected rowsexpected/adcm.csv
Edit6 rows| STUDYID | USUBJID | CMSEQ | CMTRT | CMSTDTC | ASTDT |
|---|---|---|---|---|---|
| YAMAA-01 | 1 | Paracetamol | 2025-01-12T08:30 | 2025-01-12 | |
| YAMAA-01 | 2 | Omeprazole | 2025-01-15 | 2025-01-15 | |
| YAMAA-01 | 3 | Loratadine | 2025-02 | — | |
| YAMAA-01 | 1 | Amoxicillin | 2024 | — | |
| YAMAA-01 | 2 | Cetirizine | 2025-02-03T14 | 2025-02-03 | |
| YAMAA-01 | 3 | Aspirin | — | — |
Human review and assessment
| Dataset Name | Variable Name | Variable Label | Type | Codelist/Controlled Terms | Core | Computational Method | Origin |
|---|---|---|---|---|---|---|---|
| ADCM | STUDYID | Study Identifier | character | Copy value from CM.STUDYID. | Predecessor | ||
| ADCM | USUBJID | Unique Subject Identifier | character | Copy value from CM.USUBJID. | Predecessor | ||
| ADCM | CMSEQ | Sequence Number | numeric | Copy value from CM.CMSEQ. | Predecessor | ||
| ADCM | CMTRT | Reported Name of Drug, Medication, or Therapy | character | Copy value from CM.CMTRT. | Predecessor | ||
| ADCM | CMSTDTC | Start Date/Time of Medication | character | Copy value from CM.CMSTDTC. | Predecessor | ||
| ADCM | ASTDT | Analysis Start Date | numeric | ISO 8601 | Take the date part of CMSTDTC, blank for a year or a year and month alone. | 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