- Directory read-write text field:
Displays the currently selected directory from which
dstool will load data. The default is the current value of the unix environmental variable
DSTOOL_DATA_DIR.
- Filename read-write text field:
Displays the currently selected file from which
dstool will load data. There is no default.
- Option exclusive setting:
- dstool Format:
-
The data file was saved by dstool or
is in a format which dstool can read. (The dstool format is discussed at greater length in the
dstool Reference Manual.)
This is the default load option. If the load window is elongated
(see below), then selecting this option will return the load window to its
abbreviated size.
- Unformatted:
- Data was created by an application which wrote an ASCII
data file. The data can be read into any memory object. When this option is chosen,
the load window extends to reveal additional panel items which control the loading of
unformatted data. Choosing this setting causes the load panel to lengthen, revealing
additional panel items described below.
- Load command button:
Loads data from the file specified in the Filename text field into active memory.
In the event that the data does not exist, the user is presented with a notice.
In the event that the data
does not match the data structure of the current installed
system (e.g., dimensions wrong) then an error message is
displayed. If the Unformatted option is selected, then the data is loaded according to the
specified unformatted options (described below).
There are seven types of formatted data which dstool can
load: current settings data, configuration
data,
trajectory data, fixed point data,
continuation data, parameter data,
and selected point data. Current setting data is displayed on the Selected
Point Window and the Defaults Settings Window. Configuration data consists of
the size and placement of dstool windows and panels. The remaining data types
are discussed briefly in the Save Window section of this document (and
in detail in the Reference Manual). We note here that function
values are special in that they are not stored in memory
but are derived
from parameter and function values whenever they are needed.
The following panel items are visible only when the user chooses the Unformatted option setting.
- Data Type stack setting:
Unformatted data may be loaded into one of five data types.
The value of this setting determines which data type will be filled with the unformatted data.
The possible data types are trajectory, fixed point, continuation, parameter, and selected point data.
The default setting is trajectory.
- Color exclusive setting:
Does the unformatted data include color-coding information? If so, the
color setting should be On. Each data object in dstool has two colors associated with it: an
alternating color (for use with alternating colormaps), and a
``pick color'' (for use with colormaps
of ``pick color type.'') All unformatted data is assigned the current alternating color.
If the data does not contain color-coding information, then the
data is assigned the current pick color; otherwise, the pick color is determined by the
color-coding information.
Within an unformatted data file, color is coded as an integer;
The integer appears immediately after all variable and parameter values.
If this integer is k, then the associated data object will be color-coded with the kth
color of the currently installed colormap. Obviously,
2#2
where N is the maximum
number of colors in the current colormap. For the colormaps provided with dstool, N=131.
As an example, if the user has specified that
an unformatted data file contains fixed point data, values for the variables x and y,
and color-coding information, then if the file has the line
0.0 0.5 12
then dstool will store the data point
(x,y) = (0.0,0.5) and whenever a colormap is of the
pick color type, then the point (0.0,0.5) will be plotted in the 12th color of that colormap.
Trajectories cannot currently be assigned colors from within an unformatted data file; they
automatically receive the current pick color. All other data objects can be assigned colors.
- Symbol exclusive setting:
Does the unformatted data include symbol-coding information? If so, the
symbol setting should be On. If the data does not contain symbol-coding information, then the
data is assigned the current symbol (visible in the Defaults Setting Window); otherwise, the
symbol is determined by the symbol-coding information.
Within an unformatted data file, a symbol is coded as an integer;
The integer must be the last item in the field which defines the data object.
If this integer is k, then the associated data object will be symbol-coded with the kth
symbol. Currently, valid symbols require
3#3.
The values
4#4
specify dots;
5#5
specifies triangles;
6#6
is the range for crosses;
and
7#7
specifies boxes. In each case, there are four possible sizes, with the
smaller values corresponding to smaller symbols.
As an example, if the user has specified that
an unformatted data file contains fixed point data, values for the variables x and y,
and symbol-coding information, then if the file has the line
0.0 0.5 8
then dstool will store the data point
(x,y) = (0.0,0.5) and
the point (0.0,0.5) will be plotted with the 8th symbol, which happens to be the largest
triangle. If the user wanted both color and symbol information (say the 12th color and the
8th symbol), then the data file might read something like this:
0.0 0.5 12 8
As with colors, trajectories cannot currently be assigned symbols.
- Variables read-only non-exclusive list: This list contains the phase space variables of the current
dynamical system. Any or all of these variables may be selected independently of each other.
Unformatted data is loaded into variables in the same
order
as the variables appear on the list:
the first number encountered is stored in the first selected variable on the list,
the second number is stored on the second variable on the list, and so on.
If k of these variables are selected and if j parameters are selected,
then dstool will load the first k pieces of data into the selected variable, load the next j
pieces of data into the selected parameters, and then repeat the process until it reaches the
end of the data.
Any variables not selected are assigned their current value (visible in the
Selected Point Window).
- Parameters read-only non-exclusive list: This list contains the parameters of the current
dynamical system. Any or all of these parameters may be selected independently of each other.
When the load command button is pressed, dstool proceeds as above.
Unformatted data is loaded into parameters in the same order as the parameters appear on the list.
Any parameters not selected are assigned their current value (visible in the
Selected Point Window).
As an example, suppose a dynamical system has variables (x,y,z) and parameters
8#8.
If the current values of these quantities are
(x0,y0,z0) and
9#9
and if the user specifies that an unformatted data file
contains values for x, z, and 10#10,
then a line in the file of the form
8.3 -2.3 0.01
will create a data object of the requested type and this data object will contain the
variable data
(8.3, y0, -2.3) and the parameter data
11#11.
Associated to the data object will be the current pick point color and the current
symbol, since these quantities were not specified.
See the Reference Manual
for more details on how dstool loads unformatted data.