Compute the cumulative product of the tensor `x` along `axis`.
By default, this op performs an inclusive cumulative log-sum-exp, which means that the first element of the input is identical to the first element of the output:
tf.math.cumulative_logsumexp([a, b, c]) # => [a, log(exp(a) + exp(b)), log(exp(a) + exp(b) + exp(c))]
By setting the `exclusive` kwarg to `True`, an exclusive cumulative log-sum-exp is
performed instead:
tf.cumulative_logsumexp([a, b, c], exclusive=True) # => [-inf, a, log(exp(a) * exp(b))]
Note that the neutral element of the log-sum-exp operation is `-inf`,
however, for performance reasons, the minimal value representable by the
floating point type is used instead.
By setting the `reverse` kwarg to `True`, the cumulative log-sum-exp is performed in the opposite direction.
Nested Classes
class | CumulativeLogsumexp.Options | Optional attributes for CumulativeLogsumexp
|
Public Methods
Output<T> |
asOutput()
Returns the symbolic handle of a tensor.
|
static <T extends Number, U extends Number> CumulativeLogsumexp<T> |
create(Scope scope, Operand<T> x, Operand<U> axis, Options... options)
Factory method to create a class wrapping a new CumulativeLogsumexp operation.
|
static CumulativeLogsumexp.Options |
exclusive(Boolean exclusive)
|
Output<T> |
out()
|
static CumulativeLogsumexp.Options |
reverse(Boolean reverse)
|
Inherited Methods
Public Methods
public Output<T> asOutput ()
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.
public static CumulativeLogsumexp<T> create (Scope scope, Operand<T> x, Operand<U> axis, Options... options)
Factory method to create a class wrapping a new CumulativeLogsumexp operation.
Parameters
scope | current scope |
---|---|
x | A `Tensor`. Must be one of the following types: `float16`, `float32`, `float64`. |
axis | A `Tensor` of type `int32` (default: 0). Must be in the range `[-rank(x), rank(x))`. |
options | carries optional attributes values |
Returns
- a new instance of CumulativeLogsumexp
public static CumulativeLogsumexp.Options exclusive (Boolean exclusive)
Parameters
exclusive | If `True`, perform exclusive cumulative log-sum-exp. |
---|
public static CumulativeLogsumexp.Options reverse (Boolean reverse)
Parameters
reverse | A `bool` (default: False). |
---|