/* * This file is part of ELKI: * Environment for Developing KDD-Applications Supported by Index-Structures * * Copyright (C) 2017 * 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/>. */ package de.lmu.ifi.dbs.elki.result; import javax.swing.JFrame; import de.lmu.ifi.dbs.elki.gui.GUIUtil; import de.lmu.ifi.dbs.elki.logging.Logging; import de.lmu.ifi.dbs.elki.result.Result; import de.lmu.ifi.dbs.elki.result.ResultHandler; import de.lmu.ifi.dbs.elki.result.ResultHierarchy; import de.lmu.ifi.dbs.elki.result.ResultUtil; import de.lmu.ifi.dbs.elki.utilities.Alias; import de.lmu.ifi.dbs.elki.utilities.optionhandling.AbstractParameterizer; import de.lmu.ifi.dbs.elki.utilities.optionhandling.OptionID; 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.utilities.optionhandling.parameters.StringParameter; import de.lmu.ifi.dbs.elki.visualization.VisualizerContext; import de.lmu.ifi.dbs.elki.visualization.VisualizerParameterizer; import de.lmu.ifi.dbs.elki.visualization.gui.ResultWindow; /** * Handler to process and visualize a Result. * * @author Erich Schubert * @author Remigius Wojdanowski * @since 0.3 * * @apiviz.composedOf VisualizerParameterizer * @apiviz.uses ResultWindow oneway */ @Alias({ "visualizer", "vis", "ResultVisualizer", "de.lmu.ifi.dbs.elki.visualization.gui.ResultVisualizer" }) public class AutomaticVisualization implements ResultHandler { /** * Get a logger for this class. */ private static final Logging LOG = Logging.getLogger(AutomaticVisualization.class); /** * Stores the set title. */ String title; /** * Default title */ protected static final String DEFAULT_TITLE = "ELKI Result Visualization"; /** * Visualization manager. */ VisualizerParameterizer manager; /** * Single view mode */ boolean single; /** * Current result window. */ ResultWindow window; /** * Constructor. * * @param title Window title * @param manager Parameterization manager for visualizers * @param single Flag to indicat single-view mode. */ public AutomaticVisualization(String title, VisualizerParameterizer manager, boolean single) { super(); this.title = title; this.manager = manager; this.single = single; } @Override public void processNewResult(final ResultHierarchy hier, final Result result) { if(window == null) { if(title == null) { title = VisualizerParameterizer.getTitle(ResultUtil.findDatabase(hier), result); if(title == null) { title = DEFAULT_TITLE; } } GUIUtil.setLookAndFeel(); VisualizerContext context = manager.newContext(hier, result); window = new ResultWindow(title, context, single); } javax.swing.SwingUtilities.invokeLater(new Runnable() { @Override public void run() { try { window.setVisible(true); window.setExtendedState(window.getExtendedState() | JFrame.MAXIMIZED_BOTH); } catch(Throwable e) { LOG.exception("Error in starting visualizer window.", e); } } }); } /** * Parameterization class. * * @author Erich Schubert * * @apiviz.exclude */ public static class Parameterizer extends AbstractParameterizer { /** * Parameter to specify the window title * <p> * Key: {@code -vis.window.title} * </p> * <p> * Default value: "ELKI Result Visualization" * </p> */ public static final OptionID WINDOW_TITLE_ID = new OptionID("vis.window.title", "Title to use for visualization window."); /** * Flag to set single display * * <p> * Key: -vis.single * </p> */ public static final OptionID SINGLE_ID = new OptionID("vis.window.single", "Embed visualizers in a single window, not using thumbnails and detail views."); /** * Stores the set title. */ String title; /** * Visualization manager. */ VisualizerParameterizer manager; /** * Single view mode. */ boolean single = false; @Override protected void makeOptions(Parameterization config) { super.makeOptions(config); StringParameter titleP = new StringParameter(WINDOW_TITLE_ID); titleP.setOptional(true); if(config.grab(titleP)) { title = titleP.getValue(); } Flag singleF = new Flag(SINGLE_ID); if(config.grab(singleF)) { single = singleF.isTrue(); } manager = config.tryInstantiate(VisualizerParameterizer.class); } @Override protected AutomaticVisualization makeInstance() { return new AutomaticVisualization(title, manager, single); } } }