meka.gui.components

Class AttributeSelectionPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

meka.gui.components.AttributeSelectionPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class AttributeSelectionPanel
extends JPanel

Creates a panel that displays the attributes contained in a set of instances, letting the user toggle whether each attribute is selected or not (eg: so that unselected attributes can be removed before classification).
Besides the All, None and Invert button one can also choose attributes which names match a regular expression (Pattern button). E.g. for removing all attributes that contain an ID and therefore unwanted information, one can match all names that contain "id" in the name:

 (.*_id_.*|.*_id$|^id$)
 

This does not match e.g. "humidity", which could be an attribute we would like to keep.

Version:

$Revision$

Author:

Len Trigg (trigg@cs.waikato.ac.nz), FracPete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AttributeSelectionPanel.CellRenderer Cell renderer for the attributes.

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 JButton	m_IncludeAll Press to select all attributes
protected JButton	m_Invert Press to invert the current selection
protected meka.gui.components.AttributeSelectionPanel.AttributeTableModel	m_Model The table model containing attribute names and selection status
protected JButton	m_Pattern Press to enter a perl regular expression for selection
protected String	m_PatternRegEx The current regular expression.
protected JButton	m_RemoveAll Press to deselect all attributes
protected JTable	m_Table The table displaying attribute names and selection status

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
AttributeSelectionPanel() Creates the attribute selection panel with no initial instances.
AttributeSelectionPanel(boolean include, boolean remove, boolean invert, boolean pattern) Creates the attribute selection panel with no initial instances.

Method Summary

Modifier and Type	Method and Description
Dimension	getPreferredScrollableViewportSize()
int[]	getSelectedAttributes() Gets an array containing the indices of all selected attributes.
ListSelectionModel	getSelectionModel() Gets the selection model used by the table.
TableModel	getTableModel() Get the table model in use (or null if no instances have been set yet).
static void	main(String[] args) Tests the attribute selection panel from the command line.
void	setInstances(weka.core.Instances newInstances) Sets the instances who's attribute names will be displayed.
void	setPreferredScrollableViewportSize(Dimension d)
void	setSelectedAttributes(boolean[] selected) Set the selected attributes in the widget.

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

m_IncludeAll

protected JButton m_IncludeAll

Press to select all attributes

m_RemoveAll

protected JButton m_RemoveAll

Press to deselect all attributes

m_Invert

protected JButton m_Invert

Press to invert the current selection

m_Pattern

protected JButton m_Pattern

Press to enter a perl regular expression for selection

m_Table

protected JTable m_Table

The table displaying attribute names and selection status

m_Model

protected meka.gui.components.AttributeSelectionPanel.AttributeTableModel m_Model

The table model containing attribute names and selection status

m_PatternRegEx

protected String m_PatternRegEx

The current regular expression.

Constructor Detail

AttributeSelectionPanel

public AttributeSelectionPanel()

Creates the attribute selection panel with no initial instances.

AttributeSelectionPanel

public AttributeSelectionPanel(boolean include,
                               boolean remove,
                               boolean invert,
                               boolean pattern)

Creates the attribute selection panel with no initial instances.

Parameters:

include - true if the include button is to be shown

remove - true if the remove button is to be shown

invert - true if the invert button is to be shown

pattern - true if the pattern button is to be shown

Method Detail

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()

setPreferredScrollableViewportSize

public void setPreferredScrollableViewportSize(Dimension d)

setInstances

public void setInstances(weka.core.Instances newInstances)

Sets the instances who's attribute names will be displayed.

Parameters:

newInstances - the new set of instances

getSelectedAttributes

public int[] getSelectedAttributes()

Gets an array containing the indices of all selected attributes.

Returns:

the array of selected indices.

setSelectedAttributes

public void setSelectedAttributes(boolean[] selected)
                           throws Exception

Set the selected attributes in the widget. Note that setInstances() must have been called first.

Parameters:

selected - an array of boolean indicating which attributes are to have their check boxes selected.

Throws:

Exception - if the supplied array of booleans does not have the same number of elements as there are attributes.

getTableModel

public TableModel getTableModel()

Get the table model in use (or null if no instances have been set yet).

Returns:

the table model in use or null if no instances have been seen yet.

getSelectionModel

public ListSelectionModel getSelectionModel()

Gets the selection model used by the table.

Returns:

a value of type 'ListSelectionModel'

main

public static void main(String[] args)

Tests the attribute selection panel from the command line.

Parameters:

args - must contain the name of an arff file to load.