Если пространственное отношение (ModelBuilder)

Сводка

Определяет, есть ли во входных данных заданное пространственное отношение.

Более подробно о том, как работает инструмент Если пространственное отношение в ModelBuilder

Использование

  • Этот инструмент предназначен для использования в ModelBuilder, а не в скриптах Python.

  • Инструмент выводит две Булевы переменные, True и False. В зависимости от оцениваемого условия, после работы инструмента одна из переменных является true, а другая false. Эти Булевы переменные должны быть заданы как предварительное условие для следующих инструментов, которые будут выполняться, только если одно из предварительных условий равно true.

Синтаксис

arcpy.mb.SpatialRelationshipIfThenElse(in_features, {overlap_type}, {select_features}, {search_distance}, {invert_spatial_relationship}, {selection_condition}, {count}, {count_min}, {count_max})
ParameterОбъяснениеТип данных
in_features

Входные объекты для оценки.

Feature Layer
overlap_type
(Дополнительный)

Указывает оцениваемое пространственное отношение.

  • INTERSECTОбъекты во входном слое будут выбраны, если они пересекаются со вспомогательным объектом выборки. Это значение по умолчанию
  • INTERSECT_3DОбъекты во входном слое будут выбраны, если они пересекаются со вспомогательным объектом выборки в трехмерном пространстве (x, y и z).
  • INTERSECT_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_DISTANCE, WITHIN_A_DISTANCE_GEODESIC, WITHIN_A_DISTANCE_3D, INTERSECT, INTERSECT_3D, HAVE_THEIR_CENTER_IN или CONTAINS.

Если используется опция 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Проверяет, является ли число входных объектов с пространственным отношением больше значения Количество.
  • IS_NOT_EQUAL_TOПроверяет неравенство числа входных объектов с пространственным отношением со значением Количество.
String
count
(Дополнительный)

Целочисленное значение.

Long
count_min
(Дополнительный)

Целочисленное значение минимума.

Long
count_max
(Дополнительный)

Целочисленное значение максимума.

Long

Производные выходные данные

NameОбъяснениеТип данных
true

Если указанный критерий оценивается как True, параметр также будет установлен True.

Логическое
false

Если указанный критерий оценивается как False, параметр также будет установлен False.

Логическое

Environments

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да