tf.image.random_saturation | TensorFlow v2.16.1 (original) (raw)
tf.image.random_saturation
Stay organized with collections Save and categorize content based on your preferences.
Adjust the saturation of RGB images by a random factor.
View aliases
Compat aliases for migration
SeeMigration guide for more details.
tf.compat.v1.image.random_saturation
tf.image.random_saturation(
image, lower, upper, seed=None
)
Used in the notebooks
| Used in the tutorials |
|---|
| Fine tuning models for plant disease detection |
Equivalent to adjust_saturation() but uses a saturation_factor randomly picked in the interval [lower, upper).
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]]]
tf.image.random_saturation(x, 5, 10)
<tf.Tensor: shape=(2, 2, 3), dtype=float32, numpy=
array([[[ 0. , 1.5, 3. ],
[ 0. , 3. , 6. ]],
[[ 0. , 4.5, 9. ],
[ 0. , 6. , 12. ]]], dtype=float32)>
For producing deterministic results given a seed value, usetf.image.stateless_random_saturation. 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).
| 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 | 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. |