Import Route Recorder statement

 [/h/]Irrc
   [/h/]iFile[=file_name]
   [/h/]cFile[=file_name]
   [[/h/]tBeg[=recorder_start_time]]
   [[/h/]tRel[=animal_release_time]]
   [[/h/]tEnd[=arrival_time]]
   [[/h/]Smooth[=smooting_frame]]
   [[/h/]Sint[=sampling_interval]]
   [/h/]Rect[=release_target_coord]
   [/h/]fCrit[=min,max,rep]
   [/h/]rCrit[=min,max,rep]
   [[/h/]Fmat[=Norm|Fit|Max|Min|None]]
   [[/h/]Optn[=Edit-Raw-Dir]]

Type conventions and statement syntax are explained in the Glossary.

Parameters...

iFile
File parameter indicating the file containing the route recorder data. Must be specified, there is no default.

cFile
File parameter indicating the ASCII or binary table file containing the calibration for the recorder device. Must be specified, there is no default. Expected file extension are .TAB or .BIN.

tBeg
Time parameter indicating the time when the recorder was started. Default = 00:00:00.

tRel
Time parameter indicating the time when the animal was released. Default = 00:00:00.

tEnd
Time parameter indicating the time when the animal arrived at the target site. Default = 00:00:00 = infer from end of data.

Smooth
Number parameter indicating the smoothing frame used for running average smoothing of the recorder raw data and/or built xy path data. Default = 4s.

Sint
Number parameter indicating the sampling interval. Default = 4s.

Rect
Array parameter indicating the coordinates of the release and target site. Four numbers are expected in the following order: x-coordinate of release, y-coordinate of release, x-coordinate of target, y-coordinate of target. There is no default for this parameter.

fCrit
Array parameter indicating the criteria for flight phases. There is no default for this parameter. Three integer numbers are expected in the following order:

• lower limit for direction change since previous sample,
• upper limit for direction change since previous sample,
• number of subsequent points which must fall within the direction change limits for a new phase to begin.

rCrit
Array parameter indicating the criteria for resting phases. There is no default for this parameter. Three integer numbers are expected. Their meaning and order is analogous to that in the fCrit parameter.

Fmat
Radio button parameter indicating the size of the new window. Default = Norm, else any of the following options:

• Norm = default size assigned by Windows™,
• Fit = automatic fit of data to be shown,
• Max = maximize window,
• Min = minimize as icon,
• None = do not display a window.

Optn
Check box parameter indicating execution options. None deselects all options (and is the default) else specify any combination of the following options:

• Edit = allow editing of data during import,
• Raw = smooth built path (xy coordinates) using soothing frame specified in parameter Smooth,
• Dir = smooth raw data (direction values) using soothing frame specified in parameter Smooth.

Note that...

The values specified as release and target coordinates must fit within the currently loaded setup. Good results should be obtained in most cases when setting fCrit=5,360,5 and rCrit=0,5,5 and also smoothing both path and raw data with a 12s window (Optn=Raw,Dir and Smooth=12). During resting periods, direction changes are typically 0° with occasional moves not exceeding 5°.

Additional information...

• See the topic Import Route Recorder command for basic information on the command.
• Managing setup files provides in depth information on the management of setups.
• Inside case documents provides advanced information on case documents.
• See Creating and using macros to learn how to use and create macros.
• There are lists of all available macro statements and menu commands.