Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Fixed example link

...

The GroupingFactor class is used in the reporting event's analysisGroupings

Jira
showSummaryfalse
serverIssue Tracker (JIRA)
serverId85506ce4-3cb3-3d91-85ee-f633aaaf4a45
keyARSP-28
attribute to define grouping factors, which are characteristics used to subdivide the subject population or analysis dataset records into groups for analysis. Examples of grouping factors include subject characteristics (such as sex or age group), planned or actual treatment, "system organ class" or "preferred term" in an adverse events analysis dataset, and "parameter" or "visit" in a vital signs analysis dataset. Each grouping factor may either contain a set of specified groups (e.g., “Male” and “Female” for a sex grouping) or be defined as "data-driven", where the group values are obtained from the data (e.g., "system organ class" or "preferred term" for adverse events).

Excerpt Include
ARSP:ER Diagram: GroupingFactor
ARSP:ER Diagram: GroupingFactor

...

Note

The ARS Model is designed to support the specification of analyses of data in ADaM datasets, which are expected to be "analysis-ready." In analysis-ready datasets, any complex criteria needed to specify predefined groups within grouping factors will usually have been applied to create specific grouping variables. These grouping variables can usually then be referenced in the specification of simple conditions, so compound expressions should generally not be required for the definition of predefined groups within grouping factors.

Example

Include Page
ARSP:analysisGroupings: Subject CharacteristicsSimple
ARSP:analysisGroupings: Subject CharacteristicsSimple

analysisGroupings: Dataset Records

Example
inlinetrue

See the WhereClauseCompoundExpression section for an example of predefined groups created as compound expressions containing instances of the ReferencedGroup class to reference other groups by identifier.

Include Page
analysisGroupings: Dataset Records

Once a grouping factor has been defined in the analysisGroupings attribute of the reporting event, it can be used in the specification of any analysis by including its identifier value in the groupingId attribute of 1 of the instances of the OrderedGroupingFactor class in the orderedGroupings attribute of the analysis. In general, grouping factors are defined with reference to a single grouping variable. However, multiple separate grouping factors may be referenced in the specification of an analysis, so it is possible to define analyses of subjects and data records that are grouped by multiple factors.

...