# Module: tfr.utils

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/ranking/blob/v0.5.3/tensorflow_ranking/python/utils.py) |

Utility functions for ranking library.

## Functions

[`de_noise(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/de_noise): Returns a float `Tensor` as the de-noised `counts`.

[`gather_per_row(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/gather_per_row): Gathers the values from input tensor based on per-row indices.

[`is_label_valid(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/is_label_valid): Returns a boolean `Tensor` for label validity.

[`organize_valid_indices(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/organize_valid_indices): Organizes indices in such a way that valid items appear first.

[`padded_nd_indices(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/padded_nd_indices): Pads the invalid entries by valid ones and returns the nd_indices.

[`parse_keys_and_weights(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/parse_keys_and_weights): Parses the encoded key to keys and weights.

[`ragged_to_dense(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/ragged_to_dense): Converts given inputs from ragged tensors to dense tensors.

[`reshape_first_ndims(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/reshape_first_ndims): Reshapes the first n dims of the input `tensor` to `new shape`.

[`reshape_to_2d(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/reshape_to_2d): Converts the given `tensor` to a 2-D `Tensor`.

[`shuffle_valid_indices(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/shuffle_valid_indices): Returns a shuffle of indices with valid ones on top.

[`sort_by_scores(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/sort_by_scores): Sorts list of features according to per-example scores.

[`sorted_ranks(...)`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/sorted_ranks): Returns an int `Tensor` as the ranks (1-based) after sorting scores.

## Type Aliases

[`LossFunction`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/LossFunction)

[`MetricFunction`](https://www.tensorflow.org/ranking/api_docs/python/tfr/utils/LossFunction)

[`TensorLike`](https://www.tensorflow.org/ranking/api_docs/python/tfr/keras/model/TensorLike)

[`TransformationFunction`](https://www.tensorflow.org/ranking/api_docs/python/tfr/keras/utils/GainFunction)