tf.keras.layers.RandomSaturation

See Stable See Nightly

Randomly adjusts the saturation on given images.

Inherits From: Layer, Operation

tf.keras.layers.RandomSaturation(
    factor, value_range=(0, 255), data_format=None, seed=None, **kwargs
)

This layer will randomly increase/reduce the saturation for the input RGB images.

Note: This layer is safe to use inside a tf.data or grain pipeline (independently of which backend you're using).

Args
factor	A tuple of two floats or a single float. factor controls the extent to which the image saturation is impacted. factor=0.5 makes this layer perform a no-op operation. factor=0.0 makes the image fully grayscale. factor=1.0 makes the image fully saturated. Values should be between 0.0 and 1.0. If a tuple is used, a factor is sampled between the two values for every image augmented. If a single float is used, a value between 0.0 and the passed float is sampled. To ensure the value is always the same, pass a tuple with two identical floats: (0.5, 0.5).
value_range	the range of values the incoming images will have. Represented as a two-number tuple written [low, high]. This is typically either [0, 1] or [0, 255] depending on how your preprocessing pipeline is set up.
seed	Integer. Used to create a random seed.

Example:

(images, labels), _ = keras.datasets.cifar10.load_data()
images = images.astype("float32")
random_saturation = keras.layers.RandomSaturation(factor=0.2)
augmented_images = random_saturation(images)

Attributes
input	Retrieves the input tensor(s) of a symbolic operation. Only returns the tensor(s) corresponding to the first time the operation was called.
output	Retrieves the output tensor(s) of a layer. Only returns the tensor(s) corresponding to the first time the operation was called.

Methods

convert_weight

View source

convert_weight(
    weight
)

Convert the weight if it is from the a different backend.

from_config

View source

@classmethod
from_config(
    config
)

Creates an operation from its config.

This method is the reverse of get_config, capable of instantiating the same operation from the config dictionary.

Note: If you override this method, you might receive a serialized dtype config, which is a dict. You can deserialize it as follows:

if "dtype" in config and isinstance(config["dtype"], dict):
    policy = dtype_policies.deserialize(config["dtype"])

Args
config	A Python dictionary, typically the output of get_config.

Returns
An operation instance.

get_random_transformation

View source

get_random_transformation(
    data, training=True, seed=None
)

transform_bounding_boxes

View source

transform_bounding_boxes(
    bounding_boxes, transformation, training=True
)

transform_images

View source

transform_images(
    images, transformation=None, training=True
)

transform_labels

View source

transform_labels(
    labels, transformation, training=True
)

transform_segmentation_masks

View source

transform_segmentation_masks(
    segmentation_masks, transformation, training=True
)

transform_single_bounding_box

View source

transform_single_bounding_box(
    bounding_box, transformation, training=True
)

transform_single_image

View source

transform_single_image(
    image, transformation, training=True
)

transform_single_label

View source

transform_single_label(
    label, transformation, training=True
)

transform_single_segmentation_mask

View source

transform_single_segmentation_mask(
    segmentation_mask, transformation, training=True
)