Spec-Zone.ru › TensorFlow 2.4

tf.transpose

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

Транспонирует a, где a — это тензор.

tf.transpose(
    a, perm=None, conjugate=False, name='transpose'
)

Меняет порядок измерений в соответствии со значением perm.

Измерение i возвращаемого тензора будет соответствовать измерению perm[i]. Если perm не задано, оно устанавливается в (n-1...0), где n — ранг входного тензора. Таким образом, по умолчанию данная операция выполняет обычную транспозицию матрицы для входных тензоров 2-го порядка.

Если conjugate равно True и a.dtype равно complex64 или complex128, то значения a конъюгируются и транспонируются.

Например:

x = tf.constant([[1, 2, 3], [4, 5, 6]])
tf.transpose(x)
<tf.Tensor: shape=(3, 2), dtype=int32, numpy=
array([[1, 4],
       [2, 5],
       [3, 6]], dtype=int32)>

Аналогично, можно вызвать tf.transpose(x, perm=[1, 0]).

Если x является комплексным, установка conjugate=True даёт сопряжённую транспозицию:

x = tf.constant([[1 + 1j, 2 + 2j, 3 + 3j],
                 [4 + 4j, 5 + 5j, 6 + 6j]])
tf.transpose(x, conjugate=True)
<tf.Tensor: shape=(3, 2), dtype=complex128, numpy=
array([[1.-1.j, 4.-4.j],
       [2.-2.j, 5.-5.j],
       [3.-3.j, 6.-6.j]])>

'perm' более полезен для тензоров n-го порядка, где n > 2:

x = tf.constant([[[ 1,  2,  3],
                  [ 4,  5,  6]],
                 [[ 7,  8,  9],
                  [10, 11, 12]]])

Как и выше, просто вызов tf.transpose по умолчанию будет соответствовать perm=[2,1,0].

Чтобы получить транспонирование матриц в измерении-0 (например, когда вы транспонируете матрицы, где 0 — размерность пакета), необходимо установить perm=[0,2,1].

tf.transpose(x, perm=[0, 2, 1])
<tf.Tensor: shape=(2, 3, 2), dtype=int32, numpy=
array([[[ 1,  4],
        [ 2,  5],
        [ 3,  6]],
        [[ 7, 10],
        [ 8, 11],
        [ 9, 12]]], dtype=int32)>
Примечание: У этой операции есть сокращенная запись linalg.matrix_transpose):
Аргументы
a Tensor.
perm Перестановка измерений a. Это должен быть вектор.
conjugate Необязательный bool. Установка в значение True математически эквивалентна tf.math.conj(tf.transpose(input)).
name Имя операции (необязательно).
Возвращаемое значение
Транспонированный Tensor.

Совместимость с NumPy

В NumPy транспозиции — это эффективные операции с постоянной сложностью, так как они просто возвращают новый вид тех же данных с изменёнными strides.

TensorFlow не поддерживает шаги, поэтому transpose возвращает новый тензор с переставленными элементами.

© 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.4/api_docs/python/tf/transpose

Spec-Zone.ru

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