Stay organized with collections
Save and categorize content based on your preferences.
tensorflow::
#include <array_ops.h>
Gather
slices from
params
according to
indices
.
Summary
indices
must be an integer tensor of any dimension (usually 0-D or 1-D). Produces an output tensor with shape
indices.shape + params.shape[1:]
where:
# Scalar indices
output[:, ..., :] = params[indices, :, ... :]
# Vector indices
output [ i, :, ..., : ] = params [ indices[i ] , : , ... :]
# Higher rank indices
output[i, ..., j, :, ... :] = params[indices[i, ..., j], :, ..., :]
If
indices
is a permutation and
len(indices) == params.shape[0]
then this operation will permute
params
accordingly.
validate_indices
: DEPRECATED. If this operation is assigned to CPU, values in
indices
are always validated to be within range. If assigned to GPU, out-of-bound indices result in safe but unspecified behavior, which may include raising an error.
Args:
Returns:
Public attributes
Public functions
node
:: tensorflow :: Node * node () const
operator :: tensorflow :: Input () const
operator::tensorflow::Output
operator :: tensorflow :: Output () const
Public static functions
ValidateIndices
Attrs ValidateIndices(
bool x
)
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. Some content is licensed under the numpy license .
Last updated 2021-08-16 UTC.
[null,null,["Last updated 2021-08-16 UTC."],[],[],null,["# tensorflow::ops::Gather Class Reference\n\ntensorflow::\nops::\nGather\n=========================\n\n`\n#include \u003carray_ops.h\u003e\n`\n\n\n[Gather](/versions/r2.6/api_docs/cc/class/tensorflow/ops/gather#classtensorflow_1_1ops_1_1_gather)\nslices from\n`\nparams\n`\naccording to\n`\nindices\n`\n.\n\nSummary\n-------\n\n\n`\nindices\n`\nmust be an integer tensor of any dimension (usually 0-D or 1-D). Produces an output tensor with shape\n`\nindices.shape + params.shape[1:]\n`\nwhere:\n\n\n```text\n # Scalar indices\n output[:, ..., :] = params[indices, :, ... :]\n```\n\n\u003cbr /\u003e\n\n\n```transact-sql\n # Vector indices\n output[i, :, ..., :] = params[indices[i], :, ... :]\n```\n\n\u003cbr /\u003e\n\n\n```text\n # Higher rank indices\n output[i, ..., j, :, ... :] = params[indices[i, ..., j], :, ..., :]\n```\n\n\u003cbr /\u003e\n\n\nIf\n`\nindices\n`\nis a permutation and\n`\nlen(indices) == params.shape[0]\n`\nthen this operation will permute\n`\nparams\n`\naccordingly.\n\n\n`\nvalidate_indices\n`\n: DEPRECATED. If this operation is assigned to CPU, values in\n`\nindices\n`\nare always validated to be within range. If assigned to GPU, out-of-bound indices result in safe but unspecified behavior, which may include raising an error.\n\n\n\u003cbr /\u003e\n\n\nArgs:\n\n- scope: A [Scope](/versions/r2.6/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope) object\n\n\u003cbr /\u003e\n\n\nReturns:\n\n- `\n `[Output](/versions/r2.6/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output)`\n ` : The output tensor.\n\n\u003cbr /\u003e\n\n| ### Constructors and Destructors ||\n|---|---|\n| ` `[Gather](#classtensorflow_1_1ops_1_1_gather_1a839275b14b2a970a2bdaafee039469dd)` (const :: `[tensorflow::Scope](/versions/r2.6/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope)` & scope, :: `[tensorflow::Input](/versions/r2.6/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` params, :: `[tensorflow::Input](/versions/r2.6/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` indices) ` ||\n| ` `[Gather](#classtensorflow_1_1ops_1_1_gather_1aafacd8f95dd561da28cb61d32a6a315f)` (const :: `[tensorflow::Scope](/versions/r2.6/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope)` & scope, :: `[tensorflow::Input](/versions/r2.6/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` params, :: `[tensorflow::Input](/versions/r2.6/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` indices, const `[Gather::Attrs](/versions/r2.6/api_docs/cc/struct/tensorflow/ops/gather/attrs#structtensorflow_1_1ops_1_1_gather_1_1_attrs)` & attrs) ` ||\n\n| ### Public attributes ||\n|------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|\n| ` `[operation](#classtensorflow_1_1ops_1_1_gather_1a324a25a3a94bb8ec9ea1f0c18e864f7d)` ` | ` `[Operation](/versions/r2.6/api_docs/cc/class/tensorflow/operation#classtensorflow_1_1_operation)` ` |\n| ` `[output](#classtensorflow_1_1ops_1_1_gather_1a9d78b5b304387efee0e53b5afaa384ef)` ` | ` :: `[tensorflow::Output](/versions/r2.6/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output)` ` |\n\n| ### Public functions ||\n|----------------------------------------------------------------------------------------------------------------------|--------------------------|\n| ` `[node](#classtensorflow_1_1ops_1_1_gather_1a6861dab37fe274f230029422bd94b724)` () const ` | ` ::tensorflow::Node * ` |\n| ` `[operator::tensorflow::Input](#classtensorflow_1_1ops_1_1_gather_1a8ea808391c4824b35409a4427fcfd5eb)` () const ` | ` ` |\n| ` `[operator::tensorflow::Output](#classtensorflow_1_1ops_1_1_gather_1a3dfd72e34f22afeaad6918d75a6cfdcd)` () const ` | ` ` |\n\n| ### Public static functions ||\n|---------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|\n| ` `[ValidateIndices](#classtensorflow_1_1ops_1_1_gather_1acb10767dcd5da7c1d454b97feafe2f3b)` (bool x) ` | ` `[Attrs](/versions/r2.6/api_docs/cc/struct/tensorflow/ops/gather/attrs#structtensorflow_1_1ops_1_1_gather_1_1_attrs)` ` |\n\n| ### Structs ||\n|----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| [tensorflow:: ops:: Gather:: Attrs](/versions/r2.6/api_docs/cc/struct/tensorflow/ops/gather/attrs) | Optional attribute setters for [Gather](/versions/r2.6/api_docs/cc/class/tensorflow/ops/gather#classtensorflow_1_1ops_1_1_gather) . |\n\nPublic attributes\n-----------------\n\n### operation\n\n```text\nOperation operation\n``` \n\n### output\n\n```text\n::tensorflow::Output output\n``` \n\nPublic functions\n----------------\n\n### Gather\n\n```gdscript\n Gather(\n const ::tensorflow::Scope & scope,\n ::tensorflow::Input params,\n ::tensorflow::Input indices\n)\n``` \n\n### Gather\n\n```gdscript\n Gather(\n const ::tensorflow::Scope & scope,\n ::tensorflow::Input params,\n ::tensorflow::Input indices,\n const Gather::Attrs & attrs\n)\n``` \n\n### node\n\n```gdscript\n::tensorflow::Node * node() const \n``` \n\n### operator::tensorflow::Input\n\n```gdscript\n operator::tensorflow::Input() const \n``` \n\n### operator::tensorflow::Output\n\n```gdscript\n operator::tensorflow::Output() const \n``` \n\nPublic static functions\n-----------------------\n\n### ValidateIndices\n\n```text\nAttrs ValidateIndices(\n bool x\n)\n```"]]
