Keras 3 API documentation
Models API Layers API The base Layer class Layer activations Layer weight initializers Layer weight regularizers Layer weight constraints Core layers Convolution layers Pooling layers Recurrent layers Preprocessing layers Normalization layers Regularization layers Attention layers Reshaping layers Merging layers Activation layers Backend-specific layers Callbacks API Ops API Optimizers Metrics Losses Data loading Tree API Built-in small datasets Keras Applications Mixed precision Multi-device distribution RNG API Quantizers Scope Rematerialization Utilities
Keras 2 API documentation
► Keras 3 API documentation / Layers API / Preprocessing layers / Image augmentation layers / RandomInvert layer

RandomInvert layer

[source]

RandomInvert class

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

Preprocessing layer for random inversion of image colors.

This layer randomly inverts the colors of input images with a specified
probability range. When applied, each image has a chance of having its
colors inverted, where the pixel values are transformed to their
complementary values. Images that are not selected for inversion
remain unchanged.

**Note:** This layer is safe to use inside a [`tf.data`](https://www.tensorflow.org/api_docs/python/tf/data) or `grain` pipeline
(independently of which backend you're using).

# Arguments
    factor: A single float or a tuple of two floats.
        `factor` controls the probability of inverting the image colors.
        If a tuple is provided, the value is sampled between the two values
        for each image, where `factor[0]` is the minimum and `factor[1]` is
        the maximum probability. If a single float is provided, a value
        between `0.0` and the provided float is sampled.
        Defaults to `(0, 1)`.
    value_range: a tuple or a list of two elements. The first value
        represents the lower bound for values in passed images, the second
        represents the upper bound. Images passed to the layer should have
        values within `value_range`. Defaults to `(0, 255)`.
    seed: Integer. Used to create a random seed.

# Example

layer = keras.layers.RandomInvert(value_range=(0, 255))
images = np.random.randint(0, 255, (8, 224, 224, 3), dtype="uint8")

labels = keras.ops.one_hot(
    np.array([0, 1, 2, 0, 1, 2, 0, 1]),
    num_classes=3
)

segmentation_masks = np.random.randint(0, 3, (8, 224, 224, 1), dtype="uint8")

output = layer(
    {
        "images": images,
        "labels": labels,
        "segmentation_masks": segmentation_masks
    },
    training=True
)
RandomInvert layer
RandomInvert class