tf.nn.dilation2d
Stay organized with collections
Save and categorize content based on your preferences.
Computes the grayscale dilation of 4-D input
and 3-D filters
tensors.
tf.nn.dilation2d(
input, filters, strides, padding, data_format, dilations, name=None
)
The input
tensor has shape [batch, in_height, in_width, depth]
and the
filters
tensor has shape [filter_height, filter_width, depth]
, i.e., each
input channel is processed independently of the others with its own
structuring function. The output
tensor has shape
[batch, out_height, out_width, depth]
. The spatial dimensions of the output
tensor depend on the padding
algorithm. We currently only support the
default "NHWC" data_format
.
In detail, the grayscale morphological 2-D dilation is the max-sum correlation
(for consistency with conv2d
, we use unmirrored filters):
output[b, y, x, c] =
max_{dy, dx} input[b,
strides[1] * y + rates[1] * dy,
strides[2] * x + rates[2] * dx,
c] +
filters[dy, dx, c]
Max-pooling is a special case when the filter has size equal to the pooling
kernel size and contains all zeros.
Note on duality: The dilation of input
by the filters
is equal to the
negation of the erosion of -input
by the reflected filters
.
Args |
input
|
A Tensor . Must be one of the following types: float32 , float64 ,
int32 , uint8 , int16 , int8 , int64 , bfloat16 , uint16 , half ,
uint32 , uint64 .
4-D with shape [batch, in_height, in_width, depth] .
|
filters
|
A Tensor . Must have the same type as input .
3-D with shape [filter_height, filter_width, depth] .
|
strides
|
A list of ints that has length >= 4 .
The stride of the sliding window for each dimension of the input
tensor. Must be: [1, stride_height, stride_width, 1] .
|
padding
|
A string from: "SAME", "VALID" .
The type of padding algorithm to use. See
here
for more information.
|
data_format
|
A string , only "NHWC" is currently supported.
|
dilations
|
A list of ints that has length >= 4 .
The input stride for atrous morphological dilation. Must be:
[1, rate_height, rate_width, 1] .
|
name
|
A name for the operation (optional).
|
Returns |
A Tensor . Has the same type as input .
|
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 2024-04-26 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 2024-04-26 UTC."],[],[],null,["# tf.nn.dilation2d\n\n\u003cbr /\u003e\n\n|--------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.16.1/tensorflow/python/ops/nn_ops.py#L482-L550) |\n\nComputes the grayscale dilation of 4-D `input` and 3-D `filters` tensors. \n\n tf.nn.dilation2d(\n input, filters, strides, padding, data_format, dilations, name=None\n )\n\nThe `input` tensor has shape `[batch, in_height, in_width, depth]` and the\n`filters` tensor has shape `[filter_height, filter_width, depth]`, i.e., each\ninput channel is processed independently of the others with its own\nstructuring function. The `output` tensor has shape\n`[batch, out_height, out_width, depth]`. The spatial dimensions of the output\ntensor depend on the `padding` algorithm. We currently only support the\ndefault \"NHWC\" `data_format`.\n\nIn detail, the grayscale morphological 2-D dilation is the max-sum correlation\n(for consistency with `conv2d`, we use unmirrored filters): \n\n output[b, y, x, c] =\n max_{dy, dx} input[b,\n strides[1] * y + rates[1] * dy,\n strides[2] * x + rates[2] * dx,\n c] +\n filters[dy, dx, c]\n\nMax-pooling is a special case when the filter has size equal to the pooling\nkernel size and contains all zeros.\n\nNote on duality: The dilation of `input` by the `filters` is equal to the\nnegation of the erosion of `-input` by the reflected `filters`.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `input` | A `Tensor`. Must be one of the following types: `float32`, `float64`, `int32`, `uint8`, `int16`, `int8`, `int64`, `bfloat16`, `uint16`, `half`, `uint32`, `uint64`. 4-D with shape `[batch, in_height, in_width, depth]`. |\n| `filters` | A `Tensor`. Must have the same type as `input`. 3-D with shape `[filter_height, filter_width, depth]`. |\n| `strides` | A list of `ints` that has length `\u003e= 4`. The stride of the sliding window for each dimension of the input tensor. Must be: `[1, stride_height, stride_width, 1]`. |\n| `padding` | A `string` from: `\"SAME\", \"VALID\"`. The type of padding algorithm to use. See [here](https://www.tensorflow.org/api_docs/python/tf/nn#notes_on_padding_2) for more information. |\n| `data_format` | A `string`, only `\"NHWC\"` is currently supported. |\n| `dilations` | A list of `ints` that has length `\u003e= 4`. The input stride for atrous morphological dilation. Must be: `[1, rate_height, rate_width, 1]`. |\n| `name` | A name for the operation (optional). |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A `Tensor`. Has the same type as `input`. ||\n\n\u003cbr /\u003e"]]