7.26. SetScheduleNewTarget

7.26.1. Attributes

7.26.2. Description

This action is used to modify dynamically the course of an interpolator. This action consists in a dynamic modification of the tabweights weight matrix. The target node is expected to contain an interpolator.

The child node defines a weights vector that will be used to modify the value of the current target (a row of the weight matrix). The string value of the operator attribute is an operator string. The values of the operator must be "=", "=", "+=", "-=", "*=", or "/=".

The weights defined in the child node are called source weights. If the target node contains an interpolator and if the interpolation is currently computed between the nth and (n+1)th key positions, the values of the source weights are used to modify the values of the (n+1)th row of the weight matrix of the target interpolator.

For instance if the source weights are (0.5, 0.0, 0.5), and if the operator is "=", the new target of the schedule is the middle of the first and third interpolation generators (Figure 7-1). The other operators respectively correspond to addition, substraction, multiplication, and division of the target values by the source weights.

In order to ensure continuity, the current location of the interpolator in the interpolator space becomes the current source key position. It replaces the nth row of the weight matrix of the target interpolator.

Interpolation can also operate on variables (scalars, tables, or matrices). The set_schedule_new_target command concern the interpolation of variables if and only if the variable attribute is defined in the set_schedule_new_target element. In this case, the string value of the variable attribute is the ID of the interpolated variable on the target node.

7.26.3. Expected children

The following element must occur in set_schedule_new_target: one weight vector element.

7.26.4. Expected target

The target node must be an interpolator.

7.26.5. Example

The example below defines an action that replaces the current target of the interpolator by the middle of the first and third generators of the interpolator.

<set_schedule_new_target operator="=">
  <weights dim="3"> 0.5 0.0 0.5 </weights>
</set_schedule_new_target>