dem_hillshade — DEM `shading` op

• Data kinds: depth → image2d

• Call: import fullseye as fs; fs.ledger.dem_hillshade(dem, cell_size, azimuth_deg=315.0, altitude_deg=45.0, z_factor=1.0, method='horn') (implementation को सीधे call करना हो तो import demops; demops.dem_hillshade(dem, cell_size, azimuth_deg=315.0, altitude_deg=45.0, z_factor=1.0, method='horn'), registry से लेना हो तो opsdem.get("dem_hillshade"))

• GPU: हाँ (allow-list का mechanical GPU path, CuPy)। device="auto" मापे गए आकार (4,194,304 pixel) और उससे बड़े पर GPU चुनता है

उपयोग

hillshade [0,1]। azimuth_deg प्रकाश स्रोत का azimuth है (उत्तर 0 degree, पूर्व की ओर बढ़ता)।

यह ज्यों-का-त्यों Lambert का cosine नियम है, और occlusion पर विचार नहीं किया जाता (cell के सामने की ridge से छाया में पड़ा भाग शामिल नहीं है)। यदि cast shadows चाहिए, तो dem_horizon_angle के साथ मिलाएँ —— यह मान लेना कि "hillshade में छायाएँ शामिल हैं" एक क्लासिक भ्रांति है।

समतल surface पर यह sin(altitude) के बराबर है (मापा गया 1e-15 या कम)।

उपयोग की विस्तृत 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 करते हैं)

• poc_dem_terrain — py -3.11 examples/poc_dem_terrain.py

• poc_lidar_terrain_change — py -3.11 examples/poc_lidar_terrain_change.py

• poc_stockpile_volume — py -3.11 examples/poc_stockpile_volume.py

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

—

इसी category के (`shading`)

—

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

dem_hillshade — DEM shading op