Digital watershed representation within the NewAge-JGrass system
DOI:
https://doi.org/10.21701/bolgeomin.125.3.007Keywords:
digital watershed, geotools, Hack’s Lengths, Pfafstetter orderingAbstract
This paper describes the theoretical and technical architecture of a digital watershed model (DWM) that can be used as a basis for storing data relative to a river basin and to run a spatially distributed hydrological model that is directly representable in a GIS (such as uDig). The DWM deployment is based on the integration of geospatial modelling libraries (the Geotools) by means of which geographical information is encoded and becomes an integral part of the modelling process. Subsequently, the paper identifies a sequence of operations that have to be performed in order to obtain the desired DWM, and briefly describes the necessary programs. For the topological ordering of the network, a generalisation of the Pfafstetter ordering scheme is presented as well as a partitioning scheme based on the distances to the divides (namely Hack’s Lengths).
These programs are stand-alone components which can be run in different ways by using: the uDig Spatial Toolbox interface, the user friendly Object Modelling System (OMS) console or by command line. The OMS console completes the work by allowing the connection of all parts to produce well-designed modelling solutions in which the components are connected and executed together. The tools presented have been applied to the Little Washita river basin (Oklahoma, US) and to the Piave river basin (Veneto, Italy).
Downloads
References
Abera, W., Antonello, A., Franceschi, S., Formetta, G., and Rigon, R., 2014. The uDig Spatial Toolbox for hydro-geomorphic analysis, Clarke, L.E and Nield, J.M. (Eds.) Geomorphological Techniques (Online Edition). British Society for Geomorphology; London, UK. ISSN: 2047-0371.
Ascough II, J. C., Hoag, D. L., Frasier, W. M., and McMaster, G. S. 1999. Computer use in agriculture: an analysis of Great Plains producers. Computers and electronics in agriculture, 23, 189-204. https://doi.org/10.1016/S0168-1699(99)00044-7
David, O., Ascough II, J., Lloyd, W., Green, T., Rojas, K., Leavesley, G., and Ahuja, L., 2013. A software engineering perspective on environmental modeling framework design: The Object Modeling System. Environmental Modelling & Software, 39, 201-213. https://doi.org/10.1016/j.envsoft.2012.03.006
Eagleson, S. 1970. Dynamic hydrology, McGraw-hill Book Company, 1970.
Flugel, W. 1995. Delineating hydrological response units by geographical information system analyses for regional hydrological modelling using PRMS/MMS in the drainage basin of the River Brol, Germany. Hydrological Processes, 9, 423-436. https://doi.org/10.1002/hyp.3360090313
Formetta, G. 2013. Hydrological modelling with components: the OMS3 NewAge-JGrass system, Ph.D.Thesis.
Formetta, G., Mantilla, R., Franceschi, S., Antonello, A., and Rigon, R. 2011. The JGrass-NewAge system for forecasting and managing the hydrological budgets at the basin scale: models of flow generation and propagation/routing, Geoscientific Model Development, 4, 943-955. URL http://www.geosci-model-dev.net/4/943/2011/. https://doi.org/10.5194/gmd-4-943-2011
Formetta, G., Rigon, R., Chavez, J., and David, O. 2013. Modeling shortwave solar radiation using the JGrass-NewAge system. Geoscientific Model Development, 6, 915-928. https://doi.org/10.5194/gmd-6-915-2013
Formetta, G., Antonello, A., Franceschi, S., David, O., and Rigon, R. 2014a. Hydrological modelling with components: A GIS-based open-source framework. Environmental Modelling & Software, 55, 190-200. https://doi.org/10.1016/j.envsoft.2014.01.019
Formetta, G., Kampf, S. K., David, O., and Rigon, R. 2014b. Snow water equivalent modeling components in NewAge-JGrass. Geoscientific Model Development, 7, 725-736. URL http://www. geosci-model-dev.net/7/725/2014/. https://doi.org/10.5194/gmd-7-725-2014
Furst, J. and Horhan, T. 2009. Coding of watershed and river hierarchy to support GIS-based hydrological analyses at different scales. Computers & Geosciences, 35, 688-696. https://doi.org/10.1016/j.cageo.2008.04.007
Gangodagamage, C., Belmont, P., and Foufoula-Georgiou, E. 2011. Revisiting scaling laws in river basins: New considerations across hillslope and fluvial regimes. Water Resources Research, 47. https://doi.org/10.1029/2010WR009252
Goodall, J. L. and Maidment, D. R. 2009. A spatiotemporal data model for river basin-scale hydrologic systems. International Journal of Geographical Information Science, 23, 233-247. https://doi.org/10.1080/13658810802032193
Horton, R. E. 1945. Erosional development of streams and their drainage basins; hydrophysical approach to quantitative morphology. Geological Society of America Bulletin, 56, 275-370. https://doi.org/10.1130/0016-7606(1945)56[275:EDOSAT]2.0.CO;2
Krause, P. 2002. Quantifying the impact of land use changes on the water balance of large catchments using the J2000 model. Physics and Chemistry of the Earth, Parts A/B/C, 27, 663-673. https://doi.org/10.1016/S1474-7065(02)00051-7
Liu, J., Zhou, Z., Jia, Y., Wang, H., and Chen, X. 2013. A stembranch-topological codification for watershed subdivision and identification to support distributed hydrological modeling at large river basins, Hydrological Processes. https://doi.org/10.1002/hyp.9746
Maidment, D. 2002. Arc Hydro: GIS for water resources, vol. 1, ESRI press.
Marks, D., Dozier, J., and Frew, J. 1984. Automated basin delineation from digital elevation data. Geo-processing, 2, 299-311.
Moussa, R., Chahinian, N., and Bocquillon, C. 2007. Distributed hydrological modeling of a Mediterranean mountainous catchment-Model construction and multi-site validation. Journal of Hydrology, 337, 35-51. https://doi.org/10.1016/j.jhydrol.2007.01.028
Moussa, R., Colin, F., Dages, C., Fabre, J., Lagacherie, P., Louchart, X., Rabotin, M., Raclot, D., and Voltz, M. 2010. Distributed hydrological modelling of farmed catchments (MHYDAS): assessing the impact of man-made structures on hydrological processes. LANDMOD 2010, Montpellier.
O'Callaghan, J. F. and Mark, D. M. 1984. The extraction of drainage networks from digital elevation data. Computer vision, graphics, and image processing, 28, 323-344. https://doi.org/10.1016/S0734-189X(84)80011-0
Orlandini, S., Moretti, G., Franchini, M., Aldighieri, B., and Testa, B. 2003. Pathbased methods for the determination of nondispersive drainage directions in grid-based digital elevation models. Water resources research, 39, 1144. https://doi.org/10.1029/2002WR001639
Orlandini, S., Moretti, G., Corticelli, M. A., Santangelo, P. E., Capra, A., Rivola, R., and Albertson, J. D. 2012. Evaluation of flow direction methods against field observations of overland flow dispersion. Water Resources Research, 48. https://doi.org/10.1029/2012WR012067
Peckham, S. 2003. RiverTools Users Guide, Boulder, CO: Rivix, LLC.
Rigon, R., Rodriguez-Iturbe, I., Maritan, A., Giacometti, A., Tarboton, D. G., and Rinaldo, A. 1996. On Hack's law. Water Resources Research, 32, 3367-3374. https://doi.org/10.1029/96WR02397
Rigon, R., Ghesla, E., Tiso, C., and A, C. 2006. The Horton machine: a system for DEM analysis : the reference manual. Università degli Studio di Trento, 144 p.
Rodriguez-Iturbe, I. and Porporato, A. 2005. Ecohydrology of water-controlled ecosystems: soil moisture and plant dynamics, Cambridge University Press. https://doi.org/10.1017/CBO9780511535727
Rodriguez-Iturbe, I. and Rinaldo, A. 2001. Fractal river basins: chance and selforganization, Cambridge University Press.
Rodriguez-Iturbe, I. and Valdes, J. B. 1979. The geomorphologic structure of hydrologic response. Water Resources Research, 15, 1409-1420. https://doi.org/10.1029/WR015i006p01409
Ross, B., Contractor, D., and Shanholtz, V. 1979. A finite-element model of overland and channel flow for assessing the hydrologic impact of land-use change. Journal of Hydrology, 41, 11-30. https://doi.org/10.1016/0022-1694(79)90101-X
Strassberg, G., Jones, N. L., and Maidment, D. R. 2011. Arc Hydro Groundwater: GIS for Hydrogeology, Esri Press.
Tarboton, D. G. 1997. A new method for the determination of flow directions and upslope areas in grid digital elevation models. Water resources research, 33, 309-319. https://doi.org/10.1029/96WR03137
Tarboton, D. G. 2005. Terrain analysis using digital elevation models (TauDEM), Utah Water.
Verdin, K. L. and Verdin, J. P. 1999. A topological system for delineation and codification of the Earths river basins. Journal of Hydrology, 218, 1-12. https://doi.org/10.1016/S0022-1694(99)00011-6
Viviroli, D., Zappa, M., Gurtz, J., and Weingartner, R. 2009. An introduction to the hydrological modelling system PREVAH and its pre-and post-processingtools. Environmental Modelling & Software, 24, 1209-1222. https://doi.org/10.1016/j.envsoft.2009.04.001
Wilson, J. P. and Gallant, J. C. 2000. Terrain analysis: principles and applications, Wiley.
Downloads
Published
How to Cite
Issue
Section
License
Copyright (c) 2026 Consejo Superior de Investigaciones Científicas (CSIC)

This work is licensed under a Creative Commons Attribution 4.0 International License.
© CSIC. Manuscripts published in both the print and online versions of this journal are the property of the Consejo Superior de Investigaciones Científicas, and quoting this source is a requirement for any partial or full reproduction.
All contents of this electronic edition, except where otherwise noted, are distributed under a Creative Commons Attribution 4.0 International (CC BY 4.0) licence. You may read the basic information and the legal text of the licence. The indication of the CC BY 4.0 licence must be expressly stated in this way when necessary.
Self-archiving in repositories, personal webpages or similar, of any version other than the final version of the work produced by the publisher, is not allowed.






