Stay organized with collections
Save and categorize content based on your preferences.
#include <image_ops.h>
Extracts a glimpse from the input tensor.
Summary
Returns a set of windows called glimpses extracted at location offsets from the input tensor. If the windows only partially overlaps the inputs, the non overlapping areas will be filled with random noise.
The result is a 4-D tensor of shape [batch_size, glimpse_height, glimpse_width, channels]. The channels and batch dimensions are the same as that of the input tensor. The height and width of the output windows are specified in the size parameter.
The argument normalized and centered controls how the windows are built:
- If the coordinates are normalized but not centered, 0.0 and 1.0 correspond to the minimum and maximum of each height and width dimension.
- If the coordinates are both normalized and centered, they range from -1.0 to 1.0. The coordinates (-1.0, -1.0) correspond to the upper left corner, the lower right corner is located at (1.0, 1.0) and the center is at (0, 0).
- If the coordinates are not normalized they are interpreted as numbers of pixels.
Args:
- scope: A Scope object
- input: A 4-D float tensor of shape
[batch_size, height, width, channels].
- size: A 1-D tensor of 2 elements containing the size of the glimpses to extract. The glimpse height must be specified first, following by the glimpse width.
- offsets: A 2-D integer tensor of shape
[batch_size, 2] containing the y, x locations of the center of each window.
Optional attributes (see Attrs):
- centered: indicates if the offset coordinates are centered relative to the image, in which case the (0, 0) offset is relative to the center of the input images. If false, the (0,0) offset corresponds to the upper left corner of the input images.
- normalized: indicates if the offset coordinates are normalized.
- uniform_noise: indicates if the noise should be generated using a uniform distribution or a Gaussian distribution.
- noise: indicates if the noise should
uniform, gaussian, or zero. The default is uniform which means the noise type will be decided by uniform_noise.
Returns:
Output: A tensor representing the glimpses [batch_size, glimpse_height, glimpse_width, channels].
Public attributes
Public functions
Public static functions
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 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[],[],null,["# tensorflow::ops::ExtractGlimpse Class Reference\n\ntensorflow::ops::ExtractGlimpse\n===============================\n\n`#include \u003cimage_ops.h\u003e`\n\nExtracts a glimpse from the input tensor.\n\nSummary\n-------\n\nReturns a set of windows called glimpses extracted at location `offsets` from the input tensor. If the windows only partially overlaps the inputs, the non overlapping areas will be filled with random noise.\n\nThe result is a 4-D tensor of shape `[batch_size, glimpse_height, glimpse_width, channels]`. The channels and batch dimensions are the same as that of the input tensor. The height and width of the output windows are specified in the `size` parameter.\n\nThe argument `normalized` and `centered` controls how the windows are built:\n\n\n- If the coordinates are normalized but not centered, 0.0 and 1.0 correspond to the minimum and maximum of each height and width dimension.\n- If the coordinates are both normalized and centered, they range from -1.0 to 1.0. The coordinates (-1.0, -1.0) correspond to the upper left corner, the lower right corner is located at (1.0, 1.0) and the center is at (0, 0).\n- If the coordinates are not normalized they are interpreted as numbers of pixels.\n\n\u003cbr /\u003e\n\nArgs:\n\n- scope: A [Scope](/versions/r2.14/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope) object\n- input: A 4-D float tensor of shape `[batch_size, height, width, channels]`.\n- size: A 1-D tensor of 2 elements containing the size of the glimpses to extract. The glimpse height must be specified first, following by the glimpse width.\n- offsets: A 2-D integer tensor of shape `[batch_size, 2]` containing the y, x locations of the center of each window.\n\n\u003cbr /\u003e\n\nOptional attributes (see [Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/extract-glimpse/attrs#structtensorflow_1_1ops_1_1_extract_glimpse_1_1_attrs)):\n\n- centered: indicates if the offset coordinates are centered relative to the image, in which case the (0, 0) offset is relative to the center of the input images. If false, the (0,0) offset corresponds to the upper left corner of the input images.\n- normalized: indicates if the offset coordinates are normalized.\n- uniform_noise: indicates if the noise should be generated using a uniform distribution or a Gaussian distribution.\n- noise: indicates if the noise should `uniform`, `gaussian`, or `zero`. The default is `uniform` which means the noise type will be decided by `uniform_noise`.\n\n\u003cbr /\u003e\n\nReturns:\n\n- [Output](/versions/r2.14/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output): A tensor representing the glimpses `[batch_size, glimpse_height, glimpse_width, channels]`.\n\n\u003cbr /\u003e\n\n| ### Constructors and Destructors ||\n|---|---|\n| [ExtractGlimpse](#classtensorflow_1_1ops_1_1_extract_glimpse_1ac8a9c699708b7ed7837cd2f6d9c5c960)`(const ::`[tensorflow::Scope](/versions/r2.14/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope)` & scope, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` input, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` size, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` offsets)` ||\n| [ExtractGlimpse](#classtensorflow_1_1ops_1_1_extract_glimpse_1a9e09f2f0c3cdc346a18adf000df718e9)`(const ::`[tensorflow::Scope](/versions/r2.14/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope)` & scope, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` input, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` size, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` offsets, const `[ExtractGlimpse::Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/extract-glimpse/attrs#structtensorflow_1_1ops_1_1_extract_glimpse_1_1_attrs)` & attrs)` ||\n\n| ### Public attributes ||\n|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| [glimpse](#classtensorflow_1_1ops_1_1_extract_glimpse_1a07929fd965047271b887835daf6a62f0) | `::`[tensorflow::Output](/versions/r2.14/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output) |\n| [operation](#classtensorflow_1_1ops_1_1_extract_glimpse_1ad83cc8bc3adacbbfa83216270c26afdf) | [Operation](/versions/r2.14/api_docs/cc/class/tensorflow/operation#classtensorflow_1_1_operation) |\n\n| ### Public functions ||\n|---------------------------------------------------------------------------------------------------------------------------|------------------------|\n| [node](#classtensorflow_1_1ops_1_1_extract_glimpse_1a2c22fcc3334291ced5542888967da833)`() const ` | `::tensorflow::Node *` |\n| [operator::tensorflow::Input](#classtensorflow_1_1ops_1_1_extract_glimpse_1aa8739e3ce187260c8592ff8ee5365479)`() const ` | |\n| [operator::tensorflow::Output](#classtensorflow_1_1ops_1_1_extract_glimpse_1a7e4ec40626bb935caf4f267647539c1e)`() const ` | |\n\n| ### Public static functions ||\n|----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| [Centered](#classtensorflow_1_1ops_1_1_extract_glimpse_1a1ae1ee7d233a8bb66ad6355cf707efb6)`(bool x)` | [Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/extract-glimpse/attrs#structtensorflow_1_1ops_1_1_extract_glimpse_1_1_attrs) |\n| [Noise](#classtensorflow_1_1ops_1_1_extract_glimpse_1a9398870f40e6fb56cd7eabadb1be1320)`(StringPiece x)` | [Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/extract-glimpse/attrs#structtensorflow_1_1ops_1_1_extract_glimpse_1_1_attrs) |\n| [Normalized](#classtensorflow_1_1ops_1_1_extract_glimpse_1a96c9927ae4bfed46c286e1d1675ed973)`(bool x)` | [Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/extract-glimpse/attrs#structtensorflow_1_1ops_1_1_extract_glimpse_1_1_attrs) |\n| [UniformNoise](#classtensorflow_1_1ops_1_1_extract_glimpse_1a9d8371a16ba771a5c114029dd2f5ee00)`(bool x)` | [Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/extract-glimpse/attrs#structtensorflow_1_1ops_1_1_extract_glimpse_1_1_attrs) |\n\n| ### Structs ||\n|-------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [tensorflow::ops::ExtractGlimpse::Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/extract-glimpse/attrs) | Optional attribute setters for [ExtractGlimpse](/versions/r2.14/api_docs/cc/class/tensorflow/ops/extract-glimpse#classtensorflow_1_1ops_1_1_extract_glimpse). |\n\nPublic attributes\n-----------------\n\n### glimpse\n\n```text\n::tensorflow::Output glimpse\n``` \n\n### operation\n\n```text\nOperation operation\n``` \n\nPublic functions\n----------------\n\n### ExtractGlimpse\n\n```gdscript\n ExtractGlimpse(\n const ::tensorflow::Scope & scope,\n ::tensorflow::Input input,\n ::tensorflow::Input size,\n ::tensorflow::Input offsets\n)\n``` \n\n### ExtractGlimpse\n\n```gdscript\n ExtractGlimpse(\n const ::tensorflow::Scope & scope,\n ::tensorflow::Input input,\n ::tensorflow::Input size,\n ::tensorflow::Input offsets,\n const ExtractGlimpse::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### Centered\n\n```text\nAttrs Centered(\n bool x\n)\n``` \n\n### Noise\n\n```text\nAttrs Noise(\n StringPiece x\n)\n``` \n\n### Normalized\n\n```text\nAttrs Normalized(\n bool x\n)\n``` \n\n### UniformNoise\n\n```text\nAttrs UniformNoise(\n bool x\n)\n```"]]
