# tf.keras.preprocessing.image.random_shift

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/keras-team/keras/tree/v2.13.1/keras/preprocessing/image.py#L2200-L2255) |

Performs a random spatial shift of a Numpy image tensor.

#### View aliases


**Compat aliases for migration**

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

\`tf.compat.v1.keras.preprocessing.image.random_shift\`

<br />

    tf.keras.preprocessing.image.random_shift(
        x,
        wrg,
        hrg,
        row_axis=1,
        col_axis=2,
        channel_axis=0,
        fill_mode='nearest',
        cval=0.0,
        interpolation_order=1
    )

> [!WARNING]
> **Deprecated:** [`tf.keras.preprocessing.image.random_shift`](https://www.tensorflow.org/versions/r2.13/api_docs/python/tf/keras/preprocessing/image/random_shift) does not operate on tensors and is not recommended for new code. Prefer [`tf.keras.layers.RandomTranslation`](https://www.tensorflow.org/versions/r2.13/api_docs/python/tf/keras/layers/RandomTranslation) which provides equivalent functionality as a preprocessing layer. For more information, see the tutorial for [augmenting images](https://www.tensorflow.org/tutorials/images/data_augmentation), as well as the [preprocessing layer guide](https://www.tensorflow.org/guide/keras/preprocessing_layers).

<br />

<br />

<br />

| ## Args ||
|---|---|
| `x` | Input tensor. Must be 3D. |
| `wrg` | Width shift range, as a float fraction of the width. |
| `hrg` | Height shift range, as a float fraction of the height. |
| `row_axis` | Index of axis for rows in the input tensor. |
| `col_axis` | Index of axis for columns in the input tensor. |
| `channel_axis` | Index of axis for channels in the input tensor. |
| `fill_mode` | Points outside the boundaries of the input are filled according to the given mode (one of `{'constant', 'nearest', 'reflect', 'wrap'}`). |
| `cval` | Value used for points outside the boundaries of the input if `mode='constant'`. |
| `interpolation_order` | int, order of spline interpolation. see `ndimage.interpolation.affine_transform` |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| Shifted Numpy image tensor. ||

<br />