描述

将一个或多个地理处理结果合并到指定的输出文件夹中。

如果指定的文件夹不存在,将创建一个新文件夹。

使用方法

  • 工具执行时,会将有关执行过程的信息作为结果写入到 结果 窗口中。可将结果以拖拉方式直接从 结果 窗口添加到输入中。或者,将已经另存为结果文件 ( .rlt ) 的结果添加到输入中。

    了解有关使用结果的详细信息

  • 选中 将数据转换为文件地理数据库 时(Python 中的 convert_data = 'CONVERT' ),将出现以下情况:

    • 每个唯一数据会具有一个在合并文件夹或包中创建的文件地理数据库。
    • 压缩栅格和矢量格式会转换为一个文件地理数据库,并且原来的数据压缩将会丢失。
    • 不会合并企业级地理数据库数据。要将企业级地理数据库数据转换为文件地理数据库,请选中 包括企业级地理数据库数据,而不是仅引用该数据
  • 取消选中 将数据转换为文件地理数据库 时(Python 中的 convert_data = 'PRESERVE' ),将出现以下情况:

    • 将保留输入图层的数据源格式。例外格式包括诸如个人地理数据库数据 ( .mdb )、VPF 数据和基于 Excel 电子表格或 OLEDB 连接的表等格式。64x 环境下不支持这些格式,且始终会将其转换为文件地理数据库。
    • ADRG、CADRG/ECRG、CIB 和 RPF 栅格格式将始终转换为文件地理数据库栅格。ArcGIS 本身不能写出这些格式。始终将其转换为文件地理数据库栅格以提高效率。
    • 在输出文件夹结构中,文件地理数据库将合并到一个特定于版本的文件夹中,并且所有其他格式都将合并到 commonData 文件夹中。
    • 即使在 范围 参数中指定了范围,也不会裁剪压缩栅格和矢量格式。
  • 对于包含连接或参与关系类的图层,所有连接或相关的数据源都将合并到输出文件夹。默认情况下,连接或关联数据源将全部合并,或根据使用 范围 参数指定的范围,由 选择相关行 参数决定。

  • 对于要素图层, 范围 参数用来选择将要合并的要素。对于栅格图层, 范围 参数用来裁剪栅格数据集。

  • 有些数据集引用其他数据集。例如,您可能拥有一个引用了四个要素类的拓扑数据集。引用其他数据集的数据集示例还包括几何网络、网络和定位器。基于这些数据集类型合并或打包图层时,参与数据集也将被合并或打包。

  • 如果选中 仅方案 参数,则将仅合并或打包输入和输出数据源的方案。方案是由字段和表定义、坐标系属性、符号系统、定义查询等组成的要素类或表的结构或设计。不会合并或打包数据或记录。

  • 不支持仅方案的数据源不能进行合并和打包。如果选中 仅方案 参数,并且此工具遇到“仅方案”不支持的图层,则会显示一条警告消息,并会跳过该图层。如果指定的唯一图层不支持“仅方案”,则该工具将失败。

语法

arcpy.management.ConsolidateResult(in_result, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only})
参数 说明 数据类型
in_result
[in_result,...]

要合并的地理处理结果。

添加到输入中的结果可以是结果文件 ( .rlt ),也可以是 结果 窗口中的结果。

File; String
output_folder

此输出文件夹将包含合并的工具和数据。

Folder
convert_data
(可选)

指定输入图层是转换为文件地理数据库还是保留原始格式。

  • CONVERT — 数据将转换为文件地理数据库。此选项不适用于企业级地理数据库数据源。要转换企业级地理数据库数据,请设置 convert_arcsde_data = 'CONVERT_ARCSDE'
  • PRESERVE —保留数据格式(如有可能)。这是默认设置。例外情况包括 64x 环境下不支持的格式(个人地理数据库 .mdb 数据、VPF 数据和基于 Excel 电子表格或 OLEDB 连接的表),以及 ArcGIS 本身无法写出的栅格格式(ADRG、CADRG/ECRG、CIB 和 RPF)。
Boolean
convert_arcsde_data
(可选)

指定是将输入企业级地理数据库图层转换为文件地理数据库,还是保留其原始格式。

  • CONVERT_ARCSDE — 企业级地理数据库数据将转换为文件地理数据库,并将包含在合并的文件夹或包中。这是默认设置。
  • PRESERVE_ARCSDE — 将保留企业级地理数据库数据,并将在合并文件夹或包中对其进行引用。
Boolean
extent
(可选)

通过在范围参数中按 X-Min Y-Min X-Max Y-Max 格式手动输入坐标来指定范围。要使用特定图层的范围,请指定图层名称。

  • MAXOF —将使用输入的并集。
  • MINOF —将使用输入的交集。
  • DISPLAY —将使用与当前显示相同的范围。
  • <Layer> —将使用与指定图层相同的范围。
Extent
apply_extent_to_arcsde
(可选)

指定是将指定范围应用到所有图层,还是仅应用到企业级地理数据库图层。

  • ALL — 指定范围将应用到所有图层。这是默认设置。
  • ARCSDE_ONLY —指定范围将仅应用到企业级地理数据库图层。
Boolean
schema_only
(可选)

指定是否仅合并或打包输入和输出数据集的方案。

  • ALL — 合并或打包输入和输出数据集中的所有记录。这是默认设置。
  • SCHEMA_ONLY — 仅合并或打包输入和输出数据集的方案。
Boolean

代码示例

ConsolidateResult 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在 Python 窗口中使用 ConsolidateResult 工具。

import arcpy
arcpy.ConsolidateResult_management(r'C:\ResultFiles\BufferPoints.rlt', r'C:\project\Buffer_Pnts', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL")
ConsolidateResult 示例 2(独立脚本)

查找位于指定文件夹中的所有结果文件,然后分别为这些文件创建独立的合并文件夹。

# Name: ConsolidateResultEx1.py
# Description:  Find all the Result files that reside in a specified folder and create a consolidated folder for each layer file.
# import system modules
import os 
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles" 
# Loop through the workspace, find all the result files (.rlt) and create a consolidated folder for each 
# result file found using the same name as the original result file.
for rlt in arcpy.ListFiles("*.rlt"):
    print("Consolidating " +  rlt)
    arcpy.ConsolidateResult_management(rlt, os.path.splitext(rlt)[0], "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL")

环境

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

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题