# tf.nn.conv1d

|---|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 2 version](https://www.tensorflow.org/api_docs/python/tf/nn/conv1d) | [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v1.15.0/tensorflow/python/ops/nn_ops.py#L1587-L1682) |

Computes a 1-D convolution given 3-D input and filter tensors. (deprecated argument values) (deprecated argument values)

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.nn.conv1d`](https://www.tensorflow.org/api_docs/python/tf/compat/v1/nn/conv1d)

<br />

    tf.nn.conv1d(
        value=None, filters=None, stride=None, padding=None, use_cudnn_on_gpu=None,
        data_format=None, name=None, input=None, dilations=None
    )

> [!WARNING]
> **Warning:** SOME ARGUMENT VALUES ARE DEPRECATED: `(data_format='NCHW')`. They will be removed in a future version. Instructions for updating: `NCHW` for data_format is deprecated, use `NCW` instead

> [!WARNING]
> **Warning:** SOME ARGUMENT VALUES ARE DEPRECATED: `(data_format='NHWC')`. They will be removed in a future version. Instructions for updating: `NHWC` for data_format is deprecated, use `NWC` instead

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`](https://www.tensorflow.org/versions/r1.15/api_docs/python/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.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `value` | A 3D `Tensor`. Must be of type `float16`, `float32`, or `float64`. |
| `filters` | A 3D `Tensor`. Must have the same type as `value`. |
| `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' |
| `use_cudnn_on_gpu` | An optional `bool`. Defaults to `True`. |
| `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\]. |
| `name` | A name for the operation (optional). |
| `input` | Alias for value. |
| `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. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A `Tensor`. Has the same type as input. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | if `data_format` is invalid. |

<br />