Skip to content

Commit

Permalink
grammar read-through
Browse files Browse the repository at this point in the history
  • Loading branch information
jsta committed Feb 28, 2022
1 parent 76f83f3 commit 18746f7
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ River and Basin Profiler (`rabpro`) is a Python package to delineate watersheds,

## Statement of Need

Watersheds play a central and vital role in many scientific, engineering, and environmental management applications (See @brooks_hydrology_2003 for a comprehensive overview). While `rabpro` can benefit any watershed-based research or analysis, it was designed to satisfy the needs of data-driven rainfall-runoff models. These models aim to predict a streamflow (runoff) time series as a function of precipitation over the upstream land area (i.e. the watershed). In addition to watershed delineations and precipitation estimates, they typically require data of both time-varying parameters (or forcing data) like temperature, humidity, soil moisture, and vegetation as well as static watershed properties like topography, soil type, or land use/land cover [@kratzert_toward_2019; @gauch_rainfallrunoff_2021; @nearing_data_2021; @kratzert_note_2021]. The `rabpro` API enables users to manage the complete data pipeline necessary to drive such a model starting from the initial watershed delineation through the calculation of static and time-varying parameters. Some hydrologic and hydraulic models also require channel slope for routing streamflow [@boyle_toward_2001; @piccolroaz_hyperstream_2016; @wilson_water_2008], developing rating curves [@fenton_calculation_2001; @colby_relationship_1956], or modeling local hydraulics [@schwenk_life_2015; @schwenk_high_2017; @schwenk_meander_2016].
Watersheds play a central and vital role in many scientific, engineering, and environmental management applications (See @brooks_hydrology_2003 for a comprehensive overview). While `rabpro` can benefit any watershed-based research or analysis, it was designed to satisfy the needs of data-driven rainfall-runoff models. These models aim to predict streamflow (runoff) time series as a function of precipitation over upstream land area (i.e. the watershed). In addition to watershed delineations and precipitation estimates, they typically require data on both time-varying parameters (or forcing data) like temperature, humidity, soil moisture, and vegetation as well as static watershed properties like topography, soil type, or land use/land cover [@kratzert_toward_2019; @gauch_rainfallrunoff_2021; @nearing_data_2021; @kratzert_note_2021]. The `rabpro` API enables users to manage the complete data pipeline necessary to drive such a model starting from the initial watershed delineation through the calculation of static and time-varying parameters. Some hydrologic and hydraulic models also require channel slope for routing streamflow [@boyle_toward_2001; @piccolroaz_hyperstream_2016; @wilson_water_2008], developing rating curves [@fenton_calculation_2001; @colby_relationship_1956], or modeling local hydraulics [@schwenk_life_2015; @schwenk_high_2017; @schwenk_meander_2016].

The need for watershed-based data analysis tools is exemplified by the growing collection of published datasets that provide watershed boundaries, forcing data, and/or watershed attributes in precomputed form, including CAMELS [@addor_camels_2017], CAMELS-CL, -AUS, and -BR [@alvarez-garreton_camels-cl_2018; @fowler_camels-aus_2021; @chagas_camels-br_2020], Hysets [@arsenault_comprehensive_2020], and HydroAtlas [@linke_global_2019]. These datasets provide off-the-shelf options for building streamflow models, but they suffer from a degree of inflexibility. For example, someone desiring to add a watershed attribute, to use a new remotely-sensed data product, or to update the forcing data time-series to include the most recently available data must go through the arduous process of sampling it themselves. `rabpro` was designed to provide flexibility for both building a watershed dataset from scratch or appending to an existing one.

Expand All @@ -46,7 +46,7 @@ The importance of watersheds, availability of DEMs, and growing computational po

However, to our knowledge, `rabpro` is the only available package that provides efficient end-to-end delineation and characterization of watershed basins at scale. While a combination of the cited terrain analysis packages and GEE toolboxes can achieve `rabpro`’s functionality, `rabpro`’s blending of them enables simpler, less error-prone, and faster results.

One unique `rabpro` innovation is its automation of “hydrologically addressing” input coordinates. DEM watershed delineations require that the outlet pixel be precisely specified; in many `rabpro` use cases, this is simply a (latitude, longitude) coordinate that may not align with the underlying DEM. `rabpro` will attempt to “snap” the provided coordinate to a nearby flowline while minimizing the snapping distance and the difference in upstream drainage area (if provided by the user). Another unique `rabpro` feature provides the ability to optimize the watershed delineation method according to basin size such that pixel-based (from MERIT-Hydro [@yamazaki_merit_2019]) delineations can be used for more accurate estimates and/or smaller basins, and coarser subbasin-based (from HydroBASINS [@lehner_hydrobasins_2014]) delineations can be used for rapid estimates of larger basins.
One unique `rabpro` innovation is its automation of “hydrologically addressing” input coordinates. DEM watershed delineations require that the outlet pixel be precisely specified; in many `rabpro` use cases, this is simply a (latitude, longitude) coordinate that may not align with the underlying DEM. `rabpro` will attempt to “snap” the provided coordinate to a nearby flowline while minimizing the snapping distance and the difference in upstream drainage area (if provided by the user). Another unique `rabpro` feature is the ability to optimize the watershed delineation method according to basin size such that pixel-based (from MERIT-Hydro [@yamazaki_merit_2019]) delineations can be used for more accurate estimates and/or smaller basins, and coarser subbasin-based (from HydroBASINS [@lehner_hydrobasins_2014]) delineations can be used for rapid estimates of larger basins.

## Functionality

Expand Down

0 comments on commit 18746f7

Please sign in to comment.