Class MatchPlotter

java.lang.Object
uk.ac.starlink.topcat.join.MatchPlotter

public abstract class MatchPlotter extends Object
Prepares a plot based on the inputs and outputs of a crossmatch operation.
Since:
20 Dec 2013
Author:
Mark Taylor
  • Constructor Details

    • MatchPlotter

      public MatchPlotter()
  • Method Details

    • showPlot

      public abstract void showPlot(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 Action createPlotAction(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