Package org.apache.wayang.spark.operators

Class SparkLoopOperator<InputType,ConvergenceType>

java.lang.Object

org.apache.wayang.core.plan.wayangplan.OperatorBase

org.apache.wayang.basic.operators.LoopOperator<InputType,ConvergenceType>

org.apache.wayang.spark.operators.SparkLoopOperator<InputType,ConvergenceType>

All Implemented Interfaces:

Serializable, ActualOperator, ElementaryOperator, ExecutionOperator, LoopHeadOperator, Operator, SparkExecutionOperator

public class SparkLoopOperator<InputType,ConvergenceType>
extends LoopOperator<InputType,ConvergenceType>
implements SparkExecutionOperator

Spark implementation of the LoopOperator.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.wayang.core.plan.wayangplan.OperatorBase

OperatorBase.GsonSerializer

Nested classes/interfaces inherited from interface org.apache.wayang.core.plan.wayangplan.LoopHeadOperator

LoopHeadOperator.State

Field Summary

Fields inherited from class org.apache.wayang.basic.operators.LoopOperator

criterionDescriptor, FINAL_OUTPUT_INDEX, INITIAL_CONVERGENCE_INPUT_INDEX, INITIAL_INPUT_INDEX, ITERATION_CONVERGENCE_INPUT_INDEX, ITERATION_CONVERGENCE_OUTPUT_INDEX, ITERATION_INPUT_INDEX, ITERATION_OUTPUT_INDEX

Fields inherited from class org.apache.wayang.core.plan.wayangplan.OperatorBase

inputSlots, outputSlots, STANDARD_OPERATOR_ARGS

Fields inherited from interface org.apache.wayang.core.plan.wayangplan.Operator

FIRST_EPOCH

Constructor Summary

Constructors

Constructor	Description
SparkLoopOperator(LoopOperator<InputType,ConvergenceType> that)	Creates a copy of the given LoopOperator.
SparkLoopOperator(DataSetType<InputType> inputType, DataSetType<ConvergenceType> convergenceType, FunctionDescriptor.SerializablePredicate<Collection<ConvergenceType>> criterionPredicate, Integer numExpectedIterations)	Creates a new instance.
SparkLoopOperator(DataSetType<InputType> inputType, DataSetType<ConvergenceType> convergenceType, PredicateDescriptor<Collection<ConvergenceType>> criterionDescriptor, Integer numExpectedIterations)

Method Summary

Modifier and Type	Method	Description
boolean	containsAction()	Tell whether this instances is a Spark action.
protected ExecutionOperator	createCopy()
Optional<LoadProfileEstimator>	createLoadProfileEstimator(Configuration configuration)	Developers of ExecutionOperators can provide a default LoadProfileEstimator via this method.
Tuple<Collection<ExecutionLineageNode>,Collection<ChannelInstance>>	evaluate(ChannelInstance[] inputs, ChannelInstance[] outputs, SparkExecutor sparkExecutor, OptimizationContext.OperatorContext operatorContext)	Evaluates this operator.
String	getLoadProfileEstimatorConfigurationKey()
List<ChannelDescriptor>	getSupportedInputChannels(int index)	Display the supported Channels for a certain InputSlot.
List<ChannelDescriptor>	getSupportedOutputChannels(int index)	Display the supported Channels for a certain OutputSlot.

Methods inherited from class org.apache.wayang.basic.operators.LoopOperator

beginIteration, beginIteration, createCardinalityEstimator, endIteration, endIteration, getConditionInputSlots, getConditionOutputSlots, getConvergenceType, getCriterionDescriptor, getFinalLoopOutputs, getForwards, getInputType, getLoopBodyInputs, getLoopBodyOutputs, getLoopInitializationInputs, getNumExpectedIterations, getState, initialize, initialize, isReading, outputConnectTo, outputConnectTo, setNumExpectedIterations, setState

Methods inherited from class org.apache.wayang.core.plan.wayangplan.OperatorBase

accept, addBroadcastInput, addTargetPlatform, at, collectMappedInputSlots, collectMappedOutputSlots, copy, getAllInputs, getAllOutputs, getCardinalityEstimator, getContainer, getEpoch, getName, getOriginal, getSimpleClassName, getTargetPlatforms, isAuxiliary, isSupportingBroadcastInputs, propagateInputCardinality, propagateOutputCardinality, setAuxiliary, setCardinalityEstimator, setContainer, setEpoch, setName, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.wayang.core.plan.wayangplan.ActualOperator

accept

Methods inherited from interface org.apache.wayang.core.plan.wayangplan.ElementaryOperator

createCardinalityEstimator, getCardinalityEstimator, isAuxiliary, setAuxiliary, setCardinalityEstimator

Methods inherited from interface org.apache.wayang.core.plan.wayangplan.ExecutionOperator

copy, createOutputChannelInstances, getLimitBaseKey, getLoadProfileEstimatorConfigurationKeys, getOriginal, getOutputChannelDescriptor, isFiltered

Methods inherited from interface org.apache.wayang.core.plan.wayangplan.LoopHeadOperator

getCardinalityPusher, getFinalizationPusher, getInitializationPusher

Methods inherited from interface org.apache.wayang.core.plan.wayangplan.Operator

addBroadcastInput, addTargetPlatform, broadcastTo, broadcastTo, collectMappedInputSlots, collectMappedOutputSlots, connectTo, connectTo, getAllInputs, getAllOutputs, getContainer, getEffectiveOccupant, getEffectiveOccupant, getEpoch, getEstimationContextProperties, getForwards, getInnermostLoop, getInput, getInput, getLoopStack, getName, getNumBroadcastInputs, getNumInputs, getNumOutputs, getNumRegularInputs, getOuterInputSlot, getOutermostInputSlot, getOutermostOutputSlots, getOutput, getOutput, getParent, getTargetPlatforms, isAlternative, isConversion, isElementary, isExecutionOperator, isFeedbackInput, isFeedforwardOutput, isLoopHead, isLoopSubplan, isOwnerOf, isReading, isSink, isSource, isSubplan, isSupportingBroadcastInputs, isUnconnected, propagateInputCardinality, propagateOutputCardinality, propagateOutputCardinality, replaceWith, setContainer, setEpoch, setInput, setName, setOutput

Methods inherited from interface org.apache.wayang.spark.operators.SparkExecutionOperator

getPlatform, name, name

Constructor Details

SparkLoopOperator

public SparkLoopOperator(DataSetType<InputType> inputType,
 DataSetType<ConvergenceType> convergenceType,
 FunctionDescriptor.SerializablePredicate<Collection<ConvergenceType>> criterionPredicate,
 Integer numExpectedIterations)

Creates a new instance.

SparkLoopOperator

public SparkLoopOperator(DataSetType<InputType> inputType,
 DataSetType<ConvergenceType> convergenceType,
 PredicateDescriptor<Collection<ConvergenceType>> criterionDescriptor,
 Integer numExpectedIterations)

SparkLoopOperator

public SparkLoopOperator(LoopOperator<InputType,ConvergenceType> that)

Creates a copy of the given LoopOperator.

Parameters:

that - should be copied

Method Details

evaluate

public Tuple<Collection<ExecutionLineageNode>,Collection<ChannelInstance>> evaluate(ChannelInstance[] inputs,
 ChannelInstance[] outputs,
 SparkExecutor sparkExecutor,
 OptimizationContext.OperatorContext operatorContext)

Description copied from interface: SparkExecutionOperator

Evaluates this operator. Takes a set of ChannelInstances according to the operator inputs and manipulates a set of ChannelInstances according to the operator outputs -- unless the operator is a sink, then it triggers execution.

In addition, this method should give feedback of what this instance was doing by wiring the LazyExecutionLineageNodes of input and ouput ChannelInstances and providing a Collection of executed ExecutionLineageNodes.

Specified by:

evaluate in interface SparkExecutionOperator

Parameters:

inputs - ChannelInstances that satisfy the inputs of this operator

outputs - ChannelInstances that accept the outputs of this operator

sparkExecutor - SparkExecutor that executes this instance

operatorContext - optimization information for this instance

Returns:

Collections of what has been executed and produced

createCopy

protected ExecutionOperator createCopy()

Overrides:

createCopy in class OperatorBase

getLoadProfileEstimatorConfigurationKey

public String getLoadProfileEstimatorConfigurationKey()

Specified by:

getLoadProfileEstimatorConfigurationKey in interface ExecutionOperator

createLoadProfileEstimator

public Optional<LoadProfileEstimator> createLoadProfileEstimator(Configuration configuration)

Description copied from interface: ExecutionOperator

Developers of ExecutionOperators can provide a default LoadProfileEstimator via this method.

Specified by:

createLoadProfileEstimator in interface ExecutionOperator

Parameters:

configuration - in which the LoadProfile should be estimated.

Returns:

an Optional that might contain the LoadProfileEstimator (but Optional.empty() by default)

getSupportedInputChannels

public List<ChannelDescriptor> getSupportedInputChannels(int index)

Description copied from interface: ExecutionOperator

Display the supported Channels for a certain InputSlot.

Specified by:

getSupportedInputChannels in interface ExecutionOperator

Parameters:

index - the index of the InputSlot

Returns:

an List of Channels' Classes, ordered by their preference of use

getSupportedOutputChannels

public List<ChannelDescriptor> getSupportedOutputChannels(int index)

Description copied from interface: ExecutionOperator

Display the supported Channels for a certain OutputSlot.

Specified by:

getSupportedOutputChannels in interface ExecutionOperator

Parameters:

index - the index of the OutputSlot

Returns:

an List of Channels' Classes, ordered by their preference of use

See Also:

• ExecutionOperator.getOutputChannelDescriptor(int)

containsAction

public boolean containsAction()

Description copied from interface: SparkExecutionOperator

Tell whether this instances is a Spark action. This is important to keep track on when Spark is actually initialized.

Specified by:

containsAction in interface SparkExecutionOperator

Returns:

whether this instance issues Spark actions