# Difference between revisions of "Motion Blending"

## Introduction

Blending is combination of two or more motions together. During Blending motion typically does not stop at the intermediate points.

There are three blending types:

1. CP (Continous Path) blending.
Two movements are combined into one lead by one common profile.
2. SP (SuperPosition ) blending.
Two movements are combined into one by addition, each movement is lead by its own profile.
3. AI (Advance Interpolation) blending.
Many movements are combined into one lead by one common profile.

Selected by BlendingMethod property.

### Blending Properties

Different blending properties are used in different blending methods:

 Properties CP SP AI BlendingMethod 1 2 3 CP ✓ - - CPPrev ✓ - - BlendingFactor - 1..100 - BFPrev - 1..100 - BlendProtected - ✓ - BlendingPercentage ✓ ✓ - BlendingStartCondition ✓ ✓ - DoubleMode ✓ ✓ -

## Simple Blending

The first two blending methods (Continuous Path (CP) and Super Position (SP)) are characterized by the fact that during blending exactly two motions are active and combined into one. In the first case (CP) the combination is done using profiler-following and in the second case (SP) simple addition of two movements. Both methods as a trigger for blending specify the distance from the target position of the first motion. In CP this is defined by the cp factor which in represents the linear distance from the target point (however this factor is combined with the CP of the second motion). In case of the SP it is a simple distance (given in percentage) from the starting point (Blending factor - BF). In both cases the parameter (CP or BF) of the current motion influences the point of blending of the next motion. When one of the movements are issued with no explicit blending parameter, the default value (of the CP or BF) is used. But the default value can also implicitly switch off the blending (CP = 0 or BF = 100).

• In cases when one of the movements have blending switched off, the following rules apply:
1. The nodal BF defines the starting point of the next motion in blending.
2. If the nodal BF value is set to 100 (or CP=0), there will be no blending with the next motion.

### Program Example

Blendingmethod =1 ' cp
CP = 0
BlendingFactor = 100
MOVE L
MOVE L CP = 10
Move L
delay 100
Blendingmethod =2 ' sp
CP = 0
BlendingFactor = 100
MOVE L
MOVE L BlendingFactor = 85
Move L BlendingFactor = 100


### Blending Propagation Rules

• Nodal values of BF/CP define the starting point of the next motion in blending.
• If the nodal BF value is set to 100 (or CP=0), there will be no blending with next motion.
• BlendingFactor (<robot>.BF) - either modal (global) or nodal (local) define the blending between the motion. It is given for and the next upcoming motion. Ranges from 0 (immediate = maximum blending) to 100 (no blending).
• BlendingFactorPrevious (<robot>.BFPrev) - either modal (global) or nodal (local) overwrites - if in the range of 0 to 100 - the <robot>.BF of the previous motion. Meant to be applied between the previous motion and the current one. The meaning of the range 0 to 100 is the same as with <robot>.BF. If no such overwriting is desired <robot>.BFPrev must be set to -1 (actually: any negative number).
• The same shall apply to <robot>.CP and <robot>.CPPrev. If given and > 0 <robot>.CPPrev shall overwrite the previous <robot>.CP. If -1 (actually: any negative number) it shall be ignored. The default shall be -1. If the overwrite comes too late the previous motion shall continue with its own <robot>.CP. This means that it might still apply its own low CP if it was to be overwritten by a large CPPrev. These two factors basically allow to give separate blending coefficients for the two end points of a motion, together with a very explicit and easy rule how they're applied. One can:
a) always determine blending in advance (i.e. before or at starting the motion)
b) always determine blending retrospectively (i.e. after starting the motion)
c) mix a) and b) randomly

moves robot loc1 BF=0
moves robot loc2 BFPrev=90 BF=90
moves robot loc3 BFPrev=50

means: loc1 -> BF90 -> loc2 -> BF50 -> loc3


Blending Behavior

### Rules Summary

1. global BF (<robot>.bf=<NUM>) is the default BF
2. local BF (move <robot> BF=<NUM>) overwrites that default per motion
3. this results in an effective BF per motion
4. global BFPrev initialized by the system to -1
5. local BFPrev overwrites global BFPrev per motion
6. this results in an effective BFPrev per motion
7. if the effective BFP is >= 0 (not negative), it overwrites the effective BF for the previous motion
8. the same will apply to CP and CPPrev

with some side effects:

 NOTE Globally setting BFPrev to ?'"UNIQ--nowiki-00000003-QINU"'? is not recommended, because it will overwrite any and all elaborate local BF
 NOTE Accuracy of the path length depends on the velocity at the moment of blending. Error in the magnitude of ?'"UNIQ--math-00000004-QINU"'? can be expected!

BF vs BFprev