tf.clip_by_value

Ограничивает значения тензора заданными минимальным и максимальным значениями.

tf.clip_by_value(
    t, clip_value_min, clip_value_max, name=None
)

Используется в блокнотах

Для заданного тензора t эта операция возвращает тензор того же типа и формы, что и t, значения которого ограничены диапазоном от clip_value_min до clip_value_max. Все значения меньше clip_value_min заменяются на clip_value_min. Все значения больше clip_value_max заменяются на clip_value_max.

Примечание: для корректного результата clip_value_min должно быть меньше или равно clip_value_max.

Например:

В простом случае в качестве минимального и максимального значений передаются скаляры.

t = tf.constant([[-10., -1., 0.], [0., 2., 10.]])
t2 = tf.clip_by_value(t, clip_value_min=-1, clip_value_max=1)
t2.numpy()
array([[-1., -1.,  0.],
       [ 0.,  1.,  1.]], dtype=float32)

Минимальное и максимальное значения могут иметь тот же размер, что и t, или быть совместимыми с ним при широковещательном распространении.

t = tf.constant([[-1, 0., 10.], [-1, 0, 10]])
clip_min = [[2],[1]]
t3 = tf.clip_by_value(t, clip_value_min=clip_min, clip_value_max=100)
t3.numpy()
array([[ 2.,  2., 10.],
       [ 1.,  1., 10.]], dtype=float32)

Широковещательное распространение намеренно завершается ошибкой, если оно приводит к увеличению размерности t

t = tf.constant([[-1, 0., 10.], [-1, 0, 10]])
clip_min = [[[2, 1]]] # Has a third axis
t4 = tf.clip_by_value(t, clip_value_min=clip_min, clip_value_max=100)
Traceback (most recent call last):

InvalidArgumentError: Incompatible shapes: [2,3] vs. [1,1,2]

Возникает исключение TypeError, если попытаться ограничить int значением типа float (сначала преобразуйте входные данные в float с помощью tf.cast).

t = tf.constant([[1, 2], [3, 4]], dtype=tf.int32)
t5 = tf.clip_by_value(t, clip_value_min=-3.1, clip_value_max=3.1)
Traceback (most recent call last):

TypeError: Cannot convert ...