# tensorflow::ops::TopK Class Reference

# tensorflow::
ops::
TopK

`
#include <nn_ops.h>
`


Finds values and indices of the
`
k
`
largest elements for the last dimension.

## Summary


If the input is a vector (rank-1), finds the
`
k
`
largest entries in the vector and outputs their values and indices as vectors. Thus
`
values[j]
`
is the
`
j
`
-th largest entry in
`
input
`
, and its index is
`
indices[j]
`
.


For matrices (resp. higher rank input), computes the top
`
k
`
entries in each row (resp. vector along the last dimension). Thus,

```
values.shape = indices.shape = input.shape[:-1] + [k]
```

<br />


If two elements are equal, the lower-index element appears first.


Args:

- scope: A [Scope](https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope) object
- input: 1-D or higher with last dimension at least `
  k
  ` .
- k: 0-D. Number of top elements to look for along the last dimension (along each row for matrices).

<br />


Optional attributes (see
`
https://www.tensorflow.org/versions/r2.5/api_docs/cc/struct/tensorflow/ops/top-k/attrs#structtensorflow_1_1ops_1_1_top_k_1_1_attrs
`
):

- sorted: If true the resulting `
  k
  ` elements will be sorted by the values in descending order.

<br />


Returns:

- `
  https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output
  ` values: The `
  k
  ` largest elements along each last dimensional slice.
- `
  https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output
  ` indices: The indices of `
  values
  ` within the last dimension of `
  input
  ` .

<br />

| ### Constructors and Destructors ||
|---|---|
| ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/ops/top-k#classtensorflow_1_1ops_1_1_top_k_1a0c8404c5e20cae7d52b460b213d13bf4 (const :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope & scope, :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input input, :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input k) ` ||
| ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/ops/top-k#classtensorflow_1_1ops_1_1_top_k_1ad55e14f1c8e36a07ae7e3e5189ce1de6 (const :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope & scope, :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input input, :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input k, const https://www.tensorflow.org/versions/r2.5/api_docs/cc/struct/tensorflow/ops/top-k/attrs#structtensorflow_1_1ops_1_1_top_k_1_1_attrs & attrs) ` ||

| ### Public attributes ||
|---|---|
| ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/ops/top-k#classtensorflow_1_1ops_1_1_top_k_1a702b5fcc223806a5b43892c840294e6e ` | ` :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output ` |
| ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/ops/top-k#classtensorflow_1_1ops_1_1_top_k_1a6772614af084e9178999f8b10e356ce4 ` | ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/operation#classtensorflow_1_1_operation ` |
| ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/ops/top-k#classtensorflow_1_1ops_1_1_top_k_1a3d754e075cd5e04093e27e60a6a07727 ` | ` :: https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output ` |

| ### Public static functions ||
|---|---|
| ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/ops/top-k#classtensorflow_1_1ops_1_1_top_k_1ac5e55d49539ee3457dc1a432480e85c2 (bool x) ` | ` https://www.tensorflow.org/versions/r2.5/api_docs/cc/struct/tensorflow/ops/top-k/attrs#structtensorflow_1_1ops_1_1_top_k_1_1_attrs ` |

| ### Structs ||
|---|---|
| [tensorflow:: ops:: TopK:: Attrs](https://www.tensorflow.org/versions/r2.5/api_docs/cc/struct/tensorflow/ops/top-k/attrs) | Optional attribute setters for [TopK](https://www.tensorflow.org/versions/r2.5/api_docs/cc/class/tensorflow/ops/top-k#classtensorflow_1_1ops_1_1_top_k) . |

## Public attributes

### indices

```
::tensorflow::Output indices
```

### operation

```
Operation operation
```

### values

```
::tensorflow::Output values
```

## Public functions

### TopK

```
 TopK(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  ::tensorflow::Input k
)
```

### TopK

```
 TopK(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  ::tensorflow::Input k,
  const TopK::Attrs & attrs
)
```

## Public static functions

### Sorted

```
Attrs Sorted(
  bool x
)
```