Warning: This API is deprecated and will be removed in a future
version of TensorFlow after
the replacement is stable.
ScatterNdNonAliasingAdd
Stay organized with collections
Save and categorize content based on your preferences.
Applies sparse addition to `input` using individual values or slices
from `updates` according to indices `indices`. The updates are non-aliasing:
`input` is only modified in-place if no other operations will use it.
Otherwise, a copy of `input` is made. This operation has a gradient with
respect to both `input` and `updates`.
`input` is a `Tensor` with rank `P` and `indices` is a `Tensor` of rank `Q`.
`indices` must be integer tensor, containing indices into `input`.
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 `(P-K)`-dimensional slices
(if `K < P`) along the `K`th dimension of `input`.
`updates` is `Tensor` of rank `Q-1+P-K` with shape:
$$[d_0, ..., d_{Q-2}, input.shape[K], ..., input.shape[P-1]].$$
For example, say we want to add 4 scattered elements to a rank-1 tensor to 8
elements. In Python, that addition would look like this:
input = tf.constant([1, 2, 3, 4, 5, 6, 7, 8])
indices = tf.constant([[4], [3], [1], [7]])
updates = tf.constant([9, 10, 11, 12])
output = tf.scatter_nd_non_aliasing_add(input, indices, updates)
with tf.Session() as sess:
print(sess.run(output))
The resulting value `output` would look like this:
[1, 13, 3, 14, 14, 6, 7, 20]
See tf.scatter_nd
for more details about how to make updates to slices.
Inherited Methods
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()
|
Public Methods
public
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.
Factory method to create a class wrapping a new ScatterNdNonAliasingAdd operation.
Parameters
scope |
current scope |
input |
A Tensor. |
indices |
A Tensor. Must be one of the following types: `int32`, `int64`.
A tensor of indices into `input`. |
updates |
A Tensor. Must have the same type as ref. A tensor of updated values
to add to `input`. |
Returns
- a new instance of ScatterNdNonAliasingAdd
public
Output<T>
output
()
A `Tensor` with the same shape as `input`, containing values of `input`
updated with `updates`.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-02-12 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-02-12 UTC."],[],[],null,["# ScatterNdNonAliasingAdd\n\npublic final class **ScatterNdNonAliasingAdd** \nApplies sparse addition to \\`input\\` using individual values or slices\n\n\nfrom \\`updates\\` according to indices \\`indices\\`. The updates are non-aliasing:\n\\`input\\` is only modified in-place if no other operations will use it.\nOtherwise, a copy of \\`input\\` is made. This operation has a gradient with\nrespect to both \\`input\\` and \\`updates\\`.\n\n\n\\`input\\` is a \\`Tensor\\` with rank \\`P\\` and \\`indices\\` is a \\`Tensor\\` of rank \\`Q\\`.\n\n\n\\`indices\\` must be integer tensor, containing indices into \\`input\\`.\nIt must be shape \\\\\\\\(\\[d_0, ..., d_{Q-2}, K\\]\\\\\\\\) where \\`0 \\\u003c K \\\u003c= P\\`.\n\n\nThe innermost dimension of \\`indices\\` (with length \\`K\\`) corresponds to\nindices into elements (if \\`K = P\\`) or \\`(P-K)\\`-dimensional slices\n(if \\`K \\\u003c P\\`) along the \\`K\\`th dimension of \\`input\\`.\n\n\n\\`updates\\` is \\`Tensor\\` of rank \\`Q-1+P-K\\` with shape:\n\n\n$$\\[d_0, ..., d_{Q-2}, input.shape\\[K\\], ..., input.shape\\[P-1\\]\\].$$\n\n\nFor example, say we want to add 4 scattered elements to a rank-1 tensor to 8\nelements. In Python, that addition would look like this:\n\n\ninput = tf.constant(\\[1, 2, 3, 4, 5, 6, 7, 8\\])\nindices = tf.constant(\\[\\[4\\], \\[3\\], \\[1\\], \\[7\\]\\])\nupdates = tf.constant(\\[9, 10, 11, 12\\])\noutput = tf.scatter_nd_non_aliasing_add(input, indices, updates)\nwith tf.Session() as sess:\nprint(sess.run(output))\n\n\nThe resulting value \\`output\\` would look like this:\n\n\n\\[1, 13, 3, 14, 14, 6, 7, 20\\]\n\n\nSee [`tf.scatter_nd`](https://www.tensorflow.org/api_docs/python/tf/scatter_nd) for more details about how to make updates to slices.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n### Public Methods\n\n|------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [Output](/api_docs/java/org/tensorflow/Output)\\\u003cT\\\u003e | [asOutput](/api_docs/java/org/tensorflow/op/core/ScatterNdNonAliasingAdd#asOutput())() Returns the symbolic handle of a tensor. |\n| static \\\u003cT, U extends Number\\\u003e [ScatterNdNonAliasingAdd](/api_docs/java/org/tensorflow/op/core/ScatterNdNonAliasingAdd)\\\u003cT\\\u003e | [create](/api_docs/java/org/tensorflow/op/core/ScatterNdNonAliasingAdd#create(org.tensorflow.op.Scope,%20org.tensorflow.Operand\u003cT\u003e,%20org.tensorflow.Operand\u003cU\u003e,%20org.tensorflow.Operand\u003cT\u003e))([Scope](/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](/api_docs/java/org/tensorflow/Operand)\\\u003cT\\\u003e input, [Operand](/api_docs/java/org/tensorflow/Operand)\\\u003cU\\\u003e indices, [Operand](/api_docs/java/org/tensorflow/Operand)\\\u003cT\\\u003e updates) Factory method to create a class wrapping a new ScatterNdNonAliasingAdd operation. |\n| [Output](/api_docs/java/org/tensorflow/Output)\\\u003cT\\\u003e | [output](/api_docs/java/org/tensorflow/op/core/ScatterNdNonAliasingAdd#output())() A \\`Tensor\\` with the same shape as \\`input\\`, containing values of \\`input\\` updated with \\`updates\\`. |\n\n### Inherited Methods\n\nFrom class [org.tensorflow.op.PrimitiveOp](/api_docs/java/org/tensorflow/op/PrimitiveOp) \n\n|------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| final boolean | [equals](/api_docs/java/org/tensorflow/op/PrimitiveOp#equals(java.lang.Object))(Object obj) |\n| final int | [hashCode](/api_docs/java/org/tensorflow/op/PrimitiveOp#hashCode())() |\n| [Operation](/api_docs/java/org/tensorflow/Operation) | [op](/api_docs/java/org/tensorflow/op/PrimitiveOp#op())() Returns the underlying [Operation](/api_docs/java/org/tensorflow/Operation) |\n| final String | [toString](/api_docs/java/org/tensorflow/op/PrimitiveOp#toString())() |\n\nFrom class java.lang.Object \n\n|------------------|---------------------------|\n| boolean | equals(Object arg0) |\n| final Class\\\u003c?\\\u003e | getClass() |\n| int | hashCode() |\n| final void | notify() |\n| final void | notifyAll() |\n| String | toString() |\n| final void | wait(long arg0, int arg1) |\n| final void | wait(long arg0) |\n| final void | wait() |\n\nFrom interface [org.tensorflow.Operand](/api_docs/java/org/tensorflow/Operand) \n\n|--------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|\n| abstract [Output](/api_docs/java/org/tensorflow/Output)\\\u003cT\\\u003e | [asOutput](/api_docs/java/org/tensorflow/Operand#asOutput())() Returns the symbolic handle of a tensor. |\n\nPublic Methods\n--------------\n\n#### public [Output](/api_docs/java/org/tensorflow/Output)\\\u003cT\\\u003e\n**asOutput**\n()\n\nReturns the symbolic handle of a tensor.\n\nInputs to TensorFlow operations are outputs of another TensorFlow operation. This method is\nused to obtain a symbolic handle that represents the computation of the input.\n\n\u003cbr /\u003e\n\n#### public static [ScatterNdNonAliasingAdd](/api_docs/java/org/tensorflow/op/core/ScatterNdNonAliasingAdd)\\\u003cT\\\u003e\n**create**\n([Scope](/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](/api_docs/java/org/tensorflow/Operand)\\\u003cT\\\u003e input, [Operand](/api_docs/java/org/tensorflow/Operand)\\\u003cU\\\u003e indices, [Operand](/api_docs/java/org/tensorflow/Operand)\\\u003cT\\\u003e updates)\n\nFactory method to create a class wrapping a new ScatterNdNonAliasingAdd operation. \n\n##### Parameters\n\n| scope | current scope |\n| input | A Tensor. |\n| indices | A Tensor. Must be one of the following types: \\`int32\\`, \\`int64\\`. A tensor of indices into \\`input\\`. |\n| updates | A Tensor. Must have the same type as ref. A tensor of updated values to add to \\`input\\`. |\n|---------|---------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- a new instance of ScatterNdNonAliasingAdd \n\n#### public [Output](/api_docs/java/org/tensorflow/Output)\\\u003cT\\\u003e\n**output**\n()\n\nA \\`Tensor\\` with the same shape as \\`input\\`, containing values of \\`input\\`\nupdated with \\`updates\\`."]]