Model:TopoFlow-Infiltration-Green-Ampt

Edit Model information

TopoFlow-Infiltration-Green-Ampt

Metadata

Summary Contact Technical specs In/Output Process Testing Other Component info 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 One-line model description Infiltration process component (Green-Ampt 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 When did you indicate the 'code development status'? Model availability As code, As teaching tool Source code availability (Or provide future intension) Through CSDMS repository Source web address Source csdms web address https://github.com/peckhams/topoflow 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 used by the simple Green-Ampt method for modeling infiltration are defined as follows: K_s = saturated hydraulic conductivity (m / s) K_i = initial hydraulic conductivity (m / s) (typically much less than Ks) θ_s = soil water content at ψ=0 (unitless) (typically set to the porosity, φ) θ_i = initial soil water content (unitless) G = capillary length scale (meters) = integral over all ψ of K(ψ) / K_s = (almost always between ψ_B and 2*ψ_B) P = precipitation rate (mm / sec) M = snowmelt rate (mm / sec) 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: Green_Ampt Number of layers: 1 Time step: Scalar 60.0000000 (sec) Ks: Scalar 0.00000720 (m/s) Ki: Scalar 0.00000010 (m/s) qs: Scalar 0.48500001 (none) qi: Scalar 0.37580763 (none) G: Scalar 0.72400000 (m) Closest soil_type: silt_loam Save grid timestep: Scalar 60.00000000 (sec) Save v0 grids: 0 Case5_2D-v0.rts (m/s) Save I grids: 0 Case5_2D-I.rts (m) Save pixels timestep: Scalar 60.00000000 (sec) Save v0 pixels: 0 Case5_0D-v0.txt (m/s) Save I pixels: 0 Case5_0D-I.txt (m) 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 The Green-Ampt method for modeling infiltration. Describe key physical parameters and equations Equations Used by the Green-Ampt Method f_c = K_i + ((K_s - K_i) * (F + J) / F) = infiltrability (m / sec) (max infiltration rate) = K_s + (J / F) * (K_s - K_i) = infiltrability (m / sec) (max infiltration rate) J = G * (θ_s - θ_i) = a quantity used in previous equation (meters) v_0 = min((P + M), f_c) = infiltration rate at surface (mm / sec) (K_s < (P + M)) = (P + M) = infiltration rate at surface (mm / sec) (K_s > (P + M)) F = ∫ v_0(t) d_t, (from times 0 to t) = cumulative infiltration depth (meters) (vs. I' in Smith (2002) 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 The basic stability condition is: dt < (dx / u_min), where dt is the timestep, dx is the grid cell size and u_min is the smallest velocity in the grid. This ensures that flow cannot cross a grid cell in less than one time step. 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 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: http://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 Not yet"Not yet" is not in the list (Yes, In progress, No but possible, No not possible) of allowed values for the "Code CMT compliant or not" property. PyMT component Is this a data component Can be coupled with: CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith, CanCoupleWith,

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 Erode Erode-D8-Local Shoreline TopoFlow TopoFlow-Channels-Diffusive Wave TopoFlow-Channels-Dynamic Wave TopoFlow-Channels-Kinematic Wave TopoFlow-DEM Smoother TopoFlow-Data-HIS 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

Download statistics

<pbars ytitle=Downloads Title='Monthly Downloads topoflow-infiltration-green-ampt' xlabels=true size=900x200 ymax=20 grid=true box=true cubic=true plots=open xformat=number connected=true angle=90 legend> ,Total downloads: 71 2008 - Jan,0 Feb,0 Mar,0 Apr,0 May,0 Jun,0 Jul,0 Aug,0 Sep,0 Oct,0 Nov,0 Dec,0 2009 - Jan,0 Feb,0 Mar,0 Apr,0 May,0 Jun,0 Jul,0 Aug,0 Sep,0 Oct,0 Nov,0 Dec,0 2010 - Jan,0 Feb,0 Mar,0 Apr,0 May,0 Jun,0 Jul,0 Aug,0 Sep,0 Oct,0 Nov,0 Dec,0 2011 - Jan,0 Feb,0 Mar,4 Apr,1 May,5 Jun,10 Jul,3 Aug,2 Sep,1 Oct,0 Nov,2 Dec,6 2012 - Jan,2 Feb,1 Mar,2 Apr,2 May,0 Jun,0 Jul,0 Aug,3 Sep,4 Oct,3 Nov,2 Dec,1 2013 - Jan,0 Feb,0 Mar,0 Apr,4 May,2 Jun,0 Jul,0 Aug,0 Sep,0 Oct,0 Nov,0 Dec,0 2014 - Jan,0 Feb,0 Mar,1 Apr,3 May,1 Jun,0 Jul,0 Aug,2 Sep,0 Oct,2 Nov,1 Dec,1 2015 - Jan,0 Feb,0 Mar,0 Apr,0 May,0 Jun,0 Jul,0 </pbars>

References

Add a publication

Source code

Suggested way to reference a version of the model source code following data reference guidelines:

The part "]]" of the query was not understood.</br>Results might not be as expected.

Publication(s)	Model described	Citations

Overview and general

The part "]]" of the query was not understood.</br>Results might not be as expected.

Publication(s)	Model described	Citations

Applications

The part "]]" of the query was not understood.</br>Results might not be as expected.

Publication(s)	Model described	Citations

Related theory and data

The part "]]" of the query was not understood.</br>Results might not be as expected.

Publication(s)	Model described	Citations

Help

Model help:TopoFlow-Infiltration-Green-Ampt