diff options
Diffstat (limited to 'src/de/lmu/ifi/dbs/elki/visualization/visualizers/scatterplot/index/TreeSphereVisualization.java')
-rw-r--r-- | src/de/lmu/ifi/dbs/elki/visualization/visualizers/scatterplot/index/TreeSphereVisualization.java | 318 |
1 files changed, 318 insertions, 0 deletions
diff --git a/src/de/lmu/ifi/dbs/elki/visualization/visualizers/scatterplot/index/TreeSphereVisualization.java b/src/de/lmu/ifi/dbs/elki/visualization/visualizers/scatterplot/index/TreeSphereVisualization.java new file mode 100644 index 00000000..85429eb1 --- /dev/null +++ b/src/de/lmu/ifi/dbs/elki/visualization/visualizers/scatterplot/index/TreeSphereVisualization.java @@ -0,0 +1,318 @@ +package de.lmu.ifi.dbs.elki.visualization.visualizers.scatterplot.index; + +/* + This file is part of ELKI: + Environment for Developing KDD-Applications Supported by Index-Structures + + Copyright (C) 2012 + Ludwig-Maximilians-Universität München + Lehr- und Forschungseinheit für Datenbanksysteme + ELKI Development Team + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU Affero General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see <http://www.gnu.org/licenses/>. + */ + +import java.util.ArrayList; + +import org.apache.batik.util.SVGConstants; +import org.w3c.dom.Element; + +import de.lmu.ifi.dbs.elki.data.NumberVector; +import de.lmu.ifi.dbs.elki.database.datastore.DataStoreListener; +import de.lmu.ifi.dbs.elki.database.ids.DBID; +import de.lmu.ifi.dbs.elki.distance.distancefunction.DistanceFunction; +import de.lmu.ifi.dbs.elki.distance.distancefunction.EuclideanDistanceFunction; +import de.lmu.ifi.dbs.elki.distance.distancefunction.LPNormDistanceFunction; +import de.lmu.ifi.dbs.elki.distance.distancefunction.ManhattanDistanceFunction; +import de.lmu.ifi.dbs.elki.distance.distancevalue.DoubleDistance; +import de.lmu.ifi.dbs.elki.distance.distancevalue.NumberDistance; +import de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.AbstractMTree; +import de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.AbstractMTreeNode; +import de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.MTreeEntry; +import de.lmu.ifi.dbs.elki.index.tree.metrical.mtreevariants.mtree.MTreeNode; +import de.lmu.ifi.dbs.elki.result.HierarchicalResult; +import de.lmu.ifi.dbs.elki.result.Result; +import de.lmu.ifi.dbs.elki.result.ResultUtil; +import de.lmu.ifi.dbs.elki.utilities.iterator.IterableIterator; +import de.lmu.ifi.dbs.elki.utilities.optionhandling.AbstractParameterizer; +import de.lmu.ifi.dbs.elki.utilities.optionhandling.parameterization.Parameterization; +import de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.Flag; +import de.lmu.ifi.dbs.elki.visualization.VisualizationTask; +import de.lmu.ifi.dbs.elki.visualization.colors.ColorLibrary; +import de.lmu.ifi.dbs.elki.visualization.css.CSSClass; +import de.lmu.ifi.dbs.elki.visualization.projections.Projection2D; +import de.lmu.ifi.dbs.elki.visualization.projector.ScatterPlotProjector; +import de.lmu.ifi.dbs.elki.visualization.style.StyleLibrary; +import de.lmu.ifi.dbs.elki.visualization.svg.SVGHyperSphere; +import de.lmu.ifi.dbs.elki.visualization.svg.SVGPlot; +import de.lmu.ifi.dbs.elki.visualization.svg.SVGUtil; +import de.lmu.ifi.dbs.elki.visualization.visualizers.AbstractVisFactory; +import de.lmu.ifi.dbs.elki.visualization.visualizers.Visualization; +import de.lmu.ifi.dbs.elki.visualization.visualizers.scatterplot.AbstractScatterplotVisualization; + +/** + * Visualize the bounding sphere of a metric index. + * + * @author Erich Schubert + * + * @apiviz.has AbstractMTree oneway - - visualizes + * @apiviz.uses SVGHyperSphere + * + * @param <N> Tree node type + * @param <E> Tree entry type + */ +// TODO: listen for tree changes! +public class TreeSphereVisualization<D extends NumberDistance<D, ?>, N extends AbstractMTreeNode<?, D, N, E>, E extends MTreeEntry<D>> extends AbstractScatterplotVisualization implements DataStoreListener { + /** + * Generic tag to indicate the type of element. Used in IDs, CSS-Classes etc. + */ + public static final String INDEX = "index"; + + /** + * A short name characterizing this Visualizer. + */ + public static final String NAME = "Index Spheres"; + + /** + * Drawing modes. + * + * @apiviz.exclude + */ + private enum Modus { + MANHATTAN, EUCLIDEAN, LPCROSS + } + + protected double p; + + /** + * Drawing mode (distance) to use + */ + protected Modus dist = Modus.LPCROSS; + + /** + * The tree we visualize + */ + protected AbstractMTree<?, D, N, E> tree; + + /** + * Fill parameter. + */ + protected boolean fill = false; + + /** + * Constructor + * + * @param task Task + * @param fill fill flag + */ + @SuppressWarnings("unchecked") + public TreeSphereVisualization(VisualizationTask task, boolean fill) { + super(task); + this.tree = AbstractMTree.class.cast(task.getResult()); + this.p = getLPNormP(this.tree); + this.fill = fill; + incrementalRedraw(); + context.addDataStoreListener(this); + } + + /** + * Get the "p" value of an Lp norm. + * + * @param tree Tree to visualize + * @return p value + */ + public static Double getLPNormP(AbstractMTree<?, ?, ?, ?> tree) { + // Note: we deliberately lose generics here, so the compilers complain less + // on the next typecheck and cast! + DistanceFunction<?, ?> distanceFunction = tree.getDistanceQuery().getDistanceFunction(); + if(LPNormDistanceFunction.class.isInstance(distanceFunction)) { + return ((LPNormDistanceFunction) distanceFunction).getP(); + } + return null; + } + + /** + * Test for a visualizable index in the context's database. + * + * @param tree Tree to visualize + * @return whether the tree is visualizable + */ + public static boolean canVisualize(AbstractMTree<?, ?, ?, ?> tree) { + Double p = getLPNormP(tree); + return (p != null); + } + + @Override + protected void redraw() { + int projdim = proj.getVisibleDimensions2D().cardinality(); + ColorLibrary colors = context.getStyleLibrary().getColorSet(StyleLibrary.PLOT); + + p = getLPNormP(tree); + if(tree != null) { + if(ManhattanDistanceFunction.class.isInstance(tree.getDistanceQuery())) { + dist = Modus.MANHATTAN; + } + else if(EuclideanDistanceFunction.class.isInstance(tree.getDistanceQuery())) { + dist = Modus.EUCLIDEAN; + } + else { + dist = Modus.LPCROSS; + } + E root = tree.getRootEntry(); + final int mtheight = tree.getHeight(); + for(int i = 0; i < mtheight; i++) { + CSSClass cls = new CSSClass(this, INDEX + i); + // Relative depth of this level. 1.0 = toplevel + final double relDepth = 1. - (((double) i) / mtheight); + if(fill) { + cls.setStatement(SVGConstants.CSS_STROKE_PROPERTY, colors.getColor(i)); + cls.setStatement(SVGConstants.CSS_STROKE_WIDTH_PROPERTY, relDepth * context.getStyleLibrary().getLineWidth(StyleLibrary.PLOT)); + cls.setStatement(SVGConstants.CSS_FILL_PROPERTY, colors.getColor(i)); + cls.setStatement(SVGConstants.CSS_FILL_OPACITY_PROPERTY, 0.1 / (projdim - 1)); + cls.setStatement(SVGConstants.CSS_STROKE_LINECAP_PROPERTY, SVGConstants.CSS_ROUND_VALUE); + cls.setStatement(SVGConstants.CSS_STROKE_LINEJOIN_PROPERTY, SVGConstants.CSS_ROUND_VALUE); + } + else { + cls.setStatement(SVGConstants.CSS_STROKE_PROPERTY, colors.getColor(i)); + cls.setStatement(SVGConstants.CSS_STROKE_WIDTH_PROPERTY, relDepth * context.getStyleLibrary().getLineWidth(StyleLibrary.PLOT)); + cls.setStatement(SVGConstants.CSS_FILL_PROPERTY, SVGConstants.CSS_NONE_VALUE); + cls.setStatement(SVGConstants.CSS_STROKE_LINECAP_PROPERTY, SVGConstants.CSS_ROUND_VALUE); + cls.setStatement(SVGConstants.CSS_STROKE_LINEJOIN_PROPERTY, SVGConstants.CSS_ROUND_VALUE); + } + svgp.addCSSClassOrLogError(cls); + } + visualizeMTreeEntry(svgp, this.layer, proj, tree, root, 0); + } + } + + /** + * Recursively draw the MBR rectangles. + * + * @param svgp SVG Plot + * @param layer Layer + * @param proj Projection + * @param mtree Mtree to visualize + * @param entry Current entry + * @param depth Current depth + */ + private void visualizeMTreeEntry(SVGPlot svgp, Element layer, Projection2D proj, AbstractMTree<?, D, N, E> mtree, E entry, int depth) { + DBID roid = entry.getRoutingObjectID(); + if(roid != null) { + NumberVector<?, ?> ro = rel.get(roid); + D rad = entry.getCoveringRadius(); + + final Element r; + if(dist == Modus.MANHATTAN) { + r = SVGHyperSphere.drawManhattan(svgp, proj, ro, rad); + } + else if(dist == Modus.EUCLIDEAN) { + r = SVGHyperSphere.drawEuclidean(svgp, proj, ro, rad); + } + // TODO: add visualizer for infinity norm? + else { + // r = SVGHyperSphere.drawCross(svgp, proj, ro, rad); + r = SVGHyperSphere.drawLp(svgp, proj, ro, rad, p); + } + SVGUtil.setCSSClass(r, INDEX + (depth - 1)); + layer.appendChild(r); + } + + if(!entry.isLeafEntry()) { + N node = mtree.getNode(entry); + for(int i = 0; i < node.getNumEntries(); i++) { + E child = node.getEntry(i); + if(!child.isLeafEntry()) { + visualizeMTreeEntry(svgp, layer, proj, mtree, child, depth + 1); + } + } + } + } + + @Override + public void destroy() { + super.destroy(); + context.removeDataStoreListener(this); + } + + /** + * Factory + * + * @author Erich Schubert + * + * @apiviz.stereotype factory + * @apiviz.uses TreeSphereVisualization oneway - - «create» + */ + public static class Factory extends AbstractVisFactory { + /** + * Fill parameter. + */ + protected boolean fill = false; + + /** + * Constructor. + * + * @param fill + */ + public Factory(boolean fill) { + super(); + this.fill = fill; + } + + @Override + public void processNewResult(HierarchicalResult baseResult, Result result) { + IterableIterator<ScatterPlotProjector<?>> ps = ResultUtil.filteredResults(baseResult, ScatterPlotProjector.class); + for(ScatterPlotProjector<?> p : ps) { + ArrayList<AbstractMTree<?, DoubleDistance, ?, ?>> trees = ResultUtil.filterResults(result, AbstractMTree.class); + for(AbstractMTree<?, DoubleDistance, ?, ?> tree : trees) { + if(canVisualize(tree) && tree instanceof Result) { + final VisualizationTask task = new VisualizationTask(NAME, (Result) tree, p.getRelation(), this); + task.put(VisualizationTask.META_LEVEL, VisualizationTask.LEVEL_BACKGROUND + 1); + baseResult.getHierarchy().add((Result) tree, task); + baseResult.getHierarchy().add(p, task); + } + } + } + } + + @Override + public Visualization makeVisualization(VisualizationTask task) { + return new TreeSphereVisualization<DoubleDistance, MTreeNode<Object, DoubleDistance>, MTreeEntry<DoubleDistance>>(task, fill); + } + + /** + * Parameterization class. + * + * @author Erich Schubert + * + * @apiviz.exclude + */ + public static class Parameterizer extends AbstractParameterizer { + protected boolean fill = false; + + @Override + protected void makeOptions(Parameterization config) { + super.makeOptions(config); + Flag fillF = new Flag(TreeMBRVisualization.Factory.FILL_ID); + if(config.grab(fillF)) { + fill = fillF.getValue(); + } + } + + @Override + protected Factory makeInstance() { + return new Factory(fill); + } + } + } +}
\ No newline at end of file |