View source for Tutorials:9 Long-Term Simulations

'''This tutorial is compatible with:'''
* '''WMS Version 8.1 and later'''
* '''GSSHA Version 3.0b and later'''<br><br>
<font color= "red">'''Disclaimer: GSSHA tutorial exercises do not represent real world conditions'''<br></font>

__NOTOC__
Long-term simulations typically involve running several rainfall events along with the evapotranspiration model for weeks to months. There are two key parts to running a long-term simulation. The first is to set up the precipitation file, and the second is to set up the evapotranspiration model with its hydrometeorological (hmet for short) data.

==Precipitation==

A long-term event typically consists of multiple rainfall events, often with several rain gages. Multiple gage events can either be setup using WMS or using a handy Microsoft® Excel® spreadsheet. If you are only passingly familiar with Microsoft® Excel® it is recommended that you read Chapter 10, “Using Microsoft® Excel® to format GSSHA™ Data” first.

We will start by using a Microsoft® Excel® spreadsheet to set up a multiple-event, single gage precipitation file from some raw data.

===Using the Format Precip Macro===

<ol>
	<li>Navigate to the "Formatting Macros" folder.</li>
	<li>Open the Excel® file “format_precip_macro.xls” and enable macros, if prompted.</li>
	<li>Click on the worksheet titled “input_data”.</li>
	<li>Select columns “A” through “F”.</li>
	<li>Right-click on the columns and select “Format Cells…”</li>
	<li>In the “Format Cells” pop-up window select “Text” in the box below the word “Category”.</li>
	<li>Click “OK”.</li>
	<li>Use Notepad to open the file “precip_raw.txt”, located in the Precip_data folder.</li>
	<li>Select and copy the entire text file.</li>
	<li>Select cell “A1” on the input_data worksheet, then right-click and pick “Paste”</li>
	<li>Set up the data to match the format outlined on the “Instructions” worksheet of the spreadsheet (for help look at the instructions, or refer to Chapter 10 Using Microsoft® Excel® to format GSSHA™ Data.</li>
	<li>Follow the steps on the “Instruction” worksheet. (Use the default values. The coordinate for the gage is found in the Precip_formatted.txt file.)</li>
	<li>Once you have setup the data, click on the “Format precip data” button found on the “Instructions” worksheet”.</li>
	<li>Your formatted data is on the “Output_data” worksheet.</li>
</ol>

==Hydrometeorological Data==

Hydrometeorological data is used in GSSHA™ to determine how the soil moisture is
affected by atmospheric conditions. The hydrometeorlogical data is used to drive the
evapotranspiration model. In the following exercise we will create a file that contains all
the hydrometeorological data for the same period as the precipitation data.

===Using the Format Hmet Macro===

<ol>
	<li>Open the Excel® file “Format_Hmet_macro.xls” from the Formatting_macros folder, and enable macros if prompted.</li>
	<li>Select the “Instructions” worksheet to learn how the data should be organized before it can be formatted for GSSHA™.</li>
	<li>To retrieve the raw data, open the Hmet raw data file called “Hmet_raw.xls” in the Hmet_data folder.</li>
	<li>Select the “KBLV_Scott worksheet and copy the appropriate columns of raw data to the “input_data1” worksheet of the format Hmet data macro.</li>
	<li>Select the worksheet “scott_radiation_2001” of the raw data file, and then copy the appropriate columns to the “input_data2” worksheet of the format Hmet data macro.</li>
	<li>Make sure that the “input_data1” and “input_data2” worksheets are organized as outlined on the “Instructions” worksheet, and then click the “Format Hmet data” button on the “Instructions” worksheet. (Note that the Instructions indicate that the data should be entered in cell A1. This is an error. The first row of data should be in cell A2.)</li>
	<li>The formatted data will be shown on the “output_data” worksheet.</li>
	<li>Save the “output_data” worksheet as a text file called “hmet.txt” in the folder you created earlier in the precipitation section.</li>
</ol>

==Evapotranspiration==

Now we will go back to WMS and set up the Long-term modeling data. First we need to set up the Job control options to turn on long-term mode.

If you are starting the tutorial from here, open the long_term.prj file found in the Finished Tutorial folder.

<ol>
	<li>Select '''GSSHA™| Job Control…'''</li>
	<li>Check the box next to "Long term simulation" in the GSSHA Job Control Parameters window. </li>
	<li>Click the ''Edit parameter...'' button and enter a value of 38.7696 for “Latitude”.</li>
	<li>Enter a value of 270.05 for “Longitude”.</li>
	<li>For “GMT” enter a value of –6.00.</li>
	<li>Enter 0.10 for “Minimum event discharge”.</li>
	<li>Make the “Soil moisture depth” equal to 0.5.</li>
	<li>Click on the folder icon to next to “HMET Data File” to browse for the Hmet text file you created with the “Format_Hmet_macro” spreadsheet. Navigate to the file and select it.</li>
	<li>Under “Format”, toggle on WES.</li>
	<li>Select OK.</li>
	<li>In the “Evapotranspiration” section of the window toggle “Penman Method”.</li>
	<li>In the Overland Flow Computation method combo box choose “ADE” instead of “Explicit.”</li>
	<li>Select OK.</li><br>
<div class="mleft">
Next we need to set up the ET parameters.
</div><br>
	<li>Select '''GSSHA™ | Map Tables…'''</li>
	<li>Click on the Evapotranspiration tab.</li>
	<li>In the drop down box next to “Using index map” select landuse, then click the “Generate IDs” button.</li>
	<li>Enter the values required for evapotranspiration using the following table, or you can find values from the appendix.</li><br>
{{Tutorials:Table10}}<br>
	<li>Click Done.</li><br>
<div class="mleft">
Next we need to tell WMS to point to our precipitation file.
</div><br>
	<li>Select '''GSSHA™ | Precipitation…'''</li>
	<li>Select ''Gage'' from the drop-down menu.</li>
	<li>Click the ''Import Gage File…'' button.</li>
	<li>Browse to the precipitation file, select it, and hit OK.</li><br>
<div class="mleft">
Since we only have one gage, the rainfall data is spread out uniformly over the watershed. If we had more that one gage we would pick either Theissen Polygons or Inverse Distance weighted here in this dialog.
</div><br>
	<li>Select Ok.</li><br>
<div class="mleft">
We are ready to run now, but first we will want to change some output options. We will not want to output the data sets so frequently.
</div><br>
	<li>Select '''GSSHA™ | Job Control...'''</li>
        <li>Click on the Output Control... button.</li>
	<li>In the Write frequency section of the dialog, change the Write Frequency to 60 (minutes).</li>
	<li>Select OK, OK.</li><br>
<div class="mleft">
You are now ready to run a long-term simulation. Save the project, then run GSSHA™.  This simulation may take some time to run to completion, and will run faster by selecting the Suppress screen printing option in the GSSHA Run Options dialog. You may view the simulation output by clicking the ''Abort'' button, selecting '''GSSHA | Read Solution''' and opening the sol_long_term.prj from the ''long_term_sol'' folder in the Finished_Tutorial directory.
</div>
</ol>
<noinclude>
{{TutNav}}
</noinclude>