Возвращает пакетный матричный тензор с новыми пакетными значениями диагонали.
Учитывая `input` и `diagonal`, эта операция возвращает тензор той же формы и значений, что и `input`, за исключением указанных диагоналей самых внутренних матриц. Они будут перезаписаны значениями в «диагонали».
`input` имеет размерность r+1 `[I, J, ..., L, M, N]`. Когда `k` является скаляром или `k[0] == k[1]`, `диагональ` имеет размеры `r` `[I, J, ..., L, max_diag_len]`. В противном случае он имеет размеры r+1 `[I, J, ..., L, num_diags, max_diag_len]`. `num_diags` — это количество диагоналей, `num_diags = k[1] - k[0] + 1`. `max_diag_len` — самая длинная диагональ в диапазоне `[k[0], k[1]]`, `max_diag_len = min(M + min(k[1], 0), N + min(-k[0] , 0))`
На выходе получается тензор ранга «k+1» с размерностями «[I, J, ..., L, M, N]». Если `k` скаляр или `k[0] == k[1]`:
output[i, j, ..., l, m, n]
= diagonal[i, j, ..., l, n-max(k[1], 0)] ; if n - m == k[1]
input[i, j, ..., l, m, n] ; otherwise
output[i, j, ..., l, m, n]
= diagonal[i, j, ..., l, diag_index, index_in_diag] ; if k[0] <= d <= k[1]
input[i, j, ..., l, m, n] ; otherwise
`offset` равен нулю, за исключением случаев, когда диагональ выравнивается вправо.
offset = max_diag_len - diag_len(d) ; if (`align` in {RIGHT_LEFT, RIGHT_RIGHT
and `d >= 0`) or
(`align` in {LEFT_RIGHT, RIGHT_RIGHT}
and `d <= 0`)
0 ; otherwise
}
Например:
# The main diagonal.
input = np.array([[[7, 7, 7, 7], # Input shape: (2, 3, 4)
[7, 7, 7, 7],
[7, 7, 7, 7]],
[[7, 7, 7, 7],
[7, 7, 7, 7],
[7, 7, 7, 7]]])
diagonal = np.array([[1, 2, 3], # Diagonal shape: (2, 3)
[4, 5, 6]])
tf.matrix_set_diag(input, diagonal)
==> [[[1, 7, 7, 7], # Output shape: (2, 3, 4)
[7, 2, 7, 7],
[7, 7, 3, 7]],
[[4, 7, 7, 7],
[7, 5, 7, 7],
[7, 7, 6, 7]]]
# A superdiagonal (per batch).
tf.matrix_set_diag(input, diagonal, k = 1)
==> [[[7, 1, 7, 7], # Output shape: (2, 3, 4)
[7, 7, 2, 7],
[7, 7, 7, 3]],
[[7, 4, 7, 7],
[7, 7, 5, 7],
[7, 7, 7, 6]]]
# A band of diagonals.
diagonals = np.array([[[0, 9, 1], # Diagonal shape: (2, 4, 3)
[6, 5, 8],
[1, 2, 3],
[4, 5, 0]],
[[0, 1, 2],
[5, 6, 4],
[6, 1, 2],
[3, 4, 0]]])
tf.matrix_set_diag(input, diagonals, k = (-1, 2))
==> [[[1, 6, 9, 7], # Output shape: (2, 3, 4)
[4, 2, 5, 1],
[7, 5, 3, 8]],
[[6, 5, 1, 7],
[3, 1, 6, 2],
[7, 4, 2, 4]]]
# LEFT_RIGHT alignment.
diagonals = np.array([[[9, 1, 0], # Diagonal shape: (2, 4, 3)
[6, 5, 8],
[1, 2, 3],
[0, 4, 5]],
[[1, 2, 0],
[5, 6, 4],
[6, 1, 2],
[0, 3, 4]]])
tf.matrix_set_diag(input, diagonals, k = (-1, 2), align="LEFT_RIGHT")
==> [[[1, 6, 9, 7], # Output shape: (2, 3, 4)
[4, 2, 5, 1],
[7, 5, 3, 8]],
[[6, 5, 1, 7],
[3, 1, 6, 2],
[7, 4, 2, 4]]]
Вложенные классы
сорт | MatrixSetDiag.Options | Дополнительные атрибуты для MatrixSetDiag |
Константы
Нить | OP_NAME | Название этой операции, известное основному движку TensorFlow. |
Публичные методы
статический MatrixSetDiag.Options | выровнять (выровнять строку) |
Выход <Т> | какВывод () Возвращает символический дескриптор тензора. |
static <T расширяет TType > MatrixSetDiag <T> | |
Выход <Т> | выход () Ранжируйте `r+1`, используя `output.shape = input.shape`. |
Унаследованные методы
Константы
общедоступная статическая финальная строка OP_NAME
Название этой операции, известное основному движку TensorFlow.
Публичные методы
public static MatrixSetDiag.Options align (String align)
Параметры
выровнять | Некоторые диагонали короче, чем max_diag_len, и их необходимо дополнить. `align` — это строка, определяющая, как должны быть выровнены супердиагонали и поддиагонали соответственно. Существует четыре возможных варианта выравнивания: «RIGHT_LEFT» (по умолчанию), «LEFT_RIGHT», «LEFT_LEFT» и «RIGHT_RIGHT». «RIGHT_LEFT» выравнивает супердиагонали вправо (дополняет строку слева) и субдиагонали влево (дополняет строку справа). Это формат упаковки, который использует LAPACK. cuSPARSE использует «LEFT_RIGHT», что является противоположным выравниванием. |
---|
публичный вывод <T> asOutput ()
Возвращает символический дескриптор тензора.
Входные данные для операций TensorFlow являются выходными данными другой операции TensorFlow. Этот метод используется для получения символического дескриптора, который представляет собой вычисление входных данных.
public static MatrixSetDiag <T> create (область действия , ввод операнда <T>, диагональ операнда <T>, операнд < TInt32 > k, параметры... параметры)
Фабричный метод для создания класса, обертывающего новую операцию MatrixSetDiag.
Параметры
объем | текущий объем |
---|---|
вход | Ранг `r+1`, где `r >= 1`. |
диагональ | Ранжируйте `r`, когда `k` является целым числом или `k[0] == k[1]`. В противном случае он имеет ранг `r+1`. `к >= 1`. |
к | Диагональное смещение(я). Положительное значение означает супердиагональ, 0 относится к главной диагонали, а отрицательное значение означает поддиагонали. `k` может быть одним целым числом (для одной диагонали) или парой целых чисел, определяющих нижний и верхний пределы полосы матрицы. `k[0]` не должен быть больше `k[1]`. |
параметры | содержит значения необязательных атрибутов |
Возврат
- новый экземпляр MatrixSetDiag