# tensorflow::ops::DeserializeSparse

`#include <sparse_ops.h>`

Deserialize `SparseTensor` objects.

## Summary

The input `serialized_sparse` must have the shape `[?, ?, ..., ?, 3]` where the last dimension stores serialized `SparseTensor` objects and the other N dimensions (N \>= 0) correspond to a batch. The ranks of the original `SparseTensor` objects must all match. When the final `SparseTensor` is created, its rank is the rank of the incoming `SparseTensor` objects plus N; the sparse tensors have been concatenated along new dimensions, one for each batch.

The output `SparseTensor` object's shape values for the original dimensions are the max across the input `SparseTensor` objects' shape values for the corresponding dimensions. The new dimensions match the size of the batch.

The input `SparseTensor` objects' indices are assumed ordered in standard lexicographic order. If this is not the case, after this step run `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/sparse-reorder#classtensorflow_1_1ops_1_1_sparse_reorder` to restore index ordering.

For example, if the serialized input is a `[2 x 3]` matrix representing two original `SparseTensor` objects:

```
index = [ 0]
        [10]
        [20]
values = [1, 2, 3]
shape = [50]
```

<br />

and

```
index = [ 2]
        [10]
values = [4, 5]
shape = [30]
```

<br />

then the final deserialized `SparseTensor` will be:

```
index = [0  0]
        [0 10]
        [0 20]
        [1  2]
        [1 10]
values = [1, 2, 3, 4, 5]
shape = [2 50]
```

<br />

Arguments:

- scope: A [Scope](https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope) object
- serialized_sparse: The serialized `SparseTensor` objects. The last dimension must have 3 columns.
- dtype: The `dtype` of the serialized `SparseTensor` objects.

<br />

Returns:

- `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output` sparse_indices
- `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output` sparse_values
- `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output` sparse_shape

<br />

| ### Constructors and Destructors ||
|---|---|
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/deserialize-sparse#classtensorflow_1_1ops_1_1_deserialize_sparse_1a023794d9b956960ff8d7189e5e3feec5(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#classtensorflow_1_1_input serialized_sparse, DataType dtype)` ||

| ### Public attributes ||
|---|---|
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/deserialize-sparse#classtensorflow_1_1ops_1_1_deserialize_sparse_1abdd692db872e045ede9e84be66b35bc3` | `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/operation#classtensorflow_1_1_operation` |
| `https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/ops/deserialize-sparse#classtensorflow_1_1ops_1_1_deserialize_sparse_1acdaf19772a1be03384f76ac4e07f6aaf` | `::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/deserialize-sparse#classtensorflow_1_1ops_1_1_deserialize_sparse_1a86bbd4ffa415bb68db5fa2f1e76e7de5` | `::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/deserialize-sparse#classtensorflow_1_1ops_1_1_deserialize_sparse_1a303201bfe16885e2cef2b115049d005e` | `::https://www.tensorflow.org/versions/r2.0/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output` |

## Public attributes

### operation

```
Operation operation
```

### sparse_indices

```
::tensorflow::Output sparse_indices
```

### sparse_shape

```
::tensorflow::Output sparse_shape
```

### sparse_values

```
::tensorflow::Output sparse_values
```

## Public functions

### DeserializeSparse

```
 DeserializeSparse(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input serialized_sparse,
  DataType dtype
)
```