meka.gui.experimenter

Class Experimenter

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

meka.gui.core.MekaPanel

meka.gui.experimenter.Experimenter

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, LogListener, ExecutionStageListener, IterationNotificationListener, StatisticsNotificationListener, CommandLineArgsHandler, MenuBarProvider

public class Experimenter
extends MekaPanel
implements MenuBarProvider, CommandLineArgsHandler, IterationNotificationListener, LogListener, StatisticsNotificationListener, ExecutionStageListener

Experimenter interface.

Version:

$Revision$

Author:

FracPete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected HashMap<AbstractExperimenterMenuItem,AbstractAction>	m_AdditionalMenuItems additional menu items.
protected File	m_CurrentFile the current file.
protected Experiment	m_Experiment the current experiment.
protected ExperimentFileChooser	m_FileChooser the file chooser for the experiments.
protected LogTab	m_LogTab the log tab.
protected JMenuBar	m_MenuBar the menu bar.
protected JMenu	m_MenuFileOpenRecent the "load recent" submenu.
protected JMenuItem	m_MenuItemExecutionStart the "start" menu item.
protected JMenuItem	m_MenuItemExecutionStop the "stop" menu item.
protected JMenuItem	m_MenuItemFileClose the "close" menu item.
protected JMenu	m_MenuItemFileNew the "new" menu.
protected JMenuItem	m_MenuItemFileOpen the "open" menu item.
protected JMenuItem	m_MenuItemFileSave the "save" menu item.
protected JMenuItem	m_MenuItemFileSaveAs the "save as" menu item.
protected RecentFilesHandlerWithCommandline<JMenu>	m_RecentFilesHandler the recent files handler.
protected StatusBar	m_StatusBar the statusbar to use.
protected JTabbedPane	m_TabbedPane the tabbed pane for the various panels.
protected ArrayList<AbstractExperimenterTab>	m_Tabs the tabs.
static String	SESSION_FILE the file to store the recent files in.

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
Experimenter()

Method Summary

Modifier and Type	Method and Description
void	close() Closes the experimenter.
void	experimentStage(ExecutionStageEvent e) Gets called when the experiment enters a new stage.
protected void	finishInit() Finishes the initialization.
Experiment	getCurrentExperiment() Returns the current experiment, null if not available.
File	getCurrentFile() Returns the filename of the currently loaded data.
JMenuBar	getMenuBar() Returns the menu bar to use.
StatusBar	getStatusBar() Returns the status bar.
String	handleException(AbstractExperimenterTab tab, String msg, Throwable t) Logs the stacktrace along with the message on the log tab and returns a combination of both of them as string.
protected void	initGUI() Initializes the widgets.
protected void	initialize() Initializes the members.
protected void	log(AbstractExperimenterTab tab, String msg) For logging messages.
void	logMessage(LogEvent e) Gets called if there is a new log message.
static void	main(String[] args) Starts the GUI.
void	newSetup(Class cls) Instantiates an experiment from the provided class.
void	nextIteration(IterationNotificationEvent e) Gets called if there is a new iteration (classifier/dataset combination) occurring in the experiment.
void	notifyTabsExperimentChanged(AbstractExperimenterTab source, Experiment exp) Notifies all the tabs that the experiment has changed.
void	open() Opens an experiment.
void	open(File file, ExperimentFileHandler handler) Opens the specified experiment file.
void	processCommandLineArgs(String[] args) Processes the commandline arguments.
void	save() Saves the current experiment.
void	save(File file, ExperimentFileHandler handler) Saves the experiment to the specified file.
void	saveAs() Saves the current experiment under a new name.
void	start() Starts the experiment.
void	statisticsAvailable(StatisticsNotificationEvent e) Gets called if new statistics have become available.
void	stop() Stops the current experiment.
protected void	updateMenu() Updates the enabled/disabled state of the menu items.

Methods inherited from class meka.gui.core.MekaPanel

closeParent, getParentDialog, getParentFrame

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

SESSION_FILE

public static final String SESSION_FILE

the file to store the recent files in.

See Also:

Constant Field Values

m_TabbedPane

protected JTabbedPane m_TabbedPane

the tabbed pane for the various panels.

m_Tabs

protected ArrayList<AbstractExperimenterTab> m_Tabs

the tabs.

m_MenuBar

protected JMenuBar m_MenuBar

the menu bar.

m_MenuItemFileNew

protected JMenu m_MenuItemFileNew

the "new" menu.

m_MenuItemFileOpen

protected JMenuItem m_MenuItemFileOpen

the "open" menu item.

m_MenuItemFileSave

protected JMenuItem m_MenuItemFileSave

the "save" menu item.

m_MenuFileOpenRecent

protected JMenu m_MenuFileOpenRecent

the "load recent" submenu.

m_MenuItemFileSaveAs

protected JMenuItem m_MenuItemFileSaveAs

the "save as" menu item.

m_MenuItemFileClose

protected JMenuItem m_MenuItemFileClose

the "close" menu item.

m_MenuItemExecutionStart

protected JMenuItem m_MenuItemExecutionStart

the "start" menu item.

m_MenuItemExecutionStop

protected JMenuItem m_MenuItemExecutionStop

the "stop" menu item.

m_RecentFilesHandler

protected RecentFilesHandlerWithCommandline<JMenu> m_RecentFilesHandler

the recent files handler.

m_StatusBar

protected StatusBar m_StatusBar

the statusbar to use.

m_CurrentFile

protected File m_CurrentFile

the current file.

m_LogTab

protected LogTab m_LogTab

the log tab.

m_FileChooser

protected ExperimentFileChooser m_FileChooser

the file chooser for the experiments.

m_Experiment

protected Experiment m_Experiment

the current experiment.

m_AdditionalMenuItems

protected HashMap<AbstractExperimenterMenuItem,AbstractAction> m_AdditionalMenuItems

additional menu items.

Constructor Detail

Experimenter

public Experimenter()

Method Detail

initialize

protected void initialize()

Initializes the members.

Overrides:

initialize in class MekaPanel

initGUI

protected void initGUI()

Initializes the widgets.

Overrides:

initGUI in class MekaPanel

finishInit

protected void finishInit()

Finishes the initialization.

Overrides:

finishInit in class MekaPanel

notifyTabsExperimentChanged

public void notifyTabsExperimentChanged(AbstractExperimenterTab source,
                                        Experiment exp)

Notifies all the tabs that the experiment has changed.

Parameters:

source - not null if a tab triggered this call

exp - the new experiment to use

getMenuBar

public JMenuBar getMenuBar()

Returns the menu bar to use.

Specified by:

getMenuBar in interface MenuBarProvider

Returns:

the menu bar

updateMenu

protected void updateMenu()

Updates the enabled/disabled state of the menu items.

getStatusBar

public StatusBar getStatusBar()

Returns the status bar.

Returns:

the status bar

getCurrentExperiment

public Experiment getCurrentExperiment()

Returns the current experiment, null if not available.

Returns:

the experiment, null if none available

getCurrentFile

public File getCurrentFile()

Returns the filename of the currently loaded data.

Returns:

the filename, null if none available

newSetup

public void newSetup(Class cls)

Instantiates an experiment from the provided class.

Parameters:

cls - the experiment class to use

open

public void open()

Opens an experiment.

open

public void open(File file,
                 ExperimentFileHandler handler)

Opens the specified experiment file.

Parameters:

file - the file to open

handler - the handler to use

save

public void save(File file,
                 ExperimentFileHandler handler)

Saves the experiment to the specified file.

Parameters:

file - the file to save the experiment to

handler - the saver to use, determines it automatically if null

save

public void save()

Saves the current experiment.

saveAs

public void saveAs()

Saves the current experiment under a new name.

close

public void close()

Closes the experimenter.

start

public void start()

Starts the experiment.

stop

public void stop()

Stops the current experiment.

nextIteration

public void nextIteration(IterationNotificationEvent e)

Gets called if there is a new iteration (classifier/dataset combination) occurring in the experiment.

Specified by:

nextIteration in interface IterationNotificationListener

Parameters:

e - the event

logMessage

public void logMessage(LogEvent e)

Gets called if there is a new log message.

Specified by:

logMessage in interface LogListener

Parameters:

e - the event

statisticsAvailable

public void statisticsAvailable(StatisticsNotificationEvent e)

Gets called if new statistics have become available.

Specified by:

statisticsAvailable in interface StatisticsNotificationListener

Parameters:

e - the event

experimentStage

public void experimentStage(ExecutionStageEvent e)

Gets called when the experiment enters a new stage.

Specified by:

experimentStage in interface ExecutionStageListener

Parameters:

e - the event

log

protected void log(AbstractExperimenterTab tab,
                   String msg)

For logging messages.

Parameters:

tab - the origin of the message

msg - the message to output

handleException

public String handleException(AbstractExperimenterTab tab,
                              String msg,
                              Throwable t)

Logs the stacktrace along with the message on the log tab and returns a combination of both of them as string.

Parameters:

tab - the origin of the message

msg - the message for the exception

t - the exception

Returns:

the full error message (message + stacktrace)

processCommandLineArgs

public void processCommandLineArgs(String[] args)

Processes the commandline arguments.

Specified by:

processCommandLineArgs in interface CommandLineArgsHandler

Parameters:

args - the arguments

main

public static void main(String[] args)
                 throws Exception

Starts the GUI.

Parameters:

args - ignored

Throws:

Exception