创建定向影像数据集 (定向影像)

摘要

在地理数据库中创建空白定向影像数据集。

使用情况

  • 会将模板数据集的字段、属性域、子类型和属性规则传输到定向影像数据集。 该工具会忽略与定向影像数据集所需字段同名的任何字段。

  • 创建定向影像数据集后,使用将影像添加至定向影像数据集工具添加图像。

参数

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

将在其中创建输出定向影像数据集的地理数据库。 此工作空间必须已经存在。

Workspace; Feature Dataset
已定向影像数据集名称

将创建的定向影像数据集的名称。

String
坐标系

输出定向影像数据集的空间参考。

Spatial Reference
高程源
(可选)

指定数据集的高程源。

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

整个数据集的常量地面高程值(以米为单位)。

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

Double
数字高程模型
(可选)

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

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

Image Service
细节层次
(可选)

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

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

String
栅格函数
(可选)

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

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

String
模板数据集
(可选)

影像数据集或表,其将用作模板来定义新定向影像数据集的属性字段。

Table View
已定向影像数据集别名
(可选)

将创建的定向影像数据集的备用名称。

String
配置关键字
(可选)

数据的配置关键字。 该参数仅适用于企业数据。 它用于确定数据库表的存储参数。

String
包含 Z 值
(可选)

指定输出定向影像数据集是否将具有高程值(z 值)。

  • 输出定向影像数据集将不具有 z 值。 这是默认设置
  • 输出定向影像数据集将具有 z 值。
String

派生输出

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

新的输出定向影像数据集。

Oriented Imagery Dataset

arcpy.management.CreateOrientedImageryDataset(out_dataset_path, out_dataset_name, spatial_reference, {elevation_source}, {constant_elevation}, {dem}, {lod}, {raster_function}, {template}, {out_dataset_alias}, {config_keyword}, {has_z})
名称说明数据类型
out_dataset_path

将在其中创建输出定向影像数据集的地理数据库。 此工作空间必须已经存在。

Workspace; Feature Dataset
out_dataset_name

将创建的定向影像数据集的名称。

String
spatial_reference

输出定向影像数据集的空间参考。

Spatial Reference
elevation_source
(可选)

指定数据集的高程源。

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

整个数据集的常量地面高程值(以米为单位)。

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

Double
dem
(可选)

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

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

Image Service
lod
(可选)

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

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

String
raster_function
(可选)

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

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

String
template
[template,...]
(可选)

影像数据集或表,其将用作模板来定义新定向影像数据集的属性字段。

Table View
out_dataset_alias
(可选)

将创建的定向影像数据集的备用名称。

String
config_keyword
(可选)

数据的配置关键字。 该参数仅适用于企业数据。 它用于确定数据库表的存储参数。

String
has_z
(可选)

指定输出定向影像数据集是否将具有高程值(z 值)。

  • DISABLED输出定向影像数据集将不具有 z 值。 这是默认设置
  • ENABLED输出定向影像数据集将具有 z 值。
String

派生输出

名称说明数据类型
out_oriented_imagery_dataset

新的输出定向影像数据集。

Oriented Imagery Dataset

代码示例

CreateOrientedImageryDataset 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.CreateOrientedImageryDataset("C:/data/output.gdb", "myOrientedImagery", 3857)
CreateOrientedImageryDataset 示例 2(独立脚本)

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

# Import system modules
import arcpy

arcpy.env.workspace = "C:/OrientedImageryExample"

# Set local variables
gdbName = "CreateOI.gdb"
oiName = "myFirstOI"
dataset = "C:/OrientedImageryExample/CreateOI.gdb/dataset"
spatialRef = arcpy.Describe(dataset).spatialReference
elvSource = "DEM"
demService = "https://elevation.arcgis.com/arcgis/rest/services/WorldElevation/Terrain/ImageServer/"

# Run Create Oriented Imagery Dataset 
arcpy.oi.CreateOrientedImageryDataset(
    gdbName, oiName, spatialRef, elevation_source=elvSource, dem=demService
)