1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
|
\section{The Load Window}\index{Load window}\index{window, Load}\label{load}
%
%
%
\begin{figure}[H]
%\vspace{2.5in}
\centerline{\psfig{figure=ps/load.ps,height=154pt}}
\caption{\label{loadwin}
The Load window.
}
\end{figure}
%
%
%
\begin{description}
\item[Window title:] DsTool: Load
\item[Function:] The Load window allows the user to load data from an
external file into memory.
\item[Description:] The Load window is opened by selecting the
Load option from the File menu button located in the Command
window. The user can select a file and load it into DsTool's memory.
%\item[Window type:] pop-up
%\item[Window attributes:] pinnable(out), non-resizable, fixed template
\item[Panel items:]\mbox{}
\begin{itemize}
\item Directory read-write text field:
Displays the currently selected directory from which
DsTool will load data. The default is the value of the UNIX environmental variable
\unix{DSTOOL\_DATA\_DIR}, or if that is not set, the current working directory.
\item Filename read-write text field:
Displays the currently selected file from which
DsTool will load data. The default is the file ``dstool.config''.
\item Data style exclusive setting:\index{data, style}
\begin{description}
\item[DsTool Tk Format:]\index{formatted data}\index{data, DsTool Tk format}
Specifies that the data file was saved by DsTool Tk in DsTool Tk format.
If the load window was elongated (see below), then selecting this option will return
the load window to its abbreviated size.
\item[DsTool 2.0 Format:]\index{formatted data}\index{data, DsTool 2.0 format}
Specifies that the data file was saved by DsTool 2.0 or by DsTool Tk in DsTool 2.0 format,
or is in a format which DsTool can read. (The DsTool format is discussed at greater length in the
DsTool Reference Manual.)\index{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.
\item[Unformatted:]\index{unformatted data}\index{data, unformatted}
Specifies that the data file 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 lengthens to reveal additional panel items which control the loading of
unformatted data.
\end{description}
\item Load window button:\index{window, Files}\index{Files window}
Opens and brings to the foreground the Files window,
for loading the requested file into DsTool.
In the event that the data
does not match the data structure of the current installed
system (\eg, dimensions wrong), 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:\index{data, types} current settings data\index{current settings data}, configuration
data\index{configuration data},
trajectory data\index{trajectory data}, fixed point data\index{fixed point data},
continuation data\index{continuation data}, parameter data\index{parameter data},
and selected point data\index{selected point data}.
% Current setting data is displayed on the Selected Point window and the Defaults window.
Current setting data is a mirror of the non-memory and non-function items of the Postmaster.
Configuration data consists of
the size and placement of DsTool windows, as well as viewing options for 2-D View windows.
The remaining data types are discussed briefly in the Save window section of this document (and
in detail in the Reference Manual\index{reference manual}). We note here that auxiliary function
values are special in that they are not stored in memory\index{memory, function values}
but are derived from parameter and variable values whenever they are needed.
The following panel items are visible only when the user chooses the Unformatted option setting.
\item Data type stack setting:\index{unformatted data, type}\index{data, unformatted}
Allows the user to choose which data type will be filled with the unformatted data.
Unformatted data may be loaded into one of six data types.
The possible data types are trajectory (Traj), multiple trajectory (Mult), fixed point (Fixed),
continuation (Continuation), parameter (Param), and selected point (Sel\_Pt) data.
The default setting is trajectory.
\item Color exclusive setting:\index{unformatted data, color}\index{color, setting in data files}
Allows the user to choose whether or not data should be considered to have color information.
Each data object in DsTool has two colors associated with it: an
``alternating color''\index{color, alternating} and a ``pick color''\index{color, pick}.
See section \ref{colors} for more information on color modes.
All unformatted data is assigned the current alternating color.
If the data does {\em 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. The default is to not have color 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 $k$th
color of the currently installed colormap. Obviously, $0 \leq k \leq N$ where $N$ is the maximum
number of colors in the current colormap.
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
\begin{verbatim}
0.0 0.5 12
\end{verbatim}
then DsTool will store the data point $(x,y) = (0.0,0.5)$ and whenever a view window has the
pick color option selected, the point $(0.0,0.5)$ will be plotted in the $12$th
color of the colormap.
Trajectories (and multiple 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.
\item Symbol exclusive setting:\index{unformatted data, symbol}\index{symbol, setting in data files}
Allows the user to choose whether or not data should be considered to have symbol-coding information.
If the data does {\em not} contain symbol-coding information, then the
data is assigned the current symbol (visible in the Defaults window); otherwise, the
symbol is determined by the symbol-coding information. The default is to not have symbol information.
Within an unformatted data file, a symbol is coded as an integer.\index{symbol, integer codes for}
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 $k$th
symbol. Currently, valid symbols require $0 \leq k \leq 11$. The values $0 \leq k \leq 2$
specify dots; $3 \leq k \leq 5$ specify crosses; $6 \leq k \leq 8$ specify boxes;
and $9 \leq k \leq 11$ specify triangles. In each case, there are three 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, and if the file has the line
\begin{verbatim}
0.0 0.5 8
\end{verbatim}
then DsTool will store the data point $(x,y) = (0.0,0.5)$ and
the point will be plotted with the $8$th symbol, which happens to be the largest
box. If the user wanted both color {\em and} symbol information (say the $12$th color and the
$8$th symbol), then the data file might read something like this:
\begin{verbatim}
0.0 0.5 12 8
\end{verbatim}
As with colors, trajectories cannot currently be assigned symbols.
\item Variables listbox: Allows the user to choose which variables will be loaded with
data from the data file. The listbox contains all of the variables of the current
dynamical system, including the independent variable. Any or all of these
variables may be selected independently of each other.
Unformatted data is loaded into variables in the same
order\index{unformatted data, order of variables}
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). By default, none of the variables are selected.
\item Parameters listbox: Allows the user to choose which parameters will be loaded with
data from the data file. The listbox contains all of the parameters of the current
dynamical system. Any or all of these parameters may be selected independently of each other.
When the file is loaded, 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). By default, none of the parameters are selected.
As an example, suppose a dynamical system has variables $(x,y,z)$ and parameters
$(\alpha, \beta, \gamma)$. If the current values of these quantities are
$(x_0,y_0,z_0)$ and $(\alpha_0, \beta_0, \gamma_0)$
and if the user specifies that an unformatted data file
contains values for $x$, $z$, and $\gamma$, then a line in the file of the form
\begin{verbatim}
8.3 -2.3 0.01
\end{verbatim}
will create a data object of the requested type and this data object will contain the
variable data $(8.3, y_0, -2.3)$ and the parameter data $(\alpha_0, \beta_0, 0.01)$.
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\index{reference manual}
% for more details on how DsTool loads unformatted data.
\item Dismiss command button:
Closes the Load window.
%The values of the directory and file to load do not revert to the defaults.
\end{itemize}
\end{description}
|
