如果空间关系为 (ModelBuilder)

描述

用于评估输入是否有指定的空间关系。

了解“如果空间关系为”在 ModelBuilder 中的工作原理

使用方法

  • 此工具专用于 ModelBuilder ,而并不在编写 Python 脚本时使用。

  • 此工具有两个布尔输出,TrueFalse。根据所评估的条件,工具运行后两种布尔输出一种为真另一种为假。需将这些布尔输出设置为下游工具的前提条件,以便在任一前提条件为真的情况下执行这些工具。

语法

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如果输入图层中的要素与三维空间(x、y 和 z)中的某一选择要素相交,则会选择这些要素。
  • INTERSECT_DBMS如果输入图层中的要素与某一选择要素相交,则会选择这些要素。此选项仅适用于企业级地理数据库。当满足所有要求时,选择将在企业级地理数据库 DBMS 中,而不是在客户端上进行处理(请参阅使用说明)。与在客户端上执行选择相比,此选项可提供更好的性能。
  • WITHIN_A_DISTANCE如果输入图层中的要素在某一选择要素的指定距离内(使用欧氏距离),则将选择这些要素。使用 search_distance 参数指定距离。
  • WITHIN_A_DISTANCE_3D如果输入图层中的要素在三维空间中的某一选择要素的指定距离内,则会选择这些要素。使用 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检查具有空间关系的输入要素的数量是否等于计数值。
  • IS_BETWEEN检查具有空间关系的输入要素的数量是否介于最小计数值与最大计数值之间。
  • IS_LESS_THAN检查具有空间关系的输入要素的数量是否小于计数值。
  • IS_GREATER_THAN检查与 SQL 表达式匹配的记录,其字段值是否大于计数值。
  • IS_NOT_EQUAL_TO检查具有空间关系的输入要素的数量是否不等于计数值。
String
count
(可选)

整型计数值。

Long
count_min
(可选)

最小整型计数值。

Long
count_max
(可选)

最大整型计数值。

Long

派生输出

名称说明数据类型
true

如果指定的条件评估为 True,则此参数将设置为 True。

布尔型
false

如果指定的条件评估为 False,则此参数将设置为 True。

布尔型

环境

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

许可信息

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