# DynamicStitch

public final class **DynamicStitch** Interleave the values from the \`data\` tensors into a single tensor.


Builds a merged tensor such that

    merged[indices[m][i, ..., j], ...] = data[m][i, ..., j, ...]
     
For example, if each \`indices\[m\]\` is scalar or vector, we have

    # Scalar indices:
         merged[indices[m], ...] = data[m][...]
     
         # Vector indices:
         merged[indices[m][i], ...] = data[m][i, ...]
     
Each \`data\[i\].shape\` must start with the corresponding \`indices\[i\].shape\`, and the rest of \`data\[i\].shape\` must be constant w.r.t. \`i\`. That is, we must have \`data\[i\].shape = indices\[i\].shape + constant\`. In terms of this \`constant\`, the output shape is


merged.shape = \[max(indices) + 1\] + constant


Values are merged in order, so if an index appears in both \`indices\[m\]\[i\]\` and
\`indices\[n\]\[j\]\` for \`(m,i) \< (n,j)\` the slice \`data\[n\]\[j\]\` will appear in the
merged result. If you do not need this guarantee, ParallelDynamicStitch might
perform better on some devices.


For example:

    indices[0] = 6
         indices[1] = [4, 1]
         indices[2] = [[5, 2], [0, 3]]
         data[0] = [61, 62]
         data[1] = [[41, 42], [11, 12]]
         data[2] = [[[51, 52], [21, 22]], [[1, 2], [31, 32]]]
         merged = [[1, 2], [11, 12], [21, 22], [31, 32], [41, 42],
                   [51, 52], [61, 62]]
     
This method can be used to merge partitions created by \`dynamic_partition\` as illustrated on the following example:

    # Apply function (increments x_i) on elements for which a certain condition
         # apply (x_i != -1 in this example).
         x=tf.constant([0.1, -1., 5.2, 4.3, -1., 7.4])
         condition_mask=tf.not_equal(x,tf.constant(-1.))
         partitioned_data = tf.dynamic_partition(
             x, tf.cast(condition_mask, tf.int32) , 2)
         partitioned_data[1] = partitioned_data[1] + 1.0
         condition_indices = tf.dynamic_partition(
             tf.range(tf.shape(x)[0]), tf.cast(condition_mask, tf.int32) , 2)
         x = tf.dynamic_stitch(condition_indices, partitioned_data)
         # Here x=[1.1, -1., 6.2, 5.3, -1, 8.4], the -1. values remain
         # unchanged.
     
![](https://www.tensorflow.org/images/DynamicStitch.png)

<br />

<br />

<br />

<br />

<br />

### Public Methods

|---|---|
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/DynamicStitch#asOutput())() Returns the symbolic handle of a tensor. |
| static \<T\> [DynamicStitch](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/DynamicStitch)\<T\> | [create](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/DynamicStitch#create(org.tensorflow.op.Scope,%20java.lang.Iterable<org.tensorflow.Operand<java.lang.Integer>>,%20java.lang.Iterable<org.tensorflow.Operand<T>>))([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, Iterable\<[Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Integer\>\> indices, Iterable\<[Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<T\>\> data) Factory method to create a class wrapping a new DynamicStitch operation. |
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [merged](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/DynamicStitch#merged())() |

### Inherited Methods

From class [org.tensorflow.op.PrimitiveOp](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp)

|---|---|
| final boolean | [equals](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#equals(java.lang.Object))(Object obj) |
| final int | [hashCode](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#hashCode())() |
| [Operation](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation) | [op](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#op())() Returns the underlying `https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation` |
| final String | [toString](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#toString())() |

From class java.lang.Object

|---|---|
| boolean | equals(Object arg0) |
| final Class\<?\> | getClass() |
| int | hashCode() |
| final void | notify() |
| final void | notifyAll() |
| String | toString() |
| final void | wait(long arg0, int arg1) |
| final void | wait(long arg0) |
| final void | wait() |

From interface [org.tensorflow.Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)

|---|---|
| abstract [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand#asOutput())() Returns the symbolic handle of a tensor. |

## Public Methods

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**asOutput**
()

Returns the symbolic handle of a tensor.

Inputs to TensorFlow operations are outputs of another TensorFlow operation. This method is
used to obtain a symbolic handle that represents the computation of the input.

<br />

#### public static [DynamicStitch](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/DynamicStitch)\<T\>
**create**
([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, Iterable\<[Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Integer\>\> indices, Iterable\<[Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<T\>\> data)

Factory method to create a class wrapping a new DynamicStitch operation.

##### Parameters

| scope | current scope |
|---|---|

##### Returns

- a new instance of DynamicStitch

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**merged**
()

<br />