Xmgr: data operations

## Data operations

Access the command line interpreter, describe the status of data sets, graphs and regions, display results of computations and other operations, perform transformations, set operations, point operations, region operations, block data management.

### Status

The Status popup displays useful information about the state of sets, regions, and graphs. In addition to this, several useful operations are provided to manipulate sets and graphs.

At the bottom of the popup are the controls for displaying what appears in the top portion of the popup. Directly this above is a panel that provides operations on the objects displayed in the scrolled region.

Staring with the bottom panel, from left to right, the selections are:

  Close
Close the Status popup.
  Update
Freshen up the status display.
  Write
Write the contents of the status display to the Results popup, from there, the information provided by Status can be written to disk.
  Page+
Page forward through the status display. There is a limit as to how many sets can be displayed in the Status popup at one time. By default, the maximum is 30. When the number of sets is less than 30, this button is not needed, use the scroll bars to view the status of the sets that are not shown in the display.
  Page-
Page backward through the status display. There is a limit as to how many sets can be displayed in the Status display region at one time. By default, the maximum is 30. When the number of sets is less than 30, this button is not needed, use the scroll bars to view the status of the sets that are not shown in the display.
  Home
Go to the first page of the status display.
  End
Go to the last page of the status display.
  Adjust
Adjust the width of the status window to completely show the longest comment.
  Display
An option menu used to select the object types to view, sets, graphs, or regions. The operations panel directly above will change as the object type in this item is changed.

Operations in the Status popup are performed by clicking on the operation, then clicking on one or more set numbers shown in the display. There is a status line provided that will give a bit of help on what actions to take to perform a given operation. Generally, the cursor will change to reflect the nature of the operation.

When the selection for Display is Sets, the operations provided are:

  Kill
Clicking on Kill activates the pointer such that clicking on a set number shown in the display of the Status popup kills the set. After a set is Kill'ed, the point remains hot, the Kill operation can be performed again, until the Cancel button is pressed.
  Soft kill
This is the same as Kill except that all parameters are preserved.
  Deact
Clicking on Deact followed by clicking on a set number in the scrolled window will deactivate the set (deactivation merely hides the set, the data are not released). The function can be useful when there are lots of sets being drawn, and the interest is in a subset of the sets being display in the drawing area.
  React
Clicking on React followed by clicking on a set number in the scrolled window will reactivate the set if it has previously be deactivated.
  Copy
Clicking on Copy followed by clicking on a set number in the scrolled window will select the set to copy from. Click again on another set number to perform the copy. One trick that can be performed here is that this operation can be used to copy sets from one graph to another by changing the current graph. The current graph must be changed by either clicking on the graph to receive the focus on the drawing area, or using Graph/Graph operations.
  Move
Clicking on Move followed by clicking on a set number in the scrolled window will select the set to move. Click again on another set number to perform the move. One trick that can be performed here is that this operation can be used to move sets from one graph to another by changing the current graph. The current graph must be changed by either clicking on the graph to receive the focus on the drawing area, or using Graph/Graph operations.
  Auto
Clicking on Auto followed by clicking on a set number in the scrolled window will select autoscale the graph axes such that the set in its entirety is displayed in the drawing area.
  Reverse
Clicking on Reverse followed by clicking on a set number in the scrolled window will select reverse the order of the points in the set.
  Reverse
Clicking on Join followed by clicking on a set number in the scrolled window will select the set to join to, Click again on another set number to complete the join.
  Pack
Clicking on Pack renumbers sets such that there are no gaps in the set structure. If the active sets are 0, 3, 5, following the pack operation, the sets will be numbered 0, 1, 2.
  Cancel
Clicking on Cancel cancels any of the operations above that require more than a single set to function (Copy, Move, Join). Also, most of the operations stay in effect until Cancel is pressed.
  Auto redraw
Controls whether or not xmgr redraws its canvas after each set operation in the status window. This takes effect only if the global auto redraw option is on (in Options->Draw options).

When the selection for Display is Graphs, the operations provided are:

  Activate
Clicking on Activate then clicking on a graph number activates the graph.
  Copy
Clicking on Copy then clicking on a graph number selects the graph to copy from. Clicking on another graph selects the graph to copy to.
  Move
Clicking on Move then clicking on a graph number selects the graph to move from. Clicking on another graph selects the graph to move to.
  Swap
To swap 2 graphs, click on Swap then click on a graph number to select the first graph, then click again on the second graph to perform the swap.
  Hide
To hide a graph, click on Hide then click on a graph number.
  Show
To undo the effect of Hide, click on Show then click on a graph number.
  Focus
To set the graph focus (the graph with the focus is referred to as the current graph), click on Focus then click on a graph number.
  Kill
To kill a graph, click on Kill then click on a graph number.
  Cancel
Cancel operations that require 2 selections and take the pointer out of whatever operation was previously selected.

When the selection for Display is Regions, no operations are provided at the present time.

### Results

Display the results of the regression routine and the output of the `Write' button in File/ Status in the monitor window.

### Command interpreter

Command driven version of the interface to xmgr. Here, commands are typed at the `Command:' text item and executed when < return > is entered. The command will be parsed and executed, and if no errors are found, the command line is placed in the history list. Items in the history list can be recalled by simply clicking on them with the left mouse button. The button actions are

Save...
  Save the command history list to a file
Read...
  Insert commands into the history list from a file
Clear
  Clear the history list
Replay
  Replay the commands in the history list
Add
  Add the command text to the history list at the selected position without executing the command
  Shortcut: Shift-Return
Replace
  Replace the selected history entry with the command line text without executing the text
  Shortcut: Shift-Ctrl-Return
Delete
  Delete the selected history list entry
  Shortcut: Shift-BackSpace
Up
  Move an entry up in the history list
  Shortcut: Shift-Up
Down
  Move an entry down in the history list
  Shortcut: Shift-Down
Close
  Close the window
Help
  Display help on using the Command window

### Block data

Create sets from block data. Select the type of set and the columns to use for each vector of the new set. Press Accept to create the set. Note that reading block data does not affect the scaling of the graph so when a set is created using this popup, the set may not appear within the graph's scaling limits - use AS (Autoscale) to set the scale of the graph if needed (or use View/Define world).