oracle.spatial.hadoop.vector.mapreduce.job

Class KMeansClustering<K,V>

java.lang.Object

Configured

oracle.spatial.hadoop.vector.mapred.job.BaseJob<K,V>

oracle.spatial.hadoop.vector.mapred.job.KMeansClustering<K,V>

oracle.spatial.hadoop.vector.mapreduce.job.KMeansClustering<K,V>

Type Parameters:

K - the type of the input keys

V - the type of the input values

public class KMeansClustering<K,V>
extends KMeansClustering<K,V>

Class used to perform spatial clustering over an input data set.The clustering is performed running one or more jobs iteratively.

Author:

hsaucedo

Field Summary

Fields inherited from class oracle.spatial.hadoop.vector.mapred.job.KMeansClustering

ARG_CLUSTERS_POINTS, ARG_CRIT_FUN_CLASS, ARG_DELETE_CLUSTER_FILES, ARG_K, ARG_MAX_ITERATIONS, ARG_MAX_MEMBER_DISTANCE, ARG_SHAPE_GEN_CLASS

Constructor Summary

Constructors

Constructor and Description
KMeansClustering()

Method Summary

Modifier and Type	Method and Description
void	configure(Job job) Validates and adds the current parameters to the job configuration
static <K,V> void	main(java.lang.String[] args)
int	run(java.lang.String[] args)
KMeans.KMeansIterationResult	runIteration(int iteration, Configuration baseConf) Launches a mapreduce job to run a single iteration
boolean	runIterations(int maxIterations, Configuration baseConf) Runs the K Means clustering algorithm using the given configuration

Methods inherited from class oracle.spatial.hadoop.vector.mapred.job.KMeansClustering

getClustersPoints, getCmdOptions, getCritetionFunctionClass, getCurrentCmdArgs, getInClustersPath, getIteration, getK, getMaxIterations, getShapeGeneratorClass, getWorkDirPath, isDeletePreviousClusterFiles, processArgs, setClustersPoints, setCritetionFunctionClass, setDeletePreviousClusterFiles, setInClustersPath, setIteration, setK, setMaxIterations, setOutput, setShapeGeneratorClass

Methods inherited from class oracle.spatial.hadoop.vector.mapred.job.BaseJob

getCmdOptionsWithInputDataSets, getCurrentCmdArgsAsString, getInput, getInputDataSet, getInputFormatClass, getJarClass, getOutput, getRecordInfoProviderClass, getSpatialConfig, setInput, setInputDataSet, setInputFormatClass, setJarClass, setRecordInfoProviderClass, setSpatialConfig

Methods inherited from class java.lang.Object

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

Constructor Detail

KMeansClustering

public KMeansClustering()

Method Detail

configure

public void configure(Job job)
               throws java.lang.Exception

Description copied from class: BaseJob

Validates and adds the current parameters to the job configuration

Overrides:

configure in class KMeansClustering<K,V>

Parameters:

job - a job instance

Throws:

java.lang.Exception

main

public static <K,V> void main(java.lang.String[] args)
                       throws java.lang.Exception

Throws:

java.lang.Exception

run

public int run(java.lang.String[] args)
        throws java.lang.Exception

Overrides:

run in class KMeansClustering<K,V>

Throws:

java.lang.Exception

runIteration

public KMeans.KMeansIterationResult runIteration(int iteration,
                                                 Configuration baseConf)
                                          throws java.lang.Exception

Launches a mapreduce job to run a single iteration

Overrides:

runIteration in class KMeansClustering<K,V>

Parameters:

iteration - the iteration number

baseConf - the job configuration

Returns:

a KMeans.KMeansIterationResult containing the results of the iteration

Throws:

java.lang.Exception

runIterations

public boolean runIterations(int maxIterations,
                             Configuration baseConf)
                      throws java.lang.Exception

Runs the K Means clustering algorithm using the given configuration

Overrides:

runIterations in class KMeansClustering<K,V>

Parameters:

maxIterations - the maximum number of iterations. If zero is passed, a default value based on the number of clusters will be used

baseConf - the job configuration

Returns:

true if the algortihm was successful

Throws:

java.lang.Exception