当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


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.png

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")

相关用法


注:本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 arcgis.features.analysis.create_viewshed。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。