Title: Data and code for: River planforms originate from (im)balance between riverbank erosion and bar accretion
{"Abstract":["Why rivers confine flow to a single channel (single-thread planform) or\n divide flow into multiple sub-channels (multi-thread planform) forms a\n longstanding fundamental question in river science, which to date remains\n poorly understood. In the associated manuscript, we probe planform origins\n using a novel dataset of 11+ million riverbank migration vectors mapped\n from 36 years of global satellite imagery along 84 river systems. Results\n show single-thread rivers originate from a balance between bank erosion\n and opposing-bar deposition, which maintains an equilibrium width as\n channels migrate. In contrast, multi-thread rivers originate from\n imbalance: bank erosion outpaces opposing-bar deposition, causing\n sub-channels to repeatedly widen and split. This width instability\n challenges equilibrium paradigms in river science, endangers riverside\n communities, and lowers the potential costs of nature-based river\n restoration projects along multi-thread rivers. Here, we provide the data\n and codes that form the foundation of this manuscript. "],"TechnicalInfo":["# Data and code for: River planforms originate from (im)balance between\n bank erosion and bar accretion --- author: Austin Chadwick contact:\n [achadwick@ldeo.columbia.edu](mailto:achadwick@ldeo.columbia.edu),\n [austin.chadwick23@gmail.com](mailto:austin.chadwick23@gmail.com) These\n materials are organized into two folders, Codes and Data. The Data folder\n contains spreadsheets, GIS geopackages, remote sensing images, and MATLAB\n data files for the associated manuscript "River planforms originate\n from (im)balance between bank erosion and bar accretion". The Codes\n folder provides MATLAB scripts and functions to generate the analysis and\n figures of the main manuscript. The last folder, temp, is empty; it acts\n as a temporary destination for output files that can be generated by the\n codes. ## Description of the data and file structure All data are found in\n the folder "Data", which can be accessted by opening the zip\n file "Data.zip". The following is a breakdown of each file and\n subfolder in the Data folder. * DataLog_082224_1.xlsx This excel document\n records the files used to apply PIV to remote sensing imagery, organized\n on a site-by-site basis. All files referenced therein are found in the\n Data folder. See the first sheet therein "Readme" for details. *\n Polygons subfolder This subfolder contains geopackage files (.gpkg) for\n each study reach in the main manuscript. Each file contains geopackage\n data for a single polygon that outlines and defines the study reach. These\n data were used to extract GEOTIFFs using google earth engine, and were\n obtained by manual selection in QGIS. See main manuscript for details on\n the selection process and sizing of each polygon. * Geotiffs subfolder\n This folder contains DSWE-derived river-mask GEOTIFFs derived from Landsat\n median annual composites, used for the analysis and figures of the main\n manuscript "River planforms originate from (im)balance between bank\n erosion and bar accretion". The DSWE-derived river masks were created\n in Google Earth Engine using the "GEE_watermasks" code found on\n the GitHub Repository\n ([https://github.com/evan-greenbrg/GEE_watermasks](https://github.com/evan-greenbrg/GEE_watermasks)). Each subfolder corresponds to a study reach in the main manuscript (see Table 1 in main manuscript), with nested subfolders containing river masks derived using DSWE confidence levels 1 through 4 (mask1, mask2, mask3, mask4). * PreparedImagery subfolder This folder contains true-color images and DSWE-derived river masks (.tif) for each study reach. These data were used as input data for PIV. For each site, there is a subfolder containing truecolor images ("Color") and sixteen subfolders containing DSWE-derived river masks for the four different confidence levels and four different tilt angles ("MaskX_TiltYY", where X is the confidence level and YY is the tilt angle). In each of these subfolders, there are two nested subfolders "RemovedBlanks" and "RemovedForSubsampling" which contain additional .tif's that were removed because they were blank or because optimal PIV analysis required subsampling, respectively. For details of this process, see: [https://doi.org/10.1029/2023JF007177](https://doi.org/10.1029/2023JF007177). * OutputFromPIVlab subfolder This folder contains the Raw PIV data output from PIVlab software for each site. Each site-specific subfolder contains sixteen .mat files, each of which corresponds to a specific confidence level and tilt angle in the prepared imagery (see DataLog_082224_1.xlsx for details on which file corresponds to which confidence level and tilt angle). For additional instructions on how to operate PIVlab , please see the following links: [http://sead-published.ncsa.illinois.edu/seadrepository/api/researchobjects/urn:uuid:6154f24ae4b0312e761fb761](http://sead-published.ncsa.illinois.edu/seadrepository/api/researchobjects/urn:uuid:6154f24ae4b0312e761fb761) [https://www.mathworks.com/matlabcentral/fileexchange/27659-pivlab-particle-image-velocimetry-piv-tool-with-gui](https://www.mathworks.com/matlabcentral/fileexchange/27659-pivlab-particle-image-velocimetry-piv-tool-with-gui) * PostprocessedPIV subfolder This folder contains the postprocessed PIV data output. Each site-specific subfolder contains four .mat files. These files contain the postprocessed data before filtering (Unfiltered.mat), the postprocessed data after filtering ("Filtered.mat"), the postprocessed data after filtering and setting all NaN values along high-confidence banks to zero ("Filtered_NanToZeroOnBank"). * BankNormalVectors subfolder This folder contains the bank-normal vector fields for each image. The data structure is identical to the PostprocssedPIV data, with a single .mat file for each river "BankNormalVectors.mat". All vectors have a length of 1, and are oriented perpendicular to the nearest channel bank, pointing away from the wetted area and towards the dry area. For details on this calculation, see: [https://doi.org/10.1029/2021WR031236](https://doi.org/10.1029/2021WR031236). * CrossSections subfolder This folder contains the data for the thread cross sections randomly sampled in each reach to calculate the differential migration rate (delv). Each site-specific subfolder contains a single mat file, "CrossSections.mat". This mat contains the positions (x,y) and the bank migration vectors (u,v) for each cross section. Spatial units are in pixels, and temporal units are in frames, such that velocities are in units of pixels/frame. * WettedAreas subfolder This folder contains the data for the wetted channel areas, used to investigate apparent changes in water discharge and plot supplemental figures. Each site-specific subfolder contains a single mat file, "WettedAreas.mat". This mat contains the positions (x,y) and the bank migration vectors (u,v) for each cross section. ## Sharing/Access information Some data referenced in the Datalog_082224.xlsx spreadsheet was derived from previous work: * Sylvester et al., 2019: [https://doi.org/10.1130/G45608.1](https://doi.org/10.1130/G45608.1) * Rowland et al., 2019: [https://doi.org/10.15485/1571527](https://doi.org/10.15485/1571527) * Galeazzi et al., 2021: [https://doi.org/10.1130/G49121.1](https://doi.org/10.1130/G49121.1) * Ielpi et al., 2023: [https://doi.org/10.1029/2022GL101285](https://doi.org/10.1029/2022GL101285) ## Code/Software All codes are found in the folder "Codes", which can be accessed by opening the zip folder "Codes.zip". To run any codes, it is necessary to add the "Codes" and "Data" folders (and their subfolders) to your current MATLAB path. This can be easily achieved by right-clicking the folder in the MATLAB GUI and selecting "Add To Path-->SelectedFolders and Subfolders", and will ensure that all input and output files are identified properly. The following is a breakdown of each file and subfolder in the Codes folder: * AnalsysisAndFigures1_Worldmap_082924_1.m This MATLAB script reproduces Figure 1A of the manuscript and its associated analysis. * AnalysisAndFigures2_PIVmethods_082924_1.m This MATLAB script reproduces Figure 1E of the manuscript and its associated analysis. * AnalysisAndFigures3_DifferentialMigration_082924_1.m This MATLAB script reproduces Figure 2A and Figure 4 of the manuscript, Text S1 Figures 1–4 of the supplement, and their associated analysis. It also reproduces the tabular data in Data S1, performs the statistical tests on delv* reported in the text, and counts the number of vector measurements in our database as reported in the text. * AnalysisAndFigures4_TimeSlices_082924_1.m This MATLAB script reproduces Figure 2B-G and Figure 4 of the manuscript and Figures S1–S3 of the supplement and their associated analysis. In the first code block (L23–36), the user designates the reach and cross section to plot by uncommenting the corresponding line. See code's comments on L23–36 for details. * AnalysisAndFigures5_MaterialsAndMethods_082924_1 This MATLAB script reproduces the supplement's Materials & Methods Figures 1–6 and their associated analysis. In the first code block (L19-23), the user designates the reach to plot by uncommenting the corresponding line. See code's comments on L19-23 for details. * AnalysisAndFigures6_SuppMovieFrames_082924_1.m This MATLAB script reproduces the frames of supplementary Movies S1–S3. In the first code block (L18-23), the user designates the reach to plot by uncommenting the corresponding line. See code's comments on L18-23 for details. * LatLonBySite_081924_1.xlsx This excel document records the approximate latitude and longitude coordinates of each studied reach in the main manuscript. These coordinates were used to generate Fig. 1 in the main manuscript, and were obtained by manually inspecting the coordinates of each .gpkg file in QGIS. The precise geographic coordinates for each reach can be found in the .gpkg files, in the Polygons subfolder described above. ### Change Log Version 2: minor changes in README."]}  more » « less
Award ID(s):
2310740
PAR ID:
10680330
Author(s) / Creator(s):
; ; ;
Publisher / Repository:
Dryad
Date Published:
Edition / Version:
11
Subject(s) / Keyword(s):
FOS: Earth and related environmental sciences FOS: Earth and related environmental sciences River Mobility Channel Migration Riverbank erosion Bar accretion Meandering Rivers Braided rivers
Format(s):
Medium: X Size: 69224498034 bytes
Size(s):
69224498034 bytes
Right(s):
Creative Commons Zero v1.0 Universal
Sponsoring Org:
National Science Foundation
More Like this
  1. Abstract: This document described the data and codes supporting the manuscript "Tracking the trajectory of alluvial channel adjustment reveals along-river shifts in sediment mobility" - Masteller et al., in review. This repository code was written to complete analysis outlined in Masteller et al. (in review). It has been modified from its original form to improve readability and ease of implementation for general users. You may need to modify the code for your specific applications. You are responsible for inspecting the code and making adjustments as necessary. /SummaryData/1. Reach_Summary_Final.csv - Reach-scale summaries for the South Fork Eel study sites including reach coordinates and morphology measures. 2. NREE_data_compilation.csv - Compiled data from Phillips et al., 2022. Used in Figure 2. /scripts/1. widthCalcfromBanklines.m - Processes paired left and right bankline CSV files to compute channel width along the South Fork Eel River, generate quality-control plots, and export width and bank-coordinate outputs as CSVs for downstream analyses. 2. DepthsFromWidths.m - Computes median and maximum channel depths and channel geometry metrics from QAQC’d balkline widths and cross-section elevation profiles, generates diagnostic plots, and exports per-site depth metrics to CSV. 3. reachSlopes.m - Derives channel slopes from a longitudinal profile, samples elevation and slope around grain-size survey locations, and exports per-site slope metrics and reach-scale summaries. /input/├── banklines/ - contains .CSV files of bankline positions for each study reach, two files per reach.  File headers indicate ID_number of cross-section from original width extraction (see Kostynick et al., 2026), original bank positions (Easting, Northing), and refined positions (Easting2, Northing2) and bank elevations of refined positions (Elevation2)├── centerline/ - contains .CSV file of channel centerline derived from 10-m USGS 3DEP product using Topotoolbox. File headers indicate distance downstream (D), Easting and Northing, drainage area (A), and elevation (Z). ├──crossSections/ - Matlab structure arrays containing channel cross-sections extracted using methods described in Kostynick et al., 2026 using 1-m topobathymetric lidar data product from Dietrich, 2014. Data are split between Upper Eel and Lower Eel river.  Cross-sections are contained within the structure array as width_extract.Zprof with corresponding distances in width_extract.dist or thalweg-centered distances as width_extract.dist_center└── DEM/ - contains USGS 3DEP 10-m DEM used to extract channel centerline, downloaded from OpenTopography  /output/├── widths/ - contains .CSV files of bank-to-bank widths output from widthCalcfromBanklines.m. File headers indicate site identifier, the ID number of cross-section from original width extraction (see Kostynick et al., 2026), the coordinates and elevations of each bank, and the extracted bank-to-bank widths├── depths/ - contains .CSV files of depths output from DepthsFromWidths.m. File headers indicate the site identifier, the ID number of cross-section from original width extraction (see Kostynick et al., 2026), the elevation of each bank, the average and maximum bank elevations by cross-section, the average extracted depth, wetted perimeter, cross-sectional area, and hydraulic radius, and the maximum extracted depth, wetted perimeter, cross-sectional area, and hydraulic radius.├── slopes/ contains .CSV files of slopes output from reachSlopes.m. File headers indicate the site identifier, the distance downstream from the original centerline file, the elevation, and the local slope.└── plots/ landing output folder for QAQC plots generated from width, depth, and slope extraction scripts. Contains one set of sample plots.  References: R. P. Kostynick, C. B. Phillips, C. C. Masteller, High-Resolution Channel Geometry Reveals Contrasting Styles of Gravel River Adjustment. Geophysical Research Letters (2026). https://doi.org/10.1029/2025GL118412. Kostynick, R. (2025). Supporting datasets and code for "High-Resolution Channel Geometry Reveals Contrasting Styles of Gravel River Adjustment" [Data set]. Zenodo. https://doi.org/10.5281/zenodo.17536841 Dietrich, W. E. (2014). Eel River Critical Zone Observatory July 2014 Lidar Survey [Data set]. Distributed by OpenTopography: National Center for Airborne Laser Mapping (NCALM). https://doi.org/10.5069/G9MP517V Phillips, C. B., Masteller, C. C., Slater, L. J., Dunne, K. B. J., Francalanci, S., Lanzoni, S., et al. (2022). Threshold constraints on the size, shape and stability of alluvial rivers. Nature Reviews Earth & Environment, 1–14. https://doi.org/10.1038/s43017-022-00282-z Schwanghart, W. (2022). Release TopoToolbox 2.4 [Computer software]. Github. wschwanghart/topotoolbox. Retrieved November 5, 2025, from https://github.com/wschwanghart/topotoolbox/releases/tag/2.4 Schwanghart, W., & Scherler, D. (2014). Short Communication: TopoToolbox 2 – MATLAB-based software for topographic analysis and modeling in Earth surface sciences. Earth Surface Dynamics, 2(1), 1-7-1–7. https://doi.org/10.5194/esurf-2-1-2014 
    more » « less
  2. Abstract: This dataset contains the data collected and presented in the manuscript "Influence of Biofilms and Extracellular Polymeric Substances on High-Frequency Acoustic Backscatter". It includes acoustic signals (voltage and time) for each tested case (and replicates), hydrophone tests, and acoustic calibration using two transducers. Additionally, it contains the MATLAB codes used to process the data. TechnicalInfo: The file named " AgingNaturalBiofilms.zip" contains 91 folders with 210 .mat files. The file named " EPS.zip" contains 91 folders with 210 .mat files. The file named " Replicates.zip" contains 52 folders with 120 .mat files. The file named " Hydrophone.zip" contains 2 folders with 2 .mat files. The file named "2Transducers.zip" contains 2 folders with 2 .mat files. The file "MatLabCodes.zip" contains the matlab code used to process the data. 
    more » « less
  3. {"Abstract":["Woodrats of the genus Neotoma are an important study system for ecological and paleoecological research. However, paleontological studies are often hindered by the difficulty of identifying woodrat remains to species. We address this limitation by using 2D landmark-based geometric morphometrics to classify 199 lower first molars (m1s) of five extant western North American Neotoma species (N. albigula, N. cinerea, N. fuscipes, N. lepida, and N. macrotis) collected throughout California. We then use discriminant analysis of principal components (DAPC) models to identify late Pleistocene fossils of unknown species from the Rancho La Brea Tar Pits in Los Angeles, CA. DAPC correctly identifies ~85-90% of extant individuals to species, with most misclassifications occurring between sister taxa N. fuscipes and N. macrotis. Most fossil m1s are classified as N. macrotis by DAPC, which may be the first confirmation of N. macrotis in the fossil record. We show that landmark-based geometric morphometric analyses are generally effective at differentiating m1s of extant Neotoma species in California and they are an auspicious method for unknown fossil identification. Further applications of this method across a broader range of geographic locations and species will better contextualize its utility."],"Other":["This file contains images and landmark coordinates of Neotoma lower dentition analyzed in Fox and Blois (2025) “A geometric morphometric approach to identifying recent and fossil woodrat molars with remarks on late Pleistocene Neotoma macrotis from Rancho La Brea”. The file contains three subfolders: "All Images", "Recent CA Neotoma", and "Unknowns". Each subfolder, described further below, contains .jpg specimen images and .tps files of 2D landmark coordinate data. All .tps files were built and combined in TpsUtil 32 (Rohlf, 2018a) with coordinate data digitized in TpsDig 2.32 (Rohlf, 2018b). Please see the manuscript text for a description of analyzes performed. Input data, analytical code, and output data/figures can be found in the Software section below, and at: https://github.com/bloispaleolab/Neotoma.m1.GM\n\nThe "All Images" folder contains images of all specimens analyzed and referenced in the manuscript (n = 229). It also contains two .tps files with landmark coordinate data obtained from lower first molars (m1s) of all specimens. These “Neotoma_combined_R1” and “Neotoma_combined_R2” files represent both landmarking repetitions of five extant Neotoma species from California (n = 199) combined with recent Neotoma cinerea specimens from Idaho and South Dakota (n = 13) and late Pleistocene fossil specimens from Project 23 deposits at Rancho La Brea (n = 16). Images and .tps files for each of those groups are also saved separately in the folders described below. Image files are named starting with genus and species first letter abbreviations (NX), then catalog number, then element (L= lower (mandible), LR = lower right (dentary)). Specimens are from the Museum of Vertebrate Zoology (MVZ) unless prefixed with P23 (Los Angeles County Museum of Paleontology, Rancho La Brea, Project 23) or SDSM (South Dakota School of Mines and Technology, Museum of Geology). For example, “NA_10467LR” = MVZ 10467 Neotoma albigula right dentary.\n\nThe “Recent CA Neotoma” folder contains images of recent Neotoma specimens from MVZ collected in California (n = 199). These images were obtained in November 2018 using a Dino-Lite Edge AM4815ZTL digital microscope. The folder also contains four .tps files: “Neotoma_extant_R1”, “Neotoma_extant_R2”, “WearVetted_R1”, and “WearVetted_R2”. The “Neotoma_extant” files contain landmark coordinate data for all 199 specimens. Twenty-eight of those specimens with very worn and nearly unworn molars were removed from the “WearVetted” files to evaluate wear-stage effects on tooth morphology. See manuscript Supplementary Table 1 for the list of removed specimens.\n\nThe “Unknowns” folder contains two subfolders: “East N.cinerea” and “LACMP23”. The “East N.cinerea” subfolder contains images of 12 Neotoma cinerea specimens from western South Dakota sampled from the SDSM Recent Vertebrates Collection (SDSM-SD-XXXXXX), and one specimen from Idaho sampled from MVZ (filename = “UCMVZ-ID-NC-51944L”). The SDSM specimens were photographed in November 2024 with a Dino-Lite Edge Plus AM4917MZT digital microscope and the MVZ specimen was photographed in November 2018 with a Dino-Lite Edge AM4815ZTL digital microscope. In this subfolder there is one .tps file with landmark coordinate data of all 13 specimens: “East_NC”. The “LACMP23” subfolder contains images of 16 late Pleistocene fossil m1s, and dentaries with m1s, from several Project 23 deposits at Rancho La Brea (P23_XXXXX). See manuscript Table 4 for the deposits each specimen was sampled from. Project 23 specimens were photographed between January and August of 2019 with a Dino-Lite Edge AM4815ZTL digital microscope. Left fossil elements were flipped to imitate right elements for analysis. This subfolder also contains one .tps file with landmark coordinate data of all 16 fossil specimens: “LACMP23”.\n\nReferences:\n\nRohlf, F.J., 2018a. TpsUtil version 1.76. Ecology & Evolution: (program), New York: Suny at Stony Brook.\n\nRohlf, F.J., 2018b. TpsDig version 2.31. Ecology & Evolution: (program), New York: Suny at Stony Brook."]} 
    more » « less
  4. {"Abstract":[" \n\nThis submission provides all the data and R code necessary to 1) generate the species distribution estimates and phenological predictions underlying all analyses, and 2) all results presented in the main text of the manuscript titled "Shifts in phenology and species ranges synergistically alter the timing and species composition of the flowering season" (Ramirez-Parada, Park, Peng, Nishino, Kartesz, Record, Davis, and Mazer, 2025). A preprint of this work can be accessed at: https://doi.org/10.32942/X28W5Z . This work was published in Global Change Biology (DOI: https://doi.org/10.1002/ecs2.70070).\n\nIn order for the code to work, users need to preserve the folder structure of the code and data, as the R Markdown files in the "Code" folder have relative file paths that read and write files within the "Data" folder and subfolders therein. These two folders are placed at the same level (i.e., they should both be stored within the same folder). Moving either will require re-writing the filepaths across Rmds.\n\nFor detailed descriptions of all materials (code and data) and instructions for using them, please refer to the "READ ME.md" file within "Project folder" and the main text of the manuscript.Note: This version corrects an error in  the .csv files containing the performance metrics for the three types of SDM fit for each species in the data (described in the main text). The previous version erroneously contained the performance metrics for the same model type across all three .csv files.\n\n "]} 
    more » « less
  5. Abstract: This dataset contains the data collected and presented in the manuscript "Role of microbial mats in bed evolution and the formation of sedimentary structures". It includes the bed topographies along the centerline of the channel for each tested case. Additionally, it contains the matlab codes used to process the data. TechnicalInfo: The file named "Data.zip" contains 7 folders, each one containing a .mat file with the longitudinal position, bed elevation and time interval for both abiotic and biotic cases. The file "MatLab_Codes.zip" contains the matlab codes used to process the data. 
    more » « less