Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Changed "data grouping factor" to "grouping factor" (ARSP-28)

This example shows the definition of 2 grouping factors used to group records in analysis datasets4 grouping factors, each of which is represented as an instance of the GroupingFactor class within the analysisGroupings attribute of the reporting event.

Xfancy
classrowcaps
Lines 2-2729:

Show the attributes of the instance of the GroupingFactor class for the first grouping factor, "Vital Signs ParameterSex" (line 3), which is defined as being based on the ADVS PARAMCD ADSL SEX grouping variable (lines 4 and 5). The grouping factor is not data-driven (line 6), so the groups attribute is included (line 7) and contains 2 predefined groups, each specified as a simple condition represented as an instance of the Group class:

  • Lines 8-17: Show the first predefined group (order = 1), which is identified as "AnlsGrouping_05_Sex_1", named as "Female" (line 9), labeled as "F" (line 10), and contains a simple condition specifying that the value of the SEX variable in the ADSL dataset is equal to "F", which could be expressed as:
    • ADSL.SEX EQ 'F'
  • Lines 18-27: Show the second predefined group (order = 2), which is identified as "AnlsGrouping_05_Sex_2", named as "Male" (line 20), labeled as "M" (line 21), and contains a simple condition specifying that the value of the SEX variable in the ADSL dataset is equal to "M", which could be expressed as:
    • ADSL.SEX EQ 'M'
Lines 30-34:

Show the attributes of the instance of the GroupingFactor class for the second grouping factor, "Country" (line 31), which is defined as being based on the ADSL COUNTRY grouping variable (lines 32 and 33). The grouping factor is data-driven (line 34), so the groups attribute is not included; the groups within this grouping factor are derived from the distinct values in the ADSL COUNTRY variable.

Lines 35-60:

Show the attributes of the instance of the GroupingFactor class for the first grouping factor, "Vital Signs Parameter" (line 36), which is defined as being based on the ADVS PARAMCD grouping variable (lines 37 and 38). The grouping factor is not data-driven (line 39), so the groups attribute is included (line 40) and contains 2 predefined groups, each specified as a simple condition represented as an instance of the Group class:

  • Lines 41-50: Show the first predefined group (order = 1), which is identified as "AnlsGrouping_0403_Param_1", named as "Systolic Blood Pressure (mmHg)" (line 942), and contains a simple condition specifying that the value of the PARAMCD variable in the ADVS dataset is equal to "SYSBP", which could be expressed as:
    • ADVS.PARAMCD EQ 'SYSBP'
  • Lines 1851-2760: Show the second predefined group (order = 2), which is identified as "AnlsGrouping_0403_Param_2", named as "Diastolic Blood Pressure (mmHg)" (line 1952), and contains a simple condition specifying that the value of the PARAMCD variable in the ADVS dataset is equal to "DIABP", which could be expressed as:
    • ADVS.PARAMCD EQ 'DIABP'
Lines 2861-3265:

Show the attributes of the instance of the GroupingFactor class for the second grouping factor, "System Organ Class" (line 2962), which is defined as being based on the ADAE AESOC grouping variable (lines 30 63 and 3164). The grouping factor is data-driven (line 3265), so the groups attribute is not included; the groups within this data grouping factor are derived from the distinct values in the AESOC variable.

Code Block
titleYAML Example
linenumberstrue
analysisGroupings:
- id: AnlsGrouping_04_Param01_Sex
  name: Sex
  groupingDataset: ADSL
  groupingVariable: SEX
  dataDriven: false
  groups:
  - id: AnlsGrouping_01_Sex_1
    name: Female
    label: F
    level: 1
    order: 1
    condition:
      dataset: ADSL
      variable: SEX
      comparator: EQ
      value:
      - F
  - id: AnlsGrouping_01_Sex_2
    name: Male
    label: M
    level: 1
    order: 2
    condition:
      dataset: ADSL
      variable: SEX
      comparator: EQ
      value:
      - M
- id: AnlsGrouping_02_Cntry
  name: Country
  GroupingDataset: ADSL
  groupingVariable: COUNTRY
  dataDriven: true
- id: AnlsGrouping_03_Param
  name: Vital Signs Parameter
  groupingDataset: ADVS
  groupingVariable: PARAMCD
   groupsdataDriven: false
  groups:
  - id: AnlsGrouping_0403_Param_1
    name: Systolic Blood Pressure (mmHg)
    level: 1
    order: 1
    condition:
      dataset: ADVS
      variable: PARAMCD
      comparator: EQ
      value:
      - SYSBP
  - id: AnlsGrouping_0403_Param_2
    name: Diastolic Blood Pressure (mmHg)
    level: 1
    order: 2
    condition:
      dataset: ADVS
      variable: PARAMCD
      comparator: EQ
      value:
      - DIABP
- id: AnlsGrouping_0504_Soc
  name: System Organ Class
  groupingDataset: ADAE
  groupingVariable: AESOC
  dataDriven: true

These data grouping factors and their predefined groups could be represented in tabular form as shown in the following table where each instance of the Group class is represented on a separate line, with attribute values for the related instance of the GroupingFactor class represented on every row. If there are no predefined groups in the grouping factor (i.e., it is data-driven), a single row is shown with values only included for the GroupingFactor attributes.

Dataset2
idnamegroupingDatasetgroupingVariabledataDrivengroup_idgroup_namegroup_labellevelorderdatasetvariablecomparatorvalue
AnlsGrouping_01_SexSexADSLSEXFALSEAnlsGrouping_01_Sex_1FemaleF11ADSLSEXEQF
AnlsGrouping_01_SexSexADSLSEXFALSEAnlsGrouping_01_Sex_2MaleM12ADSLSEXEQM
AnlsGrouping_02_CntryCountryADSLCOUNTRYTRUE








AnlsGrouping_03_04_ParamVital Signs ParameterADVSPARAMCDFALSEAnlsGrouping_0403_Param_1Systolic Blood Pressure (mmHg)
11ADVSPARAMCDEQSYSBP
AnlsGrouping_0403_ParamVital Signs ParameterADVSPARAMCDFALSEAnlsGrouping_0403_Param_2Diastolic Blood Pressure (mmHg)
12ADVSPARAMCDEQDIABP
AnlsGrouping_0504_SocSystem Organ ClassADAEAESOCTRUE