FunctionMLAxisRelPipe Network motion icon

Description

A selected Axis performs a move for a specified distance relative to the current position. The DeltaPosition input is signed so that the move can be in the positive or negative direction, and the Axis moves this distance in user units. The travel speed, acceleration, deceleration, and User Units of the move are values inherited from the selected Axis. The default settings are entered when an Axis is created and initiated, and can be changed with other MLAxis commands such as MLAxisGenWriteSpd, MLAxisGenWriteAcc, and MLAxisWriteUUnits.


  • If you wish to know when a move has completed, we recommend using MLAxisGenIsRdy. The output of MLAxisRel can occur before moves have finished.

Arguments

Input

ID

Description

ID Name of the Axis block.

 

Data type

DINT

 

Range

 

Unit

N/A

 

Default

DeltaPosition

Description

Sets the Axis Delta Position, or the relative distance to be moved.

 

Data type

LREAL

 

Range

 

Unit

User unit

 

Default

Output

Default (.Q)

Description

Returns true when function successfully executes. This occurs immediately after the function is called; the function does not wait for the motion profile to be completed.

See more details here.

 

Data type

BOOL

 

Unit

N/A

Related Functions

MLAxisGenWriteAcc

MLAxisGenWriteDec

MLAxisGenWriteSpd

Example

See Usage Example of Axis Functions for additional examples.

Structured Text

 

MLAxisRel(PipeNetwork.Axis1, 2500 ) ;

 

Ladder Diagram

MLAxisRel: LD example

Function Block Diagram

MLAxisRel: FBD example

Go back to the top of the page [Top]