Spec-Zone.ru › TensorFlow 2.3

tf.tensordot

Просмотреть исходный код на GitHub

Тензорное сокращение a и b по указанным осям и внешнее произведение.

Просмотр псевдонимов

Основные псевдонимы

tf.linalg.tensordot

Псевдонимы совместимости для миграции

См. Руководство по миграции для получения более подробной информации.

tf.compat.v1.linalg.tensordot, tf.compat.v1.tensordot

tf.tensordot(
    a, b, axes, name=None
)

Tensordot (также известный как тензорное сокращение) суммирует произведение элементов из a и b по индексам, указанным в a_axes и b_axes. Списки a_axes и b_axes указывают пары осей, по которым необходимо сократить тензоры. Ось a_axes[i] тензора a должна иметь одинаковую размерность с осью b_axes[i] тензора b для всех i в range(0, len(a_axes)). Списки a_axes и b_axes должны иметь одинаковую длину и состоять из уникальных целых чисел, определяющих допустимые оси для каждого тензора. Кроме того, поддерживается внешнее произведение, передавая axes=0.

Эта операция соответствует numpy.tensordot(a, b, axes).

Пример 1: Когда a и b являются матрицами (порядка 2), случай axes = 1 эквивалентен умножению матриц.

Пример 2: Когда a и b являются матрицами (порядка 2), случай axes = [[1], [0]] эквивалентен умножению матриц.

Пример 3: Когда a и b являются матрицами (порядка 2), случай axes=0 даёт внешнее произведение, тензор порядка 4.

Пример 4: Предположим, что \(a_{ijk}\) и \(b_{lmn}\) представляют два тензора порядка 3. Тогда, contract(a, b, [[0], [2]]) является тензором порядка 4 \(c_{jklm}\), чья запись, соответствующая индексам \((j,k,l,m)\) задаётся следующим образом:

\( c_{jklm} = \sum_i a_{ijk} b_{lmi} \).

В общем случае, order(c) = order(a) + order(b) - 2*len(axes[0]).

Аргументы
a Tensor типа float32 или float64.
b Tensor с тем же типом, что и a.
axes Либо скаляр N, либо список или int32 Tensor формы [2, k]. Если axes является скаляром, суммирование происходит по последним N осям a и первым N осям b в порядке. Если axes является списком или Tensor первой и второй строка содержат набор уникальных целых чисел, определяющих оси, по которым происходит сокращение, для a и b, соответственно. Количество осей для a и b должно быть одинаковым. Если axes=0, вычисляется внешнее произведение между a и b.
name Имя операции (необязательно).
Возвращаемое значение
A Tensor с тем же типом, что и a.
Исключения
ValueError Если формы a, b, и axes несовместимы.
IndexError Если значения в axes превышают ранг соответствующего тензора.

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/tensordot

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API