Memory statement

 Memory
   [Tgt=Mnn]
   [Sce=Mnn]
   Mode=All|Matrix|Sel
     |SelAdd|SelAnd|SelSub|SelXor|SelCand|SelCxor
     |MatrixAdd|MatrixSub|MatrixMult|MatrixDiv

Type conventions and statement syntax are explained in the Glossary.

Normally, Wintrack maintains a single active data matrix in memory which is overwritten each time you use the Matrix statement. Similarly, there is a single active selection mask to which all the Exclude and Include statements apply. All profile, trial, case or surface variables, as well as bullets are calculated using the active data matrix and selection mask. Used with its Tgt parameter, the Memory statement expands Wintrack's capabilities by allowing you to store the current data matrix and/or its selection mask. A collection of up to 100 data matrices and corresponding selection masks can be stored. They are referenced as M001 trough M100. Once stored, data matrices and selection masks become inactive, that is they are no longer altered by statements that affect the active data matrix or selection mask. Together with its Sce parameter, the Memory statement is used to recall any stored matrix, thereby altering the current content of the active data matrix and/or current selection mask.

Parameters...

Sce
Name parameter indicating the name of a source matrix. Valid matrix names are M001 through M100. There is no default for this parameter, but a name must only be specified if the Memory statement is used to recall a matrix from memory.

Tgt
Name parameter indicating the name of a target matrix. Valid matrix names are M001 through M100. There is no default for this parameter, but a name must only be specified if the Memory statement is used to store a matrix in memory.

Mode
Radio button parameter specifying what is to be stored or recalled. There is no default, specify one of the following options:

• All = store/recall both data matrix and corresponding selection mask
• Matrix = store/recall only data matrix
• Sel = store/recall only selection mask

The following options only be used if the Memory statement is used to recall a matrix from memory. They affect only the active selection mask and not the data matrix itself:

• SelAdd = recall only selection mask, performing an inclusive OR operation between the current and the recalled mask.
• SelAnd = recall only selection mask, performing an AND operation between the current and the recalled mask.
• SelSub = recall only selection mask, performing an AND operation between the current and the invertetd recalled mask.
• SelXor = recall only selection mask, performing an exclusive OR operation between the current and the recalled mask.
• SelCand = look for clusters of selected cells in the current selection mask. Keep only those clusters selected which DO overlap with selected cells in the selection mask that is to be recalled.
• SelCxor = look for clusters of selected cells in the current selection mask. Keep only those clusters selected which DO NOT overlap with selected cells in the selection mask that is to be recalled.

The following options can only be used if the Memory statement is used to recall a matrix from memory. They affect only the active data matrix and the outcome of the operation does not depend on the active election mask:

• MatrixAdd = recall data matrix by adding its values to the active data matrix.
• MatrixSub = recall data matrix by subtracting its values from the active data matrix.
• MatrixMult = recall data matrix by multiplying its values with the active data matrix.
• MatrixDiv = recall data matrix by dividing the active data matrix by its values.

Note that...

The actual number of matrices and selection masks that can be stored in memory depends on the amount of free memory available on the computer. Stored data matrices and selection masks remain available until overwritten by another Memory statement or until Wintrack terminates.

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.
• See Analyze Case Document command for basic information on that command.
• Inside case documents provides advanced information on case documents.