de.lmu.ifi.dbs.elki.result

Class KMLOutputHandler

java.lang.Object

de.lmu.ifi.dbs.elki.result.KMLOutputHandler

All Implemented Interfaces:

ResultHandler, ResultProcessor

@Reference(authors="E. Achtert, A. Hettab, H.-P. Kriegel, E. Schubert, A. Zimek",
           booktitle="Proc. 12th International Symposium on Spatial and Temporal Databases (SSTD), Minneapolis, MN, 2011",
           title="Spatial Outlier Detection: Data, Algorithms, Visualizations",
           url="http://dx.doi.org/10.1007/978-3-642-22922-0_41")
public class KMLOutputHandler
extends Object
implements ResultHandler

Class to handle KML output. Reference:

E. Achtert, A. Hettab, H.-P. Kriegel, E. Schubert, A. Zimek:
Spatial Outlier Detection: Data, Algorithms, Visualizations.
in Proc. 12th International Symposium on Spatial and Temporal Databases (SSTD), Minneapolis, MN, 2011

Note: This class - currently - is an ugly hack. This code needs to be modularized to make it more reusable, to support multiple results and different result types.

Author:

Erich Schubert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	KMLOutputHandler.Parameterizer Parameterization class

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	autoopen Automatically open at the end
private boolean	compat Compatibility mode.
(package private) File	filename Output file name
private static Logging	LOG Logger class to use.
private static int	NUMSTYLES Number of styles to use (lower reduces rendering complexity a bit)
(package private) OutlierScalingFunction	scaling Scaling function

Constructor Summary

Constructors

Constructor and Description
KMLOutputHandler(File filename, OutlierScalingFunction scaling, boolean compat, boolean autoopen) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
private DoubleObjPair<Polygon>	buildHullsRecursively(Cluster<Model> clu, Hierarchy<Cluster<Model>> hier, Map<Object,DoubleObjPair<Polygon>> hulls, Relation<? extends NumberVector> coords) Recursively step through the clusters to build the hulls.
static Color	getColorForValue(double val) Get color from a simple heatmap.
private StringBuilder	makeDescription(Cluster<?> c) Make an HTML description.
private StringBuilder	makeDescription(Collection<Relation<?>> relations, DBIDRef id) Make an HTML description.
void	processNewResult(ResultHierarchy hier, Result newResult) Process a result.
private void	writeClusteringResult(XMLStreamWriter xmlw, Clustering<Model> clustering, Database database)
private void	writeNewlineOnDebug(XMLStreamWriter out) Print a newline when debugging.
private void	writeOutlierResult(XMLStreamWriter xmlw, OutlierResult outlierResult, Database database)

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final Logging LOG

Logger class to use.

NUMSTYLES

private static final int NUMSTYLES

Number of styles to use (lower reduces rendering complexity a bit)

See Also:

Constant Field Values

filename

File filename

Output file name

scaling

OutlierScalingFunction scaling

Scaling function

compat

private boolean compat

Compatibility mode.

autoopen

private boolean autoopen

Automatically open at the end

Constructor Detail

KMLOutputHandler

public KMLOutputHandler(File filename,
                OutlierScalingFunction scaling,
                boolean compat,
                boolean autoopen)

Constructor.

Parameters:

filename - Output filename

scaling - Scaling function

compat - Compatibility mode

autoopen - Automatically open

Method Detail

processNewResult

public void processNewResult(ResultHierarchy hier,
                    Result newResult)

Description copied from interface: ResultProcessor

Process a result.

Specified by:

processNewResult in interface ResultProcessor

Parameters:

hier - The base of the result tree.

newResult - Newly added result subtree.

writeOutlierResult

private void writeOutlierResult(XMLStreamWriter xmlw,
                      OutlierResult outlierResult,
                      Database database)
                         throws XMLStreamException

Throws:

XMLStreamException

writeClusteringResult

private void writeClusteringResult(XMLStreamWriter xmlw,
                         Clustering<Model> clustering,
                         Database database)
                            throws XMLStreamException

Throws:

XMLStreamException

buildHullsRecursively

private DoubleObjPair<Polygon> buildHullsRecursively(Cluster<Model> clu,
                                           Hierarchy<Cluster<Model>> hier,
                                           Map<Object,DoubleObjPair<Polygon>> hulls,
                                           Relation<? extends NumberVector> coords)

Recursively step through the clusters to build the hulls.

Parameters:

clu - Current cluster

hier - Clustering hierarchy

hulls - Hull map

makeDescription

private StringBuilder makeDescription(Collection<Relation<?>> relations,
                            DBIDRef id)

Make an HTML description.

Parameters:

relations - Relations

id - Object ID

Returns:

Buffer

makeDescription

private StringBuilder makeDescription(Cluster<?> c)

Make an HTML description.

Parameters:

c - Cluster

Returns:

Buffer

writeNewlineOnDebug

private void writeNewlineOnDebug(XMLStreamWriter out)
                          throws XMLStreamException

Print a newline when debugging.

Parameters:

out - Output XML stream

Throws:

XMLStreamException

getColorForValue

public static final Color getColorForValue(double val)

Get color from a simple heatmap.

Parameters:

val - Score value

Returns:

Color in heatmap