Class TopcatLayer


  • public class TopcatLayer
    extends java.lang.Object
    Aggregates a PlotLayer and some additional information about how it was configured. The resulting object is able to come up with a suitable LayerSpec.
    Since:
    14 Jul 2017
    Author:
    Mark Taylor
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer FILENAME_NAMER  
      static uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer LABEL_NAMER  
      static uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer PATHNAME_NAMER  
      static uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer TNUM_NAMER  
    • Constructor Summary

      Constructors 
      Constructor Description
      TopcatLayer​(uk.ac.starlink.ttools.plot2.PlotLayer plotLayer, uk.ac.starlink.ttools.plot2.config.ConfigMap config, java.lang.String leglabel)
      Constructs a layer with no table data.
      TopcatLayer​(uk.ac.starlink.ttools.plot2.PlotLayer plotLayer, uk.ac.starlink.ttools.plot2.config.ConfigMap config, java.lang.String leglabel, TopcatModel tcModel, GuiCoordContent[] contents, RowSubset rset)
      Constructs a layer based on a table.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      uk.ac.starlink.ttools.plot2.task.LayerSpec getLayerSpec​(int izone)
      Returns a layer specification for this layer placed within a given zone.
      static uk.ac.starlink.ttools.task.TableNamer[] getLayerTableNamers()
      Returns a list of TableNamer objects that give the user options for referencing TopcatModels by a text string in generated stilts commands.
      uk.ac.starlink.ttools.plot2.PlotLayer getPlotLayer()
      Returns this object's plot layer.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • PATHNAME_NAMER

        public static final uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer PATHNAME_NAMER
      • FILENAME_NAMER

        public static final uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer FILENAME_NAMER
      • LABEL_NAMER

        public static final uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer LABEL_NAMER
      • TNUM_NAMER

        public static final uk.ac.starlink.topcat.plot2.TopcatLayer.TopcatNamer TNUM_NAMER
    • Constructor Detail

      • TopcatLayer

        public TopcatLayer​(uk.ac.starlink.ttools.plot2.PlotLayer plotLayer,
                           uk.ac.starlink.ttools.plot2.config.ConfigMap config,
                           java.lang.String leglabel,
                           TopcatModel tcModel,
                           GuiCoordContent[] contents,
                           RowSubset rset)
        Constructs a layer based on a table.
        Parameters:
        plotLayer - plot layer, not null
        config - configuration used to set up the plot layer (superset is permitted)
        leglabel - label used in the legend; if null, excluded from the legend
        tcModel - TopcatModel containing the table
        contents - information about data columns used to construct plot (superset is not permitted)
        rset - row subset for which layer is plotted
      • TopcatLayer

        public TopcatLayer​(uk.ac.starlink.ttools.plot2.PlotLayer plotLayer,
                           uk.ac.starlink.ttools.plot2.config.ConfigMap config,
                           java.lang.String leglabel)
        Constructs a layer with no table data.
        Parameters:
        plotLayer - plot layer, not null
        config - configuration used to set up the plot layer (superset is permitted)
        leglabel - label used in the legend; if null, excluded from the legend
    • Method Detail

      • getPlotLayer

        public uk.ac.starlink.ttools.plot2.PlotLayer getPlotLayer()
        Returns this object's plot layer.
        Returns:
        plot layer, not null
      • getLayerSpec

        public uk.ac.starlink.ttools.plot2.task.LayerSpec getLayerSpec​(int izone)
        Returns a layer specification for this layer placed within a given zone.

        It shouldn't be null, unless it was impossible to write the specification for some reason??

        Parameters:
        izone - zone index for created layer
        Returns:
        layer specification, hopefully not null??
      • getLayerTableNamers

        public static uk.ac.starlink.ttools.task.TableNamer[] getLayerTableNamers()
        Returns a list of TableNamer objects that give the user options for referencing TopcatModels by a text string in generated stilts commands. The stilts commands are assumed to have been specified using methods in this class.
        Returns:
        table namer user options