Class CartesianAxesSelector

  • All Implemented Interfaces:
    AxesSelector

    public class CartesianAxesSelector
    extends java.lang.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
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addActionListener​(java.awt.event.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.
      javax.swing.JComboBox getColumnSelector​(int icol)
      Returns one of the the column selector boxes used by this selector.
      javax.swing.JComponent getColumnSelectorPanel()
      Gets the panel which displays selectors for the columns.
      javax.swing.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​(java.awt.event.ActionListener listener)
      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
    • Method Detail

      • getColumnSelectorPanel

        public javax.swing.JComponent getColumnSelectorPanel()
        Gets the panel which displays selectors for the columns.
        Specified by:
        getColumnSelectorPanel in interface AxesSelector
        Returns:
        column selector panel
      • getColumnSelectors

        public javax.swing.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
      • 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 javax.swing.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
      • 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​(java.awt.event.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