meka.gui.explorer

Class Explorer

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

meka.gui.core.MekaPanel

meka.gui.explorer.Explorer

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, CommandLineArgsHandler, MenuBarProvider

public class Explorer
extends MekaPanel
implements MenuBarProvider, CommandLineArgsHandler

Explorer GUI for MEKA.

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 File	m_CurrentFile the current file.
protected weka.core.Instances	m_Data data currently loaded.
protected weka.gui.ConverterFileChooser	m_FileChooser the file chooser for loading/saving files.
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_MenuItemEditData the "redo" menu item.
protected JMenuItem	m_MenuItemEditUndo the "undo" menu item.
protected JMenuItem	m_MenuItemFileClose the "close" menu item.
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<AbstractExplorerTab>	m_Tabs the tabs.
protected ArrayList<File>	m_Undo the undo list.
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
Explorer()

Method Summary

Modifier and Type	Method and Description
boolean	addUndoPoint() Adds an undo point.
boolean	canUndo() Returns whether any operations can be undone currently.
void	close() Closes the explorer.
void	edit() edits the current instances object in the viewer
protected void	finishInit() Finishes the initialization.
weka.core.Instances	getCurrentData() Returns the currently loaded data.
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(AbstractExplorerTab 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(AbstractExplorerTab tab, String msg) For logging messages.
static void	main(String[] args) Starts the GUI.
void	notifyTabsDataChanged(AbstractExplorerTab source, weka.core.Instances data) Notifies all the tabs that the data has changed.
void	open() Opens a dataset.
void	open(File file, weka.core.converters.AbstractFileLoader loader) Opens the specified file.
void	processCommandLineArgs(String[] args) Processes the commandline arguments.
void	save() Saves the current dataset.
void	save(File file, weka.core.converters.AbstractFileSaver saver) Saves the data to the specified file.
void	saveAs() Saves the current dataset under a new name.
void	undo() Undos the last operation.
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<AbstractExplorerTab> m_Tabs

the tabs.

m_MenuBar

protected JMenuBar m_MenuBar

the menu bar.

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_MenuItemEditUndo

protected JMenuItem m_MenuItemEditUndo

the "undo" menu item.

m_MenuItemEditData

protected JMenuItem m_MenuItemEditData

the "redo" menu item.

m_RecentFilesHandler

protected RecentFilesHandlerWithCommandline<JMenu> m_RecentFilesHandler

the recent files handler.

m_Data

protected weka.core.Instances m_Data

data currently loaded.

m_CurrentFile

protected File m_CurrentFile

the current file.

m_FileChooser

protected weka.gui.ConverterFileChooser m_FileChooser

the file chooser for loading/saving files.

m_Undo

protected ArrayList<File> m_Undo

the undo list.

m_StatusBar

protected StatusBar m_StatusBar

the statusbar to use.

m_LogTab

protected LogTab m_LogTab

the log tab.

Constructor Detail

Explorer

public Explorer()

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

notifyTabsDataChanged

public void notifyTabsDataChanged(AbstractExplorerTab source,
                                  weka.core.Instances data)

Notifies all the tabs that the data has changed.

Parameters:

source - not null if a tab triggered this call

data - the new data 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

getCurrentData

public weka.core.Instances getCurrentData()

Returns the currently loaded data.

Returns:

the data, null if none loaded

getCurrentFile

public File getCurrentFile()

Returns the filename of the currently loaded data.

Returns:

the filename, null if none available

open

public void open(File file,
                 weka.core.converters.AbstractFileLoader loader)

Opens the specified file.

Parameters:

file - the file to open

loader - the loader to use

open

public void open()

Opens a dataset.

save

public void save(File file,
                 weka.core.converters.AbstractFileSaver saver)

Saves the data to the specified file.

Parameters:

file - the file to save the data to

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

save

public void save()

Saves the current dataset.

saveAs

public void saveAs()

Saves the current dataset under a new name.

close

public void close()

Closes the explorer.

edit

public void edit()

edits the current instances object in the viewer

addUndoPoint

public boolean addUndoPoint()

Adds an undo point.

Returns:

true if successfully added

canUndo

public boolean canUndo()

Returns whether any operations can be undone currently.

Returns:

true undo is possible

undo

public void undo()

Undos the last operation.

log

protected void log(AbstractExplorerTab tab,
                   String msg)

For logging messages.

Parameters:

tab - the origin of the message

msg - the message to output

handleException

public String handleException(AbstractExplorerTab 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