16565
doi
10.5281/zenodo.16565
oai:zenodo.org:16565
Maidment, David R.
Center for Research in Water Resources, The University of Texas at Austin, Austin, Texas
Niu, Guo-Yue
Department of Geological Sciences, Jackson School of Geosciences, The University of Texas at Austin, Austin, Texas
Yang, Zong-Liang
Department of Geological Sciences, Jackson School of Geosciences, The University of Texas at Austin, Austin, Texas
Habets, Florence
UMR-Sisyphe 7619, CNRS, UPMC, MINES ParisTech, Paris, France
Eijkhout, Victor
Texas Advanced Computing Center, The University of Texas at Austin, Austin, Texas
RAPID input and output files corresponding to "River Network Routing on the NHDPlus Dataset"
David, Cédric H.
Department of Geological Sciences, Jackson School of Geosciences, The University of Texas at Austin, Austin, Texas
doi:10.1175/2011JHM1345.1
info:eu-repo/semantics/openAccess
Creative Commons Attribution 4.0 International
https://creativecommons.org/licenses/by/4.0/legalcode
RAPID
River
Network
Flow
Modeling
Routing
Muskingum
Matrix
Parameter
Optimization
Gauge
Parallel
Speedup
NHDPlus
San Antonio
Guadalupe
Upper Mississippi
<p><strong>Corresponding peer-reviewed publication</strong></p>
<p>This dataset corresponds to all the RAPID input and output files that were used in the study reported in:</p>
<ul>
<li>David, Cédric H., David R. Maidment, Guo-Yue Niu, Zong-Liang Yang, Florence Habets and Victor Eijkhout (2011), River Network Routing on the NHDPlus Dataset, Journal of Hydrometeorology, 12(5), 913-934. DOI: 10.1175/2011JHM1345.1. </li>
</ul>
<p> </p>
<p>When making use of any of the files in this dataset, please cite both the aforementioned article and the dataset herein. </p>
<p> </p>
<p><strong>Time format</strong></p>
<p>The times reported in this description all follow the ISO 8601 format. For example 2000-01-01T16:00-06:00 represents 4:00 PM (16:00) on Jan 1<sup>st</sup> 2000 (2000-01-01), Central Standard Time (-06:00). Additionally, when time ranges with inner time steps are reported, the first time corresponds to the beginning of the first time step, and the second time corresponds to the end of the last time step. For example, the 3-hourly time range from 2000-01-01T03:00+00:00 to 2000-01-01T09:00+00:00 contains two 3-hourly time steps. The first one starts at 3:00 AM and finishes at 6:00AM on Jan 1<sup>st</sup> 2000, Universal Time; the second one starts at 6:00 AM and finishes at 9:00AM on Jan 1<sup>st</sup> 2000, Universal Time.</p>
<p> </p>
<p><strong>Data sources</strong></p>
<p>The following sources were used to produce files in this dataset:</p>
<ul>
<li>The National Hydrography Dataset Plus (NHDPlus) Version 1, obtained from http://www.horizon-systems.com/nhdplus. </li>
<li>The National Water Information System (NWIS), obtained from http://waterdata.usgs.gov/nwis. </li>
<li>Outputs from a simulation using the community Noah land surface model with multiparameterization options (Noah-MP, Niu et al. 2011, http://www.jsg.utexas.edu/noah-mp). The simulation was run by Guo-Yue Niu, and produced 3-hourly time steps from 2004-01-01T00:00+00:00 to 2008-01-01T00:00+00:00. Further details on the inputs and options used for this simulation are provided in David et al. (2011).</li>
</ul>
<p> </p>
<p><strong>Software</strong></p>
<p>The following software were used to produce files in this dataset:</p>
<ul>
<li>The Routing Application for Parallel computation of Discharge (RAPID, David et al. 2011, http://rapid-hub.org), Version 1.0.0. Further details on the inputs and options used for this series of simulations are provided below and in David et al. (2011).</li>
<li>ESRI ArcGIS (http://www.arcgis.com). </li>
<li>Microsoft Excel (https://products.office.com/en-us/excel). </li>
<li>CUAHSI HydroGET (http://his.cuahsi.org/hydroget.html). </li>
<li>The GNU Compiler Collection (https://gcc.gnu.org) and the Intel compilers (https://software.intel.com/en-us/intel-compilers). </li>
</ul>
<p> </p>
<p><strong>Study domain</strong></p>
<p>The files in this dataset correspond to two study domains:</p>
<ul>
<li>The combination of the San Antonio and Guadalupe River Basins, TX. RAPID can only use the river reaches of NHDPlus that have a known flow direction and focus is made on these reaches here (a total of 5,175). The temporal range corresponding to this domain is from 2004-01-01T00:00-06:00 to 2007-12-31 T00:00-06:00.</li>
<li>The Upper Mississippi River Basin. RAPID can only use the river reaches of NHDPlus that have a known flow direction and focus is made on these reaches here (a total of 182,240). The temporal range corresponding to this domain spans 100 fictitious days.</li>
</ul>
<p> </p>
<p><strong>Description of files for the San Antonio and Guadalupe River Basins</strong></p>
<p>All files below were prepared by Cédric H. David, using the data sources and software mentioned above. </p>
<ul>
<li><em>rapid_connect_San_Guad.csv.</em> This CSV file contains the river network connectivity information and is based on the unique IDs of NHDPlus reaches (the COMIDs). For each river reach, this file specifies: the COMID of the reach, the COMID of the unique downstream reach, the number of upstream reaches with a maximum of four reaches, and the COMIDs of all upstream reaches. A value of zero is used in place of NoData. The river reaches are sorted in increasing value of COMID. The values were computed using a combination of the following NHDPlus fields: COMID, DIVERGENCE, FROMNODE and TONODE. This file was prepared using ArcGIS and Excel.</li>
<li><em>m3_riv_San_Guad_2004_2007_cst.nc. </em>This netCDF file contains the 3-hourly accumulated inflows of water (in cubic meters) from surface and subsurface runoff into the upstream point of each river reach. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2007/12/31T18:00-06:00. The values were computed by superimposing a 900-m gridded map of NHDPlus catchments to the outputs of Noah-MP. This file was prepared using ArcGIS and a Fortran program.</li>
<li><em>kfac_San_Guad_1km_hour.csv. </em>This CSV file contains a first guess of Muskingum k values (in seconds) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on the following NHDPlus fields: COMID, LENGTHKM, Equation (13) in David et al. (2011), and using a wave celerity of 1 km/h. This file was prepared using a Fortran program.</li>
<li><em>kfac_San_Guad_celerity.csv. </em>This CSV file contains a first guess of Muskingum k values (in seconds) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on the following NHDPlus fields: COMID, LENGTHKM, Equation (13) in David et al. (2011), and using the wave celerity numbers of Table 2 in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>k_San_Guad_2004_1.csv. </em>This CSV file contains Muskingum k values (in seconds) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on the following NHDPlus fields: COMID, LENGTHKM, and using Equation (17) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>k_San_Guad_2004_2.csv. </em>This CSV file contains Muskingum k values (in seconds) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on the following NHDPlus fields: COMID, LENGTHKM, and using Equation (18) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>k_San_Guad_2004_3.csv. </em>This CSV file contains Muskingum k values (in seconds) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on the following NHDPlus fields: COMID, LENGTHKM, and using Equation (19) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>k_San_Guad_2004_4.csv. </em>This CSV file contains Muskingum k values (in seconds) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on the following NHDPlus fields: COMID, LENGTHKM, and using Equation (21) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>x_San_Guad_2004_1.csv. </em>This CSV file contains Muskingum x values (dimensionless) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on Equation (17) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>x_San_Guad_2004_2.csv. </em>This CSV file contains Muskingum x values (dimensionless) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on Equation (18) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>x_San_Guad_2004_3.csv. </em>This CSV file contains Muskingum x values (dimensionless) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on Equation (19) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>x_San_Guad_2004_4.csv. </em>This CSV file contains Muskingum x values (dimensionless) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_San_Guad.csv</em>. The values were computed based on Equation (21) in David et al. (2011). This file was prepared using a Fortran program.</li>
<li><em>basin_id_San_Guad_hydroseq.csv. </em>This CSV file contains the list of unique IDs of NHDPlus river reaches (COMID) in the San Antonio and Guadalupe River Basins. The river reaches are sorted from upstream to downstream. The values were computed using the following NHDPlus fields: COMID and HYDROSEQ. This file was prepared using Excel.</li>
<li><em>Qout_San_Guad_1460days_p1_dtR=900s.nc.</em> This netCDF file contains the 3-hourly averaged outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2007-12-31-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (17) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>Qout_San_Guad_1460days_p2_dtR=900s.nc. </em>This netCDF file contains the 3-hourly averaged outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2007-12-31-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (18) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>Qout_San_Guad_1460days_p3_dtR=900s.nc. </em>This netCDF file contains the 3-hourly averaged outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2007-12-31-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (19) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>Qout_San_Guad_1460days_p4_dtR=900s.nc. </em>This netCDF file contains the 3-hourly averaged outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2007-12-31-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (21) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>QoutR_San_Guad_182days_p1_dtR=900s.nc. </em>This netCDF file contains the 15-min outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2004-07-01-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (17) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>QoutR_San_Guad_182days_p2_dtR=900s.nc. </em>This netCDF file contains the 15-min outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2004-07-01-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (18) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>QoutR_San_Guad_182days_p3_dtR=900s.nc. </em>This netCDF file contains the 15-min outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2004-07-01-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (19) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>QoutR_San_Guad_182days_p4_dtR=900s.nc. </em>This netCDF file contains the 15-min outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_San_Guad_hydroseq.csv</em>. The time range for this file is from 2004-01-01T00:00-06:00 to 2004-07-01-00:00-06:00. The values were computed using the Muskingum method with parameters of Equation (21) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
<li><em>gage_id_San_Guad_2004_2007_full.csv. </em>This CSV file contains the list of COMIDs of rivers containing USGS gauges and with full daily data record. The river reaches are sorted in increasing value of COMID. The time range used for determining a full record is daily from 2004-01-01T00:00-06:00 to 2008-01-01T00:00-06:00. The values were computed using the following NHDPlus field: COMID. This file was prepared using ArcGIS, HydroGET, and Excel.</li>
<li><em>Qobs_San_Guad_2004_2007_full.csv. </em>This CSV file contains daily averaged measured stream flow (in cubic meters per second). The river reaches have the same COMIDs and are sorted similarly to <em>gage_id_San_Guad_2004_2007_full.csv</em>. The time range for the daily values is from 2004-01-01T00:00-06:00 to 2008-01-01T00:00-06:00. The values were computed using the following NHDPlus field: COMID, and the observations from NWIS. This file was prepared using ArcGIS, HydroGET, and Excel.</li>
</ul>
<p> </p>
<p><strong>Description of files for the Upper Mississippi River Basin</strong></p>
<p>All files below were prepared by Cédric H. David, using the data sources and software mentioned above. </p>
<ul>
<li><em>rapid_connect_Reg07.csv. </em>This CSV file contains the river network connectivity information and is based on the unique IDs of NHDPlus reaches (the COMIDs). For each river reach, this file specifies: the COMID of the reach, the COMID of the unique downstream reach, the number of upstream reaches with a maximum of four reaches, and the COMIDs of all upstream reaches. A value of zero is used in place of NoData. The river reaches are sorted in increasing value of COMID. The values were computed using a combination of the following NHDPlus fields: COMID, DIVERGENCE, FROMNODE and TONODE. This file was prepared using ArcGIS and Excel. </li>
<li><em>m3_riv_Reg07_100days_dummy.nc. </em>This netCDF file contains the 3-hourly accumulated inflows of water (in cubic meters) from surface and subsurface runoff into the upstream point of each river reach. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_Reg07.csv</em>. The time range for this file is for 100 fictitious days. The values were computed using a unique value of 1 cubic meter for all river reaches and all time steps. This file was prepared using a Fortran program.</li>
<li><em>kfac_Reg07_2.5ms.csv. </em>This CSV file contains a first guess of Muskingum k values (in seconds) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_Reg07.csv</em>. The values were computed based on the following NHDPlus fields: COMID, LENGTHKM, and using Equation (22) in David et al. (2011). This file was prepared using a Fortran program. </li>
<li><em>xfac_Reg07_0.3.csv. </em>This CSV file contains a first guess of Muskingum x values (dimensionless) for all river reaches. The river reaches have the same COMIDs and are sorted similarly to <em>rapid_connect_Reg07.csv</em>. The values were computed based on Equation (22) in David et al. (2011). This file was prepared using a Fortran program. </li>
<li><em>basin_id_Reg07_hydroseq.csv. </em>This CSV file contains the list of unique IDs of NHDPlus river reaches (COMID) in the Upper Mississippi River Basin. The river reaches are sorted from upstream to downstream. The values were computed using the following NHDPlus fields: COMID and HYDROSEQ. This file was prepared using Excel.</li>
<li><em>Qout_Reg07_100days_pfac_dtR900s.nc.</em> This netCDF file contains the 3-hourly averaged outputs (in cubic meters per second) from RAPID corresponding to the downstream point of each reach. The river reaches have the same COMIDs and are sorted similarly to <em>basin_id_Reg07_hydroseq.csv</em>. The time range for this file spans 100 fictitous days. The values were computed using the Muskingum method with parameters of Equation (22) in David et al. (2011). This file was prepared using RAPID v1.0.0 running with the preonly ILU solver on one core.</li>
</ul>
<p> </p>
<p><strong>Known bugs and limitations in this dataset or the associated manuscript.</strong></p>
<p>The confluence of the Missouri River and the Upper Mississippi River upstream of Saint Louis, MO was overlooked. The contribution from the Missouri River is therefore not accounted for in the network connectivity corresponding to the Upper Mississippi River Basin. This has no effect on the conclusions of David et al. (2011) since the Upper Mississippi River Basin was studied with synthetic data and solely to evaluate parallel performance of RAPID.</p>
<p> </p>
<p><strong>Funding</strong></p>
<p>This work was partially supported by the U.S. National Aeronautics and Space Administration under the Interdisciplinary Science Project NNX07AL79G; by the U.S. National Science Foundation under project EAR-0413265: CUAHSI Hydrologic Information Systems; by Ecole des Mines de Paris, France; and by the American Geophysical Union under a Horton (Hydrology) Research Grant.</p>
Zenodo
2011-10-01
info:eu-repo/semantics/other
609065
1579893976.931014
87975
md5:5e16efff4494d309dad012f0a63990ed
https://zenodo.org/records/16565/files/k_San_Guad_2004_1.csv
41157
md5:6e3d71704c827980e64ce50396c9b869
https://zenodo.org/records/16565/files/kfac_San_Guad_1km_hour.csv
241796840
md5:c91b7d8b193490b1b88540ed1f1d1eee
https://zenodo.org/records/16565/files/Qout_San_Guad_1460days_p4_dtR900s.nc
87975
md5:5865d1a476f233eb3f88de7fbce54d5a
https://zenodo.org/records/16565/files/x_San_Guad_2004_2.csv
87975
md5:f8710cf432889904221c06824a68ec75
https://zenodo.org/records/16565/files/x_San_Guad_2004_3.csv
501975
md5:717c997b944386954a107c770db88ff7
https://zenodo.org/records/16565/files/rapid_connect_San_Guad.csv
583897100
md5:6fd0d3f6d7d38460a52b8c1d99d3b20f
https://zenodo.org/records/16565/files/Qout_Reg07_100days_pfac_dtR900s.nc
1731757
md5:acc0a201e527c6046695dfb4ee701ced
https://zenodo.org/records/16565/files/basin_id_Reg07_hydroseq.csv
87975
md5:309957a3bccce1ba3de3f70bbf2b804f
https://zenodo.org/records/16565/files/kfac_San_Guad_celerity.csv
87975
md5:5865d1a476f233eb3f88de7fbce54d5a
https://zenodo.org/records/16565/files/x_San_Guad_2004_4.csv
361691240
md5:cfe0a83fac088059f2ad788140936b2d
https://zenodo.org/records/16565/files/QoutR_San_Guad_182days_p3_dtR900s.nc
87975
md5:486ef0c263594f9c6139bc58f55bbbb9
https://zenodo.org/records/16565/files/k_San_Guad_2004_3.csv
87975
md5:b66ac83e3792bab511bc915db40698e6
https://zenodo.org/records/16565/files/x_San_Guad_2004_1.csv
87975
md5:ba8636ef01e36a903e2b459d414843a5
https://zenodo.org/records/16565/files/k_San_Guad_2004_4.csv
241796840
md5:2f6bb0eaee36e5b1bdc701b6dfebbbc8
https://zenodo.org/records/16565/files/Qout_San_Guad_1460days_p3_dtR900s.nc
52741
md5:6a558b01ad817561dc473cb29f26ebd5
https://zenodo.org/records/16565/files/basin_id_San_Guad_hydroseq.csv
17677280
md5:06e83e0b1cfdd11227554add0f9e5287
https://zenodo.org/records/16565/files/rapid_connect_Reg07.csv
333
md5:bd47349a7429ebcdcdb1efe6b7d22ca3
https://zenodo.org/records/16565/files/gage_id_San_Guad_2004_2007_full.csv
241796840
md5:f310256c339a7ad8dc87979b422675bb
https://zenodo.org/records/16565/files/Qout_San_Guad_1460days_p2_dtR900s.nc
1226769
md5:7e8225dd27b825ffca14a9af4d1d372e
https://zenodo.org/records/16565/files/kfac_Reg07_2.5ms.csv
87975
md5:309957a3bccce1ba3de3f70bbf2b804f
https://zenodo.org/records/16565/files/k_San_Guad_2004_2.csv
911200
md5:11a00b357449a1f02b15f9939b6563e3
https://zenodo.org/records/16565/files/xfac_Reg07_0.3.csv
361691240
md5:9c62e89e88c6a05efb24fd493e35bebf
https://zenodo.org/records/16565/files/QoutR_San_Guad_182days_p4_dtR900s.nc
241796840
md5:fcef07f733ca1cfe2873b54104b4d6b2
https://zenodo.org/records/16565/files/Qout_San_Guad_1460days_p1_dtR900s.nc
241900304
md5:d5a4d1eb26e003238437abfcb3d93c4c
https://zenodo.org/records/16565/files/m3_riv_San_Guad_2004_2007_cst.nc
361691240
md5:c79e8fd7fd22f77319a2b192b092308a
https://zenodo.org/records/16565/files/QoutR_San_Guad_182days_p2_dtR900s.nc
583168104
md5:47e8938a4cce6d2a388198976bd5a5dd
https://zenodo.org/records/16565/files/m3_riv_Reg07_100days_dummy.nc
361691240
md5:b12094bcf6d64831454aff298c3567d2
https://zenodo.org/records/16565/files/QoutR_San_Guad_182days_p1_dtR900s.nc
606151
md5:2090a9d66ce81bfeacfca88eefb9e133
https://zenodo.org/records/16565/files/Qobs_San_Guad_2004_2007_full.csv
public
10.1175/2011JHM1345.1
Is supplement to
doi
isVersionOf
doi
Journal of Hydrometeorology
12
5
913-934
2011-10-01