\documentclass[10pt,letterpaper, final]{report}
\usepackage{../preamble/myWEPS}

\begin{document}

There are several items that a user needs to address prior to using WEPS.
Most of these items are not critical for most WEPS Runs,
but are beneficial for keeping track of previous simulation runs,
documenting what was done for each run,
listing who the client is and why the WEPS Run(s)were being made, etc.
Other items are purely useful for better organization of previous WEPS Runs,
clean up of temporary results and deletion of old preliminary simulation runs, etc.
\subsection{WEPS Runs Location} \label{subsec:WEPS_Runs_Location}
The first item is determining where one wants to store WEPS Runs and setting the default location for them.
For new Projects, this can be configured within the Configuration panel,
which is accessible via the "Tools/Edit Configuration" menu option
in the Config Panel's "Project \& Data Loc" tab.
The specific field is labeled: \textbf{New Prj. Default Runs Location} as shown here:

\begin{figure}[H]
	\centering
	\includegraphics[scale=3.0]{images/Interface_Ref/Config_Panel_Default_Run_Loc.jpg}
	\caption{Configuration Panel: New Project Default WEPS Runs Location.}
	\label{fig:Cfg_Panel_New_Prj_WEPS_Runs_Loc}
\end{figure}

The user has the ability to override that location and reset the default location from the main WEPS screen, if desired.
The WEPS Runs Location panel (\cref{fig:WEPS_Runs_Location_panel})
is located immediately below the “Button Bar” on the Main WEPS screen (\cref{fig:WEPS_main_screen}).

\begin{figure}[H]
	\centering
	\includegraphics[scale=0.94]{images/Interface_Ref/Runs_Location_panel.jpg}
	\caption{WEPS Runs Location panel on main WEPS screen.}
	\label{fig:WEPS_Runs_Location_panel}
\end{figure}

\begin{itemize}
\item[\img{images/icons/folder.png}]{This "Set Run Location" folder button
allows the user to change the default WEPS Run Directory by bringing up
a modified file chooser window (\cref{fig:WEPS_Runs_Location_FileChooser}).
This file chooser window defaults to the current default WEPS Runs Location folder,
which is displayed in the field immediately to the right of the folder icon,
as shown in (\cref{fig:WEPS_Runs_Location_panel}).
The user changes this system wide default path to whatever they select via this file chooser.
One can also revert back to the current default "WEPS Runs Location" setting
by clicking on the "Cfg Def Loc" button in the FileChooser window.
The "Dev Loc" button will take the user to the currently specified location
shown in \cref{fig:WEPS_Runs_Location_panel}.
If the user has previously changed from the original "New Prj. Default Runs Location,
they can use the "Config Def Loc" button as a shortcut method
to easily go back to that location, if desired.

\hl{We need to add a separate reference section regarding the general use
of the WEPS FileChooser windows and how they (are supposed to) work.}

\begin{figure}[H]
	\centering
	\includegraphics[scale=2.2]{images/Interface_Ref/Runs_Loc_FileChooser.jpg}
	\caption{WEPS Runs Location FileChooser for selecting/setting the desired default "WEPS Runs Location".}
	\label{fig:WEPS_Runs_Location_FileChooser}
\end{figure}
}
\end{itemize}
 
\subsection{Simulation Run Information} \label{subsec:Simulation_Run_Information}
Simulation information is entered in the Simulation panel (\cref{fig:Sim_Panel_Full}
on the left side, center of the WEPS main screen (\cref{fig:WEPS_main_screen}).
The following fields in the Simulation panel are:
a) \textbf{Run Mode}:
b) \textbf{Water Erosion};
c) \textbf{Region Slope};
and
d) \textbf{Rock Fragments}.

Some of these fields can be set "readonly" (greyed out) and not allow modification,
depending upon how WEPS has been configured for a specific set of users.
For example, the "Run Mode" setting cannot be changed,
if WEPS has been configured for NRCS use.

\begin{figure}[H]
	\centering
	\includegraphics[scale=2.2]{images/Interface_Ref/Sim_Panel_Full.jpg}
	\caption{Full Simulation panel display.}
	\label{fig:Sim_Panel_Full}
\end{figure}

\subsubsection{Run Mode} \label{subsubsec:Run_Mode}
The run-length mode determines the length and type of WEPS Run that will be simulated.
There are three options for \textbf{Run Mode}:
1) An \textbf{NRCS} mode which indicates that the number of simulation cycles which is currently fixed to
“50 cycles per rotation year in the selected management rotation”. 
This option is specified and locked (read-only) for official NRCS field use
in the “NRCS configured” release of WEPS;
2) The \textbf{Cycle} mode indicates that the user can specify the number of simulation cycles to run
(number of years to simulate for each rotation year in the selected management rotation).
The larger the value specified, in general the more accurate (consistent) the simulation results will be.
The default value of 50 cycles is generally considered a good compromise
between accuracy and simulation runtime.
The default length of run (number of cycles) is controlled through the “Run” tab in the
“Configuration Settings” panel (see the discussion on “Configuration” for more details);
3) The \textbf{Dates} mode allows the user to specify the exact starting and ending dates for the simulation.
This mode is only intended for researchers and developers
for when specific experimental scenarios are being evaluated.
The “Dates” mode does not guarantee that the WEPS interface reports
will display accurate information like the “NRCS” and “Cycle” modes do.
 
\begin{figure}[H]
	\centering
	\includegraphics[scale=0.76]{images/Interface_Ref/Sim_Panel_Run_Mode.jpg}
	\caption{Simulation panel displaying the "Run Mode" input field and options.}
	\label{fig:Sim_Panel_Run_Mode}
\end{figure}

\subsubsection{Water Erosion} \label{subsubsec:Water_Erosion}
The \textbf{Water Erosion} value is required for true estimates of the Soil Quality Index,
which uses both wind and water erosion estimates in its computation.
The Soil Quality Index is used by NRCS as an indicator of whether a particular set of management practices
are improving or degrading the relative quality of the soil based upon the management practices specified
for a WEPS simulation run.
NRCS requested that the index be computed as an ancillary byproduct of each WEPS wind erosion simulation.
This input field therefore has no impact on wind erosion estimates
and is not required to be properly populated for a non-NRCS WEPS simulation run.

\begin{figure}[H]
	\centering
	\includegraphics[scale=2.2]{images/Interface_Ref/Region_Slope.jpg}
	\caption{Region Slope field choices in the Simulation panel display.}
	\label{fig:Region_Slope}
\end{figure}

\subsubsection{Region Slope} \label{subsubsec:Region_Slope}
The \textbf{Region Slope} field (\cref{fig:Region_Slope})
provides the user with the option to override the default slope value
specified in the selected soil record.
The \textbf{Soil DB Value} field displays the soil record value immediately below this field.
The slope value is used within the WEPS model
to determine the amount of rainfall and applied irrigation water that will runoff the site
and not infiltrate into the soil under the surface conditions present at the time the water is received.
The reason this input is made available for user modification is because NRCS specifies a “typical” slope
for all the soil components in their NASIS soil database.
However, there is usually a range of slopes that a soil component may exist on.
Providing the \textbf{Region Slope} field allows the user to easily specify
a more representative slope value for a particular field site,
if it is significantly different than the soil record default value.
The possible values are: \textbf{Override Soil Slope} (user specifies the specific slope value);
\textbf{Use Soil Slope from Soils Database};
\textbf{Level Basin},
\textbf{No Runoff (0 degree slope)};
\textbf{Slope 0.001 (0.1\%)};
\textbf{Slope 0.01 (1\%)};
\textbf{Slope 0.02 (2\%)};
\textbf{Slope 0.03 (3\%)};
\textbf{Slope 0.04 (4\%)};
\textbf{Slope 0.05 (5\%)};
and \textbf{Slope 0.1 (10\%)}.

\subsubsection{Rock Fragments} \label{subsubsec:Rock_Fragments}
The \textbf{Rock Fragments} field (\cref{fig:Rock_Fragments}) provides the user
with the option to override the surface rock fragments value
specified in the selected soil record.
The Soil DB Value field displays the soil record value immediately below this field.
The rock fragments value is used within the WEPS model when determining
the fraction of the surface considered non-erodible,
which directly impacts the soil surface’s overall susceptibility to soil loss by wind erosion.
The reason this input is made available for user modification is because of the known variability
of the values within specific soil components listed in the NRCS NASIS soil database
and the level of sensitivity to erosion estimates from this input parameter.
The possible values are: \textbf{Override Rock Fragments} (user specifies the specific rock fragments ratio);
and \textbf{Rock Fragments from Soils Database}.

\begin{figure}[H]
	\centering
	\includegraphics[scale=2.2]{images/Interface_Ref/Rock_Fragments.jpg}
	\caption{Rock Fragments field choices in the Simulation panel display.}
	\label{fig:Rock_Fragments}
\end{figure}

\subsection{WEPS Simulation Run Notes} \label{subsec:WEPS_Simulation_Run_Notes}
If desired,
each pending WEPS simulation run can be documented with specific user specified information
into the \textbf{Notes} text panel on the main WEPS screen (\cref{fig:WEPS_Sim_Notes})
which is located on the left side of the WEPS main screen (\cref{fig:WEPS_main_screen}).
The “Clear” button clears the \textbf{Notes} field of any previous WEPS Run’s content.
\hl{Should we re-introduce the "Edit" button but name it "Edit in larger window"?}

\begin{figure}[H]
	\centering
	\includegraphics[scale=2.2]{images/Interface_Ref/WEPS_Sim_Notes.jpg}
	\caption{Notes panel for documenting pending WEPS simulation run information.}
	\label{fig:WEPS_Sim_Notes}
\end{figure}

The WEPS simulation run \textbf{Notes} content is also available for post-editing
after completion of the WEPS simulation run.
The \textbf{Notes} content displays at the bottom of the display page of the WEPS Summary Report.
That onscreen report provides editing functionality where the \textbf{Notes} content is displayed
(\cref{fig:Run_Summary_Notes}).
Also, it gets written into the last page of the PDF version of the Run Summary report as well.
\hl{Need to get the post-edit Notes section's "Save" function to work correctly again.}

\begin{figure}[H]
	\centering
	\includegraphics[scale=2.4]{images/Interface_Ref/Run_Summary_Notes.jpg}
	\caption{Notes panel for documenting post WEPS simulation run information.}
	\label{fig:Run_Summary_Notes}
\end{figure}

\subsection{Client Information} \label{subsec:Client_Info}
Customer information for a simulation run is entered in the panel labeled \textbf{Client Information}
located on the upper left side of the WEPS main screen (\cref{fig:WEPS_main_screen}).
The \textbf{Client Name} as well as the \textbf{Farm No}, \textbf{Tract No}, and \textbf{Field No}
for the simulation run can be entered by typing the information into the appropriate boxes in the panel.
These four items are for informational purposes only and are not required to execute a WEPS simulation run.
These fields and their names were provided primarily for NRCS business purposes,
but any user can populate them with appropriate information to help them keep track
of individual WEPS simulation runs.

\begin{figure}[H]
	\centering
	\includegraphics[scale=3]{images/Interface_Ref/Client_Info.jpg}
	\caption{Client Information panel.}
	\label{fig:Client_Info}
\end{figure}

\subsection{Simulation Region Information} \label{subsubsec:Sim_Region_Info}
The  Simulation Region Information (\textbf{Region} panel) is shown in \cref{fig:Sim_Region_Info_Rec}
and is located in the upper center region of the WEPS main screen (\cref{fig:WEPS_main_screen}).
To describe the simulation region, the field dimensions are entered.
For example, the  X-Length and  Y-Length are entered for a rectangle.
Note that the area of the region will be displayed.
To orient the field, simply type in the angle in degrees of deviation from north
for the north/south field border and accept the value (tab or click outside the field).
Note that the field will only rotate in a range of ±45 degrees.
By rotating and adjusting the field length and width, the user should be able
to obtain the desired size and orientation for any field.  

\begin{figure}[H]
	\centering
	\includegraphics[scale=3]{images/Interface_Ref/Sim_Region_Info_Rec.jpg}
	\caption{Simulation Region Information panel with rectangular field selected.}
	\label{fig:Sim_Region_Info_Rec}
\end{figure}

Other field shapes can be specified by clicking the down arrow \img{images/icons/down_arrow.png}
to the right of the \textbf{Shape} box to display a list of valid field shapes
(\cref{fig:Region_Shape_Options}).

\begin{figure}[H]
	\centering
	\includegraphics[scale=3]{images/Interface_Ref/Region_Shape_Options.jpg}
	\caption{Dropdown list of some alternative Simulation Region Shape options available.}
	\label{fig:Region_Shape_Options}
\end{figure}

\cref{fig:Sim_Region_Info_Circle} illustrates the panel entry for a circular field.
To describe a circular field, either the radius or the area of the field can be specified
and the other value is automatically computed.
For simulation purposes within WEPS, fields that are circles or partial circles
(i.e., half or quarter circle)are approximated as a square or rectangular field
with an area equal to that specified in the \textbf{Region} panel.
Field shapes that can be selected include Rectangle, Square, Circle, Half Circle VE (vertical east),
Half Circle VW (vertical west), Half Circle HS (horizontal south), Half Circle HN (horizontal north),
Quarter Circle NE (northeast), Quarter Circle SE (southeast), Quarter Circle SW (southwest),
and quarter Circle NW (northeast).
For a square, enter either the X-Length, Y-length or the area.
If area is entered, the field side length will be calculated and displayed.
For rectangular fields enter either the X-Length and Y-Length or the area and one length.
For circles or partial circles, enter the radius or the area and the other value
is automatically calculated and displayed.
The shape and orientation of the simulation region is displayed in the \textbf{Field View}
and automatically updated when any of the field values are modified.
If the user switches field shapes, the area will stay the same, unless the user later changes the dimensions.

\begin{figure}[H]
	\centering
	\includegraphics[scale=3]{images/Interface_Ref/Sim_Region_Info_Circle.jpg}
	\caption{Simulation Region Information panel with circular field selected.}
	\label{fig:Sim_Region_Info_Circle}
\end{figure}

Special shapes or configurations such as circles and strip cropping are further discussed
under the “Special Field Configurations” section of the chapter titled
“Using WEPS for Conservation Planning” in the WEPS User Manual.
Strip cropping is further discussed in detail in the “WEPS How To Guide” for Strip Cropping.
The orientation of tillage direction is specified within the Management Crop Rotation Editor for WEPS (MCREW).
\hl{(Add links here after the mentioned chapter(s) gets converted/updated to LaTeX))}

The Simulation Region must be considered carefully.
The boundaries of this region are assumed to be non-erodible.
This is assumed so that unknown quantities of material will not be entering from a neighboring area.
Typically, stable boundaries do not allow creep and saltation sized material
to pass through and include barriers
or a surface at least 15 feet wide that has vegetation sufficient to stop erosion.
However, there are situations where one may want to simulate a field with erodible boundaries
such as an area within an erodible field.
In these situations, the user should consult their agency’s policy for simulating such areas.   

\subsection{Field View} \label{subsubsec:Field_View}
The  \textbf{Field View} panel (\cref{fig:Field_View_Rec})
is located in the center of the WEPS main screen (\cref{fig:WEPS_main_screen}).
It is designed to give the user a pictorial diagram of the field size, shape, and orientation (field shape displayed in green).
The placement of any barriers present is also displayed in red.
A yellow bar on the side of the field in the Field View panel indicates which side of the field
has been selected for barrier placement using the radio buttons  in the \textbf{Barriers} panel.
This is useful for selecting field barrier placement when the field is oriented at angles close to 45 degrees.
A red barrier shaded with yellow, as shown for the south barrier (\cref{fig:Field_View_Rec}),
indicates a selected barrier that has already been placed on the field border.
Note that if the ratio of length to width of the field or barriers is too great to display to scale,
this will be indicated within the panel,
and an approximation of the field or barrier shape will be displayed
(see \cref{fig:Field_View_Circle}).
This panel is for viewing only and is not directly editable. 

\begin{figure}[H]
	\centering
	\includegraphics[scale=3]{images/Interface_Ref/Field_View_Rec.jpg}
	\caption{Field View panel for a rectangular field.}
	\label{fig:Field_View_Rec}
\end{figure}

When a full, half, or quarter circle field is simulated (\cref{fig:Field_View_Circle}),
it is approximated within WEPS as a square or rectangular field with an area
equal to that specified in the \textbf{Region} panel.
The \textbf{Field View} panel displays an approximate inscribed circle (or half or quarter circle)
within the simulated rectangular field.
When a non-rectangular field is selected, the field described
in the \textbf{Region} panel has an area equal to that of the simulated rectangular field.

\begin{figure}[H]
	\centering
	\includegraphics[scale=3]{images/Interface_Ref/Field_View_Circle.jpg}
	\caption{Field View panel for a circular field.}
	\label{fig:Field_View_Circle}
\end{figure}

\end{document}