<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/transform/blob/v1.21.0/tensorflow_transform/mappers.py#L223-L253) |

Re-arranges a [`tf.SparseTensor`](https://www.tensorflow.org/api_docs/python/tf/sparse/SparseTensor) and returns a left-aligned version of it.

    tft.sparse_tensor_left_align(
        sparse_tensor: tf.SparseTensor
    ) -> tf.SparseTensor

This mapper can be useful when returning a sparse tensor that may not be
left-aligned from a preprocessing_fn.

<br />

<br />

<br />

| ## Args ||
|---|---|

<br />

*** ** * ** ***

sparse_tensor: A 2D [`tf.SparseTensor`](https://www.tensorflow.org/api_docs/python/tf/sparse/SparseTensor).

<br />

<br />

<br />

| ## Raises ||
|---|---|

<br />

*** ** * ** ***

ValueError if `sparse_tensor` is not 2D.

<br />

<br />

<br />

| ## Returns ||
|---|---|

<br />

*** ** * ** ***

A left-aligned version of sparse_tensor as a [`tf.SparseTensor`](https://www.tensorflow.org/api_docs/python/tf/sparse/SparseTensor).