Transform Path statement

 [/h/]Tsfm
   [[/h/]Name[=window_name]]
   [[/h/]Rang[=trial_range]]
   [[/h/]Vers[=version_range]]
   [[/h/]Tlat[=dX,dY]]
   [[/h/]Scal[=fX,fY]]
   [[/h/]Rota[=angle]]
   [[/h/]CorrNE[=dx,dY,PtgtX,PtgtY,PnX,PnY,Rn]]
   [[/h/]CorrNW[=dx,dY,PtgtX,PtgtY,PnX,PnY,Rn]]
   [[/h/]CorrSE[=dx,dY,PtgtX,PtgtY,PnX,PnY,Rn]]
   [[/h/]CorrSW[=dx,dY,PtgtX,PtgtY,PnX,PnY,Rn]]

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 is the topmost case document.

Rang
Range parameter indicating the range of trials to be transformed. By default all trials in the case are deleted.

Vers
Range parameter indicating the range of versions to be affected. By default all versions are deleted. If an explicit range of versions is specified, case documents whose version is not part of that range will remain unaffected by the command.

Tlat
Array parameter indicating the translation vector. Two numbers are expected in the following order: dx = displacement in x-direction, dY = displacement in y-direction. All measures in m. Default = 0,0 = no translation.

Scal
Array parameter indicating the scaling factors. Two numbers are expected in the following order: fX = scaling factor in x-direction, fY = scaling factor in y-direction. The scale is changed relative to the maze center which itself does not change position. Default = 0,0 = no scaling.

Rota
Number parameter indicating the angle for a rotation around the arena center. Positive values lead to clockwise rotation. Default = 0 = no rotation.

CorrNE
Array parameter indicating the parameters for North East corner correction. Seven numbers are expected in the following order: dX = maximal displacement in x-direction, dY = maximal displacement in y-direction, PtgtX = x-coordinate of target corner point, PtgtY = y-coordinate of target corner point, PnX = x-coordinate of center of neutral zone, PnY = y-coordinate of center of neutral zone, Rn = radius of neutral zone. All measures in m. Point within the neutral zone are not changed. Outside this zone the translation distance increases with the distance from the neutral zone but never exceeds the specified maximum. Default = 0,0,0,0,0,0,0 = no corner correction.

CorrNW
Array parameter indicating the parameters for North West corner correction. Seven numbers are expected in the following order: dX = maximal displacement in x-direction, dY = maximal displacement in y-direction, PtgtX = x-coordinate of target corner point, PtgtY = y-coordinate of target corner point, PnX = x-coordinate of center of neutral zone, PnY = y-coordinate of center of neutral zone, Rn = radius of neutral zone. All measures in m. Point within the neutral zone are not changed. Outside this zone the translation distance increases with the distance from the neutral zone but never exceeds the specified maximum. Default = 0,0,0,0,0,0,0 = no corner correction.

CorrSE
Array parameter indicating the parameters for South East corner correction. Seven numbers are expected in the following order: dX = maximal displacement in x-direction, dY = maximal displacement in y-direction, PtgtX = x-coordinate of target corner point, PtgtY = y-coordinate of target corner point, PnX = x-coordinate of center of neutral zone, PnY = y-coordinate of center of neutral zone, Rn = radius of neutral zone. All measures in m. Point within the neutral zone are not changed. Outside this zone the translation distance increases with the distance from the neutral zone but never exceeds the specified maximum. Default = 0,0,0,0,0,0,0 = no corner correction.

CorrSW
Array parameter indicating the parameters for South West corner correction. Seven numbers are expected in the following order: dX = maximal displacement in x-direction, dY = maximal displacement in y-direction, PtgtX = x-coordinate of target corner point, PtgtY = y-coordinate of target corner point, PnX = x-coordinate of center of neutral zone, PnY = y-coordinate of center of neutral zone, Rn = radius of neutral zone. All measures in m. Point within the neutral zone are not changed. Outside this zone the translation distance increases with the distance from the neutral zone but never exceeds the specified maximum. Default = 0,0,0,0,0,0,0 = no corner correction.

Note that...

The order of execution is as flollows): linear translation, linear scaling, rotation, correction of corner distortions due to fisheye lenses (NE, NW, SE, SW). This command does not only change the appearance of the document, but actually physically modifies the path data. When using this command make sure you keep a copy of the original data.

Additional information...

• See Transform Path command for basic information on the command.
• 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.