概要
1 つまたは複数のジオプロセシングの結果を、指定された出力フォルダーへ統合します。
指定されたフォルダーが存在しない場合、新しいフォルダーが作成されます。
使用法
ツールを実行すると、実行に関する情報が結果として [結果] ウィンドウに書き込まれます。結果はドラッグ アンド ドロップすることで、[結果] ウィンドウから直接入力として追加できます。あるいは、結果ファイル (*.rlt) として保存されている結果を入力として追加できます。
[データをファイル ジオデータベースへ変換] をオン (Python では convert_data = 'CONVERT') にしたとき、以下が発生します。
- 一意のデータ ソースごとに、ファイル ジオデータベースが統合フォルダーまたはパッケージに作成されます。
- 圧縮されたラスター形式およびベクター形式は、ファイル ジオデータベースに変換され、圧縮は解除されます。
- エンタープライズ ジオデータベースのデータは統合されません。エンタープライズ ジオデータベースのデータをファイル ジオデータベースに変換するには、[データを参照せずにエンタープライズ ジオデータベースのデータを含める] をオンにします。
[データをファイル ジオデータベースへ変換] をオフ (Python では convert_data = 'PRESERVE') にしたとき、以下が発生します。
- 入力レイヤーのデータ ソース形式が維持されます。例外は、パーソナル ジオデータベース データ (*.mdb)、VPF データ、Excel スプレッドシートまたは OLEDB 接続に基づくテーブルなどの形式です。これらの形式は、64x 環境ではサポートされないため、常にファイル ジオデータベースに変換されます。
- ADRG、CADRG/ECRG、CIB、および RPF ラスター形式は、常にファイル ジオデータベース ラスターに変換されます。ArcGIS は、ネイティブにこれらの形式を書き出すことはできません。効率のために、それらは常にファイル ジオデータベース ラスターに変換されます。
- 出力フォルダー構造の中で、ファイル ジオデータベースはバージョン固有のフォルダーに統合され、それ以外の形式はすべて commonData フォルダーに統合されます。
- 圧縮されたラスターおよびベクター形式は、[範囲] パラメーターに範囲が指定されていても、クリップされません。
結合を含むか、リレーションシップ クラスに属するレイヤーの場合、結合したデータ ソースまたは関連付けられたデータ ソースはすべて出力フォルダーに統合されます。デフォルトでは、結合したデータ ソースまたは関連付けられたデータ ソースは、[範囲] パラメーターを使用して指定された範囲に基づいて、全体が統合されるか、[関連行の選択] パラメーターに応じて統合されます。
フィーチャ レイヤーの場合は、[範囲] パラメーターを使用して、統合するフィーチャを選択します。ラスター レイヤーの場合は、[範囲] パラメーターを使用して、ラスター データセットをクリップします。
一部のデータセットは、他のデータセットを参照しています。たとえば、4 つのフィーチャクラスを参照するトポロジ データセットなどがあります。他のデータセットを参照するそれ以外のデータセットの例として、ジオメトリック ネットワーク、ネットワーク、およびロケーターを挙げることができます。これらのタイプのデータセットを基にしてレイヤーを統合またはパッケージ化するときは、それに属しているデータセットも統合またはパッケージ化されます。
[スキーマのみ] パラメーターをオンにすると、入力および出力データ ソースのスキーマだけを統合またはパッケージ化できます。スキーマは、フィーチャクラスまたはテーブルの構造または設計であり、フィールドおよびテーブル定義、座標系プロパティ、シンボル、フィルター設定などで構成されます。データまたはレコードは統合またはパッケージ化されません。
スキーマのみをサポートしないデータ ソースは、統合またはパッケージ化されません。[スキーマのみ] パラメーターをオンにしているときに、スキーマのみではサポートされないレイヤーが検出されると、警告メッセージが表示され、そのレイヤーはスキップされます。指定した唯一のレイヤーがスキーマのみではサポートされない場合、ツールは失敗します。
構文
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 (オプション) | 入力レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。
| Boolean |
convert_arcsde_data (オプション) | 入力エンタープライズ ジオデータベース レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。
| Boolean |
extent (オプション) | 範囲パラメーターに X-Min Y-Min X-Max Y-Max 形式で座標を入力して範囲を指定します。特定レイヤーの範囲を使用するには、レイヤー名を指定します。
| Extent |
apply_extent_to_arcsde (オプション) | 指定した範囲をすべてのレイヤーに適用するか、エンタープライズ ジオデータベースのレイヤーだけに適用するかを指定します。
| Boolean |
schema_only (オプション) | 入力および出力データセットのスキーマだけを統合またはパッケージ化するかどうかを指定します。
| Boolean |
コードのサンプル
ConsolidateResult (結果の統合) の例 1 (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: はい