Class TopcatUtils

Method Details

• getSaveTable

  public static uk.ac.starlink.table.StarTable getSaveTable(TopcatModel tcModel)

  Returns the table represented by the current state of a given TopcatModel in a form suitable for persisting into one of the known serialization formats.

  This basicaly uses TopcatModel.getApparentStarTable(), but may apply a few extra tweaks for a table that is known to be about to be saved.

  Parameters:

  tcModel - topcat model

  Returns:

  saveable table

• getExpression

  public static String getExpression(uk.ac.starlink.table.ColumnInfo info)

  Returns the expression text for a column. This should only have a non-null value for synthetic columns.

  Parameters:

  info - column info

  Returns:

  synthetic expression string

• getBaseName

  public static String getBaseName(String origName, String baseSuffix)

  Returns the base name of a column; that is one without any suffix based on baseSuffix. This method is used in conjunction with getDistinctName(uk.ac.starlink.topcat.ColumnList, java.lang.String, java.lang.String).

  Parameters:

  origName - full name, possibly including bits of suffix

  baseSuffix - the base suffix string

  Returns:

  name without any suffix-like elements of the sort specified by baseSuffix

• getDistinctName

  public static String getDistinctName(ColumnList colList, String origName, String baseSuffix)

  Returns a column name based on a given one which is guaranteed distinct from any others in the column list. If the submitted origName is already unique, it may be returned. Otherwise a new name may be made which involves appending the given baseSuffix to it.

  Parameters:

  colList - column list within which distinct naming is required

  origName - initial name

  baseSuffix - suffix used for deduplication

  Returns:

  a name resembling origName which is not the same as any existing column names in colList

  See Also:

  • getBaseName(java.lang.String, java.lang.String)

• getApplicationName

  public static String getApplicationName()

  Returns the name of this application.

  Returns:

  "TOPCAT"

• getAbout

  public static String[] getAbout()

  Returns some lines of text describing this copy of the software including its version and versions of some important components.

  Returns:

  lines of About text

• getRowAsParameters

  public static List<uk.ac.starlink.table.DescribedValue> getRowAsParameters(TopcatModel tcModel, long lrow)

  Returns the values from a row of a given table as a list of DescribedValues, suitable for use as parameters (per-value metadata) of a StarTable.

  Parameters:

  tcModel - table supplying values

  lrow - row index

  Returns:

  list of described values

• setClipboardText

  public static void setClipboardText(String txt)

  Sets the text content of the system clipboard(s). This is somewhat OS-dependent. X11 uses a PRIMARY selection (middle mouse button) alongside the CLIPBOARD selection (explicit cut'n'paste). JTextComponents fill both, though not under exactly the same circumstances. This method sets the text for both if both are available. This may not replicate exactly the behaviour expected by X clients, but I think it's what users would want to happen. I may be wrong.

  Parameters:

  txt - text to set as clipboard contents

• ensureRowIndexIsVisible

  public static void ensureRowIndexIsVisible(JTable jtab, int irow)

  Scrolls a JTable as necessary to ensure that a given row index is scrolled to the visible part of the viewport.

  Parameters:

  jtab - JTable

  irow - table index that must be visible

  See Also:

  • JList.ensureIndexIsVisible(int)

• memoryError

  public static void memoryError(OutOfMemoryError e)

  Alerts the user that the system has run out of memory, and provides the option of some useful tips.

  Parameters:

  e - exception, or null

• memoryErrorLater

  public static void memoryErrorLater(OutOfMemoryError e)

  Queues a memoryError(java.lang.OutOfMemoryError) call for later execution on the event dispatch thread.

  Parameters:

  e - exception, or null

• canSog

  public static boolean canSog()

  Indicates whether there are enough classes to make SoG work at runtime.

  Returns:

  true iff it's safe to use a SoG-based viewer

• canExec

  public static boolean canExec()

  Indicates whether we have System.exec permission.

  Returns:

  true if it's possible to exec

• canJel

  public static boolean canJel()

  Indicates if it's possible to use JEL to compile algebraic expressions. If the security manager does not permit creation of private class loaders, it will fail.

  Returns:

  true iff JEL epxression compilation will work

• getBrowserDesktop

  public static Desktop getBrowserDesktop()

  Returns a browse-capable desktop instance, or null if none is available.

  Returns:

  desktop

• getVersion

  public static String getVersion()

  Returns the version string for this copy of TOPCAT.

  Returns:

  version number only

• getRevision

  public static String getRevision()

  Returns the version control revision number for TOPCAT and its dependencies.

  Returns:

  revision identifier

• getSTILVersion

  public static String getSTILVersion()

  Returns the version string for the version of STIL being used here.

  Returns:

  STIL version number

• enquireLatestVersion

  public static void enquireLatestVersion()

  Ascertains the most recent release using an external connection, and reports through the logging system as appropriate.

• equals

  public static boolean equals(Object o1, Object o2)

  Determines whether two objects are equal in the sense of Object.equals(java.lang.Object). Unlike that method however, it returns true if both objects are null, and won't throw a NullPointerException.

  Parameters:

  o1 - first object

  o2 - second object

  Returns:

  true if o1.equals(o2) or they're both null

• identityString

  public static String identityString(Object obj)

  Returns a string unique to an object's identity. This is modelled on the value that Object.toString() usually returns, though not guaranteed to be the same.

  Parameters:

  obj - object

  Returns:

  unique string for object

• formatLong

  public static String formatLong(long num)

  Formats a long value for presentation as text. This typically puts separators between groups of three numbers for improved visibility. TOPCAT policy is usually to do this only for numbers which are, or might be expected to be, quite large.

  Parameters:

  num - number to format

  Returns:

  formatted value

• alignComponents

  public static void alignComponents(JComponent[] comps)

  Reshapes a set of components so that they all have the same preferred size (that of the largest one).

  Parameters:

  comps - components to align

• addSubset

  public static void addSubset(JComponent parent, TopcatModel tcModel, BitSet matchMask, String dfltName, String[] msgLines, String title)

  Using input from the user, adds a new (or reused) Row Subset to the given TopcatModel based on a given BitSet.

  Parameters:

  parent - parent component for dialogue

  tcModel - topcat model

  matchMask - mask for included rows

  dfltName - default name for subset

  msgLines - lines of text to appear in dialogue window

  title - dialogue window title

• encodeSession

  public static uk.ac.starlink.table.StarTable encodeSession(TopcatModel tcModel)

  Encodes a TopcatModel as a StarTable including per-table session information, suitable for serialization.

  Parameters:

  tcModel - model

  Returns:

  table

• decodeSession

  public static TopcatModel decodeSession(uk.ac.starlink.table.StarTable table, String location, ControlWindow controlWindow)

  Attempts to unpack a StarTable into a TopcatModel containing per-table application session information. For this to work it must have been written using one of the TopcatCodec formats that this application is aware of. If not, null is returned.

  Parameters:

  table - encoded table

  location - table location string

  controlWindow - control window, or null if necessary

  Returns:

  topcat model, or null