Acquire Noldus Experiment Statement

 [/h/]Ethv
   [/h/]iFile[=file_name]
   [[/h/]Sint[=sampling_interval]]
   [[/h/]AscFac[=area_scaling_factor]]
   [[/h/]wCols[=window_columns]]
   [[/h/]wRows[=window_rows]]
   [[/h/]RowBrk[=row_breaks]]
   [[/h/]GapEnds[=gap_ends]]
   [[/h/]Exp[=exp_name]]
   [[/h/]BehavStop[=key_map]]
   [[/h/]BehavExcl[=key_map]]

Type conventions and statement syntax are explained in the Glossary.

Parameters...

iFile
File parameter indicating the Noldus™ EthoVision 2.3 workspace (.EWS) file or EthoVision DOS experiment (.EXP) file to import from. Must be specified, there is no default.

Sint
Number parameter indicating a sampling interval. Default is 0.24. This parameter is only considered during import from EthoVision DOS.

AscFac
Number parameter indicating an area scaling factor for the import of object surface area. Default is 1. This parameter is only considered during import from EthoVision 2.3. A value of 1 will import object surface area in pixels. A value of 0.1366 tranforms object surface area to EthoVision DOS pixels.

wCols
Number parameter indicating the number of columns of trials to be displayed at a time in the created case document.

wRows
Number parameter indicating the number of rows of trials to be displayed at a time in the created case document.

RowBrk
Range parameter listing all trials which are to appear at the beginning of a new row in the created case document. By default all trials are placed in one single row.

GapEnds
Range parameter listing all trials at which the experiment may resume after skipping a series of trials. This parameter helps to prevent inappropriate "gap ahead", "gap behind", "truncation ahead", "truncation behind", and "trial out of range" error messages during import of data from experiments in which animals typically perform only part of the possible trials, e.g. in training to criterion schedules.

Exp
Name parameter specifying the name of the Noldus EthoVision 2.3 experiment to import from. This parameter is ignored during import from EthoVision DOS.

BehavStop
Name parameter specifying the key map to import behaviors that were recorded with the EthoVision 2.3 manual event recorder using the Start/Stop method. To map them to the Wintrack event keys F1-12 or Space, use the syntax indicated by the following example: groom=F1,rear=F2,off=Space. Please note that the field text must not contain spaces. Behavior names must be identical to the ones defined in EthoVision. Type none if you do not want to import any such behaviors. This parameter is ignored during import from EthoVision DOS.

BehavExcl
Name parameter specifying the key map to import behaviors that were recorded with the EthoVision 2.3 manual event recorder using the Mutually Exclusive method. This parameter is used in the same way as the parameter BehavStop and is ignored as well during import from EthoVision DOS.

Additional information...

• See the topics Acquire EthoVision Experiment command and Case Properties command for basic information on the commands.
• See the topics Acquire EthoVision Experiment dialog and Case Properties dialog for details on the two associated dialog boxes.
• 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