ace.gui
Class MainGUIFrame

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by java.awt.Window
              extended by java.awt.Frame
                  extended by javax.swing.JFrame
                      extended by ace.gui.MainGUIFrame
All Implemented Interfaces:
java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants

public class MainGUIFrame
extends javax.swing.JFrame
implements java.awt.event.ActionListener

Part of the ACE project. This is the main GUI container that is used to hold tabbed panes and menus. The DataBoard used by ACE to store taxonomy, feature and instance information is also stored in objects of this class, and can be accessed externally by other objects.

The File menu allows the user to load and save project files or to quit. The Load Configuration Files menu item allows the users to load an ACE project the related ACE files using the File Path Settings dialog box. This erases any existing project information currently in memory. The Save Project menu item saves all information currently in memory to the paths specified in the File Path Settings dialog box. The Save Project Paths menu item stores the paths specified in the File Path Settings dialog box as an ACE project file, but does not actually save data to each of these paths. The Load Zip menu item allows the user to specify an ACE zip file to be loaded. The contents of the specified zip file are extracted into a temporary directory. The Quit menu item quits the ACE software. If a zipfile has been loaded, the user will be prompted to save the current data back into a zipfile. Otherwise, all unsaved data will be lost when ACE exits.

The Help menu allows the user to view basic information about ACE or view the on-line manual. The About menu item shows basic version and authourship information on the ACE software. The View Manual displays the on-line browsable manual to ACE.

The Taxonomy panel allows the user to view and edit information relating to the taxonomy which classifiers are to be made based on, if any.

The Instances panel allows the user to view and edit information relating to features extracted from instances, model classifications of instances and meta-data relating to instances.

The Feature Settings panel allows the user to view meta-data on features.

The Preferences panel allows the user to view and edit user preferences relating to the ACE GUI.

The Classification Settings panel allows the user to view and edit information relating to how training, testing and meta-learning is to be performed.

The Experimenter panel allows the user to perform classification experiments.

See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JFrame
javax.swing.JFrame.AccessibleJFrame
 
Nested classes/interfaces inherited from class java.awt.Frame
java.awt.Frame.AccessibleAWTFrame
 
Nested classes/interfaces inherited from class java.awt.Window
java.awt.Window.AccessibleAWTWindow
 
Nested classes/interfaces inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
 DataBoard data_board
          The object that stores the current taxonomy, feature settings, instance feature values and model classifications.
 Project project
          This object stores the path names to all component ACE XML files of an ACE project.
 ProjectFilesDialogBox project_files_dialog_box
          Dialog box that stores paths of ACE XML or Weka ACE files used in current project.
 boolean project_previously_loaded
          Notes whether a project has already been loaded
 TaxonomyPanel taxonomy_panel
          The panel used to view and edit the current taxonomy.
 java.util.LinkedList<java.lang.String> temp_files
          List of files and/or directories to be deleted when ACE closes.
 boolean zipfile_loaded
          Notes whether a zipfile has been loaded.
 
Fields inherited from class javax.swing.JFrame
accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Frame
CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
MainGUIFrame()
          Construct the ACE GUI and load the default startup project (called default_ace_project.xml) if it is is available.
MainGUIFrame(java.lang.String project_file_name)
          Construct the ACE GUI and load the specified startup project.
MainGUIFrame(java.lang.String taxonomy_file, java.lang.String[] feature_key_files, java.lang.String[] feature_vector_files, java.lang.String[] model_classifications_files, java.lang.String weka_arff_file, java.lang.String trained_classifiers_file)
          Construct the ACE GUI and load the specified configuration files.
 
Method Summary
 void actionPerformed(java.awt.event.ActionEvent event)
          Calls the appropriate methods when the menu items are selected.
 void loadNewConfigurationFiles()
          Load a new set of configuration files based on the contents of the project_files_dialog_box.
 
Methods inherited from class javax.swing.JFrame
addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update
 
Methods inherited from class java.awt.Frame
addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setVisible, show, toBack, toFront
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.awt.MenuContainer
getFont, postEvent
 

Field Detail

data_board

public DataBoard data_board
The object that stores the current taxonomy, feature settings, instance feature values and model classifications.


project

public Project project
This object stores the path names to all component ACE XML files of an ACE project.


temp_files

public java.util.LinkedList<java.lang.String> temp_files
List of files and/or directories to be deleted when ACE closes. example: The temporary directory into which zipfiles are extracted will be deleted when ACE closes.


project_previously_loaded

public boolean project_previously_loaded
Notes whether a project has already been loaded


zipfile_loaded

public boolean zipfile_loaded
Notes whether a zipfile has been loaded.


project_files_dialog_box

public ProjectFilesDialogBox project_files_dialog_box
Dialog box that stores paths of ACE XML or Weka ACE files used in current project.


taxonomy_panel

public TaxonomyPanel taxonomy_panel
The panel used to view and edit the current taxonomy.

Constructor Detail

MainGUIFrame

public MainGUIFrame()
Construct the ACE GUI and load the default startup project (called default_ace_project.xml) if it is is available. Then display the GUI.


MainGUIFrame

public MainGUIFrame(java.lang.String project_file_name)
             throws java.lang.Exception
Construct the ACE GUI and load the specified startup project. Then display the GUI.

Parameters:
project_file_name - The ACE project file to load upon startup.
Throws:
java.lang.Exception - If an error occurs.

MainGUIFrame

public MainGUIFrame(java.lang.String taxonomy_file,
                    java.lang.String[] feature_key_files,
                    java.lang.String[] feature_vector_files,
                    java.lang.String[] model_classifications_files,
                    java.lang.String weka_arff_file,
                    java.lang.String trained_classifiers_file)
Construct the ACE GUI and load the specified configuration files. Then display the GUI. If a default startup project (called default_ace_project.xml) is available, then the gui_settings_path and classifier_settings_file are loaded from it, otherwise they are defaulted to empty.

Parameters:
taxonomy_file - The path of the taxonomy file to store in this dialog box. If no entry is to be stored, "" should be passed, not null.
feature_key_files - The path of the feature key file to store in this dialog box. If no entry is to be stored, "" should be passed, not null.
feature_vector_files - The path of the feacture vector files to store in this dialog box. If no entry is to be stored, "" should be passed, not null.
model_classifications_files - The path of the model classifications file to store in this dialog box. If no entry is to be stored, "" should be passed, not null.
weka_arff_file - The path of the Weka ARFF file to store in this dialog box. If no entry is to be stored, "" should be passed, not null.
trained_classifiers_file - The path of the trained classifiers file to store in this dialog box. If no entry is to be stored, "" should be passed, not null.
Method Detail

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent event)
Calls the appropriate methods when the menu items are selected.

Specified by:
actionPerformed in interface java.awt.event.ActionListener
Parameters:
event - The event that is to be reacted to.

loadNewConfigurationFiles

public void loadNewConfigurationFiles()
Load a new set of configuration files based on the contents of the project_files_dialog_box. Instantiate a new data_board based on these files If an error occurs, then the previous settings are restored. The GUI panes are then (re)set if no errors occured.