Overview
The application mmDataTable provides a data display
service to its client applications. It accepts data from
clients and displays it in a window. Its typical use
is to display the evolving values of quantities computed by a
micromagnetic solver program.
Launching
mmDataTable may be started either by selecting the
mmDataTable button on mmLaunch,
or from the command line via
tclsh app/oommf/oommf.tcl mmDataTable [-console]
Inputs
The client application(s) that send data to mmDataTable for
display control the flow of data. The user, interacting with
the mmDataTable window, controls how the data is displayed.
Upon launch, mmDataTable displays only a menubar. Upon user
request, a display window below the menubar displays data values.
Each message from a client contains a list of (name, value, units) triples containing data for display. For example, one element in the list might be {Magnetization 800000 A/m }. mmDataTable stores the latest value it receives for each name. Earlier values are discarded when new data arrives from a client.
Outputs
mmDataTable does not support any data output or storage
facilities. To save tabular data, use the
mmGraph
or
mmArchive
applications.
Controls
The Data menu holds a list of all the data names for which
mmDataTable has received data. Initially, mmDataTable has
received no data from any clients, so this menu is empty. As data
arrives from clients, the menu fills with the list of data names.
Each data name on the list lies next to a checkbutton. When the
checkbutton is toggled from off to on, the corresponding data name and
its value and units are displayed at the bottom of the display window.
When the checkbutton is toggled from on to off, the corresponding data
name is removed from the display window. In this way, the user
selects from all the data received what is to be displayed. Selecting
the dashed rule at the top of the Data menu detaches it so the
user may easily click multiple checkbuttons.
In addition to selecting what data names are displayed, the user may also control the format in which the data values are displayed. A mouse click on a displayed data value brings up a dialog box in which the user may specify the formatting the value undergoes (by the Tcl command format) prior to display. The Options menu includes a Format menu item which lets the user set the default formatting for data values.
The menu selection File|Exit terminates the mmDataTable application. The menu Help provides the usual help facilities.