tf.compat.v1.debugging.assert_shapes

Проверка форм тензоров и соотношений размеров размерностей между тензорами.

tf.compat.v1.debugging.assert_shapes(
    shapes, data=None, summarize=None, message=None, name=None
)

Этот оператор проверяет, что набор соотношений форм тензоров удовлетворяет заданным ограничениям.

Пример:

n = 10
q = 3
d = 7
x = tf.zeros([n,q])
y = tf.ones([n,d])
param = tf.Variable([1.0, 2.0, 3.0])
scalar = 1.0
tf.debugging.assert_shapes([
 (x, ('N', 'Q')),
 (y, ('N', 'D')),
 (param, ('Q',)),
 (scalar, ()),
])

tf.debugging.assert_shapes([
  (x, ('N', 'D')),
  (y, ('N', 'D'))
])
Traceback (most recent call last):

ValueError: ...

Пример добавления зависимости к операции:

with tf.control_dependencies([tf.assert_shapes(shapes)]):
  output = tf.matmul(x, y, transpose_a=True)

Если x, y, param или scalar не имеют форму, которая удовлетворяет всем заданным ограничениям, message, а также первые summarize элементы первого обнаруженного нарушающего тензора будут выведены, и будет поднято исключение InvalidArgumentError.

Элементы размера в указанных формах проверяются по отношению к другим элементам по их хешу, за исключением:

• элемент размера интерпретируется как явный размер, если его можно разобрать как целое числовое значение.
• элемент размера интерпретируется как любой размер, если он равен None или '.'.

Если первый элемент формы равен ... (тип Ellipsis) или '*', это указывает на переменное количество внешних размерностей неопределённого размера, т.е. ограничение применяется только к внутренним размерностям.

Скалярные тензоры и указанные формы длиной ноль (исключая префикс «внутренний») оба рассматриваются как имеющие одну размерность размера один.