Keras 3 API 文档 / 层 API / 预处理层 / 图像增强层 / RandomContrast 层

RandomContrast 层

[源代码]

RandomContrast

keras.layers.RandomContrast(factor, value_range=(0, 255), seed=None, **kwargs)

一个预处理层,在训练期间随机调整对比度。

此层将通过随机因子随机调整图像或多张图像的对比度。在训练期间,每个图像的每个通道的对比度都是独立调整的。

对于每个通道,此层计算通道中图像像素的均值,然后将每个像素的每个分量 x 调整为 (x - mean) * contrast_factor + mean

输入像素值可以是任何范围(例如 [0., 1.)[0, 255]),并且可以是整数或浮点 dtype。默认情况下,该层将输出浮点数。

注意: 此层可以安全地在 tf.data 管道中使用(与您使用的后端无关)。

输入形状

3D(未批处理)或 4D(已批处理)张量,形状为:(..., height, width, channels),采用 "channels_last" 格式。

输出形状

3D(未批处理)或 4D(已批处理)张量,形状为:(..., height, width, channels),采用 "channels_last" 格式。

参数

  • factor: 一个正浮点数,表示为值的比例,或大小为 2 的元组,表示下限和上限。当表示为单个浮点数时,下限 = 上限。对比度因子将在 [1.0 - lower, 1.0 + upper] 之间随机选择。对于通道中的任何像素 x,输出将为 (x - mean) * factor + mean,其中 mean 是通道的均值。
  • value_range: 输入图像将具有的值范围。表示为写成 [low, high] 的双数元组。这通常是 [0, 1][0, 255],具体取决于您的预处理管道的设置方式。
  • seed: 整数。用于创建随机种子。