Refuse a SAS Transport File With an Unreadable Display Format

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

EditUnder reviewWhat this benchmark means

README.md

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

Goal: submit the demographics domain as a SAS transport file with its data definition, the age (AGE) displayed with three digits and no decimals.

Input: collected demographics with the age in years, one record per subject.

Variables:

DOMAIN is DM on every record.
AGE is the age in years at informed consent.

Note: the age's display format is written 3,0, with a comma between width and decimals. A SAS format separates them with a period, so the transport file could not carry the format, and the submission is refused before any file is written; the dataset itself still builds.

How to fix

Write the format as SAS spells it, width then a period:

display_format: "3."

3.0 states the same display with its zero decimals written out.

Expected failure

Editthe run is rejected; no artifact is accepted

expected/error.yaml

phase: validation
condition: xpt_display_format_invalid
rule: XPT-9

expected/error.yaml

phase: validation
condition: xpt_display_format_invalid
spec_paths:
  - sdtm.specs[0].columns.AGE.submission.display_format
rule: XPT-9
context:
  column: AGE
  display_format: "3,0"

YAML specification

1 spec file

spec.yaml

Edit70 lines

1yamaa: "1.0"2type: spec3model: SDTM4domain: DM5keys: [STUDYID, USUBJID]6input:7  RAW: {path: input/dm_raw.csv, types: {AGE: int}}89output:10  path: dm.csv11  columns: [DOMAIN, STUDYID, USUBJID, AGE]1213columns:14  - name: DOMAIN15    type: str16    label: Domain Abbreviation17    derivation: "'DM'"18    submission:19      core: Req20      role: Identifier21      length: 222      origins:23        - type: Assigned24          source: Sponsor2526  - name: STUDYID27    type: str28    label: Study Identifier29    derivation: RAW.STUDYID30    submission:31      core: Req32      role: Identifier33      length: 534      origins:35        - type: Protocol36          source: Sponsor3738  - name: USUBJID39    type: str40    label: Unique Subject Identifier41    derivation: RAW.USUBJID42    submission:43      core: Req44      role: Identifier45      length: 946      origins:47        - type: Assigned48          source: Sponsor4950  # The display format separates width and decimals with a comma, as a51  # spreadsheet in some locales would.52  - name: AGE53    type: int54    label: Age55    derivation: RAW.AGE56    submission:57      core: Exp58      role: Record Qualifier59      length: 360      display_format: "3,0"61      origins:62        - type: Derived63          source: Sponsor64      method: Age in years at informed consent6566submission:67  label: Demographics68  class: SPECIAL PURPOSE69  structure: One record per subject70  repeating: false

Inputs

Under review1 source file

input/dm_raw.csv

Edit2 rows

input/dm_raw.csv
STUDYID	USUBJID	AGE
PAR01		45
PAR01		63

Unexpected Output

Under review2 rows presented to the failing check - not an accepted artifact

expected/dm.csv

Edit2 rows

expected/dm.csv
DOMAIN	STUDYID	USUBJID	AGE
DM	PAR01		45
DM	PAR01		63

Shaded columns are derived— = missing value

Human review and assessment

Variable Name	Variable Label	Type	Length	Origin	Core	Conversion Definition	Variable Type	Variable Order
DOMAIN	Domain Abbreviation	Char	2	Assigned	Req	Set constant value "DM".	SDTM	1
STUDYID	Study Identifier	Char	5	Protocol	Req	Copy value from RAW.STUDYID.	SDTM	2
USUBJID	Unique Subject Identifier	Char	9	Assigned	Req	Copy value from RAW.USUBJID.	SDTM	3
AGE	Age	Num	3	Derived	Exp	Age in years at informed consent	SDTM	4

Version	Date	Author	Description
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

How to fix

input/dm_raw.csv

expected/dm.csv

Your review

Mapping spec