SDTMIG v3.4 Metadata Check for Domain Specification Table 1.4.1

Metadata check macro is applied and detected no issues. This notice is provided as a visual reminder. It will be removed during final publication. Release Notes

Variable NameVariable LabelTypeControlled Terms, Codelist or Format1RoleCDISC NotesCore
STUDYIDStudy IdentifierChar
IdentifierUnique identifier for a study.Req
DOMAINDomain AbbreviationCharCPIdentifierTwo-character abbreviation for the domain.Req
USUBJIDUnique Subject IdentifierChar
IdentifierIdentifier used to uniquely identify a subject across all studies for all applications or submissions involving the product.Req
CPSEQSequence NumberNum
IdentifierSequence number to ensure uniqueness of subject records within a domain. May be any valid number.Req
CPGRPIDGroup IDChar
IdentifierUsed to tie together a block of related records in a single domain for a subject.Perm
CPREFIDReference IDChar
IdentifierInternal or external specimen identifier.Perm
CPSPIDSponsor-Defined IdentifierChar
IdentifierSponsor-defined reference number. May be preprinted on the CRF as an explicit line identifier or defined in the sponsor's operational database. Example: Line number on the lab page.Perm
CPLNKIDLink IDChar
IdentifierIdentifier used to link related records across domains. This may be a one-to-one or a one-to-many relationship.Perm
CPLNKGRPLink Group IDChar
IdentifierIdentifier used to link related records across domains. This will usually be a many-to-one relationship.Perm
CPTESTCDTest or Examination Short NameChar(CPTESTCD)TopicShort name of the measurement, test, or examination described in CPTEST. It can be used as a column name when converting a dataset from a vertical to a horizontal format. The value in CPTESTCD cannot be longer than 8 characters, nor can it start with a number (e.g., "1TEST" is not valid). CPTESTCD cannot contain characters other than letters, numbers, or underscores. Examples: "MONO", "MNS".Req
CPTESTName of Measurement, Test or ExaminationChar(CPTEST)Synonym Qualifier

Long name for CPTESTCD. For cell phenotyping, the name (often abbreviated) of the cell population, as it is generally accepted by the scientific community, is populated (rather than a colloquial designation based on a primary marker, e.g., TLym Help rather than CD4). When the test is for a sublineage which can only be identified by specifying additional markers (i.e., has not been given a name) or which is further restricted to a subpopulation based on a particular cell state (e.g., activated, proliferating, apoptotic), the Sublineage Marker String (CPSBMRKS), Cell State (CPCELSTA), and Cell State Marker String (CPCSMRKS) variables are additionally populated and the value in CPTEST is suffixed with "Sub" to denote that it is a subset of the population identified in CPTEST (e.g., Monocytes Sub).

The value in CPTEST cannot be longer than 40 characters.

Req
CPSBMRKSSublineage Marker StringChar
Variable Qualifier

Used to further subset the cell population identified in CPTEST based on the use of additional marker(s) that define a sublineage. The value in CPSBMRKS is used in combination with values in CPTEST and CPCELSTA to fully describe the cell population being measured. As such, it is an essential component of the full test name.

For example, three unnamed sublineages of monocytes have been identified as: CCR2+CD16-, CCR2-CD16+, and CCR2+CD16+. Whereas the entire monocyte cell population can be defined as CD14+ cells, the additional CCR2 and CD16 markers are used to differentiate one sublineage from another. As none of these sublineages have been given names, they are only known by the CCR2 and CD16 marker combinations. By associating the CPTEST value of "Monocytes Sub" with, for example, a value of "CCR2+CD16-" in CPSBMRKS, the full test is defined to be the CCR2+CD16- monocyte subpopulation.

Perm
CPCELSTACell StateChar(CELSTATE)Variable Qualifier

A textual description of a subset of the cell population identified in CPTEST based on a particular functional and/or biological state (e.g., "ACTIVATED", "PROLIFERATING", "SENESCENT"). When populated, the values in CPCELSTA and CPSMRKS, in combination with the values in CPTEST and CPSBMRKS, fully describe the cell population being measured.

Perm
CPCSMRKSCell State Marker StringChar
Variable Qualifier

Identifies the marker(s) or indicator(s) used to define the cell state (i.e., the value in CPCELSTA).

For example, when Ki67 expression is used to determine that a cell population is in a proliferating state (i.e., CPCELSTA value="PROLIFERATING"), the value "Ki67+" in CPCSMRKS indicates that positive expression of Ki67 was used to define the population as proliferating. Similarly, a value of "Ki67-" in CPCSMRKS would indicate that lack of expression of Ki67 defined the "NON-PROLIFERATING" cell state in CPCELSTA. The CPCSMRKS value is useful for quickly determining which marker(s) were used to classify (i.e., operationally define) a cell population based on a functional/biological state.

Perm
CPTSTCNDTest ConditionChar(TESTCOND)Variable Qualifier

Identifies any planned condition imposed by the assay system on the specimen at the time the test is performed. --TSTCND is generally used to distinguish between two or more records where the same assay is performed under varying (as opposed to fixed) conditions, usually for the purpose of making a comparison. For example, when the same assay (identified in --TEST) is performed under stimulated and non-stimulated conditions, the --TSTCND variable is used distinguish between the records.

Perm
CPCNDAGTTest Condition AgentChar
Record Qualifier

The textual description of the agent, if applicable, used to impose the condition identified in CPTSTCND. For example, records might be produced for the same assay run under stimulating (CPTSTCND value = "STIMULATED") conditions produced by different stimulating agents (e.g., phorbol myristate acetate, concanavalin A, PHA-P, TNF-alpha, Ionomycin, candida antigen).

Perm
CPBDAGNTBinding AgentChar
Record Qualifier

The textual description of the agent that is binding to the entity in the CPTEST variable. The CPBDAGNT variable is used to indicate that there is a binding relationship between the entities in the CPTEST and CPBDAGNT variables, regardless of direction.

The binding agent may be, but is not limited to, a test article; a portion of a test article; a substance related to a test article; an endogenous molecule; an allergen; an infectious agent; or a reagent (e.g., primary antibody) that confers the binding specificity for the measurement defined in CPTEST when it is needed to uniquely identify the test.

Perm
CPABCLIDAntibody Clone IdentifierChar
Record Qualifier

Identifies the antibody clone (e.g., supplier-provided catalog name) used to confer specificity for the binding agent specified in CPBDAGNT.

Perm
CPMRKSTRMarker StringChar
Record Qualifier

The text string identifying the full set of markers/indicators used by the laboratory to operationally define the complete test based on the combination of CPTEST, CPSBMRKS, and CPCELSTA. Because laboratories often use different markers/indicators to identify a cell population, the relationship between a named cell population in CPTEST (as combined with CPSBMRKS and CPCELSTA values) and the set of markers used to identify that population is many-to-one. To ensure nuances important for accurately interpreting the data are accounted for and which arise from the use of different sets of markers, it is necessary to operationally define the test in terms of the complete set of markers/indicators used to perform that test.

Exp
CPGATEGateChar
Record Qualifier

The sponsor-defined name assigned to a gate. Gates are electronic (i.e., a device setting or software-defined) boundaries set by a user to virtually parse a specimen into discrete populations based on a set of defined characteristics (e.g., presence, absence, or intensity of expression of various markers; physical size; internal complexity or granularity). Gates are used to constrain data collection or analysis to a specific cell population or region of interest within the specimen.

Perm
CPGATDEFGate DefinitionChar
Record Qualifier

The text string identifying the set of parameters and the order in which they are applied to define the gating strategy. In practice, a series of 2-dimensional sub-gates based on different cell characteristics (i.e., markers/indicators/physical properties) are most often combined until the cell population of interest is sufficiently resolved (i.e., electronically isolated) from other cell populations contained within the specimen.

For complex analyses, differences in gating strategies can produce subtle differences in results obtained for a test. To ensure nuances important for accurately interpreting the data are accounted for and which arise from the use of different gating strategies, it is often necessary to qualify the test in terms of the gating strategy. For some purposes, however, and at the discretion of the sponsor, only the ultimate or penultimate gate is identified. When specifying the gating strategy in CPGATDEF, each sub-gate should be listed in the order it was applied and separated from the next sub-gate using the pipe/vertical line ("|") character.

Perm
CPSPTSTDSponsor Test DescriptionChar
Record Qualifier

Sponsor's description of a test. The variable is intended to contain highly structured test description metadata used by a sponsor to unambiguously define (label) a test. Such values generally reside in a sponsor/laboratory test metadata repository. CPSPTSTD is not intended for unstructured (spontaneous) free text.

An example of appropriate usage is when it is necessary to include identifying information for a target cell population on which a test is conducted when the target population is not part of the test name, e.g., tests for quantitative expression of a particular marker on a specific cell population.

Perm
CPCATCategoryChar(CPCAT)Grouping QualifierUsed to define a category of topic-variable values across subjects. Examples: "IMMUNOPHENOTYPING", "CELL FUNCTION", "TARGET ENGAGEMENT".Perm
CPSCATSubcategoryChar
Grouping QualifierA further categorization of CPCAT.Perm
CPTSTPNLTest PanelChar
Grouping Qualifier

Sponsor-defined textual description used to group tests run together as part of a test panel. Can be used with --GRPID to ensure that relationships between associated tests are accurately identified.

Perm
CPORRESResult or Finding in Original UnitsChar
Result QualifierResult of the measurement or finding as originally received or collected.Exp
CPORRESUOriginal UnitsChar(UNIT)Variable QualifierOriginal units in which the data were collected. The unit for CPORRES. Examples: "10^6/L", "%", "MESF".Perm
CPRESSCLResult ScaleChar(RSLSCLRS)Record Qualifier

Classifies the scale of the original result value with respect to whether the result is quantitative, ordinal, nominal, or narrative.

Perm
CPRESTYPResult TypeChar(RESTYPRS)Record Qualifier

Classifies the kind of result (i.e., property type) originally reported for the test. Examples: "NUMBER CONCENTRATION", "NUMBER FRACTION", "RATIO".

Perm
CPCOLSRTCollected Summary Result TypeChar(COLSTYP)Record Qualifier

Used to indicate the type of collected summary result. This includes source summary results collected on a CRF or provided by an external vendor (e.g., central lab). If the summary result is derived using individual source data records, this summary result should be represented in ADaM. If a sponsor has both a collected summary result and a derived summary result, the collected summary result should be represented in SDTM and the derived summary result should be represented in ADaM.

Perm
CPORNRLOReference Range Lower Limit in Orig UnitChar
Variable QualifierLower end of reference range for continuous measurement in original units. Should be populated only for continuous results.Perm
CPORNRHIReference Range Upper Limit in Orig UnitChar
Variable QualifierUpper end of reference range for continuous measurement in original units. Should be populated only for continuous results.Perm
CPSTRESCResult or Finding in Standard FormatChar
Result QualifierContains the result value for all findings, copied or derived from CPORRES in a standard format or in standard units. CPSTRESC should store all results or findings in character format; if results are numeric, they should also be stored in numeric format in CPSTRESN.Exp
CPSTRESNNumeric Result/Finding in Standard UnitsNum
Result QualifierUsed for continuous or numeric results or findings in standard format; copied in numeric format from CPSTRESC. CPSTRESN should store all numeric test results or findings.Perm
CPSTRESUStandard UnitsChar(UNIT)Variable QualifierStandardized unit used for CPSTRESC or CPSTRESN.Perm
CPSTNRLOReference Range Lower Limit-Std UnitsNum
Variable QualifierLower end of reference range for continuous measurements for CPSTRESC/CPSTRESN in standardized units. Should be populated only for continuous results.Perm
CPSTNRHIReference Range Upper Limit-Std UnitsNum
Variable QualifierUpper end of reference range for continuous measurements in standardized units. Should be populated only for continuous results.Perm
CPNRINDReference Range IndicatorChar(NRIND)Variable Qualifier

Indicates where the value falls with respect to reference range defined by CPORNRLO and CPORNRHI, CPSTNRLO and CPSTNRHI, or by CPSTNRC. Examples: "NORMAL", "ABNORMAL", "HIGH", "LOW". Sponsors should specify in the study metadata (Comments column in the Define-XML document) whether CPNRIND refers to the original or standard reference ranges and results. CPNRIND should not be used to indicate clinical significance.

Perm
CPSTATCompletion StatusChar(ND)Record QualifierUsed to indicate that the test was not performed or that it was attempted but did not generate a result. Should be null if a result exists in CPORRES.Perm
CPREASNDReason Not DoneChar
Record QualifierDescribes why a test was not performed, e.g., "BROKEN EQUIPMENT", "SUBJECT REFUSED", "SPECIMEN LOST". Used in conjunction with CPSTAT when value is "NOT DONE".Perm
CPNAMVendor NameChar
Record QualifierThe name or identifier of the laboratory that performed the test.Perm
CPLOINCLOINC CodeCharLOINCSynonym QualifierCode for the test from the LOINC code system. The sponsor is expected to provide the dictionary name and version used to map the terms utilizing the Define-XML external codelist attributes.Perm
CPSPECSpecimen TypeChar(SPECTYPE)Record QualifierDefines the type of specimen used for a measurement. Examples: "BLOOD", "BONE MARROW".Perm
CPSPCCNDSpecimen ConditionChar(SPECCOND)Record QualifierThe physical state or quality of a specimen for an assessment. Example: "CLOTTED".Perm
CPMETHODMethod of Test or ExaminationChar(METHOD)Record QualifierMethod of the test or examination. Example: "FLOW CYTOMETRY".Perm
CPANMETHAnalysis MethodChar
Record QualifierAnalysis method applied to obtain a summarized result. Analysis method describes the method of secondary processing applied to a complex observation result.Perm
CPLOBXFLLast Observation Before Exposure FlagChar(NY)Record QualifierOperationally-derived indicator used to identify the last non-missing value prior to RFXSTDTC. The value should be "Y" or null.Perm
CPBLFLBaseline FlagChar(NY)Record QualifierIndicator used to identify a baseline value. The value should be "Y" or null.Perm
CPDRVFLDerived FlagChar(NY)Record QualifierUsed to indicate a derived record. The value should be "Y" or null. Records that represent the average of other records, or do not come from the CRF, or are not as originally received or collected are examples of records that might be derived for the submission datasets. If CPDRVFL = "Y", then CPORRES may be null, with CPSTRESC and (if numeric) CPSTRESN having the derived value.Perm
CPCLSIGClinically Significant, CollectedChar(NY)Record QualifierUsed to indicate whether a collected observation is clinically significant based on judgement.Perm
VISITNUMVisit NumberNum
TimingClinical encounter number. Numeric version of VISIT, used for sorting.Perm
VISITVisit NameChar
TimingProtocol-defined description of clinical encounter. May be used in addition to VISITNUM and/or VISITDY.Perm
VISITDYPlanned Study Day of VisitNum
TimingPlanned study day of the visit based upon RFSTDTC in Demographics. Should be an integer.Perm
TAETORDPlanned Order of Element within ArmNum
TimingNumber that gives the planned order of the element within the arm.Perm
EPOCHEpochChar(EPOCH)TimingEpoch associated with the start date/time of the observation, or the date/time of collection if start date/time is not collected.Perm
CPDTCDate/Time of CollectionCharISO 8601 datetime or intervalTimingDate/time of specimen collection represented in ISO 8601 character format.Exp
CPDYStudy Day of Visit/Collection/ExamNum
TimingStudy day of specimen collection, measured in integer days. Algorithm for calculations must be relative to the sponsor-defined RFSTDTC value in Demographics.Perm
CPTPTPlanned Time Point NameChar
TimingText description of time when a specimen is to be taken, as defined in the protocol. This may be represented as an elapsed time relative to a fixed reference point (i.e., to the value in CPTPTREF). Example: "1 hour post".Perm
CPTPTNUMPlanned Time Point NumberNum
TimingNumerical version of CPTPT to aid in sorting. When CPTPT is represented as an elapsed time relative to a fixed reference point (i.e., to the value in CPTPTREF), the values in CPTPTNUM should be assigned in ascending order relative to the value in CPTPTREF. For example, records for time points where CPTPT = "5 minutes post", 1 hour post", and "4 hours post" could be represented in CPTPTNUM as "1", "2", and "3", which maintains the order between CPTPT and CPTPTNUM with respect to the fixed time point reference in CPTPTREF.Perm
CPELTMPlanned Elapsed Time from Time Point RefCharISO 8601 durationTimingPlanned elapsed time relative to the planned fixed reference value in CPTPTREF, represented in ISO 8601 duration format. Examples: "-PT15M" to represent 15 minutes prior to the reference time point indicated by CPTPTREF, "T8H" to represent 8 hours after the reference time point represented by CPTPTREF.Perm
CPTPTREFTime Point ReferenceChar
TimingDescriptive name of the fixed reference point referred to by CPTPT, CPTPTNUM, and CPELTM. Examples: "PREVIOUS DOSE", "PREVIOUS MEAL".Perm
CPRFTDTCDate/Time of Reference Time PointCharISO 8601 datetime or intervalTimingDate/time for a fixed reference time point defined by CPTPTREF.Perm

1In this column, an asterisk (*) indicates that the variable may be subject to controlled terminology. CDISC/NCI codelist values are enclosed in parentheses.


  • No labels