Package com.yahoo.tensor.functions

Class Reduce

java.lang.Object

com.yahoo.tensor.functions.TensorFunction

com.yahoo.tensor.functions.PrimitiveTensorFunction

com.yahoo.tensor.functions.Reduce

public class Reduce
extends PrimitiveTensorFunction

The reduce tensor operation returns a tensor produced from the argument tensor where some dimensions are collapsed to a single value using an aggregator function.

Author:

bratseth

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Reduce.Aggregator

Constructor Summary

Constructors

Constructor	Description
Reduce(TensorFunction argument, Reduce.Aggregator aggregator)	Creates a reduce function reducing all dimensions
Reduce(TensorFunction argument, Reduce.Aggregator aggregator, java.lang.String dimension)	Creates a reduce function reducing a single dimension
Reduce(TensorFunction argument, Reduce.Aggregator aggregator, java.util.List<java.lang.String> dimensions)	Creates a reduce function.

Method Summary

Modifier and Type	Method	Description
TensorFunction	argument()
java.util.List<TensorFunction>	arguments()	Returns the function arguments of this node in the order they are applied
<NAMETYPE extends TypeContext.Name> Tensor	evaluate(EvaluationContext<NAMETYPE> context)	Evaluates this tensor.
static TensorType	outputType(TensorType inputType, java.util.List<java.lang.String> reduceDimensions)
PrimitiveTensorFunction	toPrimitive()	Translate this function - and all of its arguments recursively - to a tree of primitive functions only.
java.lang.String	toString(ToStringContext context)	Return a string representation of this context.
<NAMETYPE extends TypeContext.Name> TensorType	type(TypeContext<NAMETYPE> context)	Returns the type of the tensor this produces given the input types in the context
TensorFunction	withArguments(java.util.List<TensorFunction> arguments)	Returns a copy of this tensor function with the arguments replaced by the given list of arguments.

Methods inherited from class com.yahoo.tensor.functions.TensorFunction

evaluate, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Reduce

public Reduce(TensorFunction argument,
              Reduce.Aggregator aggregator)

Creates a reduce function reducing all dimensions

Reduce

public Reduce(TensorFunction argument,
              Reduce.Aggregator aggregator,
              java.lang.String dimension)

Creates a reduce function reducing a single dimension

Reduce

public Reduce(TensorFunction argument,
              Reduce.Aggregator aggregator,
              java.util.List<java.lang.String> dimensions)

Creates a reduce function.

Parameters:

argument - the tensor to reduce

aggregator - the aggregator function to use

dimensions - the list of dimensions to remove. If an empty list is given, all dimensions are reduced, producing a dimensionless tensor (a scalar).

Throws:

java.lang.IllegalArgumentException - if any of the tensor dimensions are not present in the input tensor

Method Detail

outputType

public static TensorType outputType(TensorType inputType,
                                    java.util.List<java.lang.String> reduceDimensions)

argument

public TensorFunction argument()

arguments

public java.util.List<TensorFunction> arguments()

Description copied from class: TensorFunction

Returns the function arguments of this node in the order they are applied

Specified by:

arguments in class TensorFunction

withArguments

public TensorFunction withArguments(java.util.List<TensorFunction> arguments)

Description copied from class: TensorFunction

Returns a copy of this tensor function with the arguments replaced by the given list of arguments.

Specified by:

withArguments in class TensorFunction

toPrimitive

public PrimitiveTensorFunction toPrimitive()

Description copied from class: TensorFunction

Translate this function - and all of its arguments recursively - to a tree of primitive functions only.

Specified by:

toPrimitive in class TensorFunction

Returns:

a tree of primitive functions implementing this

toString

public java.lang.String toString(ToStringContext context)

Description copied from class: TensorFunction

Return a string representation of this context.

Specified by:

toString in class TensorFunction

Parameters:

context - a context which must be passed to all nested functions when requesting the string value

type

public <NAMETYPE extends TypeContext.Name> TensorType type(TypeContext<NAMETYPE> context)

Description copied from class: TensorFunction

Returns the type of the tensor this produces given the input types in the context

Specified by:

type in class TensorFunction

Parameters:

context - a context which must be passed to all nexted functions when evaluating

evaluate

public <NAMETYPE extends TypeContext.Name> Tensor evaluate(EvaluationContext<NAMETYPE> context)

Description copied from class: TensorFunction

Evaluates this tensor.

Specified by:

evaluate in class TensorFunction

Parameters:

context - a context which must be passed to all nexted functions when evaluating