com.nutiteq.datasources.vector

Class ClusteringVectorDataSource<T extends com.nutiteq.geometry.VectorElement>

java.lang.Object

com.nutiteq.vectordatasources.AbstractVectorDataSource<T>

com.nutiteq.datasources.vector.ClusteringVectorDataSource<T>

Type Parameters:

T - Vector element data type (usually Marker or Point)

All Implemented Interfaces:

com.nutiteq.vectordatasources.VectorDataSource<T>

public class ClusteringVectorDataSource<T extends com.nutiteq.geometry.VectorElement>
extends com.nutiteq.vectordatasources.AbstractVectorDataSource<T>

Virtual clustering data source. Take elements from input data source and merges elements that are closer than given minimum distance value into a cluster. Element merging can be customized.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ClusteringVectorDataSource.ElementMerger<T extends com.nutiteq.geometry.VectorElement> Interface for customizing element merging.

Nested classes/interfaces inherited from interface com.nutiteq.vectordatasources.VectorDataSource

com.nutiteq.vectordatasources.VectorDataSource.OnChangeListener

Field Summary

Fields inherited from class com.nutiteq.vectordatasources.AbstractVectorDataSource

projection

Constructor Summary

Constructors

Constructor and Description
ClusteringVectorDataSource(com.nutiteq.vectordatasources.VectorDataSource<T> dataSource, float distance, int threshold, ClusteringVectorDataSource.ElementMerger<T> elementMerger) Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected Collection<T>	clusterData(Collection<T> elements, double maxDistance, com.nutiteq.components.Envelope envelope)
protected com.nutiteq.components.Envelope	enlargeEnvelope(com.nutiteq.components.Envelope envelope, double extra, com.nutiteq.components.Bounds bounds)
com.nutiteq.components.Envelope	getDataExtent()
Collection<T>	loadElements(com.nutiteq.components.CullState cullState)

Methods inherited from class com.nutiteq.vectordatasources.AbstractVectorDataSource

addOnChangeListener, getProjection, notifyElementChanged, notifyElementsChanged, onElementChanged, removeOnChangeListener

Methods inherited from class java.lang.Object

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

Constructor Detail

ClusteringVectorDataSource

public ClusteringVectorDataSource(com.nutiteq.vectordatasources.VectorDataSource<T> dataSource,
                          float distance,
                          int threshold,
                          ClusteringVectorDataSource.ElementMerger<T> elementMerger)

Default constructor.

Parameters:

dataSource - input data source

distance - minimum allowed distance between elements. Distance is in relative screen units - 1.0f covers whole screen. Good value to start with is usually between 0.05f and 0.1f.

threshold - minimum number of elements in a cluster. When cluster contains less elements, elements are added individually. Must be larger than 1, usually 2.

elementMerger - element merger interface for customizing clustering.

Method Detail

getDataExtent

public com.nutiteq.components.Envelope getDataExtent()

loadElements

public Collection<T> loadElements(com.nutiteq.components.CullState cullState)

enlargeEnvelope

protected com.nutiteq.components.Envelope enlargeEnvelope(com.nutiteq.components.Envelope envelope,
                                              double extra,
                                              com.nutiteq.components.Bounds bounds)

clusterData

protected Collection<T> clusterData(Collection<T> elements,
                        double maxDistance,
                        com.nutiteq.components.Envelope envelope)