\documentclass[10pt,letterpaper, final]{report} % \documentclass{} required in all files

\usepackage{../preamble/myWEPS} % This is now our single preamble file inclusion (it assumes a “.sty” file extension)

\begin{document}
A “WEPS Project” is a directory that can be thought of as a working area where WEPS simulation input data files are created, edited and stored.
A WEPS Project stores all the parameters for the current simulation run being prepared within the WEPS interface,
as well as any previous WEPS simulation runs made from within this Project folder.
For example, a particular WEPS Project may represent a folder for an individual client
under which all of the simulation runs for each field and management alternatives for that client's farm can be stored.

When a WEPS Project is saved, the current "state" of the WEPS interface is preserved with all of the information
contained in the current WEPS interface screen is stored in a 
\textbf{weps.ini} file within the Project folder
along with the currently selected management and crop files.
Multiple WEPS Project folders can be created and given user defined names.
WEPS Project folders use the default name extension of ".wpj" to easily identify them.
WEPS provides the ability to remove unnecessary WEPS Project folders from within the WEPS interface
via the pertinent options under the \textbf{Project} menu.
Note that the following characters cannot be used in WEPS file names:
\textbf{: \& "  ` * ?} \boldsymbol{${<}$ ${>}$  ${|}$ $\backslash$}

When leaving the current WEPS Project folder (or exiting WEPS), the user is always asked via a popup window (\cref{fig:Save_Current_Project_window}),
if the user first wants to save the current Project's "state" (of the WEPS interface), unless no changes have yet been made in the WEPS interface during this instance of WEPS.
\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/Interface_ref/Save_Current_Project_window.jpg}
\caption{Save Current Project popup window.}
\label{fig:Save_Current_Project_window}
\end{figure}
If the user clicks \textbf{Yes}, the current parameters are saved to the old (current) Project.
If the user clicks \textbf{No}, the current parameteres are not saved.
If the user clicks \textbf{Cancel}, the selected WEPS Project process is aborted and the WEPS interface screen returns
to the previous Project and its current interface settings.
\subsection{Working with WEPS Projects} \label{subsec:Working_with_WEPS_Projects}
Clicking the \textbf{\ul{P}roject} menu item displays a list of various options pertaining to WEPS Projects.
These options are discussed below. Note that multiple WEPS Projects functionality is now available by default for all WebStart WEPS builds, including NRCS configured builds.

The \textbf{\ul{N}ew (Ctrl-N)} menu item (same as
\scalerel*{\img{images/icons/new.png}}{\strut}
on the button bar)
allows the user to create/name a new WEPS Project folder.
Clicking on this menu item causes WEPS to first allow for any unsaved changes to be saved to the current Project via a popup window (\cref{fig:Save_Current_Project_window}).
After the user appropriately dismisses the popup window,
a file chooser window (\cref{fig:FileChooser_New_Project})
\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/Interface_ref/FileChooser_New_Project.jpg}
\caption{New Project FileChooser window.}
\label{fig:FileChooser_New_Project}
\end{figure}
appears which allows the user to specify a name for the new WEPS Project.
The WEPS interface screen is then cleared, and the newly created WEPS Project becomes the current WEPS Project.

The \textbf{\ul{O}pen... (Ctrl-O)} menu item(same as
\scalerel*{\img{images/icons/open.png}}{\strut}
on the button bar)
opens an existing WEPS Project.
Clicking on this menu item causes WEPS to first allow for any unsaved changes to be saved to the current Project via a popup window (\cref{fig:Save_Current_Project_window}).
After the user appropriately dismisses the popup window,
a file chooser window (similar to \cref{fig:FileChooser_New_Project}) appears which allows the user to select the name of an existing WEPS Project to re-open.
The WEPS interface screen is then cleared, and the selected WEPS Project's last saved "state" (of the WEPS interface) is restored for the newly selected current WEPS Project.

The \textbf{\ul{S}ave (Ctrl-S)} menu item
(same as \scalerel*{\img{images/icons/save.png}}{\strut}
on the button bar)
saves the current WEPS Project "state" (of the WEPS interface) into the Project's \textbf{weps.ini} file for the current WEPS Project.

\textbf{S\ul{a}ve As... (Ctrl-A)} allows the user to save a copy of the currently displayed WEPS Project's "state" (of the WEPS interface)
into a new Project's \textbf{weps.ini} file.
The new Project must not previously exist and it cannot overwrite (replace) an existing WEPS Project.
The user must enter a unique name. The newly saved copy of the Project then becomes the current WEPS Project.

The \textbf{Delete \ul{P}roject (Ctrl-P)} menu items open a file chooser to delete a selected WEPS Project folder, including all of its contents.
%  and the \textbf{Delete Run} or a WEPS Run folder

The \textbf{Delete \ul{M}anagement Rotation File (Ctrl-M)} menu item opens a file chooser to delete a WEPS management file.

The \textbf{Delete IFC Soil File (Ctrl-L)} item opens a file chooser to delete a WEPS soil file.

The \textbf{Reset} and \textbf{Clear GUI} menu options both clear the main WEPS interface fields and set them back to the defaults.
The \textbf{Reset} option also removes all files from the current WEPS Project folder (it does not remove any subfolders or their contents from the current Project.
This is to hopefully preserve any WEPS Runs that may exist under the current WEPS Project folder.

The \textbf{E\ul{x}it (Ctrl-X)} menu option, exits the WEPS program.

The default WEPS Project folder location for these various WEPS Project menu options,
under which new WEPS Projects will be created and existing WEPS Projects will be opened,
can be specified under the \textbf{Project \& Data Loc} tab of the \textbf{Configuration Panel} window (\cref{fig:Config_Panel_Projects}).
This Config Panel is accessible via the \textbf{\ul{T}ools/Edit \ul{C}onfiguration} menu option in WEPS or by using the \textbf{Alt-C} key sequence.
\begin{figure}[H]
\centering
	\includegraphics[scale=1.69]{images/Interface_ref/Config_Panel_Projects.jpg}
\caption{Configuration Panel settings for specifying the default WEPS Project and Run locations.}
\label{fig:Config_Panel_Projects}
\end{figure}
The location for all WEPS Projects to reside by default is specified in the \textbf{Projects Folder} field as shown in \cref{fig:Config_Panel_Projects}.
This location is usually set to the user's \textbf{Documents} folder\footnote{The \textbf{\$\{user.documents\}} variable shown in \cref{fig:Config_Panel_Projects}
in the \textbf{Projects Folder} field, refers to the operating system's \textbf{Documents} folder for the current user in WEPS.},
but can be anywhere the user desires on there computer system.
All new WEPS Projects will automatically be created under this folder location by default, unless overridden by the user.

WEPS will use the \textbf{Default Project}\footnote{The \textbf{\$\{project.path\}} variable shown in \cref{fig:Config_Panel_Projects}
in the \textbf{Default Project} field, refers to the path represented by the \textbf{Projects Folder} field in \cref{fig:Config_Panel_Projects}.}
name,
(also shown in \cref{fig:Config_Panel_Projects})
as the base name for all new WEPS Projects with an "\textbf{\_x}"
(The "\textbf{x}" is a unique integer number) appended to this basename by default.
The user has the option to override this default new WEPS Project name, if desired.

\subsection{“WEPS Run” Folders} \label{subsec:“WEPS_Run”_Folders}
All WEPS simulation run results are stored in separate folders.
A WEPS Run folder is created every time a simulation run is made.
A WEPS Run folder stores a copy of all input files used to make the simulation run, together with the output files generated from those inputs by the WEPS science model.
Thus, one is able to reproduce the identical WEPS Run at a later date
(and get the same output results assuming they are using the same version of WEPS and weather generators/databases used when making the original simulation)
because the original input files are still available.
Typically, "re-executing" a previous WEPS Run is not necessary since the outputs are stored in the WEPS Run directory and can be reviewed via the “ViewOutput” menu options.
However, a user may want to "Restore” a previous WEPS Run and use it as a template for editing prior to making a subsequent simulation run.
This functionality is available via the
\scalerel*{\img{images/icons/rerun.png}}{\strut}
button or the \textbf{Restore WEPS Run} option under the \textbf{\ul{R}un} menu.
Storing the input and output files for each WEPS Run in individually named directories makes it relatively easy to manage, archive and remove selected WEPS Runs as necessary. 
WEPS is configured by default to place the WEPS Run folders within the current WEPS Project folder under the "Runs" subdirectory
as shown in \cref{fig:Config_Panel_Projects}
in the \textbf{New Prj. Default Runs Location} field\footnote{The \textbf{\$\{project.directory\}} variable shown in \cref{fig:Config_Panel_Projects}
in the \textbf{New Prj. Default Runs Location} field, refers to the path represented by the \textbf{Default Project} field in \cref{fig:Config_Panel_Projects}.}.
This keeps all the WEPS Runs made within each specific WEPS Project with that Project.
An alternative default WEPS Runs location can be configured within the \textbf{Configuration Panel} if desired.

Also, the default WEPS Runs location for the current WEPS Project can be changed from the configured default specified in the \textbf{Configuration Panel} (\cref{fig:Config_Panel_Projects})
via the \textbf{Project/Set R\ul{u}n Location} menu option or on the WEPS interface screen (\textbf{Runs Location} panel in \cref{fig:WEPS_main_screen} and shown here
in \cref{fig:Runs_Location_Panel2}.
Clicking on that folder icon \img{images/icons/folder.png} (selecting the menu option) will bring up a file chooser to change the default WEPS Runs location 
(\cref{fig:Set_Run_Location}).

\begin{figure}[H]
\centering
	\includegraphics[scale=1.7]{images/Interface_ref/Runs_Location_panel2.jpg}
\caption{WEPS Runs Location Panel.}
\label{fig:Runs_Location_Panel2}
\end{figure}

\begin{figure}[H]
\centering
	\includegraphics[scale=1.69]{images/Interface_ref/Set_Run_Location.jpg}
\caption{Set Default WEPS Runs Location FileChooser.}
\label{fig:Set_Run_Location}
\end{figure}
The user also has the ability to temporarily override the default WEPS Runs location when submitting a WEPS Run for execution.
when specifying a WEPS Run via the options under the \textbf{\ul{R}un} menu or the
\scalerel*{\img{images/icons/run_button.png}}{\strut}
and
\scalerel*{\img{images/icons/calibraterun.png}}{\strut}
buttons.
Here is the filechooser that allows the user to specify both the WEPS Run location and the name of the WEPS Run (\cref{fig:Set_Run_Location2}).
\begin{figure}[H]
\centering
	\includegraphics[scale=1.69]{images/Interface_ref/Set_Run_Location2.jpg}
\caption{Set default WEPS Runs Location FileChooser.}
\label{fig:Set_Run_Location2}
\end{figure}
The user can make the change for this WEPS Run instance by clicking on the folder \scalerel*{\img{images/icons/folder.png}}{\strut} icon or editing the path field directly. Note also that WEPS provides a unique default name for each WEPS Run, which the user can also change.

WEPS also provides some additional \textbf{\ul{P}roject} menu options that refer to the WEPS Runs as well:

\textbf{Set R\ul{u}n Location} - \textbf{Ctrl-U}, as mentioned previously, allows the user to set the default WEPS Run location for the current WEPS Project.

\textbf{Export Run...} allows the user to copy and optionally zip the desired WEPS Run to conveniently archive or send copies to other individuals (\cref{fig:WEPS_Run_Exporter}).
\begin{figure}[H]
\centering
	\includegraphics[scale=1.69]{images/Interface_ref/WEPS_Run_Exporter.jpg}
\caption{WEPS Run Exporter Window.}
\label{fig:WEPS_Run_Exporter}
\end{figure}
\textbf{\ul{D}elete Run} - \textbf{Ctrl-D} allows the user to delete the specified WEPS Run.
\end{document}