Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated metadata and datasets as per Nate comments.

...

Definexmltable
Multipletrue
LevelDataset
PurposeAnalysis

Dataset Name

Dataset Description

Class of Dataset

Structure

Keys

Documentation

Location

ADSL

Subject-Level Analysis Dataset

SUBJECT LEVEL ANALYSIS DATASET

One record per subject

USUBJIDADaMIGadsl.xpt
ADCVNTPCardiac Ejection Fraction and NTproBNP Analysis Dataset

BASIC DATA STRUCTURE

One record per subject per analysis visit per parameterUSUBJID, AVISITN, PARAMN

Analysis Dataset

adcvntp.xpt
ADCVCMRCardiovascular CMR Ejection Fraction Analysis Dataset

BASIC DATA STRUCTURE

One record per subject per analysis visit per parameterUSUBJID, AVISITN, PARAMN

Analysis Dataset

adcvcmr.xpt

The ADSL was combined with other SDTM datasets to create the analysis datasets. More than one SDTM dataset can be combined in this wayADaM model requires a one-record-per-subject analysis dataset, ADSL, which contains subject characteristics and covariates that are important for analyses. Also, stratification variables can be created in the ADSL to subset by, or to add variables needed in the analyses. For the data. More than one SDTM dataset is used as input to the ADSL. As an example, a flag (ACEMEDFL) could be added for ACE inhibitors. Another variable, body surface area indicating concomitant medication use of ACE inhibitors (ACEINHFL) was derived from CM. Body surface area at screening (BSASC), was derived from the VS dataset ( using height and weight ) at the screening visit and added to ADSL. Note that based on the dates shown in DM, the screening visit and visit 1 have occurred at the same dates for time in this example.

The ADCVNTP dataset includes tests pertinent to these analyses. The records from CV where CVTESTCD = "LVEF_C" and "RVEF_C" and the records from LB where LBTESTCD = "BNPPRONT" were selected. Many lab draws may occur throughout the year, but only those linked to a specific visit were included. By subsetting the LB dataset by LBLNKID not missing, laboratory data that aligns with CV data can be filtered out and sorted using USUBJID and VISIT. If LBLNKID is not available, a windowing strategy could be used to select the laboratory draw closest to that visit for merging with CV, computed in AVISIT.

The ADCVMR dataset is an efficacy analysis dataset with only a few records for more complex modeling of changes in ejection fraction, plus the ProB-type test results. It is an ADaM Basic Data Structure (BDS) dataset, with additional variables added from ADCVNTP.

...

This is a simplified example ADSL dataset; it is expected that additional variables for stratification, or of interest for analysis, would be includedthe Foundational standards are followed to include all the core variables. Analysis age was computed from date of birth and (AAGE) was computed to provide age with more precision.  The Body Surface Area (BSA) at screening is calculated for screening, and named BSASC as per the ADAMIG v1.2.  There are many possible calculations for BSA. For this example, the Du Bois method was used (footnote: https://www.calculator.net/body-surface-area-calculator.html),

Definexmltable
DatasetADSL
LevelVariable
PurposeAnalysis
NameVariable
Variable NameVariable LabelTypeCodelist/Controlled Terms/FormatSourceDerivation/Comment
STUDYIDStudy IdentifierChar

DM.STUDYID


USUBJIDUnique Subject IdentifierChar

DM.USUBJID


BRTHDTDate of BirthNumdate9.


Date portion of DM.BRTHDTC converted to numeric and displayed in a format such as date9.from ISO 8601 format to numeric date.9 
AAGEAnalysis AgeNum


Age as screening, computed by DM.RFICDTC - BRTHDTC as continuous variable. Note that some countries do not allow capturing date of birth, so this could be computed by capturing age in years and months on a CRF.
AGEAgeNum

DM.AGE


AGEUAge UnitsCharYEARS

DM.AGEU


SEX

SexChar(SEX)

DM.SEX


RACE

RaceNum(RACE)

DM.RACE


TRTSDTDate of First Exposure to TreatmentNumdate9.
Date portion of DM.RFSTDTC converted to numeric and displayed in a format such as date9.
RFICDT

Date of Informed Consent

Numdate9.
Date portion of DM.RFICDTC converted to numeric and displayed in a format such as date9.
DTHDT

Date of Death

Numdate9.
Date portion of DM.RFSTDTC converted to numeric and displayed in a format such as date9.
DTHFL

Subject Death
Flag

CharYDM.DTHFL
TRT01P

Planned Treatment for Period 01

CharDrug A, Drug B
Predecessor; DM.ARM. May be changed to lower case or more descriptive term for use in tables and listings.
TRT01A

Actual Treatment for Period 01

CharDrug A, Drug B
Predecessor; DM.ACTARM. Note: Actual treatment  matches planned treatment unless there is a reason subject does not take planned drug.

ITTFL

Intent-To-Treat Population Flag

Char

Y; N


Derive the intent-to-treat population as per the protocol and SAP.

ACEINHFL

ACE Inhibitor Medications Flag

Char

Y; N


Select a list of ACE inhibitor medications from concomitant medications (CM) domain , and from treatment (EX or EC) domains as as per Statistical Analysis Plan or Protocol. Code Set to "Y" if the medication was these medications were taken during the study, and "N" if they are absent. Can be used to subset or to exclude the population who took ACE inhibitors.

HEIGHTSC

Height (cm) at Screening

Num



Set to VS.VSSTRESN where VS.VSTESTCD = "HEIGHT" and VISITNUM= 1 (or screening visit for your study).

WEIGHTSC

Weight (kg) at Screening

Num



Set to VS.VSSTRESN where VS.VSTESTCD = "WEIGHT" and VISITNUM = 1 (or screening visit for your study).

BSASC

Body Surface Area at Screening

Num



Select where VISITNUM = 1 (or screening visit for your study). Compute from HEIGHT and WEIGHT, using the Du Bois method. BSA = 0.007184 × W0.425 × H0.725

Note that there are multiple methods and the study protocol should describe which one to use (e.g., Du Bois, Mosteller, Haycock, Gehan & George, Boyd, Fujimoto, Takahira, and Schlich).

Dataset wrap
Showtrue
NameADSL
Dataset2
tableidadsl
RowSTUDYIDUSUBJIDBRTHDTAAGEAGEAGEUSEXRACETRTSDT
RFICDTC
RFICDTDTHDTDTHFLTRT01PITTFLACENHFLHEIGHTSCWEIGHTSCBSASC
1DMD-EFLGEDMD-EF-01-10107FEB201012.312YEARSMBLACK OR AFRICAN AMERICAN16JUN202216JUN2022

Drug AYY119200.82
2DMD-EFLGEDMD-EF-01-10101MAY200814.114YEARSMASIAN13JUN202213JUN2022

Drug AYY115300,95
3DMD-EFLGEDMD-EF-01-10110JUL200319.019YEARSMNATIVE HAWAIIAN OR OTHER PACIFIC ISLANDER15JUL2202215JUL2022

Drug BYN140451,30
4DMD-EFLGEDMD-EF-01-10115JAN199923.723YEARSMWHITE06SEP202206SEP202223NOV2023YDrug BYY132421,21

ADCVNTP Analysis Dataset

In this example, columns for derived variables BASE, CHG, PCHG and CHGCAT1 have been added to facilitate analyses of the efficacy endpoints. Specifically, example demographic data for ADSL were created for an 8 year old male. Also, a custom variable for BSA at baseline (BSABL), and an example of a stratification variable for subjects with was added from ADSL.

...

Definexmltable
DatasetADCVNTP
LevelVariable
PurposeAnalysis
NameVariable
ADSLBSASC
Variable NameVariable LabelTypeCodelist/Controlled Terms/FormatSourceDerivation/Comment
STUDYIDStudy IdentifierChar

CV.STUDYID


USUBJIDUnique Subject IdentifierChar

CV.USUBJID

Select for records with RE data.


BRTHDTDate of BirthNumDate9.

ADSL.BRTHDT


AAGEAGEAnalysis AgeNum

ADSL.AAGE


AGEUAge UnitCharYEARS

ADSL.AGEU


TRTSDT

SEX

RFICDTSexChar(SEX)

DM.SEX


RACE

RaceNum(RACE)

DM.RACE


TRTSDT

Date of First Exposure to Treatment

Numdate9ADSL.TRTSDT
TRT01P

Planned Treatment for Period 01

CharDrug ATRT01P

Planned Treatment for Period 01

CharDrug A, Drug BADSL.TRT01P
TRT01A

Actual Treatment for Period 01

CharDrug A, Drug BADSL.TRT01A

ITTFL

Intent-To-Treat Population Flag

Char

Y; N

ADSL.ITTFL


BSASCBody Surface Area at ScreeningNum


ADSL.BSASC


HEIGHT

Height (cm

HEIGHT

Height (cm)

Num



Set to VS.VSSTRESN where VS.VSTEST = "HEIGHT" and merge   by visit.

WEIGHT

Weight (kg)

Num



Set to VS.VSSTRESN where VS.VSTEST = "WEIGHT" and merge   by visit.

BSASCBody Surface Area at ScreeningNum

.

BSABody Surface Area (m2)Num



Compute from HEIGHT and WEIGHT at each visit, using the Du Bois method. BSA = 0.007184 × W0.425 × H0.725

Note that there are multiple methods and the study protocol should describe which one to use (e.g., Mosteller, Haycock, Gehan & George, Boyd, Fujimoto, Takahira, and Schlich).

ACEINHFL

ACE Inhibitor Medications Flag

Char

Y; N

ADSL.ACEINHFL


PARAMParameterChar

Left Ventricular Ejection Fraction, Calculated (%);

Right Ventricular Ejection Fraction, Calculated (%);

N-Terminal ProB-type Natriuretic Peptide (pg/mL)


For tests from CV, set to the values of CV.CVTEST plus CV.CVTESTU with spaces and parentheses as shown. 

For tests from LB, set to the value of LB.LBTEST plus LB.LBTESTU with spaces and parentheses as shown. 

PARAMCDParameter CodeChar

LVEF_C;

RVEF_C;

BNPPRONT

If CV.CVTESTCD = "LVEF_C" then PARAMCD = "LVEF_C"

If CV.CVTESTCD = "RVEF_C" then PARAMCD = "RVEF_C"

If LB.LBTESTDC = "BNPPRONT" then PARAMCD = "BNPPRONT"

LB.LBTESTCD

NoteNote: for this example dataset, select the records where the test values shown above at left are included.

PARAMNParameter (N)Num



Number PARAMCD as follows:

LVEF_C = "1"

RVEF_C = "2"

BNPPRONT = "3"

AVALAnalysis ValueNum


See Parameter Value List 

AVISITAnalysis VisitChar

Visit 1 (Baseline)

Visit 6 (1 Year)


If CV.VISIT = "VISIT 1" then AVISIT = "Visit 1 (Baseline)".

Else if CV.VISIT = "VISIT 6" then AVISIT = "Visit 6 (1 Year)".

AVISITNAnalysis Visit (N)Num1, 6

CV.VISITNUM

LB.VISITNUM


VISITVisitNum

VISIT 1

VISIT 6

CV.VISIT

LB.VISIT


ADTAnalysis DateNumdate9.
Date portion of CV.CVDTC or LB.LBDTC converted to numeric and displayed in a format such as date9. 
ABLFLBaseline Record FlagCharY

If CV.VISIT = "VISIT 1" then ABLFL = "Y".

BASEBaseline ValueNum

Set BASE to AVAL from the record for that subject and parameter where ABLFL = "Y".

Populate BASE for additional visits by merging the value of BASE in the baseline record by USUBJID and PARAMCD.

CHGChange from BaselineNum

Compute CHG = AVAL - BASE for that record. Only compute for post-baseline records.
PCHGPercent Change from BaselineNum

Compute PCHG = (CHG / BASE) * 100. Only compute for post-baseline records.
CHGCAT1Change from Baseline Category 1Char

Decline >=5% ; Decline <5%

Increase GT 100 pg/mL



See PVLM table.
SRCDOMSource DataChar

CV; LB


Set to the SDTM domain name that relates to the analysis value.
SRCVARSource VariableChar



Set to the SDTM variable that relates to the analysis value.
SRCSEQSource Sequence NumberNum


CV.CVSEQ

LB.LBSEQ

Set to the SDTM domain sequence number that relates to the analysis value.

Efficacy Analysis Example 1

This example dataset shows the findings and additional analysis variables associated with:

...

Dataset wrap
Showtrue
Nameadcvntp
Rowcaps
Rows 1-2:Show the baseline ejection fraction measurements at VISIT 1.
Row 3:Shows the baseline N-Terminal ProB-type Natriuretic Peptide test results at VISIT 1.
Rows 4-5:Show the baseline ejection fraction measurements at VISIT 6.
Row 6:Shows the baseline N-Terminal ProB-type Natriuretic Peptide test results at VISIT 6.
Dataset2
tableidadcvntp
RowSTUDYIDUSUBJID
BRTHDT
AGEAGEUSEXRACETRT01PTRT01AITTFLBSASCHEIGHTWEIGHTBSAACEINHFLPARAMPARAMCDPARAMNAVALAVISITAVISITNVISITADTABLFLBASECHGPCHGCHGCAT1SRCDOMSRCVARSRCSEQ
1DMD-EFLGEDMD-EF-01-101
07FEB2010
12YEARSMBLACK OR AFRICAN AMERICANDrug ADrug AY0.8211920
1
0.
09
82YLeft Ventricular Ejection Fraction, Calculated (%)LVEF_C167Visit 1 (Baseline)1VISIT 116MAY2022Y67


CVCVTESTCD3
2DMD-EFLGEDMD-EF-01-101
07FEB2010
12YEARSMBLACK OR AFRICAN AMERICANDrug A
Y
Drug AY0.8211920
1
0.
09
82YRight Ventricular Ejection Fraction, Calculated (%)RVEF_C274Visit 1 (Baseline))1VISIT 116MAY2022Y74


CVCVTESTCD7
3DMD-EFLGEDMD-EF-01-101
07FEB2010
12YEARSMBLACK OR AFRICAN AMERICANDrug ADrug AY0.8211920
1
0.
09
82YN-Terminal ProB-type Natriuretic Peptide (IU/L)BNPPRONT340Visit 1 (Baseline)1VISIT 116MAY2022Y40


LBLBTESTCD1
4DMD-EFLGEDMD-EF-01-101
07FEB2010
12YEARSMBLACK OR AFRICAN AMERICANDrug ADrug AY0.82132321.
33
08YLeft Ventricular Ejection Fraction, Calculated (%)LVEF_C160Visit 6 (1 Year)6VISIT 606APR2023
67-7-10.447761Decline >=5.0%CVCVTESTCD11
5DMD-EFLGEDMD-EF-01-101
07FEB2010
12
Drug A
YEARS
Y132
MBLACK OR AFRICAN AMERICANDrug ADrug AY0.82132321.
33
08YRight Ventricular Ejection Fraction, Calculated (%)RVEF_C261Visit 6 (1 Year)6VISIT 606APR2023
74-13-17.567568Decline >=5.0%CVCVTESTCD15
6DMD-EFLGEDMD-EF-01-101
07FEB2010
12YEARSMBLACK OR AFRICAN AMERICANDrug ADrug AY0.82132321.
33
08YN-Terminal ProB-type Natriuretic Peptide (IU/L)BNPPRONT3900Visit 6 (1 Year)6VISIT 106APR2023
408602,150Increase GT 100 pg/mLLBLBTESTCD2

ADCVCMR Analysis Dataset

Efficacy Example 2

The dataset above can also be set up to provide multivariate analyses by taking the lab tests of interest , transposing and merging or other analysis datasets, and  merging variables of interest with the ADCVNTP dataset. In that case, the records from LB are not needed as a row. The stratification variables such as BSA and ACEINHFL are carried over, but not HEIGHTW or WEIGHTW which were used to compute BSA values.

/* remove this table and make sure description is above */

This summary dataset is created from other ADaM datasets as the source and only variable used in the analysis are kept. 

Definexmltable
DatasetADCVCMR
LevelValueVariable
PurposeAnalysis
OIDNameAVALVariable
DatasetValueWhere Variable 
Variable Name
Variable Label
ADCVCMRAVALPARAMCD = "BNPPRONT"BNPPRONTN-Terminal ProB-type Natriuretic Peptide (IU/L)ADCVCMRCHGPARAMCD = "BNPPRONT"BNPCHGN-Term ProB-type N Pep Change Category
TypeCodelist/Controlled Terms/FormatSourceDerivation/Comment
STUDYIDStudy IdentifierChar

ADCVNTP.STUDYID


USUBJIDUnique Subject IdentifierChar

ADCVNTP.USUBJID


BRTHDTDate of BirthNumDate9.

ADCVNTP.BRTHDT


AGEAgeNum

ADCVNTP.AGE


AGEUAge UnitCharYEARS

ADCVNTPL.AGEU


TRTSDT

Date of First Exposure to Treatment

Numdate9.ADCVNTP.TRTSDT
TRT01P

Planned Treatment for Period 01

CharDrug A, Drug BADCVNTP.TRT01P

ITTFL

Intent-To-Treat Population Flag

Char

Y; N

ADCVNTP.ITTFL


BSASCBody Surface Area at ScreeningNum


ADCVNTP.BSASC


BSABody Surface Area (m2)Num


ADCVNTP.BSA


ACEINHFL

ACE Inhibitor Medications Flag

Char

Y; N

ADCVNTP.ACEINHFL


BNPPRONT


Num



BNPPRONT = AVAL where PARAMCD =  ADCVNTP.BNPPRONT,  and merge by USUBJID and AVISITN. Note: there are many ways to add this including transposing the data.
PARAMParameterChar

Left Ventricular Ejection Fraction, Calculated (%);

Right Ventricular Ejection Fraction, Calculated (%);

N-Terminal ProB-type Natriuretic Peptide (pg/mL)

ADCVNTP.PARAM


PARAMCDParameter CodeChar

LVEF_C;

RVEF_C;

BNPPRONT

ADCVNTP.PARAMCD


PARAMNParameter (N)Num


ADCVNTP.PARAMN


AVALAnalysis ValueNum

ADCVNTP.AVAL


AVISITAnalysis VisitChar

Visit 1 (Baseline)

Visit 6 (1 Year)

ADCVNTP.AVISIT


AVISITNAnalysis Visit (N)Num1, 6

ADCVNTP.AVISITN


ADTAnalysis DateNumdate9.ADCVNTP.ADT
ABLFLBaseline Record FlagCharYADCVNTP.ABLFL


BASEBaseline ValueNum
ADCVNTP.BASE


CHGChange from BaselineNum
ADCVNTP.CHG
PCHGPercent Change from BaselineNum
ADCVNTP.PCHG
CHGCAT1Change from Baseline Category 1Char

Decline >=5% ; Decline <5%

Increase GT 100 pg/mL


ADCVNTP.CHGCAT1




Dataset2
tableidadcvcmr
RowSTUDYIDUSUBJIDASEQBRTHDTTRT01PTRT01AITTFLBSAACEINHFLBNPPRONTBNPCHGPARAMPARAMCDPARAMNAVALAVISITAVISITNVISITADTABLFLBASECHGPCHGSRCDOMSRCSEQCHGCAT1
1DMD-EFLGEDMD-EF-01-101107FEB201007FEB2010Drug ADrug AY10.0982Y40Left Ventricular Ejection Fraction, Calculated (%)LVEF_C170Visit 1 (Baseline)1VISIT 116MAY2022Y70CV3


2DMD-EFLGEDMD-EF-01-101207FEB201007FEB2010Drug ADrug AY10.0982Y40Right Ventricular Ejection Fraction, Calculated (%)RVEF_C275Visit 1 (Baseline)1VISIT 116MAY2022Y75CV7


3DMD-EFLGEDMD-EF-01-101307FEB201007FEB2010Drug ADrug AY1.3308Y9002150Left Ventricular Ejection Fraction, Calculated (%)LVEF_C165Visit 6 (1 Year)6VISIT 606APR2023
70-5-10.447761CV11Decline >=5.0%
4DMD-EFLGEDMD-EF-01-101407FEB201007FEB2010Drug ADrug AY1.3308Y9002150Right Ventricular Ejection Fraction, Calculated (%)RVEF_C270Visit 6 (1 Year)6VISIT 606APR2023
75-5-17.567568CV15Decline >=5.0%

Example Analysis Results Metadata (ARM) Tables

...