org.tensorflow.op.core

Class NthElement<T extends Number>

java.lang.Object

org.tensorflow.op.PrimitiveOp

org.tensorflow.op.core.NthElement<T>

Type Parameters:

T - data type for values() output

All Implemented Interfaces:

Op, Operand<T>

@Operator
public final class NthElement<T extends Number>
extends PrimitiveOp
implements Operand<T>

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 Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NthElement.Options Optional attributes for NthElement

Field Summary

Fields inherited from class org.tensorflow.op.PrimitiveOp

operation

Method Summary

Modifier and Type	Method and Description
Output<T>	asOutput() Returns the symbolic handle of a tensor.
static <T extends Number> NthElement<T>	create(Scope scope, Operand<T> input, Operand<Integer> n, NthElement.Options... options) Factory method to create a class to wrap a new NthElement operation to the graph.
static NthElement.Options	reverse(Boolean reverse)
Output<T>	values() The `n`-th order statistic along each last dimensional slice.

Methods inherited from class org.tensorflow.op.PrimitiveOp

equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

create

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

Factory method to create a class to wrap a new NthElement operation to the graph.

Parameters:

scope - current graph 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

reverse

public static NthElement.Options reverse(Boolean reverse)

Parameters:

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

values

public Output<T> values()

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

asOutput

public Output<T> asOutput()

Description copied from interface: Operand

Returns the symbolic handle of a 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.

Specified by:

asOutput in interface Operand<T extends Number>

See Also:

OperationBuilder.addInput(Output)