\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}
