Вычислить поле (Управление данными)

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

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

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

Внимание:

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

• Более подробно о выражениях Python, см. Примеры Python Вычислить поле.

  Более подробно о выражениях Arcade, см. Руководство ArcGIS Arcade.

  Более подробно о выражениях SQL см. в разделе Вычислить значения полей.

  Более подробно о выражениях VBScript, см. Примеры VBScript Вычислить поле.

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

• Вычисление можно применить только к одному полю за один раз. Чтобы применить несколько вычислений, используйте инструмент Вычислить поля.

• Существующие значения поля будут перезаписаны. Чтобы сохранить исходные значения, создайте резервную копию входной таблицы или воспользуйтесь опцией Включить возможность отмены на панели Геообработка.

• В вычислениях Python имена полей должны быть заключены в восклицательные знаки (например, !fieldname!).

  В вычислениях Arcade перед именами полей должно стоять $feature. (например, $feature.fieldname).

• Для вычислений, связанных с переносом временных значений между различными типами полей, рассмотрите в качестве альтернативы возможность использования инструмента Конвертировать поле времени.

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

• Чтобы вычислить поле как числовое значение, введите числовое значение в параметр Выражение; кавычки при этом не требуются.

Прежние версии:

arcgis.rand() в ArcGIS AllSource 2.0 больше не поддерживается. Вместо этого следует использовать похожие функции модуля Python random. Для успешного использования модуля random добавьте его в виде импорта в параметр Блок кода.

• Вы можете создавать сложные выражения с помощью параметра Блок кода. Введите блок кода либо непосредственно в диалоговое окно, либо в виде строки в скрипт. Выражение и блок кода являются соединенными. Блок кода должен иметь обратное отношение к выражению; результат выполнения блока кода должен передаваться в выражение.

  Параметр Блок кода поддерживается только для выражений Python.

• Можно использовать модуль Python math и форматирование в параметре Блок кода. Также можно импортировать дополнительные модули. Модуль math предлагает теоретико-числовые функции и функции представления, степенные и логарифмические функции, тригонометрические функции, функции углового преобразования, гиперболические функции и математические константы. Более подробно о модуле math см. Справку Python.

• Чтобы вычислить информацию о геометрии в Python, воспользуйтесь свойствами объекта Geometry. Например, используйте выражение !shape.pointCount! для вычисления числа вершин объекта.

  Примечание:

  Инструмент Вычислить атрибуты геометрии поддерживает аналогичные вычисления.

  Чтобы вычислить площадь и длину в Python, используйте методы getArea и getLength с указанием метода и типа единицы измерения.

  • Для расчета геодезической площади полигонов в квадратных километрах воспользуйтесь следующим выражением:
    !shape.getArea('GEODESIC', 'SQUAREKILOMETERS')!

  • Чтобы вычислить длину полилиний или полигонов на плоскости в ярдах, используйте следующее выражение:
    !shape.getArea('PLANAR', 'YARDS')

  Для получения подробной информации см. объекты Polygon и Polyline.

  Подробнее об инструментах геообработки и линейных и площадных единицах измерения

• В приложениях ArcGIS для записи и чтения файлов .cal используется кодировка UTF-16-LE. Другие приложения (например, Notepad) также можно использовать для создания и редактирования файлов .cal, если файл записывается в кодировке UTF-16-LE. Файл с любой другой кодировкой не будет загружен в блок кода.

• При работе с присоединенными данными вы можете обновлять только поля исходной таблицы. Невозможно обновлять поля присоединенной таблицы. Чтобы выполнить вычисление в присоединенной таблице, он должен осуществляться непосредственно в этой таблице.

• Выражения Python, в которых соединяются строковые поля, содержащие значения null либо деление на ноль, возвратят null в качестве значения такого поля.

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

  Выражения SQL поддерживают только сервисы объектов и многопользовательские базы геоданных. Для других форматов используйте выражение Python или Arcade.

  При использовании опции SQL для параметра Тип выражения есть следующие ограничения:

  • Эта опция поддерживается только для многопользовательских баз геоданных Db2, Oracle, PostgreSQL, SAP HANA и SQL Server.
  • Вычисление значений полей в соединяемых таблицах не поддерживается.
  • Версионные и архивированные данные многопользовательской базы геоданных не поддерживаются.
  • Операции отмены геообработки не поддерживаются.

  Для получения справки по выражениям SQL см. Документацию поставщика вашей базы данных.

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Входная таблица, содержащая поля, которые будут обновлены при вычислении.	Mosaic Layer; Raster Layer; Table View
Имя поля (существующего или нового)	Поля, которые будут обновлены при вычислении. Если во входной таблице нет поля с этим именем, оно будет добавлено.	Field
Выражение	Простое выражение вычисления, используемое для создания значения, которое будет внесено в выбранные строки.	SQL Expression
Тип выражения (Дополнительный)	Указывает тип используемого выражения. Если входные данные - сервис объектов, тип выражения по умолчанию - SQL. Для остальных типов входных данных тип выражения по умолчанию - Python. Более подробно о выражениях Python, см. Примеры Python Вычислить поле. Более подробно о выражениях Arcade, см. Руководство ArcGIS Arcade. Более подробно о выражениях SQL см. в разделе Вычислить значения полей. Выражения SQL поддерживают более быстрые вычисления для сервисов объектов и многопользовательских баз геоданных. Вместо выполнения вычислений по одному объекту или строке за раз, к серверу или базе данных устанавливается один запрос, что приводит к значительно более быстрым вычислениям. Выражения SQL поддерживают только сервисы объектов и многопользовательские базы геоданных. Для других форматов используйте выражение Python или Arcade. Более подробно о выражениях VBScript, см. Примеры VBScript Вычислить поле. Python—Будет использоваться тип выражения Python. Arcade—Будет использоваться тип выражения Arcade. SQL—Будет использоваться тип выражения SQL. VBScript—Будет использоваться тип выражения VBScript.	String
Блок кода (Дополнительный)	Блок кода, который будет использоваться для сложных выражений Python или VBScript.	String
Тип поля (Дополнительный)	Задает тип для нового поля. Этот параметр используется, только если имя поля отсутствует во входной таблице. Если поле имеет тип text, длина поля будет равна 512, если только входные данные не являются шейп-файлом или файлом базы данных, в этом случае длина будет равна 254. Чтобы настроить длину, используйте инструмент Изменить поле. Short (16-разрядное целочисленное)—Тип поля будет установлен на short. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767. Long (32-разрядное целочисленное)—Тип поля будет установлен на long. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647. Big integer (64-разрядное целое число)—Типом поля будет большое целочисленное. Поля типа big integer поддерживают целые числа в диапазоне -(2^53). и 2^53. Float (32-разрядное с плавающей точкой)—Тип поля будет установлен на float. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38. Double (64-разрядное с плавающей точкой)—Тип поля будет установлен на double. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308. Text—Тип поля будет установлен на text. Текстовые поля поддерживают строки символов. Date—Тип поля будет установлен на date. Поля типа Date поддерживают значения даты и времени. Дата (высокой точности)—Тип поля будет дата с высокой точностью. Поля даты с высокой точностью поддерживают дату и время с точностью до миллисекунды. Только дата—Типом поля будет только поле даты. Поля только для даты поддерживают значения даты без значений времени. Только время—Типом поля будет только поле времени. Поля только для времени поддерживают значения времени без значения даты. Сдвиг метки времени—Типом поля будет поле сдвига метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB (Большой двоичный объект)—Тип поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID (глобальный уникальный идентификатор)—Типом поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. Raster—Типом поля будет Растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.	String
Принудительно использовать домены (Дополнительный)	Указывает, будут ли применяться правила домена поля. Отмечено – правила домена поля будут применены. Если поле невозможно обновить, значение поля останется без изменений, в сообщения инструмента будет включено предупреждение. Не отмечено – правила домена поля не будут применены. Используется по умолчанию	Boolean

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

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

Python

arcpy.management.CalculateField(in_table, field, expression, {expression_type}, {code_block}, {field_type}, {enforce_domains})

Имя	Описание	Тип данных
in_table	Входная таблица, содержащая поля, которые будут обновлены при вычислении.	Mosaic Layer; Raster Layer; Table View
field	Поля, которые будут обновлены при вычислении. Если во входной таблице нет поля с этим именем, оно будет добавлено.	Field
expression	Простое выражение вычисления, используемое для создания значения, которое будет внесено в выбранные строки.	SQL Expression
expression_type (Дополнительный)	Указывает тип используемого выражения. PYTHON3—Будет использоваться тип выражения Python. ARCADE—Будет использоваться тип выражения Arcade. SQL—Будет использоваться тип выражения SQL. VB—Будет использоваться тип выражения VBScript. Если входные данные - сервис объектов, тип выражения по умолчанию - SQL. Для остальных типов входных данных тип выражения по умолчанию - PYTHON3. Более подробно о выражениях Python, см. Примеры Python Вычислить поле. Более подробно о выражениях Arcade, см. Руководство ArcGIS Arcade. Более подробно о выражениях SQL см. в разделе Вычислить значения полей. Выражения SQL поддерживают более быстрые вычисления для сервисов объектов и многопользовательских баз геоданных. Вместо выполнения вычислений по одному объекту или строке за раз, к серверу или базе данных устанавливается один запрос, что приводит к значительно более быстрым вычислениям. Выражения SQL поддерживают только сервисы объектов и многопользовательские базы геоданных. Для других форматов используйте выражение Python или Arcade. Более подробно о выражениях VBScript, см. Примеры VBScript Вычислить поле.	String
code_block (Дополнительный)	Блок кода, который будет использоваться для сложных выражений Python или VBScript.	String
field_type (Дополнительный)	Задает тип для нового поля. Этот параметр используется, только если имя поля отсутствует во входной таблице. Если поле имеет тип text, длина поля будет равна 512, если только входные данные не являются шейп-файлом или файлом базы данных, в этом случае длина будет равна 254. Чтобы настроить длину, используйте инструмент Изменить поле. SHORT—Тип поля будет установлен на short. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767. LONG—Тип поля будет установлен на long. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647. BIGINTEGER—Типом поля будет большое целочисленное. Поля типа big integer поддерживают целые числа в диапазоне -(2^53). и 2^53. FLOAT—Тип поля будет установлен на float. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38. DOUBLE—Тип поля будет установлен на double. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308. TEXT—Тип поля будет установлен на text. Текстовые поля поддерживают строки символов. DATE—Тип поля будет установлен на date. Поля типа Date поддерживают значения даты и времени. DATEHIGHPRECISION—Тип поля будет дата с высокой точностью. Поля даты с высокой точностью поддерживают дату и время с точностью до миллисекунды. DATEONLY—Типом поля будет только поле даты. Поля только для даты поддерживают значения даты без значений времени. TIMEONLY—Типом поля будет только поле времени. Поля только для времени поддерживают значения времени без значения даты. TIMESTAMPOFFSET—Типом поля будет поле сдвига метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB—Тип поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID—Типом поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. RASTER—Типом поля будет Растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.	String
enforce_domains (Дополнительный)	Указывает, будут ли применяться правила домена поля. ENFORCE_DOMAINS—Правила домена поля будут применены. NO_ENFORCE_DOMAINS—Правила домена поля не будут применены. Это значение по умолчанию	Boolean

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

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

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.AddField("vegtable.dbf", "VEG_TYP2", "TEXT", "", "", "20")
arcpy.management.CalculateField("vegtable.dbf", "VEG_TYP2", 
                                '!VEG_TYPE!.split(" ")[-1]', "PYTHON3")

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

Используйте функцию CalculateField для присвоения новым полям значения центроида.

# Name: CalculateField_centroids.py

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "parcels"
fieldName1 = "xCentroid"
fieldName2 = "yCentroid"
fieldPrecision = 18
fieldScale = 11
 
# Add fields
arcpy.management.AddField(inFeatures, fieldName1, "DOUBLE", 
                          fieldPrecision, fieldScale)
arcpy.management.AddField(inFeatures, fieldName2, "DOUBLE", 
                          fieldPrecision, fieldScale)
 
# Calculate centroid
arcpy.management.CalculateField(inFeatures, fieldName1, 
                                "!SHAPE.CENTROID.X!",
                                "PYTHON3")
arcpy.management.CalculateField(inFeatures, fieldName2, 
                                "!SHAPE.CENTROID.Y!",
                                "PYTHON3")

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

Используйте функцию CalculateField с блоком кода для вычисления значений на основании диапазонов.

# Name: CalculateField_ranges.py

# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inTable = "parcels"
fieldName = "areaclass"
expression = "getClass(float(!SHAPE.area!))"

codeblock = """
def getClass(area):
    if area <= 1000:
        return 1
    if area > 1000 and area <= 10000:
        return 2
    else:
        return 3"""
 
# Run AddField
arcpy.management.AddField(inTable, fieldName, "SHORT")
 
# Run CalculateField 
arcpy.management.CalculateField(inTable, fieldName, expression, "PYTHON3", 
                                codeblock)

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

Используйте функцию CalculateField для случайных значений в новом поле.

# Name: CalculateField_Random.py

# Import system modules
import arcpy
import random
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
  
# Set local variables
inFeatures = "parcels"
fieldName = "RndValue"
expression = "random.randint(0, 10)"
code_block = "import random"
 
# Run AddField
arcpy.management.AddField(inFeatures, fieldName, "LONG")
 
# Run CalculateField 
arcpy.management.CalculateField(inFeatures, fieldName, expression, "PYTHON3", 
                                code_block)

CalculateField, пример 5 (окно Python)

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

import arcpy
arcpy.env.workspace = "C:/data/fgdb.gdb"
arcpy.management.CalculateField("data", "new_value", "$feature.value1 + $feature.value2", "ARCADE")

CalculateField, пример 6 (окно Python)

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

import arcpy
feature_service = "<a feature service url>"
arcpy.management.CalculateField("data", "NEW_VALUE", "SAMPLE * (BASELINE - 40)", "SQL")

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

Текущая рабочая область, Экстент, Передать описания доменов полей

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

Передать описания доменов полей

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