更新定向影像数据集属性 (定向影像)

摘要

用于更新或修改定向影像数据集属性。

使用情况

    警告:

    此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略,请参阅修改或更新输入数据的工具

  • 数据集属性可用于优化数据集。 如果任何数据集属性作为属性表中的字段存在,并且所有记录的值均相同,则可以从属性表中移除字段,并将该值设置为数据集属性。 如果属性表中存在该字段,则属性表值将优先于数据集属性值。

  • 如果必须使用 Python 中的工具以移除字符串数据类型参数,请提供值 "None"

参数

标注说明数据类型
定向影像数据集

定向影像数据集的路径和名称。

Oriented Imagery Layer
最大距离
(可选)

查询数据集要素时将使用的最大搜索距离。 最大距离不能小于零。 单位为米。

Double
覆盖范围百分比
(可选)

修改图像地面覆盖区范围的百分比。 将计算每个图像的地面覆盖区以搜索包含所选位置的图像,该位置在地图上标识为红十字。

负百分比值会减小地面覆盖区的大小,正百分比值会增大地面覆盖区的大小。 此参数可用于排除或包含图像边上的点。 例如,值 -30 将使覆盖区大小减小 30%,值 20 将使覆盖区大小增大 20%。 有效值范围为 -50 到 50。

Double
覆盖区项目
(可选)

覆盖区要素类的名称。 要素类应与定向影像数据集位于同一地理数据库中。

String
高程源
(可选)

指定将使用的高程源。

  • DEM高程源将是数字高程模型,即动态影像服务或切片影像服务。
  • 常量高程高程源将是整个数据集的常量地面高程值。
  • 将移除高程源。
String
常量高程
(可选)

整个数据集的常量地面高程值。 垂直测量单位参数值将用作常量高程的单位。

高程源参数值指定为常量高程时,此参数处于活动状态。

Double
数字高程模型
(可选)

引用输入数字高程模型的 URL。 动态影像服务或切片影像服务可以用作数字高程模型。

高程源参数值指定为 DEM 时,此参数处于活动状态。

Image Service
细节层次
(可选)

在切片方案中定义的比例。 比例表示缩放级别值。 与前一级别相比,每个连续级别的分辨率和地图比例都会提高一倍。

数字高程模型参数值为切片影像服务时,将启用此参数。

String
栅格函数
(可选)

可应用于影像服务的栅格函数处理模板。

数字高程模型参数值为动态影像服务时,此参数处于活动状态。

String
垂直测量单位
(可选)

指定将用于所有垂直测量的单位。

  • 将使用米作为测量单位。
  • 英尺将使用英尺作为测量单位。
String
时间间隔单位
(可选)

指定将用于过滤图像的时间测量单位。

  • 将按分钟过滤图像。
  • 小时将按小时过滤图像。
  • 将按天过滤图像。
  • 将按周过滤图像。
  • 将按月过滤图像。
  • 将按年过滤图像。
String
定向影像类型
(可选)

指定数据集中图像的类型。

  • 水平数据集中包含曝光平行于地面且朝向地平线的图像。
  • 倾斜数据集中存在曝光与地面成一定角度(通常约为 45 度),由此可以看到对象侧面的图像。
  • 像底点数据集中包含曝光垂直于地面且直视下方的图像。 只能看到对象的顶部。
  • 360数据集中包含使用提供 360 度球形环绕视图的相机拍摄的图像或者已将多个相机的 360 度视图拼接在一起的图像。
  • 检查资产的特写图像位于数据集中。
  • 将从数据集中移除定向影像类型。
String
相机朝向
(可选)

围绕相机 z 轴第一次旋转的相机方向。 该值以度为单位。 将以正顺时针方向测量朝向值,其中北向定义为 0 度。 当方向未知时,将使用 -999。

Double
相机仰俯角
(可选)

围绕相机 x 轴以正逆时针方向第二次旋转的相机方向。 该值以度为单位。 当相机正对地面时,俯仰角为 0 度。 俯仰角的有效范围为 0 到 180 度,其中 180 度表示相机正对上方,90 度表示相机面向地平线。

Double
相机转动
(可选)

围绕相机 z 轴以正顺时针方向最终旋转的相机方向。 该值以度为单位。 有效值范围为 -90 到 90。

Double
相机高度
(可选)

当捕获影像时,相机高于地面的高度。 单位为米。 相机高度用于确定图像的可见范围。 较大的值将导致更大的视图范围。 值不应小于 0。

Double
水平视域
(可选)

水平方向的相机范围。 该值以度为单位。 有效值的范围为 0 到 360。

Double
垂直视域
(可选)

垂直方向的相机范围。 该值以度为单位。 有效值介于 0 到 180 之间。

Double
近距离
(可选)

影像距相机位置的最近可用距离。 单位为米。

Double
远距离
(可选)

影像距相机位置的最远可用距离。 单位为米。 远距离应大于 0。

Double
图像旋转
(可选)

当捕获图像时,相机相对于场景的方向(以度为单位)。 除了相机转动之外,还添加了旋转。 有效值的范围为 -360 到 360。

Double
定向精度
(可选)

以分号分隔的精度值的标准差。 将按以下顺序和格式添加标准差值:

  • 相机在 XY 方向的位置(以米为单位)
  • 相机高度(以米为单位)
  • 相机朝向(以度为单位)
  • 相机仰俯角(以度为单位)
  • 相机转动(以度为单位)
  • 近距离(以米为单位)
  • 远距离(以米为单位)
  • 高程(以米为单位)

例如,如果 GPS 在 x,y 坐标上的 RMS 值为 +/- 10 米,高度为 +/- 20 米,则定向精度值为 10;20。

String
图像路径前缀
(可选)

将用于与 Image 属性一起构建图像路径的前缀。

String
图像路径后缀
(可选)

将用于与 Image 属性一起构建图像路径的后缀。

String
深度图像路径前缀
(可选)

将用于与 Depth Image 属性一起构建深度图像路径的前缀。

String
深度图像路径后缀
(可选)

将用于与 Depth Image 属性一起构建深度图像路径的后缀。

String
DEM 路径前缀
(可选)

将用于与属性中的 Elevation Source URL 一起构建 DEM 路径的前缀。

String
DEM 路径后缀
(可选)

将用于与属性中的 Elevation Source URL 一起构建 DEM 路径的后缀。

String

派生输出

标注说明数据类型
输出定向影像数据集

更新的定向影像数据集。

Oriented Imagery Dataset

arcpy.management.UpdateOrientedImageryDatasetProperties(in_oriented_imagery_dataset, {maximum_distance}, {coverage_percent}, {footprint_item}, {elevation_source}, {constant_elevation}, {dem}, {lod}, {raster_function}, {vertical_measurement_unit}, {time_interval_unit}, {oriented_imagery_type}, {camera_heading}, {camera_pitch}, {camera_roll}, {camera_height}, {hfov}, {vfov}, {near_distance}, {far_distance}, {image_rotation}, {orientation_accuracy}, {image_path_prefix}, {image_path_suffix}, {depth_image_path_prefix}, {depth_image_path_suffix}, {dem_path_prefix}, {dem_path_suffix})
名称说明数据类型
in_oriented_imagery_dataset

定向影像数据集的路径和名称。

Oriented Imagery Layer
maximum_distance
(可选)

查询数据集要素时将使用的最大搜索距离。 最大距离不能小于零。 单位为米。

Double
coverage_percent
(可选)

修改图像地面覆盖区范围的百分比。 将计算每个图像的地面覆盖区以搜索包含所选位置的图像,该位置在地图上标识为红十字。

负百分比值会减小地面覆盖区的大小,正百分比值会增大地面覆盖区的大小。 此参数可用于排除或包含图像边上的点。 例如,值 -30 将使覆盖区大小减小 30%,值 20 将使覆盖区大小增大 20%。 有效值范围为 -50 到 50。

Double
footprint_item
(可选)

覆盖区要素类的名称。 要素类应与定向影像数据集位于同一地理数据库中。

String
elevation_source
(可选)

指定将使用的高程源。

  • DEM高程源将是数字高程模型,即动态影像服务或切片影像服务。
  • CONSTANT_ELEVATION高程源将是整个数据集的常量地面高程值。
  • NONE将移除高程源。
String
constant_elevation
(可选)

整个数据集的常量地面高程值。 vertical_measurement_unit 参数值将用作常量高程的单位。

如果将 elevation_source 参数值指定为 CONSTANT_ELEVATION,将启用此参数。

Double
dem
(可选)

引用输入数字高程模型的 URL。 动态影像服务或切片影像服务可以用作数字高程模型。

如果将 elevation_source 参数值指定为 DEM,将启用此参数。

Image Service
lod
(可选)

在切片方案中定义的比例。 比例表示缩放级别值。 与前一级别相比,每个连续级别的分辨率和地图比例都会提高一倍。

dem 参数值为切片影像服务时,将启用此参数。

String
raster_function
(可选)

可应用于影像服务的栅格函数处理模板。

dem 参数值为动态影像服务时,将启用此参数。

String
vertical_measurement_unit
(可选)

指定将用于所有垂直测量的单位。

  • METER将使用米作为测量单位。
  • FEET将使用英尺作为测量单位。
String
time_interval_unit
(可选)

指定将用于过滤图像的时间测量单位。

  • MINUTES将按分钟过滤图像。
  • HOURS将按小时过滤图像。
  • DAYS将按天过滤图像。
  • WEEKS将按周过滤图像。
  • MONTHS将按月过滤图像。
  • YEARS将按年过滤图像。
String
oriented_imagery_type
(可选)

指定数据集中图像的类型。

  • HORIZONTAL数据集中包含曝光平行于地面且朝向地平线的图像。
  • OBLIQUE数据集中存在曝光与地面成一定角度(通常约为 45 度),由此可以看到对象侧面的图像。
  • NADIR数据集中包含曝光垂直于地面且直视下方的图像。 只能看到对象的顶部。
  • 360数据集中包含使用提供 360 度球形环绕视图的相机拍摄的图像或者已将多个相机的 360 度视图拼接在一起的图像。
  • INSPECTION资产的特写图像位于数据集中。
  • NONE将从数据集中移除定向影像类型。
String
camera_heading
(可选)

围绕相机 z 轴第一次旋转的相机方向。 该值以度为单位。 将以正顺时针方向测量朝向值,其中北向定义为 0 度。 当方向未知时,将使用 -999。

Double
camera_pitch
(可选)

围绕相机 x 轴以正逆时针方向第二次旋转的相机方向。 该值以度为单位。 当相机正对地面时,俯仰角为 0 度。 俯仰角的有效范围为 0 到 180 度,其中 180 度表示相机正对上方,90 度表示相机面向地平线。

Double
camera_roll
(可选)

围绕相机 z 轴以正顺时针方向最终旋转的相机方向。 该值以度为单位。 有效值范围为 -90 到 90。

Double
camera_height
(可选)

当捕获影像时,相机高于地面的高度。 单位为米。 相机高度用于确定图像的可见范围。 较大的值将导致更大的视图范围。 值不应小于 0。

Double
hfov
(可选)

水平方向的相机范围。 该值以度为单位。 有效值的范围为 0 到 360。

Double
vfov
(可选)

垂直方向的相机范围。 该值以度为单位。 有效值介于 0 到 180 之间。

Double
near_distance
(可选)

影像距相机位置的最近可用距离。 单位为米。

Double
far_distance
(可选)

影像距相机位置的最远可用距离。 单位为米。 远距离应大于 0。

Double
image_rotation
(可选)

当捕获图像时,相机相对于场景的方向(以度为单位)。 除了相机转动之外,还添加了旋转。 有效值的范围为 -360 到 360。

Double
orientation_accuracy
(可选)

以分号分隔的精度值的标准差。 将按以下顺序和格式添加标准差值:

  • 相机在 XY 方向的位置(以米为单位)
  • 相机高度(以米为单位)
  • 相机朝向(以度为单位)
  • 相机仰俯角(以度为单位)
  • 相机转动(以度为单位)
  • 近距离(以米为单位)
  • 远距离(以米为单位)
  • 高程(以米为单位)

例如,如果 GPS 在 x,y 坐标上的 RMS 值为 +/- 10 米,高度为 +/- 20 米,则定向精度值为 10;20。

String
image_path_prefix
(可选)

将用于与 Image 属性一起构建图像路径的前缀。

String
image_path_suffix
(可选)

将用于与 Image 属性一起构建图像路径的后缀。

String
depth_image_path_prefix
(可选)

将用于与 Depth Image 属性一起构建深度图像路径的前缀。

String
depth_image_path_suffix
(可选)

将用于与 Depth Image 属性一起构建深度图像路径的后缀。

String
dem_path_prefix
(可选)

将用于与属性中的 Elevation Source URL 一起构建 DEM 路径的前缀。

String
dem_path_suffix
(可选)

将用于与属性中的 Elevation Source URL 一起构建 DEM 路径的后缀。

String

派生输出

名称说明数据类型
out_oriented_imagery_dataset

更新的定向影像数据集。

Oriented Imagery Dataset

代码示例

UpdateOrientedImageryDatasetProperties 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 UpdateOrientedImageryDatasetProperties 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset",
    maximum_distance=550,
    footprint_item='MyOrientedImageryDataset_footprint',
    image_path_prefix='None')
UpdateOrientedImageryDatasetProperties 示例 2(独立脚本)

以下 Python 脚本演示了如何在独立脚本中使用 UpdateOrientedImageryDatasetProperites 函数。

# Import system modules
import arcpy

# Set local variables
in_oi = "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset"
new_maximum_distance = 550
footprint = "MyOrientedImageryDataset_footprint"
new_time_unit = "HOURS"
new_camera_height = 2.5

# Run Update Oriented Imagery Dataset Properties
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    in_oriented_imagery_dataset = in_oi,
    maximum_distance = new_maximum_distance,
    footprint_item = footprint,
    time_interval_unit = new_time_unit,
    camera_height = new_camera_height,
)

环境

此工具不使用任何地理处理环境。