空間リレーションシップ (If Spatial Relationship Is) (ModelBuilder)

概要

入力に指定した空間リレーションシップがあるかどうかを評価します。

ModelBuilder での空間リレーションシップ (If Spatial Relationship Is) の詳細

使用法

  • このツールは、ModelBuilder で使用するためのツールで、Python スクリプトでは使用できません。

  • このツールには、[True][False] の 2 つのブール出力があります。評価される条件に基づき、ツールの実行後に、これら 2 つのブール出力のいずれかが true となり、他方の出力は false になります。いずれかの前提条件が true である場合、これらのブール出力は実行される下流ツールの前提条件として設定する必要があります。

構文

arcpy.mb.SpatialRelationshipIfThenElse(in_features, {overlap_type}, {select_features}, {search_distance}, {invert_spatial_relationship}, {selection_condition}, {count}, {count_min}, {count_max})
パラメーター説明データ タイプ
in_features

評価する入力フィーチャ

Feature Layer
overlap_type
(オプション)

評価される空間リレーションシップを指定します。

  • INTERSECT入力レイヤー内のフィーチャは、そのフィーチャが選択フィーチャと交差している場合に選択対象になります。これがデフォルトです。
  • INTERSECT_3D入力レイヤー内のフィーチャは、そのフィーチャが 3 次元空間 (X、Y、および Z) で選択しているフィーチャと交差している場合に選択対象になります。
  • INTERSECT_DBMS入力レイヤー内のフィーチャは、そのフィーチャが選択フィーチャと交差している場合に選択対象になります。このオプションは、エンタープライズ ジオデータベースのみに当てはまります。すべての要件を満たす場合、選択はクライアント上ではなく、エンタープライズ ジオデータベースの DBMS 内で処理されます (使用上の注意をご参照ください)。このオプションは、クライアント上で選択を処理する場合よりパフォーマンスが向上する場合があります。
  • WITHIN_A_DISTANCE入力レイヤー内のフィーチャは、そのフィーチャが選択フィーチャから指定の距離 (ユークリッド距離) 内にある場合に選択対象になります。search_distance パラメーターを使用して、距離を指定します。
  • WITHIN_A_DISTANCE_3D入力レイヤー内のフィーチャは、そのフィーチャが 3 次元空間で選択フィーチャから指定の距離内にある場合に選択対象になります。search_distance パラメーターを使用して、距離を指定します。
  • WITHIN_A_DISTANCE_GEODESIC入力レイヤー内のフィーチャは、そのフィーチャが選択フィーチャから指定の距離内にある場合に選択対象になります。フィーチャ間の距離は、測地線の式を使用して計算されます。この式は、楕円体の曲率を考慮して、日付変更線と極の近くのデータおよび交差するデータを正確に処理します。search_distance パラメーターを使用して、距離を指定します。
  • CONTAINS入力レイヤー内のフィーチャは、そのフィーチャが選択フィーチャを包含している場合に選択対象になります。
  • COMPLETELY_CONTAINS入力レイヤー内のフィーチャは、そのフィーチャが完全に選択フィーチャを包含している場合に選択対象になります。
  • CONTAINS_CLEMENTINIこの空間リレーションシップは、選択フィーチャが完全に入力フィーチャの境界線上にある (選択フィーチャのどの部分も入力フィーチャの内部または外部にない) 場合、そのフィーチャは選択されない点を除くと、COMPLETELY_CONTAINS と同じ結果になります。CLEMENTINI は、境界線ポリゴンは内部と外部を分離するポリゴンであり、ラインの境界線はその端点で、ポイントの境界線は常に空であると定義しています。
  • WITHIN入力レイヤーのフィーチャは、選択フィーチャに含まれる場合に選択対象になります。
  • COMPLETELY_WITHIN入力レイヤー内のフィーチャは、完全に選択フィーチャに含まれる場合に選択対象になります。
  • WITHIN_CLEMENTINI入力レイヤーのフィーチャ全体が選択レイヤーのフィーチャの境界線の上にある場合にフィーチャが選択対象にならない点を除き、WITHIN と同じ結果になります。CLEMENTINI は、境界線ポリゴンは内部と外部を分離するポリゴンであり、ラインの境界線はその端点で、ポイントの境界線は常に空であると定義しています。
  • ARE_IDENTICAL_TO入力レイヤー内のフィーチャは、そのフィーチャが (ジオメトリ上) 選択フィーチャと一致する場合に選択対象になります。
  • BOUNDARY_TOUCHES入力レイヤー内のフィーチャは、選択フィーチャに接する境界線がある場合に選択対象になります。入力フィーチャがラインまたはポリゴンであるとき、入力フィーチャの境界線は、選択フィーチャの境界線と接することができるだけで、入力フィーチャのいずれの部分も選択フィーチャの境界線と重なることはできません。
  • SHARE_A_LINE_SEGMENT_WITH入力レイヤーのフィーチャは、ライン セグメントを選択フィーチャと共有する場合に選択対象となります。入力フィーチャおよび選択フィーチャは、ラインまたはポリゴンのどちらかでなければなりません。
  • CROSSED_BY_THE_OUTLINE_OF入力レイヤーのフィーチャは、選択フィーチャのアウトラインと交差する場合に選択対象となります。入力フィーチャおよび選択フィーチャは、ラインまたはポリゴンのどちらかでなければなりません。入力レイヤーまたは選択レイヤーとしてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。ポイントで交差するラインは選択されますが、ライン セグメントを共有するラインは選択されません。
  • HAVE_THEIR_CENTER_IN入力レイヤー内のフィーチャは、その中心が選択フィーチャに含まれる場合に選択対象になります。フィーチャの中心を計算するために、ポリゴンとマルチポイントの場合はジオメトリの重心が使用されます。ライン入力の場合には、ジオメトリの中間点が使用されます。
String
select_features
(オプション)

[入力フィーチャ] パラメーターのフィーチャは、このレイヤーまたはフィーチャクラスのフィーチャとの関係に基づき、選択対象となります。

Feature Layer
search_distance
(オプション)

検索の対象となる指定の距離。このパラメーターは、overlap_type パラメーターを次のいずれかに設定した場合のみ有効です。WITHIN_A_DISTANCEWITHIN_A_DISTANCE_GEODESICWITHIN_A_DISTANCE_3DINTERSECTINTERSECT_3DHAVE_THEIR_CENTER_INCONTAINS

WITHIN_A_DISTANCE_GEODESIC オプションを選択した場合、キロメートルやマイルなどの距離単位を使用します。

Linear Unit
invert_spatial_relationship
(オプション)

空間リレーションシップの評価結果がそのまま使用されるか、反対の結果が使用されるかを指定します。たとえば、このパラメーターを使用すると、交差していないフィーチャまたは別のデータセット内のフィーチャから一定距離内にはないフィーチャのリストを取得することができます。

  • NOT_INVERTクエリがそのまま使用されます。これがデフォルトです。
  • INVERT逆のクエリが使用されます。selection_type パラメーターを使用すると、選択フィーチャが既存のフィーチャと統合される前に選択が反転します。
Boolean
selection_condition
(オプション)

入力と選択したフィーチャ間の空間リレーションシップの選択条件。

  • EXISTS入力と選択したフィーチャ間に、空間リレーションシップが存在するかどうかを確認します。これがデフォルト設定です。
  • NO_SELECTION入力と選択したフィーチャ間に、空間リレーションシップが存在しないかどうかを確認します。
  • ALL_SELECTED入力フィーチャのすべてのフィーチャに、空間リレーションシップが存在するかどうかを確認します。
  • IS_EQUAL_TO空間リレーションシップのある入力フィーチャの数が、Count 値と一致するかどうかを確認します。
  • IS_BETWEEN空間リレーションシップのある入力フィーチャの数が、Minimum Count 値と Maximum Count 値の間にあるかどうかを確認します。
  • IS_LESS_THAN空間リレーションシップのある入力フィーチャが、Count 値よりも少ないかどうかを確認します。
  • IS_GREATER_THANSQL 文と一致するレコードのフィールド値が、Count 値より多いかどうかを確認します。
  • IS_NOT_EQUAL_TO空間リレーションシップのある入力フィーチャの数が、Count 値と一致しないかどうかを確認します。
String
count
(オプション)

整数の個数

Long
count_min
(オプション)

整数の最小個数

Long
count_max
(オプション)

整数の最大個数

Long

派生した出力

名前説明データ タイプ
true

指定の条件が True であった場合、このパラメーターは True に設定されます。

Boolean
false

指定の条件が False であった場合、このパラメーターは True に設定されます。

Boolean

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: はい
  • Standard: はい
  • Advanced: はい