NthElement

public final class NthElement

Finds values of the `n`-th order statistic for the last dimension.

If the input is a vector (rank-1), finds the entries which is the nth-smallest value in the vector and outputs their values as scalar tensor.

For matrices (resp. higher rank input), computes the entries which is the nth-smallest value in each row (resp. vector along the last dimension). Thus,

values.shape = input.shape[:-1]

Nested Classes

class NthElement.Options Optional attributes for NthElement

Constants

String OP_NAME The name of this op, as known by TensorFlow core engine

Public Methods

Output <T>
asOutput ()
Returns the symbolic handle of the tensor.
static <T extends TNumber > NthElement <T>
create ( Scope scope, Operand <T> input, Operand < TInt32 > n, Options... options)
Factory method to create a class wrapping a new NthElement operation.
static NthElement.Options
reverse (Boolean reverse)
Output <T>
values ()
The `n`-th order statistic along each last dimensional slice.

Inherited Methods

Constants

public static final String OP_NAME

The name of this op, as known by TensorFlow core engine

Constant Value: "NthElement"

Public Methods

public Output <T> asOutput ()

Returns the symbolic handle of the tensor.

Inputs to TensorFlow operations are outputs of another TensorFlow operation. This method is used to obtain a symbolic handle that represents the computation of the input.

public static NthElement <T> create ( Scope scope, Operand <T> input, Operand < TInt32 > n, Options... options)

Factory method to create a class wrapping a new NthElement operation.

Parameters
scope current scope
input 1-D or higher with last dimension at least `n+1`.
n 0-D. Position of sorted vector to select along the last dimension (along each row for matrices). Valid range of n is `[0, input.shape[:-1])`
options carries optional attributes values
Returns
  • a new instance of NthElement

public static NthElement.Options reverse (Boolean reverse)

Parameters
reverse When set to True, find the nth-largest value in the vector and vice versa.

public Output <T> values ()

The `n`-th order statistic along each last dimensional slice.