Package org.tensorflow.op.core

Class ResourceScatterNdUpdate

java.lang.Object

org.tensorflow.op.PrimitiveOp

org.tensorflow.op.core.ResourceScatterNdUpdate

All Implemented Interfaces:

Op

@Operator
public final class ResourceScatterNdUpdate
extends PrimitiveOp

Applies sparse `updates` to individual values or slices within a given

variable according to `indices`.

`ref` is a `Tensor` with rank `P` and `indices` is a `Tensor` of rank `Q`.

`indices` must be integer tensor, containing indices into `ref`. It must be shape `[d_0, ..., d_{Q-2}, K]` where `0 < K <= P`.

The innermost dimension of `indices` (with length `K`) corresponds to indices into elements (if `K = P`) or slices (if `K < P`) along the `K`th dimension of `ref`.

`updates` is `Tensor` of rank `Q-1+P-K` with shape:

 [d_0, ..., d_{Q-2}, ref.shape[K], ..., ref.shape[P-1]].
 

For example, say we want to update 4 scattered elements to a rank-1 tensor to 8 elements. In Python, that update would look like this:

     ref = tf.Variable([1, 2, 3, 4, 5, 6, 7, 8])
     indices = tf.constant([[4], [3], [1] ,[7]])
     updates = tf.constant([9, 10, 11, 12])
     update = tf.scatter_nd_update(ref, indices, updates)
     with tf.Session() as sess:
       print sess.run(update)
 

The resulting update to ref would look like this:

[1, 11, 3, 10, 9, 6, 7, 12]

See `tf.scatter_nd` for more details about how to make updates to slices.

Nested Class Summary

Nested Classes

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

Field Summary

Fields inherited from class org.tensorflow.op.PrimitiveOp

operation

Method Summary

Modifier and Type	Method	Description
static <T extends java.lang.Number,U> ResourceScatterNdUpdate	create(Scope scope, Operand<?> ref, Operand<T> indices, Operand<U> updates, ResourceScatterNdUpdate.Options... options)	Factory method to create a class to wrap a new ResourceScatterNdUpdate operation to the graph.
static ResourceScatterNdUpdate.Options	useLocking(java.lang.Boolean useLocking)

Methods inherited from class java.lang.Object

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

Methods inherited from class org.tensorflow.op.PrimitiveOp

equals, hashCode, toString

Method Detail

create

public static <T extends java.lang.Number,U> ResourceScatterNdUpdate create(Scope scope,
                                                                            Operand<?> ref,
                                                                            Operand<T> indices,
                                                                            Operand<U> updates,
                                                                            ResourceScatterNdUpdate.Options... options)

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

Parameters:

scope - current graph scope

ref - A resource handle. Must be from a VarHandleOp.

indices - A Tensor. Must be one of the following types: int32, int64. A tensor of indices into ref.

updates - A Tensor. Must have the same type as ref. A tensor of updated values to add to ref.

options - carries optional attributes values

Returns:

a new instance of ResourceScatterNdUpdate

useLocking

public static ResourceScatterNdUpdate.Options useLocking(java.lang.Boolean useLocking)

Parameters:

useLocking - An optional bool. Defaults to True. If True, the assignment will be protected by a lock; otherwise the behavior is undefined, but may exhibit less contention.