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