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

Compare with Current View Page History

« Previous Version 10 Next »

Description  TOBA-116 - Getting issue details... STATUS TOBA-186 - Getting issue details... STATUS TOBA-202 - Getting issue details... STATUS

A findings domain for representing results of testing performed on tobacco products or samples from tobacco products. PT is not a subject-level domain and is not used for results from testing products in human or animal subjects.


Specification

TIG v1.0 Metadata Check for SDTM Domain Specification Table Beta 3.2

Metadata check macro is applied. Make sure all Confluence WIKI macros e.g., JIRA, Status, are removed prior to publication. This notice is provided as a visual reminder. It will be removed during final publication. Release Notes

Variable NameVariable LabelTypeControlled Terms, Codelist, or FormatRoleCDISC NotesCore
STUDYIDStudy IdentifierChar
IdentifierUnique identifier for a study. Serves as a key to indicate that all datasets containing the same value of this variable are related by the purpose for which they were collected.Req
DOMAINDomain AbbreviationCharPTIdentifierTwo-character abbreviation for the domain.Req

SPTOBID

Applicant-Defined Tobacco Product IDChar
IdentifierIdentifier used to uniquely identify a tobacco product across all studies for all applications/submissions involving the product. In product description studies (i.e., where there are no human subjects) it is the top-level identifier.Req
IGDCMPIDIngredient or Component IdentifierChar
IdentifierIdentifier given to an ingredient, substance or component of a tobacco product (e.g., "Burley Tobacco", "Reconstituted Tobacco"). It originates in the IT or IN domain. See PT assumption 7a below for more information.Perm
STOCONIDApplicant-defined Storage Conditions IDChar
IdentifierApplicant-defined identifier for a set of storage conditions that are represented in the ES domain, where this identifier originates. See assumption 7b below for more information. (See also ES domain Specification and Assumptions for more information on the ES domain).Perm
PTSEQSequence NumberNum
IdentifierSequence number given to ensure uniqueness of subject records within a domain. May be any valid number.Req
PTGRPIDGroup IDChar


IdentifierUsed to tie together a block of related records in a single domain for a subject.Perm
PTREFIDReference IDChar
IdentifierInternal or external identifier. In PT it is used to represent a smoking regimen, and serves as a link to the Device-In Use Properties (DU) domain, where a matching value of DUREFID indicates parameters of the smoking regimen performed by the smoking machine.Perm

PTSPID

Applicant-Defined IdentifierChar
Identifier

Applicant-defined reference number. Can be used to identify an instance of an observation. Examples: a value pre-printed on a form; an identifier from the applicant's operational database.

Perm
PTTESTCDTest or Examination Short Name.Char

(PTTESTCD)

TopicShort name of the measurement or test described in PTTEST. It can be used as a column name when converting a dataset from a vertical to a horizontal format. The value in PTTESTCD cannot be longer than 8 characters, nor can it start with a number (e.g., "1TEST" is not valid). PTTESTCD cannot contain characters other than letters, numbers, or underscores. Examples: "NH4", "BENZ".Req
PTTESTTest or Examination NameChar(PTTEST)Synonym QualifierVerbatim name of the test or examination used to obtain the measurement or finding. The value in PTTEST cannot be longer than 40 characters. Examples: "Ammonia", "Benzene".Req
PTTSTDTLTest DetailChar
Record QualifierFurther description of the test performed in producing the PT result (e.g., "DRY WEIGHT BASIS" in HPHC testing or stability testing).Perm
PTCATCategory of TestChar

(PTCAT)

Grouping QualifierUsed to define a category of related records by purpose. Examples: "HPHC TESTING", "STABILITY TESTING", "DESIGN PARAMETER TESTING". Note: given the vast amount of data types that will use this domain, PTCAT is a required variable in the PT domain to differentiate and group the records by purpose.Req
PTSCATSubcategory of TestChar
Grouping QualifierA further categorization of a test category. Examples: "HPHC" (for constituents designated as HPHCs under PTCAT=HPHC TESTING), "OTHER" (for constituents like tar, which are categorized under PTCAT=HPHC TESTING but that are not formally designated HPHCs).Perm
PTORRESResult or Finding in Original UnitsChar
Result QualifierResult of the measurement or finding as originally received or collected.Exp
PTORRESUOriginal UnitsChar(UNIT)Variable QualifierOriginal units in which the data were collected. The unit for PTORRES. Example: "mg/mL".Exp

PTLLOD

Lower Limit of Detection

Char
Variable QualifierThe lowest threshold (as originally received or collected) for reliably detecting the presence or absence of substance measured by a specific test. The value for the field will be as described in documentation from the instrument or lab vendor.Perm
PTSTRESCCharacter Result/Finding in Std FormatChar
Result QualifierContains the result value for all findings, copied or derived from PTORRES in a standard format or standard units. PTSTRESC should store all results or findings in character format; if results are numeric, they should also be stored in numeric format in PTSTRESN. For example, if a test has results "NONE", "NEG", and "NEGATIVE" in PTORRES and these results effectively have the same meaning, they could be represented in standard format in PTSTRESC as "NEGATIVE". For other examples, see general assumptions.Exp
PTSTRESNNumeric Result/Finding in Standard UnitsNum
Result QualifierUsed for continuous or numeric results or findings in standard format; copied in numeric format from PTSTRESC. PTSTRESN should store all numeric test results or findings.Exp
PTSTRESUStandard UnitsChar(UNIT)Variable QualifierStandardized unit used for PTSTRESC or PTSTRESN.Exp
PTSTATCompletion StatusChar(ND)Record QualifierUsed to indicate exam not done. Should be null if a result exists in PTORRES.Perm
PTREASNDReason Test Not DoneChar
Record QualifierDescribes why a measurement or test was not performed, e.g., "BROKEN EQUIPMENT", or "SAMPLE LOST". Used in conjunction with PTSTAT when value is "NOT DONE".Perm
PTXFNExternal File PathChar
Record QualifierThe filename and/or path to external data not stored in the same format and possibly not the same location as the other data for a study. For example, when submitting lab methodology as a separate document, the name of the document or path to the file in the folder structure in the submission should be referred to in this variable.

Perm TOBA-185 - Getting issue details... STATUS

PTNAMVendor NameChar
Record QualifierThe name or identifier of the laboratory that performed the test.Perm
PTSPECSpecimen Material TypeChar(SPECPT)Record QualifierDefines the type of sample/matrix used for a measurement. Examples: "TOBACCO", "E-LIQUID", "SMOKE", "AEROSOL".Exp
PTSPCCNDSpecimen ConditionChar

(SPECCOND)

Record QualifierThe physical state or quality of a sample for an assessment. Examples: "AS-IS", "DRY WEIGHT BASIS".Perm
PTMETHODMethod of Test or ExaminationChar(METHOD)Record QualifierMethod used to arrive at the result of the test or examination. Not for representing smoking regimens or sample storage conditions. If lab methodology is too complex for this single variable, and supplemental lab documentation is instead submitted, a file name or path to such documentation should be included in the PTXFN variable instead.Perm
PTBLFLBaseline FlagChar(NY)Record QualifierIndicator used to identify a baseline value. Should be "Y" or null. Note that PTBLFL is retained for backward compatibility. The authoritative baseline for statistical analysis is in an ADaM dataset.Perm
PTDRVFLDerived 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 PTDRVFL = "Y", then PTORRES may be null, with PTSTRESC and (if numeric) PTSTRESN having the derived value.Perm
PTLLOQLower Limit of QuantitationNum
Variable QualifierThe lowest threshold for reliably quantifying the amount of substance measured by a specific test, in standardized units.Perm
PTULOQUpper Limit of QuantitationNum
Variable QualifierThe highest threshold for reliably detecting the result of a specific test in standardized units.Perm
PTREPNUMRepetition NumberNum
Record QualifierThe instance number of a test that is repeated within a given time frame for the same test performed. The level of granularity can vary (e.g., within a time point). Example: multiple measurements of tobacco product testing for a specific test.Perm
PTDTCDate/Time of Sample TestingCharISO 8601 datetime or intervalTimingDate/time of sample testing represented in ISO 8601 character format.Exp TOBA-343 - Getting issue details... STATUS
PTENDTCEnd Date/Time of Sample CollectionCharISO 8601 datetime or intervalTimingEnd date/time of sample collection represented in ISO 8601 character format. Used when I sample is collected over a period of time, and the length of time is deemed significant to the test or the interpretation if its result.Perm
PTTPTPlanned Time Point NameChar
Timing
  1. Text description of time when sample should be tested.
  2. This may be represented as an elapsed time relative to a fixed reference point, such as date of manufacture. See PTTPTNUM and PTTPTREF. Examples: "Week 12".
Perm
PTTPTNUMPlanned Time Point NumberNum
TimingNumerical version of PTTPT to aid in sorting.Perm
PTELTMPlanned Elapsed Time from Time Point RefCharISO 8601 durationTimingPlanned elapsed time (in ISO 8601) relative to a planned fixed reference (PTTPTREF). This variable is useful where there are repetitive measures. Not a clock time or a date/time variable. Represented as ISO 8601 duration. Example: "PT60D" to represent the period of 60 days after the reference point indicated by PTTPTREF.Perm
PTTPTREFTime Point ReferenceChar
TimingName of the fixed reference point referred to by PTELTM, PTTPTNUM, and PTTPT. Example: "DATE OF MANUFACTURE".Perm
PTRFTDTCDate/Time of Reference Time PointCharISO 8601 datetime or intervalTimingDate/time of the reference time point, PTTPTREF.Perm


Assumptions

  1. PT is used to represent the results of all testing of tobacco products. Examples of the types of testing that would be represented here include:
    1. Testing products for conformance to design parameter specifications
    2. Testing for harmful and potentially harmful constituents (HPHCs) in samples of the product
    3. Product stability study testing results
  2. PTCAT (Category of Test) is a required variable since the same analyte (same value of PTEST) may appear in more than one context. PTCAT differentiates the records in these cases (e.g., HPHC TESTING, STABILITY TESTING)
    1. PTSCAT can be used to further differentiate constituents.
    2. Constituents like tar, which are not formally designated HPHCs but which are tested along with designated HPHCs, should be categorized as "HPHC TESTING" with PTSCAT="OTHER".
  3. The original result of a test and its associated units are represented in PTORRES and PTORRESU, respectively. If the result is standardized to a different set of units, the standardized value and its units are represented in PTSRESC and PTSTRESU. Additionally, PTSRESN should be populated if the standard result is numeric.
    1. PTORRES, PTSTRESC and PTSTRESN are all Expected variables. PTSTRESN can be left null if the result is not numeric
    2. If the original results are not standardized to different units, the value in PTORRES should be carried over to PTSTRESC and PTSRESN (the latter is only used if numeric). The value in PTORRESU should be carried over into PTSTRESC. 
  4. The variable PTSPEC (Specimen Type) is used to represent the specimen matrix (e.g, E-LIQUID, TOBACCO, SMOKE, VAPOR).
  5. PTSPCCND (Specimen Condition) is used for conditions such as "AS-IS" or "DRIED".
  6.  When lab methodology is too complex for the single PTMETHOD variable, PTXFN should be used to reference a file name or path to a file in the application that describes the methodology used. Either PTMETHOD or PTXFN should be included in the data.
  7. The following Permissible identifiers can be used as follows:
    1. IGDCMPID is used when necessary to identify that a particular test was performed on a specific component of the tobacco product, and when this component would not be obvious without identifying it explicitly. For example, IGDCMPID is necessary when the same test is performed on 2 different components, such as 2 different types of tobacco in a leaf product.
    2. STOCONID is used in stability studies testing to identify the set of conditions under which the product being tested was stored. 

  • No labels