Spec-Zone.ru › TensorFlow 2.3

tf.transpose

View source on 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 Тензор.
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.3/api_docs/python/tf/transpose

Spec-Zone.ru

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