Breadcrumbs

MovePeriodic.srv

Features

This function performs the cyclic motion based on the sine function of each axis (parallel and rotation) of the reference coordinate (ref) input as a relative motion that begins at the current position. The attributes of the motion on each axis are determined by the amplitude and period, and the acceleration/deceleration time and the total motion time are set by the interval and repetition count.

Parameters

Parameter Name

Data Type

Default Value

Description

amp

float64[6]

-

Amplitude (motion between -amp and +amp) [mm] or [deg]

periodic

float64[6]

-

Period (time for 1 cycle) [sec]

acc

float64

-

Acceleration

time

float64

-

Acc-, dec- time [sec]

repeat

int8

-

Repetition count

ref

int8

0

  • reference coordinate

MOVE_REFERENCE_BASE =0

MOVE_REFERENCE_TOOL=1

MOVE_REFERENCE_WORLD=2

syncType

int8

0

SYNC = 0

ASYNC = 1


  • Amp refers to the amplitude. The input is a list of 6 elements which are the amp values for the axes (x, y, z, rx, ry, and rz). The amp input on the axis that does not have a motion must be 0.

  • Period refers to the time needed to complete a motion in the direction, the amplitude. The input is a list of 6 elements which are the periods for the axes (x, y, z, rx, ry, and rz).

  • Atime refers to the acceleration and deceleration time at the beginning and end of the periodic motion. The largest of the inputted acceleration/deceleration times and maximum period*1/4 is applied. An error is generated when the inputted acceleration/deceleration time exceeds 1/2 of the total motion time.

  • Repeat refers to the number of repetitions of the axis (reference axis) that has the largest period value and determines the total motion time. The number of repetitions for each of the remaining axes is determined automatically according to the motion time.

  • If the motion terminates normally, the motions for the remaining axes can be terminated before the reference axis's motion terminates so that the end position matches the starting position. The deceleration section will deviate from the previous path if the motions of all axes are not terminated at the same time. Refer to the following image for more information.

image2021-12-10_17-37-38.png

image2021-12-10_17-37-47.png

  • ref refers to the reference coordinate system of the repeated motion.

  • The MOVE_REFERENCE_WORLD argument of ref is only available in M2.40 or later versions.

  • If a maximum velocity error is generated during a motion, adjust the amplification and period using the following formula.
    velocity = Amplification(amp)*2*pi(3.14)/Period(period)(i.e., Max. velocity=62.83mm/sec if amp=10mm and period=1 sec)

  • This function does not support online blending of previous and subsequent motions.

Return

Parameter Name

Data Type

Default Value

Description

success

bool

-

True or False