Esri 主页

  • ARCGIS

    ArcGIS 概览
    Esri 企业级地理空间平台
    ArcGIS Online
    完整的 SaaS 制图平台
    ArcGIS Pro
    世界领先的 GIS 软件
    ArcGIS Enterprise
    用于 GIS 和制图的基础系统
    开发者技术
    构建制图和空间分析应用程序
    所有产品

    功能

    制图
    从空间上查看和了解数据
    分析
    将位置引入分析
    数据管理
    管理、增强和共享 GIS 数据
    所有功能

    购买 ARCGIS

    用户类型
    基于角色的 ArcGIS 访问权限
    Esri 商店
    Esri 的 ArcGIS 产品
    如何购买
    Esri 产品、合作伙伴产品和开发人员订阅

    专题解决方案

    一张绿色阴影的山地等高线地图，标注有一个红色点，通过虚线与一个方形相连，表示两者之间的距离。
    ArcGIS for Operational Intelligence
    ArcGIS for Operational Intelligence 是一款地理空间软件，能够帮助分析人员从战略层面转向战术层面，将运营与情报数据转化为可执行的实时洞察。
    探索 ArcGIS for Operations Intelligence

  • 行业

    建筑、工程和建造
    商业
    Conservation
    教育
    能源公共设施
    设施点管理
    卫生与公共服务
    国家政府
    自然资源
    非营利机构
    公共安全
    自然科学
    州和地方政府
    可持续发展
    电信
    交通运输
    水
    所有行业

    专题倡议

    基础设施管理
    基础设施管理
    使用 GIS 创建现代化、有弹性且可持续发展的未来。 规划和运营的地理方法有助于领导者了解基础设施工程与周围环境的关系。
    探索基础设施管理

  • 支持与服务

    服务概述
    技术支持
    高级支持
    培训
    咨询服务
    托管云服务
    优势计划

    自助服务

    地理空间卓越之旅
    Esri 社区
    ArcGIS 博客
    文档
    My Esri

    联系我们

    联系支持部门

    专题培训

    城市街道地图，米色背景上用蓝色和绿色点标注了公用设施网络
    在 ArcGIS 中使用公共设施网络
    在为期两天的课程中，您将学习如何高效地创建和编辑网络功能、维护实用程序数据的完整性以及快速识别网络中断。
    立即注册

  • Esri 故事

    WhereNext Magazine
    高管级新闻和见解
    Esri 博客
    现实世界的全球 GIS 创新
    Esri 和 The Science of Where 播客
    商业和技术领导者之声
    ArcUser
    面向 ArcGIS 用户的实用技术资源
    ArcNews
    行业新闻和 ArcGIS 更新
    ArcWatch
    地理空间新闻、观点和趋势
    所有故事

    精选故事

    在大学公共区域，三排学生坐着或站着微笑并合影
    布拉德中心开创性的环境正义实习项目
    德克萨斯南方大学的学生获得了 GIS 软件方面应对污染和气候变化的基本知识和技能。
    阅读故事

  • 关于 Esri

    关于 Esri
    Esri 计划和倡议
    活动
    合作伙伴
    招贤纳士
    媒体与分析师关系
    联系我们

    关于 GIS

    什么是 GIS？
    地理方法

    致力于创新

    人工智能
    位置智能
    数字化转换
    数字孪生体

    特色资源

    三维数字地图显示水域附近建筑物的轮廓，其中一些建筑物用红色阴影表示气候风险
    气候一览表
    探索利用地理空间技术评估和减轻气候风险的数据驱动战略。 真实案例展示了如何保护企业、社区和我们的地球。
    查看清单
ArcGIS Pro
  • 概览
  • 扩展模块
    • Exploration and Visualization
    • Imagery
    • Data Management
    • 自定义和创建
    • Cartography
    • Analytics Data Science
    • Share your Work
    • Launch New Capabilities
    • 开发者工具
  • 资源
  • 免费试用
    • 定价
定价
  • 主页
  • 入门
  • 帮助
  • 工具参考
  • Python
  • SDK
工具参考地理处理工具“栅格分析”工具箱分析 Terrain 工具集

栅格分析工具箱概述

栅格分析工具箱概述 “栅格分析”工具箱许可 “栅格分析”工具箱历史

分析模式工具集

分析模式工具集概述 计算密度 插值点

分析 Terrain 工具集

分析 Terrain 工具集概述 创建视域 表面参数

深度学习工具集

深度学习工具集概述 使用深度学习分类对象 使用深度学习分类像素 使用深度学习检测对象

栅格综合工具集

栅格综合工具集概述 蚕食

水文分析工具集

水文分析工具集概述 填洼 流量 流向 流动距离 河流链 集水区

管理数据工具集

管理数据工具集概述 要素转栅格 栅格转要素

汇总数据工具集

汇总数据工具集概述 汇总范围内的栅格 以表格显示分区统计

邻近分析工具集

邻近分析工具集概述 距离累积 距离分配 最佳路径为线 最佳路径为栅格 最佳区域连接

使用邻近分析（旧版本）工具集

旧版本邻近分析工具集概述 计算距离 计算行程成本 成本路径折线 确定最佳行程成本网络 确定行程成本路径为折线 确定到目的地的行程成本路径
返回顶部
返回顶部

创建视域 (栅格分析)

此 ArcGIS 3.1 文档已 存档，并且不再对其进行更新。 其中的内容和链接可能已过期。 请参阅最新文档。

在本主题中

  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息

摘要

创建能够查看地面上对象的观察点区域。 输入观察点可以表示观察点（例如地面上的人或火警瞭望塔上的人）或被观察的对象（例如，风力涡轮机、水塔、车辆或其他人）。

观察点和被观察对象都距离地面向上有一定高度，这些高度可用于确定可见性。 例如，针对地面上 300 英尺的风力涡轮机和 6 英尺高的人计算得到的视域通常要比针对 200 英尺的涡轮机和 5 英尺高的人计算得到的视域大。

结果图层将记录输入表面栅格中每个像元位置对于输入观测点可见的次数。 不可见像元将得到 NoData 值。

插图

“创建视域”工具

使用情况

  • 当您登录到已针对 Raster Analysis 配置 ArcGIS Image Server 的 ArcGIS Enterprise 门户时，可以使用此栅格分析门户工具。 工具运行时，ArcGIS Pro 将充当客户端，并且处理将在与 ArcGIS Enterprise 联合的服务器中进行。 门户工具接受来自门户的图层作为输入，并在门户中创建输出。

    输入栅格图层支持门户中的图层、影像服务的 URI 或 URL 或者创建影像服务器图层工具的输出。 输入要素图层可以是门户中的图层或要素服务的 URI 或 URL。 此工具不支持本地栅格数据或图层。 虽然可以使用本地要素数据和图层作为此门户工具的输入，但是最佳做法是使用门户中的图层作为输入。

  • 每个像元中心的可见性都将通过目标和每个观察点之间的视线测试来确定。

参数

对话框Python

标注说明数据类型
输入高程表面

用于计算视域的高程表面。

如果输入表面的垂直单位与水平单位存在差异（例如，高程值用英尺表示，但坐标系用米表示），则该表面必须具有确定的垂直坐标系。 其原因在于，工具将使用垂直 (Z) 和水平 (XY) 单位来计算视域分析所需的 z 因子。 没有了垂直坐标系，也就没有了可用的 Z 单位信息，此时工具将假定 Z 单位与 XY 单位相同。 结果导致分析中将使用内部 Z 因子 1.0，从而导致意外的结果。

高程表面可为整型或浮点型。

Raster Layer; Image Service; String
观察点要素

计算视域时表示观察者位置的点要素。

Feature Set
输出名称

输出栅格服务的名称。

默认名称基于工具名称以及输入图层名称。 如果该图层名称已存在，则系统将提示您提供其他名称。

String
优化
(可选)

用于计算视域的优化方法。

  • 速度—此方法可优化处理速度，牺牲一些精度以获得更高的性能。 这是默认设置。
  • 精度—此方法可用来优化结果的精度，代价是需要更长的处理时间。
String
最大可视距离类型
(可选)

选择用于确定最大可视距离的方法。

如果将类型由距离更改为字段，则最大可视距离参数将更改为最大可视距离字段。

  • 距离—最大距离由指定值定义。 这是默认方法。
  • 字段—各观察点位置的最大距离由指定字段中的值来决定。
String
最大可视距离
(可选)

这就是停止计算可见区域的中断距离。 超出此距离，就无法确定观察点和其他对象互相能否看见。

单位值为千米、米、法定英里、国际码、国际英尺、美国测量英里、美国测量码和美国测量英尺。

默认值为 9 法定英里。

Linear Unit
最大可视距离字段
(可选)

您可以用此字段指定每个观察点的最大可视距离。 字段中包含的值的单位必须与输入高程表面的 XY 单位相同。

最大可视距离是停止计算可见区域的中断距离。 超出此距离，就无法确定观察点和其他对象互相能否看见。

Field
最小可视距离类型
(可选)

选择用于确定最小可视距离的方法。

如果将类型由距离更改为字段，则最小可视距离参数将更改为最小可视距离字段。

  • 距离—最小距离由您指定的值定义。 这是默认方法。
  • 字段—各观察点位置的最小距离由指定字段中的值来决定。
String
最小可视距离
(可选)

这就是开始计算可见区域的距离。 表面上小于此距离的像元在输出中不可见，但仍会妨碍最小可视距离和最大可视距离之间像元的可见性。

单位值为千米、米、法定英里、国际码、国际英尺、美国测量英里、美国测量码和美国测量英尺。

Linear Unit
最小可视距离字段
(可选)

您可以用此字段指定每个观察点的最小可视距离。 字段中包含的值的单位必须与输入高程表面的 XY 单位相同。

最小可视距离定义计算可见区域的起始点。 表面上小于此距离的像元在输出中不可见，但仍会妨碍最小可视距离和最大可视距离之间像元的可见性。

Field
可视距离为 3D 距离
(可选)

指定最小可视距离和最大可视距离参数是采用三维方式还是更简单的二维方式进行测量。 2D 距离是观察者和目标之间最简单的线性距离，通过两者在海平面上的投影位置测得。 3D 距离可将两者的相关高度纳入考量范围，从而能够得出更为真实的值。

  • 选中 - 可视距离在 3D 距离中测得。
  • 未选中 - 可视距离在 2D 距离中测得。 这是默认设置。
Boolean
观察点高程类型
(可选)

选择用于确定观察点高程的方法。

如果将类型由高程更改为字段，则观察点高程参数将更改为观察点高程字段。

  • 高程—观察点高程由指定的值定义。 这是默认方法。
  • 字段—每个观察点位置的高程由指定字段中的值来确定。
String
观察点高程
(可选)

这是观察点位置的高程。

如果未指定此参数，则会使用双线性插值法从表面栅格中获取观察点高程。 如果为此参数设置了一个值，则该值将应用到所有观察点。 要为每个观察点指定不同的值，请将此参数设置为输入观察点要素中的某个字段。

单位值为千米、米、法定英里、国际码、国际英尺、美国测量英里、美国测量码和美国测量英尺。

Linear Unit
观察点高程字段
(可选)

您可以用此字段指定观察点高程。 字段中包含的值的单位必须与输入高程表面的 Z 单位相同。

如果未指定此参数，则会使用双线性插值法从表面栅格中获取观察点高程。

Field
观察点高度类型
(可选)

选择用于确定观察点高度的方法。

如果将类型由高度更改为字段，则观察点高度参数将更改为观察点高度字段。

  • 高度—观察点高度通过指定的值获得。 这是默认方法。
  • 字段—每个观察点位置的高度由指定字段中的值来确定。
String
观察点高度
(可选)

这是用于观察点位置的高度。

单位值为千米、米、法定英里、国际码、国际英尺、美国测量英里、美国测量码和美国测量英尺。

默认值为 6 国际英尺。

Linear Unit
观察点高度字段
(可选)

您可以用此字段指定观察点高度。 字段中包含的值的单位必须与输入高程表面的 Z 单位相同。

Field
目标高度类型
(可选)

选择用于确定目标高度的方法。

如果将类型由高度更改为字段，则目标高度参数将更改为目标高度字段。

  • 高度—目标高度通过指定的值获得。 这是默认方法。
  • 字段—每个目标的高度由指定字段中的值来确定。
String
目标高度
(可选)

这是地面上建筑物或人的高度，用于确立可见性。 结果视域为观察点可看到这些其他对象的区域。 反之亦然，其他对象也可以看到观察点。

单位值为千米、米、法定英里、国际码、国际英尺、美国测量英里、美国测量码和美国测量英尺。

Linear Unit
目标高度字段
(可选)

您可以用此字段指定目标高度。 字段中包含的值的单位必须与输入高程表面的 Z 单位相同。

Field
地平面以上输出名称
(可选)

地平面以上 (AGL) 栅格输出结果的名称。 AGL 结果是一个栅格，其中每个像元值都记录了为保证像元至少对一个观察点可见而需要向该像元添加的最小高度（若不添加此高度，像元不可见）。 在输出栅格中为已可见的像元分配 0。

String

派生输出

标注说明数据类型
输出栅格

输出视域栅格。

Raster Layer
输出地平面以上栅格

地面以上输出栅格。

Raster Layer

arcpy.ra.CreateViewshed(inputElevationSurface, inputObserverFeatures, outputName, {optimizeFor}, {maximumViewingDistanceType}, {maximumViewingDistance}, {maximumViewingDistanceField}, {minimumViewingDistanceType}, {minimumViewingDistance}, {minimumViewingDistanceField}, {viewingDistanceIs3D}, {observersElevationType}, {observersElevation}, {observersElevationField}, {observersHeightType}, {observersHeight}, {observersHeightField}, {targetHeightType}, {targetHeight}, {targetHeightField}, {aboveGroundLevelOutputName})
名称说明数据类型
inputElevationSurface

用于计算视域的高程表面。

如果输入表面的垂直单位与水平单位存在差异（例如，高程值用英尺表示，但坐标系用米表示），则该表面必须具有确定的垂直坐标系。 其原因在于，工具将使用垂直 (Z) 和水平 (XY) 单位来计算视域分析所需的 z 因子。 没有了垂直坐标系，也就没有了可用的 Z 单位信息，此时工具将假定 Z 单位与 XY 单位相同。 结果导致分析中将使用内部 Z 因子 1.0，从而导致意外的结果。

高程表面可为整型或浮点型。

Raster Layer; Image Service; String
inputObserverFeatures

计算视域时表示观察者位置的点要素。

Feature Set
outputName

输出栅格服务的名称。

默认名称基于工具名称以及输入图层名称。 如果该图层名称已存在，则系统将提示您提供其他名称。

String
optimizeFor
(可选)

用于计算视域的优化方法。

  • SPEED—此方法可优化处理速度，牺牲一些精度以获得更高的性能。 这是默认设置。
  • ACCURACY—此方法可用来优化结果的精度，代价是需要更长的处理时间。
String
maximumViewingDistanceType
(可选)

选择用于确定最大可视距离的方法。

  • DISTANCE—最大距离由指定值定义。 这是默认方法。
  • FIELD—各观察点位置的最大距离由指定字段中的值来决定。
String
maximumViewingDistance
(可选)

这就是停止计算可见区域的中断距离。 超出此距离，就无法确定观察点和其他对象互相能否看见。

单位值为 Kilometers、Meters、MilesInt、YardsInt、FeetInt、Miles、Yards 和 Feet。

默认值为 9 法定英里。

Linear Unit
maximumViewingDistanceField
(可选)

您可以用此字段指定每个观察点的最大可视距离。 字段中包含的值的单位必须与输入高程表面的 XY 单位相同。

最大可视距离是停止计算可见区域的中断距离。 超出此距离，就无法确定观察点和其他对象互相能否看见。

Field
minimumViewingDistanceType
(可选)

选择用于确定最小可视距离的方法。

  • DISTANCE—最小距离由您指定的值定义。 这是默认方法。
  • FIELD—各观察点位置的最小距离由指定字段中的值来决定。
String
minimumViewingDistance
(可选)

这就是开始计算可见区域的距离。 表面上小于此距离的像元在输出中不可见，但仍会妨碍最小可视距离和最大可视距离之间像元的可见性。

单位值为 Kilometers、Meters、MilesInt、YardsInt、FeetInt、Miles、Yards 和 Feet。

Linear Unit
minimumViewingDistanceField
(可选)

您可以用此字段指定每个观察点的最小可视距离。 字段中包含的值的单位必须与输入高程表面的 XY 单位相同。

最小可视距离定义计算可见区域的起始点。 表面上小于此距离的像元在输出中不可见，但仍会妨碍最小可视距离和最大可视距离之间像元的可见性。

Field
viewingDistanceIs3D
(可选)

指定最小可视距离和最大可视距离参数是采用三维方式还是更简单的二维方式进行测量。 2D 距离是观察者和目标之间最简单的线性距离，通过两者在海平面上的投影位置测得。 3D 距离可将两者的相关高度纳入考量范围，从而能够得出更为真实的值。

  • 2D—可视距离在 2D 距离中测得。 这是默认设置。
  • 3D—可视距离在 3D 距离中测得。
Boolean
observersElevationType
(可选)

选择用于确定观察点高程的方法。

  • ELEVATION—观察点高程由指定的值定义。 这是默认方法。
  • FIELD—每个观察点位置的高程由指定字段中的值来确定。
String
observersElevation
(可选)

这是观察点位置的高程。

如果未指定此参数，则会使用双线性插值法从表面栅格中获取观察点高程。 如果为此参数设置了一个值，则该值将应用到所有观察点。 要为每个观察点指定不同的值，请将此参数设置为输入观察点要素中的某个字段。

单位值为 Kilometers、Meters、MilesInt、YardsInt、FeetInt、Miles、Yards 和 Feet。

Linear Unit
observersElevationField
(可选)

您可以用此字段指定观察点高程。 字段中包含的值的单位必须与输入高程表面的 Z 单位相同。

如果未指定此参数，则会使用双线性插值法从表面栅格中获取观察点高程。

Field
observersHeightType
(可选)

选择用于确定观察点高度的方法。

  • HEIGHT—观察点高度通过指定的值获得。 这是默认方法。
  • FIELD—每个观察点位置的高度由指定字段中的值来确定。
String
observersHeight
(可选)

这是用于观察点位置的高度。

单位值为 Kilometers、Meters、MilesInt、YardsInt、FeetInt、Miles、Yards 和 Feet。

默认值为 6 国际英尺。

Linear Unit
observersHeightField
(可选)

您可以用此字段指定观察点高度。 字段中包含的值的单位必须与输入高程表面的 Z 单位相同。

Field
targetHeightType
(可选)

选择用于确定目标高度的方法。

  • HEIGHT—目标高度通过指定的值获得。 这是默认方法。
  • FIELD—每个目标的高度由指定字段中的值来确定。
String
targetHeight
(可选)

这是地面上建筑物或人的高度，用于确立可见性。 结果视域为观察点可看到这些其他对象的区域。 反之亦然，其他对象也可以看到观察点。

单位值为 Kilometers、Meters、MilesInt、YardsInt、FeetInt、Miles、Yards 和 Feet。

Linear Unit
targetHeightField
(可选)

您可以用此字段指定目标高度。 字段中包含的值的单位必须与输入高程表面的 Z 单位相同。

Field
aboveGroundLevelOutputName
(可选)

地平面以上 (AGL) 栅格输出结果的名称。 AGL 结果是一个栅格，其中每个像元值都记录了为保证像元至少对一个观察点可见而需要向该像元添加的最小高度（若不添加此高度，像元不可见）。 在输出栅格中为已可见的像元分配 0。

String

派生输出

名称说明数据类型
outputRaster

输出视域栅格。

Raster Layer
outputAboveGroundLevelRaster

地面以上输出栅格。

Raster Layer

代码示例

CreateViewshed 示例 1（Python 窗口）

本示例使用给定表面和观察点来创建视域影像服务。

import arcpy

arcpy.ra.CreateViewshed(
    "https://myserver/rest/services/elevation/ImageServer", 
    "https://myserver/rest/services/destination/FeatureServer/0", 
    "outview1", "SPEED", "DISTANCE", "9 Miles", "#", "DISTANCE",
    "0 Meters", "#", "2D", "ELEVATION", "#", "#", "HEIGHT",
    "6 Feet", "#", "HEIGHT", "3 Feet", "#", "outagl1")
CreateViewshed 示例 2（独立脚本）

本示例使用给定表面和观察点来创建视域影像服务。

#---------------------------------------------------------------------------
# Name: CreateViewshed_example02.py
# Description: Creates a viewshed image service raster from given surface
#   and observer points.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSurface = "https://myserver/rest/services/elevation/ImageServer"
inObservers = "https://myserver/rest/services/destination/FeatureServer/0"
outputViewshed = "outview1"
optimizeFor = "Speed"
maxDistType = "Distance"
maxDist = "9 Miles"
maxDistField = "#"
minDistType = "Distance"
minDist = "0 Miles"
minDistField = "#"
distanceIs3D = "2D"
obsElevationType = "Elevation"
obsElevation = "#"
obsElevationField = "#"
obsOffsetType = "Height"
obsOffset = "6 Feet"
obsOffsetField = "#"
surfOffsetType = "Height"
surfOffset = "3 Feet"
surfOffsetField = "#"
outputAgl = "outagl1"

# Execute Create Viewshed raster analysis tool
arcpy.ra.CreateViewshed(
    inSurface, inObservers, outputViewshed, optimizeFor,
    maxDistType, maxDist, maxDistField, minDistType, minDist,
    minDistField, distanceIs3D, obsElevationType, obsElevation,
    obsElevationField, obsOffsetType, obsOffset, obsOffsetField,
    surfOffsetType, surfOffset, surfOffsetField, outputAgl)

环境

范围, 像元大小, 掩膜, 输出坐标系, 金字塔, 捕捉栅格

许可信息

  • Basic: 需要 ArcGIS Image Server
  • Standard: 需要 ArcGIS Image Server
  • Advanced: 需要 ArcGIS Image Server

相关主题

  • 分析 Terrain 工具集概述
  • 查找地理处理工具
  • 测地线视域
  • 视域函数
在本主题中
  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息
有关 Esri 和 The Science of Where 的详细信息Esri: The Science of Where
  • FacebookFacebook
  • XTwitter
  • LinkedInLinkedIn
  • Esri CommunityEsri Community
  • InstagramInstagram
  • YouTubeYouTube_30
ArcGIS
  • ArcGIS 概览
  • 制图
  • ArcGIS Pro
  • ArcGIS Enterprise
  • ArcGIS Online
  • 开发者技术
  • ArcGIS Location Platform
  • Esri 商店
  • ArcGIS Architecture Center
社区
  • Esri 社区
  • ArcGIS 博客
  • 行业博客
  • 用户研究和测试
  • Esri 年轻专家关系网
  • 活动
了解 GIS
  • 什么是 GIS？
  • 位置智能
  • 培训
  • ArcUser
  • ArcNews
  • ArcWatch
  • Esri Press
  • Esri 视频
公司
  • 关于 Esri
  • 联系我们
  • 招贤纳士
  • 开放视野
  • 合作伙伴
  • 业务行为准则
  • 环境可持续性声明
特殊计划
  • ArcGIS for Personal Use
  • ArcGIS for Student Use
  • Conservation
  • 灾难响应
  • 教育
  • 非营利机构
  • 种族平等
  • 隐私策略
  • 无障碍性
  • 法律声明
  • 网站地图
  • 信任中心