...
The table below contains a list of standard suffix fragments (i.e., variable name fragments used as the last part of a variable name) that are required when naming variables in ADaM datasets, as defined in ADD LINK Section 3.1, ADaM Variable Conventions. For these fragments, it is a requirement that the appropriate fragment be used whenever the concept applies and that the fragment is reserved to be used only for the corresponding concept. For example, a variable whose name ends in DT must contain a numeric date, and a variable created to contain a numeric date must have a name ending in DT.
| Metadataspec |
|---|
Num | Fragment | CDISC Notes | 1 | GRy | Suffix used in names of grouping variables, where "y" refers to the grouping scheme or algorithm (not the category within the grouping). Note that GRy can be abbreviated to Gy when necessary to comply with the variable name length limit of 8 characters. The corresponding numeric version of the variable will use the suffix GRyN (or GyN if the Gy abbreviation is used). For more information on grouping variables see Section 3.1.1, General Variable Conventions. See Table 3.2.2 for examples of grouping variables. | 2 | FL | Suffix used in names of character flag variables, when the valid values of the variable are Y/null or Y/N/null. The corresponding numeric version of the variable will use the suffix FN. For more information on flag variables, see Section 3.1.1, General Variable Conventions, and Section 3.1.4, Flag Variable Conventions. See Table 3.2.3, Table 3.3.4.3.1, and Table 3.3.8.1 for examples of flag variables. | 3 | DT | Suffix used in names of numeric date variables. For more information on timing variables, see Section 3.1.2, Timing Variable Conventions. See Section 3.3.3, Timing Variables for BDS Datasets, for examples of timing variables. | 4 | TM | Suffix used in names of numeric time variables. For more information on timing variables, see Section 3.1.2, Timing Variable Conventions. See Section 3.3.3, Timing Variables for BDS Datasets, for examples of timing variables. Note that although ADaM variable ARELTM ends in TM, it is an exception, and is not a numeric time variable. In addition, the SDTM variables -- ELTM are not numeric time variables. | 5 | DTM | Suffix used in names of numeric datetime variables. For more information on timing variables, see Section 3.1.2, Timing Variable Conventions. See Section 3.3.3, Timing Variables for BDS Datasets, for examples of timing variables. | 6 | DTF | Suffix used in names of date imputation flag variables. Note that DTF can be abbreviated to DF to comply with the variable name length limit of 8 characters. For more information, see Section 3.1.3, Date and Time Imputation Flag Variables. See Section 3.3.3, Timing Variables for BDS Datasets, for examples of timing imputation variables. | 7 | TMF | Suffix used in names of time imputation flag variables. Note that TMF can be abbreviated to TF to comply with the variable name length limit of 8 characters. For more information, see Section 3.1.3, Date and Time Imputation Flag Variables. See Section 3.3.3, Timing Variables for BDS Datasets, for examples of timing imputation variables. | 8 | DY | Suffix used in names of relative day variables that do not include day 0. For more information on timing variables, see Section 3.1.2, Timing Variable Conventions. See Section 3.3.3, Timing Variables for BDS Datasets, for examples of timing variables. |
|
Additional Fragments that May Be Used in Naming ADaM Variables
The table below contains a list of additional standard reserved fragments to use as a guide when naming variables in ADaM datasets. This list should be used in addition to the list of timing fragments defined in ADD LINK Table 3.3.3.3 and the fragments defined in the SDTMIG. It should be noted that some concepts have slightly different fragments in ADaM than in the SDTMIG; the ADaM fragment takes precedence when creating an ADaM variable. When using fragments, the general rule is to use the fragment(s) that best conveys the meaning of the variable within the 8-character limit. This list of fragments is provided as a guideline, not as a requirement.
| Metadataspec |
|---|
Num | Fragment | CDISC Notes | 1 | BL | Baseline. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. Not to be used to support more than one baseline definition for AVAL in BDS datasets. See paragraph immediately following this table. | 2 | CHG | Change. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. Not to be used to support change from more than one baseline for AVAL in BDS datasets. See paragraph immediately following this table. | 3 | FU | Follow-up. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. | 4 | OT | On treatment. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. | 5 | RU | Run-in. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. | 6 | SC | Screening. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. | 7 | TA | Taper. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. | 8 | TI | Titer. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. | 9 | U | Units. The position of this fragment is at the end of the variable, as a suffix. To identify the units for a variable, a separate variable can be created, using the name of the original variable with a "U" suffix added. To keep within the 8-character variable name length limit, some truncation may be necessary prior to appending the U. In situations where the units do not vary within the ADaM dataset, it may be preferable to simply include the units in the variable's label and metadata. The approach taken will be determined by the producer, based on the requirements of the analysis and review of the dataset. Note that there is no separate units variable for BDS variables PARAM or AVAL, since the units of AVAL will be included in the value of PARAM. | 10 | WA | Washout. As described below, the position of this fragment within the variable name is dependent on the purpose of the variable. |
|