\section{The Save Window}\index{Save window}\index{window, Save}\label{save}
%
%
%
\begin{figure}[H]
%\vspace{1.0in}
\centerline{\psfig{figure=ps/save.ps,height=143pt}}
\caption{\label{savewin}
The Save window.
}
\end{figure}

%
%
%
\begin{description}

\item[Window title:] DsTool: Save
\item[Function:] The Save window is used to control saving memory data to files.
\item[Description:] The Save window is opened by selecting the 
	Save option from the File menu button located in the 
	Command window.  The user can specify parts of DsTool 
	memory to save.
%\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: \index{directory, save}
		Displays the currently selected directory to which DsTool will save data.  
		The default is the current 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 filename to which
		DsTool will save data.  The default is an emptry string.
	\item Data style exclusive selection:\index{data, style}
		\begin{description}
		\item[DsTool Tk Format:]\index{formatted data}\index{data, DsTool Tk format}
		Specifies that the data should be saved in 
		DsTool Tk format.  This format is currently not completely
		operational.  The only options which can be saved with this
		format are ``Current Settings'' and ``Window Configuration''.
                \item[DsTool 2.0 Format:]\index{formatted data}\index{data, DsTool 2.0 format}
                Specifies that the data should be saved in
                DsTool 2.0 format.  This format allows all of the options
                below to be saved.  This is the default setting.
		\end{description}
	\item Save options non-exclusive selections:   
		\begin{description}
		\item[Current Settings:]\index{data, types}\index{current settings data}  
			Specifies that the current initial 
			conditions, parameter values, and default settings
			are saved to the file specified by the Filename text field. 
			Specifically, the data saved is a complete description of the Postmaster, with the
			exception of the ``Models'' object.  No Tcl variables which control the look of the
			user interface (such as COLOR and EXT) are saved.  This is selected by default.
%Specifically, the data saved
%			makes up the Orbits, Multiple Orbits, and Fixed Points windows, as well as the
%			Selected Point and Defaults windows.  
		\item[Window Configuration:]\index{configuration data}
			Specifies that the positions and sizes of all DsTool windows 
			are saved to the data file specified by the Filename text field.  
%			With the exception of the Save and Load windows and user-defined 
%			windows, windows which can be 
%			chosen from the Command window may have their sizes and positions saved.
			For each 2-D View window that is open, the view options
			are also saved.  View options include the horizontal and
			vertical coordinates and plotting ranges.  By saving the current settings and
			configuration before ending a DsTool session, the user may preserve virtually
			all the program working environment.  Later, the user can restart DsTool, load
			the saved configuration and data file and continue working essentially as if the
			session had not been terminated.
		\item[Trajectories:]\index{trajectory data}
		 	Specifies that all trajectories (whether or not they are currently
			displayed) are saved to the data file specified by the Filename text field.
			Be warned that by using this option it is easy to generate massive data files. 
%Trajectory data is displayed in a view window whenever no coordinate of the view window is a 
%			parameter.\index{data, conditions to view}\index{window, types of data displayed in}
			Flow objects (generated using the Multiple Orbits window) are also saved when this
			option is chosen.
		\item[Fixed points:] \index{fixed point data}
			Specifies that all fixed points (which may be found using the Fixed Points window)
			are saved to the data file specified by the Filename text field. 
% Fixed points are displayed in a view window whenever no coordinate  of the view window are parameters.  
			Any computed stable or unstable manifolds are also saved.
		\item[Continuation data:] \index{continuation data}
			Specifies that all continuation trajectories (whether or not
			they are currently displayed) are saved to the data file specified by the
			Filename text field. 
% Continuation data may be displayed in any view window, regardless of which variables are being displayed.
                \item[Selected points:] \index{selected point data}
			Specifies that selected point data be saved to the data file
                        specified by the Filename text field.
                        Selected Point data contains elements  of the
                        cross-product of phase and parameter space.
% If the coordinates of a view window does not consist completely of parameters, then Selected Point data are
%                       displayed in that window.
		\item[Parameter data:] \index{parameter data}
			Specifies that parameter data be saved to the data file 
			specified by the Filename text field. 
			Parameter data and selected point data are similar in
			that they both contain elements of the cross-product of phase and parameter
			space.  The main difference lies in how these data sets are displayed in view
			windows.  Parameter data is only displayed in a view window if all coordinates
			are parameters.  In fact, parameter data does not contain any phase space variable 
			information.   This version of DsTool does not save information into the 
			Parameter memory, but this option is included for compatibility with other versions. 
		\item[Function values:] \index{memory, function values}
			Specifies that function values be saved to the data file
			specified by the Filename text field. 
			Function values are not stored in memory but they can be
			written to a data file.  Function values are {\em never} read back into DsTool;
			DsTool will stop reading when it encounters a function value.
		\end{description}
	\item Save window button:\index{Files window}\index{window, Files}
		Opens and brings to the foreground the
		Files window, for saving the requested data to the file. 
	\item Dismiss command button:
		Closes the Save window. 
% The current selected options do not revert to their default values.
\end{itemize}
\end{description}
