Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Changed reference to DataGroupingFactor, DataGroup and dataGroupings to GroupingFactor, Group and analysisGroupings (ARSP-28) and added groupingDataset (GitHub #187)

This example shows the definition of 2 data grouping factors, each of which is represented as an instance of the DataGroupingFactor class within the dataGroupings attribute of the reporting eventgrouping factors used to group records in analysis datasets.

Xfancy
classrowcaps
Lines 2-627:

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

  • Lines 78-1617: Show the first predefined group (order = 1), which is identified as "DataGroupingAnlsGrouping_0104_Param_1", labeled named as "Systolic Blood Pressure (mmHg)" (line 89), 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 1718-2627: Show the second predefined group (order = 2), which is identified as "DataGroupingAnlsGrouping_0104_Param_2", labeled named as "Diastolic Blood Pressure (mmHg)" (line 1819), 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 2728-3032:

Show the attributes of the instance of the DataGroupingFactor GroupingFactor class for the second subject grouping factor, "System Organ Class" (line 2829), which is defined as being based on the ADAE AESOC grouping variable (line 29lines 30 and 31). The grouping factor is data-driven (line 3032), 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
dataGroupingsanalysisGroupings:
- id: DataGroupingAnlsGrouping_0104_Param
  dataDriven: false
  labelname: Vital Signs Parameter
  groupingDataset: ADVS
  groupingVariable: PARAMCD
  groups:
  - id: DataGroupingAnlsGrouping_0104_Param_1
    labelname: Systolic Blood Pressure (mmHg)
    level: 1
    order: 1
    condition:
      dataset: ADVS
      variable: PARAMCD
      comparator: EQ
      value:
      - SYSBP
  - id: DataGroupingAnlsGrouping_0104_Param_2
    labelname: Diastolic Blood Pressure (mmHg)
    level: 1
    order: 2
    condition:
      dataset: ADVS
      variable: PARAMCD
      comparator: EQ
      value:
      - DIABP
- id: DataGroupingAnlsGrouping_0205_Soc
  labelname: 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 DataGroup Group class is represented on a separate line, with attribute values for the related instance of the DataGroupingFactor 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 DataGroupingFactor GroupingFactor attributes.

Dataset2
idnamegroupingDatasetlabelgroupingVariabledataDrivengroup_idgroup_labelnamelevelorderdatasetvariablecomparatorvalue
DataGroupingAnlsGrouping_0104_ParamVital Signs ParameterADVSPARAMCDFALSEDataGroupingAnlsGrouping_0104_Param_1Systolic Blood Pressure (mmHg)11ADVSPARAMCDEQSYSBP
DataGroupingAnlsGrouping_0104_ParamVital Signs ParameterADVSPARAMCDFALSEDataGroupingAnlsGrouping_0104_Param_2Diastolic Blood Pressure (mmHg)12ADVSPARAMCDEQDIABP
DataGroupingAnlsGrouping_0205_SocSystem Organ ClassADAEAESOCTRUE