Присоединить объекты (GeoAnalytics Desktop)

Краткая информация

Присоединяет атрибуты из одного слоя к другому на основе пространственных, временных или атрибутивных отношений, или любой их комбинации.

Иллюстрация

Иллюстрация инструмента Присоединить объекты
Оба примера инструмента присоединения объектов показывают пространственно-временное присоединение.

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

  • Пространственное соединение сопоставляет объекты (строки) из входных данных (значения параметров Целевой слой и Присоединяемый слой) в зависимости от их пространственного расположения. Временное соединение сопоставляет объекты (строк) входных данных на основе их временных отношений. Атрибутивное соединение сопоставляет объекты на основе значений полей.

  • Вы можете соединять их на основании пространственного отношения, временного отношения, атрибутивного отношения или любой их комбинации.

    ОпцияОписание

    Пространственное отношение

    Пространственное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа геометрии (точки, линии, полигоны) соединяемых слоёв. Доступны следующие пространственные отношения:

    • Пересекает
    • Равны
    • Ближайший (На плоскости) – использует расстояния на плоскости.
    • Ближайший (Геодезически) – использует геодезические расстояния.
    • Содержат
    • Внутри
    • Касается
    • Пересекает
    • Перекрытия

    Более подробно о пространственных отношениях в инструментах GeoAnalytics Desktop

    Временное отношение

    Временное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа времени (мгновенный или интервальный) соединяемых слоёв. Доступны следующие временные отношения:

    • Удовлетворяет
    • Встречено
    • Перекрытия
    • Перекрыто
    • Во время
    • Содержат
    • Равны
    • Завершает
    • Завершено
    • Начинает
    • Начато
    • Пересекает
    • Ближайший объект
    • Ближайший объект до
    • Ближайший объект после

    Более подробно о временных отношениях в инструментах GeoAnalytics Desktop

    Атрибутивное отношение

    Атрибутивное отношение, определяющее, будут ли объекты присоединяться друг к другу. Атрибуты объектов соединяются, если значения поля в присоединяемом слое идентичны значениям поля в целевом слое.

  • Если целевые и присоединяемые объекты находятся в разных системах координат, будет использована система координат целевых объектов. Если выбрана выходная система координат, все объекты проецируются в эту систему, а затем соединяются.

  • Если для параметра Пространственное отношение задано Ближайший на плоскости, значение параметра Целевой слой должен быть спроецировано, или выходная система координат должна быть задана как система координат проекции.

  • Если несколько пространственных объектов совпадают с одним и тем же целевым объектом, вы можете определить, соединять ли все совпадающие объекты (Операция присоединения со значением Присоединить один-ко-многим) или все совпадающие объекты будут суммированы вместе (Операция присоединения со значением Присоединить один-к-одному):

    • Присоединить один-ко-многим – присоединить все совпадающие объекты в присоединяемом слое с объектами целевого слоя. Полученный в результате слой будет содержать несколько записей для целевого объекта.
    • Присоединить один-к-одному – суммирует все совпадающие присоединяемые объекты, и присоединяет их к каждому объекту в целевом слое. Только совпадающие объекты будут включены в суммирование и результат. Количество присоединённых объектов будет добавлено в дополнение к другой статистике, такой как сумма, минимум, максимум, диапазон, дисперсия, среднее и стандартное отклонение. По умолчанию в классе выходных объектов будут поддерживаться только те целевые объекты, которые имеют указанные отношения (внутреннее соединение). Если отмечено Сохранить все целевые объекты, все входные целевые объекты будут записываться в класс выходных объектов (это называется левым внешним соединением).
    Примеры соединения один ко многим и один к одному
    Показаны примеры соединения один ко многим и один к одному. В этом примере присоединение один-к одному включает только количество; дополнительные статистические параметры могут быть вычислены, как показано ниже.

  • Вы можете построить выражение для присоединения объектов, используя параметр Условие присоединения. Если вы указываете выражение, будут использоваться только соответствующие условию пространственные объекты. Например, используя выражение $target["Magnitude"] > $join["Explosion"], вы можете присоединить целевые пространственные объекты, значение в поле Magnitude которых больше, чем значения присоединяемых объектов в поле Explosion. Более подробно см. в разделе Выражения Arcade в инструментах GeoAnalytics Desktop.

  • Следующие поля включаются в выходные объекты при выполнении соединения один-ко-многим:

    • Все поля из целевых слоев
    • Все поля из присоединяемых слоев

    Если в целевом и присоединяемом наборах данных существует одно и то же имя поля, объединенное поле будет начинаться со слова join (например, join_fieldname).

    Имя поляОписание

    start_date

    Это поле представляет время начала и создается, когда для входных данных задано время в виде мгновения или интервала.

    end_date

    Это поле представляет время окончания и создается, когда во входных данных время задано как интервал.

    В дополнение ко всем полям из целевого слоя, следующие поля включаются в выходные объекты при выполнении соединения один-к-одному:

    Имя поляОписание

    count

    Число объектов, которые были присоединены.

    statistic_fieldname

    Каждая заданная статистика создает поле атрибута с именем в следующем формате: statistics_fieldname. Например, максимальное значение и стандартное отклонение поля id будет MAX_id и SD_id.

    start_date

    Это поле представляет время начала и создается, когда для входных данных задано время в виде мгновения или интервала.

    end_date

    Это поле представляет время окончания и создается, когда во входных данных время задано как интервал.

  • Если включен параметр Включить расстояние, а параметр Операция присоединения установлен на Соединение один-ко-многим, в выходные объекты могут быть включены следующие поля:

    Имя поляОписание

    distance

    Расстояние между целевыми и присоединяемыми объектами. Это поле включается, если для параметра Пространственное отношение задано Ближайший (На плоскости) или Ближайший (геодезически).

    Расстояние, равное 0, указывает на то, что целевая и присоединяемая геометрии пересекаются. Нулевое значение указывает на то, что геометрии находятся дальше друг от друга, чем значение параметра Расстояние отношения Рядом. Если значение параметра Пространственное отношение равно Ближайший (на плоскости), значения расстояния будут плоскостными; если значение параметра равно Ближайший (геодезически), значения расстояния будут геодезическими. Значения будут указаны в единицах измерения, заданных параметром Единицы измерения расстояний. Единицы расстояния по умолчанию - метры.

    timegap

    Временная разница между целевым и присоединяемым объектами, в миллисекундах. Это поле включается, если параметр Временное отношение имеет значения Ближайший, Ближайший объект до или Ближайший объект после.

    Разница, равная 0, указывает на то, что целевой и присоединяемый объекты пересекаются во времени. Положительные значения означают, что целевой объект появляется раньше присоединяемого объекта, а отрицательные значения означают, что присоединяемый объект появляется раньше целевого объекта. Значения Null указывают на то, что объекты не соответствовали условию присоединения. Например, объекты находятся дальше друг от друга, чем значение параметра Расстояние временного отношения Рядом.

  • Вы можете повысить производительность инструмента Присоединить объекты, выполнив одно или несколько из следующих действий:

    • Установите параметр среды экстента таким образом, чтобы анализировались только интересующие вас данные.
    • Сделайте условия соединения как можно более избирательными. Например, присоединение Рядом длиной 1 километр будет работать лучше, чем присоединение длиной 5 километров на тех же данных.
    • Добавьте более одного условия присоединения. Дополнительные условия присоединения делают его более избирательным. Например, присоединение Рядом длиной 1 километр и длительностью 1 час будет работать лучше, чем присоединение только длиной 1 километр на тех же данных.
    • Примените выражение присоединения.
    • Используйте локальные данные, относительно места выполнения анализа.

  • Аналогичный анализ можно выполнить, используя инструмент Пространственное соединение из набора инструментов Анализ.

  • Этот инструмент геообработки работает на Spark. Анализ выполняется на настольном компьютере с использованием параллельно работающих ядер. Чтобы узнать больше о выполнении анализа см. раздел Информация по инструментами GeoAnalytics Desktop.

  • При запуске инструментов GeoAnalytics Desktop аналитика выполняется на настольном компьютере. Для оптимальной производительности, данные должны быть доступны на настольном ПК. Если используется размещенный векторный слой, рекомендуется применить ArcGIS GeoAnalytics Server. Если данные не являются локальными, инструмент будет работать дольше. Чтобы использовать ArcGIS GeoAnalytics Server для выполнения анализа, см. GeoAnalytics Tools.

Параметры

ПодписьОписаниеТип данных
Целевой слой

Содержит целевые объекты. Атрибуты из целевых объектов и атрибуты из присоединяемых объектов будут перенесены в выходные данные.

Table View
Присоединяемый слой

Содержит присоединяемые объекты. Атрибуты присоединяемых объектов будут присоединены к объектам целевого класса. Дополнительные сведения о том, как тип операции соединения влияет на объединение присоединяемых атрибутов, см в описании параметра Операция присоединения.

Table View
Выходной набор данных

Новый класс пространственных объектов, содержащий целевые объекты с присоединенными объектами.

Feature Class;Table
Операция соединения

Задает, как будут осуществляться соединения между Целевым слоем и Присоединяемым слоем в выходном классе объектов, если найдено несколько присоединяемых объектов, которые имеют то же пространственное отношение к одному целевому объекту.

  • Присоединить Один-к-одномуАтрибуты из нескольких соединяемых объектов будут агрегированы. Например, если точечный целевой объект находится внутри двух отдельных полигонов в классе присоединяемых объектов, атрибуты этих двух полигонов будут агрегированы до переноса в выходной класс объектов. Если один полигон имеет атрибутивное значение 3, а другой – значение 7, при выборе суммарной статистики для этого поля значение в выходном классе объектов будет равно 10. Применяется по умолчанию, возвращается только подсчет объектов.
  • Присоединить один-ко-многимВыходной класс объектов будет содержать несколько копий (записей) целевого объекта. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, выходной класс объектов будет содержать две строки атрибутивной таблицы целевого объекта: одна – с атрибутами одного полигона, другая – с атрибутами другого. С этой опцией суммарная статистика недоступна.
String
Пространственное отношение
(Дополнительный)

Задает критерии, использующиеся для пространственного присоединения объектов.

  • ПересекаетПрисоединяемые объекты учитываются, если они пересекают целевые объекты. Используется по умолчанию.
  • РавныПрисоединяемые объекты сопоставляются если их геометрия идентична геометрии целевого объекта.
  • Рядом на плоскостиПрисоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояния измеряются с помощью расстояний на плоскости. Укажите расстояние в параметре Расстояние отношения Рядом.
  • Рядом геодезическиПрисоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояние измеряется геодезически. Укажите расстояние в параметре Расстояние отношения Рядом.
  • СодержатЦелевые объекты должны содержать в своих границах присоединяемые объекты. Целевыми объектами должны быть полигоны или полилинии. Если целевыми объектами являются полигоны, присоединяемыми объектами могут быть только полигоны. Полигон может содержать объект любого типа. Полилиния может содержать только полилинии и точки. Точка не может содержать какой-либо объект, даже точку. Если присоединяемый объект полностью находится на границе целевого объекта (ни одна из его частей не находится внутри или вне ее), объект не будет сопоставлен.
  • ВнутриЦелевые объекты должны содержать в своих границах присоединяемые объекты. Это отношение является обратным отношению Содержит. Целевые объекты могут быть только полигонами, а присоединяемые объекты – также полигонами. Точка может быть присоединяемым объектом, только если целевым объектом является точка. Если присоединяемый объект находится целиком на границе целевого объекта; в этом случае объект учитываться не будет.
  • КасаетсяПрисоединяемые объекты учитываются, если их границы касаются целевого объекта. Если целевые и присоединяемые объекты являются линиями или полигонами, граница присоединяемого объекта может только касаться границы целевого объекта, и ни одна часть присоединяемого объекта не может пересекать границу целевого объекта.
  • ПересекаетПрисоединяемые объекты учитываются, если целевой объект пересекается их контуром. Присоединяемые и целевые объекты должны быть линейными или полигональными. Если присоединяемыми и целевыми объектами являются полигоны, используется граница полигона (линия). Будут учитываться линии, пересекающиеся в точке, но не линии с общим линейным сегментом.
  • ПерекрытияПрисоединяемые объекты будут сопоставляться, если они накладываются на целевые объекты.
String
Расстояние отношения Рядом
(Дополнительный)

Расстояние от целевого объекта, в пределах которого присоединяемые объекты будут рассматриваться как пространственное соединение. Радиус поиска допустим только в том случае, если значением параметра Пространственное отношение является Ближайший (на плоскости) или Ближайший (геодезически).

Linear Unit
Временное отношение
(Дополнительный)

Определяет критерии времени для сопоставления объектов.

  • УдовлетворяетЕсли окончание интервала целевого времени равно началу интервала времени соединения, то целевое время встречает время соединения.
  • ВстреченоЕсли начало целевого времени равно окончанию интервала времени соединения, то такое целевое время встречено временем соединения.
  • ПерекрытияЕсли интервал целевого времени начинается и заканчивается до начала и окончания интервала времени соединения, то такое целевое время перекрывает время соединения.
  • ПерекрытоЕсли интервал целевого времени начинается и заканчивается после времени начала и окончания интервала времени соединения, то такое целевое время перекрыто временем соединения.
  • Во времяЕсли целевое время находится в промежутке между началом и окончанием интервала времени соединения, считается, что это целевое время случилось в течение времени соединения.
  • СодержатЕсли время присоединяемого объекта находится в промежутке между началом и окончанием интервала целевого времени, считается, что это целевое время содержит время соединения.
  • РавныДва времени считаются равными, если их моменты или интервалы одинаковые.
  • ЗавершаетЕсли целевое время оканчивается одновременно с временем соединения, а началось после этого времени соединения, то это целевое время завершает время соединения.
  • ЗавершеноЕсли время присоединяемого объекта оканчивается одновременно с целевым временем, и это время соединения началось после целевого времени, то это целевое время будет завершено временем соединения.
  • НачинаетЕсли целевое время начинается одновременно с началом интервала времени соединения и заканчивается до окончания интервала времени соединения, то это целевое время начинает время соединения.
  • НачатоЕсли целевое время интервала начинается одновременно с временем соединения и заканчивается по окончании времени соединения, то это целевое время начато временем соединения.
  • ПересекаетЕсли любая часть целевого времени случается одновременно с временем соединения, то это целевое время пересекает время соединения.
  • Ближайший объектЕсли целевое время находится в заданном диапазоне времени от времени соединения, то это целевое время располагается рядом со временем соединения.
  • Близко передЕсли целевое время указывает время до времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается незадолго до времени соединения.
  • Близко послеЕсли целевое время указывает время после времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается немного позже времени соединения.
String
Расстояние временного отношения Рядом
(Дополнительный)

Расстояние во времени от целевого объекта, в пределах которого присоединяемые объекты будут рассматриваться как пространственное соединение. Время действует, только когда значением параметра Временное отношение является Рядом, Рядом до или Рядом после, и оба объекта содержат информацию о времени.

Time Unit
Атрибутивное отношение
(Дополнительный)

Соединение объектов происходит по значениям атрибутивного поля. Задает атрибутивное поле из целевого слоя, которое должно быть сопоставлено с атрибутивным полем слоя соединения.

  • Целевое поле – атрибутивное поле из целевого слоя, содержащее сопоставляемые значения.
  • Поле соединения – атрибутивное поле из слоя соединения, содержащее сопоставляемые значения.

Value Table
Поля суммирования
(Дополнительный)

Статистика, которая будет рассчитываться по определенным полям.

Value Table
Условие присоединения
(Дополнительный)

Применяет к указанным полям условие. Будут присоединены только объекты, значение полей которых соответствуют этим условиям.

Например, вы можете применить условие присоединения к объектам, в которых атрибут HealthSpending в слое соединения составляет более 20 процентов от атрибута дохода Income в целевом слое. Используйте выражение Arcade, такое как $join["HealthSpending"] > $target["Income"] * .2.

String
Сохранить все целевые объекты
(Дополнительный)

Указывает, будут ли сохранены все целевые объекты в выходном классе объектов (левое внешнее соединение) или только имеющие заданное отношение с присоединяемыми объектами (внутреннее соединение).

  • Отмечено – все целевые объекты будут записаны в выходные данные.
  • Не отмечено – только те целевые объекты, которые имеют заданное отношение, будут поддерживаться в выходном классе объектов. Все точечные объекты, не находящиеся внутри полигональных, будут исключены из выходных данных. Используется по умолчанию.

Boolean
Включить расстояние
(Дополнительный)

Задает, будет ли включено в результат пространственное расстояние или временная разница.

Этот параметр активен, если значение параметра Операция присоединения равно Присоединить один-ко-многим и истинно любое из следующего:

  • Значением параметра Пространственное отношение является Ближайший (на плоскости) и Ближайший (геодезически).
  • Параметр Временное отношение имеет значения Ближайший, Ближайший объект до или Ближайший объект после.
.
  • Отмечено - пространственное расстояние или временная разница будет включена в результат.
  • Не отмечено - ни пространственное расстояние, ни временная разница не будет включена в результат. Используется по умолчанию.

Boolean
Единицы измерения расстояния
(Дополнительный)

Задает единицу измерения, которая будет использоваться для значений расстояния в выходном классе объектов.

  • МетрыЕдиницами измерения будут метры. Используется по умолчанию.
  • КилометрыЕдиницами измерения будут километры.
  • Геодезические мили СШАЕдиницами измерения будут геодезические мили США.
  • Геодезические морские мили СШАЕдиницами измерения будут геодезические морские мили США.
  • Геодезические ярды СШАЕдиницами измерения будут геодезические ярды США.
  • Геодезические футы СШАЕдиницами измерения будут геодезические футы США.
  • Сухопутные милиЕдиницами измерения будут сухопутные мили.
  • Международные морские милиЕдиницами измерения будут международные морские мили.
  • Международные ярдыЕдиницами измерения будут международные ярды.
  • Международные футыЕдиницами измерения будут международные футы.
String

arcpy.geoanalytics.JoinFeatures(target_layer, join_layer, output, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {keep_all_target_features}, {include_distance}, {distance_unit})
ИмяОписаниеТип данных
target_layer

Содержит целевые объекты. Атрибуты из целевых объектов и атрибуты из присоединяемых объектов будут перенесены в выходные данные.

Table View
join_layer

Содержит присоединяемые объекты. Атрибуты присоединяемых объектов будут присоединены к объектам целевого класса. Дополнительные сведения о том, как тип операции соединения влияет на объединение присоединяемых атрибутов, см в описании параметра Операция присоединения.

Table View
output

Новый класс пространственных объектов, содержащий целевые объекты с присоединенными объектами.

Feature Class;Table
join_operation

Задает, как будут осуществляться соединения между значениями target_layer и join_layer в выходном объекте, если найдено несколько присоединяемых объектов, которые имеют то же пространственное отношение к одному целевому объекту.

  • JOIN_ONE_TO_ONEАтрибуты из нескольких соединяемых объектов будут агрегированы. Например, если точечный целевой объект находится внутри двух отдельных полигонов в классе присоединяемых объектов, атрибуты этих двух полигонов будут агрегированы до переноса в выходной класс объектов. Если один полигон имеет атрибутивное значение 3, а другой – значение 7, при выборе суммарной статистики для этого поля значение в выходном классе объектов будет равно 10. Применяется по умолчанию, возвращается только подсчет объектов.
  • JOIN_ONE_TO_MANYВыходной класс объектов будет содержать несколько копий (записей) целевого объекта. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, выходной класс объектов будет содержать две строки атрибутивной таблицы целевого объекта: одна – с атрибутами одного полигона, другая – с атрибутами другого. С этой опцией суммарная статистика недоступна.
String
spatial_relationship
(Дополнительный)

Задает критерии, использующиеся для пространственного присоединения объектов.

  • INTERSECTSПрисоединяемые объекты учитываются, если они пересекают целевые объекты. Используется по умолчанию.
  • EQUALSПрисоединяемые объекты сопоставляются если их геометрия идентична геометрии целевого объекта.
  • NEARПрисоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояния измеряются с помощью расстояний на плоскости. Укажите расстояние в параметре spatial_near_distance.
  • NEAR_GEODESICПрисоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояние измеряется геодезически. Укажите расстояние в параметре spatial_near_distance.
  • CONTAINSЦелевые объекты должны содержать в своих границах присоединяемые объекты. Целевыми объектами должны быть полигоны или полилинии. Если целевыми объектами являются полигоны, присоединяемыми объектами могут быть только полигоны. Полигон может содержать объект любого типа. Полилиния может содержать только полилинии и точки. Точка не может содержать какой-либо объект, даже точку. Если присоединяемый объект полностью находится на границе целевого объекта (ни одна из его частей не находится внутри или вне ее), объект не будет сопоставлен.
  • WITHINЦелевые объекты должны содержать в своих границах присоединяемые объекты. Это отношение является обратным отношению Содержит. Целевые объекты могут быть только полигонами, а присоединяемые объекты – также полигонами. Точка может быть присоединяемым объектом, только если целевым объектом является точка. Если присоединяемый объект находится целиком на границе целевого объекта; в этом случае объект учитываться не будет.
  • TOUCHESПрисоединяемые объекты учитываются, если их границы касаются целевого объекта. Если целевые и присоединяемые объекты являются линиями или полигонами, граница присоединяемого объекта может только касаться границы целевого объекта, и ни одна часть присоединяемого объекта не может пересекать границу целевого объекта.
  • CROSSESПрисоединяемые объекты учитываются, если целевой объект пересекается их контуром. Присоединяемые и целевые объекты должны быть линейными или полигональными. Если присоединяемыми и целевыми объектами являются полигоны, используется граница полигона (линия). Будут учитываться линии, пересекающиеся в точке, но не линии с общим линейным сегментом.
  • OVERLAPSПрисоединяемые объекты будут сопоставляться, если они накладываются на целевые объекты.
String
spatial_near_distance
(Дополнительный)

Расстояние от целевого объекта, в пределах которого присоединяемые объекты будут рассматриваться как пространственное соединение. Радиус поиска допустим только в том случае, если значением параметра spatial_relationship является NEAR или NEAR_GEODESIC.

Linear Unit
temporal_relationship
(Дополнительный)

Определяет критерии времени для сопоставления объектов.

  • MEETSЕсли окончание интервала целевого времени равно началу интервала времени соединения, то целевое время встречает время соединения.
  • MET_BYЕсли начало целевого времени равно окончанию интервала времени соединения, то такое целевое время встречено временем соединения.
  • OVERLAPSЕсли интервал целевого времени начинается и заканчивается до начала и окончания интервала времени соединения, то такое целевое время перекрывает время соединения.
  • OVERLAPPED_BYЕсли интервал целевого времени начинается и заканчивается после времени начала и окончания интервала времени соединения, то такое целевое время перекрыто временем соединения.
  • DURINGЕсли целевое время находится в промежутке между началом и окончанием интервала времени соединения, считается, что это целевое время случилось в течение времени соединения.
  • CONTAINSЕсли время присоединяемого объекта находится в промежутке между началом и окончанием интервала целевого времени, считается, что это целевое время содержит время соединения.
  • EQUALSДва времени считаются равными, если их моменты или интервалы одинаковые.
  • FINISHESЕсли целевое время оканчивается одновременно с временем соединения, а началось после этого времени соединения, то это целевое время завершает время соединения.
  • FINISHED_BYЕсли время присоединяемого объекта оканчивается одновременно с целевым временем, и это время соединения началось после целевого времени, то это целевое время будет завершено временем соединения.
  • STARTSЕсли целевое время начинается одновременно с началом интервала времени соединения и заканчивается до окончания интервала времени соединения, то это целевое время начинает время соединения.
  • STARTED_BYЕсли целевое время интервала начинается одновременно с временем соединения и заканчивается по окончании времени соединения, то это целевое время начато временем соединения.
  • INTERSECTSЕсли любая часть целевого времени случается одновременно с временем соединения, то это целевое время пересекает время соединения.
  • NEARЕсли целевое время находится в заданном диапазоне времени от времени соединения, то это целевое время располагается рядом со временем соединения.
  • NEAR_BEFOREЕсли целевое время указывает время до времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается незадолго до времени соединения.
  • NEAR_AFTERЕсли целевое время указывает время после времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается немного позже времени соединения.
String
temporal_near_distance
(Дополнительный)

Расстояние во времени от целевого объекта, в пределах которого присоединяемые объекты будут рассматриваться как пространственное соединение. Время действует, только когда значением параметра temporal_relationship является NEAR, NEAR_BEFORE или NEAR_AFTER, и оба объекта содержат информацию о времени.

Time Unit
attribute_relationship
[attribute_relationship,...]
(Дополнительный)

Соединение объектов происходит по значениям атрибутивного поля. Задает атрибутивное поле из целевого слоя, которое должно быть сопоставлено с атрибутивным полем слоя соединения.

  • Целевое поле – атрибутивное поле из целевого слоя, содержащее сопоставляемые значения.
  • Поле соединения – атрибутивное поле из слоя соединения, содержащее сопоставляемые значения.

Value Table
summary_fields
[summary_fields,...]
(Дополнительный)

Статистика, которая будет рассчитываться по определенным полям.

  • COUNT – количество ненулевых значений. Может использоваться с числовыми или текстовыми полями. Количество [null, 0, 2] равно 2.
  • SUM – сумма числовых значений в поле. Сумма [null, null, 3] равна 3.
  • MEAN – среднее арифметическое числовых значений. Среднее [0,2, null] равно 1.
  • MIN – минимальное значение числового поля. Минимум [0, 2, null] равен 0.
  • MAX – максимальное значение числового поля. Максимальное значение [0, 2, null] равно 2.
  • STDDEV – среднеквадратическое отклонение числового поля. Среднеквадратическое отклонение [1] равно null. Среднеквадратическое отклонение [null, 1,1,1] равно null.
  • VAR – дисперсия по числовому полю в треке. Дисперсия [1] равна null. Дисперсия [null, 1,1,1] равна null.
  • RANGE – диапазон числового поля. Он вычисляется вычитанием минимального значения из максимального. Диапазон [0, null, 1] равен 1. Диапазон [null, 4] равен 0.
  • ANY – пример строки из текстового поля.

Value Table
join_condition
(Дополнительный)

Применяет к указанным полям условие. Будут присоединены только объекты, значение полей которых соответствуют этим условиям.

Например, вы можете применить условие присоединения к объектам, в которых атрибут HealthSpending в слое соединения составляет более 20 процентов от атрибута дохода Income в целевом слое. Используйте выражение Arcade, такое как $join["HealthSpending"] > $target["Income"] * .2.

String
keep_all_target_features
(Дополнительный)

Указывает, будут ли сохранены все целевые объекты в выходном классе объектов (левое внешнее соединение) или только имеющие заданное отношение с присоединяемыми объектами (внутреннее соединение).

  • KEEP_ALLВсе целевые объекты будут записаны в выходные данные.
  • KEEP_COMMONТолько те целевые объекты, которые имеют заданное отношение, будут поддерживаться в выходном классе объектов. Используется по умолчанию.
Boolean
include_distance
(Дополнительный)

Задает, будет ли включено в результат пространственное расстояние или временная разница.

Этот параметр активен, если значение параметра join_operation равно JOIN_ONE_TO_MANY и истинно любое из следующего:

  • Значение параметра spatial_relationship - NEAR или NEAR_GEODESIC.
  • Значение параметра temporal_relationship - NEAR, NEAR_BEFORE или NEAR_AFTER.

  • INCLUDE_DISTANCEПространственное расстояние или временная разница будет включена в результат.
  • NO_INCLUDE_DISTANCEПространственное расстояние или временная разница будет включена в результат. Используется по умолчанию.
Boolean
distance_unit
(Дополнительный)

Задает единицу измерения, которая будет использоваться для значений расстояния в выходном классе объектов.

  • METERSЕдиницами измерения будут метры. Используется по умолчанию.
  • KILOMETERSЕдиницами измерения будут километры.
  • MILESЕдиницами измерения будут геодезические мили США.
  • NAUTICAL_MILESЕдиницами измерения будут геодезические морские мили США.
  • YARDSЕдиницами измерения будут геодезические ярды США.
  • FEETЕдиницами измерения будут геодезические футы США.
  • MILES_INTЕдиницами измерения будут сухопутные мили.
  • NAUTICAL_MILES_INTЕдиницами измерения будут международные морские мили.
  • YARDS_INTЕдиницами измерения будут международные ярды.
  • FEET_INTЕдиницами измерения будут международные футы.
String

Пример кода

JoinFeatures, пример (автономный скрипт)

В следующем автономном скрипте показано использование функции JoinFeatures.

# Name: JoinFeatures.py
# Description: Join crime events that are close together in time and space, and 
#              return the count of nearby crimes. This example is a self join 
#              (joining the same layer to itself).

# Import system modules 
import arcpy 

arcpy.env.workspace = "C:/data/CityData.gdb"

# Enable time on the input features using an .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties 
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\ChicagoCrimes.lyrx'

# MakeFeatureLayer converts the .lyrx to features
chicagoCrimesLayer = arcpy.management.MakeFeatureLayer(inputLyrx, "Crimes_layer")

# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(chicagoCrimesLayer, inputLyrx)

# Set local variables
spatialOperation = "NEAR" 
nearDistance = "1 Kilometers" 
temporalOperation = "NEAR" 
nearTime = "3 Hours" 
out = "CloseCrimes"

# Run Join Features
arcpy.gapro.JoinFeatures(chicagoCrimesLayer, inFeatures, out, "JOIN_ONE_TO_ONE", 
                         spatialOperation, nearDistance, temporalOperation, 
                         nearTime)