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
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 98.1p1 release (March 2nd, 1998)
originally by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>The Load Window</TITLE>
<META NAME="description" CONTENT="The Load Window">
<META NAME="keywords" CONTENT="userman">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<LINK REL="STYLESHEET" HREF="userman.css">
<LINK REL="next" HREF="node12.html">
<LINK REL="previous" HREF="node10.html">
<LINK REL="up" HREF="node5.html">
<LINK REL="next" HREF="node12.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html695"
HREF="node12.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/lib/latex2html/icons.gif/next_motif.gif"></A>
<A NAME="tex2html692"
HREF="node5.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/lib/latex2html/icons.gif/up_motif.gif"></A>
<A NAME="tex2html686"
HREF="node10.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/lib/latex2html/icons.gif/previous_motif.gif"></A>
<A NAME="tex2html694"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="/usr/lib/latex2html/icons.gif/contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html696"
HREF="node12.html">The Files window</A>
<B> Up:</B> <A NAME="tex2html693"
HREF="node5.html">Attributes of Interface Windows</A>
<B> Previous:</B> <A NAME="tex2html687"
HREF="node10.html">The Save Window</A>
<BR>
<BR>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION00460000000000000000"> </A><A NAME="372"> </A><A NAME="373"> </A><A NAME="load"> </A>
<BR>
The Load Window
</H1>
<BR>
<DIV ALIGN="CENTER"><A NAME="loadwin"> </A><A NAME="430"> </A>
<TABLE WIDTH="50%">
<CAPTION><STRONG>Figure 2.6:</STRONG>
The Load window.</CAPTION>
<TR><TD>8#8</TD></TR>
</TABLE>
</DIV>
<BR>
<P>
<DL>
<DD><P>
<DT><STRONG>Window title:</STRONG>
<DD>DsTool: Load
<DT><STRONG>Function:</STRONG>
<DD>The Load window allows the user to load data from an
external file into memory.
<DT><STRONG>Description:</STRONG>
<DD>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.
<DT><STRONG>Panel items:</STRONG>
<DD>
<UL>
<LI>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
DSTOOL_DATA_DIR, or if that is not set, the current working directory.
<LI>Filename read-write text field:
Displays the currently selected file from which
DsTool will load data. The default is the file ``dstool.config''.
<LI>Data style exclusive setting:<A NAME="383"> </A>
<DL>
<DT><STRONG>DsTool Tk Format:</STRONG>
<DD><A NAME="385"> </A><A NAME="386"> </A>
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.
<DT><STRONG>DsTool 2.0 Format:</STRONG>
<DD><A NAME="387"> </A><A NAME="388"> </A>
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.)<A NAME="389"> </A>
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.
<DT><STRONG>Unformatted:</STRONG>
<DD><A NAME="390"> </A><A NAME="391"> </A>
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.
</DL>
<LI>Load window button:<A NAME="393"> </A><A NAME="394"> </A>
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 (, 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:<A NAME="395"> </A> current settings data<A NAME="396"> </A>, configuration
data<A NAME="397"> </A>,
trajectory data<A NAME="398"> </A>, fixed point data<A NAME="399"> </A>,
continuation data<A NAME="400"> </A>, parameter data<A NAME="401"> </A>,
and selected point data<A NAME="402"> </A>.
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<A NAME="403"> </A>). We note here that auxiliary function
values are special in that they are not stored in memory<A NAME="404"> </A>
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.
<LI>Data type stack setting:<A NAME="405"> </A><A NAME="406"> </A>
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.
<LI>Color exclusive setting:<A NAME="407"> </A><A NAME="408"> </A>
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''<A NAME="409"> </A> and a ``pick color''<A NAME="410"> </A>.
See section <A HREF="node46.html#colors"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]"
SRC="/usr/lib/latex2html/icons.gif/cross_ref_motif.gif"></A> for more information on color modes.
All unformatted data is assigned the current alternating color.
If the data does <EM>not</EM> 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 <I>k</I>, then the associated data object will be color-coded with the <I>k</I>th
color of the currently installed colormap. Obviously,
<!-- MATH: $0 \leq k \leq N$ -->
9#9
where <I>N</I> 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 <I>x</I> and <I>y</I>,
and color-coding information, then if the file has the line
<PRE>
0.0 0.5 12
</PRE> then DsTool will store the data point
<!-- MATH: $(x,y) = (0.0,0.5)$ -->
(<I>x</I>,<I>y</I>) = (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 12th
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.
<LI>Symbol exclusive setting:<A NAME="415"> </A><A NAME="416"> </A>
Allows the user to choose whether or not data should be considered to have symbol-coding information.
If the data does <EM>not</EM> 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.<A NAME="418"> </A>
The integer must be the last item in the field which defines the data object.
If this integer is <I>k</I>, then the associated data object will be symbol-coded with the <I>k</I>th
symbol. Currently, valid symbols require
<!-- MATH: $0 \leq k \leq 11$ -->
10#10.
The values
<!-- MATH: $0 \leq k \leq 2$ -->
11#11
specify dots;
<!-- MATH: $3 \leq k \leq 5$ -->
12#12
specify crosses;
<!-- MATH: $6 \leq k \leq 8$ -->
13#13
specify boxes;
and
<!-- MATH: $9 \leq k \leq 11$ -->
14#14
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 <I>x</I> and <I>y</I>,
and symbol-coding information, and if the file has the line
<PRE>
0.0 0.5 8
</PRE> then DsTool will store the data point
<!-- MATH: $(x,y) = (0.0,0.5)$ -->
(<I>x</I>,<I>y</I>) = (0.0,0.5) and
the point will be plotted with the 8th symbol, which happens to be the largest
box. If the user wanted both color <EM>and</EM> symbol information (say the 12th color and the
8th symbol), then the data file might read something like this:
<PRE>
0.0 0.5 12 8
</PRE>
As with colors, trajectories cannot currently be assigned symbols.
<LI>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<A NAME="424"> </A>
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 <I>k</I> of these variables are selected and if <I>j</I> parameters are selected,
then DsTool will load the first <I>k</I> pieces of data into the selected variable, load the next <I>j</I>
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.
<LI>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 (<I>x</I>,<I>y</I>,<I>z</I>) and parameters
<!-- MATH: $(\alpha, \beta, \gamma)$ -->
15#15.
If the current values of these quantities are
<!-- MATH: $(x_0,y_0,z_0)$ -->
(<I>x</I><SUB>0</SUB>,<I>y</I><SUB>0</SUB>,<I>z</I><SUB>0</SUB>) and
<!-- MATH: $(\alpha_0, \beta_0, \gamma_0)$ -->
16#16
and if the user specifies that an unformatted data file
contains values for <I>x</I>, <I>z</I>, and 17#17,
then a line in the file of the form
<PRE>
8.3 -2.3 0.01
</PRE> will create a data object of the requested type and this data object will contain the
variable data
<!-- MATH: $(8.3, y_0, -2.3)$ -->
(8.3, <I>y</I><SUB>0</SUB>, -2.3) and the parameter data
<!-- MATH: $(\alpha_0, \beta_0, 0.01)$ -->
18#18.
Associated to the data object will be the current pick point color and the current
symbol, since these quantities were not specified.
<P>
<LI>Dismiss command button:
Closes the Load window.
</UL></DL><HR>
<!--Navigation Panel-->
<A NAME="tex2html695"
HREF="node12.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/lib/latex2html/icons.gif/next_motif.gif"></A>
<A NAME="tex2html692"
HREF="node5.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/lib/latex2html/icons.gif/up_motif.gif"></A>
<A NAME="tex2html686"
HREF="node10.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/lib/latex2html/icons.gif/previous_motif.gif"></A>
<A NAME="tex2html694"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="/usr/lib/latex2html/icons.gif/contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html696"
HREF="node12.html">The Files window</A>
<B> Up:</B> <A NAME="tex2html693"
HREF="node5.html">Attributes of Interface Windows</A>
<B> Previous:</B> <A NAME="tex2html687"
HREF="node10.html">The Save Window</A>
<!--End of Navigation Panel-->
<ADDRESS>
<I>John Lapeyre</I>
<BR><I>1998-09-04</I>
</ADDRESS>
</BODY>
</HTML>
|
