Wintrack

Analyze Case Document statement

 [/h/]Anly
   [[/h/]Name[=window_name]]
   [[/h/]iFile[=file_name]]
   [[/h/]Rprt[=None|New|Merge|Chain]]
   [[/h/]Vdef[=List|File]]
   [[/h/]Vsel[=tim-pth-fai-ier-aer-eff-awy-wsh-adg-qcg-wtm
    -ctm-jmp-spd-act-lat-imb-stp-rst-rtm-rdu-bur-bdu-tor
    -ssp-asp-cvr-cvl-qog-qrf-qct-qne-qnw-qsw-qse-xog-xrf
    -xct-xne-xnw-xsw-xse-cup-cdn-chn-pok-alt-rep-nov-mlt
    -rnd-ini]
   [[/h/]WinDur[=window_duration]]
   [[/h/]WinOff[=window_offset]]
   [[/h/]WinRef[=None|All|Beg|End]]
   [[/h/]Suffix[=variable_name_suffix]]
   [[/h/]Rang[=trial_range]]
   [[/h/]Block[=trial_block_size]
   [[/h/]Wall[wall_zone_width]
   [[/h/]Inner[inner_zone_width]
   [[/h/]Start[start_zone_radius]
   [[/h/]Goal[goal_zone_radius]
   [[/h/]Cdor[airline_corrdor_radius]
   [[/h/]Act[activity_threshold]

Type conventions and statement syntax are explained in the Glossary.

Parameters...

Name
Name parameter indicating the name of the case document to be affected by the command. Default: the topmost case document.

iFile
File parameter indicating the file name and location of the variable definition file to be processed. Wintrack variable definition files are expected to have the extension .VDF.

Rprt
Radio button parameter indicating how the results of the analysis should be reported. Default = None, else one of the following options:

None = do not create a report.

New = create a new scrollsheet to hold the results of the analysis.

Merge = merge the results into the topmost scrollsheet reusing existing columns as much as possible and overwriting any previous results of the same analysis. If the topmost scrollsheet contains incompatible data, a new one is created.

Chain = append the results to the topmost scrollsheet without reusing or overwriting any existing columns or rows. If the topmost scrollsheet contains incompatible data, a new one is created.

Vdef
Radio button parameter indicating how variables are defined. Default = None, else one of the following options:

List = analyze predefined variables specified by the List parameter Vsel.

File = analyze custom variables defined in the file specified by the parameter iFile.

Vsel
List parameter specifying a list of predefined variables which are to be analyzed. There is no default for this parameter, you must specify a selection of predefined variables whenever you set Vdef=List.

WinDur
Number parameter indicating the duration of the time window to be analyzed. The value is automatically adjusted if it exceeds the duration of the trial. There is no default, can only be omitted if WinRef=None.

WinOff
Number parameter indicating an offset for the time window to be analyzed. The offset is between the ends of window and trial or between the beginnings of trial and window as indicated by the WinRef parameter. There is no default, can only be omitted if WinRef=None.

WinRef
Radio button parameter indicating how the value of WinOff is to be interpreted. Default = None, else one of the following options:

None = don't change the time window and ignore WinOff and WinDur,

All = show entire path and ignore WinOff and WinDur,

Beg = WinOff is the time elapsing between the beginning of the trial and the beginning of the time window,

End = WinOff is the time elapsing between the end of the time window and the end of the trial.

Suffix
Text parameter specifying a suffix to be appended to all variable names defined in a custom variable definition file. Specify "None" (default) if you do not wish to add a suffix to variable names.

Rang
Range parameter indicating the range of trials to be affected by the command. By default all trials are considered. If Vdef=File, the effect of a trial range specification will depend on the type of variable defined in the custom variable definition file you are about to process. For trial variables, profile variables, and bullets it will simply determine which trials will be considered in the analysis. For surface variables, it will further restrict the trial ranges already specified in the variable definition, so that only trials included in both ranges will be considered. Case variables will remain unaffected by the setting.

Block
Number parameter indicating the size of the blocks into which the trials of the selected range are to be grouped. If you specify o for block size, Wintrack will analyze trial variables, else it will analyze case variables. In the latter case, all selected variables will be analyzed for every trial in the range and then averaged for each block of trials. Default = 2. This parameter is ignored for Vdef=File. In that case, Wintrack expects the trial blocks for case variables to be defined in the custom variable definition file.

Wall
Number parameter indicating the width of the wall zone. This parameter needs to be only specified for certain of the predefined variables. Default = 15cm.

Inner
Number parameter indicating the width of the inner or center zone. This parameter needs only to be specified for certain of the predefined variables. Default = 50cm.

Start
Number parameter indicating the radius of the start zone. This parameter needs only to be specified for certain of the predefined variables. Default = 30cm.

Goal
Number parameter indicating the radius of the goal zone. This parameter needs only to be specified for certain of the predefined variables. Default = 30cm.

Cdor
Number parameter indicating the radius of the air-line corridor leading from the start point to the goal. This parameter needs only to be specified for certain of the predefined variables. Default = 16cm.

Act
Number parameter indicating the activity threshold. Default = 0.06m/s.

Note that...

If you set Type=File, you need to specify a valid variable definition file name for iFile. If you set Type=List, you need to specify a selection of predefined variables for Vsel and specify appropriate values for the parameters WinDur through Act. The parameter Rprt needs to be specified in any case. Trial variables created by the Analyze Case command, have the same format as reports created by the Filter Case statement and both can be reported in the same scrollsheet document. If Type=File, Wintrack will scan the custom variable definition file for any Window statements without explicitly defined Begin and End parameters and supplement the missing parameters using the values from WinRef, WinDur, and WinOff. This will affect any case, trial, or surface variables that depend on those Window statements. Profile variables and bullets always refer to entire trials.

Additional information...

See the topic Analyze Case command for basic information on the command.
See the topic New Scrollsheet command for basic information on that command.
Managing setup files provides in depth information on the management of setups.
Managing variable definition files provides information on the management of variable definitions.
Inside case documents provides advanced information on case documents.
Inside scrollsheets provides advanced information on scrollsheets.
See Creating and using macros to learn how to use and create macros.
There are lists of all available macro statements and menu commands.