Package uk.ac.starlink.topcat
Class TopcatUtils
java.lang.Object
uk.ac.starlink.topcat.TopcatUtils
Class containing miscellaneous static methods and constants
for use in TOPCAT.
- Since:
- 19 Aug 2004
- Author:
- Mark Taylor
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final uk.ac.starlink.table.ValueInfo
Column auxiliary metadata key identifying the uniqe column identifier for use in algebraic expressions.static String
static String
static String
static final uk.ac.starlink.table.ValueInfo
Column auxiliary metadata key identifying the text string which gives an expression for a synthetic column.static final uk.ac.starlink.table.ValueInfo
Column auxiliary metadata key identifying an object which can convert from non-numeric cell values to numeric ones.static final String
static final uk.ac.starlink.table.ValueInfo
Data identifier for epoch-type data.static final String
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic 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.static void
alignComponents
(JComponent[] comps) Reshapes a set of components so that they all have the same preferred size (that of the largest one).static boolean
canExec()
Indicates whether we have System.exec permission.static boolean
canJel()
Indicates if it's possible to use JEL to compile algebraic expressions.static boolean
canSog()
Indicates whether there are enough classes to make SoG work at runtime.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.static uk.ac.starlink.table.StarTable
encodeSession
(TopcatModel tcModel) Encodes a TopcatModel as a StarTable including per-table session information, suitable for serialization.static void
Ascertains the most recent release using an external connection, and reports through the logging system as appropriate.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.static boolean
Determines whether two objects are equal in the sense ofObject.equals(java.lang.Object)
.static String
formatLong
(long num) Formats a long value for presentation as text.static String[]
getAbout()
Returns some lines of text describing this copy of the software including its version and versions of some important components.static String
Returns the name of this application.static String
getBaseName
(String origName, String baseSuffix) Returns the base name of a column; that is one without any suffix based on baseSuffix.static Desktop
Returns a browse-capable desktop instance, or null if none is available.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.static String
getExpression
(uk.ac.starlink.table.ColumnInfo info) Returns the expression text for a column.static String
Returns the version control revision number for TOPCAT and its dependencies.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.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.static String
Returns the version string for the version of STIL being used here.static String
Returns the version string for this copy of TOPCAT.static String
identityString
(Object obj) Returns a string unique to an object's identity.static void
Alerts the user that the system has run out of memory, and provides the option of some useful tips.static void
Queues amemoryError(java.lang.OutOfMemoryError)
call for later execution on the event dispatch thread.static void
setClipboardText
(String txt) Sets the text content of the system clipboard(s).
-
Field Details
-
DEMO_LOCATION
-
DEMO_TABLE
-
DEMO_NODES
-
VERSION_RESOURCE
- See Also:
-
STATUS_URL
- See Also:
-
COLID_INFO
public static final uk.ac.starlink.table.ValueInfo COLID_INFOColumn auxiliary metadata key identifying the uniqe column identifier for use in algebraic expressions. -
EXPR_INFO
public static final uk.ac.starlink.table.ValueInfo EXPR_INFOColumn auxiliary metadata key identifying the text string which gives an expression for a synthetic column. -
NUMERIC_CONVERTER_INFO
public static final uk.ac.starlink.table.ValueInfo NUMERIC_CONVERTER_INFOColumn auxiliary metadata key identifying an object which can convert from non-numeric cell values to numeric ones. -
TIME_INFO
public static final uk.ac.starlink.table.ValueInfo TIME_INFOData identifier for epoch-type data.
-
-
Constructor Details
-
TopcatUtils
public TopcatUtils()
-
-
Method Details
-
getSaveTable
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
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
Returns the base name of a column; that is one without any suffix based on baseSuffix. This method is used in conjunction withgetDistinctName(uk.ac.starlink.topcat.ColumnList, java.lang.String, java.lang.String)
.- Parameters:
origName
- full name, possibly including bits of suffixbaseSuffix
- the base suffix string- Returns:
- name without any suffix-like elements of the sort specified by baseSuffix
-
getDistinctName
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 requiredorigName
- initial namebaseSuffix
- suffix used for deduplication- Returns:
- a name resembling origName which is not the same as any existing column names in colList
- See Also:
-
getApplicationName
Returns the name of this application.- Returns:
- "TOPCAT"
-
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 valueslrow
- row index- Returns:
- list of described values
-
setClipboardText
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
Scrolls a JTable as necessary to ensure that a given row index is scrolled to the visible part of the viewport.- Parameters:
jtab
- JTableirow
- table index that must be visible- See Also:
-
memoryError
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
Queues amemoryError(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
Returns a browse-capable desktop instance, or null if none is available.- Returns:
- desktop
-
getVersion
Returns the version string for this copy of TOPCAT.- Returns:
- version number only
-
getRevision
Returns the version control revision number for TOPCAT and its dependencies.- Returns:
- revision identifier
-
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
Determines whether two objects are equal in the sense ofObject.equals(java.lang.Object)
. Unlike that method however, it returns true if both objects arenull
, and won't throw a NullPointerException.- Parameters:
o1
- first objecto2
- second object- Returns:
- true if
o1.equals(o2)
or they're both null
-
identityString
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
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
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 dialoguetcModel
- topcat modelmatchMask
- mask for included rowsdfltName
- default name for subsetmsgLines
- lines of text to appear in dialogue windowtitle
- dialogue window title
-
encodeSession
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 tablelocation
- table location stringcontrolWindow
- control window, or null if necessary- Returns:
- topcat model, or null
-