Review ask

As a clinical trial statistician or programmer, answer three short questions in Your review: the task, the inputs and outputs, and the AI-assisted review. Agreeing with all three approves this benchmark; disagreeing with any 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: reviewedEditUnder review
What this benchmark means
README.md

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

Goal: give each subject a normalized country in COUNTRY and its region in REGION1.

Input: demographics (DM) rows carrying the collected country (COUNTRY) as reported, in mixed case or empty, including a country outside the three listed below.

Variables:

  • COUNTRY is the collected country from demographics in upper case; a subject with no collected country is UNKNOWN. Every collected country passes through: there is no allowed-countries check, so the run never stops on a new country.
  • REGION1 is the region for that country: USA and CAN give North America, DEU gives Europe, and any other country (including UNKNOWN) gives Rest of World.

Note: case differences never split a country (usa and USA are one), and the fallback values mean every subject has both a country and a region.

Inputs

Under review
1 source file

input/dm.csv

Edit
9 rows
input/dm.csv
STUDYIDUSUBJIDCOUNTRY
YAMAA-01usa
YAMAA-01CAN
YAMAA-01deu
YAMAA-01—
YAMAA-01UsA
YAMAA-01cAn
YAMAA-01unknown
YAMAA-01—
YAMAA-01fra

Expected output

Under review
9 expected rows

expected/adsl.csv

Edit
9 rows
expected/adsl.csv
STUDYIDUSUBJIDCOUNTRYREGION1
YAMAA-01USANorth America
YAMAA-01CANNorth America
YAMAA-01DEUEurope
YAMAA-01UNKNOWNRest of World
YAMAA-01USANorth America
YAMAA-01CANNorth America
YAMAA-01UNKNOWNRest of World
YAMAA-01UNKNOWNRest of World
YAMAA-01FRARest of World
Shaded columns are derived— = missing value

Human review and assessment

Your review

3 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
ADSLSTUDYIDStudy IdentifiercharacterCopy value from DM.STUDYID.Predecessor
ADSLUSUBJIDUnique Subject IdentifiercharacterCopy value from DM.USUBJID.Predecessor
ADSLCOUNTRYCountrycharacterConvert DM.COUNTRY to upper case; a missing source → "UNKNOWN".Derived
ADSLREGION1Geographic Region 1characterNorth America, Europe, Rest of WorldRecode COUNTRY: "USA" → "North America", "CAN" → "North America", "DEU" → "Europe"; missing or unlisted values → "Rest of World".Derived
VariablePermitted values
REGION1North America, Europe, Rest of World
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

Agent prompt

The request an agent receives with the input files; each tier states no more than the one above

prompts/adam-adsl-country-region/full.md

Edit
13 lines

Following CDISC ADaM standards, use the provided DM dataset to create an ADSL dataset with one record per subject.

The output dataset should contain the following columns in this order: STUDYID, USUBJID, COUNTRY, REGION1

COUNTRY is the collected country in upper case, and "UNKNOWN" when no country was collected. REGION1 is "North America" when COUNTRY is "USA" or "CAN", "Europe" when COUNTRY is "DEU", and "Rest of World" for any other country, including "UNKNOWN".

Read the source datasets from /app/input and save the completed dataset as /app/output/adsl.csv.

prompts/adam-adsl-country-region/conventions.md

Edit
12 lines

Following CDISC ADaM standards, use the provided DM dataset to create an ADSL dataset with one record per subject.

The output dataset should contain the following columns in this order: STUDYID, USUBJID, COUNTRY, REGION1

COUNTRY is the collected country in upper case, or "UNKNOWN". REGION1 is "North America" for "USA" or "CAN", "Europe" for "DEU", and "Rest of World" for any other country.

Read the source datasets from /app/input and save the completed dataset as /app/output/adsl.csv.

prompts/adam-adsl-country-region/brief.md

Edit
8 lines

Following CDISC ADaM standards, use the provided DM dataset to create an ADSL dataset with one record per subject.

The output dataset should contain the following columns in this order: STUDYID, USUBJID, COUNTRY, REGION1

Read the source datasets from /app/input and save the completed dataset as /app/output/adsl.csv.

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

Solution without yamaa

Written from the full prompt and the inputs alone; CI checks it reproduces the expected output

solutions/adam-adsl-country-region/result.R

Edit
29 lines
# Reference solution for the yamaa benchmark adam-adsl-country-region (R track).## Written from the benchmark's full prompt and its inputs alone, as an agent# would write it. Harbor's oracle agent runs it to check that the prompt can# be solved and that the grader scores a correct answer 1.library(dplyr, warn.conflicts = FALSE)library(readr)library(stringr)dm <- read_csv(  "/app/input/dm.csv",  col_types = cols(.default = col_character()))adsl <- dm |>  mutate(    COUNTRY = str_trim(coalesce(COUNTRY, "")),    COUNTRY = if_else(COUNTRY == "", "UNKNOWN", str_to_upper(COUNTRY)),    REGION1 = case_when(      COUNTRY %in% c("USA", "CAN") ~ "North America",      COUNTRY == "DEU" ~ "Europe",      .default = "Rest of World"    )  ) |>  select(STUDYID, USUBJID, COUNTRY, REGION1)dir.create("/app/output", showWarnings = FALSE)write_csv(adsl, "/app/output/adsl.csv", na = "")

solutions/adam-adsl-country-region/result.py

Edit
54 lines
# Reference solution for the yamaa benchmark adam-adsl-country-region (Python track).## Written from the benchmark's full prompt and its inputs alone, as an agent# would write it. Harbor's oracle agent runs it to check that the prompt can# be solved and that the grader scores a correct answer 1."""Create ADSL from DM: one record per subject with COUNTRY and REGION1.COUNTRY is the collected country in upper case, or "UNKNOWN" when nocountry was collected. REGION1 is "North America" for USA/CAN, "Europe"for DEU, and "Rest of World" for any other country, including "UNKNOWN"."""import csvINPUT_CSV = "/app/input/dm.csv"OUTPUT_CSV = "/app/output/adsl.csv"OUTPUT_COLUMNS = ["STUDYID", "USUBJID", "COUNTRY", "REGION1"]def region_for(country):    if country in ("USA", "CAN"):        return "North America"    if country == "DEU":        return "Europe"    return "Rest of World"def main():    with open(INPUT_CSV, newline="", encoding="utf-8") as f:        dm = list(csv.DictReader(f))    rows = []    for record in dm:        collected = (record.get("COUNTRY") or "").strip()        country = collected.upper() if collected else "UNKNOWN"        rows.append(            {                "STUDYID": record["STUDYID"],                "USUBJID": record["USUBJID"],                "COUNTRY": country,                "REGION1": region_for(country),            }        )    with open(OUTPUT_CSV, "w", newline="", encoding="utf-8") as f:        writer = csv.DictWriter(f, fieldnames=OUTPUT_COLUMNS)        writer.writeheader()        writer.writerows(rows)if __name__ == "__main__":    main()

solutions/adam-adsl-country-region/result.sas

Edit
24 lines
/* opensas reference solution for the yamaa benchmark adam-adsl-country-region.   Reads the benchmark inputs and derives the requested output.   Execute with the existing opensas runtime: opensas /app/output/result.sas. */data dm;  length STUDYID USUBJID COUNTRY $1024;  infile "/app/input/dm.csv" dsd dlm="," firstobs=2 truncover lrecl=32767;  input STUDYID : $char1024. USUBJID : $char1024. COUNTRY : $char1024.;run;data result;  length REGION1 $20;  set dm;  COUNTRY=upcase(COUNTRY);  if missing(COUNTRY) then COUNTRY='UNKNOWN';  if COUNTRY in ('USA','CAN') then REGION1='North America';  else if COUNTRY='DEU' then REGION1='Europe';  else REGION1='Rest of World';run;proc sql;  create table final as select STUDYID, USUBJID, COUNTRY, REGION1 from result;quit;proc export data=final outfile="/app/output/adsl.csv" dbms=csv replace; run;