# tensorflow::ops::Conv

`#include <nn_ops.h>`

Computes a N-D convolution given (N+1+batch_dims)-D `input` and (N+2)-D `filter` tensors.

## Summary

General function for computing a N-D convolution. It is required that `1 <= N <= 3`.

Args:

- scope: A [Scope](https://www.tensorflow.org/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope) object
- input: [Tensor](https://www.tensorflow.org/api_docs/cc/class/tensorflow/tensor#classtensorflow_1_1_tensor) of type T and shape `batch_shape + spatial_shape + [in_channels]` in the case that `channels_last_format = true` or shape `batch_shape + [in_channels] + spatial_shape` if `channels_last_format = false`. spatial_shape is N-dimensional with `N=2` or `N=3`. Also note that `batch_shape` is dictated by the parameter `batch_dims` and defaults to 1.
- filter: An `(N+2)-D`[Tensor](https://www.tensorflow.org/api_docs/cc/class/tensorflow/tensor#classtensorflow_1_1_tensor) with the same type as `input` and shape `spatial_filter_shape + [in_channels, out_channels]`, where spatial_filter_shape is N-dimensional with `N=2` or `N=3`.
- strides: 1-D tensor of length `N+2`. The stride of the sliding window for each dimension of `input`. Must have `strides[0] = strides[N+1] = 1`.
- padding: The type of padding algorithm to use.

<br />

Optional attributes (see `https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs#structtensorflow_1_1ops_1_1_conv_1_1_attrs`):

- explicit_paddings: If `padding` is `"EXPLICIT"`, the list of explicit padding amounts. For the ith dimension, the amount of padding inserted before and after the dimension is `explicit_paddings[2 * i]` and `explicit_paddings[2 * i + 1]`, respectively. If `padding` is not `"EXPLICIT"`, `explicit_paddings` must be empty.
- data_format: Used to set the data format. By default `CHANNELS_FIRST`, uses `NHWC (2D) / NDHWC (3D)` or if `CHANNELS_LAST`, uses `NCHW (2D) / NCDHW (3D)`.
- dilations: 1-D tensor of length `N+2`. 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. The dimension order is determined by the value of `channels_last_format`, see above for details. Dilations in the batch and depth dimensions must be 1.
- batch_dims: A positive integer specifying the number of batch dimensions for the input tensor. Should be less than the rank of the input tensor.
- groups: A positive integer specifying the number of groups in which the input is split along the channel axis. Each group is convolved separately with `filters / groups` filters. The output is the concatenation of all the groups results along the channel axis. [Input](https://www.tensorflow.org/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input) channels and filters must both be divisible by groups.

<br />

Returns:

- `https://www.tensorflow.org/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output`: A (N+1+batch_dims)-D tensor. The dimension order is determined by the value of `channels_last_format`, see below for details.

<br />

| ### Constructors and Destructors ||
|---|---|
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a6287e3e083783a8839a1e5945a0c235d(const ::https://www.tensorflow.org/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope & scope, ::https://www.tensorflow.org/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input input, ::https://www.tensorflow.org/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input filter, const gtl::ArraySlice< int > & strides, StringPiece padding)` ||
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a1a0454a47a9d1b7998b9c19337fdee0c(const ::https://www.tensorflow.org/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope & scope, ::https://www.tensorflow.org/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input input, ::https://www.tensorflow.org/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input filter, const gtl::ArraySlice< int > & strides, StringPiece padding, const https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs#structtensorflow_1_1ops_1_1_conv_1_1_attrs & attrs)` ||

| ### Public attributes ||
|---|---|
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a9c0bde16ef271157408f8cad028021a0` | `https://www.tensorflow.org/api_docs/cc/class/tensorflow/operation#classtensorflow_1_1_operation` |
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1ac432deaf8fb63d377d5eae640a9a0308` | `::https://www.tensorflow.org/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output` |

| ### Public functions ||
|---|---|
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a54d008d9e6715102204ff35fc4bef53a() const ` | `::tensorflow::Node *` |
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a613baefcadce3a2640b1d206bb795a74() const ` |   |
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a9bbdcbdb0c3ddec45158a5bba02b5bf0() const ` |   |

| ### Public static functions ||
|---|---|
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a03e8a203323605e33f404e25f52e2cf9(int64 x)` | `https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs#structtensorflow_1_1ops_1_1_conv_1_1_attrs` |
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a478c74724f59413a66761e6058459a84(StringPiece x)` | `https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs#structtensorflow_1_1ops_1_1_conv_1_1_attrs` |
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a2bdf588ff1cd3ee5dfa6fae0fafda7ff(const gtl::ArraySlice< int > & x)` | `https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs#structtensorflow_1_1ops_1_1_conv_1_1_attrs` |
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1aeb4e34adfe40a96577628f9c92db0ae5(const gtl::ArraySlice< int > & x)` | `https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs#structtensorflow_1_1ops_1_1_conv_1_1_attrs` |
| `https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv_1a90dc2a0db109c13a7a5d03b186607e24(int64 x)` | `https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs#structtensorflow_1_1ops_1_1_conv_1_1_attrs` |

| ### Structs ||
|---|---|
| [tensorflow::ops::Conv::Attrs](https://www.tensorflow.org/api_docs/cc/struct/tensorflow/ops/conv/attrs) | Optional attribute setters for [Conv](https://www.tensorflow.org/api_docs/cc/class/tensorflow/ops/conv#classtensorflow_1_1ops_1_1_conv). |

## Public attributes

### operation

```
Operation operation
```

### output

```
::tensorflow::Output output
```

## Public functions

### Conv

```
 Conv(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  ::tensorflow::Input filter,
  const gtl::ArraySlice< int > & strides,
  StringPiece padding
)
```

### Conv

```
 Conv(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  ::tensorflow::Input filter,
  const gtl::ArraySlice< int > & strides,
  StringPiece padding,
  const Conv::Attrs & attrs
)
```

### node

```
::tensorflow::Node * node() const 
```

### operator::tensorflow::Input

```
 operator::tensorflow::Input() const 
```

### operator::tensorflow::Output

```
 operator::tensorflow::Output() const 
```

## Public static functions

### BatchDims

```
Attrs BatchDims(
  int64 x
)
```

### DataFormat

```
Attrs DataFormat(
  StringPiece x
)
```

### Dilations

```
Attrs Dilations(
  const gtl::ArraySlice< int > & x
)
```

### ExplicitPaddings

```
Attrs ExplicitPaddings(
  const gtl::ArraySlice< int > & x
)
```

### Groups

```
Attrs Groups(
  int64 x
)
```