Model:TUGS: Difference between revisions

From CSDMS
No edit summary
m removed old questionnaire information. Replaced with form
Line 84: Line 84:
<!-- Edit the part above to update info on other papers -->
<!-- Edit the part above to update info on other papers -->


== TUGS ==
==Introduction==
__TOC__


===Introduction===
== History ==


=== History ===
== Papers ==


=== Papers ===
== Issues ==


=== TUGS Questionnaire ===
== Help ==


==== Contact Information ====
== Input Files ==
{| class="wikitable"
| class="model_col1"| Model:
| class="model_col2"| The Unified Gravel-Sand (TUGS) Model
|-
| class="model_col1"| Contact person:
| class="model_col2"| Yantao Cui
|-
| class="model_col1"| Institute:
| class="model_col2"| Stillwater Sciences
|-
| class="model_col1"| City:
| class="model_col2"| Berkeley
|-
| class="model_col1"| Country:
| class="model_col2"| USA
|-
| class="model_col1"| Email:
| class="model_col2"| yantao@stillwatersci.com
|-
| class="model_col1"| 2nd person involved:
| class="model_col2"| --
|-
| class="model_col1"| 3rd person involved:
| class="model_col2"| --
|}


==== Model description ====
== Output Files ==


{| class="wikitable"
== Download ==
| class="model_col1"| Model type:
| class="model_col2"| Single model for the terrestrial domain.
|-
| class="model_col1"| Description:
| class="model_col2"| TUGS is a 1D model that simulates the transport of gravel and sand in rivers.  The model predicts the responses of a channel to changes made to the environment (e.g., sediment supply, hydrology, and certain artifical changes made to the river).  Output of the model include longitudinal profile, sediment flux, and grain size distributions in bedload, channel surface and subsurface.
|}


==== Technical information ====
== Source ==
 
{| class="wikitable"
| class="model_col1"| Supported platforms:
| class="model_col2"| Windows, Can be compiled to other systems
|-
| class="model_col1"| Programming language:
| class="model_col2"|  Fortran77, Fortran90, in Excel for input/output manipulation
|-
| class="model_col1"| Model was developed started from:
| class="model_col2"| 2006. Currently there is no further development
|-
| class="model_col1"| To what degree will the model become available:
| class="model_col2"| The model may potentially be available as a teaching tool
|-
| class="model_col1"| Current license type:
| class="model_col2"| Propritary software
|-
| class="model_col1"| Memory requirements:
| class="model_col2"| Depending on node,number of sizes and number of layers information has to be stored
|-
| class="model_col1"| Typical run time:
| class="model_col2"| Hours to hundredes of years, but typically annual output
|}
 
==== Input / Output description ====
 
{| class="wikitable"
| class="model_col1"| Input parameters:
| class="model_col2"| describe input parameters: Initial longitudinal profile and estimated surface/subsurface grain size; sediment input, including both rate and grain size distribution, and typically at a long-term-avearged basis; and water discharge, typically daily average discharge.
|-
| class="model_col1"| Input format:
| class="model_col2"| ASCII, Other: A Excel-VBA workbook is available for input data processing and simple error checking
|-
| class="model_col1"| Output parameters:
| class="model_col2"| Time variation of longitudinal profile, sediment flux and grain size distributions of bedload, surface and subsurface sediment.   
|-
| class="model_col1"| Output format:
| class="model_col2"| ASCII, Other: Output results must be processed with a Excel-VBA workbook
|-
| class="model_col1"| Post-processing software (if needed):
| class="model_col2"| yes: A Excel-VBA workbook is available to extract the output files into various Excel worksheets.
|-
| class="model_col1"| Visualization software (if needed):
| class="model_col2"| no
|}
 
==== Process description ====
 
{| class="wikitable"
| class="model_col1"| Processes represented by model:
| class="model_col2"| The two key elements of TUGS model are a surface-based bedload transport equation that allows for calculation of transport rate and grain size distribution of both gravel and sand (Wilcoco and Crowe 2003), and functions that link bedload grain size distributions with surface and subsurface grain size distributions (Hoey and Ferguson 1994; Toro-Escobar et al. 1996; Cui 2007a).
|-
| class="model_col1"| Key physical parameters & equations:
| class="model_col2"| See Cui (2007a) for detail: [http://dx.doi.org/10.1029/2006WR005330 http://dx.doi.org/10.1029/2006WR005330]
|-
| class="model_col1"| Length scale & resolution constraints:
| class="model_col2"| Length varies, resolution is on the order of several channel width (i.e., 1D model produces only reach-averaged results).
|-
| class="model_col1"| Time scale & resolution constraints:
| class="model_col2"| For typical application in a natural river as a prediction tool, the recommended resolution is annual, although it can be as high as hours for simulation of a specific known event.
|-
| class="model_col1"| Numerical limitations and issues :
| class="model_col2"| TUGS was developed with a fairly low budget, and thus, bugs may still exist.  There are, however, no known numerical limitations at this point.
|}
 
==== Testing ====
 
{| class="wikitable"
| class="model_col1"| Available calibration data sets:
| class="model_col2"| See two papers:
Cui (2007a) [http://dx.doi.org/10.1029/2006WR005330 http://dx.doi.org/10.1029/2006WR005330]
Cui (2007b) [http://dx.doi.org/10.1002/rra.1012 http://dx.doi.org/10.1002/rra.1012]
A manuscript with regard to its application to the Waipaoa River, NZ is currently underway by Basil Gomez and others.
|-
| class="model_col1"| Available test data sets:
| class="model_col2"| St. Anthony Falls Laboratory downstream fining experiments (Rebecca Soileau, Chris Paola and Gary Parker)
|-
| class="model_col1"| Ideal data for testing:
| class="model_col2"| --
|}
 
==== User groups ====
 
{| class="wikitable"
| class="model_col1"| Currently or plans for collaborating with:
| class="model_col2"| Collaboration is always welcomed. The developer, however, does not have any funding to cover such activities.  So it may take a fairly long time to finish a modeling exercise if it is done in his spare time.
|}
 
==== Documentation ====
 
{| class="wikitable"
| class="model_col1"| Key papers of the model:
| class="model_col2"| Cui (2007a) [http://dx.doi.org/10.1029/2006WR005330 http://dx.doi.org/10.1029/2006WR005330]<br>Cui (2007b) [http://dx.doi.org/10.1002/rra.1012 http://dx.doi.org/10.1002/rra.1012]
|-
| class="model_col1"| Is there a manual available:
| class="model_col2"| No
|-
| class="model_col1"| Model website if any:
| class="model_col2"| --
|}
 
==== Additional comments ====
 
{| class="wikitable"
| class="model_col1"| Comments:
| class="model_col2"| --
|}
 
 
=== Issues ===
 
=== Help ===
 
=== Input Files ===
 
=== Output Files ===
 
=== Download ===
 
=== Source ===






[[Category:Terrestrial]]
[[Category:Terrestrial]]

Revision as of 17:11, 25 September 2009

Contact

Name Yantao Cui
Type of contact Model developer
Institute / Organization Stillwater Sciences
Postal address 1 2855 Telegraph Ave. Suite 400
Postal address 2
Town / City Berkeley
Postal code 94705
State California
Country USA"USA" is not in the list (Afghanistan, Albania, Algeria, Andorra, Angola, Antigua and Barbuda, Argentina, Armenia, Australia, Austria, ...) of allowed values for the "Country" property.
Email address yantao@stillwatersci.com
Phone 510-848-8098 x120
Fax 510-848-8398



TUGS


Metadata

Summary

Also known as
Model type Single
Model part of larger framework
Note on status model
Date note status model

Technical specs

Supported platforms
Windows
Other platform Can be compiled to other systems
Programming language

Fortran77, Fortran90

Other program language in Excel for input/output manipulation
Code optimized Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development 2006
Does model development still take place? No
If above answer is no, provide end year model development 2008
Code development status
When did you indicate the 'code development status'?
Model availability As teaching tool
Source code availability
(Or provide future intension)
Source web address
Source csdms web address
Program license type Other
Program license type other Propritary code
Memory requirements Depending on node,number of sizes and number of layers information has to be stored
Typical run time Hours to hundredes of years, but typically annual output


In/Output

Describe input parameters describe input parameters: Initial longitudinal profile and estimated surface/subsurface grain size; sediment input, including both rate and grain size distribution, and typically at a long-term-avearged basis; and water discharge, typically daily average discharge.
Input format ASCII
Other input format A Excel-VBA workbook is available for input data processing and simple error checking
Describe output parameters Time variation of longitudinal profile, sediment flux and grain size distributions of bedload, surface and subsurface sediment.
Output format ASCII
Other output format Output results must be processed with a Excel-VBA workbook
Pre-processing software needed? No
Describe pre-processing software
Post-processing software needed? Yes
Describe post-processing software A Excel-VBA workbook is available to extract the output files into various Excel worksheets.
Visualization software needed? No
If above answer is yes
Other visualization software


Process

Describe processes represented by the model The two key elements of TUGS model are a surface-based bedload transport equation that allows for calculation of transport rate and grain size distribution of both gravel and sand (Wilcoco and Crowe 2003), and functions that link bedload grain size distributions with surface and subsurface grain size distributions (Hoey and Ferguson 1994; Toro-Escobar et al. 1996; Cui 2007a).
Describe key physical parameters and equations See Cui (2007a) for detail: http://dx.doi.org/10.1029/2006WR005330
Describe length scale and resolution constraints Length varies, resolution is on the order of several channel width (i.e., 1D model produces only reach-averaged results).
Describe time scale and resolution constraints For typical application in a natural river as a prediction tool, the recommended resolution is annual, although it can be as high as hours for simulation of a specific known event.
Describe any numerical limitations and issues TUGS was developed with a fairly low budget, and thus, bugs may still exist. There are, however, no known numerical limitations at this point.


Testing

Describe available calibration data sets See two papers:

Cui (2007a) http://dx.doi.org/10.1029/2006WR005330 Cui (2007b) http://dx.doi.org/10.1002/rra.1012 A manuscript with regard to its application to the Waipaoa River, NZ is currently underway by Basil Gomez and others.

Upload calibration data sets if available:
Describe available test data sets St. Anthony Falls Laboratory downstream fining experiments (Rebecca Soileau, Chris Paola and Gary Parker)
Upload test data sets if available:
Describe ideal data for testing --


Other

Do you have current or future plans for collaborating with other researchers? Collaboration is always welcomed. The developer, however, does not have any funding to cover such activities. So it may take a fairly long time to finish a modeling exercise if it is done in his spare time.
Is there a manual available? No
Upload manual if available:
Model website if any
Model forum / discussion board
Comments --


Introduction

History

Papers

Issues

Help

Input Files

Output Files

Download

Source