File: twoD.tex

package info (click to toggle)
dstooltk-doc 2.0-3
  • links: PTS
  • area: main
  • in suites: woody
  • size: 4,024 kB
  • ctags: 451
  • sloc: perl: 753; makefile: 49; sh: 8
file content (173 lines) | stat: -rw-r--r-- 8,970 bytes parent folder | download | duplicates (3)
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
\section{The 2-D View Window}\label{twoDwin}\label{2-D view window}\label{window, 2-D view}\index{2-D View window}\index{window, 2-D View}
%
%
%
\begin{figure}[H]
%\vspace{.5in}
\centerline{\psfig{figure=ps/twoD.ps,height=365pt}}
\caption{\label{twoD}
The 2-D View window.
}
\end{figure}

%
%
%
\begin{description}

\item[Window title:]  DsTool: 2-D View \#{\it n}
\item[Function:] The 2-D View window graphically displays computed data. 
\item[Description:] The 2-D View window is opened by selecting the 2-D View
	option from the Panels menu button located in the Command window.
	Unlike the 1-D View window, a 2-D View window can always be opened, 
	regardless of the number of phase space variables of the system.  
        The user can select the plotting coordinates from all available
        variables, parameters, and auxiliary functions for the current
        dynamical system.  Additionally, the range of each axis is displayed,
        and the size of the window and various other plotting options may be
        specified.  Multiple 2-D View windows can be open simultaneously, 
	and each may plot with different coordinates.

	When the window is open, data is displayed as it is computed.
%	When iconized,	the canvas is not updated.  When reopened, the window 
%	will be in an identical state as when it was closed, except 
%	that the canvas will now display all appropriate currently stored data.
	When the user resizes\index{window, resizing} the window, the current variable ranges are
	maintained, but the scaling is adjusted accordingly.  

	As the user moves the mouse in the drawing canvas, the current
	coordinates\index{coordinates of mouse} 
	of the mouse position\index{mouse, position} are displayed in the window's
	panel.  This region is blank when the mouse does not point
	into the canvas.
	Mouse events in the main drawing canvas have the following
	effects:
	\begin{itemize}
	\item
		The SELECT\index{mouse, select button}
		button sets the direction of the integrator or iterator to ``forward.''  It 
		also reads the values indicated by the cursor.  If one 
		or both of these values are variables or 
		parameters, these values are adjusted in the Selected Point window.  
%		If a secondary coordinate system (such as polar coordinates) is in 
%		use, then these secondary coordinates\index{coordinates, secondary} are set. \notimp{}

	\item
		Dragging the SELECT button while holding down SHIFT creates an elastic rectangle used
		to rescale\index{rescaling view windows} the window.  When the user releases SELECT, a notice
		appears with the options to enlarge the 
		view (the default, also known as ``zoom in'')\index{zoom}, 
		shrink the view (also known as ``zoom out''), 
		or cancel the selection.  If the enlarge option is selected, the scaling is
		adjusted so that the selected region fills the canvas.  If the
		shrink option is selected, the view is rescaled so that
		the whole view is put into the selected rectangle.  The
		values in the ordinate and abscissa Min and Max text fields
		are updated automatically and a screen refresh is performed.
	\item
		Dragging the SELECT button while holding down CONTROL creates an elastic
		rectangle used to input a region for the Multiple Orbits window.  See
		Section~\ref{MultOrbWin} for details on this operation.
		\index{trajectories, multiple}
	\item
		The MENU\index{mouse, menu button} button 
                sets the direction of the integrator or iterator to ``backward.''  It
                also reads the values indicated by the cursor.  If one
                or both of these values are variables or
                parameters, these values are adjusted in the Selected Point window.
	\item
		Clicking the ADJUST\index{mouse, adjust button} button is equivalent to selecting
		the Continue button on the Orbits window. 
%	\item
%		Clicking the ADJUST button while holding down CONTROL deletes stored data.\index{data, deleting}
%        	The actual points
%        	deleted depend upon the coordinates of the view window when the action is taken. If
%        	every coordinate of the view window is a parameter, then the action clears
%        	the parameter data.   If no coordinate of the view window is a parameter, then 
%        	the action clears the trajectory data.  In the remaining cases, the
%        	action clears the selected point data.  See the Reference Manual\index{reference manual} 
%		or Sections \ref{save} and \ref{load}
%		for more information on different types of data.
	\end{itemize}		
	
%\item[Window type:] base frame
%\item[Window attributes:] iconizable, resizable, variable template, footer
\item[Panel items:] \mbox{}
	\begin{itemize}
	\item Hor stack setting:
		Allows the user to choose the coordinate of the abscissa.
		The user may choose between all variables (including the independent
		variable), all parameters, and all auxiliary functions.
% (and alternate coordinate systems if the user has specified them).   
%		The window is refreshed after the user selects the Refresh option.
		The three text fields to the right of the hor stack setting are
		the Hor min read-write text field, the Mouse abscissa position
		read-only text field, and the Hor max read-write text field.
        \item Hor min read-write text field:
                Displays the current minimum value of the displayed
                range of the abscissa.  
%The user may adjust this value.  The canvas is refreshed after the user selects the refresh option.
	\item Mouse abscissa position read-only text field:
		Displays the current abscissa value of the mouse.   If the mouse does not 
		point into the canvas, this region is blank.
        \item Hor max read-write text field:
                Displays the current maximum value of the displayed
                range of the abscissa.  
%The user may adjust this value.  The canvas is refreshed after the user selects the refresh option.
	\item Ver stack setting:
		Allows the user to choose the coordinate of the ordinate.
		The user has the same choices as for the Hor stack setting.
%		The canvas is refreshed after the user selects the Refresh option.
		The three text fields to the right of the ver stack setting
		are the Ver min read-write text field, the Mouse ordinate 
		position read-only text field, and the Ver max read-write text field. 
	\item Ver min read-write text field:
		Displays the current minimum value of the displayed 
		range of the ordinate.  
%The user may adjust this value.  The canvas is refreshed after the user selects the refresh option.
        \item Mouse ordinate position read-only text field:
                Displays the current ordinate value of the mouse.   If the mouse does not
                point into the canvas, this region is blank.
	\item Ver max read-write text field:
		Displays the current maximum value of the displayed 
		range of the ordinate.  
%The user may adjust this value.  The canvas is refreshed after the user selects the refresh option.
	\item Options menu button:
		\begin{description}
		\item[Color:]\index{Color window}\index{window, Color}
		 	Opens and brings to the foreground the Color window.
		\item[Continuation Colors:]\index{Continuation Colors window}\index{window, Continuation Colors}
		 	Opens and brings to the foreground the Continuation Colors window.
		\item[Print:]\index{Print window}\index{window, Print}	
			Opens and brings to the foreground the Print window.
		\item[Snapshot:]\index{Snapshot window}\index{window, Snapshot}
			Opens and brings to the foreground the Snapshot window. 
		\end{description}
	\item Window sizes menu button:
		\begin{description}
		\item[Scale to fit:]\index{scale to fit}
			Sets the abscissa and ordinate ranges so that all of the computed
			data points lie within a box centered in the canvas with a padding on each side.
			See section \ref{window, defaults} for a description of how to control the parameter 
			involved. The canvas is refreshed after the user selects this option.
		\item[Set current to default:] Sets the abscissa and ordinate ranges to their
			default values.  The canvas is refreshed after the users selects this option.
		\item[Set default to current:] Sets the abscissa and ordinate default ranges to 
			the current range. 
		\end{description}
	\item Pick color exclusive setting:\index{color, pick}
		Allows the user to choose whether points which are plotted in this
		2-D View window will be plotted using their ``pick color'',
		or their ``alternating color''.
	\item Refresh command button:
		Clears the drawing canvas and redraws with the appropriate
		projection of currently stored data as selected by the user in 
		the above settings.
	\item Clear command button:
		Clears trajectory data from memory, and refreshes the canvas according
		to the above settings.
	\item Dismiss command button:
		Closes the 2-D View window. 
% The min and max fields will revert back to their default values.  
	\end{itemize}
\end{description}