You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

ADaM specifications in this guide are instructions for implementing the ADaM to build analysis datasets for representation of collected or derived data. ADaM dataset specifications for the TIG are provided in:

  • Section x.x, Specifications for Product Description
  • Section x.x, Specifications for Individual Health
  • Section x.x, Specifications for Population Health

Analysis Dataset Specifications list standard ADaM variables and define the required characteristics of standard variables (columns) that are frequently needed in ADaM datasets. The ADaM standard requires that these variable names be used when a variable that contains the content defined in ADD LINK Section 2.9.4 is included in any ADaM dataset, regardless of dataset class. It also requires these ADaM standard variables be used for the purposes indicated, even if the content of an ADaM variable is a copy of the content of an SDTM dataset variable.


Currently ADaM has three structures: ADSL, BDS, and OCCDS, which correspond to the SUBJECT LEVEL ANALYSIS DATASET, BASIC DATA STRUCTURE, and OCCURRENCE DATA STRUCTURE classes of ADaM datasets. Analysis datasets that follow the ADaM fundamental principles and other ADaM conventions, but which do not follow one of the three defined structures (ADSL, BDS, OCCDS), are considered to be ADaM datasets with a class of ADAM OTHER. 




The columns in an ADaM dataset specification table are:




1Variable NameSpecifies the name of the variable in the resulting dataset.
2Variable LabelSpecifies a descriptive label for the variable. 
3Type

Specifies the data type of the variable. Values for in this column are:

  • Num for numeric data
  • Char for character or alphanumeric data
4Controlled Terms, Codelist, or Format

Specifies applicable controlled terminology or formats with which to populate the variable. Values in this column are:

  • Names of one or more CDISC Controlled Terminology codelists with each codelist name in paratheses.
  • Short references to an external terminology (e.g., MedDRA)
  • The name of an external ISO 8601 format.
5Core

Specifies expectations for inclusion of the variable in the resulting dataset. Values in this column are:

  • Req for variables which are Required and must be included in the resulting dataset - however unlike SDTM a required variable may be null for any record. 
  • Cond for variables which must be included in the dataset in certain circumstances.
  • Perm for variables for which it is Permissible to include or exclude the variable from the resulting dataset. 
6CDISC Notes

Provides additional context for the intended use of the variable and may include:

  • A description of the purpose of the variable and/or what the variable means. 
  • Guidelines for variable use including rules for when or how the variable should be populated, or how the contents should be formatted.
  • Example values which could appear in the variable. Such values are intended to support understanding and are not intended to influence decisions regarding what values must be captured in the variable.

1Variable NameSpecifies the name of the variable in the resulting dataset.
2Variable LabelSpecifies a descriptive label for the variable. 
3Type

Specifies the data type of the variable. Values for in this column are:

  • Num for numeric data
  • Char for character or alphanumeric data
4Controlled Terms, Codelist, or Format

Specifies applicable controlled terminology or formats with which to populate the variable. Values in this column are:

  • Names of one or more CDISC Controlled Terminology codelists with each codelist name in paratheses.
  • Short references to an external terminology (e.g., MedDRA)
  • The name of an external ISO 8601 format.
5Core

Specifies expectations for inclusion of the variable in the resulting dataset. Values in this column are:

  • Req for variables which are Required and must be included in the resulting dataset - however unlike SDTM a required variable may be null for any record. 
  • Cond for variables which must be included in the dataset in certain circumstances.
  • Perm for variables for which it is Permissible to include or exclude the variable from the resulting dataset. 
6CDISC Notes

Provides additional context for the intended use of the variable and may include:

  • A description of the purpose of the variable and/or what the variable means. 
  • Guidelines for variable use including rules for when or how the variable should be populated, or how the contents should be formatted.
  • Example values which could appear in the variable. Such values are intended to support understanding and are not intended to influence decisions regarding what values must be captured in the variable.
  • No labels