tablebrowser - Function

"Table browser"

Synopsis
tablebrowser(table, readonly, rows2read, show, hide)

Arguments

table	Table name or handle
	Allowed:	Any valid table name or handle
readonly	Flag to open the table readonly or not
	Allowed:	Boolean T or F
	Default:	T
rows2read	Then number of rows to cache in memory (set to -1 to read all rows)
	Allowed:	integer
	Default:	1000
show	Array of columns to display (case insensitive)
	Allowed:	Array of Strings
	Default:	T
hide	Array of columns to hide from display (case insensitive)
	Allowed:	Array of Strings
	Default:	T

Returns
Glish agent

Example
include "tablebrowser.g"

 nt := tablebrowser('MS')

This will load and display the MS table readonly in the table browser. To enable editing of the table use the following:

 nt := tablebrowser('MS', readonly=F)

To read all rows of a table into memory use:

 nt := tablebrowser('MS', rows2read=-1)

Warning.. large tables can take a long time to load (several minutes).

Another application may close the table browser using the following:

nt->close(T)

Note: If the show and hide arguments are used together, show takes precedence. A hide keyword for a column is overruled when using show.

Description
Browse a table using a graphical interface. The current implementation supports subset of the table tool's functions. The graphical interfaces has three parts:

Menu Bar has five options:

File
-

Open
starts a Table chooser,
Save
will save changes to the table (not visibile with readonly set to T)
Save As
starts a Table chooser which lets you make a copy of the table with a new name,
Report Bug
, Displays the AIPS++bug reporting form,
Close
, Dismisses the GUI.

Edit
-

Cut Copy Paste New Row
are currently not available,
Properties
displays a properites dialog which allow you to edit some display parameters, size of the vector to show, how many rows to cache in memory, and how big a canvas to cache,
Help Browser
choose the html browser to use for help.

View
-

Table Summary
displays a dialog containing table summary information,
Table Keywords
displays a dialog containing the table keywords,
Hide/Show Columns
displays a dialog which allows one to specify which columns to show or hide.

Table
-

Query
display a table query dialog, which will display the resulting table in a new window (uses TaQL),
Plot
display a dialog for selecting what to plot, columns maybe specified and used in Glish expressions.
Select
display a table query dialog, which will highlight the rows matching a query (uses TaQL).

Help
- drives the browser to the new table browser html.
Goto Keying a number into the "Goto" entry and pressing return will put the row number at the top of the canvas.
Display Canvas has the following features:

Vertical Scrollbar
if a table does not fit into memory, the vertical scrolling bar can not be grabbed and dragged. Clicking in the trough and on the arrows will do reposition the scrollbar. If the table fits into memory the scroll bar works as expected.
Column Labels
Each column label has a menu attached to it,

Select
selects an entire column,
Keywords
displays a dialog containing the keywords for that column The following column keywords will be used by the table browser

BROWSER_LABEL
, what label to use for the column,
BROWSER_FORMAT
, how to format the members of that column (uses C syntax, currently not implemented), and
BROWSER_HIDE
, whether to display that column or not

Hide
removes the column from the display canvas,
Format
selects how to format the column, uses C syntax.

Rows and Individual Cells
may be selected by pressing a mouse button on the text. Vectors may be displayed as "[1 2 3]" or "[3]integer" depending on how many elements of the vector are chosen to display. Selecting on the "[3]integer" form will cause an arraybrowser to be displayed with the values of the vector or array displayed in it.

See Also
table tool

Next: tablecomparer - Tool Up: table - Module Previous: tabledefinehypercolumn - Function Contents Index

	Package	utility
	Module	table