About Software

BasinMaker

BasinMaker v3.1 is a set of Python-based GIS tools that support vector-based watershed delineation, rediscretization, simplification, and revision for complex watershed systems that may include thousands of stream and lakes. These tools are designed to manipulate the North American river and lake routing data product downloadable from this website.

BasinMaker can directly generate model discretization files for the Raven hydrological model framework, but may also be used to support drainage analysis or simulation with other vector-based hydrology models.

Routing Products

BasinMaker has been used to generate three publicly available routing products outlined below, which are shapefiles defining stream/lake network topology and characteristics of lakes and streams. In these products, each lake is represented by a lake catchment (subbasin). A lake catchment is defined by the following rules:

  1. the extent of the lake catchment will fully cover the lake;
  2. the outlet of the lake catchment is the same as the outlet of the lake; and
  3. each lake’s inlets are treated as a catchment outlet.
In this way, both inflow and outflow of each lake can be explicitly simulated by hydrologic routing models. The lake-river routing product details the routing structure (which here refers to both the topology of the stream network and the contributing areas to individual lakes and stream reaches), to correctly represent lakes in hydrologic and land-surface models.

CLRH - the Canadian Lake-River Hydrofabric

BasinMaker v3.1 was used to create a Canada-wide hydrofabric, with networks downloadable by region or by catchments upstream of points of interest such as Water Survey of Canada stream gauges. See the CLRH website for download and data specifications. Note also that BasinMaker can be applied in a CLRH-specific Google Colab environment to download and simplify CLRH networks.

CLRH Website image

Ontario Lake-River Routing Product (OLRRP) v1.0

BasinMaker v3.0 was used to create this lake-river routing product covering the Province of Ontario based upon Ontario-specific terrain and hydrofeature data layers. See the OLRRP website to view and download the routing network.

OLRRP Website image

North American Lake-River Routing Product (NALRRP) v2.1

BasinMaker v2.0 was utilized to create this lake-river routing product using the MERIT DEM (3 arcsec; ~0.0008333°; ~90m) and HydroLAKES as core input layers. The extent of the routing product covers the main drainage regions across North America (Canada and the USA).

Routing product data v2.1 can be accessed via the map-based download tool. Please use CLRH instead of NALRRP for any regions covered by both products.

Routing product users will want to download the data specifications file as well.

Authors

BasinMaker and the associated lake-river routing products were developed by the hydrology research group at the University of Waterloo. Primary Contributors includes Ming Han, Hongren Shen, Bryan A. Tolson, James R. Craig, Juliane Mai, Simon Lin, Nandita B. Basu, Frezer Awol. We also want to thank Robert Chlumsky, Étienne Gaborit, Hongli Liu, Konhee Lee for their secondary support in development of this product and their contributions to our Pan-Canadian routing product.

Contact

Please contact Ming Han regarding the BasinMaker and the routing products.

Citation

The BasinMaker manuscript is submitted for review. To cite BasinMaker software or the North American Lake-River Routing Product routing product, please use:

And if necessary, for the NALRRP dataset, cite:

Support

Support for BasinMaker and the North American routing product development came from multiple sources: