将影像添加至定向影像数据集 (定向影像)

摘要

可将来自多个输入源(包括文件、文件夹、表、图像路径列表或点要素图层)的图像添加至定向影像数据集。

使用情况

  • 添加的图像不受定向影像数据集管理;数据集将指向图像的存储位置。 如果删除或移动图像,则不会将其加载到定向影像查看器。

  • 根据输入数据参数值,该工具可识别将数据加载到定向影像数据集中所需的元数据。 定向影像功能取决于元数据信息。

  • 所有输入数据选项都支持 JPEG 格式。 在以下情况下,必须使用遵循定向影像表方案.csv 文件、遵循定向影像属性表方案的要素图层或者定向影像图层来添加图像:

    • 图像格式为 TIF 或 MRF。
    • 图像元数据将与图像文件分开存储,或者需要在添加之前进行编辑。
    • 需要包含相机方向,由此可实现更加精确的图像到地面和地面到图像转换。

  • 如果直接从图像文件、包含图像的文件夹或者具有图像路径列表的文本文件添加数据,则将从图像 EXIF 和 XMP 数据中提取元数据信息。 EXIF 数据至少必须包含地理位置信息。

参数

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

将在其中添加图像的定向影像数据集的路径和名称。

Oriented Imagery Layer
影像类别

指定将使用的输入图像的类型并设置定向影像数据集的默认属性。 如果在定向影像数据集属性表中未找到等效属性,则将使用默认属性。

  • Horizontal - 将使用曝光平行于地面且朝向地平线的图像。
  • Oblique - 将使用曝光与地面成一定角度(通常约为 45 度),由此可以看到对象侧面的图像。
  • Nadir - 将使用曝光垂直于地面且直视下方的图像。 只能看到对象的顶部。
  • 360 - 将使用通过提供 360 度球形环绕视图的专用相机拍摄的图像或者已将多个相机的 360 度视图拼接在一起的图像。
  • Inspection - 将使用资产的特写影像(距相机不到 5 米)。
String
输入数据

输入数据的路径和名称。 支持以下程序:

  • 一张或多张 JPEG 格式的图像。
  • 包含图像的文件夹。 仅将文件夹中的 JPEG 图像添加至数据集。
  • 包含 JPEG 图像路径的 .txt 文件。 每个图像路径必须位于单独的行上。
  • 使用定向影像表方案.csv 文件。
  • 使用定向影像属性表方案的要素图层。
  • 定向影像图层。

Folder; Oriented Imagery Layer; Table; Raster Layer; File
包含子文件夹
(可选)

指定是否递归搜索子文件夹。

  • 选中 - 将递归地探索所有子文件夹中的数据。 这是默认设置。
  • 取消选中 - 仅浏览顶级文件夹以查找数据。
Boolean
输入文件夹过滤器
(可选)

将用于在输入文件夹中过滤和添加图像的表达式。

例如,要仅添加包含特定字符串的图像,请在字符串值前后添加百分号 (%value%)。

String
输入表过滤器
(可选)

用于选择记录子集的 SQL 表达式。 有关 SQL 语法的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
包括输入表中的所有字段
(可选)

指定是否将输入表中除了所需方案之外的所有字段添加至数据集的属性表。

未选中 - 仅将定向影像方案特定的字段添加至数据集的属性表。 这是默认设置。

选中 - 将输入表中的所有字段添加至数据集的属性表。

Boolean

派生输出

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

更新的定向影像数据集。

Oriented Imagery Layer

arcpy.management.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields})
名称说明数据类型
in_oriented_imagery_dataset

将在其中添加图像的定向影像数据集的路径和名称。

Oriented Imagery Layer
imagery_category

指定将使用的输入图像的类型并设置定向影像数据集的默认属性。 如果在定向影像数据集属性表中未找到等效属性,则将使用默认属性。

  • Horizontal - 将使用曝光平行于地面且朝向地平线的图像。
  • Oblique - 将使用曝光与地面成一定角度(通常约为 45 度),由此可以看到对象侧面的图像。
  • Nadir - 将使用曝光垂直于地面且直视下方的图像。 只能看到对象的顶部。
  • 360 - 将使用通过提供 360 度球形环绕视图的专用相机拍摄的图像或者已将多个相机的 360 度视图拼接在一起的图像。
  • Inspection - 将使用资产的特写影像(距相机不到 5 米)。
String
input_data
[input_data,...]

输入数据的路径和名称。 支持以下程序:

  • 一张或多张 JPEG 格式的图像。
  • 包含图像的文件夹。 仅将文件夹中的 JPEG 图像添加至数据集。
  • 包含 JPEG 图像路径的 .txt 文件。 每个图像路径必须位于单独的行上。
  • 使用定向影像表方案.csv 文件。
  • 使用定向影像属性表方案的要素图层。
  • 定向影像图层。

Folder; Oriented Imagery Layer; Table; Raster Layer; File
include_sub_folders
(可选)

指定是否递归搜索子文件夹。

  • SUBFOLDERS将递归地探索所有子文件夹中的数据。 这是默认设置。
  • NOSUBFOLDERS仅浏览顶级文件夹以查找数据。
Boolean
folder_filter
(可选)

将用于在输入文件夹中过滤和添加图像的表达式。

例如,要仅添加包含特定字符串的图像,请在字符串值前后添加百分号 (%value%)。

String
where_clause
(可选)

用于选择记录子集的 SQL 表达式。 有关 SQL 语法的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考

SQL Expression
include_all_fields
(可选)

指定是否将输入表中除了所需方案之外的所有字段添加至数据集的属性表。

  • NO_INCLUDE_ALL_FIELDS仅将定向影像方案特定的字段添加至数据集的属性表。 这是默认设置。
  • INCLUDE_ALL_FIELDS将输入表中的所有字段添加至数据集的属性表。
Boolean

派生输出

名称说明数据类型
out_oriented_imagery_dataset

更新的定向影像数据集。

Oriented Imagery Layer

代码示例

AddImagesToOrientedImageryDataset 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.AddImagesToOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    imagery_category="Oblique",
    input_data='C:/OrientedImageryExample/Samples/img1.jpg;C:/OrientedImageryExample/Samples/img2.jpg')