# tf.contrib.image.translate

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v1.15.0/tensorflow/contrib/image/python/ops/image_ops.py#L102-L127) |

Translate image(s) by the passed vectors(s).

    tf.contrib.image.translate(
        images, translations, interpolation='NEAREST', name=None
    )

<br />

<br />

<br />

| ## Args ||
|---|---|
| `images` | A tensor of shape (num_images, num_rows, num_columns, num_channels) (NHWC), (num_rows, num_columns, num_channels) (HWC), or (num_rows, num_columns) (HW). The rank must be statically known (the shape is not `TensorShape(None)`. |
| `translations` | A vector representing \[dx, dy\] or (if images has rank 4) a matrix of length num_images, with a \[dx, dy\] vector for each image in the batch. |
| `interpolation` | Interpolation mode. Supported values: "NEAREST", "BILINEAR". |
| `name` | The name of the op. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| Image(s) with the same type and shape as `images`, translated by the given vector(s). Empty space due to the translation will be filled with zeros. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `TypeError` | If `image` is an invalid type. |

<br />