tf.nn.conv1d
Stay organized with collections
Save and categorize content based on your preferences.
Computes a 1-D convolution given 3-D input and filter tensors.
tf.nn.conv1d(
input, filters, stride, padding, data_format='NWC', dilations=None, name=None
)
Given an input tensor of shape
[batch, in_width, in_channels]
if data_format is "NWC", or
[batch, in_channels, in_width]
if data_format is "NCW",
and a filter / kernel tensor of shape
[filter_width, in_channels, out_channels], this op reshapes
the arguments to pass them to conv2d to perform the equivalent
convolution operation.
Internally, this op reshapes the input tensors and invokes tf.nn.conv2d
.
For example, if data_format
does not start with "NC", a tensor of shape
[batch, in_width, in_channels]
is reshaped to
[batch, 1, in_width, in_channels],
and the filter is reshaped to
[1, filter_width, in_channels, out_channels].
The result is then reshaped back to
[batch, out_width, out_channels]
(where out_width is a function of the stride and padding as in conv2d) and
returned to the caller.
Args |
input
|
A 3D Tensor . Must be of type float16 , float32 , or float64 .
|
filters
|
A 3D Tensor . Must have the same type as input .
|
stride
|
An int or list of ints that has length 1 or 3 . The number of
entries by which the filter is moved right at each step.
|
padding
|
'SAME' or 'VALID'
|
data_format
|
An optional string from "NWC", "NCW" . Defaults to "NWC" ,
the data is stored in the order of [batch, in_width, in_channels]. The
"NCW" format stores data as [batch, in_channels, in_width].
|
dilations
|
An int or list of ints that has length 1 or 3 which
defaults to 1. The dilation factor for each dimension of input. If set to
k > 1, there will be k-1 skipped cells between each filter element on that
dimension. Dilations in the batch and depth dimensions must be 1.
|
name
|
A name for the operation (optional).
|
Returns |
A Tensor . Has the same type as input.
|
Raises |
ValueError
|
if data_format is invalid.
|
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 2020-10-01 UTC.
[null,null,["Last updated 2020-10-01 UTC."],[],[],null,["# tf.nn.conv1d\n\n|----------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|\n| [TensorFlow 1 version](/versions/r1.15/api_docs/python/tf/nn/conv1d) | [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.1.0/tensorflow/python/ops/nn_ops.py#L1686-L1748) |\n\nComputes a 1-D convolution given 3-D input and filter tensors. \n\n tf.nn.conv1d(\n input, filters, stride, padding, data_format='NWC', dilations=None, name=None\n )\n\nGiven an input tensor of shape\n\\[batch, in_width, in_channels\\]\nif data_format is \"NWC\", or\n\\[batch, in_channels, in_width\\]\nif data_format is \"NCW\",\nand a filter / kernel tensor of shape\n\\[filter_width, in_channels, out_channels\\], this op reshapes\nthe arguments to pass them to conv2d to perform the equivalent\nconvolution operation.\n\nInternally, this op reshapes the input tensors and invokes [`tf.nn.conv2d`](../../tf/nn/conv2d).\nFor example, if `data_format` does not start with \"NC\", a tensor of shape\n\\[batch, in_width, in_channels\\]\nis reshaped to\n\\[batch, 1, in_width, in_channels\\],\nand the filter is reshaped to\n\\[1, filter_width, in_channels, out_channels\\].\nThe result is then reshaped back to\n\\[batch, out_width, out_channels\\]\n(where out_width is a function of the stride and padding as in conv2d) and\nreturned to the caller.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `input` | A 3D `Tensor`. Must be of type `float16`, `float32`, or `float64`. |\n| `filters` | A 3D `Tensor`. Must have the same type as `input`. |\n| `stride` | An int or list of `ints` that has length `1` or `3`. The number of entries by which the filter is moved right at each step. |\n| `padding` | 'SAME' or 'VALID' |\n| `data_format` | An optional `string` from `\"NWC\", \"NCW\"`. Defaults to `\"NWC\"`, the data is stored in the order of \\[batch, in_width, in_channels\\]. The `\"NCW\"` format stores data as \\[batch, in_channels, in_width\\]. |\n| `dilations` | An int or list of `ints` that has length `1` or `3` which defaults to 1. The dilation factor for each dimension of input. If set to k \\\u003e 1, there will be k-1 skipped cells between each filter element on that dimension. Dilations in the batch and depth dimensions must be 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\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Raises ------ ||\n|--------------|------------------------------|\n| `ValueError` | if `data_format` is invalid. |\n\n\u003cbr /\u003e"]]