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.
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.