Model:TUGS: Difference between revisions

From CSDMS
m (add model)
 
m (Text replacement - "{{End headertab}}" to "{{End headertab}} {{{{PAGENAME}}_autokeywords}}")
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Infobox Model
{{Model identity
|model name              = TUGS
|Model type=Single
|developer                = '''Cui''', Yantao
|one-line-description    = Fluvial gravel and sand transport model 
|type                     = Model
|source                  = [[image:Red1.png]]
}}
}}
<!-- Edit the part above to update info on other papers -->
{{Model identity2
|ModelDomain=Terrestrial
|Spatial dimensions=1D
|One-line model description=Fluvial gravel and sand transport model
|Extended model description=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.
}}
{{Start model keyword table}}
{{Model keywords
|Model keywords=river
}}
{{Model keywords
|Model keywords=sediment dynamics
}}
{{End a table}}
{{Modeler information
|First name=Yantao
|Last name=Cui
|Type of contact=Model developer
|Institute / Organization=Stillwater Sciences
|Postal address 1=2855 Telegraph Ave. Suite 400
|Town / City=Berkeley
|Postal code=94705
|State=California
|Country=United States
|Email address=yantao@stillwatersci.com
|Phone=510-848-8098 x120
|Fax=510-848-8398
}}
{{Model technical information
|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
|Start year development=2006
|Does model development still take place?=No
|End year development=2008
|Model availability=As code, As teaching tool
|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
}}
{{Input - Output description
|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
|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
}}
{{Process description model
|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.
}}
{{Model testing
|Describe available calibration data sets=See two papers:


== TUGS ==
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.
__TOC__
|Describe available test data sets=St. Anthony Falls Laboratory downstream fining experiments (Rebecca Soileau, Chris Paola and Gary Parker)
|Describe ideal data for testing=
}}
{{Users groups model
|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.
}}
{{Documentation model
|Provide key papers on model if any=Key Papers:
*'''Cui Y. T., 2007a. The Unified Gravel-Sand (TUGS) Model: Simulating Sediment Transport and Gravel/Sand Grain Size Distributions in Gravel-Bedded Rivers. Water Resources Research, 43, W10436, Doi: ([http://dx.doi.org/10.1029/2006WR005330 10.1029/2006WR005330]).'''


===Introduction===
*'''Cui, Y. T., 2007b. Examining the dynamics of grain size distributions of gravel/sand deposits in the Sandy River, Oregon with a numerical model. River Research and Applications, 23(7): 732~751, Doi: ([http://dx.doi.org/10.1002/rra.1012 10.1002/rra.1012]).'''


=== History ===
*'''Toro-Escobar, C. M., Parker, G., Paola, C., 1996. Transfer function for the deposition of poorly sorted gravel in response to streambed aggradation. Journal of Hydraulic Research, 34(1): 35~53.'''
 
|Manual model available=No
=== Papers ===
}}
 
{{Additional comments model
=== TUGS Questionnaire ===
|Comments=--
 
}}
==== Contact Information ====
{{CSDMS staff part
{| class="wikitable"
|OpenMI compliant=No but possible
| class="model_col1"| Model:
|CCA component=No but possible
| class="model_col2"| The Unified Gravel-Sand (TUGS) Model
|IRF interface=No but possible
|-
|CMT component=No but possible
| class="model_col1"| Contact person:
}}
| class="model_col2"| Yantao Cui
{{Start coupled table}}
|-
{{End a table}}
| class="model_col1"| Institute:
{{End headertab}}
| class="model_col2"| Stillwater Sciences
{{{{PAGENAME}}_autokeywords}}
|-
{{NOINDEX}}
| class="model_col1"| City:
<!-- Edit the part above to update info on other papers -->
| 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 ====
 
{| class="wikitable"
| 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 ====
 
{| 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 ===
==Introduction==


=== Input Files ===
== History ==


=== Output Files ===
== References  ==
<br>{{AddReferenceUploadButtons}}<br><br>
{{#ifexist:Template:{{PAGENAME}}-citation-indices|{{{{PAGENAME}}-citation-indices}}|}}<br>
{{Include_featured_references_models_cargo}}<br>


=== Download ===
== Issues ==


=== Source ===
== Help ==
{{#ifexist:Model_help:{{PAGENAME}}|[[Model_help:{{PAGENAME}}]]|}}


== Input Files ==


== Output Files ==


[[Category:Terrestrial]]
[[Category:Source code not available]]

Latest revision as of 20:15, 16 September 2020



TUGS [edit]


Metadata[edit]

Also known as
Model type Single
Model part of larger framework
Note on status model
Date note status model
Spatial dimensions 1D
Spatial extent
Model domain Terrestrial
One-line model description Fluvial gravel and sand transport model
Extended model description 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.
Keywords:

river, sediment dynamics,

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 United States
Email address yantao@stillwatersci.com
Phone 510-848-8098 x120
Fax 510-848-8398


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 code, 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


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


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.


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


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


This part will be filled out by CSDMS staff

OpenMI compliant No but possible
BMI compliant No but possible
WMT component No but possible
PyMT component
Is this a data component
Can be coupled with:
Model info
Yantao Cui
Nr. of publications: --
Total citations: 0
h-index: --"--" is not a number.
m-quotient: 0

Link to this page

Template:TUGS autokeywords


Introduction[edit]

History[edit]

References[edit]




Nr. of publications: --
Total citations: 0
h-index: --"--" is not a number.
m-quotient: 0


See more publications of TUGS

Issues[edit]

Help[edit]

Input Files[edit]

Output Files[edit]