Обновление (Анализ)

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

Вычисляет геометрическое пересечение Входных объектов и Корректирующих объектов. Атрибуты и геометрия входных объектов заменяются атрибутами и геометрией корректирующих объектов.

Иллюстрация

Обновление

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

  • И Входные объекты и Корректирующие объекты должны быть полигонами.

  • Имена полей входного и корректирующего классов объектов должны совпадать. Если в классе корректирующих объектов пропущено одно или несколько полей, которые присутствуют во входном классе объектов, значения в соответствующих полях выходного класса объектов будут пустыми.

  • Входной класс объектов не будет изменен в результате работы этого инструмента. Результаты инструмента будут записаны в новый класс пространственных объектов.

  • Если в диалоговом окне не отмечен параметр Границы (установлен как NO_BORDERS в Python), границы полигонов вдоль внешнего ребра корректирующих объектов будут удалены. Даже если пропущены внешние границы некоторых корректирующих полигонов, атрибуты корректирующих объектов, которые перекрывают входные объекты, будут присвоены полигонам выходного класса объектов.

  • Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.

    Внимание:

    Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.

  • Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости.Для получения более подробной информации см. Геообработка больших наборов данных.

  • Этот инструмент может создавать составные объекты в выходных данных, даже если все входные данные простые. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.

  • Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (используется значение по умолчанию) или указан как 0, параллельная обработка будет отключена. Установка параметра среды на 100 активирует параллельную обработку. Если параллельная обработка включена, используется до 10 ядер.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Входной класс пространственных объектов или векторный слой. Типом геометрии должен быть полигон.

Feature Layer
Обновленные объекты

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

Feature Layer
Выходной класс пространственных объектов

Класс пространственных объектов, содержащий результаты.

Feature Class
Границы
(Дополнительный)

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

  • Включено – внешняя граница Корректирующих объектов будет сохранена в Выходном классе объектов. Это является опцией по умолчанию.
  • Выключено – внешняя граница Корректирующих объектов удаляется после того, как они будут вставлены во Входные объекты. Значения полей Корректирующих объектов имеют приоритет над атрибутами Входных объектов.
Boolean
Допуск XY
(Дополнительный)

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

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit

arcpy.analysis.Update(in_features, update_features, out_feature_class, {keep_borders}, {cluster_tolerance})
ИмяОписаниеТип данных
in_features

Входной класс пространственных объектов или векторный слой. Типом геометрии должен быть полигон.

Feature Layer
update_features

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

Feature Layer
out_feature_class

Класс пространственных объектов, содержащий результаты.

Feature Class
keep_borders
(Дополнительный)

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

  • BORDERSВнешняя граница update_features будет сохранена в out_feature_class. Это является опцией по умолчанию.
  • NO_BORDERSВнешняя граница update_features удаляется после того, как они будут вставлены во in_features. Значения полей update_features имеют приоритет над атрибутами in_features.
Boolean
cluster_tolerance
(Дополнительный)

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

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit

Пример кода

Update, пример 1 (Окно Python)

Пример скрипта окна Python для использования функции Update в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.Update_analysis("city_lots.shp", "data.gdb/flood_levels", 
                      "data.gdb/low_lots", "NO_BORDERS")
Update, пример 2 (автономный скрипт)

Ниже приводится пример скрипта Python для выполнения функции Update в автономном режиме.

# Name: UpdateZones.py
# Purpose: Update the "lots" feature class with features from "cutzones"
# Import system modules
import arcpy
 
# Set the workspace
arcpy.env.workspace = "c:/data/city.gdb"
# Set local parameters
inFeatures = "lots"
updateFeatures = "cutzones"
outFeatures = "futurecut"
# Process: Update
arcpy.Update_analysis(inFeatures, updateFeatures, outFeatures, "NO_BORDERS")

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

  • Basic: Нет
  • Standard: Нет
  • Advanced: Да

Связанные разделы