Обновить (Инструменты Анализа)

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

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

Иллюстрация

Иллюстрация инструмента Обновить

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

Значения параметров Входные объекты и Обновленные объекты должны быть полигонами.
Имена полей входного и корректирующего классов объектов должны совпадать. Если в классе корректирующих объектов пропущено одно или несколько полей, которые присутствуют во входном классе объектов, значения в соответствующих полях выходного класса объектов будут пустыми.
Входной класс пространственных объектов не будет изменен. Результаты будут записаны в новый класс пространственных объектов.
Если не отмечен параметр Границы, границы полигонов вдоль внешнего ребра корректирующих объектов будут удалены. Даже если пропущены внешние границы некоторых корректирующих полигонов, атрибуты корректирующих объектов, которые перекрывают входные объекты, будут присвоены полигонам выходного класса объектов.
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой, и отмечена опция поля Использовать правило пропорции, то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции, всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Опция Использовать правило пропорции применяется только к числовым типам полей.

Внимание:

Инструменты геообработки игнорируют правила разбиения, заданные для полей таблицы или классов пространственных объектов базы геоданных.
Для повышения производительности и масштабируемости этот инструмент использует разбиение на листы при обработке очень больших наборов данных. Для получения более подробной информации см. Обработка больших наборов данных с разбиением на листы.
Этот инструмент может создать составные объекты выходных данных, даже если все входные объекты состоят из одной части. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.

Подпись	Объяснение	Тип данных
Входные объекты	Входной класс пространственных объектов или векторный слой. Типом геометрии должен быть полигон.	Feature Layer
Корректирующие объекты	Пространственные объекты, которые будут использоваться для обновления входных объектов. Типом геометрии должен быть полигон.	Feature Layer
Выходной класс пространственных объектов	Класс пространственных объектов, который будет содержать выходные данные.	Feature Class
Границы (Дополнительный)	Определяет, будут ли сохранены границы корректирующих полигональных объектов. Отмечено–Внешняя граница значения параметра Корректирующие объекты будет сохранена в значении параметра Выходной класс объектов. Используется по умолчанию. Не отмечено–Внешняя граница значения параметра Корректирующие объекты не будет сохранена после того, как она будет вставлена во Входные объекты. Значения полей в значении параметра Корректирующие объекты имеют приоритет над атрибутами значения параметра Входные объекты.	Boolean
Допуск XY (Дополнительный)	Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по 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). Внимание: Изменение значения этого параметра может привести к сбою или получению неожиданных результатов. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется параметр допуск x,y пространственной привязки входного класса объектов.	Linear Unit

Пример кода

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

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

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.analysis.Update("city_lots.shp", "data.gdb/flood_levels",
                      "data.gdb/low_lots", "NO_BORDERS")

Пример 2 Update (автономный скрипт)

Ниже приводится пример скрипта для выполнения функции 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.analysis.Update(inFeatures, updateFeatures, outFeatures, "NO_BORDERS")

Параметры среды

Автоподтверждение, Поддержка полноценных имен полей, Выходное Z-значение по умолчанию, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходной M домен, Выходной XY домен, Выходной Z домен, Выходная система координат, Географические преобразования, Экстент, Наличие выходных значений M, Выходные данные содержат Z значения, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z, Коэффициент параллельной обработки, Перенос свойств полей базы геоданных

Особые случаи

Коэффициент параллельной обработки

This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled; parallel processing will not be used and processing will be done sequentially. Setting the environment to 100 will enable parallel processing; parallel processing will be used and processing will be done in parallel. Up to 10 cores will be used when parallel processing is enabled.

Parallel processing is currently supported for polygon-on-polygon, line-on-polygon, and point-on-polygon overlay operations.

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

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