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]),并且可以是整数或浮点数据类型。默认情况下,该层将输出浮点数。

注意:此层可以在 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:整数。用于创建随机种子。