Jinghe River Basin Spatial Overlap Frequency (SOF): Final Data and Processing Code

Description

This dataset supports the analysis of drainage-divide hierarchy in the Jinghe River Basin using Spatial Overlap Frequency (SOF). It includes the final SOF boundary raster derived using a flow-accumulation threshold of 3,140 cells, drainage-divide polylines, point-level geomorphic and hydrologic attributes, an analysis-ready GeoPackage table, threshold-sensitivity metrics, and reference figures supplied with the dataset. The final spatial products are provided both as an ArcGIS Pro 3.6 project package and as standalone GeoTIFF and Shapefile datasets. The point-level analytical table contains SOF, slope, drainage-divide polygonal-region area, drainage-divide line length, divide relief, elevation, maximum downstream flow length (FLD), Negative Openness, and inverted-DEM Shreve and Strahler attributes. The deposited code package contains author-supplied MATLAB scripts with English-translated comments and the ArcGIS Pro ModelBuilder toolbox used in the processing workflow, together with reference outputs and a Python utility added to reproduce the principal SOF-flow-length analytical fit. Raw ASTER GDEM V2 tiles and routine full-basin intermediate hydrological rasters are not redistributed because the source elevation data are available from NASA LP DAAC and the omitted processing products can be regenerated from the documented workflow. Detailed file descriptions, field definitions, units, provenance records, validation results, software requirements, licences, and reproducibility limitations are provided in README.md and the accompanying documentation. File sizes and SHA-256 checksums are provided in FILE_MANIFEST.csv and Jinghe_SOF_Code/docs/FILE_MANIFEST.csv.

Steps to reproduce

1. Download the complete dataset and keep the folder structure unchanged. 2. To inspect the final spatial products, open Jinghe_SOF_Final_Data.ppkx in ArcGIS Pro 3.6, or load the standalone products in spatial_exports/: Jinghe_SOF_T3140.tif, Jinghe_SOF_divides_T3140.shp, and SOF_points.shp. 3. To reproduce the final SOF-flow-length analytical fit, run the following command from the dataset root folder: python Jinghe_SOF_Code/python/reproduce_final_flow_length_fit.py The script reads source_table.gpkg and writes/updates Jinghe_SOF_Code/reference_outputs/final_flow_length_fit.csv. 4. To reproduce the deposited MATLAB stream-link hierarchy table, run the MATLAB workflow from Jinghe_SOF_Code/matlab/core using the provided topology input file Jinghe_SOF_Code/inputs/topology/datalink_1.xlsx. The expected output is Jinghe_SOF_Code/reference_outputs/test.csv. 5. To rerun the full DEM-to-SOF workflow, obtain the required ASTER GDEM V2 DEM tiles from NASA LP DAAC. In ArcGIS Pro 3.6, preprocess the DEM using Fill, Flow Direction, Flow Accumulation, stream extraction with a 3,140-cell threshold, Stream Link, Watershed, and Raster To Polygon. Keep the same snap raster, cell size, processing extent, coordinate system, and full-basin processing domain when reproducing the deposited Jinghe result. 6. Use the MATLAB hierarchy output as the reclassification table for the Stream Link raster, then run the deposited ArcGIS Pro ModelBuilder toolbox in Jinghe_SOF_Code/arcgis_toolbox/tool.atbx to generate nested catchment rasters. Before rerunning the toolbox, redirect the saved ModelBuilder paths to writable local workspaces. 7. Generate the SOF raster by combining the nested catchment rasters with equal weights, applying a 3 x 3 Focal Statistics range operation, converting the result to integer format, and converting the final raster-derived boundary result to vector polylines. The deposited final products corresponding to this stage are spatial_exports/Jinghe_SOF_T3140.tif and spatial_exports/Jinghe_SOF_divides_T3140.shp. 8. To reproduce the point-level product, follow Step 5 in Jinghe_SOF_Code/README.md. In summary, convert the raster-derived divide lines to polygons, sample the SOF raster at polygon points, dissolve to single-part SOF regions, simplify boundaries, derive centerlines, generate centerline-associated sampling points, extract geomorphic and hydrologic raster values to those points, and standardize the fields to produce SOF_points.shp and source_table.gpkg. 9. Refer to README.md, spatial_exports/README.md, figures/README.md, and Jinghe_SOF_Code/docs/WORKFLOW.md for file descriptions, field definitions, units, provenance, software requirements, path limitations, and known reproducibility boundaries.

Institutions

• Anhui University

  Anhui, Hefei
• Sun Yat-sen University

  Guangdong, Guangzhou

Categories

Related Links

Licence