Collapse statement

 Collapse
   Tgt=Ann
   Mode=Ave|Mdn|Var|Count|First|Last|Sum|Ons|Offs|OnOffs|AveSum|Repeat
    |Alternate|ChainUp|ChainDown|ChainAll|Visits|Novel|AllNovel|Favourite
   [Frame=frame_width]
   [Crit=criterion]

Type conventions and statement syntax are explained in the Glossary.

Collapses the active data matrix into a data array. Each element of the created data array stands for one column of the active data matrix, that is for one trial of the case document being analyzed. Wintrack can store up to 100 data arrays at a time.

Parameters...

Tgt
Name parameter indicating the target data array. Valid array names are A001 through A100. There is no default for this parameter.

Mode
Radio button parameter indicating the collapsing mode to be applied. There is no default for this parameter, specify one of the following options:

• Ave = calculate the average of the selected cells in each column.
• Mdn = calculate the median of the selected cells in each column.
• Var = calculate the variance of the selected cells in each column.
• Count = count the number of clusters of selected cells.
• First = of each column take the value of the first selected cell.
• Last = of each column take the value of the last selected cell.
• Sum = calculate the sum of the selected cells in each column.
• Ons = same as Count, but the first cluster is not counted if it begins with the very first data point of the trial.
• Offs = same as Count, but the last cluster is not counted if it ends with the very last data point of the trial.
• OnOffs = same as Count, but the first cluster is not counted if it begins with the very first data point of the trial and the last cluster is not counted if it ends with the very last data point of the trial.
• AveSum = calculate the local sum of every cluster of selected cells. Then take the average of these cluster sums.

Options intended for use with data matrices representing field entries (Matrix statement with Data=Field). Cell values are converted to integers and contiguous repetitions without interspersed deselected or empty cells are treated as one appearance = field visit:

• Repeat = in selected cells, count the number of repeatedly appearing values.
  Example: 11111 is no repetition, 11 - 11111 - - - - - 1 are two repetitions.
• Alternate = in selected cells, count the number of values appearing in alternation.
  Example: 1122 - - 111 are two alternations, 1122 - 1 - 22 are three alternations.
• ChainUp = in selected cells, count the number of values appearing in ascending sequence. Example: 11 - 22 is no chained cell, 11 - 2233 - 44 are three chained cells.
• ChainDown = in selected cells, count the number of values appearing in descending sequence.
• ChainAll = in selected cells, count the number of value appearing in descending or ascending sequence.
• Visits = in selected cells, count the number of value changes.
• Novel = in selected cells, count the number of appearing novel values.
  This option is intended for determining the number of first time visits.
• AllNovel = in selected cells, count the number of novel values appearing until the first reappearance of a value that has already occurred. This option is intended for determining the number of correct visits before the first working memory error.
• Favourite = in selected cells, count the number of appearances of the most frequently encountered value. This option is intended for determining the number of visits to the most frequently visited field..

Frame
Number parameter indicating the frame to be used for circular transformation of value differences. This parameter must be specified if Mode=Alternate, ChainAll, ChainUp, or ChainDown. Circular transformation is necessary if a range of fields is arranged in a circle, with for example the 40th field next to the first one. In this case set Frame=40 to inform Wintrack of this type of arrangement. If the arrangement of fields is linear, set Frame=0.

Crit
Number parameter that can be specified if Mode=ChainAll, ChainUp, or ChainDown. It specifies the number of vaules that must appear in ascending or descending sequence in order to be counted. Minimum and default = 2. Example: 11 - 2233 - 44 are three chained cells with Crit=2 or Crit=3, but give a count of 0 with Crit>3.

Note that...

You must execute the Matrix statement at least once to create an active data matrix and build a selection mask using the Include and/or Exclude statements, before you can use the Collapse statement. Collapsing does not actually destroy the active data matrix. You can collapse the same data matrix into more than one data array by executing the Collapse statement repeatedly. Once you have created data arrays, you can use them as a source to extract data values using the Extract statement, or as criteria for de/selecting cells in a data matrix using the Include and Exclude statements.

Additional information...

• Managing custom variable definition files provides general information on the management of custom variable definition files.
• The Flowchart of advanced data analysis gives a synopsis of data and variable types.
• There is a topic describing how to build a custom variable definition file.
• There is a list of all available variable definition statements.
• Using the Memory statement you can build collections of data matrices and selection masks for later reuse in other variables.
• See Analyze Case Document command for basic information on that command.
• Inside case documents provides advanced information on case documents.