calculate_surface_roughness

功能概述

利用【输入DEM栅格文件】、【邻域统计半径】、【随机糙度因子】计算calculate_surface_roughness，并输出生态评价结果栅格。

原理简介

该工具用于生成生态评价模型中的中间因子或结果栅格。计算以输入栅格逐像元对应为基础，因此应尽量保证所有输入栅格采用相同的坐标系、分辨率和空间范围。

适用场景

• 作为生态系统服务评估或生态质量评价模型的中间因子栅格。
• 为土壤保持、水源涵养、气候调节等专题模型提供参数输入。
• 在区域生态对比分析中统一生成可量化、可叠加的评价指标。

参数介绍

参数名称	参数描述	补充说明
输入DEM栅格文件	输入的数字高程模型(DEM)栅格文件路径	必填
邻域统计半径	邻域统计半径，单位：米	必填；默认值：2000
使用8邻域统计	是否使用8邻域统计。如果为False，则使用圆形邻域	必填；默认值：True
随机糙度因子	随机糙度因子，单位：厘米	必填；默认值：0
输出地表粗糙度因子栅格文件	输出的地表粗糙度因子栅格文件路径	必填

操作步骤

1. 启动工具：打开【计算工具箱】工具箱 → 导航至【ecological_evaluation】 > 【climate_factor】 → 启动【calculate_surface_roughness】工具窗格。
2. 准备输入：按数据类型选择【输入DEM栅格文件】，确认输入数据完整且可正常读取。
3. 设置核心参数：根据业务目标配置【邻域统计半径】、【使用8邻域统计】、【随机糙度因子】，必要时结合单位、阈值、统计方法或插值方式进行调整。
4. 设置输出：指定【输出地表粗糙度因子栅格文件】，并确认输出路径、格式和命名规则满足后续使用需求。
5. 运行并检查结果：点击【运行】执行任务，完成后检查结果数据的范围、数值分布、字段结构或空间位置是否符合预期。

注意事项

• 涉及多幅栅格联合计算时，优先确认坐标系、分辨率、范围和网格对齐方式一致。
• DEM 中的空洞、噪声和异常高程会直接影响坡度、坡向、曲率等地形因子结果。
• 生态评价因子通常具有明确单位或无量纲含义，输入前应确认单位体系一致。
• 若源码中会自动重采样对齐输入栅格，仍建议事先检查参考栅格和目标栅格的一致性。