# tf.image.random_saturation

<br />

|---|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 2 version](https://www.tensorflow.org/api_docs/python/tf/image/random_saturation) | [![](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/image_ops_impl.py#L2050-L2080) |

Adjust the saturation of RGB images by a random factor.

#### View aliases


**Compat aliases for migration**

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

[`tf.compat.v1.image.random_saturation`](https://www.tensorflow.org/api_docs/python/tf/image/random_saturation), \`tf.compat.v2.image.random_saturation\`

<br />

    tf.image.random_saturation(
        image, lower, upper, seed=None
    )

Equivalent to `adjust_saturation()` but uses a `saturation_factor` randomly
picked in the interval `[lower, upper]`.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `image` | RGB image or images. Size of the last dimension must be 3. |
| `lower` | float. Lower bound for the random saturation factor. |
| `upper` | float. Upper bound for the random saturation factor. |
| `seed` | An operation-specific seed. It will be used in conjunction with the graph-level seed to determine the real seeds that will be used in this operation. Please see the documentation of set_random_seed for its interaction with the graph-level random seed. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| Adjusted image(s), same shape and DType as `image`. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | if `upper <= lower` or if `lower < 0`. |

<br />