org.apache.hama.graph

Class AggregationRunner<V extends org.apache.hadoop.io.Writable,E extends org.apache.hadoop.io.Writable,M extends org.apache.hadoop.io.Writable>

java.lang.Object

org.apache.hama.graph.AggregationRunner<V,E,M>

public final class AggregationRunner<V extends org.apache.hadoop.io.Writable,E extends org.apache.hadoop.io.Writable,M extends org.apache.hadoop.io.Writable>
extends Object

Runner class to do the tasks that need to be done if aggregation was configured.

Constructor Summary

Constructors

Constructor and Description
AggregationRunner()

Method Summary

Methods

Modifier and Type	Method and Description
void	aggregateVertex(M lastValue, Vertex<V,E,M> v) Aggregates the last value before computation and the value after the computation.
void	doMasterAggregation(org.apache.hadoop.io.MapWritable updatedCnt) The method the master task does, it globally aggregates the values of each peer and updates the given map accordingly.
org.apache.hadoop.io.Writable	getLastAggregatedValue(int index)
org.apache.hadoop.io.IntWritable	getNumLastAggregatedVertices(int index)
boolean	isEnabled()
void	masterReadAggregatedIncrementalValue(org.apache.hadoop.io.Text textIndex, M value) Method to let the master read messages from peers and aggregate the incremental value.
void	masterReadAggregatedValue(org.apache.hadoop.io.Text textIndex, M value) Method to let the master read messages from peers and aggregate a value.
boolean	receiveAggregatedValues(BSPPeer<org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,GraphJobMessage> peer, long iteration) Receives aggregated values from a master task, by doing an additional barrier sync and parsing the messages.
void	sendAggregatorValues(BSPPeer<org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,GraphJobMessage> peer, int activeVertices) Runs the aggregators by sending their values to the master task.
void	setupAggregators(BSPPeer<org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,GraphJobMessage> peer)

Methods inherited from class java.lang.Object

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

Constructor Detail

AggregationRunner

public AggregationRunner()

Method Detail

setupAggregators

public void setupAggregators(BSPPeer<org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,GraphJobMessage> peer)

sendAggregatorValues

public void sendAggregatorValues(BSPPeer<org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,GraphJobMessage> peer,
                        int activeVertices)
                          throws IOException

Runs the aggregators by sending their values to the master task.

Throws:

IOException

aggregateVertex

public void aggregateVertex(M lastValue,
                   Vertex<V,E,M> v)

Aggregates the last value before computation and the value after the computation.

Parameters:

lastValue - the value before compute().

v - the vertex.

doMasterAggregation

public void doMasterAggregation(org.apache.hadoop.io.MapWritable updatedCnt)

The method the master task does, it globally aggregates the values of each peer and updates the given map accordingly.

receiveAggregatedValues

public boolean receiveAggregatedValues(BSPPeer<org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,org.apache.hadoop.io.Writable,GraphJobMessage> peer,
                              long iteration)
                                throws IOException,
                                       SyncException,
                                       InterruptedException

Receives aggregated values from a master task, by doing an additional barrier sync and parsing the messages.

Returns:

always true if no aggregators are defined, false if aggregators say we haven't seen any messages anymore.

Throws:

IOException

SyncException

InterruptedException

isEnabled

public boolean isEnabled()

Returns:

true if aggregators were defined. Normally used by the internal stateful methods, outside shouldn't use it too extensively.

masterReadAggregatedValue

public void masterReadAggregatedValue(org.apache.hadoop.io.Text textIndex,
                             M value)

Method to let the master read messages from peers and aggregate a value.

masterReadAggregatedIncrementalValue

public void masterReadAggregatedIncrementalValue(org.apache.hadoop.io.Text textIndex,
                                        M value)

Method to let the master read messages from peers and aggregate the incremental value.

getLastAggregatedValue

public final org.apache.hadoop.io.Writable getLastAggregatedValue(int index)

getNumLastAggregatedVertices

public final org.apache.hadoop.io.IntWritable getNumLastAggregatedVertices(int index)