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