tf.image.stateless_random_saturation | TensorFlow v2.16.1 (original) (raw)
tf.image.stateless_random_saturation
Stay organized with collections Save and categorize content based on your preferences.
Adjust the saturation of RGB images by a random factor deterministically.
tf.image.stateless_random_saturation(
image, lower, upper, seed=None
)
Equivalent to adjust_saturation()
but uses a saturation_factor
randomly picked in the interval [lower, upper)
.
Guarantees 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).
Usage Example:
x = [[[1.0, 2.0, 3.0],
[4.0, 5.0, 6.0]],
[[7.0, 8.0, 9.0],
[10.0, 11.0, 12.0]]]
seed = (1, 2)
tf.image.stateless_random_saturation(x, 0.5, 1.0, seed)
<tf.Tensor: shape=(2, 2, 3), dtype=float32, numpy=
array([[[ 1.1559395, 2.0779698, 3. ],
[ 4.1559396, 5.07797 , 6. ]],
[[ 7.1559396, 8.07797 , 9. ],
[10.155939 , 11.07797 , 12. ]]], dtype=float32)>
Args | |
---|---|
image | RGB image or images. The 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 | A shape [2] Tensor, the seed to the random number generator. Must have dtype int32 or int64. (When using XLA, only int32 is allowed.) |
Returns |
---|
Adjusted image(s), same shape and DType as image. |
Raises | |
---|---|
ValueError | if upper <= lower or if lower < 0. |