<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.21.0/tensorflow/python/ops/ragged/ragged_concat_ops.py#L73-L124) |

Stacks a list of rank-`R` tensors into one rank-`(R+1)` `RaggedTensor`.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.ragged.stack`](https://www.tensorflow.org/api_docs/python/tf/ragged/stack)

<br />

    tf.ragged.stack(
        values: typing.List[ragged_tensor.RaggedOrDense], axis=0, name=None
    )

Given a list of tensors or ragged tensors with the same rank `R`
(`R >= axis`), returns a rank-`R+1` `RaggedTensor` `result` such that
`result[i0...iaxis]` is `[value[i0...iaxis] for value in values]`.

#### Examples:

    # Stacking two ragged tensors.
    t1 = tf.ragged.constant([[1, 2], [3, 4, 5]])
    t2 = tf.ragged.constant([[6], [7, 8, 9]])
    tf.ragged.stack([t1, t2], axis=0)
    <tf.RaggedTensor [[[1, 2], [3, 4, 5]], [[6], [7, 8, 9]]]>
    tf.ragged.stack([t1, t2], axis=1)
    <tf.RaggedTensor [[[1, 2], [6]], [[3, 4, 5], [7, 8, 9]]]>

    # Stacking two dense tensors with different sizes.
    t3 = tf.constant([[1, 2, 3], [4, 5, 6]])
    t4 = tf.constant([[5], [6], [7]])
    tf.ragged.stack([t3, t4], axis=0)
    <tf.RaggedTensor [[[1, 2, 3], [4, 5, 6]], [[5], [6], [7]]]>

<br />

<br />

<br />

| ## Args ||
|---|---|
| `values` | A list of [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor) or [`tf.RaggedTensor`](https://www.tensorflow.org/api_docs/python/tf/RaggedTensor). May not be empty. All `values` must have the same rank and the same dtype; but unlike [`tf.stack`](https://www.tensorflow.org/api_docs/python/tf/stack), they can have arbitrary dimension sizes. |
| `axis` | A python integer, indicating the dimension along which to stack. (Note: Unlike [`tf.stack`](https://www.tensorflow.org/api_docs/python/tf/stack), the `axis` parameter must be statically known.) Negative values are supported only if the rank of at least one `values` value is statically known. |
| `name` | A name prefix for the returned tensor (optional). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A `RaggedTensor` with rank `R+1` (if `R>0`). If `R==0`, then the result will be returned as a 1D `Tensor`, since `RaggedTensor` can only be used when `rank>1`. `result.ragged_rank=1+max(axis, max(rt.ragged_rank for rt in values]))`. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | If `values` is empty, if `axis` is out of bounds or if the input tensors have different ranks. |

<br />