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.datagrain 管道中使用(无论您使用的是哪个后端),且是安全的。

输入形状

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

输出形状

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

参数

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