weka.gui

Class SetInstancesPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

weka.gui.SetInstancesPanel

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class SetInstancesPanel
extends javax.swing.JPanel

A panel that displays an instance summary for a set of instances and lets the user open a set of instances from either a file or URL. Instances may be obtained either in a batch or incremental fashion. If incremental reading is used, then the client should obtain the Loader object (by calling getLoader()) and read the instances one at a time. If batch loading is used, then SetInstancesPanel will load the data into memory inside of a separate thread and notify the client when the operation is complete. The client can then retrieve the instances by calling getInstances().

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JPanel.AccessibleJPanel

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

javax.swing.JComponent.AccessibleJComponent

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

Fields

Modifier and Type	Field and Description
protected javax.swing.JComboBox	m_ClassComboBox the class combobox.
protected javax.swing.JLabel	m_ClassLabel the label for the class combobox.
protected javax.swing.JButton	m_CloseBut Click to close the dialog.
protected javax.swing.JPanel	m_CloseButPanel the panel the Close-Button is located in.
protected ConverterFileChooser	m_FileChooser The file chooser for selecting arff files.
protected Instances	m_Instances The current set of instances loaded.
protected java.lang.Thread	m_IOThread The thread we do loading in.
protected java.lang.String	m_LastURL Stores the last URL that instances were loaded from.
protected Loader	m_Loader The current loader used to obtain the current instances.
protected javax.swing.JButton	m_OpenFileBut Click to open instances from a file.
protected javax.swing.JButton	m_OpenURLBut Click to open instances from a URL.
protected javax.swing.JFrame	m_ParentFrame the parent frame. if one is provided, the close-button is displayed
protected boolean	m_readIncrementally whether to read the instances incrementally, if possible.
protected boolean	m_showClassComboBox whether to display a combobox that allows the user to choose the class attribute.
protected boolean	m_showZeroInstancesAsUnknown whether to display zero instances as unknown ("?").
protected InstancesSummaryPanel	m_Summary The instance summary component.
protected java.beans.PropertyChangeSupport	m_Support Manages sending notifications to people when we change the set of working instances.
static java.lang.String	NO_CLASS the text denoting "no class" in the class combobox.

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
SetInstancesPanel() Default constructor.
SetInstancesPanel(boolean showZeroInstancesAsUnknown, boolean showClassComboBox, ConverterFileChooser chooser) Create the panel.

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(java.beans.PropertyChangeListener l) Adds a PropertyChangeListener who will be notified of value changes.
void	closeFrame() closes the frame, i.e., the visibility is set to false.
int	getClassIndex() Returns the currently selected class index.
Instances	getInstances() Gets the set of instances currently held by the panel.
Loader	getLoader() Gets the currently used Loader.
javax.swing.JFrame	getParentFrame() Returns the current frame the panel knows of, that it resides in.
boolean	getReadIncrementally() Gets whether instances are to be read incrementally or not.
InstancesSummaryPanel	getSummary() Gets the instances summary panel associated with this panel.
void	removePropertyChangeListener(java.beans.PropertyChangeListener l) Removes a PropertyChangeListener.
void	setInstances(Instances i) Updates the set of instances that is currently held by the panel.
protected void	setInstancesFromFile(java.io.File f) Loads results from a set of instances contained in the supplied file.
void	setInstancesFromFileQ() Queries the user for a file to load instances from, then loads the instances in a background process.
protected void	setInstancesFromURL(java.net.URL u) Loads instances from a URL.
void	setInstancesFromURLQ() Queries the user for a URL to load instances from, then loads the instances in a background process.
void	setParentFrame(javax.swing.JFrame parent) Sets the frame, this panel resides in.
void	setReadIncrementally(boolean incremental) Sets whether or not instances should be read incrementally by the Loader.

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, 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, 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

NO_CLASS

public static final java.lang.String NO_CLASS

the text denoting "no class" in the class combobox.

See Also:

Constant Field Values

m_OpenFileBut

protected javax.swing.JButton m_OpenFileBut

Click to open instances from a file.

m_OpenURLBut

protected javax.swing.JButton m_OpenURLBut

Click to open instances from a URL.

m_CloseBut

protected javax.swing.JButton m_CloseBut

Click to close the dialog.

m_Summary

protected InstancesSummaryPanel m_Summary

The instance summary component.

m_ClassLabel

protected javax.swing.JLabel m_ClassLabel

the label for the class combobox.

m_ClassComboBox

protected javax.swing.JComboBox m_ClassComboBox

the class combobox.

m_FileChooser

protected ConverterFileChooser m_FileChooser

The file chooser for selecting arff files.

m_LastURL

protected java.lang.String m_LastURL

Stores the last URL that instances were loaded from.

m_IOThread

protected java.lang.Thread m_IOThread

The thread we do loading in.

m_Support

protected java.beans.PropertyChangeSupport m_Support

Manages sending notifications to people when we change the set of working instances.

m_Instances

protected Instances m_Instances

The current set of instances loaded.

m_Loader

protected Loader m_Loader

The current loader used to obtain the current instances.

m_ParentFrame

protected javax.swing.JFrame m_ParentFrame

the parent frame. if one is provided, the close-button is displayed

m_CloseButPanel

protected javax.swing.JPanel m_CloseButPanel

the panel the Close-Button is located in.

m_readIncrementally

protected boolean m_readIncrementally

whether to read the instances incrementally, if possible.

m_showZeroInstancesAsUnknown

protected boolean m_showZeroInstancesAsUnknown

whether to display zero instances as unknown ("?").

m_showClassComboBox

protected boolean m_showClassComboBox

whether to display a combobox that allows the user to choose the class attribute.

Constructor Detail

SetInstancesPanel

public SetInstancesPanel()

Default constructor.

SetInstancesPanel

public SetInstancesPanel(boolean showZeroInstancesAsUnknown,
                         boolean showClassComboBox,
                         ConverterFileChooser chooser)

Create the panel.

Parameters:

showZeroInstancesAsUnknown - whether to display zero instances as unknown (e.g., when reading data incrementally)

showClassComboBox - whether to display a combobox allowing the user to choose the class attribute

chooser - the file chooser to use (may be null to use the default file chooser)

Method Detail

setParentFrame

public void setParentFrame(javax.swing.JFrame parent)

Sets the frame, this panel resides in. Used for displaying the close button, i.e., the close-button is visible if the given frame is not null.

Parameters:

parent - the parent frame

getParentFrame

public javax.swing.JFrame getParentFrame()

Returns the current frame the panel knows of, that it resides in. Can be null.

Returns:

the current parent frame

closeFrame

public void closeFrame()

closes the frame, i.e., the visibility is set to false.

setInstancesFromFileQ

public void setInstancesFromFileQ()

Queries the user for a file to load instances from, then loads the instances in a background process. This is done in the IO thread, and an error message is popped up if the IO thread is busy.

setInstancesFromURLQ

public void setInstancesFromURLQ()

Queries the user for a URL to load instances from, then loads the instances in a background process. This is done in the IO thread, and an error message is popped up if the IO thread is busy.

setInstancesFromFile

protected void setInstancesFromFile(java.io.File f)

Loads results from a set of instances contained in the supplied file.

Parameters:

f - a value of type 'File'

setInstancesFromURL

protected void setInstancesFromURL(java.net.URL u)

Loads instances from a URL.

Parameters:

u - the URL to load from.

setInstances

public void setInstances(Instances i)

Updates the set of instances that is currently held by the panel.

Parameters:

i - a value of type 'Instances'

getInstances

public Instances getInstances()

Gets the set of instances currently held by the panel.

Returns:

a value of type 'Instances'

getClassIndex

public int getClassIndex()

Returns the currently selected class index.

Returns:

the class index, -1 if none selected

getLoader

public Loader getLoader()

Gets the currently used Loader.

Returns:

a value of type 'Loader'

getSummary

public InstancesSummaryPanel getSummary()

Gets the instances summary panel associated with this panel.

Returns:

the instances summary panel

setReadIncrementally

public void setReadIncrementally(boolean incremental)

Sets whether or not instances should be read incrementally by the Loader. If incremental reading is used, then the client should obtain the Loader object (by calling getLoader()) and read the instances one at a time. If batch loading is used, then SetInstancesPanel will load the data into memory inside of a separate thread and notify the client when the operation is complete. The client can then retrieve the instances by calling getInstances().

Parameters:

incremental - true if instances are to be read incrementally

getReadIncrementally

public boolean getReadIncrementally()

Gets whether instances are to be read incrementally or not.

Returns:

true if instances are to be read incrementally

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener l)

Adds a PropertyChangeListener who will be notified of value changes.

Overrides:

addPropertyChangeListener in class java.awt.Container

Parameters:

l - a value of type 'PropertyChangeListener'

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener l)

Removes a PropertyChangeListener.

Overrides:

removePropertyChangeListener in class java.awt.Component

Parameters:

l - a value of type 'PropertyChangeListener'