Model:TopoFlow-Evaporation-Priestley Taylor

TopoFlow-Evaporation-Priestley Taylor

Metadata

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

Incorporated models or components:

Spatial dimensions	2D
Spatial extent	Landscape-Scale, Watershed-Scale
Model domain	Hydrology
One-line model description	Evaporation process component (Priestley-Taylor method) for a D8-based, spatial hydrologic model
Extended model description	This process component is part of a spatially-distributed hydrologic model called TopoFlow, but it can now be used as a stand-alone model.

Keywords:	basins,

Name	Scott Peckham
Type of contact	Model developer
Institute / Organization	CSDMS, INSTAAR, University of Colorado
Postal address 1	1560 30th street
Postal address 2
Town / City	Boulder
Postal code	80305
State	Colorado
Country	United States
Email address	Scott.Peckham@colorado.edu
Phone	303-492-6752
Fax

Supported platforms	Unix, Linux, Mac OS, Windows
Other platform
Programming language	Python
Other program language	None (but uses NumPy package)
Code optimized	Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development	2001
Does model development still take place?	Yes
If above answer is no, provide end year model development
Code development status	Active
When did you indicate the 'code development status'?	2020
Model availability	As code, As teaching tool
Source code availability (Or provide future intension)	Through web repository
Source web address	https://github.com/peckhams/topoflow
Source csdms web address
Program license type	Apache public license
Program license type other
Memory requirements	Standard
Typical run time	Minutes to hours

Describe input parameters	The input variables for the Priestley-Taylor method of estimating losses due to evaporation are defined as follows: Q_SW = net shortwave radiation (W / m^2) Q_LW = net longwave radiation (W / m^2) T_air = air temperature (deg C) T_surf = surface (snow) temperature (deg C) T_soil_x = soil temperature at depth x (deg C) x = reference depth in soil (m) K_soil = thermal conductivity of soil (W / (m deg_C)) α = coefficient (unitless) L_v = latent heat of vaporization, water (J / kg) (2500000) The behavior of this component is controlled with a configuration (CFG) file, which may point to other files that contain input data. Here is a sample configuration (CFG) file for this component: Method code: 0 Method name: Priestley-Taylor Time step: Scalar 3600.00000000 (sec) alpha: Scalar 1.20000000 (none) K_soil: Scalar 0.44999999 (W/m/deg_C) soil_x: Scalar 0.05000000 (m) T_soil_x: Scalar 0.00000000 (deg C) Save grid timestep: Scalar 60.00000000 (sec) Save er grids: 0 Case5_2D-ETrate.rts (m/s) Save pixels timestep: Scalar 60.00000000 (sec) Save er pixels: 0 Case5_0D-ETrate.txt (m/s)
Input format	ASCII, Binary
Other input format
Describe output parameters
Output format	ASCII, Binary
Other output format
Pre-processing software needed?	Yes
Describe pre-processing software	Another program must be used to create the input grids. This includes a D8 flow grid derived from a DEM for the region to be modeled. The earlier, IDL version of TopoFlow can be used to create some of these.
Post-processing software needed?	Yes
Describe post-processing software	None, except visualization software. Grid sequences saved in netCDF files can be viewed as animations and saved as movies using VisIt.
Visualization software needed?	Yes
If above answer is yes
Other visualization software	VisIt

Describe processes represented by the model	Priestley-Taylor method of estimating losses due to evaporation
Describe key physical parameters and equations	Main equations used by this component: ET = (1000 * Q_et) / (ρ_water * L_v) = evaporation rate (mm / sec) Q_et = α * (0.406 + (0.011 * T_air)) * (Q_SW + Q_LW - Q_c) = energy flux used to evaporate water (W / m^2) Q_c = K_soil * (T_soil_x - T_surf) * (100 / x) = conduction energy flux (W / m^2)
Describe length scale and resolution constraints	Recommended grid cell size is around 100 meters, but can be parameterized to run with a wide range of grid cell sizes. DEM grid dimensions are typically less than 1000 columns by 1000 rows.
Describe time scale and resolution constraints	Typical timesteps are on the order of seconds to minutes. Model can be run for a full year or longer, if necessary.
Describe any numerical limitations and issues	This model/component needs more rigorous testing.

Describe available calibration data sets	This model/component is typically not calibrated to fit data, but is run with a best guess or measured value for each input parameter.
Upload calibration data sets if available:
Describe available test data sets	Available test data sets: Treynor watershed, in the Nishnabotna River basin, Iowa, USA. (Two large rainfall events.) Small basin in Kentucky. Inclined plane for testing. Arctic watershed data from Larry Hinzman (UAF). See /data/progs/topoflow/3.0/data on CSDMS cluster.
Upload test data sets if available:
Describe ideal data for testing	Several test datasets are stored on the CSDMS cluster at: /data/progs/topoflow/3.0/data.

Do you have current or future plans for collaborating with other researchers?	Collaborators include: Larry Hinzman (UAF), Bob Bolton, Anna Liljedahl (UAF), Stefan Pohl, Tom Over and others

Is there a manual available?	Yes
Upload manual if available:
Model website if any	This site.
Model forum / discussion board

Comments	About this component: This component was developed as part of the TopoFlow hydrologic model, which was originally written in IDL and had a point-and-click GUI. For more information on TopoFlow, please goto: https://csdms.colorado.edu/wiki/Model:TopoFlow. When used from within the CSDMS Modeling Tool (CMT), this component has "config" button which launches a graphical user interface (GUI) for changing input parameters. The GUI is a tabbed dialog with a Help button at the bottom that displays HTML help in a browser window. This component also has a configuration (CFG) file, with a name of the form: <case_prefix>_channels_diff_wave.cfg. This file can be edited with a text editor. The Numerical Python module (numpy) is used for fast, array-based processing. This model has an OpenMI-style interface, similar to OpenMI 2.0. Part of this interface is inherited from "CSDMS_base.py".

This part will be filled out by CSDMS staff

OpenMI compliant	No but planned
BMI compliant	Yes
WMT component	Yes
PyMT component
Is this a data component

Can be coupled with:	TopoFlow, TopoFlow-Meteorology, TopoFlow-Channels-Diffusive_Wave, TopoFlow-Channels-Dynamic_Wave, TopoFlow-Channels-Kinematic_Wave, TopoFlow-Snowmelt-Degree-Day, TopoFlow-Snowmelt-Energy_Balance, TopoFlow-Infiltration-Green-Ampt, TopoFlow-Infiltration-Richards_1D, TopoFlow-Infiltration-Smith-Parlange, TopoFlow-Saturated_Zone-Darcy_Law,

Model info

Authors

Scott Peckham

Source code

Go to external source code site

Model citations

Nr. of publications:	1
Total citations:	12
h-index:	1
m-quotient:	0.06

QR-code

Link to this page

Other models by author

Introduction

History

References

Nr. of publications:	1
Total citations:	12
h-index:	1
m-quotient:	0.06

Featured publication(s)	Year	Model described	Type of Reference	Citations
Peckham, S.D.; 2009. Chapter 25 Geomorphometry and Spatial Hydrologic Modelling. In: (eds.)Developments in Soil Science.. 579–602. (View/edit entry)	2009	TopoFlow TopoFlow-Channels-Diffusive Wave TopoFlow-Channels-Dynamic Wave TopoFlow-Channels-Kinematic Wave TopoFlow-Diversions TopoFlow-Evaporation-Energy Balance TopoFlow-Evaporation-Priestley Taylor TopoFlow-Evaporation-Read File TopoFlow-Infiltration-Green-Ampt TopoFlow-Infiltration-Richards 1D TopoFlow-Infiltration-Smith-Parlange TopoFlow-Meteorology TopoFlow-Saturated Zone-Darcy Layers TopoFlow-Snowmelt-Degree-Day TopoFlow-Snowmelt-Energy Balance	Model overview	12
See more publications of TopoFlow-Evaporation-Priestley Taylor

Issues

Help

Model help:TopoFlow-Evaporation-Priestley Taylor

Input Files

Output Files