Инструмент Вычислить поля (несколько) (Управление данными)—ArcGIS AllSource

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

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

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

Внимание:

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

Более подробно о выражениях Python, см. Примеры Python Вычислить поле.
Более подробно о выражениях Arcade см. ArcGIS Arcade в Справке для разработчиков.
Более подробно о выражениях SQL см. в разделах Синтаксис выражения SQL и Вычислить значения полей.
Более подробно о выражениях VBScript, см. Примеры VBScript Вычислить поле.
Выражения Arcade этого инструмента используют профиль Вычисление поля Arcade. Профиль Arcade является контекстом, в котором распознается и оценивается выражение Arcade. Когда вычисляется выражение Arcade, возвращаемое значение приводится к типу поля выходного значения.
При использовании с выбранным набором объектов, например, созданных из запроса в инструментах Создать векторный слой или Выбрать в слое по атрибуту, этот инструмент обновит только выбранные записи.
Существующие значения поля будут перезаписаны. Чтобы сохранить исходные значения, создайте резервную копию входной таблицы или воспользуйтесь опцией Включить возможность отмены на панели Геообработка.
В вычислениях Python имена полей должны быть заключены в восклицательные знаки (например, !fieldname!).
В вычислениях Arcade перед именами полей должно стоять $feature. (например, $feature.fieldname).

Примечание:

Чтобы перенести временные значения между типами полей (дата, только дата, только время, сдвиг метки времени и текст), используйте инструмент Конвертировать поле времени.

Чтобы вычислить строки в текстовые или символьные поля, в диалоговом окне строка должна использовать двойные кавычки ("строка"), или в скрипте строка, использующая двойные кавычки, также должна быть заключена в одинарные кавычки (например, '"string"').
Чтобы вычислить поле как числовое значение, введите числовое значение в параметр Выражение, кавычки при этом не требуются.
Вы можете создавать сложные выражения с помощью параметра Блок кода. Введите блок кода либо непосредственно в диалоговое окно, либо в виде строки в скрипт. Выражение и блок кода являются соединенными. Блок кода должен иметь обратное отношение к выражению; результат выполнения блока кода должен передаваться в выражение.
Параметр Блок кода поддерживается только для выражений Python.
Можно использовать модуль Python math и форматирование в параметре Блок кода. Также можно импортировать дополнительные модули. Модуль math предлагает теоретико-числовые функции и функции представления, степенные и логарифмические функции, тригонометрические функции, функции углового преобразования, гиперболические функции и математические константы. Более подробно о модуле math см. Справку Python.
Чтобы вычислить информацию о геометрии в Python, воспользуйтесь свойствами объекта Geometry. Например, используйте выражение !shape.pointCount! для вычисления числа вершин объекта.
Примечание:
Инструмент Вычислить атрибуты геометрии поддерживает аналогичные вычисления.
Чтобы вычислить площадь и длину в Python, используйте методы getArea и getLength с указанием метода и типа единицы измерения.
- Для расчета геодезической площади полигонов в квадратных километрах воспользуйтесь следующим выражением:
```
!shape.getArea('GEODESIC', 'SQUAREKILOMETERS')!
```
- Чтобы вычислить длину полилиний или полигонов на плоскости в ярдах, используйте следующее выражение:
```
!shape.getLength('PLANAR', 'YARDS')
```
Для получения подробной информации см. объекты ArcPy Polygon и Polyline.
Подробнее об инструментах геообработки и линейных и площадных единицах измерения
При работе с присоединенными данными вы можете обновлять только поля исходной таблицы. Невозможно обновлять поля присоединенной таблицы. Чтобы выполнить вычисление в присоединенной таблице, он должен осуществляться непосредственно в этой таблице.
Выражения Python, в которых соединяются строковые поля, содержащие значения null либо деление на ноль, возвратят null в качестве значения такого поля.
Выражения SQL поддерживают более быстрые вычисления в сервисах объектов. Вместо выполнения вычислений по одному объекту или строке за раз, к серверу устанавливается один запрос, что приводит к более быстрым вычислениям.
Выражения SQL поддерживаются только в сервисах объектов. Для других форматов используйте выражение Python или Arcade.
При использовании опции SQL для параметра Тип выражения есть следующие ограничения:
- Вычисление значений полей в соединяемых таблицах не поддерживается.
- Операции отмены геообработки не поддерживаются.

Параметры

Подпись	Описание	Тип данных
Входная таблица	Входная таблица, содержащая поля, которые будут обновлены при вычислении.	Table View; Raster Layer; Mosaic Layer
Тип выражения	Указывает тип используемого выражения. Если входные данные - сервис объектов, тип выражения по умолчанию - SQL. Для остальных типов входных данных тип выражения по умолчанию - Python. Более подробно о выражениях Python, см. Примеры Python Вычислить поле. Более подробно о выражениях Arcade см. ArcGIS Arcade в Справке для разработчиков. Более подробно о выражениях SQL см. в разделах Синтаксис выражения SQL и Вычислить значения полей. Более подробно о выражениях VBScript, см. Примеры VBScript Вычислить поле. Python—Будет использоваться тип выражения Python. Arcade—Будет использоваться тип выражения Arcade. SQL—Будет использоваться тип выражения SQL. VBScript—Будет использоваться тип выражения VBScript.	String
Поля	Поля, которые будут вычисляться, выражения, которые будут вычисляться, а также необязательные выражения where и типы полей. Дополнительное выражение SQL будет использоваться для выбора подмножества записей. Будут вычислены только те записи, которые соответствуют условию where. Если условие where оставить пустым, будут вычислены все записи. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS. Если во входной таблице нет поля с этим именем, оно будет добавлено. Тип поля будет задан с помощью значения типа поля. Если тип поля не указан, поле будет добавлено как текстовое. Доступны следующие типы полей: Short (16-разрядное целочисленное) — тип поля будет короткое целое. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767. Long (32-разрядное целочисленное) — тип поля будет длинное целое. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647. Big integer (64-разрядное целое) — типом поля будет большое целое. Поля типа big integer поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³. Float (32-разрядное с плавающей точкой) — тип поля будет с плавающей точкой. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38. Double (64-разрядное с плавающей точкой) — тип поля будет двойной точности. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308. Text — тип поля будет текстовым. Текстовые поля поддерживают строки символов. Date — тип поля будет дата. Поля типа Date поддерживают значения даты и времени. Date (high precision) — Тип поля будет дата с высокой точностью. Поля даты с высокой точностью поддерживают дату и время с точностью до миллисекунды. Только дата – типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. Только время – типом поля будет только время. Поля только для времени поддерживают значения времени без значения даты. Метка времени – типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB (Большой двоичный объект) — тип поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID (глобальный уникальный идентификатор) — Тип поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. Raster imagery — тип поля будет растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.	Value Table
Блок кода (Дополнительный)	Блок кода, который будет использоваться для сложных выражений. Функцию нельзя использовать для того, чтобы вернуть несколько значений.	String
Принудительно использовать домены (Дополнительный)	Указывает, будут ли применяться правила домена поля. Отмечено – правила домена поля будут применены. Если поле невозможно обновить, значение поля останется без изменений, в сообщения инструмента будет включено предупреждение. Не отмечено – правила домена поля не будут применены. Используется по умолчанию	Boolean

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

Подпись	Описание	Тип данных
Выходная таблица	Обновленная таблица.	Table View; Raster Layer; Mosaic Layer

arcpy.management.CalculateFields(in_table, expression_type, fields, {code_block}, {enforce_domains})

Имя	Описание	Тип данных
in_table	Входная таблица, содержащая поля, которые будут обновлены при вычислении.	Table View; Raster Layer; Mosaic Layer
expression_type	Указывает тип используемого выражения. PYTHON3—Будет использоваться тип выражения Python. ARCADE—Будет использоваться тип выражения Arcade. SQL—Будет использоваться тип выражения SQL. VB—Будет использоваться тип выражения VBScript. Если входные данные - сервис объектов, тип выражения по умолчанию - SQL. Для остальных типов входных данных тип выражения по умолчанию - PYTHON3. Более подробно о выражениях Python, см. Примеры Python Вычислить поле. Более подробно о выражениях Arcade см. ArcGIS Arcade в Справке для разработчиков. Более подробно о выражениях SQL см. в разделах Синтаксис выражения SQL и Вычислить значения полей. Более подробно о выражениях VBScript, см. Примеры VBScript Вычислить поле.	String
fields [[Field Name, Expression, {Where Clause}, {Field Type}],...]	Поля, которые будут вычисляться, выражения, которые будут вычисляться, а также необязательные выражения where и типы полей. Дополнительное выражение SQL будет использоваться для выбора подмножества записей. Будут вычислены только те записи, которые соответствуют условию where. Если условие where оставить пустым, будут вычислены все записи. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS. Если во входной таблице нет поля с этим именем, оно будет добавлено. Тип поля будет задан с помощью значения типа поля. Если тип поля не указан, поле будет добавлено как текстовое. Доступны следующие типы полей: SHORT — тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767. LONG — тип поля будет длинное целое. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647. BIGINTEGER – типом поля будет большое целое. Поля типа big integer поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³. FLOAT — тип поля будет с плавающей точкой. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38. DOUBLE — тип поля будет двойной точности. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308. TEXT — тип поля будет текстовым. Текстовые поля поддерживают строки символов. DATE — тип поля будет дата. Поля типа Date поддерживают значения даты и времени. DATEHIGHPRECISION — Тип поля будет дата с высокой точностью. Поля даты с высокой точностью поддерживают дату и время с точностью до миллисекунды. DATEONLY – типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. TIMEONLY – типом поля будет только время. Поля только для времени поддерживают значения времени без значения даты. TIMESTAMPOFFSET – типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB — типом поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID — Тип поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. RASTER — тип поля будет растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.	Value Table
code_block (Дополнительный)	Блок кода, который будет использоваться для сложных выражений. Функцию нельзя использовать для того, чтобы вернуть несколько значений.	String
enforce_domains (Дополнительный)	Указывает, будут ли применяться правила домена поля. ENFORCE_DOMAINS—Правила домена поля будут применены. NO_ENFORCE_DOMAINS—Правила домена поля не будут применены. Это значение по умолчанию	Boolean

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

Имя	Описание	Тип данных
out_table	Обновленная таблица.	Table View; Raster Layer; Mosaic Layer

Пример кода

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

Пример скрипта окна Python, иллюстрирующий использование функции CalculateFields в режиме прямого запуска с типом выражений Python.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.CalculateFields("parcels", "PYTHON3", 
                                 [["xCentroid", "!SHAPE.CENTROID.X!"], 
                                  ["yCentroid", "!SHAPE.CENTROID.Y!"]])

CalculateFields, пример 2 (окно Python)

Пример скрипта окна Python, иллюстрирующий использование функции CalculateFields в режиме прямого запуска с типом выражений SQL.

import arcpy
arcpy.management.CalculateFields("<a feature service url>", "SQL", 
                                 [["ceiling_field", "CEILING(field1)"], 
                                  ["floor_field", "FLOOR(field1)"]])

CalculateFields, пример 3 (окно Python)

Пример скрипта окна Python, иллюстрирующий использование функции CalculateFields в режиме прямого запуска с типом выражений Arcade.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.CalculateFields(
    "parcels", "ARCADE", 
    [["max_value", "Max($feature.field1, $feature.field2)"], 
     ["min_value", "Min($feature.field1, $feature.field2)"]])

CalculateFields, пример 4 (окно Python)

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

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"

# Calculate the Field1 field to -1 if the value is null.
# Calculate the Title field to remove any leading spaces if the first character
# is a space.
arcpy.management.CalculateFields(
    "parcels", "PYTHON3", 
    [['Field1', -1, "Field1 IS NULL"],
     ['Title', '!Address!.lstrip()', "Title LIKE ' %'"]])

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

Сохранить Global ID

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

Отзыв по этому разделу?

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

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

Внимание:

Примечание:

Примечание:

Параметры

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

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

Пример кода

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

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

В этом разделе