TensorFlow 2.0 Beta is available Learn more

tf.image.random_saturation

Adjust the saturation of RGB images by a random factor.

Aliases:

  • tf.compat.v1.image.random_saturation
  • tf.compat.v2.image.random_saturation
  • tf.image.random_saturation
tf.image.random_saturation(
    image,
    lower,
    upper,
    seed=None
)

Defined in python/ops/image_ops_impl.py.

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

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.

Returns:

Adjusted image(s), same shape and DType as image.

Raises:

  • ValueError: if upper <= lower or if lower < 0.