dem_stream_network — DEM hydrology op

• Data kinds: depth → image2d

• Call: import fullseye as fs; fs.ledger.dem_stream_network(dem, cell_size, threshold_cells=100.0, fill=True, nodata='error') (implementation को सीधे call करना हो तो import demops; demops.dem_stream_network(dem, cell_size, threshold_cells=100.0, fill=True, nodata='error'), registry से लेना हो तो opsdem.get("dem_stream_network"))

उपयोग

binary mask जो उन cell को stream channel मानता है जिनका flow accumulation threshold से अधिक है।

प्रक्रिया: हर cell की accumulated cell count (cell स्वयं को 1 गिनते हुए) पाने के लिए dem_flow_accumulation(dem, cell_size, fill, nodata) का उपयोग करें, acc >= threshold_cells को 1 और बाकी सब को 0 करें। missing cells nan ही रहते हैं।

• threshold_cells: वह accumulated cell count जिसे channel माना जाता है। धनात्मक finite (ValueError)। क्षेत्रफल से तय करने के लिए area [m^2] / cell_size^2 में बदलकर वह पास करें (यह op केवल cell counts स्वीकार करता है)।

• fill=True (डिफ़ॉल्ट): पहले priority-flood से sinks भरें (dem_fill_sinks, epsilon=1e-6)। अन्यथा प्रवाह sinks में रुक जाता है, downstream accumulation छोटा आता है, और channels टूट जाते हैं।

• nodata: "error" (डिफ़ॉल्ट, nan मौजूद होने पर अस्वीकार) / "outlet" (missing = outlet, जलाशयों के लिए उपयुक्त) / "barrier" (missing = दीवार)। छेदों को constant से भरने का कोई विकल्प नहीं है।

• dem / cell_size का contract dem_slope के समान है (3x3 या बड़ा, sentinel मान अस्वीकार, [m])।

• return value: 0 / 1 का (H, W) float64 (missing nan है)। bool नहीं है, इसलिए blob_label आदि को पास करने से पहले == 1 से binarise करें।

• जटिलता: accumulation के लिए topological sweep सभी cells पर Python loop है।

D8 flow direction (dem_flow_direction) पर आधारित होने के कारण, समतल reclaimed भूमि पर प्रवाह एक ही जगह पर अभिसरित होने लगता है ―― threshold को बहुत नीचे करने से grid के आकार के नकली channels बनते हैं।

उपयोग की विस्तृत guide

• dem_terrain_analysis family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• dem_terrain_analysis_tour — py -3.11 examples/dem_terrain_analysis_tour.py

वे अगले ops जिनसे type जुड़ता है (image2d को input के रूप में लेते हैं)

—

इसी category के (hydrology)

dem_fill_sinks · dem_flow_direction · dem_flow_accumulation


*Provenance: demops.py — DEM operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.