# tff.analytics.data_processing.get_top_elements

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/federated/blob/v0.87.0 Version 2.0, January 2004 Licensed under the Apache License, Version 2.0 (the) |

Gets top unique elements from the input `dataset`.

    tff.analytics.data_processing.get_top_elements(
        dataset: tf.data.Dataset,
        max_user_contribution: int,
        string_max_bytes: Optional[int] = None
    )

This method returns the set of `max_user_contribution` elements that appear
most frequently in the dataset. Each word will only appear at most once in the
output.

This differs from `get_top_multi_elements` in that it returns a set rather
than a multiset.

The input `dataset` must yield batched rank-1 tensors. This function reads
each coordinate of the tensor as an individual element and caps the total
number of elements to return. Note that the returned set of top elements will
not necessarily be sorted.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `dataset` | A [`tf.data.Dataset`](https://www.tensorflow.org/api_docs/python/tf/data/Dataset) to extract top elements from. Element type must be [`tf.string`](https://www.tensorflow.org/api_docs/python/tf#string). |
| `max_user_contribution` | The maximum number of elements to keep. |
| `string_max_bytes` | The maximum length (in bytes) of strings in the dataset. Strings longer than `string_max_bytes` will be truncated. Defaults to `None`, which means there is no limit of the string length. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A rank-1 Tensor containing the top `max_user_contribution` unique elements of the input `dataset`. If the total number of unique elements is less than or equal to `max_user_contribution`, returns the list of all unique elements. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | -- If the shape of elements in `dataset` is not rank 1. -- If `max_user_contribution` is less than 1. -- If `string_max_bytes` is not `None` and is less than 1. |
| `TypeError` | If `dataset.element_spec.dtype` must be [`tf.string`](https://www.tensorflow.org/api_docs/python/tf#string) is not [`tf.string`](https://www.tensorflow.org/api_docs/python/tf#string). |

<br />