public final class **GatherNd** Gather slices from \`params\` into a Tensor with shape specified by \`indices\`.


\`indices\` is a K-dimensional integer tensor, best thought of as a
(K-1)-dimensional tensor of indices into \`params\`, where each element defines a
slice of \`params\`:


output\[\\\\(i_0, ..., i_{K-2}\\\\)\] = params\[indices\[\\\\(i_0, ..., i_{K-2}\\\\)\]\]


Whereas in [`tf.gather`](https://www.tensorflow.org/api_docs/python/tf/gather) \`indices\` defines slices into the \`axis\`
dimension of \`params\`, in [`tf.gather_nd`](https://www.tensorflow.org/api_docs/python/tf/gather_nd), \`indices\` defines slices into the
first \`N\` dimensions of \`params\`, where \`N = indices.shape\[-1\]\`.


The last dimension of \`indices\` can be at most the rank of
\`params\`:


indices.shape\[-1\] \<= params.rank


The last dimension of \`indices\` corresponds to elements
(if \`indices.shape\[-1\] == params.rank\`) or slices
(if \`indices.shape\[-1\] \< params.rank\`) along dimension \`indices.shape\[-1\]\`
of \`params\`. The output tensor has shape


indices.shape\[:-1\] + params.shape\[indices.shape\[-1\]:\]


Note that on CPU, if an out of bound index is found, an error is returned.
On GPU, if an out of bound index is found, a 0 is stored in the
corresponding output value.


Some examples below.


Simple indexing into a matrix:

    indices = [[0, 0], [1, 1]]
         params = [['a', 'b'], ['c', 'd']]
         output = ['a', 'd']
     
Slice indexing into a matrix:

    indices = [[1], [0]]
         params = [['a', 'b'], ['c', 'd']]
         output = [['c', 'd'], ['a', 'b']]
     
Indexing into a 3-tensor:

    indices = [[1]]
         params = [[['a0', 'b0'], ['c0', 'd0']],
                   [['a1', 'b1'], ['c1', 'd1']]]
         output = [[['a1', 'b1'], ['c1', 'd1']]]
     
     
         indices = [[0, 1], [1, 0]]
         params = [[['a0', 'b0'], ['c0', 'd0']],
                   [['a1', 'b1'], ['c1', 'd1']]]
         output = [['c0', 'd0'], ['a1', 'b1']]
     
     
         indices = [[0, 0, 1], [1, 0, 1]]
         params = [[['a0', 'b0'], ['c0', 'd0']],
                   [['a1', 'b1'], ['c1', 'd1']]]
         output = ['b0', 'b1']
     
Batched indexing into a matrix:

    indices = [[[0, 0]], [[0, 1]]]
         params = [['a', 'b'], ['c', 'd']]
         output = [['a'], ['b']]
     
Batched slice indexing into a matrix:

    indices = [[[1]], [[0]]]
         params = [['a', 'b'], ['c', 'd']]
         output = [[['c', 'd']], [['a', 'b']]]
     
Batched indexing into a 3-tensor:

    indices = [[[1]], [[0]]]
         params = [[['a0', 'b0'], ['c0', 'd0']],
                   [['a1', 'b1'], ['c1', 'd1']]]
         output = [[[['a1', 'b1'], ['c1', 'd1']]],
                   [[['a0', 'b0'], ['c0', 'd0']]]]
     
         indices = [[[0, 1], [1, 0]], [[0, 0], [1, 1]]]
         params = [[['a0', 'b0'], ['c0', 'd0']],
                   [['a1', 'b1'], ['c1', 'd1']]]
         output = [[['c0', 'd0'], ['a1', 'b1']],
                   [['a0', 'b0'], ['c1', 'd1']]]
     
     
         indices = [[[0, 0, 1], [1, 0, 1]], [[0, 1, 1], [1, 1, 0]]]
         params = [[['a0', 'b0'], ['c0', 'd0']],
                   [['a1', 'b1'], ['c1', 'd1']]]
         output = [['b0', 'b1'], ['d0', 'c1']]
     
See also [`tf.gather`](https://www.tensorflow.org/api_docs/python/tf/gather) and \`tf.batch_gather\`.

<br />

<br />

<br />

<br />

<br />

<br />

<br />

<br />

<br />

<br />

<br />

### Public Methods

|---|---|
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/GatherNd#asOutput())() Returns the symbolic handle of a tensor. |
| static \<T, U extends Number\> [GatherNd](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/GatherNd)\<T\> | [create](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/GatherNd#create(org.tensorflow.op.Scope,%20org.tensorflow.Operand<T>,%20org.tensorflow.Operand<U>))([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<T\> params, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<U\> indices) Factory method to create a class wrapping a new GatherNd operation. |
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [output](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/GatherNd#output())() Values from \`params\` gathered from indices given by \`indices\`, with shape \`indices.shape\[:-1\] + params.shape\[indices.shape\[-1\]:\]\`. |

### Inherited Methods

From class [org.tensorflow.op.PrimitiveOp](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp)

|---|---|
| final boolean | [equals](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#equals(java.lang.Object))(Object obj) |
| final int | [hashCode](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#hashCode())() |
| [Operation](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation) | [op](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#op())() Returns the underlying `https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation` |
| final String | [toString](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#toString())() |

From class java.lang.Object

|---|---|
| boolean | equals(Object arg0) |
| final Class\<?\> | getClass() |
| int | hashCode() |
| final void | notify() |
| final void | notifyAll() |
| String | toString() |
| final void | wait(long arg0, int arg1) |
| final void | wait(long arg0) |
| final void | wait() |

From interface [org.tensorflow.Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)

|---|---|
| abstract [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand#asOutput())() Returns the symbolic handle of a tensor. |

## Public Methods

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**asOutput**
()

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.

<br />

#### public static [GatherNd](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/GatherNd)\<T\>
**create**
([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<T\> params, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<U\> indices)

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

##### Parameters

| scope | current scope |
| params | The tensor from which to gather values. |
| indices | Index tensor. |
|---|---|

##### Returns

- a new instance of GatherNd

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**output**
()

Values from \`params\` gathered from indices given by \`indices\`, with
shape \`indices.shape\[:-1\] + params.shape\[indices.shape\[-1\]:\]\`.