# tensorflow::ops::DynamicStitch

`#include <data_flow_ops.h>`

Interleave the values from the `data` tensors into a single tensor.

## Summary

Builds a merged tensor such that


```
    merged[indices[m][i, ..., j], ...] = data[m][i, ..., j, ...]
```

<br />

For example, if each `indices[m]` is scalar or vector, we have


```
    # Scalar indices:
    merged[indices[m], ...] = data[m][...]
```

<br />


```
    # Vector indices:
    merged[indices[m][i], ...] = data[m][i, ...]
```

<br />

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)] + constant
```

<br />

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](https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/parallel-dynamic-stitch#classtensorflow_1_1ops_1_1_parallel_dynamic_stitch) 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]]
```

<br />

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.
```

<br />


![](https://www.tensorflow.org/static/versions/r2.0/api_docs/cc/images/DynamicStitch.png)

<br />

Arguments:

- scope: A [Scope](https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope) object

<br />

Returns:

- `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output`: The merged tensor.

<br />

| ### Constructors and Destructors ||
|---|---|
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/dynamic-stitch#classtensorflow_1_1ops_1_1_dynamic_stitch_1a40683e2fafd5461794d620ec3ab75b02(const ::https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope & scope, ::https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/input-list#classtensorflow_1_1_input_list indices, ::https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/input-list#classtensorflow_1_1_input_list data)` ||

| ### Public attributes ||
|---|---|
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/dynamic-stitch#classtensorflow_1_1ops_1_1_dynamic_stitch_1ab680171a95778bb5700d266c6d81263a` | `::https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output` |
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/dynamic-stitch#classtensorflow_1_1ops_1_1_dynamic_stitch_1aa293b5d370da3681d76bd21d745f63b3` | `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/operation#classtensorflow_1_1_operation` |

| ### Public functions ||
|---|---|
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/dynamic-stitch#classtensorflow_1_1ops_1_1_dynamic_stitch_1a116487484247157a3a09e30862677040() const ` | `::tensorflow::Node *` |
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/dynamic-stitch#classtensorflow_1_1ops_1_1_dynamic_stitch_1a7bea7f966421c8a58236ed192cde235f() const ` | ` `` ` |
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/dynamic-stitch#classtensorflow_1_1ops_1_1_dynamic_stitch_1a71343c33e7d5cb4c7b9f8f68204520ff() const ` | ` `` ` |

## Public attributes

### merged

```
::tensorflow::Output merged
```

### operation

```
Operation operation
```

## Public functions

### DynamicStitch

```
 DynamicStitch(
  const ::tensorflow::Scope & scope,
  ::tensorflow::InputList indices,
  ::tensorflow::InputList data
)
```

### node

```
::tensorflow::Node * node() const 
```

### operator::tensorflow::Input

```
 operator::tensorflow::Input() const 
```

### operator::tensorflow::Output

```
 operator::tensorflow::Output() const 
```