uk.ac.starlink.topcat.plot

Class CartesianAxesSelector

java.lang.Object

uk.ac.starlink.topcat.plot.CartesianAxesSelector

All Implemented Interfaces:

AxesSelector

public class CartesianAxesSelector
extends Object
implements AxesSelector

AxesSelector implementation which deals with the straightforward case in which the returned data table consists of the columns selected from the selector's table.

Since:

31 May 2007

Author:

Mark Taylor

Constructor Summary

Constructors

Constructor and Description
CartesianAxesSelector(String[] axisNames, ToggleButtonModel[] logModels, ToggleButtonModel[] flipModels, ErrorModeSelectionModel[] errorModeModels) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addActionListener(ActionListener listener) Adds a listener which is notified when any of the selections made by this component changes.
AxisEditor[]	createAxisEditors() Constructs an array of AxisEditor objects suitable for modifying the axes which are defined by this selector.
PointStore	createPointStore(int npoint) Returns a PointStore suitable for storing coordinate and error information generated by the current state of this selector.
JComboBox	getColumnSelector(int icol) Returns one of the the column selector boxes used by this selector.
JComponent	getColumnSelectorPanel() Gets the panel which displays selectors for the columns.
JComboBox[]	getColumnSelectors() Returns the array of combo boxes which are used to select column or other values.
uk.ac.starlink.table.StarTable	getData() Returns a StarTable which corresponds to the data in the columns selected by the current selections on this object.
AxisDataSelector	getDataSelector(int icol) Returns one of the axis selector boxes used by this selector.
uk.ac.starlink.table.StarTable	getErrorData() Returns a StarTable containing error information as selected in this component.
uk.ac.starlink.ttools.plot.ErrorMode[]	getErrorModes() Returns the error modes currently in force for this selector.
uk.ac.starlink.table.StarTable	getLabelData() Returns a StarTable whose single column contains a label for each point.
int	getNdim() Returns the number of columns in the table that AxesSelector.getData() will return.
TopcatModel	getTable() Returns the TopcatModel for which this selector is currently selecting axes.
void	initialiseSelectors() Hint to set up the values of the column selectors to a sensible value.
boolean	isReady() Indicates whether this selector has enough state filled in to be able to specify some point data.
void	removeActionListener(ActionListener listener) Removes a listener added by AxesSelector.addActionListener(java.awt.event.ActionListener).
void	setTable(TopcatModel tcModel) Set up column selectors correctly for the given model.

Methods inherited from class java.lang.Object

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

Constructor Detail

CartesianAxesSelector

public CartesianAxesSelector(String[] axisNames,
                             ToggleButtonModel[] logModels,
                             ToggleButtonModel[] flipModels,
                             ErrorModeSelectionModel[] errorModeModels)

Constructor.

Method Detail

getColumnSelectorPanel

public JComponent getColumnSelectorPanel()

Gets the panel which displays selectors for the columns.

Specified by:

getColumnSelectorPanel in interface AxesSelector

Returns:

column selector panel

getColumnSelectors

public JComboBox[] getColumnSelectors()

Description copied from interface: AxesSelector

Returns the array of combo boxes which are used to select column or other values.

Specified by:

getColumnSelectors in interface AxesSelector

Returns:

array of column selector combo boxes

getNdim

public int getNdim()

Description copied from interface: AxesSelector

Returns the number of columns in the table that AxesSelector.getData() will return.

Specified by:

getNdim in interface AxesSelector

Returns:

dimensionality

isReady

public boolean isReady()

Description copied from interface: AxesSelector

Indicates whether this selector has enough state filled in to be able to specify some point data.

Specified by:

isReady in interface AxesSelector

Returns:

true iff properly filled in

getData

public uk.ac.starlink.table.StarTable getData()

Description copied from interface: AxesSelector

Returns a StarTable which corresponds to the data in the columns selected by the current selections on this object.

Note: for performance reasons, it is imperative that two tables returned from this method must match according to the Object.equals(java.lang.Object) method if they are known to contain the same cell data (i.e. if the state of this selector has not changed in the mean time). Don't forget to do hashCode too.

Specified by:

getData in interface AxesSelector

Returns:

table containing the data from the current selection

getErrorData

public uk.ac.starlink.table.StarTable getErrorData()

Returns a StarTable containing error information as selected in this component. The columns from the active selectors (if any) of each AxisDataSelector are packed one after another. It is necessary to know the ErrorModes currently in force to make sense of this information.

Specified by:

getErrorData in interface AxesSelector

Returns:

error data table

getErrorModes

public uk.ac.starlink.ttools.plot.ErrorMode[] getErrorModes()

Description copied from interface: AxesSelector

Returns the error modes currently in force for this selector.

Specified by:

getErrorModes in interface AxesSelector

Returns:

error mode array

getLabelData

public uk.ac.starlink.table.StarTable getLabelData()

Description copied from interface: AxesSelector

Returns a StarTable whose single column contains a label for each point.

See the notes in AxesSelector.getData() about table equality - the same constraints apply.

Specified by:

getLabelData in interface AxesSelector

Returns:

label table

getDataSelector

public AxisDataSelector getDataSelector(int icol)

Returns one of the axis selector boxes used by this selector.

Parameters:

icol - column index

Returns:

axis selector

getColumnSelector

public JComboBox getColumnSelector(int icol)

Returns one of the the column selector boxes used by this selector.

Parameters:

icol - column index

Returns:

column selector box

createAxisEditors

public AxisEditor[] createAxisEditors()

Description copied from interface: AxesSelector

Constructs an array of AxisEditor objects suitable for modifying the axes which are defined by this selector. The number of them is often, but not necessarily, the same as the dimensionality of this selector.

Specified by:

createAxisEditors in interface AxesSelector

Returns:

array of new AxisEditors

createPointStore

public PointStore createPointStore(int npoint)

Description copied from interface: AxesSelector

Returns a PointStore suitable for storing coordinate and error information generated by the current state of this selector. The store will have to store npoint points, and its PointStore.storePoint(java.lang.Object[], java.lang.Object[], java.lang.String) method will be called with the result of acquiring rows from the tables got from this selector's AxesSelector.getData() and AxesSelector.getErrorData() methods.

Specified by:

createPointStore in interface AxesSelector

Parameters:

npoint - number of points to store

Returns:

new point store

setTable

public void setTable(TopcatModel tcModel)

Description copied from interface: AxesSelector

Set up column selectors correctly for the given model. This will involve setting the column selector models appropriately. If the submitted table is null, then the selector models should be unselected.

Specified by:

setTable in interface AxesSelector

Parameters:

tcModel - table for which selectors must be configured

getTable

public TopcatModel getTable()

Returns the TopcatModel for which this selector is currently selecting axes.

Returns:

table

initialiseSelectors

public void initialiseSelectors()

Description copied from interface: AxesSelector

Hint to set up the values of the column selectors to a sensible value. An implementation which does nothing is legal.

Specified by:

initialiseSelectors in interface AxesSelector

addActionListener

public void addActionListener(ActionListener listener)

Description copied from interface: AxesSelector

Adds a listener which is notified when any of the selections made by this component changes.

Specified by:

addActionListener in interface AxesSelector

Parameters:

listener - listener to add

removeActionListener

public void removeActionListener(ActionListener listener)

Description copied from interface: AxesSelector

Removes a listener added by AxesSelector.addActionListener(java.awt.event.ActionListener).

Specified by:

removeActionListener in interface AxesSelector

Parameters:

listener - listener to remove