org.tensorflow.op.core

Class MatrixDiag<T>

java.lang.Object

org.tensorflow.op.PrimitiveOp

org.tensorflow.op.core.MatrixDiag<T>

Type Parameters:

T - data type for output() output

All Implemented Interfaces:

Op, Operand<T>

@Operator
public final class MatrixDiag<T>
extends PrimitiveOp
implements Operand<T>

Returns a batched diagonal tensor with a given batched diagonal values.

Given a `diagonal`, this operation returns a tensor with the `diagonal` and everything else padded with zeros. The diagonal is computed as follows:

Assume `diagonal` has `k` dimensions `[I, J, K, ..., N]`, then the output is a tensor of rank `k+1` with dimensions [I, J, K, ..., N, N]` where:

`output[i, j, k, ..., m, n] = 1{m=n} * diagonal[i, j, k, ..., n]`.

For example:

 # 'diagonal' is [[1, 2, 3, 4], [5, 6, 7, 8]]
 
 and diagonal.shape = (2, 4)
 
 tf.matrix_diag(diagonal) ==> [[[1, 0, 0, 0]
                                      [0, 2, 0, 0]
                                      [0, 0, 3, 0]
                                      [0, 0, 0, 4]],
                                     [[5, 0, 0, 0]
                                      [0, 6, 0, 0]
                                      [0, 0, 7, 0]
                                      [0, 0, 0, 8]]]
 
 which has shape (2, 4, 4)
 

Field Summary

Fields inherited from class org.tensorflow.op.PrimitiveOp

operation

Method Summary

Modifier and Type	Method and Description
Output<T>	asOutput() Returns the symbolic handle of a tensor.
static <T> MatrixDiag<T>	create(Scope scope, Operand<T> diagonal) Factory method to create a class to wrap a new MatrixDiag operation to the graph.
Output<T>	output() Rank `k+1`, with `output.shape = diagonal.shape + [diagonal.shape[-1]]`.

Methods inherited from class org.tensorflow.op.PrimitiveOp

equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

create

public static <T> MatrixDiag<T> create(Scope scope,
                                       Operand<T> diagonal)

Factory method to create a class to wrap a new MatrixDiag operation to the graph.

Parameters:

scope - current graph scope

diagonal - Rank `k`, where `k >= 1`.

Returns:

a new instance of MatrixDiag

output

public Output<T> output()

Rank `k+1`, with `output.shape = diagonal.shape + [diagonal.shape[-1]]`.

asOutput

public Output<T> asOutput()

Description copied from interface: Operand

Returns the symbolic handle of a tensor.

Inputs to TensorFlow operations are outputs of another TensorFlow operation. This method is used to obtain a symbolic handle that represents the computation of the input.

Specified by:

asOutput in interface Operand<T>

See Also:

OperationBuilder.addInput(Output)