User:Jcreer/SWB: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOINDEX__
__NOINDEX__
{{Version GMS 10.4}}
{{Future feature}}
The Soil-Water-Balance (SWB) model has been developed by USGS to allow estimates of potential recharge to be made quickly and easily.  
The Soil-Water-Balance (SWB) model has been developed by USGS to allow estimates of potential recharge to be made quickly and easily.  


Line 9: Line 9:
*Available soil-water capacity
*Available soil-water capacity
*Surface-water flow direction
*Surface-water flow direction
In addition to gridded land-surface data the model requires tabular daily climatological data (daily precip (inches), average air temperature [F], max air temp [F], min air temp [F]). Additional data may be required depending on model options: (1) daily average wind speed (m/s), (2) daily average relative humidity (%), (3) daily max relative humidity (%), (4) daily percentage of possible sunshine (%). Finally a lookup table must be supplied to assign curve numbers, interception values, rooting depths, and maximum daily recharge values.
In addition to gridded land-surface data the model requires tabular daily climatological data (daily precip (inches), average air temperature [F], max air temp [F], min air temp [F]). Additional data may be required depending on model options:
# daily average wind speed (m/s),  
# daily average relative humidity (%),  
# daily max relative humidity (%),  
# daily percentage of possible sunshine (%).  
Finally a lookup table must be supplied to assign curve numbers, interception values, rooting depths, and maximum daily recharge values.


==Creating an SWB Simulation==
==Creating an SWB Simulation==
To create an SWB simulation, do the following:
To create an SWB simulation, do the following:
# Right-click on the "[[File:Project Icon.svg|15 px]] Project" item the Project Explorer and select ''New Simulation'' | '''SWB'''.
# Right-click on the "[[File:Project Icon.svg|15 px]] Project" item the Project Explorer and select ''New Simulation'' | '''SWB'''.
A new "Simulation Data" [[File:Simulation Data Icon.svg|16 px]] item will appear in the Project Explorer, along with a "SWB Simulations" [[File:Simulation Folder Icon.svg|16 px]] item and a new simulation [[File:Simulation InactiveIcon.svg|16 px]] item. Right-clicking on the "SWB Simulations" [[File:Simulation Folder Icon.svg|16 px]] item also has a '''New Simulation''' command that allows adding additional SWB simulations to the project.


==Simulation Menu==
==Simulation Menu==
Line 26: Line 32:
* '''Save, Export, and Launch SWB''' – Combines several other commands together. First, it saves the project file, then exports files for the model run, and finally launches the SWB model run.  
* '''Save, Export, and Launch SWB''' – Combines several other commands together. First, it saves the project file, then exports files for the model run, and finally launches the SWB model run.  
* '''Properties''' – Opens the ''Properties'' dialog which displays the simulation properties and allows adding notes.
* '''Properties''' – Opens the ''Properties'' dialog which displays the simulation properties and allows adding notes.
 
<!--
==Model Control==
==Model Control==
[[File:SWB ModelControl.png|thumb|340 px|Example of the SWB ''Model Control'' dialog]]
The parameters for the SWB model run are set in the ''Model Control'' dialog.
The parameters for the SWB model run are set in the ''Model Control'' dialog.
===Required Inputs===
===Required Inputs===
Line 82: Line 89:
*''Output Variables'' &ndash; This table allows specifying specific variables for SWB to output as gridded data files.
*''Output Variables'' &ndash; This table allows specifying specific variables for SWB to output as gridded data files.
**''Variable name'' &ndash; This column will allow selecting an SWB variable to output. Options include: rainfall, snow cover, snowfall, continuous frozen ground index, change in snow cover, snow melt, min. temperature, max. temperature, average temperature, interception, net precipitation, inflow, outflow, runoff inside, rejected recharge, net inflow, net infiltration, potential evapotranspiratio, actual evapotranspiration, precipitation minus potential evapostranspiration, soil moisture deficit, soil moisture surplus, accumulated potential water loss, soil moisture, and change in soil moisture.
**''Variable name'' &ndash; This column will allow selecting an SWB variable to output. Options include: rainfall, snow cover, snowfall, continuous frozen ground index, change in snow cover, snow melt, min. temperature, max. temperature, average temperature, interception, net precipitation, inflow, outflow, runoff inside, rejected recharge, net inflow, net infiltration, potential evapotranspiratio, actual evapotranspiration, precipitation minus potential evapostranspiration, soil moisture deficit, soil moisture surplus, accumulated potential water loss, soil moisture, and change in soil moisture.
**Daily output
**''Daily output'' &ndash; Writes output with daily values. Can be set to none, grid, plot, or both.
**Monthly output
**''Monthly output''  &ndash; Writes output with monthly values. Can be set to none, grid, plot, or both.
**Annual output
**''Annual output''  &ndash; Writes output with annual values. Can be set to none, grid, plot, or both.
**''Copy/Paste Mode'' &ndash; This option allows copying that values in the table into a spreadsheet or pasting values from a spreadsheet.
**''Copy/Paste Mode'' &ndash; This option allows copying that values in the table into a spreadsheet or pasting values from a spreadsheet.
**Import
**'''Import''' &ndash; Opens a browser that allows importing a text or CSV file into the table.
**Export
**'''Export''' &ndash; Opens a browser to save out a text or CSV file contain the table values.
**Insert Above
**'''Insert Above''' &ndash; Adds a row in the table above the current selected row.
**Insert Below
**'''Insert Below''' &ndash; Adds a row in the table below the current selected row.
** Delete
** '''Delete''' &ndash; Removes the selected row from the table.
-->
==SWB Output Files==
After running the model, SWB will generate several output files.
*Recharge daily statistics &ndash; Contains the minimum, maximum, and mean values for all major components of the water balance for all grid cells in the model on a given day.
*Recharge daily report &ndash; Contains values representing the individual daily values summed over the entire model multiplied by the conversion factor.
*Recharge annual statistics &ndash; Contains mean values representing the annual sum of daily mean values.
*Log file &ndash; Contains a report of the processes performed during the model run.
*Grid and image files &ndash; Based on the selected optional output variables in the model control.


==External Links==
==External Links==
Line 98: Line 113:


{{Navbox GMS}}
{{Navbox GMS}}
[[Category:Numerical Models]]
[[Category:SWB]]

Latest revision as of 17:08, 4 January 2021

The Soil-Water-Balance (SWB) model has been developed by USGS to allow estimates of potential recharge to be made quickly and easily.

Required Input

Four gridded datasets are required:

  • Hydrologic soil group
  • land use/land cover
  • Available soil-water capacity
  • Surface-water flow direction

In addition to gridded land-surface data the model requires tabular daily climatological data (daily precip (inches), average air temperature [F], max air temp [F], min air temp [F]). Additional data may be required depending on model options:

  1. daily average wind speed (m/s),
  2. daily average relative humidity (%),
  3. daily max relative humidity (%),
  4. daily percentage of possible sunshine (%).

Finally a lookup table must be supplied to assign curve numbers, interception values, rooting depths, and maximum daily recharge values.

Creating an SWB Simulation

To create an SWB simulation, do the following:

  1. Right-click on the "Project Icon.svg Project" item the Project Explorer and select New Simulation | SWB.

A new "Simulation Data" Simulation Data Icon.svg item will appear in the Project Explorer, along with a "SWB Simulations" Simulation Folder Icon.svg item and a new simulation Simulation InactiveIcon.svg item. Right-clicking on the "SWB Simulations" Simulation Folder Icon.svg item also has a New Simulation command that allows adding additional SWB simulations to the project.

Simulation Menu

Right-clicking on the simulation item Simulation InactiveIcon.svg in the Project Explorer will bring up the following menu command:

  • Delete – Removes the simualation item.
  • Duplicate Creates a copy for the simulation, including all parameters set in the model control.
  • Rename – Allows changing the name of the simulation item.
  • Model Control – Opens the Model Control dialog where the model run parameters are set.
  • Model Check – Looks for potential errors in the model setup. Brings up the Model Checker dialog if issues are discovered.
  • Export SWB – Generates files used in the model run.
  • Launch SWB – Starts the SWB model run and opens the Simulation Run Queue dialog.
  • Save, Export, and Launch SWB – Combines several other commands together. First, it saves the project file, then exports files for the model run, and finally launches the SWB model run.
  • Properties – Opens the Properties dialog which displays the simulation properties and allows adding notes.

SWB Output Files

After running the model, SWB will generate several output files.

  • Recharge daily statistics – Contains the minimum, maximum, and mean values for all major components of the water balance for all grid cells in the model on a given day.
  • Recharge daily report – Contains values representing the individual daily values summed over the entire model multiplied by the conversion factor.
  • Recharge annual statistics – Contains mean values representing the annual sum of daily mean values.
  • Log file – Contains a report of the processes performed during the model run.
  • Grid and image files – Based on the selected optional output variables in the model control.

External Links