Python ArcGIS create_viewshed用法及代码示例

本文简要介绍 python 语言中 arcgis.features.analysis.create_viewshed 的用法。

用法:

arcgis.features.analysis.create_viewshed(input_layer, dem_resolution='Finest', maximum_distance=None, max_distance_units='Meters', observer_height=None, observer_height_units='Meters', target_height=None, target_height_units='Meters', generalize=True, output_name=None, context=None, gis=None, estimate=False, future=False)

返回：

result_layer：如果指定了output_name，则为 FeatureLayer ，否则为 FeatureCollection 。

create_viewshed 方法根据您提供的观察者位置识别可见区域。结果是观察者可以看到被观察对象的区域(并且被观察对象可以看到观察者)。

Parameter	Description
input_layer	所需的点要素图层。用作观察者位置的要素。请参阅特征输入。
dem_resolution	可选字符串。用于计算的源高程数据的近似空间分辨率(像元大小)。 分辨率值是数字高程模型的空间分辨率的近似值。虽然许多高程源以弧秒为单位分布，但关键字是这些分辨率的近似值，以米为单位，以便于理解。 选择列表：['FINEST'，‘10m’, ‘24m’，‘30m’, ‘90m’] 默认是可用的最高分辨率。
maximum_distance	可选浮点数。这是可见区域计算停止的截止距离。超出这个距离，不知道分析点和其他物体是否能看到对方。 它对于模拟当前天气状况或一天中的给定时间(例如黄昏)很有用。较大的值会增加计算时间。 除非指定，否则将根据源 DEM 的分辨率和范围计算默认最大距离。允许的最大值为 50 公里。使用max_distance_units 设置maximum_distance 的单位。
max_distance_units	可选字符串。 maximum_distance 参数的单位。 选择列表：[“米”、“公里”、“英尺”、“英里”、“码”] 默认值为“米”。
observer_height	可选浮点数。这是观察者位置离地面的高度。 默认值为 1.75 米，大约是一个人的平均身高。如果您从高处观看，例如观景塔或高层建筑，请改用该高度。 使用observer_height_units 设置observer_height 的单位。
observer_height_units	可选字符串。 observer_height 参数的单位。 选择列表：[“米”、“公里”、“英尺”、“英里”、“码”] 默认值为“米”。
target_height	可选浮点数。这是用于建立能见度的地面结构或人员的高度。结果视域是输入点可以看到这些其他对象的区域。反之亦然；其他对象可以看到输入点。 如果您的输入点代表风力涡轮机，并且您想确定站在地面上的人可以看到涡轮机的位置，请输入一个人的平均身高(大约 6 英尺)。结果是那些站在地面上的人可以看到风力涡轮机的区域。 如果您的输入点代表火警瞭望塔，并且您想要确定哪些瞭望塔可以看到 20 英尺高或更高的烟羽，请输入 20 英尺作为高度。结果是火灾了望塔可以看到至少 20 英尺高的烟羽的区域。 如果您的输入点表示沿道路和小径的风景俯瞰，并且您想确定可以看到 400 英尺高或更高的风力涡轮机的位置，请输入 400 英尺作为高度。结果是那些站在风景优美的俯瞰处的人可以看到至少 400 英尺高的风力涡轮机的区域。 如果您的输入点代表风景优美的俯瞰，并且您想确定站在俯瞰处的人可以看到多少地面区域，请输入零。结果是可以从风景优美的俯瞰中看到的那些区域。 使用target_height_units 设置target_height 的单位。
target_height_units	可选字符串。 target_height 参数的单位。 选择列表：[“米”、“公里”、“英尺”、“英里”、“码”] 默认值为“米”。
generalize	可选的布尔值。确定是否要概化视域多边形。 视域计算基于栅格高程模型，该模型创建带有 stair-stepped 边的结果。为了创建更令人愉悦的外观并提高性能，默认行为是概括多边形。泛化过程平滑了可见区域的边界，并且可以去除一些单细胞可见区域。 默认值是true。
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。处理范围和输出空间参考等附加设置。对于create_viewshed，有三个设置。 extent - 定义分析区域的边界框。仅分析input_layer 中与边界框相交的那些特征。 outSR - 输出要素将投影到 wkid 引用的输出空间参考中。 overwrite - 如果为 True，则 output_name 中的要素层将被新要素层覆盖。适用于 ArcGIS Online 或 Enterprise 10.9.1+ # Example Usage context = {"extent": {"xmin": 3164569.408035, "ymin": -9187921.892449, "xmax": 3174104.927313, "ymax": -9175500.875353, "spatialReference":{"wkid":102100,"latestWkid":3857}}, "outSR": {"wkid": 3857}, "overwrite": True}
gis	可选，运行此工具的 GIS 。如果未指定，则使用活动 GIS。
estimate	可选的布尔值。如果为 True，则将返回运行该操作所需的估计积分数。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。

例子：

# USAGE EXAMPLE: To create viewshed around esri headquarter office.

viewshed3 = create_viewshed(hq_lyr,
                    maximum_distance=9,
                    max_distance_units='Miles',
                    target_height=6,
                    target_height_units='Feet',
                    output_name="create Viewshed")