Model:TUGS: Difference between revisions

From CSDMS
m removed old questionnaire information. Replaced with form
No edit summary
Line 9: Line 9:
|State=California
|State=California
|Country=USA
|Country=USA
|Email address=yantao@stillwatersci.com  
|Email address=yantao@stillwatersci.com
|Phone=510-848-8098 x120
|Phone=510-848-8098 x120
|Fax=510-848-8398
|Fax=510-848-8398
Line 17: Line 17:
|Categories=Terrestrial
|Categories=Terrestrial
|Spatial dimensions=1D
|Spatial dimensions=1D
|One-line model description=Fluvial gravel and sand transport model  
|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.  
|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.
}}
}}
{{Model technical information
{{Model technical information
Line 24: Line 24:
|Other platform=Can be compiled to other systems
|Other platform=Can be compiled to other systems
|Programming language=Fortran77, Fortran90
|Programming language=Fortran77, Fortran90
|Other program language=in Excel for input/output manipulation  
|Other program language=in Excel for input/output manipulation
|Code optimized=Single Processor
|Code optimized=Single Processor
|Start year development=2006
|Start year development=2006
|Does model development still take place?=No
|Does model development still take place?=No
|End year development=2008
|End year development=2008
|Model availability=As teaching tool
|Model availability=As code, As teaching tool
|Source code availability=Through owner
|Program license type=Other
|Program license type=Other
|Program license type other=Propritary code
|Program license type other=Propritary code
Line 35: Line 36:
|CCA component=No not possible
|CCA component=No not possible
|IRF interface=No not possible
|IRF interface=No not possible
|Memory requirements=Depending on node,number of sizes and number of layers information has to be stored  
|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  
|Typical run time=Hours to hundredes of years, but typically annual output
}}
}}
{{Input - Output description
{{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.  
|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
|Input format=ASCII
|Other input format=A Excel-VBA workbook is available for input data processing and simple error checking  
|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.  
|Describe output parameters=Time variation of longitudinal profile, sediment flux and grain size distributions of bedload, surface and subsurface sediment.
|Output format=ASCII
|Output format=ASCII
|Other output format=Output results must be processed with a Excel-VBA workbook  
|Other output format=Output results must be processed with a Excel-VBA workbook
|Pre-processing software needed?=No
|Pre-processing software needed?=No
|Post-processing software needed?=Yes
|Post-processing software needed?=Yes
|Describe post-processing software=A Excel-VBA workbook is available to extract the output files into various Excel worksheets.  
|Describe post-processing software=A Excel-VBA workbook is available to extract the output files into various Excel worksheets.
|Visualization software needed?=No
|Visualization software needed?=No
}}
}}
{{Process description model
{{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 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 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 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 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 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
{{Model testing
|Describe available calibration data sets=See two papers:
|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.  
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.
|Describe available test data sets=St. Anthony Falls Laboratory downstream fining experiments (Rebecca Soileau, Chris Paola and Gary Parker)  
|Describe available test data sets=St. Anthony Falls Laboratory downstream fining experiments (Rebecca Soileau, Chris Paola and Gary Parker)
|Describe ideal data for testing=--
|Describe ideal data for testing=--
}}
}}
{{Users groups model
{{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.  
|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
{{Documentation model

Revision as of 14:36, 9 November 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 code, As teaching tool
Source code availability
(Or provide future intension)
Through owner"Through owner" is not in the list (Through web repository, Through CSDMS repository) of allowed values for the "Source code availability" property.
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