Illustrates Domains
ADEFF
Illustrates Variables
ABLFL
Illustrates Data Structures
BDS
Content
This example includes abbreviated ADaM datasets together with metadata to demonstrate possible ways to construct analysis datasets to analyze vital signs data in pediatric type 1 diabetes (T1D) subjects. The variables presented are those that may be of specific interest to analysis of changes in weight and/or body mass index (BMI) for an observational study in the period following initial diagnosis of T1D. In this hypothetical case, subjects are enrolled within 2 months of being diagnosed with T1D. After the enrollment visit, there are no study visits; vital signs data is collected at each healthcare visit. The researchers want to analyze changes in BMI at 30, 60, and 90 days following diagnosis.
The following example includes sample data along with dataset, variable, and value/parameter-level metadata. The source metadata for the variables and values are provided for illustrative purposes and are not intended to represent standard derivation logic. Within the Source/Deriviation/Comment column there is additional text intended to provide further discussion. This additional text would not be present in an actual Define-XML document. ADVSBMI is an example of an ADaM BDS dataset that could be used to support analysis of BMI and BMI percentile over time.
ADVSBMI Dataset Metadata
Dataset Name | Dataset Description | Dataset Location | Dataset Structure | Keys | Class | Documentation |
---|---|---|---|---|---|---|
ADVSBMI | BMI Analysis Dataset | advsbmi.xpt | One record per subject per parameter per analysis timepoint | STUDYID, USUBJID, PARAMCD, ATPT | BASIC DATA STRUCTURE | XYZ Protocol and SAP |
ADVSBMI Variable Metadata
Variable | Variable Label | Type | Length/Display Format | Codelist/Controlled Terms | Source/Derivation/Comment |
---|---|---|---|---|---|
STUDYID | Study Identifier | text | $5 | ADSL.STUDYID | |
USUBJID | Unique Subject Identifier | text | $7 | ADSL.USUBJID | |
AAGE | Analysis Age | float | (6.2) | ADSL.AAGE | |
AAGEU | Analysis Age Units | text | ADSL.AAGEU | ||
SEX | Sex | text | (SEX) | ADSL.SEX | |
SEXN | Sex (N) | integer | 1, 2 | ADSL.SEXN | |
BRTHDT | Date of Birth | integer | date9. | ADSL.BRTHDT | |
T1DDXDT | Date of Type 1 Diabetes Diagnosis | integer | date9. | ADSL.T1DDXDT | |
VSDTC | Date/Time of Measurements | text | ISO 8601 | VS.VSDTC | |
ADT | Analysis Date | integer | date9. | Numeric version of date portion of VSDTC | |
ATPT | Analysis Timepoint | text | Baseline 30 Days 60 Days 90 Days | If ADT <= ADSL.RFICDT, set to "Baseline"; else if ADSL.RFICDT < ADT <= ADSL.T1DDXDT + 45, set to "30 days"; else if ADSL.T1DDXDT + 45 < ADT < = ADSL.T1DDXDT+ 75, set to "60 days"; else if ADSL.T1DDXDT+ 75 < ADT <=ADSL.T1DDXDT+ 105, else set to "90 days"; otherwise, set to missing. | |
ATPTN | Analysis Timepoint Number | integer | 0 (= Baseline) 30 (= 30 Days) 60 (= 60 Days) 90 (= 90 Days) | Assigned based on value of ATPT. Provided to facilitate plotting. | |
AGEYTPT | Age at Analysis Timepoint (years) | float | (6.2) | Derived: Age in years (in 2 decimal points) calculated between BRTHDT and ADT as ROUND(((ADT – BRTHDT) / 365.25),0.01). | |
AGEMTPT | Age at Analysis Timepoint (months) | float | (6.2) | Derived: Age in months (in 2 decimal points) calculated between BRTHDT and ADT as ROUND(12*((ADT – BRTHDT) / 365.25),0.01). | |
PARAM | Parameter | text | Height (m), Weight (kg), Body Mass Index (kg/m2), BMI-for-Age Percentile | Assign based on PARAMCD using controlled terminology. | |
PARAMCD | Parameter Code | text | HEIGHT, WEIGHT, BMI, BMIAPCTL | Set PARAMCD=VS.VSTESTCD where VSTESTCD in ("HEIGHT, WEIGHT, BMI, BMIAPCTL") | |
AVAL | Analysis Value | float | See Parameter-Level Metadata. | ||
ABLFL | Baseline Record Flag | text | Y | Set to "Y" for the record with ADT closest and prior to T1DDXDT with a non-missing AVAL. | |
BASE | Baseline Value | float | AVAL where ABLFL="Y" | ||
CHG | Change from Baseline | float | AVAL - BASE | ||
VSSEQ | Sequence Number | integer | When the record is based on a single record in VS, set to VS.VSEQ where VS.VSTESTCD= PARAMCD and VS.VSDTC = ADT. Otherwise missing. |
Parameter Value List - ADVSBMI [AVAL]
Variable | Where | Type | Length/DisplayFormat | CodeList/Controlled Terms | Source/Derivation Comment |
---|---|---|---|---|---|
AVAL | PARAMCD in ("WEIGHT","HEIGHT") | float | (6.2) | Set to VS.VSTRESN where VS.VSTESTCD = PARAMCD | |
AVAL | PARAMCD="BMI" | float | (5.1) | After deriving ADaM data for parameters HEIGHT and WEIGHT from SDTM records of a given VS.VSDTC, check for a VS.VSTESTCD="BMI" at the same VS.VSDTC.
| |
AVAL | PARAMCD="BMIAPCTL" | integer | (2.0) | If there is a VS record where VS.VSTESTCD = "BMIAPCTL" and VS.VSDTC = ADT, set AVAL to VS.VSSTRESN; else use the AGEMTPT, SEXN and BMI to look up the BMIAPCTL value in the available reference tables (may be captured in the protocol, SAP, or external references) that define the percentile value associated with the combination of variable values. |