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

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

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

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

    Внимание:

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

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

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

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

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

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

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

  • В вычислениях 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.getArea('PLANAR', 'YARDS')

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

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

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная таблица

Входная таблица, содержащая поля, которые будут обновлены при вычислении.

Table View; Raster Layer; Mosaic Layer
Тип выражения

Указывает тип используемого выражения.

Если входные данные - сервис объектов, тип выражения по умолчанию - SQL. Для остальных типов входных данных тип выражения по умолчанию - Python.

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

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

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

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

  • PythonБудет использоваться тип выражения Python.
  • ArcadeБудет использоваться тип выражения Arcade.
  • SQLБудет использоваться тип выражения SQL.
  • VBScriptБудет использоваться тип выражения VBScript.
String
Поля

Поля, которые будут вычисляться, их выражения и условие where.

Дополнительное выражение SQL будет использоваться для выбора подмножества записей. Будут вычислены только те записи, которые соответствуют условию where. Если условие where оставить пустым, будут вычислены все записи. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в 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 см. в разделе Вычислить значения полей.

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

String
fields
[[Field Name, Expression, {Where Clause}],...]

Поля, которые будут вычисляться, их выражения и условие where.

Дополнительное выражение SQL будет использоваться для выбора подмножества записей. Будут вычислены только те записи, которые соответствуют условию where. Если условие where оставить пустым, будут вычислены все записи. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в 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)"]])

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

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