Submitted:
04 September 2025
Posted:
05 September 2025
You are already at the latest version
Abstract

Keywords:
1. Introduction
2. Materials and Methods
2.1. Assigning Watershed Codes
2.2. Naming of HUC8 Streams
2.2.1. Mainstem and Tributary Identifier Encoding
2.2.2. Stream Naming Across Confluences and Divergences
2.3. Naming HEC Model Elements
3. Results
3.1. Naming of Streams and Tributaries
3.2. Naming of Hydrologic Model Elements
3.2.1. Subbasins
3.2.2. Routing Reaches
3.2.3. Junctions
3.2.4. Diversions
3.2.5. Detention Basins
3.2.6. Sources
3.2.7. Sinks
3.3. Naming of Hydraulic Model Elements
3.3.1. River
3.3.2. Reach
3.3.3. Cross Sections
3.3.4. Junctions
3.3.5. Bridges and Other Hydraulic Structures
3.3.6. Two-Dimensional Model Elements
- 2D Flow Areas. Names for two-dimensional flow areas (e.g., XY2D042) are identified by the HUC8 watershed code, e.g., XY, followed by the characters “2D” followed by a three-digit Crockford base-32 identifier unique to a particular HUC8 watershed, e.g., 042, indicating that this is the 130th named 2D flow area in a particular HUC8 watershed (see Figure 7 for an example showing 2D areas named according to this scheme).
- Storage Areas. Names of storage areas (e.g., XYSA023) are identified by the HUC8 watershed code (e.g., XY), followed by the characters “SA” then a three Crockford base-32 digit identifier unique to a particular HUC8 watershed, e.g., 023 indicating that this is the 67th named storage area in a particular HUC8 watershed. Note that there are no separators between elements to allow connections between storage areas and 2D areas to be identified by combining connection end-point identifiers (see next section on SA/2D connections).
- SA/2D Flow Area Connections. Hydraulic structures linking storage areas and 2D flow areas are named by combining the identifiers of the storage area and 2D flow area, separated by “_”. For example, XYSA023_XY2D042, where XYSA023 is the identifier of the storage area being connected, XY2D042 is the identifier of the 2D flow area being connected. Note that HEC-RAS limits the storage area-2D area connection name to 16 characters.
3.3.7. Boundary Conditions
4. Discussion
Author Contributions
Funding
Data Availability Statement
Conflicts of Interest
Abbreviations
| HEC | Hydrologic Engineering Center |
| HUC | Hydrologic Unit Code |
| NHD | National Hydrography Dataset |
| GIS | Geographic Information System |
| HEC-RAS | Hydrologic Engineering Center—River Analysis System |
| HEC-HMS | Hydrologic Engineering Center—Hydrologic Modeling System |
References
- HCFCD. n.d. Harris County Flood Control District’s Model and Map Management System. Available online: https://www.hcfcd.org/Resources/Interactive-Mapping-Tools/Model-and-Map-Management-M3-System (accessed on 8 May 2024).
- NCFMP. “Riverine Hydrologic & Hydraulic Modeling Guidelines and Standards.” NC Cooperating Technical State Mapping Program. 4 September 2014. Available online: https://flood.nc.gov/NCFLOOD_BUCKET/NFIP/Riverine%20HandH%20Engineer ing%20Guidelines%20and%20Standards-05212020.pdf (accessed on 1 December 2021).
- LWI. n.d. Louisiana Watershed Initiative. Available online: https://watershed.la.gov/modeling-program (accessed on 8 May 2024).
- Doe, S.R.K.; Duncan, C.T. Naming conventions and documentation for distribution system modeling. Journal—American Water Works Association 2008, 100, 132–138. [Google Scholar] [CrossRef]
- Belete, G.; Voinov, A.; Laniak, G. An overview of the model integration process: From pre-integration assessment to testing. Environmental Modelling & Software 2017, 87, 49–63. [Google Scholar] [CrossRef] [PubMed]
- Overeem, I.; Berlin, M.M.; Syvitski, J.P.M. Strategies for integrated modeling: The community surface dynamics modeling system example. Environmental Modelling & Software 2013, 39, 314–321. [Google Scholar] [CrossRef]
- Peckham, S.D. The CSDMS Standard Names: Cross-Domain Naming Conventions for Describing Process Models, Data Sets and Their Associated Variables. International Congress on Environmental Modelling and Software 2014, 12. [Google Scholar]
- Horton, R. E. Erosional development of streams and their drainage basins: hydro-physical approach to quantitative morphology. Geological Society of America Bulletin 1945, 56, 275–370. [Google Scholar] [CrossRef]
- Strahler, A. N. Hypsometric (area-altitude) analysis of erosional topology. Geological Society of America Bulletin 1952, 63, 1117–1142. [Google Scholar] [CrossRef]
- Jager, A. L. de; Vogt, J. V. Development and demonstration of a structured hydrological feature coding system for Europe. Hydrological Sciences Journal 2010, 55, 661–675. [Google Scholar] [CrossRef]
- Pfafstatter, O. Classificação de Bacias Hidrográficas—Metodologia de Codificação; Departamento Nacional de Obras de Saneamento (DNOCS): Rio de Janeiro, RJ, 1989; p. 19. [Google Scholar]
- Seaber, P.R.; Kapinos, F.P.; Knapp, G.L. Hydrologic unit maps: U.S. Geological Survey Water-Supply Paper 2294, 63 p. 1987. Available online: https://pubs.usgs.gov/wsp/wsp2294/.
- Jones, K.A.; Niknami, L.S.; Buto, S.G.; Decker, D. Federal standards and procedures for the national Watershed Boundary Dataset (WBD) (5 ed.): U.S. Geological Survey Techniques and Methods 11-A3, 54 p. [CrossRef]
- U.S. Geological Survey. National Hydrography Dataset. 2023a. Available online: https://www.usgs.gov/national-hydrography/national-hydrography-dataset (accessed on 20 December 2023).
- U.S. Geological Survey. National Hydrography Dataset (NHD) Data Dictionary Feature Classes. 2023b. Available online: https://www.usgs.gov/ngp-standards-and-specifications/national-hydrography-dataset-nhd-data-dictionary-feature-classes (accessed on 20 December 2023).
- Goodell, Christopher R., “Breaking the HEC-RAS Code: A User’s Guide to Automating HEC-RAS” (2014). h2ls. ISBN 0990891801.
- Habib, E. H.; Miles, B. LWI Model Naming Conventions: Stream naming algorithm, HydroShare. [CrossRef]







| Element Type | Identifier Structure | Example | Notes |
|---|---|---|---|
| Subbasins (HMS) | Receiving Stream ID + _ + letter (A, B, C…) | XY01H006GG030401_A | Letter progresses upstream; subdivisions add digits (e.g., _A1). |
| Routing Reaches (HMS) | Stream ID + _ + 5-digit station + _R | XY01H006GG030401_00570_R | Station based on distance from mouth (ft ÷ 10). |
| Junctions (HMS) | Stream ID + _ + 5-digit station + _J | XY01H006GG030401_00030_J | Station represents nearest downstream location. |
| Diversions (HMS) | Stream ID + _ + 5-digit station + _D or _SW | XY01H006GG030401_00457_D | _D for diversion, _SW for side-weir diversion. |
| Detention Basins (HMS) | Stream ID + _ + 5-digit station + _DET | XY01H006GG030401_00030_DET | Station taken from nearest downstream cross-section. |
| Sources (HMS) | Subbasin ID + _SRC | XY01H006GG030401_A_SRC | Represents inflow from adjacent watersheds. |
| Sinks (HMS) | Stream ID + _ + 5-digit station + _S | XY01H006GG030401_00030_S | Identifies outflows at downstream stations. |
| Rivers (RAS) | Stream ID | XY01H006GG030401 | Uses full stream identifier. |
| Reaches (RAS) | 5-digit station | 00500 | Based on downstream station (ft ÷ 10). |
| Cross Sections (RAS) | Station value (ft from mouth) | 12345 | Updated when new sections or structures are added. |
| Junctions (RAS) | Mainstem ID + _ + 4-digit sequence + _J | XY01_0023_J | Shortened due to 12-character limit. |
| 2D Flow Areas (RAS) | Watershed code + 2D + 3-digit Base-32 identifier | XY2D042 | Sequential numbering within HUC8 watershed. |
| Storage Areas (RAS) | Watershed code + SA + 3-digit Base-32 identifier | XYSA023 | Used for reservoirs or floodplains. |
| SA/2D Connections (RAS) | Storage Area ID + _ + 2D Flow Area ID | XYSA023_XY2D042 | Concatenated identifiers; limited to 16 characters. |
Disclaimer/Publisher’s Note: The statements, opinions and data contained in all publications are solely those of the individual author(s) and contributor(s) and not of MDPI and/or the editor(s). MDPI and/or the editor(s) disclaim responsibility for any injury to people or property resulting from any ideas, methods, instructions or products referred to in the content. |
© 2025 by the authors. Licensee MDPI, Basel, Switzerland. This article is an open access article distributed under the terms and conditions of the Creative Commons Attribution (CC BY) license (http://creativecommons.org/licenses/by/4.0/).