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

\section{Preparing/Building a WEPS Simulation} \label{sec:Preparing_Building_a_WEPS_Simulation}
For a WEPS simulation, only four types of information are required to be entered on the main WEPS screen:

\begin{enumerate}
\item{Select field shape and specify the site area and orientation in the \textbf{Region} panel.}
\item{Select field site location in the \textbf{Location} panel, which also automatically selects the Cligen and Windgen stations to be used.}
\item{Select the desired soil component for the simulation via the dropdown choice list next to the \textbf{Soil} button at the bottom of the WEPS screen.}
\item{Select the desired management/crop rotation scenario via the dropdown choice list next to the \textbf{Man} button
near the bottom of the WEPS screen\footnote{Note that most previously built management/crop rotations require modification for each specific simulation site.}.}
\item{(Optional) Select wind barrier(s) which are placed along the field borders via the \textbf{Barriers} panel.}
\end{enumerate}

Now that we know which inputs are required for a WEPS simulation to be performed,
we will look at each of them in more detail:

\subsection{Specifying Field Information} \label{subsec:Specifying_Field_Information}

Describe field shape, size (area) and orientation within the \textbf{Region} panel
(see examples in \cref{fig:Region_Panel_Rectangle_Circle_Sections}).
Field shapes and orientations are displayed below the \textbf{Region} panel
(see examples in \cref{fig:Region_Panel_Shapes}).

	\begin{minipage}{\linewidth}
	\begin{figure}[H]
		\centering
			\subcaptionbox{Rectangle Shape Field Inputs}{\includegraphics[width=0.45\textwidth]{images/WEPS_Run/Region_Panel_Rectangle.jpg}}%
		\hfill
			\subcaptionbox{Circle Shape Field Inputs}{\includegraphics[width=0.45\textwidth]{images/WEPS_Run/Region_Panel_Circle.jpg}}%
		\caption{Field Site specification within the Region Panel.}
		\label{fig:Region_Panel_Rectangle_Circle_Sections}
	\end{figure}
	\end{minipage}
	
	\begin{enumerate}[label=\Alph*)]
	\item{Select field shape via the dropdown choice list,
	which will automatically get depicted in the field display area when selected (\cref{fig:Region_Panel_Shapes}).
	The options are:}

		\begin{center}
		\begin{multicols}{3}
		  \begin{itemize}[noitemsep]
		    \item[]{Rectangle}
		    \item[]{Square}
		    \item[]{Circle}
		    \item[]{ } %Empty item to get row spacing in 1st column to match the other columns, since we have an odd number of items.
		    \item[]{Half Circle VE}
		    \item[]{Half Circle VW}
		    \item[]{Half Circle HS}
		    \item[]{Half Circle HN}
		    \item[]{Quarter Circle NE}
		    \item[]{Quarter Circle SE}
		    \item[]{Quarter Circle NW}
		    \item[]{Quarter Circle SW}    
		  \end{itemize}
		\end{multicols}
		\end{center}

	\begin{minipage}{\linewidth}
	\begin{figure}[H]
		\centering
			\subcaptionbox{Rectangle Shape Field}{\includegraphics[width=0.25\textwidth]{images/WEPS_Run/Region_Panel_Rectangle_Shape.jpg}}%
		\hfill
			\subcaptionbox{Circle Shape Field}{\includegraphics[width=0.24\textwidth]{images/WEPS_Run/Region_Panel_Circle_Shape.jpg}}%
		\hfill
			\subcaptionbox{Quarter Circle Shape Field}{\includegraphics[width=0.26\textwidth]{images/WEPS_Run/Region_Panel_Quarter_Circle_Shape.jpg}}%
		\caption{Example Field Shape displays located below the Region Panel.}
		\label{fig:Region_Panel_Shapes}
	\end{figure}
	\end{minipage}

	\item{Specify the field orientation (±45\textdegree\ max) relative to true north, in the \textit{Orientation} box,
	which the orientation will automatically get depicted in the field display when selected (\cref{fig:Region_Panel_Shapes}).}

	\item{Enter the specific field boundary length(s), field radius, etc.,
	 based upon the field shape selected or specify the field area for the site.}

	\end{enumerate}

\subsection{Selecting Site Location} \label{subsec:Selecting_Site_Location}

Select the field/site location (which also automatically obtains the default Cligen and Windgen weather station selections).

In the panel labeled \textbf{Location}, use the mouse to select
a \textit{Country} (if enabled), \textit{State}
(or other country specific designation)
and \textit{County} (or other local designation)
from the drop down menu \img{images/icons/down_arrow.png} (\cref{fig:State_County_Selection}).

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/State_County_Selection.jpg}
\caption{State/County Location Selection.}
\label{fig:State_County_Selection}
\end{figure}

Coordinates for a location will be automatically selected
near the center (centroid) of the selected County.
This can be visually displayed in the Map Viewer
as shown in \cref{fig:MapViewer_County},
which is accessible by clicking on the Map Viewer button (\cref{fig:State_County_Selection})
currently containing the text "\textit{Please Select Field Location}".
The weather stations, both \textbf{Cligen} and \textbf{Windgen},
for the selected location
will also be automatically determined
and displayed immediately below the elevation field (\cref{fig:State_County_Selection}).
The \textit{Elevation} field itself
will be automatically populated with the value
from the currently selected \textbf{Cligen} station,
which can overridden by the user, if desired.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/MapViewer_County.jpg}
\caption{Map Viewer County centroid display.}
\label{fig:MapViewer_County}
\end{figure}

However, it is desirable to provide the actual field site location for WebStart WEPS, if available.
This is because WebStart WEPS can make PRISM local monthly average temperature adjustments
to the Cligen station data inputs for the Cligen generator,
allowing Cligen to create a more accurate representation of the weather inputs driving the WEPS simulation for the selected site.
In addition, the new CSIP Soil service will also provide the user with a list of the actual soils
present on the field site for the user to select from,
rather than selecting the soil component from the entire county listing of soil components
via the NRCS SoilDataMart service.
Therefore, specifying the actual field site is usually preferred for WebStart WEPS simulations.

If the user knows the site location's lat/long coordinates, they can enter them directly into their respective fields
(\cref{fig:Field_Lat_Lon_Site_Selection})\footnote{Note that the Map Viewer button changes its text to "\textit{Field Location Selected}"
to inform the user that they have now specified a specific field site location}.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/Field_Lat_Lon_Site_Selection.jpg}
\caption{Field Lat/Long coordinates site selection.}
\label{fig:Field_Lat_Lon_Site_Selection}
\end{figure}

If not, the user can use the \textbf{MapViewer} to select the location from a satellite map image,
which will provide the lat/long coordinates of the field site directly (\cref{fig:MapViewer_Site_Selection}).

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/Field_Site_Selection.jpg}
\caption{Map Viewer County displaying site selection.}
\label{fig:MapViewer_Site_Selection}
\end{figure}

\subsection{Selecting Soil Component} \label{subsec:Selecting_Soil_Component}

In the bottom panel of the window,
to the far right of the button labeled \textbf{Soil},
use the mouse to select a soil
from the drop down menu \img{images/icons/down_arrow.png}.
To see and select a soil that exists on the field site,
use the \textit{CSIP Soil Service} option
as shown in \cref{fig:CSIP_Soil_Selection}.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/CSIP_Soil_Selection.jpg}
\caption{Soil dropdown choice list displaying CSIP soil component selection.}
\label{fig:CSIP_Soil_Selection}
\end{figure}

\subsection{Selecting Management/Crop Rotation Scenario} \label{subsec:Selecting_Management_Crop_Rotation_Scenario}

In the bottom panel of the window, to the far right of the button labeled \textbf{Man},
use the mouse to select a management/crop rotation
from the drop down menu \img{images/icons/down_arrow.png}.
If one uses the \textit{CRLMOD Managements} templates
(as shown in \cref{fig:CMZ_Management_Selection})
which are subdivided by NRCS CMZ (Crop Management Zones),
be aware that these rotations are generic and very likely
will require editing for most uses.
They also do not contain irrigation operations,
so if the rotation is to be used in an irrigated site,
irrigation operation(s) must be added.
Click on the \textbf{Man} button to open
\textbf{MCREW} (Management/Crop Rotation Editor for WEPS)
to review and modify the selected management/crop rotation as necessary.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/CMZ_Management_Selection.jpg}
\caption{Management dropdown choice list displaying a CMZ management template selection.}
\label{fig:CMZ_Management_Selection}
\end{figure}

\section{Making a Standard WEPS Run} \label{sec:Making_a_Standard_WEPS_Run}
Once the desired information discussed above is entered through the interface screen, a simulation run can be initiated.
Clicking on the \textbf{\ul{R}un} menu, then selecting \textbf{\ul{M}ake a WEPS Run}
(Figure~\ref{fig:Run_Menu}),
begins a WEPS simulation run.
One can also click the run button
\scalerel*{\img{images/icons/run_button.png}}{\strut}
on the button bar
or use the keyboard shortcut key by pressing the \textbf{Ctrl-R} keys simultaneously to begin the process of executing a WEPS simulation run.
Once the simulation begins, you will then see indicators (popup window displaying progress of the simulation) that WEPS is running.
When the simulation run is finished, the \textbf{Run Summary} report
will automatically appear on the computer screen. 

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/Run_menu.jpg}
\caption{The \ul{R}un menu on the main WEPS screen.}
\label{fig:Run_Menu}
\end{figure}

After initiating a WEPS Run, the “WEPS Run Name” window will appear
(Figure~\ref{fig:WEPS_Run_Name_Window}),
allowing the user to edit the default WEPS Run folder name displayed in the first (top) field labeled \textbf{Run Name}.
Note that some special characters are not allowed in file names\footnote{
Known characters that are not allowed include:
\textbf{: \& "  ` * ?} \boldsymbol{${<}$ ${>}$  ${|}$ $\backslash$}}.
Note also that the WEPS Run Name is actually a folder that will automatically get a ".wpj" extension appended to it, if not provided.
 
The user also has the option to change the default \textbf{WEPS Run} location
in the middle (center) field labeled \textbf{Run Location}.
If the user does not remember the exact path they desire the WEPS Run to be placed in,
they can use the folder icon
\scalerel*{\img{images/icons/folder.png}}{\strut}
on the right side of the field to bring up a file chooser to select the WEPS Run directory location for this WEPS Run.
The complete WEPS Run folder name and path are displayed in the third (bottom) \textbf{Run File} read-only field.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/WEPS_Run_Name.jpg}
\caption{WEPS Run Name window.}
\label{fig:WEPS_Run_Name_Window}
\end{figure}

When a Run name folder has been entered and the used selects the \textbf{OK} button,
the simulation begins and a window appears that shows the status and progress of the WEPS Run
(Figure~\ref{fig:WEPS_Run_Status_Window}).
At the conclusion of the run, a window may appear, 
if warranted, displaying any warnings that have been generated.
These warnings are for informational purposes and may or may not be of interest to the user.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/runboxNew.jpg}
\caption{WEPS Run status window.}
\label{fig:WEPS_Run_Status_Window}
\end{figure}

Upon completion of the WEPS Run, a WEPS Run Summary report will appear for the user to review and print if desired.
The Run Summary report
(Figure~\ref{fig:WEPS_Run_Summary_Report})
is saved in the WEPS Run folder,
along with other more detailed output reports for later retrieval.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/Summary_Report.jpg}
\caption{WEPS Run Summary Report.}
\label{fig:WEPS_Run_Summary_Report}
\end{figure}

The summary and detailed reports for a WEPS Run can be viewed or created any time by the user.
See the following chapters in this document,
\nameref{ch:\ViewingWEPSOutputReports}
and \nameref{ch:\ViewTabDetReports} for more detailed descriptions
of the WEPS report types and how to select them for viewing or printing.

If a crop does not reach maturity, a warning will appear
(Figure~\ref{fig:Growth_Maturity_Warning_Message}),
indicating that the crop only reached the specified percent of the expected maturity for a given year.
This warning can result from one of three causes.
First, the crop variety chosen has a growing season too short
for the climate being simulated with the specified planting and harvesting dates.
For example, a 120-day corn variety may be specified for a location that usually grows 110-day corn.
In this case, a variety that matures over a longer period for that location should be chosen.
If a variety of suitable length is not available in the crop drill-down list,
a new variety can be created by following the method outlined in the
\hl{WEPS How To Guide: Crop Database Record Development}.
Another cause of this warning may be that the growing season is too short based upon the
specified planting and harvesting dates for the location's climate, not allowing the crop enough days to reach maturity.
In this case, be sure the planting and harvesting dates are correct and adjust accordingly.
If a crop is typically harvested before it reaches full maturity (e.g., for alfalfa or silage),
this warning message will also appear, but can be ignored in this situation.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/Ex7-runwarnings.jpg}
\caption{Crop growth/maturity warning message pop-up window.}
\label{fig:Growth_Maturity_Warning_Message}
\end{figure}

\section{Make a Yield Calibration WEPS Run} \label{sec:Make_Yield_Calibration_WEPS_Run}

Differences in crop management by producers or local climate and soil variances may result in crop yields,
generated by WEPS,
that do not reflect the actual yields observed by a producer.
WEPS provides a method to “calibrate” yields and associated crop residue biomass from WEPS,
so that they more accurately reflect those of individual producers or a county as a whole.
Default values are specified to reduce the need for user input, but the WEPS user must inspect/set
specific parameters to their desired values, if necessary.
The following steps describe how, to make a yield calibration run.

\begin{itemize}
\item{Within MCREW, press the \textbf{Yield Calibrate} button
\scalerel*{\img{images/icons/yCalOff.png}}{\strut}
to display additional columns related to the crop-yield calibration function in WEPS
(Figure~\ref{fig:MCREW_Calib}).
Resize and/or scroll horizontally as necessary the MCREW window to view the additional columns.
}

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/MCREW_Calib.jpg}
\caption{MCREW window with Yield Calibration display enabled.}
\label{fig:MCREW_Calib}
\end{figure}

\item{Within MCREW, select the crop (or crops) that you want to calibrate by checking the box
in the \textbf{Select Yield for Calib.} column of the respective row for the crop planting operation
(see \inlinebox[colframe=red]{red} framed boxes as shown in Figure~\ref{fig:MCREW_Calib}).
}

\item{Fill in the desired \textbf{Harvest Target Yield} value for the selected crop(s)
(shown with \inlinebox[colframe=green]{green} boxed regions in Figure~\ref{fig:MCREW_Calib}).
The yield units are displayed but not editable within MCREW.
}

%Move the following information into a new section/chapter where this can be described in detail - LEW
%The units may be changed in the Crop Drill-down window
%under the "Harvest" tab and the \textbf{Harvest yield conversion factor} must be adjusted to reflect the new units.
%Note that changing the water content requires changing the columns labeled “Yield Coef.” and “Residue Intercept”
%because all three parameters are interrelated.
%See the \hl{Crop How To Guide} for more information on these parameters.

\item{Within MCREW, select the harvest operation(s) for the crop (or crops) that you want to calibrate
by checking the box in the \textbf{Select Harvest for Calib.} column
for the respective row each crop harvesting operation is in
(\inlinebox[colframe=blue]{blue} boxed regions in Figure~\ref{fig:MCREW_Calib}).
}

\item{Save the rotation management file in MCREW. This currently can be done by:
i) pressing the \textbf{\ul{S}ave} icon \scalerel*{\img{images/icons/save.png}}{\strut},
ii) selecting the \textbf{\ul{F}ile} menu's \textbf{\ul{S}ave} sub-menu option,
iii) using the \textbf{Ctrl-S} keyboard shortcut,
or
iv) by clicking the \textbf{Save and Close} button \scalerel*{\img{images/icons/close.png}}{\strut},
which saves the displayed data to the current file name and also closes MCREW.}

\item{Optionally exit MCREW. This can be done either by:
i) clicking on the operating system’s \textbf{Close Window} button
\scalerel*{\img{images/icons/closeNew.jpg}}{\strut}
in the top right corner of the MCREW window frame
or
ii) selecting the \textbf{\ul{F}ile} menu's \textbf{E\ul{x}it} sub-menu option.
Note that if one forgets to save the management file before attempting to exit MCREW,
the user will be notified and given the opportunity to do so before exiting MCREW.}

\item{Click the \textbf{Make a Yield Calibration WEPS Run} sub-menu option from the \textbf{Run} menu bar option
on the main screen
(Figure~\ref{fig:Run_Menu})
or the \textbf{Calibrate Run} button \scalerel*{\img{images/icons/calibraterun.png}}{\strut}
on the main screen button bar.
The shortcut \textbf{Ctrl-C} will also work if the main WEPS screen has focus.
All of these methods will bring up the following \textbf{WEPS Run Name} file chooser window
(Figure~\ref{fig:WEPS_Yield_Calibration_Run_Name_window}).
This file chooser window will automatically append \textbf{\_calib} to the WEPS Run file name by default.
}

\end{itemize}

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/run_calib_name.jpg}
\caption{WEPS Yield Calibration Run Name window.}
\label{fig:WEPS_Yield_Calibration_Run_Name_window}
\end{figure}

\begin{itemize}
\item{After the Calibration Run has completed, a pop-up dialog window
(Figure~\ref{fig:WEPS_Run_Calibration_Factors_window})
will appear that displays the \textbf{‘Calibration Factors’}
for each crop selected for calibration (see figure to the left).
One may then save each crop record as a new crop by clicking
the “Save As” \includegraphics[scale=.8]{images/icons/saveas.png} button for each crop.
These calibrated crop records are usually saved in the "local" \textbf{crops}  folder.
The user may also select the new management file which contains the newly calibrated crop records
to be loaded into WEPS for subsequent use.
The string "\_CALIB" will be appended to the original management file name to identify it
as now containing calibrated crop records.
This can be done by clicking on the 
\textbf{Use in Current Project} button at the bottom of the window (Figure~\ref{fig:WEPS_Run_Calibration_Factors_window}).
The new biomass adjustment factor determined for each crop is also written into the ‘notes’ file for the calibration run
as well as the "notes" section of the new "calibrated" management file.
}
\end{itemize}

Note that users should use a typical management practice rotation for the region the site is located
which will produce the long term average yields being set for crop calibration purposes.
Once the crop(s) are calibrated, the user should use the calibrated crop records for future
simulation for alternative management scenarios.
This ensures that the crop yields will respond correctly to different management practices that provide
more or less available soil water for plant growth.
Re-calibrating the crops for each management scenario will defeat that capability in WEPS
and in some situations dramatically affect predicted wind erosion frequency and levels of soil loss.

\begin{figure}[H]
\centering
	\includegraphics[scale=1.75]{images/WEPS_Run/calibNew.jpg}
\caption{WEPS Run Calibration Factors window.}
\label{fig:WEPS_Run_Calibration_Factors_window}
\end{figure}

\section{Restore a WEPS Run} \label{sec:Restore_a_WEPS_Run}

A previously created WEPS run can be restored by clicking on the \textbf{\ul{R}un} menu
and selecting \textbf{\ul{R}estore a WEPS Run}.
This will open a file chooser that allows the user to select a previously created WEPS run.
One can also click the restore button \scalerel*{\img{images/icons/rerun.png}}{\strut}
to restore a WEPS Run.
\textbf{Restoring a WEPS Run} actually loads the inputs of the previous WEPS Run into the WEPS interface.
These inputs can be modified and a new simulation run again with a new WEPS Run name.
The new WEPS Run will be saved into a new folder. Previous WEPS Runs cannot be overwritten.
Runs can be removed via the \textbf{Project} menu's \textbf{Delete Run} sub-menu option.
It is recommended that the user remove unwanted WEPS Runs regularly to prevent these directories
and their contents from taking up too much storage space.

\end{document}