Text Language Definition

function T1Axis.ActualPosition:double;

Description

Actual Position returns the current position in User Units along an axis. On axes that are encoders this is the sensed position while for stepper motors this is the number of electrical pulses that have been emitted from the controller. Closed loop stepper motor outputs may differ from the Actual Position because of rotor deflecton. To know the position of a closed loop motor it is best to reference the actual position of the encoder on the motor. Actual Position is different from Commanded Position. Commanded Position is the calculated desired value of an axis coming from the motion profiler or other calculations that are directing motion. The value returned is in User Units.

Escapes

The Actual Position command does not generate any escapes.

Examples

This example shows the actual position of an axis in a message box style prompter:

This procedure records the position of the motor when a sensor event occurs:

A more accurate hardware Capture Position method is available if additional precision is required.

Related Topics

Commanded Position
Error Position
Destination Position
Capture Position