be.SIRAPRISE.ra

Class UNPACK

java.lang.Object

be.SIRAPRISE.ra.RelationalOperator

be.SIRAPRISE.ra.UNPACK

public abstract class UNPACK
extends RelationalOperator

UNPACK

Author:

erwin

Constructor Summary

Constructors

Constructor and Description
UNPACK()

Method Summary

Modifier and Type	Method and Description
static IRelation	computeUnpack(Relation relation, NameIdentifier... unpackAttributes)
int	getMaximumArgumentCount() Gets the maximum argument count for this operator.
int	getMinimumArgumentCount() Gets the minimum argument count for this operator.
java.lang.String	getName() Gets the operator name
boolean	isMonoRelationOperator() Checks if the operator takes only one Relation as input
static MyReadOnlyMap<NameIdentifier,IntervalTypeImplementation>	prepareIntervalTypeImplementationsMap(MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations) Prepares a map mapping attribute names in a heading to the interval type implementations corresponding to them
static java.util.Set<MyReadOnlyMap<NameIdentifier,ValueBuffer>>	unpackTuple(TupleBuffer t, MyReadOnlyMap<NameIdentifier,IntervalTypeImplementation> intervalTypeImplementations, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations)
static UNPACKInvocationResultDetails	validateExpressionDetails(Heading inputHeading, java.util.Set<NameIdentifier> attributeNames, java.lang.String inputPredicate, java.util.Collection<? extends KeyDef> inputKeySpecifications)

Methods inherited from class be.SIRAPRISE.ra.RelationalOperator

toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UNPACK

public UNPACK()

Method Detail

computeUnpack

public static IRelation computeUnpack(Relation relation,
                                      NameIdentifier... unpackAttributes)
                               throws EvaluationException

Parameters:

relation - the relation to be unpacked

unpackAttributes - the interval-typed attributes over which the relation is to be unpacked

Returns:

the result of unpacking the given relation over the specified interval-typed attributes

Throws:

EvaluationException - if the evaluation fails for any reason of invalid arguments. The contained exception cause will provide more detail.

prepareIntervalTypeImplementationsMap

public static MyReadOnlyMap<NameIdentifier,IntervalTypeImplementation> prepareIntervalTypeImplementationsMap(MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations)

Prepares a map mapping attribute names in a heading to the interval type implementations corresponding to them

Parameters:

intervalTypedAttributesIntervalOperatorImplementations - A map of attribute name to interval operator implementations mappings as it typically gets used in Relational computations involving Allen operators.

Returns:

a map mapping attribute names in a heading to the interval type implementations corresponding to them

unpackTuple

public static java.util.Set<MyReadOnlyMap<NameIdentifier,ValueBuffer>> unpackTuple(TupleBuffer t,
                                                                                   MyReadOnlyMap<NameIdentifier,IntervalTypeImplementation> intervalTypeImplementations,
                                                                                   MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations)

Parameters:

t - A tuple with interval-type attributes to be unpacked to point values

intervalTypeImplementations - the applicable interval type implementations per attribute to be unpacked

intervalTypedAttributesIntervalOperatorImplementations - the applicable interval operator implementations per attribute to be unpacked

Returns:

The set of attribute value maps that represents the input tuple unpacked over the specified unpack attributes

validateExpressionDetails

public static UNPACKInvocationResultDetails validateExpressionDetails(Heading inputHeading,
                                                                      java.util.Set<NameIdentifier> attributeNames,
                                                                      java.lang.String inputPredicate,
                                                                      java.util.Collection<? extends KeyDef> inputKeySpecifications)
                                                               throws NonExistingAttributeException,
                                                                      AttributeNotIntervalTypedException,
                                                                      TypeIsNotOrdinalException

Parameters:

inputHeading - the heading of the relation subjected to an UNPACK.

attributeNames - the set of attribute names to UNPACK over.

inputPredicate - The predicate of which the input is the extension.

inputKeySpecifications - The key specifications that the input is known to satisfy.

Returns:

An object holding information about the operator invocation

Throws:

NonExistingAttributeException - if an unpack attribute is specified that is not present in the input

AttributeNotIntervalTypedException - if an unpack attribute is specified that is not interval-typed

TypeIsNotOrdinalException - If the unpack attribute is of an interval type that is not based on an ordinal base type

getMaximumArgumentCount

public final int getMaximumArgumentCount()

Description copied from class: RelationalOperator

Gets the maximum argument count for this operator. Note that stuff like rename lists are regarded as an argument as far as this count is concerned

Specified by:

getMaximumArgumentCount in class RelationalOperator

Returns:

the maximum argument count for this operator.

getMinimumArgumentCount

public final int getMinimumArgumentCount()

Description copied from class: RelationalOperator

Gets the minimum argument count for this operator. Note that stuff like rename lists are regarded as an argument as far as this count is concerned

Specified by:

getMinimumArgumentCount in class RelationalOperator

Returns:

the minimum argument count for this operator

getName

public java.lang.String getName()

Description copied from class: RelationalOperator

Gets the operator name

Specified by:

getName in class RelationalOperator

Returns:

the operator name

isMonoRelationOperator

public boolean isMonoRelationOperator()

Description copied from class: RelationalOperator

Checks if the operator takes only one Relation as input

Specified by:

isMonoRelationOperator in class RelationalOperator

Returns:

true if the operator takes only one Relation as input