# tf.image.random_flip_up_down

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.8.4/tensorflow/python/ops/image_ops_impl.py#L327-L371) |

Randomly flips an image vertically (upside down).

#### View aliases


**Compat aliases for migration**

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

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

<br />

    tf.image.random_flip_up_down(
        image, seed=None
    )

With a 1 in 2 chance, outputs the contents of `image` flipped along the first
dimension, which is `height`. Otherwise, output the image as-is.
When passing a batch of images, each image will be randomly flipped
independent of other images.

#### Example usage:

    image = np.array([[[1], [2]], [[3], [4]]])
    tf.image.random_flip_up_down(image, 3).numpy().tolist()
    [[[3], [4]], [[1], [2]]]

Randomly flip multiple images.

    images = np.array(
    [
        [[[1], [2]], [[3], [4]]],
        [[[5], [6]], [[7], [8]]]
    ])
    tf.image.random_flip_up_down(images, 4).numpy().tolist()
    [[[[3], [4]], [[1], [2]]], [[[5], [6]], [[7], [8]]]]

For producing deterministic results given a `seed` value, use
[`tf.image.stateless_random_flip_up_down`](https://www.tensorflow.org/versions/r2.8/api_docs/python/tf/image/stateless_random_flip_up_down). Unlike using the `seed` param
with `tf.image.random_*` ops, `tf.image.stateless_random_*` ops guarantee the
same results given the same seed independent of how many times the function is
called, and independent of global seed settings (e.g. tf.random.set_seed).

<br />

<br />

<br />

| ## Args ||
|---|---|
| `image` | 4-D Tensor of shape `[batch, height, width, channels]` or 3-D Tensor of shape `[height, width, channels]`. |
| `seed` | A Python integer. Used to create a random seed. See [`tf.compat.v1.set_random_seed`](https://www.tensorflow.org/versions/r2.8/api_docs/python/tf/compat/v1/set_random_seed) for behavior. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A tensor of the same type and shape as `image`. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | if the shape of `image` not supported. |

<br />