インテグレート(Integrate) (データ管理)
サマリ
[インテグレート(Integrate)] を使用すると、所定の X、Y 許容値内に収まるフィーチャを一致させることができます。これにより、共有フィーチャ境界の整合性を維持できます。所定の X、Y 許容値内に収まるフィーチャは、同一であり一致していると見なされます。
たとえば、5 単位(たとえば、フィートやメートル)の X、Y 許容値を指定した場合、データに含まれる区画の境界は、隣接する区画の境界と共有されている必要がありますが、区画の境界同士は 4 単位だけ離れています。このツールを実行し終えると、2 つの区画の境界はそれぞれ 5 単位の X、Y 許容値内に収まるため、一致するようになります。
[インテグレート(Integrate)] では、次のタスクが実行されます。
- 所定の X、Y 許容値内に収まるフィーチャを見つけます。
- 所定の X、Y 許容値内に収まるフィーチャによって共有される座標頂点を挿入し、フィーチャ セグメント同士が交差する頂点を追加します。
図
使用法
-
このツールは、選択されている入力フィーチャに対してのみ実行されます。
このツールで実行される処理内容は、トポロジとほぼ同じです。両方とも、X、Y 許容値内に収まるフィーチャを移動し、フィーチャ同士が交差する頂点を挿入する処理を実行します。この種の操作を実行する際には、その操作にトポロジを使用することを検討してください。トポロジを使用することにより、フィーチャ同士の相互関連の仕方についてのルールと条件を指定できるからです。トポロジの使用方法の詳細については、トポロジの基礎をご参照ください。
トポロジよりも [インテグレート(Integrate)] を使用したほうが望ましいのは、次のような場合です。
- フィーチャの移動の仕方についてのルールを指定する必要がなく、すべてのフィーチャを所定の許容値内に収めるだけでよい場合。
- ラインの交差する各場所に頂点を挿入したい場合。
- ジオデータベース以外のフィーチャ(シェープファイルなど)を処理している場合、または数種類のジオデータベースからフィーチャを処理している場合(トポロジ内のフィーチャはすべて同じフィーチャ データセット内にある必要があります)。
-
[XY 許容値] の値は、きわめて重要です。許容値が大きすぎると、ポリゴンまたはラインが破壊、削除される場合や、動かしてはならない頂点が動いてしまう場合があります。エラーを最小限に抑えるには、可能な限り小さい値を X、Y 許容値として選択する必要があります。
-
[インテグレート(Integrate)] で入力(ポイント、マルチポイント、ライン、またはポリゴン)として使用できるのは、シンプル フィーチャクラスのみです。アノテーション フィーチャ、ディメンション フィーチャ、ネットワーク フィーチャを入力フィーチャとして使用することはできません。
-
入力フィーチャに対して行った変更を元に戻すには、編集セッションで [インテグレート(Integrate)] を使用します。
-
処理対象データセット内に格納されている個々のフィーチャに、きわめて多数の頂点がある場合(たとえば、1 つのフィーチャ内に数十万から数百万もの頂点があるとき)、一部のジオメトリック処理操作でメモリ不足が発生することがあります。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
-
このツールの出力データ エレメントは、派生した複数値出力です。このツールの出力(1 つまたは複数)を別のツールで使用するには、次の図に示すように、このツールの入力(1 つまたは複数)を直接使用し、その出力を他のツールの前提条件として設定します。前提条件の設定の詳細
このツールを使用すると入力データが変更されます。詳しい説明および不適切なデータ変更を防ぐための方法については、「出力を伴わないツール」をご参照ください。
構文
パラメータ | 説明 | データ タイプ |
in_features [[Feature Layer, Long],...] |
インテグレート対象のフィーチャクラス。フィーチャ間の距離が許容値と比較して小さい場合、頂点またはポイントがクラスタ化(移動して一致)します。下位ランクのフィーチャクラスまたはレイヤのフィーチャクラスまたはレイヤのフィーチャにスナップします(1 は、2 よりも上位ランクです)。大きい X、Y 許容値を使用すると、ランク 1 のフィーチャクラス内のフィーチャが動いてしまうことがあるので、注意してください。 | Value Table |
cluster_tolerance (オプション) |
フィーチャの頂点が一致すると見なされる距離範囲です。頂点の不必要な動きを最小限に抑えるには、X、Y 許容値にかなり小さい値を指定する必要があります。値を指定しないと、入力リスト内の最初のデータセットからの XY 許容値が使用されます。 | Linear unit |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで Integrate(インテグレート)関数を使用する方法を示しています。
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CopyFeatures_management("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.Integrate_management("C:/output/output.gdb/vegtype", 0.01)
次のスタンドアロン スクリプトは、スクリプト環境で Integrate(インテグレート)関数を適用する方法を示した単純な例です。
# Name: Integrate_Example2.py
# Description: Run Integrate on a feature class
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data/Habitat_Analysis.gdb"
# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"
xyTolerance = "0.1 feet"
# Execute CopyFeature (since Integrate modifies the original data
# this ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
# Execute Integrate
arcpy.Integrate_management(integrateFeatures, xyTolerance)