be.SIRAPRISE.typeimplementations

Class UNPACK

java.lang.Object

be.SIRAPRISE.typeimplementations.RelationalOperator

be.SIRAPRISE.typeimplementations.UNPACK

All Implemented Interfaces:

OperatorGenerator

@OperatorGeneratorCharacteristics(maximumArgumentCount=2,
                                  minimumArgumentCount=2,
                                  name="UNPACK",
                                  signature={EXPRESSION,STRING})
 @MonoRelationOperator
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)
static UNPACK_RELATION	getInstance(Heading heading, java.util.Set<NameIdentifier> unpackAttributes) Gets an instance of an UNPACK operator for the given heading and unpack specification
OperatorImplementation_V0105	getOperatorImplementation(OperatorGeneratorArgument[] args) Gets an implementation instance of the operator.
static MyReadOnlyMap<NameIdentifier,IntervalTypeImplementation>	prepareIntervalTypeImplementationsMap(MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations) Deprecated. - best replaced with the method from IntervalMapsForHeading

Methods inherited from class be.SIRAPRISE.typeimplementations.RelationalOperator

getInvocationName, getMaximumArgumentCount, getMinimumArgumentCount, getName, getOperatorGeneratorSignature, isMonoRelationOperator, 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.

getInstance

public static UNPACK_RELATION getInstance(Heading heading,
                                          java.util.Set<NameIdentifier> unpackAttributes)
                                   throws NonExistingAttributeException,
                                          AttributeNotIntervalTypedException,
                                          TypeIsNotOrdinalException

Gets an instance of an UNPACK operator for the given heading and unpack specification

Parameters:

heading - The heading of the relation to be unpacked

unpackAttributes - The in-order list of interval-typed attributes to be unpacked over

Returns:

an instance of an UNPACK operator for the given heading and unpack specification

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

prepareIntervalTypeImplementationsMap

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

Deprecated. - best replaced with the method from IntervalMapsForHeading

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

getOperatorImplementation

public final OperatorImplementation_V0105 getOperatorImplementation(OperatorGeneratorArgument[] args)
                                                             throws NotFoundException

Description copied from interface: OperatorGenerator

Gets an implementation instance of the operator.

Parameters:

args - The arguments from which the instance is to be created. There must be exactly as many arguments as there are elements in the list returned from OperatorGenerator.getOperatorGeneratorSignature(). The correspondence between OperatorGeneratorArgumentType values and OperatorGeneratorArgument types is given in the table below :

correspondence between OperatorGeneratorArgumentType values and OperatorGeneratorArgument types

OperatorGeneratorArgumentType value	OperatorGeneratorArgument type
EXPRESSION	NonScalarOperatorGeneratorExpressionArgument
EXPRESSIONWITHSCOPE	NonScalarOperatorGeneratorExpressionArgument
STRING	NonScalarOperatorGeneratorTextArgument

Returns:

an instance of the operator

Throws:

NotFoundException - If the given OperatorGeneratorArguments do not satisfy all of the rules of the OperatorGenerator. These rules are specific to each OperatorGenerator.