Constructor Detail

• MatchPlotter

  public MatchPlotter()

Method Detail

• showPlot

  public abstract void showPlot​(java.awt.Component parent,
                                TupleSelector[] tselectors,
                                uk.ac.starlink.table.JoinFixAction[] fixActs,
                                TopcatModel result)
                         throws LayerException

  Posts a plot window representing data from tables input to a match and the output table. The input tables are represented as points, and the output table is represented as links between the corresponding input positions.

  Parameters:

  parent - parent component

  tselectors - selectors used to specify match input tables and values, one for each input table

  fixActs - options for column name disambiguation, one for each input table

  result - output (matched) table

  Throws:

  LayerException - if the plot cannot be constructed

• getMatchPlotter

  public static MatchPlotter getMatchPlotter​(uk.ac.starlink.table.join.MatchEngine engine)

  Acquires an instance of this class suitable for a given match engine.

  Parameters:

  engine - match criterion

  Returns:

  match plotter instance, or null if we don't know how to do it

• createPlotAction

  public static javax.swing.Action createPlotAction​(java.awt.Component parent,
                                                    uk.ac.starlink.table.join.MatchEngine engine,
                                                    TupleSelector[] tselectors,
                                                    uk.ac.starlink.table.JoinFixAction[] fixActs,
                                                    TopcatModel result)

  Creates an action which can be used to post a plot for a given completed match operation. This is a utility method which acquires a suitable instance and invokes it within an action.

  It's not always possible to do this. In the case that no plot can be made, a non-null action is still returned, but invoking it will pop up an error message.

  Parameters:

  parent - parent component

  engine - match engine determining match criteria

  tselectors - populated GUI components specifying input tables and coordinates, corresponding to match engine requirements

  fixActs - options for column name disambiguation, one for each input table

  result - output (matched) table

  Returns:

  action to plot the result