Skip to content

Commit 5dde873

Browse files
Merge pull request #67 from jollygoodjacob/master
JOSS paper edits following new sections framework
2 parents 071922a + 1fbb681 commit 5dde873

2 files changed

Lines changed: 82 additions & 54 deletions

File tree

paper/paper.Rmd

Lines changed: 26 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: 'Open Riverine Ecosystem Synthesis (OpenRES): A QGIS plugin for automated extraction of hydrogeomorphic features to support Functional Process Zone classification of river networks'
33
tags:
44
- QGIS
5-
- river network classification
5+
- river classification
66
- Riverine Ecosystem Synthesis
77
- Functional Process Zones
88
- hydrogeomorphology
@@ -19,30 +19,30 @@ affiliations:
1919
- name: Department of Civil and Environmental Engineering, University of California, Merced, Merced, CA, USA
2020
index: 1
2121

22-
date: 1 Dec 2025
22+
date: 24 Mar 2026
2323
bibliography: paper.bib
2424
---
2525

26-
# Statement of need
27-
28-
Functional Process Zones (FPZs) represent recurring hydrogeomorphic units within river corridors that operate at the reach-to-valley scale. Accurate classification and mapping of these zones are essential for evaluating how spatial variations in hydrogeomorphic structure influence ecological communities and ecosystem functioning within the Riverine Ecosystem Synthesis (RES) framework (@thorp_2006). However, the delineation and classification of FPZs have been constrained by the deprecation of standardized GIS tools (e.g., RESonate for ArcMap; @williams_2013) and by the absence of open-source alternatives capable of extracting the diverse hydrogeomorphic features required for FPZ classification across entire river networks. This limitation has hindered reproducibility and comparability across studies seeking to test or extend the RES framework.
26+
# Summary
2927

30-
**Open Riverine Ecosystem Synthesis**, or `OpenRES`, addresses this gap by providing an open-source, modular, and GUI-accessible QGIS plugin that automates the extraction of key hydrogeomorphic features necessary for FPZ classification. By integrating reproducible methods within a widely adopted open-source GIS platform, `OpenRES` promotes standardization, accessibility, and scalability in riverine ecosystem analyses.
28+
**Open Riverine Ecosystem Synthesis**, or `OpenRES`, is an open-source, modular, and GUI-accessible QGIS plugin that automates the extraction of key hydrogeomorphic features necessary for Functional Process Zone (FPZ) classification of river networks. FPZs represent recurring hydrogeomorphic units within river corridors that operate at the reach-to-valley scale. Accurate classification and mapping of these zones are essential for evaluating how spatial variations in hydrogeomorphic structure influence ecological communities and ecosystem functioning within the Riverine Ecosystem Synthesis (RES) framework (@thorp_2006). However, the delineation and classification of FPZs have been constrained by the deprecation of standardized GIS tools (e.g., RESonate for ArcMap; @williams_2013) and by the absence of open-source alternatives capable of extracting the diverse hydrogeomorphic features required for FPZ classification across river networks at scale. This limitation has hindered reproducibility and comparability across studies seeking to test or extend the RES framework. By integrating reproducible methods within a widely adopted open-source GIS platform, `OpenRES` promotes standardization, accessibility, and scalability in riverine ecosystem analyses.
3129

32-
# Background
30+
# Statement of need
3331

34-
The Riverine Ecosystem Synthesis (RES) reconceptualizes rivers as downstream mosaics of large, discrete, and repeating hydrogeomorphic patches rather than continuous longitudinal gradients (in contrast with the River Continuum Concept; @vannote_1980). These hydrogeomorphic patches, termed Functional Process Zones, arise from interactions between catchment geomorphology, hydrology, and climate and typically span 5–10 km of river valley (@thorp_2010). FPZs describe differences in channel and valley structure, floodplain connectivity, and sediment and flow dynamics across watersheds (@hestir_2007), and have been linked to variation in ecological communities and ecosystem properties in rivers across five continents (@thorp_2023).
32+
The Riverine Ecosystem Synthesis (RES) reconceptualizes rivers as downstream mosaics of large, discrete, and repeating hydrogeomorphic patches rather than continuous longitudinal gradients (in contrast with the River Continuum Concept; @vannote_1980). These hydrogeomorphic patches, termed Functional Process Zones, arise from interactions between catchment geomorphology, hydrology, and climate and typically span 5–10 km sections of a river valley (@thorp_2010). FPZs describe differences in channel and valley structure, floodplain connectivity, and sediment and flow dynamics across watersheds (@hestir_2007), and have been linked to variation in ecological communities and ecosystem properties in rivers across five continents (@thorp_2023).
3533

3634
FPZ classification requires spatially consistent measures of climatic, geologic, and geomorphic features, yet collecting these data in the field is often impractical. Automated geospatial tools therefore play a critical role in enabling watershed scale classification. `OpenRES` was developed to meet this need by offering a unified, reproducible, and open-source workflow for extracting the hydrogeomorphic features required for FPZ delineation.
3735

38-
# OpenRES Audience
39-
4036
`OpenRES` is intended for students, instructors, researchers, and practitioners in river science, geomorphology, hydrology, and ecosystem management who use QGIS and need a standardized, open-source tool to delineate FPZs and conduct studies of riverine ecosystems.
4137

42-
# OpenRES Functionality
38+
# State of the field
39+
40+
41+
42+
# Software design
4343

4444
## Data Preparation
45-
There are six required datasets needed prior to the extraction of hydrogeomorphic features along a user's watershed of interest using OpenRES in QGIS:
45+
There are six required datasets needed prior to the extraction of hydrogeomorphic features along a user's watershed of interest using `OpenRES` in QGIS:
4646

4747
- A rasterized mean annual precipitation layer.
4848

@@ -52,13 +52,13 @@ There are six required datasets needed prior to the extraction of hydrogeomorphi
5252

5353
- A geomorphically corrected stream network layer.
5454

55-
- A valley-boundary line layer delimiting valley bottoms and confining slopes.
55+
- A valley-boundary line layer delineating valley bottoms and confining slopes.
5656

5757
- A channel-belt line layer defining the active or recently active channel zone.
5858

5959
## Using OpenRES
6060

61-
### Geomorphology Tools
61+
### Geomorphology tools
6262

6363
OpenRES includes optional tools to help users prepare valley and channel-belt boundaries:
6464

@@ -68,7 +68,7 @@ OpenRES includes optional tools to help users prepare valley and channel-belt bo
6868

6969
These tools assist in constructing the line layers required for subsequent feature extraction.
7070

71-
### Data Extraction Tools
71+
### Data extraction tools
7272
The core functionality of `OpenRES` is contained in seven data extraction tools, each of which is intended to be used sequentially to automate the extraction of fifteen hydrogeomorphic features.
7373

7474
- **[1] Generate Transects**: Perpendicular transects are generated from each river segment centerline to the valley boundaries. The tool iteratively extends transects until two intersections with both left and right valley boundary lines are found, providing a consistent sampling framework for valley geometry.
@@ -87,10 +87,20 @@ The core functionality of `OpenRES` is contained in seven data extraction tools,
8787

8888
The resulting dataset contains standardized metrics that collectively describe longitudinal and lateral hydrogeomorphic variation along the river corridor.
8989

90-
## After OpenRES: Unsupervised Classification
90+
## After OpenRES: unsupervised classification
9191

9292
The extracted attributes can be exported to Python, R, or another software for clustering analyses commonly used to delineate FPZs (e.g., hierarchical clustering; @maasri_2019; @elgueta_2019). The resulting FPZ classes can be joined back to the river network for visualization and spatial analysis within QGIS. This workflow enables reproducible, cross-watershed FPZ classification and supports testing of RES hypotheses regarding linkages among hydrogeomorphic structure, ecological composition, and ecosystem function (@thorp_2023).
9393

94+
# Research impact statement
95+
`OpenRES` is the first open-source implementation of a complete hydrogeomorphic feature extraction workflow for FPZ classification within QGIS. Unlike legacy tools such as RESonate, which depend on deprecated ArcMap environments, `OpenRES`:
96+
97+
- operates in a modern, actively maintained GIS platform,
98+
- provides a modular and extensible architecture,
99+
- enables reproducible workflows across watersheds, and
100+
- integrates directly with open-source geospatial ecosystems.
101+
102+
By lowering technical and software barriers, `OpenRES` facilitates broader adoption of the RES framework in river science and ecosystem studies.
103+
94104
# Acknowledgements
95105
`OpenRES` was developed by members of the Earth Observation and Remote Sensing Laboratory at the University of California, Merced. The authors would like to thank Matthew Rossi, Rachel S. Meyer, E. Natasha Stavros, Madeline Slimp, and Meghan T. Hayden for their feedback, suggestions, and support during the development of OpenRES.
96106

paper/paper.html

Lines changed: 56 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -256,6 +256,7 @@
256256
div.csl-bib-body { }
257257
div.csl-entry {
258258
clear: both;
259+
margin-bottom: 0em;
259260
}
260261
.hanging div.csl-entry {
261262
margin-left:2em;
@@ -379,41 +380,42 @@ <h4 class="date">1 Dec 2025</h4>
379380
</div>
380381

381382

382-
<div id="statement-of-need" class="section level1">
383-
<h1>Statement of need</h1>
384-
<p>Functional Process Zones (FPZs) represent recurring hydrogeomorphic
385-
units within river corridors that operate at the reach-to-valley scale.
386-
Accurate classification and mapping of these zones are essential for
387-
evaluating how spatial variations in hydrogeomorphic structure influence
388-
ecological communities and ecosystem functioning within the Riverine
389-
Ecosystem Synthesis (RES) framework (<span class="citation">Thorp,
390-
Thoms, and Delong (2006)</span>). However, the delineation and
391-
classification of FPZs have been constrained by the deprecation of
392-
standardized GIS tools (e.g., RESonate for ArcMap; <span class="citation">Williams et al. (2013)</span>) and by the absence of
393-
open-source alternatives capable of extracting the diverse
394-
hydrogeomorphic features required for FPZ classification across entire
395-
river networks. This limitation has hindered reproducibility and
396-
comparability across studies seeking to test or extend the RES
397-
framework.</p>
383+
<div id="summary" class="section level1">
384+
<h1>Summary</h1>
398385
<p><strong>Open Riverine Ecosystem Synthesis</strong>, or
399-
<code>OpenRES</code>, addresses this gap by providing an open-source,
400-
modular, and GUI-accessible QGIS plugin that automates the extraction of
401-
key hydrogeomorphic features necessary for FPZ classification. By
402-
integrating reproducible methods within a widely adopted open-source GIS
403-
platform, <code>OpenRES</code> promotes standardization, accessibility,
404-
and scalability in riverine ecosystem analyses.</p>
386+
<code>OpenRES</code>, is an open-source, modular, and GUI-accessible
387+
QGIS plugin that automates the extraction of key hydrogeomorphic
388+
features necessary for Functional Process Zone (FPZ) classification of
389+
river networks. FPZs represent recurring hydrogeomorphic units within
390+
river corridors that operate at the reach-to-valley scale. Accurate
391+
classification and mapping of these zones are essential for evaluating
392+
how spatial variations in hydrogeomorphic structure influence ecological
393+
communities and ecosystem functioning within the Riverine Ecosystem
394+
Synthesis (RES) framework (<span class="citation">Thorp, Thoms, and
395+
Delong (2006)</span>). However, the delineation and classification of
396+
FPZs have been constrained by the deprecation of standardized GIS tools
397+
(e.g., RESonate for ArcMap; <span class="citation">Williams et al.
398+
(2013)</span>) and by the absence of open-source alternatives capable of
399+
extracting the diverse hydrogeomorphic features required for FPZ
400+
classification across river networks at scale. This limitation has
401+
hindered reproducibility and comparability across studies seeking to
402+
test or extend the RES framework. By integrating reproducible methods
403+
within a widely adopted open-source GIS platform, <code>OpenRES</code>
404+
promotes standardization, accessibility, and scalability in riverine
405+
ecosystem analyses.</p>
405406
</div>
406-
<div id="background" class="section level1">
407-
<h1>Background</h1>
407+
<div id="statement-of-need" class="section level1">
408+
<h1>Statement of need</h1>
408409
<p>The Riverine Ecosystem Synthesis (RES) reconceptualizes rivers as
409410
downstream mosaics of large, discrete, and repeating hydrogeomorphic
410411
patches rather than continuous longitudinal gradients (in contrast with
411412
the River Continuum Concept; <span class="citation">Vannote et al.
412413
(1980)</span>). These hydrogeomorphic patches, termed Functional Process
413414
Zones, arise from interactions between catchment geomorphology,
414-
hydrology, and climate and typically span 5–10 km of river valley (<span class="citation">Thorp, Thoms, and Delong (2010)</span>). FPZs describe
415-
differences in channel and valley structure, floodplain connectivity,
416-
and sediment and flow dynamics across watersheds (<span class="citation">Hestir (2007)</span>), and have been linked to
415+
hydrology, and climate and typically span 5–10 km sections of a river
416+
valley (<span class="citation">Thorp, Thoms, and Delong (2010)</span>).
417+
FPZs describe differences in channel and valley structure, floodplain
418+
connectivity, and sediment and flow dynamics across watersheds (<span class="citation">Hestir (2007)</span>), and have been linked to
417419
variation in ecological communities and ecosystem properties in rivers
418420
across five continents (<span class="citation">Thorp et al.
419421
(2023)</span>).</p>
@@ -424,28 +426,28 @@ <h1>Background</h1>
424426
<code>OpenRES</code> was developed to meet this need by offering a
425427
unified, reproducible, and open-source workflow for extracting the
426428
hydrogeomorphic features required for FPZ delineation.</p>
427-
</div>
428-
<div id="openres-audience" class="section level1">
429-
<h1>OpenRES Audience</h1>
430429
<p><code>OpenRES</code> is intended for students, instructors,
431430
researchers, and practitioners in river science, geomorphology,
432431
hydrology, and ecosystem management who use QGIS and need a
433432
standardized, open-source tool to delineate FPZs and conduct studies of
434433
riverine ecosystems.</p>
435434
</div>
436-
<div id="openres-functionality" class="section level1">
437-
<h1>OpenRES Functionality</h1>
435+
<div id="state-of-the-field" class="section level1">
436+
<h1>State of the field</h1>
437+
</div>
438+
<div id="software-design" class="section level1">
439+
<h1>Software design</h1>
438440
<div id="data-preparation" class="section level2">
439441
<h2>Data Preparation</h2>
440442
<p>There are six required datasets needed prior to the extraction of
441443
hydrogeomorphic features along a user’s watershed of interest using
442-
OpenRES in QGIS:</p>
444+
<code>OpenRES</code> in QGIS:</p>
443445
<ul>
444446
<li><p>A rasterized mean annual precipitation layer.</p></li>
445447
<li><p>A digital elevation model (DEM) layer.</p></li>
446448
<li><p>A simplified geology polygon layer.</p></li>
447449
<li><p>A geomorphically corrected stream network layer.</p></li>
448-
<li><p>A valley-boundary line layer delimiting valley bottoms and
450+
<li><p>A valley-boundary line layer delineating valley bottoms and
449451
confining slopes.</p></li>
450452
<li><p>A channel-belt line layer defining the active or recently active
451453
channel zone.</p></li>
@@ -454,7 +456,7 @@ <h2>Data Preparation</h2>
454456
<div id="using-openres" class="section level2">
455457
<h2>Using OpenRES</h2>
456458
<div id="geomorphology-tools" class="section level3">
457-
<h3>Geomorphology Tools</h3>
459+
<h3>Geomorphology tools</h3>
458460
<p>OpenRES includes optional tools to help users prepare valley and
459461
channel-belt boundaries:</p>
460462
<ul>
@@ -471,7 +473,7 @@ <h3>Geomorphology Tools</h3>
471473
subsequent feature extraction.</p>
472474
</div>
473475
<div id="data-extraction-tools" class="section level3">
474-
<h3>Data Extraction Tools</h3>
476+
<h3>Data extraction tools</h3>
475477
<p>The core functionality of <code>OpenRES</code> is contained in seven
476478
data extraction tools, each of which is intended to be used sequentially
477479
to automate the extraction of fifteen hydrogeomorphic features.</p>
@@ -516,7 +518,7 @@ <h3>Data Extraction Tools</h3>
516518
</div>
517519
</div>
518520
<div id="after-openres-unsupervised-classification" class="section level2">
519-
<h2>After OpenRES: Unsupervised Classification</h2>
521+
<h2>After OpenRES: unsupervised classification</h2>
520522
<p>The extracted attributes can be exported to Python, R, or another
521523
software for clustering analyses commonly used to delineate FPZs (e.g.,
522524
hierarchical clustering; <span class="citation">Maasri et al.
@@ -528,6 +530,22 @@ <h2>After OpenRES: Unsupervised Classification</h2>
528530
ecological composition, and ecosystem function (<span class="citation">Thorp et al. (2023)</span>).</p>
529531
</div>
530532
</div>
533+
<div id="research-impact-statement" class="section level1">
534+
<h1>Research impact statement</h1>
535+
<p><code>OpenRES</code> is the first open-source implementation of a
536+
complete hydrogeomorphic feature extraction workflow for FPZ
537+
classification within QGIS. Unlike legacy tools such as RESonate, which
538+
depend on deprecated ArcMap environments, <code>OpenRES</code>:</p>
539+
<ul>
540+
<li>operates in a modern, actively maintained GIS platform,</li>
541+
<li>provides a modular and extensible architecture,</li>
542+
<li>enables reproducible workflows across watersheds, and</li>
543+
<li>integrates directly with open-source geospatial ecosystems.</li>
544+
</ul>
545+
<p>By lowering technical and software barriers, <code>OpenRES</code>
546+
facilitates broader adoption of the RES framework in river science and
547+
ecosystem studies.</p>
548+
</div>
531549
<div id="acknowledgements" class="section level1">
532550
<h1>Acknowledgements</h1>
533551
<p><code>OpenRES</code> was developed by members of the Earth
@@ -539,7 +557,7 @@ <h1>Acknowledgements</h1>
539557
</div>
540558
<div id="references" class="section level1 unnumbered">
541559
<h1 class="unnumbered">References</h1>
542-
<div id="refs" class="references csl-bib-body hanging-indent">
560+
<div id="refs" class="references csl-bib-body hanging-indent" entry-spacing="0">
543561
<div id="ref-elgueta_2019" class="csl-entry">
544562
Elgueta, Anaysa, Martin C Thoms, Konrad Górski, Gustavo Díaz, and Evelyn
545563
M Habit. 2019. <span>“Functional Process Zones and Their Fish

0 commit comments

Comments
 (0)